InhaltsverzeichnisAllgemeinesBeschreibung, mitgelieferte Dateien

# Vorwort

Lieber Leser

Herzlich Willkommen und vielen Dank, dass Sie sich für dieses Produkt entschieden haben.

In diesem Programm stecken mehrere Jahre mühevoller Entwicklungsarbeit, sowie viele Stunden, welche unzählige helfende Hände investiert haben, um durch Tipps, Vebesserungsvorschläge und Programmtests dieses Programm stetig zu verbessern.

Alle diese Stunden haben mir und allen, die an diesem Projekt beteiligt waren, sehr viel Freude bereitet.

Wir hoffen, dass Ihnen das Ergebnis unserer Arbeit ebenso viel Freude bereiten wird. Bitte berichten Sie uns von Ihren Erfahrungen. Falls Sie Vorschläge haben stehe ich Ihnen gern via E-Mail zur Verfügung.

Thomas Meyer

# Beschreibung

Dieses Programmpaket enthält zwei wesentliche Bestandteile.

Einerseits ein "Component-Framework". Es unterstützt die Entwicklung von Anwendungen in PHP 4.3x und höher durch die Bereitstellung häufig benötigter Komponenten, wie bspw. Nutzerverwaltung, Authentifizierung, Datenbank-API, oder Templates. Außerdem fördert es das Schreiben sauberen Codes durch das Forcieren einer klassischen 3-Schichtenarchitektur. (Vergleich: "Model-View-Controler")
Dieses Framework und die zugrundeliegende Architektur wurden sinnigerweise "Yana" (Yet ANother Architecture) getauft.

Andererseits beinhaltet dieses Programm Softwarekomponenten, welche Yana benutzen: Anwendungen und Plugins. Wenn von "Anwendungen" die Rede ist, meint dies in erster Linie ein Gästebuch. Dieses ist mit Abstand die älteste Anwendung, welche derzeit für Yana verfügbar ist, denn es ist die erste, die jemals damit geschrieben wurde.

Der wesentliche Unterschied zu den meisten anderen Programmen, welche Sie im Internet oder anderenorts finden können ist aber, dass dieses Gästebuch beliebig erweiterbar ist. Und zwar nicht nur mit ein paar einfachen Skins oder Templates, sondern mit völlig beliebigen Webanwendungen, solange diese mit Yana kompatibel sind.

Derzeit sind unter anderem folgende Erweiterungen verfügbar:
- RSS-Feed Reader
- Suchmaschine (in Vorbereitung)
- IP-Filter mit Blacklist / Whitelist

Features

- eigene Smilies können eingefügt werden (25 Basis-Smilies vorhanden)
- eingegebenen Text formatieren (fett, unterstrichen, kursiv, ...)
- Bilder oder URLs in Text einfügen
- Mail-Benachrichtigung bei neuen Einträgen
- geeignet für Online-Communities
- einfache Schritt-für-Schritt Anleitung
- Kommentieren und Löschen von Einträgen durch den Webmaster
- komplett online administrierbar
- Schutz gegen Flooding und Diebstahl von Mailadressen ist integriert
- zusätzliche Skins, Plugins und Sprachdateien
- integrierte Nutzerverwaltung (ab Version 2.4)
- zusätzliche Optionen für Online-Communities
- umfangreiches Handbuch mit Installationsanleitung
- keine Datenbank erforderlich (wahlweise Datenbankanbindung möglich)

# Systemanforderungen

Damit dieses Programm korrekt arbeitet, müssen folgende Mindestanforderungen erfüllt sein:

- Apache 2.0 oder höher, oder ein anderer kompatibler Webserver
- PHP 4.3x bzw. PHP 5.0 oder höher
- ein mit PHP nutzbarer Mailserver
- FTP-Zugang und (CHMOD-fähiger) FTP-Client

Um Datenbankfeatures nutzen zu können, muss zusätzlich PEAR-DB installiert sein.
Um Bildfunktionen wie zum Beispiel CAPTCHA verwenden zu können, muss die GD-Library installiert sein.

