✎ struct-Plugin: selbst definierte Meta-Daten zu Seiten hinzufügen, anhand derer dann (gefilterte) Auflistungen erstellt werden können [Umweltschuzzug WIKI]

<h1 class="page-header pb-3 mb-4 mt-5"><svg viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" role="presentation" class="iconify mr-2"><path d="M13 9h5.5L13 3.5V9M6 2h8l6 6v12a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V4c0-1.11.89-2 2-2m9 16v-2H6v2h9m3-4v-2H6v2h12z"/></svg> struct-Plugin: selbst definierte Meta-Daten zu Seiten hinzufügen, anhand derer dann (gefilterte) Auflistungen erstellt werden können</h1>
<div class="level1">

<p>
<img src="/lib/images/smileys/icon_exclaim.gif" class="icon" alt=":!:" /> <b>Diese Anleitung ist noch nicht fertig</b> <img src="/lib/images/smileys/icon_exclaim.gif" class="icon" alt=":!:" />
</p>

<p>
&lt;WRAP center round info 100%>
Das struct-Plugin ist sehr mächtig, aber teilweise auch komplex in der Einrichtung. Auf dieser Seite kann nur ein kurzer Überblick gegeben werden. Es wird empfohlen, sich zuerst bei der <a href="https://www.dokuwiki.org/oIWIKIoplugin%3AstructcIWIKIc" class="interwiki iw_doku" target="_blank" title="https://www.dokuwiki.org/oIWIKIoplugin%3AstructcIWIKIc" rel="noopener">Dokumentation des struct-Plugins auf dokuwiki.org</a> zu informieren.
&lt;/WRAP>
</p>

<p>
&lt;WRAP center round download 100%>
Für das struct-Plugin wird das <a href="https://www.dokuwiki.org/oIWIKIoplugin%3AsqlitecIWIKIc" class="interwiki iw_doku" target="_blank" title="https://www.dokuwiki.org/oIWIKIoplugin%3AsqlitecIWIKIc" rel="noopener">sqlite-Plugin</a> benötigt, was zuvor <a href="/doku.php?id=wiki:hilfe:plugins:plugins_installieren" class="wikilink1" title="wiki:hilfe:plugins:plugins_installieren" data-wiki-id="wiki:hilfe:plugins:plugins_installieren">installiert</a> werden muss.
&lt;/WRAP>
</p>

<p>
Das struct-Plugin kann in zwei verschiedenen Modi betrieben werden:
</p>
<ul class="fix-media-list-overlap">
<li class="level1"> mit <b>Page Schemas</b> kann pro Seite ein Datensatz hinzugefügt werden. In diesem Datensatz können mehrere Felder mit Werten belegt werden. Diese Daten sind dann fest an die Seite gebunden. Sie könnten dies mit einer Excel-Tabelle vergleichen, und jede Wiki-Seite hat eine Zeile in der Werte eingetragen werden können. Es können dann z.B. Auflistungen erstellt werden, die anhand der Feldwerte gefiltert werden.</li>
<li class="level1"> mit <b>Global Schemas</b> kann eine Datenbanktabelle erstellt werden, die nicht an eine spezielle Wikiseite gebunden ist. Sie könnten dies mit einer Excel-Tabelle vergleichen, die komplett mit allen Zeilen und Spalten dargestellt wird. Sie können diese Daten aber mehrfach auf verschiedenen Wiki-Seiten verwenden. Zum Beispiel könnten Sie auf einer Wiki-Seite zu der nur Administratoren Zugang haben eine Liste aller Dokumente anzeigen, aber auf einer Seite im allgemein zugänglichen Bereich nur die Infos anzeigen die derzeit aktuell sind. Schauen Sie sich zur Verdeutlichung unten das Beispiel <em>Straßensperrungen</em> an.</li>
</ul>

<p>
Die Möglichkeiten des Plugins sollen anhand von zwei Beispielen verdeutlicht werden:
</p>

</div>

<h2 class="page-header pb-3 mb-4 mt-5">Global-Schema: Liste von Straßensperrungen</h2>
<div class="level2">

