Platzhalter für Verzeichnispfade in Vorlagen nutzen

Veröffentlichungsdatum: 02. Dezember 2011
Änderungsdatum: 23. November 2017

verzeichnis dir erstellen create anlegen vorlage template platzhalter

Verwenden Sie Platzhalter, um bei Erstellen von Verzeichnissen die Verzeichnispfade passend zum angelegten Verzeichnis zu setzen.

Beim Erstellen von Verzeichnissen auf Grundlage einer Verzeichnisvorlage mit Inhalt (Dateien, Unterverzeichnisse) können Sie auf Platzhalter zurückgreifen. Eine Weblication® CMS Liste können Sie auf diese Weise mit den entsprechenden Pfaden auf die neue Verzeichnisstruktur setzen.

Beispiel: Verzeichnisvorlage für News

Gehen wir von der Struktur der aktuellen Meldungen aus der BASE Projektbasis aus, setzt sich diese wie folgt zusammen:

  • /base/aktuelles/index.php
  • /base/aktuelles/meldungen/

Es besteht eine Listendatei (index.php), welche die Meldungen aus dem Unterverzeichnis /meldungen ausliest.

Um nun die gleiche Struktur in anderen Bereichen zu schaffen, verwenden Sie eine Verzeichnisvorlage, die alle erforderlichen Dateien und Unterverzeichnisse bereits enthält.

Sie können zum Anlegen dieser Verzeichnisvorlage wie folgt vorgehen.

Schritt 1: Kopieren der bestehenden Struktur als Vorlage

Im Beispiel verwenden wir das Verzeichnis /aktuelles als Grundlage für unsere Vorlage. Dieses Verzeichnis inkl. Dateien und Unterverzeichnisse können Sie entweder manuell über FTP oder auch über das PHP-Framework kopieren.

Beispiel: Inhalt des Skriptes, um /aktuelles als Verzeichnisvorlage zu kopieren

include($_SERVER['DOCUMENT_ROOT'].'/weblication/grid.php');
wRepository::copyDirectory('/base/aktuelles/', '/base/weblication/templates/directories/news');

Wenn Sie das PHP-Framework zum Kopieren verwenden, rufen Sie das unter der lizenzierten Domain abgelegte Skript mit oben angeführtem Inhalt (auf Ihre Pfade angepasst) auf. Danach haben Sie dieses Verzeichnis mit angegebenem neuen Namen (hier: /news) als Vorlage innerhalb des gewünschten Templatesverzeichnisses abliegen.

Schritt 2: Kopierte Verzeichnisvorlagen anpassen

Die Verzeichnisvorlagen erreichen Sie entweder über das Inhaltsprojekt im Backend (als Administrator). Oder Sie rufen die Verzeichniseinstellungen (Register Vorlagen) des betreffenden Verzeichnisses auf (im Beispiel also die von /base).

BASE Verzeichnisvorlagen aufrufen
BASE Verzeichnisvorlagen aufrufen
BASE Verzeichniseinstellungen - Register Vorlagen
BASE Verzeichniseinstellungen - Register Vorlagen

Durch Klick auf den Button "Vorlagen bearbeiten" bzw. "Eigene Verzeichnisvorlagen verwalten" rufen Sie den Bereich für die Verzeichnisvorlagen des entsprechenden Verzeichnisses (hier: /base) auf.

Bearbeiten Sie hier nun das Verzeichnis /news nach Ihren Vorstellungen (z.B. Templateinformationen einpflegen, etc.).

BASE Verzeichniseinstellungen der Newsvorlage (Templateinformationen)
BASE Verzeichniseinstellungen der Newsvorlage (Templateinformationen)

Tipp:
Löschen Sie aus dem /meldungen Verzeichnis dieser Verzeichnisvorlage die kopierten Meldungen raus, bei Bedarf auch die rss.php aus /news.

Schritt 3: Platzhalter setzen

