PHPKIT WCMS Dokumentation

Das PHPKIT WCMS verwendet zur Darstellung der Website Vorlagen in Form von Templates in der Scriptsprache HTML. Diese sind auf dem Webserver als Dateien vorhanden und werden nach einer Bearbeitung in der Datenbank gespeichert.

Die Art für den Vorgang des Ladens von Templates ist in PHPKIT wie folgt. PHPKIT lädt zunächst immer die Standard-Templates, welches als Datei auch vorhanden ist. Wenn Sie ein Standard-Template bearbeiten, so wird ein Duplikat in der Datenbank erzeugt und sofern dieses Template den selben Namen trägt, wie die Original-Templatedatei, so wird zuerst immer das Template aus der Datenbank vor der Datei geladen und dargestellt.

Diese Prozedur macht es Ihnen einfach, diese Vorlagen als Templates in HTML direkt zu bearbeiten, zu speichern und bei Bedarf die Originaldatei erneut vom Server zu laden.

Sofern Sie schon wissen, wie Sie die Namen der Templates einschalten, können Sie die folgenden Schritte überspringen.

In diesem Tutorial möchten wir Ihnen zeigen, wie Sie die Templates zunächst finden, bearbeiten, speichern und laden können. Mit der Manipulation dieser Vorlagen können Sie das optische Erscheinungsbild von PHPKIT vollkommen verändern. Wenn Sie nicht nur Textausgaben in den Templates verändern möchten, sollten Sie über Kenntnisse in HTML verfügen.

Schritt 1 - Öffnen der Konfiguration

Um die Templatesnamen im Quelltext einzuschalten, klicken Sie zunächst in der Navigation im Administratiosbereich zuerst auf Konfiguration und danach auf Stammdaten.

Schritt 2 - Templatenamen in den Stammdaten aktivieren

In den Stammdaten können Sie grundlegende Einstellungen Ihrer Installation vornehmen. Wir möchten Ihnen in diesem Tutorial eine Option in den weitere Einstellungen erklären. Es handelt sich um die Option Templatenamen im Quelltext. Mit dieser eingeschalteten Optionen, können Sie schnell die richtigen Templates im System finden, welche Sie bearbeiten wollen.

Um mit diesem Tutorial fortzufahren, stellen Sie diese Einstellung der Templatenamen im Quelltext auf ja und danach auf Speichern damit diese Einstellung übernommen wird.

Schritt 3 - Anzeigen des Quelltextes einer Seite im öffentlichen Bereich

Mit der zuvor eingestellten Option sind nun die Namen der Templates im Quelltext als HTML.Kommentar sichtbar. Es handelt sich dabei um eine umschließende Darstellungsweise, wie man Sie zum Beispiel aus HTML her kennt.

<!-- TPL START template1-->
	<!-- TPL START template2-->
		<!-- TPL START template3-->
		<!-- TPL END template3-->
	<!-- TPL END template2-->
<!-- TPL END template1-->

Mit dieser Methode werden Templates in anderen Templates verschachtelt dargestellt. Erkennbar am Anfang mit START und am Ende mit END.

In diesem Tutorial werden wir nun auf der Startseite nach dem verwendeten Template für das Kontaktformular suchen und finden. Klicken Sie zunächst bei Kontakt auf den Verweis Kontaktformular. Alternativ geben Sie diese Adresse in der Adresszeile Ihres Webbrowsers hinter Ihrer Domain ein:

?path=contact

Schritt 4 - Öffnen der Ansicht für den Quelltext

Nachdem Sie das Kontaktformular geladen haben, lassen Sie sich den Quelltext dieser Seite anzeigen.

Je nach Browser kann es anders sein, wie Sie den Quelltext der Seite anzeigen lassen können. Im Mozilla Firefox kann man auch die Tastenkombination Strg+U drücken. Alternativ in der Menüleiste des Browsers Ansicht und danach Seitenquelltext anzeigen auswählen. Das Resultat ist das selbe.

Schritt 5 - Analysieren des Quelltextes vom Kontaktformular

Damit Sie die richtige Stelle finden, empfiehlt es sich nach Übereinstimmungen zu suchen. In unserem Beispiel möchten wir den Vogel aus der twitterbox unter den Buttons Senden und Zurücksetzen anzeigen lassen.

Suchen Sie nach dem auf dieser Seite einmalig vorkommenden Wort Senden. Klicken Sie dazu in das Fenster des Quelltextes für die Website und nutzen Sie dazu die Suchen- und Finden Funktion des Webbrowsers. Im Firefox ist es die Tastenkombination Strg+F. Tragen Sie das Wort Senden in das Suchfeld des Browsers ein und lassen danach suchen.

Anmerkung:
Groß- und Kleinschreibungen spielen bei der Eingabe soweit keine Rolle. Die Suchfunktion berücksichtigt in der Regel beide Varianten, es sei denn man gibt an, dass man zwingend diese Einschränkungen bei den Suchergebnissen berücksichtigen lassen soll.

Des Weiteren sollten Sie nicht nach Sonderzeichen oder Umlauten wie ÄÖÜ suchen, da diese in codiertem HTML geschrieben wurden.

Schritt 6 - Entnehmen des Namens für das Template bzw. die Vorlage