<p>
Nachdem Sie das Plugin installieren, gehen Sie wie folgt vor:
</p>

<p>
Öffnen Sie den <a href="/doku.php?id=wiki:hilfe:administration:admin-bereich" class="wikilink1" title="wiki:hilfe:administration:admin-bereich" data-wiki-id="wiki:hilfe:administration:admin-bereich">Admin-Bereich</a>.
</p>

<p>
Klicken Sie im Admin-Bereich nun auf den Link <b>Struct Schema Editor</b>:
</p>

<p>
Jetzt öffnet sich die Maske um ein neues Schema anzulegen. Wie auch bei den Seitennamen des Wikis, sollten keine Großbuchstaben oder Sonderzeichen verwendet werden. Wir nennen dieses Schema <code>strassensperrungen</code>.
</p>
<hr />

<p>
Klicken Sie nun auf Speichern, um das Schema anzulegen. Im nächsten Schritt definieren Sie die Feldnamen (Spaltennamen). Wir definieren hier die Felder <code>strassenname</code>, <code>gueltig_von</code>, <code>gueltig_bis</code> und <code>beschreibung</code>.
</p>
<hr />

<p>
Einige Teile des Schemas werden schon vorausgefüllt. Beachten Sie, dass zuerst nur die Reihe für das erste Feld angezeigt wird, und erst nach einem Klick auf <b>Save</b> unter dem Formular die nächste Reihe erzeugt wird. An folgenden Stellen müssen wir Eingaben bzw. Änderungen vornehmen:
</p>

</div>

<h4>Erste Reihe: strassenname</h4>
<div class="level4">

<p>
Tragen Sie neben dem Feldnamen <code>strassenname</code> in der Spalte <em>Konfiguration</em> bei <b>label</b> den Wert ein, der später bei der Ausgabe als sichtbare Beschreibung angezeigt werden soll; hier <code>Straßenname</code>. Der Feldname <code>strassenname</code> wird nur für technische Zwecke verwendet und ist für den Endanwender nicht sichtbar, dieser bekommt nur den bei <em>label</em> eingetragenen Wert zu Gesicht. Klicken Sie nun auf <b>Save</b>, um die Reihe zu speichern und die nächste Reihe zu erzeugen.
</p>

</div>

<h4>Zweite Reihe: gueltig_von</h4>
<div class="level4">

<p>
Tragen Sie als Feldname <code>gueltig_von</code> ein. Wählen Sie nun in der Spalte <em>Eingeben</em> aus der Liste den Eintrag <code>Date</code> aus, um das Feld als Datumsfeld zu definieren. Nun vergeben Sie wieder ein aussagekräftiges label für das Feld, hier <code>gültig von</code>. Zusätzlich Ändern Sie im Feld <code>format</code> das Datumsformat vom amerikanischen Standard <code>Y/m/d</code> auf das deutsche Standardformat <code>d.m.Y</code> (Tag, Monat, Jahr). Klicken Sie nun wieder auf <b>Save</b>.
</p>

</div>

<h4>Dritte Reihe: gueltig_bis</h4>
<div class="level4">

<p>
Diese Reihe entspricht der zweiten Reihe, mit dem einzigen Unterschied dass Sie für Feldname und Label jeweils <b>bis</b> statt <b>von</b> schreiben. Bestätigen Sie wieder mit <b>Save</b>.
</p>

</div>

<h4>Vierte Reihe: Beschreibung</h4>
<div class="level4">

<p>
Tragen Sie als Feldname <code>beschreibung</code> ein. Wählen Sie nun in der Spalte <em>Eingeben</em> aus der Liste den Eintrag <code>LongText</code> aus. Damit wird statt einer einzelnen Eingabezeile ein größerer (mehrzeiliger) Eingabebereich für einen längeren Text erzeugt. Geben Sie auch hier wieder ein aussagekräftiges Label (<em>Beschreibung</em>) ein. Nach einem weiteren Klick auf <b>Save</b> haben Sie das Schema fertig angelegt.
</p>

</div>