Um beim Erstellen eines Aktuelles-Bereiches auf Grundlage dieser Verzeichnisvorlage die korrekten Pfadangaben im neuen Verzeichnis zu haben, definieren Sie an den entsprechenden Stellen Platzhalter für den Verzeichnisnamen. Hierfür stehen beim Erstellen von Verzeichnissen folgende Platzhalter zur Verfügung:

  • $WONCREATEDIR['destPath']
    Beim Erstellen eines Verzeichnisses wird dieser Platzhalter in der Verzeichnisvorlage durch den Pfad des neuen Verzeichnisses ersetzt.
    Wird z.B. innerhalb /base/marketing ein Verzeichnis mit dem Namen "neues" auf Grundlage der news-Verzeichnisvorlage erstellt, so wird der Platzhalter durch /base/marketing/neues ersetzt.
    z.B.:
    $WONCREATEDIR['destPath']/meldungen -> /base/marketing/neues/meldungen
  • $WONCREATEDIR['destName']
    Beim Erstellen eines Verzeichnisses wird dieser Platzhalter in der Verzeichnisvorlage durch den Namen des neuen Verzeichnisses ersetzt.
    Wird z.B. innerhalb /base/marketing ein Verzeichnis mit dem Namen "neues" auf Grundlage der news-Verzeichnisvorlage erstellt, so wird der Platzhalter durch neues ersetzt.
    z.B.:
    /base/marketing/$WONCREATEDIR['destName']/meldungen -> /base/marketing/neues/meldungen

 Dies wird nachfolgend anhand der Bearbeitenmasken für die "Schaltfläche, um eine neue Datei zu erstellen" und den "Listenoptionen" veranschaulicht.

