//  01-Newsscript V2 - Copyright 2006 by Michael Lorer - 01-Scripts.de
//  Lizenzinformationen unter: http://www.01-scripts.de/lizenz.php
//  Support unter: http://www.01-scripts.de/support.php
//**  **  **  **  **  **  **  **  **  **  **  **  **  **  **  **  *  *

1. Einfhrung
2. Aufbau einer Template-Datei
3. Wichtige Template-Dateien
4. Text ndern. Wie?
5. Weitere Informationen

1. Einfhrung:
--------------

Templates sind im Prinzip eine Art "Kontainer", der durch die Gestaltungssprache HTML
in seinem Aussehen beliebig verndert werden kann. Diese Template-Kontainer werden
anschlieend durch das 01-Newsscript mit Daten aus der Datenbank gefllt (Newseintrge,
Kommentare, etc.).
Das bedeutet fr Sie, dass an den Templates einfache nderungen am Design vorgenommen werden
knnen ohne das man zu viel am eigentlichen Kernprogramm verndern muss.

Der HTML-Quelltext fr die Ausgabe-Datei ist auf die Template-Dateien (*.html*)
in diesem Ordner und einige wenige Sprachvariablen in der Datei variablen.txt verteilt.

Fr nderungen an den Templates und Sprachvariablen des 01-Newsscripts sind zumindest 
grundlegende HTML-Kenntnisse ntig.

Weiterfhrende Informationen zu HTML finden Sie hier:
http://de.selfhtml.org/


2. Aufbau einer Template-Datei:
-------------------------------

Template-Dateien bestehen im Prinzip aus einfachem HTML-Quellcode, der fr die Darstellung
des Designs verantwortlich ist. Der jeweils aktuelle Inhalt wird dann immer per PHP aus
der Datenbank in die Templates "geschrieben".
Um Beispielsweise den zu einem Newseintrag gehrenden Usernamen auszulesen ist folgender
PHP-Code ntig:

<?PHP echo $username; ?>

<?PHP -> Dieser Teil zeigt dem Browser an, das ab jetzt kein HTML, sondern PHP-Code auszufhren
         ist.
echo $username; -> Diese Zeichenfolge wird spter durch den Usernamen ersetzt.
?>   -> Mit diesem Befehl wird der PHP-Code wieder geschlossen. Danach folgt wieder normales
        HTML.

Zustzlich zu dieser einfachen Ausgabe von Informationen gibt es auch einfache if-Abfragen
(Entscheidungsfragen) in den Templates.
Eine solche Abfrage sieht folgendermaen aus:

<?php if($xyz == 1): ?>
Hier kann HTML-Code stehen, der ausgegeben wird, wenn $xyz = 1 ist.
<?php elseif($xzy == 2): ?>
Hier kann HTML-Code stehen, der ausgegeben wird, wenn $xyz nicht = 1, sondern $xyz = 2 ist.
<?php else: ?>
Hier kann HTML-Code stehen, der ausgegeben wird, wenn $xyz weder 1 noch 2 ist.
<?php endif; ?> //Dieser Befehl beendet die if-Abfrage

Der Rest der Templates besteht aus reinem HTML-Code und kann mit etwas Hintergrundwissen
problemlos bearbeitet und gendert werden.
Bei Fragen oder Problemen stehe ich Ihnen gerne ber das 01-Supportforum zur Verfgung:
http://board.01-scripts.de

3. Wichtige Template-Dateien
----------------------------

Folgende Template-Dateien, die sich alle im Verzeichnis 01news/01newstemplates/ befinden,
werden vom 01-Newsscript verwendet:

-commentbit.html      Dieses Template ist fr die Ausgabe von Kommentaren zustndig.
                      Es wird fr jeden einzelnen Kommentar jeweils neu aufgerufen.
-comments_add.html    In diesem Template befindet sich das HTML-Formular um neue Kommentare
                      zu einem Beitrag hinzufgen zu knnen.
-comments_end.html    Ausgabe von Seitenzahl u.. unterhalb der Kommentare.
-comments_head.html   Dieses Template wird oberhalb von Kommentaren eingebunden.
                      Es kann hier beispielsweise noch eigener Text eingefgt werden.
-foot.html            Diese Datei wird ganz am Ende unterhalb von Newseintrgen angezeigt
                      und enthlt HTML-Code um eine HTML-Seite syntaktisch korrekt abzuschlieen.
                      Dieses Template wird nur angezeigt, wenn Sie als Einbindungs-Methode
                      "Eigene Seite" oder "Iframe" verwenden.
-head.html            Das head-Template enthlt HTML-Code um eine HTML-Seite syntaktisch
                      korrekt zu beginnen.
                      Dieses Template wird nur angezeigt, wenn Sie als Einbindungs-Methode
                      "Eigene Seite" oder "Iframe" verwenden.
!MAIN_BOTTOM.html     Der Inhalt dieses Templates wird immer unterhalb der News/Kommentare
                      angezeigt. Dies ist das richtige Template um eigenen Text unterhalb
                      der News anzuzeigen!
!MAIN_top.html        Der Inhalt dieses Templates wird immer oberhalb der News/Kommentare
                      angezeigt. Dies ist das richtige Template um eigenen Text oberhalb
                      der News anzuzeigen!
!news.html            Durch dieses Template werden die einzelnen News-Beitrge ausgegeben
                      und angezeigt.
-seiten.html          Diese Datei ist fr die Ausgabe der Seitenzahlen & Links verantwortlich.
                      Auerdem befinden sich hier die Links zu RSS-Dateien, die Suchfunktion etc.

4. Text ndern. Wie?
--------------------

Um Text aus den Templates zu ndern oder zu bersetzen kopieren Sie die entsprechende
Stelle aus Ihrem Browser in die Zwischenablage (Text markieren und STRG+C drcken).
ffnen Sie anschlieend das Template, in dem sich der Text befindet knnte (siehe 3.), mit
einem Texteditor.
Durchsuchen Sie das Template durch drcken von STRG+F nach dem Text (Sie knnen den Text durch
STRG+V aus der Zwischenablage in das Suchfeld kopieren).
Ersetzen Sie die gefundene Textstelle durch Ihre eigene.

5. Weitere Informationen:
-------------------------

Ausfhrliche Informationen zu individuellen nderungen werden gerne im 01-Supportforum
beantwortet:
http://board.01-scripts.de

Weiterfhrende Informationen zu HTML finden Sie hier:
http://de.selfhtml.org/

Informationen zu PHP finden Sie auf folgender Seite:
http://www.selfphp.info/