How-To

This page is part of semorg's documentation.

How to enable a feature

Simply create the feature's overview page. It's basic content is

{{#semorg-overview:<feature>}}

If you don't use an overview page's canonical name you should change Mediawiki:Semorg-<feature>-page-name to your custom name.

You can use the page SemanticOrganization as a convenient starting point. There you can create overview pages with prefilled content with a click.

How to add a link to a feature the navigation

Just edit Mediawiki:Tweeki-navbar-left to add a link. For Details see the documentation for the Tweeki skin.

How to enable new fields in a form

Edit MediaWiki:Semorg-form-<feature>-rows and add the field. Predefined fields for every feature can be found on the page Fields in this documentation.

How to change the name of a group?

Use the „move“ feature in the dropdown next to the edit button. If you create a redirect (which is the default), existing group meetings will still be associated to the group. However the association could get lost when editing a meeting so you should either edit them manually or use the Replace Text extension.

How to add a field?

Create the property Property:Semorg-<feature>-<field>. You can use Special:CreateProperty (provided by the Page Forms extension). Chose the data type you want to use.
Create MediaWiki:Semorg-field-<feature>-<field>-name.
If needed create MediaWiki:Semorg-field-<feature>-<field>-parameters (or -input-type, -size, -help, -prefix, or -suffix).
If the field should be shown in the form add <field> to MediaWiki:Semorg-form-<feature>-rows.
Create a custom template. Copy Template:Semorg-<feature> to a new page in the template namespace (e.g. Template:Semorg-<feature>-custom).
In order to save the field in the database add the line |<field>={{{<field>|}}} to the call of {{#semorg-set:}}.
If the field's value should be shown in the detail table add the line |<field>={{{<field>|}}} to the call of {{#semorg-table:}}. You can add any formatting you want here.
Point Mediawiki:Semorg-<feature>-template to the newly created template.
If you already created calls to the old template, change them. You can use the Replace Text extension to quickly replace all appearances of {{semorg-<feature> with {{semorg-<feature>-custom.

If the field should be shown in lists

copy the contents of Template:Semorg-<feature>-row to Template:Semorg-<feature>-custom-row
add |?semorg-<feature>-<field>=<field> to the call of {{#semorg-list:}}
- if you want to change only one specific list, use the row template and headers parameters
- if you want it for all lists for this feature, change MediaWiki:semorg-list-<feature>-row-template and MediaWiki:semorg-list-<feature>-headers
- the value for the row template should be <feature>-custom (without “semorg-” and “-row”)

How to change the appearance of a list?

see also the documentation for the {{#semorg-list:}} parser function

List have two parts:

Headers
Rows, whose contents are controlled by a template.

In most cases you need to change both of them.

	default	globally (System Messages)	single use (Function Parameters)	example value
Headers		`MediaWiki:Semorg-list-<feature>-headers`	`headers`	group-name, group-description, group-host, group-members
Row template	`Template:Semorg-<feature>-row`	`MediaWiki:Semorg-list-<feature>-row-template`	`row template`	`<feature>-custom` (translates to `Template:semorg-<feature>-custom-row`

How to allow more than one responsible person for a task?

change the value for input type in MediaWiki:Semorg-field-task-responsible-parameters to tokens and add |list at the end

How to change users' display names

You can change how your users' names are displayed (i.e. how the property Semorg-person-name is set) by editing the MediaWiki:Semorg-person-user-name message.

You can use the following parameters:

$1: user name
$2: first name
$3: last name
$4: acronym

Default is "{{#if:$2$3|$2 $3|$1}}".

Attention! If you change this on an existing installation the attributes will only be updated after a resave of all affected pages!