$WONCREATEDIR['destPath'] Platzhalter innerhalb der Datei der Verzeichnisvorlage news/index.php
$WONCREATEDIR['destPath'] Platzhalter innerhalb der Datei der Verzeichnisvorlage news/index.php
PHP-Framework Funktion: wRepository::copyDirectory
Onlinedokumentation - Inhaltsvorlagen - Verzeichnisse
Onlinedokumentation - Verzeichniseinstellungen - Vorlagen
FAQs
Wozu nutzt man Platzhalter in Verzeichnisvorlagen beim Erstellen von Verzeichnissen?
Platzhalter werden verwendet, um die Verzeichnispfade in einer Vorlage automatisch passend zum neu angelegten Verzeichnis zu setzen. Dadurch lässt sich z. B. eine Weblication® CMS Liste mit den richtigen Pfaden auf die neue Verzeichnisstruktur übertragen.
Wie können Verzeichnisvorlagen mit Inhalt (Dateien und Unterverzeichnisse) die Zielstruktur übernehmen?
Wenn Verzeichnisse auf Basis einer Verzeichnisvorlage mit Inhalt erstellt werden (z. B. Dateien und Unterverzeichnisse), können Sie in dieser Vorlage Platzhalter nutzen, damit die Pfadangaben beim Anlegen in der neuen Struktur automatisch korrekt sind.
Wie sieht das Beispiel einer Verzeichnisvorlage für News typischerweise aus?
Im Beispiel basiert die Vorlage auf der Struktur der aktuellen Meldungen. Diese setzt sich zusammen aus einer Listendatei (z. B. <code class="codeInline">/base/aktuelles/index.php</code>), die Meldungen aus dem Unterverzeichnis <code class="codeInline">/base/aktuelles/meldungen/</code> ausliest. Für andere Bereiche wird dann eine Verzeichnisvorlage verwendet, die die erforderlichen Dateien und Unterverzeichnisse bereits enthält (z. B. als <code class="codeInline">/base/weblication/templates/directories/news</code>).
Wie erstellt man eine Verzeichnisvorlage, indem man eine bestehende Struktur kopiert?
Sie können die bestehende Struktur (inkl. Dateien und Unterverzeichnisse) aus dem Quellverzeichnis (im Beispiel <code class="codeInline">/aktuelles</code>) kopieren, entweder manuell per FTP oder über das PHP-Framework. Anschließend wird das Verzeichnis mit dem gewünschten neuen Namen (im Beispiel <code class="codeInline">news</code>) als Vorlage im Templatesverzeichnis abgelegt.
Wie kann man im Beispiel das Verzeichnis <code class="codeInline">/aktuelles</code> als Vorlage kopieren?
Über ein PHP-Skript mit dem Framework: <code class="codeInline">include($_SERVER['DOCUMENT_ROOT'].'/weblication/grid.php');</code> und <code class="codeInline">wRepository::copyDirectory('/base/aktuelles/', '/base/weblication/templates/directories/news');</code>. Das Skript wird unter der lizenzierten Domain aufgerufen und erstellt die Vorlage unter dem neuen Namen.
Wo und wie passen Administratoren die kopierten Verzeichnisvorlagen an?
Die Verzeichnisvorlagen erreichen Sie entweder über den entsprechenden Administrationsbereich (als Administrator) oder über die Oberfläche des betreffenden Verzeichnisses. Im Beispiel wird erläutert, die Vorlagen über die BASE-Verzeichniseinstellungen aufzurufen und dann z. B. die Vorlage <code class="codeInline">/news</code> zu bearbeiten (z. B. Templateinformationen einpflegen).
Welcher Tipp wird für das Anpassen der Newsvorlage genannt?
Löschen Sie aus dem <code class="codeInline">/meldungen</code>-Verzeichnis der Verzeichnisvorlage die kopierten Meldungen heraus. Falls erforderlich, löschen Sie auch die <code class="codeInline">rss.php</code> aus dem entsprechenden Vorlagenverzeichnis (z. B. <code class="codeInline">news</code>).
Welche Platzhalter stehen beim Erstellen von Verzeichnissen in der Verzeichnisvorlage zur Verfügung?
Für die automatische Anpassung beim Erstellen stehen zwei Platzhalter zur Verfügung: - <code class="codeInline">$WONCREATEDIR['destPath']</code>: Wird beim Erstellen durch den Pfad des neuen Verzeichnisses ersetzt (z. B. <code class="codeInline">/base/marketing/neues</code>). - <code class="codeInline">$WONCREATEDIR['destName']</code>: Wird beim Erstellen durch den Namen des neuen Verzeichnisses ersetzt (z. B. <code class="codeInline">neues</code>).
Wie funktioniert <code class="codeInline">$WONCREATEDIR['destPath']</code> in einem Beispiel konkret?
Wenn in der Vorlage z. B. <code class="codeInline">$WONCREATEDIR['destPath']/meldungen</code> verwendet wird und innerhalb von <code class="codeInline">/base/marketing</code> ein Verzeichnis namens <code class="codeInline">neues</code> erstellt wird, ersetzt sich der Platzhalter durch <code class="codeInline">/base/marketing/neues</code>. Ergebnis wäre dann <code class="codeInline">/base/marketing/neues/meldungen</code>.
Wie funktioniert <code class="codeInline">$WONCREATEDIR['destName']</code> in einem Beispiel konkret?
Wenn in der Vorlage z. B. <code class="codeInline">/base/marketing/$WONCREATEDIR['destName']/meldungen</code> verwendet wird und das neue Verzeichnis den Namen <code class="codeInline">neues</code> erhält, wird <code class="codeInline">$WONCREATEDIR['destName']</code> durch <code class="codeInline">neues</code> ersetzt. Ergebnis wäre dann <code class="codeInline">/base/marketing/neues/meldungen</code>.
Wozu nutzt man die Platzhalter in bestimmten Dateien der Verzeichnisvorlage (z. B. <code class="codeInline">news/index.php</code>)?
Die Platzhalter werden in den Dateien der Verzeichnisvorlage verwendet, um sicherzustellen, dass beim späteren Erstellen eines neuen Bereichs die Pfadangaben korrekt auf die neue Verzeichnisstruktur zeigen. Im Beispiel wird dies anhand von Bearbeitungsmasken (z. B. „Schaltfläche, um eine neue Datei zu erstellen“) und Listenoptionen veranschaulicht.