Folgende Konfiguration wird empfohlen:

- Xampp 1.5 (enthält Apache, MySQL, Mailserver und PHP)
- Apache 2.0
- PHP 5 mit PEAR-DB, GD-Library und XML-Parser
- MySQL 4
- FileZilla 2 FTP-Client
- PHP MyAdmin (empfohlen)

Hinweis: Dieses Skript benötigt PHP und funktioniert deswegen normalerweise nicht auf Ihrer lokalen Festplatte sondern nur im Internet. Damit dieses Skript auf Ihrer Webseite funktioniert muss von Ihrem Anbieter PHP Unterstützung bereitgestellt werden. Fragen Sie im Zweifel Ihren Anbieter.
Hinweis: die Nutzung dieses Skript ist nur für private Homepages freigegeben. Ganz besonders möchten wir darauf hinweisen, dass es NICHT gestattet ist dieses Skript einzusetzen, um eine Dienstleistung anzubieten - zum Beispiel einen "Gästebuchservice" aufzubauen. Also meine Arbeit anderen Personen anzubieten, ohne meine direkte Beteiligung oder explizite schriftliche Genehmigung.
Falls Sie etwas Derartiges beabsichtigen, schreiben Sie bitte eine Mail an und holen Sie vorab eine schriftliche Erlaubnis ein.
Es ist außerdem nicht gestattet, enthaltene Copyrighthinweise zu entfernen, zu verändern, zu verdecken oder auf irgendeine Weise unkenntlich zu machen. Quellcodes dürfen ebenfalls nicht editiert oder verändert werden. Wenn Sie Fragen haben, oder einen Fehler finden, versuchen Sie bitte nicht den Quellcode zu ändern sondern schreiben Sie mir eine Mail.

# mitgelieferte Dateien

Dateien
`index.php` | Startseite
`library.php` | Systemdatei
Verzeichnisse
`cache/` | Verzeichnis für temporäre Dateien und Log-Files (bei knappem Speicherplatz können Sie den Inhalt dieses Verzeichnisses von Zeit zu Zeit leeren)
`common_files/` | gemeinsam genutzte Anwendungsdaten
`config/` | Konfigurationsdateien
`engine/` | Template-Engine
`includes/` | PHP-Klassenbibliothek
`plugins/` | Programmverzeichnis
`languages/` | Sprachdateien
`manual/` | Onlinehilfe
Die folgenden Dateien dürfen (und sollen) editiert werden ... *
`skins/` | Webdesigner können hier zusätzliche Skins und Layouts für die Anwendung speichern
`plugins/` | PHP-Programmierer können hier eigene Erweiterungen der Anwendung speichern
`languages/` | Übersetzer können hier neue Sprachdateien hinzufügen
`common_files/smilies/*.gif` | hier können neue Emoticons eingefügt werden
* Lassen Sie alle anderen Dateien bitte unbedingt unverändert. Diese Inhalte sind urheberrechtlich geschützt und dürfen nicht editiert werden.

Tipp: Falls Sie neue Skins, Plugins oder Übersetzungen erstellt haben sollten und Sie der Meinung sind, dass diese auch für andere Nutzer interessant sein könnten, dann sollten Sie diese kostenlos (!) verteilen. Falls Sie sich außerdem entschliessen, mich über Ihre Arbeit zu informieren, kann ich außerdem berücksichtigen, ob Ihre Komponenten durch ein Update der Software beeinträchtigt werden.
Hinweis: Setzen der Zugriffsrechte.
Damit das Pogramm funktioniert müssen nach der Installation Lese-/Schreibrechte für das Verzeichnis "config/" und alle darin enthaltenen Dateien gesetzt werden (auf Unix-Servern durch den FTP-Befehl CHMOD 777) ...

© 2001, 2002, 2003, 2004, 2005, 2006Thomas Meyer, www.all-community.de/pub