Zuletzt bearbeitet vor 8 Monaten
von Margit Link-Rodrigue

9 Handbuch:Erweiterung/BlueSpicePageTemplates: Unterschied zwischen den Versionen

Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
(15 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
<bookshelf src="Buch:Adminhandbuch" />
{{DISPLAYTITLE:Seitenvorlagen}}
__TOC__
==Merkmale einer Seitenvorlage==
{{#evt:
service=youtube
|id=https://youtu.be/x4_FVwBA0nQ
|dimensions=300
|alignment=right
|description=Video-Tutorial: Seitenvorlagen''' (8:26 Min.)
|container=frame
}}<section begin="training-intro" />Mit Seitenvorlagen können Sie beim Erstellen einer Seite vorgefertigte Inhalte laden. Dies ist  bei oft verwendeten Formaten wie Protokollen oder Prozessbeschreibungen nützlich. Seitenvorlagen enthalten oft auch parameterisierte Vorlagen (z.B. Infoboxen).


{{DISPLAYTITLE:Seitenvorlagen}}
'''Für eine Seitenvorlage gilt:'''
*kann nur von Administratoren aktiviert werden,
*die Vorlagen selbst können von allen Bearbeitern erstellt werden
*nur für neue Seiten verwendbar
* kann auch (Standard-)Vorlagen beinhalten
*erzeugt eine vorbefüllte Seite
*kann auf bestimmte  Namensräume beschränkt werden
 
== Standard-Seitenvorlagen ==
{{BSVersion|bsvFrom=4.2|bsvTo=|bsvFeature=}}
Seitenvorlagen, die standardmäßig installiert sind, können aus der Seitenvorlagenverwaltung gelöscht werden (1).
[[Datei:Handbuch:seitenvorlagen löschen.png|alternativtext=Seitenvorlagen löschen|zentriert|mini|750x750px|Seitenvorlagen löschen (1) oder Inhalte von Seitenvorlagen ändern (2)]]


__TOC__


==Was sind Seitenvorlagen?==
Alternativ können die Vorlagen direkt im Vorlagen-Namensraum angepasst werden. Hierzu klicken Sie auf den Vorlagen-Link in der Spalte ''Vorlage'' (2).
<section begin="training-intro" />


Mit Seitenvorlagen können Sie beim Erstellen einer Seite vorgefertigte Inhalte laden. Dies ist  bei oft verwendeten Formaten wie Protokollen oder Prozessbeschreibungen nützlich. Seitenvorlagen enthalten oft auch parameterisierte Vorlagen (z.B. Infoboxen).<section end="training-intro" />
=== Liste der Standardvorlagen ===
{| class="wikitable" style="width:100%;"
!Seitenvorlage
!Edition
!Beschreibung
|-
|Anleitung
|free, pro
|Schritt-für-Schritt Anleitung erstellen
|-
|Aufforderung zur Stellungnahme
|pro
|Aufforderung zur Stellungnahme
|-
|Aufgabenliste
|free, pro
|Aufgaben verteilen und nachverfolgen
|-
|Entscheidungsmatrix
|pro
|Entscheidungshilfe durch den Vergleich verschiedener Optionen erstellen
|-
|Management-Besprechung
|pro
|Besprechungsprotokoll für regelmäßige Management-Besprechungen erstellen
|-
|Richtlinie
|pro
|Allgemeine Verhaltensrichtlinie anlegen
|-
|Standard-Protokoll
|free
|Besprechungsagenda und Protokoll anlegen
|-
|Statusbericht
|pro
|Stakeholder über den derzeitigen Stand eines Projekts informieren
|-
|Veranstaltung
|pro
|Planungshilfe für Veranstaltungen anlegen
|}


===Merkmale einer Seitenvorlage===
==Eine Seitenvorlage erstellen==
Wiki-Administratoren können existierende Seiten im Vorlagen-Namensraum als Seitenvorlagen definieren. Die Spezialseite ''Spezial:Seitenvorlagenverwaltung'' ist über den Menüpunkt ''Globale Aktionen > Verwaltung > Seitenvorlagen'' erreichbar.[[File:PageTemplates1a.png| thumb | Seitenvorlagenverwaltung|alt=Seitenvorlagenverwaltung|zentriert|650x650px]]


[[Datei:seitenvorlage-auswahl.png|mini|Seitenvorlage auswählen|verweis=Special:FilePath/seitenvorlage-auswahl.png|alternativtext=Seitenvorlage auswählen]]


*kann nur von Administratoren angelegt werden
Wenn eine Seitenvorlage ausgewählt ist, kann diese durch Klicken auf das "Schraubenschlüssel"-Symbol bearbeitet oder durch Klicken auf das Symbol "X" gelöscht werden.
*nur für neue Seiten verwendbar
*kann auch (Standard-)Vorlagen beinhalten
*erzeugt eine vorbefüllte Seite
*kann auf bestimmte  Namensräume beschränkt werden
*Substitution von Variablen möglich
*kann die Erweiterung ''Page Forms'' (Formulare) einbeziehen


==Eine Seitenvorlage erstellen==
Wiki-Administratoren können neue Seitenvorlagen erstellen sowie vorhandene Seitenvorlagen im Seitenvorlagen-Manager bearbeiten und entfernen. Ein Link dorthin befindet sich in der linken Navigation auf der Registerkarte "Globale Aktionen" im Abschnitt "Verwaltung".[[File:PageTemplates1a.png| thumb | Seitenvorlagen-Manager|alternativtext=Seitenvorlagen-Manager|zentriert|650x650px]]{{Box Note|boxtype=note|Note text=Jede Seitenvorlage hängt von einer tatsächlichen Seite im Vorlagennamensraum ab, um den Inhalt bereitzustellen, der bei der Erstellung mit dieser Seitenvorlage in neue Seiten eingefügt wird. Diese Vorlage muss vor dem Erstellen einer Seitenvorlage bereits angelegt sein.}}
Wenn Seitenvorlage ausgewählt ist, kann diese durch Klicken auf das "Schraubenschlüssel"-Symbol bearbeitet oder durch Klicken auf das Symbol "X" gelöscht werden.
Über die Schaltfläche "Plus" oberhalb der Vorlagenliste können neue Vorlagen erstellt werden.
Über die Schaltfläche "Plus" oberhalb der Vorlagenliste können neue Vorlagen erstellt werden.


<br />
<br />Beim Erstellen oder Bearbeiten einer Seitenvorlage müssen alle Felder ausgefüllt sein:
===Vorlagenfelder===
Beim Erstellen oder Bearbeiten einer Seitenvorlage müssen folgende Felder ausgefüllt werden, bevor die Vorlage gespeichert werden kann.
 
*'''Name''' - der Name der Vorlage
*'''Name''' - der Name der Vorlage
*'''Beschreibung''' - eine kurze Beschreibung des Verwendungszwecks. Diese wird den Benutzern angezeigt.
*'''Beschreibung''' - eine kurze Beschreibung des Verwendungszwecks. Diese wird den Benutzern angezeigt.
Zeile 38: Zeile 88:
[[Datei:pagetemplates-edit.png|alternativtext=Erstellen einer Seitenvorlage|zentriert|mini|450x450px|Erstellen einer Seitenvorlage]]
[[Datei:pagetemplates-edit.png|alternativtext=Erstellen einer Seitenvorlage|zentriert|mini|450x450px|Erstellen einer Seitenvorlage]]
<br />
<br />
===Verwenden von Seitenvorlagen beim Erstellen neuer Seiten===
==Verwenden der Seitenvorlage==
Nachdem die Seitenvorlage gespeichert wurde, kann sie zum Erstellen neuer Seiten in Namensräumen verwendet werden, für die die Vorlage festgelegt ist.
Nachdem die Seitenvorlage gespeichert wurde, kann sie zum Erstellen neuer Seiten verwendet werden. Hierbei sind zwei Einstellungen wichtig:
 
Hierbei sind zwei Einstellungen wichtig:


*'''Namensraum zuweisen:''' Seitenvorlagen können mit bestimmten Namensräumen verknüpft werden. Wenn hier ein Namensraum nicht aufgeführt wird, wird die Vorlage entsprechend dort nicht angezeigt.
*'''Namensraum zuweisen:''' Seitenvorlagen können mit bestimmten Namensräumen verknüpft werden. Wenn hier ein Namensraum nicht aufgeführt wird, wird die Vorlage entsprechend dort nicht angezeigt.
Zeile 50: Zeile 98:


<br />
<br />
[[File:PageTemplates3a.png| thumb | Verfügbare Seitenvorlagen beim Erstellen einer neuen Seite|alternativtext=Verfügbare Seitenvorlagen beim Erstellen einer neuen Seite|zentriert|650x650px]]
[[Datei:seitenvorlage-auswahl.png|verweis=https://bs4-de.wiki.bluespice.com/wiki/Spezial:Dateipfad/seitenvorlage-auswahl.png|alternativtext=Seitenvorlage auswählen|zentriert|mini|Seitenvorlage auswählen]]Die [[Handbuch:Erweiterung/BlueSpicePageTemplates/Anpassung|Darstellung der Seite kann im Wiki]] über CSS angepasst werden.
 
 
 
<br />
==Technische Details==
Seitenvorlagen basieren auf der Erweiterung [[Referenz:BlueSpicePageTemplates|BlueSpicePageTemplates]].
==Tipps zum Arbeiten mit Seitenvorlagen==


*Seitenvorlagen eignen sich besonders zum Entwerfen von Strukturen für Protokolle und Arbeitsanweisungen, sie eignen sich aber auch hervorragend für typische Geschäfts- oder Produktdaten für Marketing, Vertrieb und Produktmanagement.
==Konfiguration==
{{#dpl:title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#BlueSpicePageTemplates}}


{{Box Links|Thema1=[[Referenz:BlueSpicePageTemplates]]}}
{{Box Links|Thema1=[[Referenz:BlueSpicePageTemplates]]}}

Version vom 8. September 2022, 12:41 Uhr

Merkmale einer Seitenvorlage[Bearbeiten | Quelltext bearbeiten]

{{#evt:

service=youtube
|id=https://youtu.be/x4_FVwBA0nQ 
|dimensions=300
|alignment=right
|description=Video-Tutorial: Seitenvorlagen (8:26 Min.)
|container=frame

}}

Mit Seitenvorlagen können Sie beim Erstellen einer Seite vorgefertigte Inhalte laden. Dies ist bei oft verwendeten Formaten wie Protokollen oder Prozessbeschreibungen nützlich. Seitenvorlagen enthalten oft auch parameterisierte Vorlagen (z.B. Infoboxen).

Für eine Seitenvorlage gilt:

  • kann nur von Administratoren aktiviert werden,
  • die Vorlagen selbst können von allen Bearbeitern erstellt werden
  • nur für neue Seiten verwendbar
  • kann auch (Standard-)Vorlagen beinhalten
  • erzeugt eine vorbefüllte Seite
  • kann auf bestimmte  Namensräume beschränkt werden

Standard-Seitenvorlagen[Bearbeiten | Quelltext bearbeiten]

ist ab BlueSpice 4.2 enthalten.

Seitenvorlagen, die standardmäßig installiert sind, können aus der Seitenvorlagenverwaltung gelöscht werden (1).

Seitenvorlagen löschen
Seitenvorlagen löschen (1) oder Inhalte von Seitenvorlagen ändern (2)


Alternativ können die Vorlagen direkt im Vorlagen-Namensraum angepasst werden. Hierzu klicken Sie auf den Vorlagen-Link in der Spalte Vorlage (2).

Liste der Standardvorlagen[Bearbeiten | Quelltext bearbeiten]

Seitenvorlage Edition Beschreibung
Anleitung free, pro Schritt-für-Schritt Anleitung erstellen
Aufforderung zur Stellungnahme pro Aufforderung zur Stellungnahme
Aufgabenliste free, pro Aufgaben verteilen und nachverfolgen
Entscheidungsmatrix pro Entscheidungshilfe durch den Vergleich verschiedener Optionen erstellen
Management-Besprechung pro Besprechungsprotokoll für regelmäßige Management-Besprechungen erstellen
Richtlinie pro Allgemeine Verhaltensrichtlinie anlegen
Standard-Protokoll free Besprechungsagenda und Protokoll anlegen
Statusbericht pro Stakeholder über den derzeitigen Stand eines Projekts informieren
Veranstaltung pro Planungshilfe für Veranstaltungen anlegen

Eine Seitenvorlage erstellen[Bearbeiten | Quelltext bearbeiten]

Wiki-Administratoren können existierende Seiten im Vorlagen-Namensraum als Seitenvorlagen definieren. Die Spezialseite Spezial:Seitenvorlagenverwaltung ist über den Menüpunkt Globale Aktionen > Verwaltung > Seitenvorlagen erreichbar.

Seitenvorlagenverwaltung
Seitenvorlagenverwaltung


Wenn eine Seitenvorlage ausgewählt ist, kann diese durch Klicken auf das "Schraubenschlüssel"-Symbol bearbeitet oder durch Klicken auf das Symbol "X" gelöscht werden.

Über die Schaltfläche "Plus" oberhalb der Vorlagenliste können neue Vorlagen erstellt werden.


Beim Erstellen oder Bearbeiten einer Seitenvorlage müssen alle Felder ausgefüllt sein:

  • Name - der Name der Vorlage
  • Beschreibung - eine kurze Beschreibung des Verwendungszwecks. Diese wird den Benutzern angezeigt.
  • Namensraum - Liste der Namensräume, denen diese Vorlage zugewiesen wird. Soll die Vorlage im gesamten Wiki zur Verfügung gestellt werden, wählen Sie hier (alle) aus.
  • Vorlage - Seite aus dem Vorlagen-Namensraums, aus der die Daten abgerufen werden sollen


Erstellen einer Seitenvorlage
Erstellen einer Seitenvorlage


Verwenden der Seitenvorlage[Bearbeiten | Quelltext bearbeiten]

Nachdem die Seitenvorlage gespeichert wurde, kann sie zum Erstellen neuer Seiten verwendet werden. Hierbei sind zwei Einstellungen wichtig:

  • Namensraum zuweisen: Seitenvorlagen können mit bestimmten Namensräumen verknüpft werden. Wenn hier ein Namensraum nicht aufgeführt wird, wird die Vorlage entsprechend dort nicht angezeigt.
  • Namensraumverwaltung: In der Namensraumverwaltung muss die Funktion PageTemplates aktiviert sein, damit beim Erstellen einer neuen Seite in einem bestimmten Namensraum automatisch die zugehörigen Vorlagen angezeigt werden, wenn z.B. die "+"-Schaltfläche zur Seitenerstellung benutzt wird.

Eine Liste der verfügbaren Vorlagen zur Auswahl wird beim Erstellen einer neuen Seite unterhalb der Standardvorlage "Leere Seite" angezeigt. Durch Auswahl einer dieser Seitenvorlagen wird die neue Seite erstellt und mit dem Inhalt der Seite im Vorlagennamensraum gefüllt.


Seitenvorlage auswählen
Seitenvorlage auswählen

Die Darstellung der Seite kann im Wiki über CSS angepasst werden.

Konfiguration[Bearbeiten | Quelltext bearbeiten]

  • Zielnamensraum erzwingen: Die Seitenvorlage wird immer im Zielnamensraum erstellt, unabhängig davon, welcher Namensraum während der Seitenerstellung angegeben wird.
    Zielnamensraum erzwingen
    Zielnamensraum erzwingen (Beispiel aus englischsprachigem Wiki)
    Im Bild wird angezeigt, dass die Seite NewPage über den Dialog "Neue Seite erstellen" im Hauptnamensraum erstellt werden soll. Wählt der Benutzer die Vorlage To-do List aus, die explizit mit dem QM-Namensraum verknüpft ist, so wird tatsächlich im Wiki die Seite QM:NewPage erstellt, wenn die Einstellung Zielnamensraum erzwingen aktiviert ist.
  • Standardvorlagen ausblenden: Entfernt die Standardvorlage Leere Seite von der Auswahl der Seitenvorlagen beim Erstellen einer neuen Seite.
  • Vorlage ausblenden, wenn die Seite nicht im Zielnamensraum erstellt werden soll: Wenn die Seite in einem bestimmten Namensraum erstellt werden soll, werden nur dort gültige Vorlagen in der Vorlagenauswahl angezeigt.


Weiterführende Links




Feedback zur Dokumentation ist im Community-Forum möglich.

Diskussionen