Handbuch:Erweiterung/BlueSpiceChecklist: Unterschied zwischen den Versionen

[freigegebene Version][freigegebene Version]
K
(Markierung: 2017-Quelltext-Bearbeitung)
K (Mlink-rodrigue verschob die Seite Handbuch:Erweiterung/BlueSpiceCheckList nach Handbuch:Erweiterung/BlueSpiceChecklist: Misspelling)
 

BlueSpiceChecklist ermöglicht das Einfügen von Checkboxen und Checklisten in eine Seite z.B. für Aufgabenlisten mit Verantwortlichkeiten und Statusangaben.

Das magische Wort "checklist"[Bearbeiten | Quelltext bearbeiten]

Es ist einfach, eine Checkbox oder Checklisten in eine Wiki-Seite einzufügen. Wenn eine Wiki-Seite eine Checkliste enthält, kann jeder Benutzer mit dem Recht checklistmodify die Checklistenwerte aktualisieren, ohne in den Bearbeitungsmodus zu wechseln. Dies sind standardmäßig Benutzer in den Rollen editor, author, maintenanceadmin und bot.

Hinweis: Wenn ein Benutzer mit Leseberechtigungen den Wert eines Kontrollkästchens oder einer Dropdown-Liste ändert, wird der Wert nicht gespeichert. Beim Aktualisieren der Seite wird der zuletzt gespeicherte Wert wieder angezeigt.


Um eine Checkbox (Kontrollkästchen) oder eine Checkliste auf einer Seite einzufügen:

  1. Klicken Sie im visuellen Editor auf Einfügen > Mehr > Magisches Wort.
    Visueller Editor
    Visueller Editor
  2. Klicken Sie auf checklist.
    Magisches Wort checklist
    Magisches Wort checklist
  3. Klicken Sie auf Fertig. Es erscheint ein Dialogfenster.
    Dialogfenster für Checklisten
    Dialogfenster für Checklisten

Anschließend wechseln Sie die Reiter, um den gewünschten Typ auszuwählen:

  • Checkbox: Fügt ein einzelnes Kontollkästchen auf der Seite ein.
  • Liste: Fügt ein Drop-down Menü auf der Seite ein.

Einer Seite können mehrere Checkboxen und Listen hinzugefügt werden.

Einfügen einer Checkbox[Bearbeiten | Quelltext bearbeiten]

  1. Klicken Sie auf den Umschalter, um eine leeres Kontrollkästchen zu erstellen. Wenn der Umschalter blau ist, wird das Kästchen als ausgewählt angezeigt.
  2. Klicken Sie auf Einfügen. Das Kontrollkästchen wird nun auf der Seite angezeigt. Schreiben Sie nun den gewünschten Text neben das Kästchen.

Nach dem Speichern der Seite können alle Benutzer das Kontrollkästchen aktivieren und deaktivieren.

Einfügen einer Checkliste[Bearbeiten | Quelltext bearbeiten]

Checklistenvorlage auswählen
Checklistenvorlage auswählen
  1. Wählen Sie im Reiter Liste eine existierende Optionsliste aus.
  2. Unter Gewählte Option legen Sie den angezeigten Standardwert fest.
  3. Klicken Sie auf Fertig.

Nach dem Speichern der Seite können alle Benutzer den ausgewählten Listenwert im Lesemodus ändern.

Listen definieren[Bearbeiten | Quelltext bearbeiten]

Listen müssen vorab als Seiten im Vorlagennamensraum definiert werden.

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

* Wähle Pizza | #000000
* Margherita | #000000
* Schinken | #000000
* Salami | #000000
* Pilze | #00FF00
* Hawaii | #000000
* Gamberetti | #0000FF
* Diavolo | #000000
* Siziliana | #0000FF
* Quattro Formaggi | #00FF00

Beim Speichern dieser Seite erscheint beim Einfügen der Checkliste die Liste "Pizza" in der "Optionsliste".

Farben können mithilfe des HEX-Codes zugewiesen werden:

 * Quattro Formaggi | #00FF00 

Die Farbe #F00FF00 zeigt den Menüpunkt Quattro Formaggi grün an.

Ohne Angabe der Farbe würde der Text standardmäßig schwarz bleiben.
Checkliste als Drop-down-Menü
Checkliste als Drop-down-Menü

