Manual:Extension/BlueSpiceChecklist

BlueSpiceChecklist allows you to insert a drop-down checklist or a checkbox. Users with edit rights can change the status or value directly in view mode.

Note:In contrast, checkboxes for tasks are created as a Task list.

Checklist

The checklist is inserted as a Content droplet. The selected list value can only be changed in the view mode of the page. This creates a new page version.

Droplet "Checklist"

Defining list values

Die Listenwerte müssen vorab als Seite im Vorlagennamensraum definiert werden. Die Elemente müssen als ungeordnete Liste angelegt werden. Im Quelltext der Seite werden Listenpunkte mit einem * am Zeilenanfang erstellt.

Wenn Sie beispielsweise eine Liste von Pizzas erstellen möchten, in der eine bestimmte Pizza ausgewählt werden kann, können Sie die Seite Vorlage:Pizza mit folgendem Inhalt anlegen:

The list values must be predefined as a page in the namespace "Template" as an unordered list. In the source code of the page, list items are created with an asterisk * at the beginning of the line.

For example, if you want to create a list of pizzas from which a specific pizza can be selected, you can create a page alled Template:Pizza with the following content:

* Choose a pizza ... 
* Margherita
* Schinken 
* Salami
* Pilze
* Hawaii 
* Gamberetti
* Diavolo
* Siziliana
* Quattro Formaggi

In addition, a font color (using HEX-code notation) can be specified for each entry:

 * Quattro Formaggi | #00FF00 

Inserting the list

The list can now be selected in the control list selection menu.

Choose the list

This generates the following tag in the source code:

 <bs:checklist type="list" list="Template:Pizza" value="Choose a pizza..." />

Der parameter list legt die Seite fest, auf der sich die vordefinierte Liste befindet; value legt den Wert fest, der voreingestellt sein soll.

The parameter list specifies the page for the list values. The parameter value specifies the default value.

Checkboxes (source edit only)

In addition, it is possible to create individual checkboxes in source edit mode:

<bs:checkbox checked="false" /> Margherita
<bs:checkbox checked="true" /> Siziliana

Unterschiede der Kontrollkästchen zur Aufgabenliste

Function	Kontrollkästchen (BlueSpiceChecklist)	Aufgabenliste (Checklists)
Insert	in source edit mode	as Content droplet via keyboard shortcut [] in source edit mode
Selection	in view mode	in view mode (tracks status change in version history) with the visual editor (no status tracking)
Status	checkbox shows a check mark	checkbox shows a check mark closed tasks have strike-through formatting
Overview	no overview available	filtered overview of all tasks is possible stored as page property
Edit permission	roles: editor, author, maintenanceadmin, bot	"edit" permission

• Datei:BlueSpiceChecklist Beispiel Checkbox.png

  Kontrollkästchen

• Datei:Aufgabe Beispiel.png

  Aufgaben

Compatibility of checkboxes   v4.3+

The Content Droplet Checklist is available from BlueSpice 4.3. Since this has changed the syntax, checkboxes that were previously created with the <bs:checklist /> tag must be adjusted accordingly. If there are many checkboes, this can be done using the page Special:ReplaceText.

The syntax <bs:checklist value="Salami" type="check" /> no longer works as of BlueSpice 4.3.

New integration:

<bs:checkbox checked="false" /> Margherita
<bs:checkbox checked="true" /> Siziliana

Wichtig!Kontrolllisten und Kontrollkästchen können nicht gleichzeitig in eine Seite eingebunden werden.

Wenn Sie eine Kontrollliste auf einer Seite nutzen, können Sie zusätzlich eine Aufgabenliste einbinden.

Configuration

The following configuration can be changed in the Config manager:

• Mark checklist changes as minor edit: If this setting is active, changes to a checklist (for example, checking a checkbox) in view mode are logged as minor edits. If this setting is inactive, a change to the checklist is recorded as a regular version in the page history.
  
  

  minor edit

Berechtigungen

Wenn eine Wiki-Seite eine Checkliste enthält, kann jeder Benutzer mit dem Recht checklistmodify die Checklistenwerte aktualisieren. Diese Aktion erfolgt im Ansichtsmodus der Seite. Standardmäßig können dies Benutzer in den Rollen editor, author, maintenanceadmin und bot.

Magic word "checklist" (obsolete)   -v4.2

Until BlueSpice 4.2, checklist elements were inserted as magic word. To create a checklist item:

1. Click Insert > More > Magic word in the visual editor.
   
2. Click checklist in the dialog window.
   
3. Click Done. Another dialog window appears.
   

   Dialog window for checklists
4. Select the tab to select your checklist type:
   • Checkbox: creates an individual checkbox.
   • List: creates a drop-down menu.

Creating a checkbox

1. Toggle the switch in the dialog window on the checkbox tab to create an unselected checkbox. When this toggle is blue, the checkbox is pre-selected.
2. Select insert. The checkbox is now visible on the page. Write the text for a label or for an instruction next to the checkbox

After the page has been saved, all users can activate and deactivate the checkbox.

Creating a drop-down list

1. Select an existing option list in the List tab.
2. Under Selected option, choose the default value.
3. Click Done.

[] Order a pizza [] Pick up the pizza

Margherita

Siziliana

Technical Reference: BlueSpiceChecklist

---

To submit feedback about this documentation, visit our community forum.