<h3 class="page-header pb-3 mb-4 mt-5">Seite zur Anzeige der Daten anlegen</h3>
<div class="level3">

<p>
Als nächstes wird eine Seite angelegt, auf der die Daten angezeigt werden. Öffnen Sie dazu zum Beispiel die Seite <a href="/doku.php?id=lokal:strassensperrungen" class="wikilink2" title="lokal:strassensperrungen" rel="nofollow" data-wiki-id="lokal:strassensperrungen">:lokal:strassensperrungen</a>, und tragen Sie auf diese den folgenden Code ein:
</p>
<pre class="code">====== Straßensperrungen ======

---- struct global ----
schema: strassensperrungen
filter: gueltig_bis >= $TODAY$
----

</pre><p> </p>

<p>
Beachten Sie dabei, dass hier gleich ein Filter angewendet wird. Dieser sorgt dafür, dass nur Datensätze angezeigt werden die bis heute oder einem späteren Zeitpunkt gültig sind. Datensätze deren Gültigkeit abgelaufen ist werden nicht angezeigt.
</p>

<p>
Bisher sind allerdings noch keine Daten eingetragen, und Sie sehen ein leeres Formular:
</p>

<p>
Tragen Sie nun mehrere Testeinträge ein. Versuchsweise können Sie auch ein <em>gültig bis</em>-Datum verwenden, das in der Vergangenheit liegt. Dieses wird dann nicht angezeigt.<br/>
Für diese Formulareinträge gelten übrigens die gleichen Zugriffsregeln wie für Wiki-Seiten; wer bearbeiten darf, der darf auch Formulareinträge anlegen. Wer nur lesen darf, darf nur die Einträge anzeigen.
</p>

<p>
Wenn Sie mehrere Testeinträge verfasst haben, könnte die Seite folgendermaßen aussehen:
</p>

<p>
Falls Sie darauf bedacht sind, die Straßensperrungen nach dem Ende nicht nur wie oben beschrieben auszublenden, sondern komplett zu löschen, stehen Sie nun vor dem Problem dass Sie die abgelaufenen Datensätze ja nicht mehr sehen und deswegen auch nicht löschen können. Doch die Lösung ist einfach. Legen Sie sich eine Seite an auf der Sie die Daten pflegen, z.B. <a href="/doku.php?id=lokal:admin" class="wikilink2" title="lokal:admin" rel="nofollow" data-wiki-id="lokal:admin">:lokal:admin</a>. Auf diese Seite schreiben Sie dann folgenden Wiki-Code:
</p>
<pre class="code">====== Verwaltung lokaler Bereich ======

===== Straßensperrungen verwalten =====

---- struct global ----
schema: strassensperrungen
----

</pre><p> </p>

<p>
Hier wird kein Filter angewendet, und Sie können alte Einträge nach Belieben löschen.
</p>

</div>

<h2 class="page-header pb-3 mb-4 mt-5">Page Schema: --folgt noch--</h2>
<div class="level2">

</div>

<h2 class="page-header pb-3 mb-4 mt-5">Installation des Plugins</h2>
<div class="level2">

<p>
Dieses Plugin ist in der Standard-Einsatzleiterwiki-Installation nicht enthalten. Eine Anleitung, wie Sie ein Plugin installieren, finden Sie auf <a href="/doku.php?id=wiki:hilfe:plugins:plugins_installieren" class="wikilink1" title="wiki:hilfe:plugins:plugins_installieren" data-wiki-id="wiki:hilfe:plugins:plugins_installieren">dieser Seite</a>.
</p>

<p>
<a href="https://www.dokuwiki.org/plugin%3Astruct" class="interwiki iw_doku" target="_blank" title="https://www.dokuwiki.org/plugin%3Astruct" rel="noopener">Dokumentation des struct-Plugins auf dokuwiki.org</a>
</p>

</div>

Aktiviere komplexe Tabellen Editorhöhe px Zusätzliche Unterstützung beim Einfügen von Bildern aus der Zwischenablage Ein

Zusammenfassung: Kleine Änderungen