Tags im Quelltext hinzufügen[Bearbeiten | Quelltext bearbeiten]

Checklisten können auch direkt im Quelltext erzeugt werden.

Checkbox:
 <bs:checklist type="check" checked="true" /> 

Der Wert des Parameters checked kann true oder false sein, abhängig davon, ob die Checkbox im Ausgangszustand ausgewählt (true) oder nicht ausgewählt (false) sein soll.

Liste:
 <bs:checklist type="list" list="Vorlage:Pizza" value="Pizza auswählen" /> 

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

Sobald das Checklisten-Tag auf der Seite gespeichert wurde, können Benutzer beim Lesen der Seite im Lesemodus und die Werte ändern.

Konfiguration[Bearbeiten | Quelltext bearbeiten]

Folgende Einstellung kann über die Konfigurationsverwaltung vorgenommen werden:

  • Checklistenänderungen als geringfügige Änderungen markieren: Wenn diese Einstellung aktiviert ist, werden Änderungen an einer Checkliste (z.B. Aktivieren eines Kontrollkästchens) im Ansichtsmodus als geringfügige Änderungen protokolliert. Wenn diese Einstellung inaktiv ist, wird eine Änderung der Checkliste als normale Version aufgezeichnet.
    kleinere Bearbeitung
    kleinere Bearbeitung

Verwandte Themen

