## Konfiguration Vorlagenerweiterung

### Ziel

Festlegung der Bedingungen zum Ersetzen jeder Vorlage mit einer sogenannten Vorlagenerweiterung ("Replacer" genannte Vorlage).

Die "Originalvorlage" aus ./themes/default/template (oder jede andere Vorlage) wird mit dem sogenannten "Replacer" ersetzt, wenn dieser "Replacer" mit der "Originalvorlage" verlinked ist (oder wenn die URL ein definiertes Schlüsselwort enthält).

Diese Schlüsselwörter befinden sich nach dem Modulnamen in der URL.

Diese URL Schlüsselwörter können auch sogenannte "Permalinks" sein (Lesen Sie den Bereich über Permalinks in der Dokumentation für nähere Informationen).

Lesen Sie das Kapitel `Warnungen` zum Thema Nutzungsbedingungen.

### Was sind Vorlagenerweiterungen?

Vorlagenerweiterungen sind ein leistungsfähiges Werkzeug für Einsteiger und fortgeschrittene Anwender. Über einen FTP Zugang kann der Webmaster die mitgelieferten .tpl Dateien ("Originalvorlagen") unter einem neuen Namen in den Ordner template-extension kopieren ("Replacer"). "Originalvorlagen", aktuelle unterstützte Originalvorlagen sind:

- index.tpl
- mainpage_categories.tpl und/oder thumbnails.tpl
- menubar.tpl
- header.tpl und/oder footer.tpl
- picture_content.tpl und/oder picture.tpl
- profile.tpl und/oder profile_content.tpl
- tags.tpl
- upload.tpl
- about.tpl
- popuphelp.tpl
- search.tpl und/oder search_rules.tpl
- nbm.tpl und/oder notification.tpl
- identification.tpl und/oder register.tpl
- redirect.tpl

### Wo finde ich "Originalvorlagen"?

Mitgelieferte Originalvorlagen befinden sich im Ordner /themes/default/template/ (Verändern Sie nie die mitgelieferten Vorlagen, da sonst Probleme bei späteren Upgrades auftreten können). Jeder Webmaster kann Kopien der Originalvorlagen anfertigen (sogenannte "Replacer (angepasste Vorlagen)") und diese nach seinen Wünschen anpassen.

### Wo kann ich "Replacers" speichern?

Replacers (angepasste Vorlagen) müssen sich im oder unterhalb des Ordners template-extension befinden. Replacers können einen beliebigen Dateinamen mit der Endung .tpl habe, zum Beispiel: template-extension/my-extension/video.tpl.

### Wie aktiviere ich meinen "Replacer"?

Jedem Replacer (angepasste Vorlage) sollte eine Originalvorlage zugewiesen werden, damit dieser Replacer aktiviert wird. Diese Konfiguration wird im Administrationsmenü über die "Vorlagenerweiterung" durchgeführt.

Wenn Sie ein URL Schlüsselwort definieren, wird der Replacer nur auf Seiten angewendet, die dieses Schlüsselwort in der URL enthalten. Zum Beispiel: index.php?/ most_visited

Fortgeschrittene Benutzer verwenden sogenannte Permalinks als URL Schlüsselwörter.

Wenn Sie eine zugewiesene Vorlage ausgewählt haben, wird Ihr Replacer an dieser Vorlage angewendet.

### Wie kann ich meine "Replacers" deaktivieren?

- Deaktivieren Sie die Verbindung zwischen Ihrem Replacer und der "Originalvorlage".
- Löschen Sie Ihren "Replacer" über Ihren FTP Zugang.

### Warnhinweise

- Die definierte Originalvorlage muss wirklich die kopierte Vorlage des Replacers sein, sonst kann der Einsatz des Replacers unvorhersehbare Auswirkungen haben!
- Wenn Sie mehrere Replacers (angepasste Vorlagen) mit der selben Originalvorlage und den selben URL Schlüsselwörtern verwenden, wird nur der letzte Replacer der Liste angewendet.
- Wird kein URL Schlüsselwort ausgewählt, wird der aktive Replacer auf jede Vorlage angwendet. Wie vorhin angemerkt, kann die Reihenfolge der Replacer deren Anwendung beeinflussen.
- Unterordner: Unterordner werden ignoriert, aber sie können verwendet werden, um die Reihenfolge zu verändern.
  distributed-samples: werden für Testzwecke mitgeliefert! Nicht bearbeiten, erstellen Sie Ihre eigenen!
- Wenn Sie einen Replacer löschen, wird die Originalvorlage sofort reaktiviert.