Im Firefox ist es von Vorteil, dass die Kommentare, die in HTML geschrieben sind, grün markiert werden. Somit lässt sich das Template namens: contact schnell ausmachen. Angenehmer Weise wird für die Darstellung des Kontaktformulars nur ein einzelnes Template als Vorlage benutzt. Erkennbar am Anfangskommentar:

<!--TPL START contact -->

und etwas weiter unten am Endkommentar:

<!-- TPL END contact -->

Schritt 7 - Öffnen der Verwaltung für die Vorlagen bzw Templates

Um in die Bearbeitung der Vorlagen bzw. Templates des PHPKIT WCMS zu gelangen. Betreten Sie zunächst den Administrationsbereich. Am besten in einem neuen Browserfenster oder neuen Browsertab, damit Sie zwischen den Fenstern hin und her schalten können. Klicken Sie dazu in der Navigation im Administrationsbereich auf Sonstiges und Vorlagen.

Stellen Sie zunächst sicher, dass im Set der Vorlagen bzw. Templates das Set Standardvorlagen (schreibgeschützt) ausgewählt ist. Wenn nicht, so wählen Sie dieses Set über die Auswahl aus.

Sie haben nun zwei Möglichkeiten das Template aus der Liste der verschiedenen Vorlagen zu finden. Entweder Sie suchen selbst in der Auswahlliste oder suchen mit der komfortablen Suchfunktion des PHPKIT WCMS nach der Vorlage. Dabei reicht es wenn Sie die ersten Buchstaben des zu suchenden Templates eintragen. PHPKIT wird Ihnen Ergebnisse auflisten die mit den eingegebenen Buchstaben in der korrekten Reihenfolge übereinstimmen.

In unserem Beispiel möchten wir die Suchfunktion verwenden. Tragen Sie dazu den Namen contact. In das Suchfeld ein und Klicken Sie auf Suchen.

Schritt 9 - Öffnen des Editors für Templates bzw. Vorlagen

In den Suchergebnissen sehen Sie jetzt 3 Templates die mit contact im Namen als Übereinstimmung haben. Alle haben Ihre eigenen Funktionen, uns interessiert allerdings nur die Vorlage die sich contact nennt. Markieren Sie diese und klicken Sie danach auf Editieren.

Schritt 10 - Die Vorlage des Kontaktformulars bearbeiten

Hier sehen Sie die Bearbeitungsmaske für die Bearbeitung der Vorlagen. In unserem Beispiel möchten wir unter den Buttons Speichern und Zurücksetzen die Grafik des twitter Vogels einfügen, wie er in der Box für twitter abgebildet wird.

Gehen Sie an das Ende der Vorlage (Tastenkürzel Strg+Ende) und fügen Sie nach:

</form>

diesen HTML Tag direkt darunter in einer neuen Zeile ein:

<img border="0" src="fx/default/icons/twitter-bird-half-small.png"  />

Nachdem Sie dieses hinzugefügt haben, Speichern Sie diese bearbeitete Vorlage. Sie werden merken, dass PHPKIT bearbeitete Vorlagen in einem neuen Set namens Eigene Vorlagen in der Datenbank speichert.

Der Vorteil bei dieser Methode der Speicherung besteht darin, dass die Datei des Templates immer noch vorhanden ist und bei Bedarf erneut aus dem Set der Standardvorlagen (schreibgeschützt) laden können.

Schritt 11 - Aktivieren der Vorlage

Öffnen Sie jetzt die Designveraltung mit einem Klick auf Sonstiges und Design

Schritt 12 - Auswählen des aktiven Designs

In dieser Übersicht sehen Sie zum einen das aktive Design und zudem das verwendete Vorlagenpaket. Sofern bei Ihnen Eigene Vorlagen hinter Ihrem aktiven Design stehen sollte, so können Sie sich Ihre Modifikation bereits auf Ihrer Website betrachten.

Sollte das nicht der Fall sein, so wählen Sie jetzt mit einem Klick Ihr aktives Design aus. Dieses erscheint in der Auswahl fettgedruckt.

Schritt 13 - Kontrolle des verwendeten Sets für die Vorlagen

Damit die veränderten Vorlagen geladen werden können, müssen Sie PHPKIT mitteilen, welches Set für Vorlagen mit dem aktiven Design verknüpft sein soll. Kontrollieren Sie daher die Einstellung im Auswahlfeld Vorlagenpaket so dass dort Eigene Vorlagen dort eingestellt sind. Wenn Sie das Vorlangenpaket ausgewählt haben, klicken Sie anschließend noch auf den Pfeil der nach unten zeigt und klicken danach auf Speichern.

Schritt 14 - Die veränderte Vorlage auf der Website

Wie Sie sehen können, haben wir erfolgreich eine Standardvorlage von PHPKIT erfolgreich verändert. Auf die selbe Art und Weise lassen sich alle Templates bzw. Vorlagen verändern und bearbeiten.

Anmerkung:
Dieses Tutorial können Sie auf Ihrer eigenen Website durchführen. Fragen zur Modifikation von Templates stellen Sie bitte in unserem offiziellen Supportforum. Zudem sollten Sie sicherstellen, dass Sie nach einer Bearbeitung der Vorlagen die Namen der Templates bzw. Vorlagen wieder deaktivieren sollten. Diese Einstellung ist nur zum Auffinden der Templates gedacht und könnte sonst im normalen Betrieb stören.