{{DISPLAYTITLE:Checklisten}}
        
        __TOC__
        

        '''BlueSpiceChecklist''' ermöglicht das Einfügen von Checkboxen und Checklisten in eine Seite z.B. für Aufgabenlisten mit Verantwortlichkeiten und Statusangaben.  
        

        ==Das magische Wort "checklist"==
        
        Es ist einfach, eine Checkbox oder Checklisten in eine Wiki-Seite einzufügen. Wenn eine Wiki-Seite eine Checkliste enthält, kann jeder Benutzer mit dem Recht ''checklistmodify'' die Checklistenwerte aktualisieren, ohne in den Bearbeitungsmodus zu wechseln. Dies sind standardmäßig Benutzer in den Rollen ''editor'', ''author'', ''maintenanceadmin'' und ''bot''.
        

        {{Box Note|boxtype=note|Note text=Wenn ein Benutzer mit Leseberechtigungen den Wert eines Kontrollkästchens oder einer Dropdown-Liste ändert, wird der Wert nicht gespeichert. Beim Aktualisieren der Seite wird der zuletzt gespeicherte Wert wieder angezeigt.}}
        

        Um eine Checkbox (Kontrollkästchen) oder eine Checkliste auf einer Seite einzufügen:
        

        #'''Klicken''' Sie im visuellen Editor '''auf''' ''Einfügen > Mehr > Magisches Wort''.[[Datei:Handbuch:VE-insert-magicwordDE.png|alternativtext=Visueller Editor|zentriert|mini|220x220px|Visueller Editor|verweis=https://de.wiki.bluespice.com/wiki/Datei:Handbuch:VE-insert-magicwordDE.png]]
        
        #'''Klicken''' Sie '''auf''' ''checklist''.[[Datei:Checklist2.png|thumb|verweis=https://de.wiki.bluespice.com/wiki/Datei:Checklist2.png|alternativtext=Magisches Wort checklist|zentriert|450x450px|Magisches Wort ''checklist'']]
        
        #'''Klicken''' Sie '''auf''' ''Fertig''. Es erscheint ein Dialogfenster.<br />[[Datei:Handbuch:magicword-dialog.png|alternativtext=Dialogfenster für Checklisten|zentriert|mini|250x250px|Dialogfenster für Checklisten|verweis=https://de.wiki.bluespice.com/wiki/Datei:Handbuch:magicword-dialog.png]]
        

        Anschließend wechseln Sie die Reiter'','' um den gewünschten Typ auszuwählen:
        

        *''Checkbox:'' Fügt ein einzelnes Kontollkästchen auf der Seite ein.
        
        *Liste: Fügt ein Drop-down Menü auf der Seite ein.
        

        Einer Seite können mehrere Checkboxen und Listen hinzugefügt werden.
        

        ===Einfügen einer Checkbox===
        

        #'''Klicken''' Sie '''auf''' den Umschalter, um eine leeres Kontrollkästchen zu erstellen. Wenn der Umschalter blau ist, wird das Kästchen als ausgewählt angezeigt.
        
        #'''Klicken''' Sie '''auf''' Einfügen. Das Kontrollkästchen wird nun auf der Seite angezeigt. Schreiben Sie nun den gewünschten Text neben das Kästchen.
        

        Nach dem Speichern der Seite können alle Benutzer das Kontrollkästchen aktivieren und deaktivieren.
        

        ===Einfügen einer Checkliste===
        
        [[Datei:Checklist4.png|thumb|verweis=https://de.wiki.bluespice.com/wiki/Datei:Checklist4.png|alternativtext=Checklistenvorlage auswählen|zentriert|400x400px|Checklistenvorlage auswählen]]
        

        #'''Wählen''' Sie im Reiter ''Liste'' eine [[#Listen definieren|existierende Optionsliste]] '''aus'''.
        
        #Unter ''Gewählte Option'' '''legen''' Sie den angezeigten Standardwert '''fest'''.
        
        #K'''licken''' Sie '''auf''' ''Fertig''.
        

        Nach dem Speichern der Seite können alle Benutzer den ausgewählten Listenwert im Lesemodus ändern.
        
        ==Listen definieren==
        
        Listen müssen vorab als Seiten im Vorlagennamensraum definiert werden.
        

        Wenn Sie beispielsweise eine Liste von Pizzas erstellen möchten, in der eine bestimmte Pizza ausgewählt werden kann, muss eine Seite ''Vorlage:Pizza'' mit folgendem Inhalt existieren:
        
<pre>
        
        * Wähle Pizza | #000000
        
        * Margherita | #000000
        
        * Schinken | #000000
        
        * Salami | #000000
        
        * Pilze | #00FF00
        
        * Hawaii | #000000
        
        * Gamberetti | #0000FF
        
        * Diavolo | #000000
        
        * Siziliana | #0000FF
        
        * Quattro Formaggi | #00FF00
        </pre>
        

        Beim Speichern dieser Seite erscheint beim Einfügen der Checkliste die Liste "Pizza" in der "Optionsliste".
        

        Farben können mithilfe des [https://de.wikipedia.org/wiki/Hexadezimale_Farbdefinition HEX-Codes] zugewiesen werden:
        <pre> * Quattro Formaggi | #00FF00 </pre>
        
        Die  Farbe #F00FF00 zeigt den Menüpunkt Quattro Formaggi  grün an.
        
        Ohne Angabe der Farbe würde der Text standardmäßig schwarz bleiben.[[Datei:Checklist5.png|thumb|verweis=https://de.wiki.bluespice.com/wiki/Datei:Checklist5.png|alternativtext=Checkliste als Drop-down-Menü|zentriert|550x550px|Checkliste als Drop-down-Menü]]
        
        ==Tags im Quelltext hinzufügen==
        
        Checklisten können auch direkt im Quelltext erzeugt werden.
        

        Checkbox:<pre> <bs:checklist type="check" checked="true" /> </pre>
        
        Der Wert des Parameters ''checked'' kann ''true'' oder ''false'' sein, abhängig davon, ob die Checkbox im Ausgangszustand ausgewählt (true) oder nicht ausgewählt (false) sein soll.
        

        Liste:<pre> <bs:checklist type="list" list="Vorlage:Pizza" value="Pizza auswählen" /> </pre>
        
        Der Parameter ''list'' legt die Seite fest, auf der sich die vordefinierte Liste befindet, ''value'' legt den Wert fest, der voreingestellt sein soll.
        

        Sobald das Checklisten-Tag auf der Seite gespeichert wurde, können Benutzer beim Lesen der Seite im Lesemodus und die Werte ändern.
        

        ==Konfiguration==
        
        Folgende Einstellung kann über die Konfigurationsverwaltung vorgenommen werden:
        
        {{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#BlueSpiceChecklist}}
        
        {{Box Links|Thema1=[[Referenz:BlueSpiceChecklist]]}}
        

        [[en:Manual:Extension/BlueSpiceChecklist]]
        
        [[de:{{FULLPAGENAME}}]]
(kein Unterschied)

Anhänge

Diskussionen