-----------------------------------------------------------------------
|  papaya CMS                                                         |
|  Version: 5 nightly                                                 |
|  Copyright: 2002-2006 papaya Software GmbH                          |
-----------------------------------------------------------------------

  Allgemeines
  
  Lizenz

  Systemvorraussetzungen
     
  Automatische Installation
  
  Manuelle Installation
    1. Dateien kopieren
    2. An den Server anpassen
    3. Rechte setzen
    
  Initialisierung und Konfiguration
    1. Datenbank initialisieren
    2. Konfiguration
    3. Benutzer und Passwrter

  Update 4 -> 5
    
  Anhang
    A papaya CMS in einem Unterverzeichnis
    B Rewrite Rules in der httpd.conf
    C Apache mod_vhost_alias
    D MySQL >= 4.1 und Zeichenstze


----------------
| Allgemeines  |
----------------

Danke, dass Sie sich papaya CMS heruntergeladen haben und testen/nutzen
wollen. Die Nutzung ist fr Sie kostenfrei unter den Bedingungen der 
GNU General Public Licence (GPL) mglich.

Aktuelle Informationen zu papaya CMS finden Sie unter 
[http://www.papaya-cms.com].


-----------
| Lizenz  |
-----------

Die Software "papaya CMS" unterliegt der GNU General Public Licence 
(GPL). Die Lizenz liegt in der Datei gpl.txt bei.



--------------------------
| Systemvoraussetzungen  |
--------------------------

Server:
  Apache HTTPd 1.3.x oder 2.x
    mod_rewrite
  PHP >= 4.3.0 oder PHP >= 5.0
    XML (ext/xml)
    XSLT (ext/xslt, ext/domxml oder ext/xsl)
    MySQL oder PostgreSQL(ext/mysql, ext/mysqli oder ext/pgsql)
    Sessions (ext/session)
    PCRE (ext/pcre)
    GD (ext/gd)
  MySQL >= 3.23 oder PostgreSQL >= 8.0
  
Client (fr Administrationsoberflche):
  Webbrowser (empfohlen Firefox)
    JavaScript
    Flash
    
Client (fr Ausgabe mit Standardtemplates):
  Webbrowser
    JavaScript (optional - fr Popups und Flasheinbindungen)
  
  
  
-------------------------------
|  Automatische Installation  |
-------------------------------

Wenn Sie von Windows aus installieren, knnen Sie den Installer nutzen.
Sie knnen lokal auf den gleichen Computer intallieren oder ber FTP auf
einen entfernten Webserver. Im zweiten Fall kann der Computer auch unter 
Linux oder einem anderen Betriebssystem laufen.

!Wichtig! - Achten Sie unbedingt darauf, das der Webserver mod_rewrite 
untersttzt. Fragen Sie im Zweifel bei Ihrem Administrator/Provider nach.

Der Installer fragt die bentigten Daten ab, prft den Server, kopiert die
Dateien, setzt Rechte und legt die Grundkonfiguration an.

Um die bentigte Daten zu ermitteln, ldt der Installer nacheinander mehrere
kleine PHP-Dateien hoch und ruft diese dann ber den Webserver wieder ab.
Stimmen die Pfadangaben nicht, oder verweigert der Webserver die Auslieferung, 
wird der Installer melden, dass er die entsprechende Testdatei nicht findet.

Als letzte Datei wird der Installer ein PHP-Script hochladen, welches die 
Optionstabelle anlegt und verschiedene Standardoptionen eintrgt. Zu diesem 
Zeitpunkt sind bereits alle Dateien hochgeladen. Kann der Installer dieses 
Script nicht abrufen, ist eventuell mod_rewrite nicht aktiv. In diesem Fall 
wird jeder Seitenaufruf einen Serverfehler (500) liefern.

Am Ende wird der Installer die Seite 
http://www.domain.tld/papaya/install.php (www.domain.tld entspricht
Ihrer Domain) in Ihrem Webbrowser aufrufen. Dort knnen Sie mit der 
*Initialisierung und Konfiguration* fortfahren.

---------------------------
|  Manuelle Installation  |
---------------------------

1. Dateien kopieren

Im Installationsverzeichnis finden Sie 5 Verzeichnisse und 3 Dateien.

  papaya-data/    - Datenverzeichnis fr das CMS
  papaya-lib/     - papaya Klassenbibliothek
  
  papaya/         - papaya Admininterface
  papaya-script/  - diverse Script-Dateien (Flash-Erkennung, Popups, ...)
  papaya-themes/  - Themes - CSS-Dateien und Layout-Bilder
  
  .htaccess       - RewriteRules fr den Apache
  conf.inc.php    - Basiskonfiguration (Datenbankzugriff, Biliothekspfad)
  index.php       - Seitenindex
  
Die beiden ersten Verzeichnisse ("papaya-data" und "papapya-lib") kopieren 
Sie wenn mglich auerhalb des Document-Root Ihres Webservers. Die anderen 
Verzeichnisse, sowie die Dateien ".htaccess" und "index.php", kopieren 
Sie bitte in den Document-Root des Webservers.

2. An den Server anpassen

In der Datei conf.inc.php mssen Sie zwei Werte anpassen. Die
Adresse der Datenbank (PAPAYA_DB_URI) nach dem Schema:

 "dbms://benutzer:passwort@server/datenbank"
 
 z.B.
 "mysql://web1:geheim@localhost/usr_web1_1"
 
Die notwendigen Einzelwerte erhalten Sie von Ihrem Provider.

Der Wert PAPAYA_INCLUDE_PATH ist der Pfad zum papaya Klassenframework. 
Sie knnen hier einen absoluten Pfad oder einen Pfad innerhalb des 
PHP-Include-Path angeben. Mgliche Werte wren:

  "/home/www/web1/files/lib/papaya-lib/" oder "lib/papaya-lib/"
  
Nach der nderung kopieren Sie diese Datei bitte ebenfalls in den 
Document-Root Ihres Webservers.
  
3. Rechte setzen

Das Verzeichnis "papaya-data" muss fr den Webserver schreibbar sein. 
blicherweise besitzen FTP-Programme eine Mglichkeit die Rechte zu 
ndern. Setzen Sie die Rechte fr das Verzeichnis auf "0777".

            Besitzer Gruppe Alle
Lesen          X        X     X
Schreiben      X        X     X
Ausfhren      X        X     X

Unter Umstnden sind auch weniger Rechte mglich. Fragen Sie bitte bei 
Ihrem Serveradministrator nach.

Das CMS ist nun installiert und Sie knnen mit der *Initialisierung
und Konfiguration* fortfahren.

---------------------------------------
|  Initialisierung und Konfiguration  |
---------------------------------------

1. Datenbank initialisieren
    
Rufen Sie die Seite http://www.domain.tld/papaya/install.php in Ihrem 
Webbrowser auf (www.domain.tld ersetzen Sie bitte durch Ihre Domain).

Wenn das System auf die Datenbank zugreifen kann, werden Sie gebeten,
zuerst die Konfigurationstabelle zu erzeugen. Danach zeigt die Seite 
eine Liste von Tabellen, sowie einen Dialog mit verschiedenen Aktionen.

 1) Analyze Database
 
    prft die vorhandenen Tabellen in der Datenbank
    (wird deaktiviert, wenn keine der bentigten Tabellen vorhanden sind)
    
 2) Update Database
    
    Erzeugen fehlender Tabellen, Abgleichen bestehender Tabellen
    (wird deaktiviert, wenn keine nderungen ntig sind)
 
 3) Insert default data
 
    Einfgen von Standardwerten in die markierten Tabellen. Dabei 
    wird der aktuelle Inhalt der Tabelle gelscht.
    (diese Aktion kann mehrfach ausgefhrt werden)
    
 4) Check options and modules
   
    Prft die Optionen, legt Standardwerte an und sucht nach 
    installierten Modulen
    (diese Aktion kann mehrfach ausgefhrt werden)    
    
 5) Go to admin interface
 
    Ruft die Benutzeradministration des Admininterfaces auf.
  
Klicken Sie sich nacheinander durch die verschiedenen Schritte. 
Das Tool ist in der Lage bestehende Tabellen anzupassen, ohne die 
darin enthaltenen Daten zu lschen. Sie knnen damit spter also 
auch Updates machen.

Tabellen fr Zusatzmodule (z.b. Foren) werden spter ber die 
Modulverwaltung installiert.

2. Konfiguration

Papaya CMS ist nun installiert.

Rufen Sie nun die Seite http://www.domain.tld/papaya/ in Ihrem 
Webbrowser auf. Durch die Datenbankinitialiserung sollten Sie 
automatisch eingeloggt sein. Der Standardbenutzer ist "admin" mit
leerem Passwort. Das System wird auf jeder Seite eine Warnung ausgeben,
solange Sie kein Passwort gesetzt haben.

In der obersten Leiste finden Sie einen Button "Konfiguration", mit
welchem Sie das CMS weiter anpassen knnen. 

Wichtige Optionen:

  Pfade
    PAPAYA_PATH_DATA   - Pfad zum Datenverzeichnis (papaya-data/)
    PAPAYA_PATH_WEB    - Pfad im Browser

  Layout 
    PAPAYA_LAYOUT_TEMPLATES - XSLT-Verzeichnis
    PAPAYA_LAYOUT_THEME     - Verzeichnis mit CSS und Layout-Bildern

Nach dem Einstellen des Datenverzeichnisses, sollten Sie den Button 
"Pfade prfen" anklicken. Damit wird das Verzeichnis geprft und 
eventuell bentigte Unterverzeichnisse angelegt.    

3. Benutzer und Passwrter

Gehen Sie in den Punkt "Benutzer" und vergeben Sie ein Passwort 
fr den Administrator (Login: admin, kein Password). Das System 
wird eine Warnmeldung ausgeben, bis Sie ein Passwort gesetzt haben. 
Sie sollten nach Mglichkeit auch die anderen Daten des Administrators
anpassen.

Tip: Legen Sie fr jeden Autor einen eigenen Benutzer an. Es ist 
mglich, den Autor einer Seite auszugeben.

-----------------------
|  Update 4 -> 5  |
-----------------------

Die aktuelle Version ist nur eine Testversion. Sie ist nicht fr den 
Einsatz auf einem Produktivserver gedacht. Derzeit ist ein Update 
nicht zum empfehlen, Die Datenstruktur wurde sehr stark verndert 
(Mehrsprachigkeit und Ausgabefilter). Sie ist daher nicht kompatibel.

Mit dem Release der 5.0 werden wir auch ein Update-Script zur Verfgung 
stellen.

------------
|  Anhang  |
------------

A - papaya CMS in einem Unterverzeichnis

Es ist mglich, papaya CMS auch in einem Unterverzeichnis des
Webservers zu installieren. Die .htaccess muss jedoch immer im
Document-Root liegen und in diesen Fllen angepat werden. Eine 
Beispieldatei finden sie in diesem Verzeichnis (htaccess.tpl). Der
Platzhalter {%webpath_pages%} muss durch den entsprechenden Pfad ersetzt 
werden.

Beispiele:

  pages/
  cms/page/

Beachten Sie bitte das kein fhrender Schrgstrich angegeben werden darf, 
jedoch der Pfad mit einem Schrgstrich abgeschlossen werden muss.

Bei der automatischen Installation wird eine entsprechend angepate 
.htaccess in den Document-Root kopiert.

B - Rewrite Rules in der httpd.conf

Sie knnen die Angaben aus der .htaccess auch in die 
Konfigurationsdatei des Webservers kopieren. Nutzen Sie wenn mglich
eine "per-Directory"-Konfiguration.

Die .htaccess wird damit berflssung und kann komplett entfernt und
deaktiviert werden.

C - Apache mod_vhost_alias

Wenn Sie mod_vhost_alias einsetzen, enthlt die Variable 
$_SERVER['DOCUMENT_ROOT'] den falschen Wert. Auch kann der Installer 
die Pfade nicht korrekt immer berechnen. Sie mssen daher die Pfad in 
der conf.inc.php manuell korrigieren, sowie die folgende Zeile 
einfgen:

$_SERVER['DOCUMENT_ROOT'] = '/path/vhosts/hostname/';

Diese entspricht der Pfadangabe fr den VirtualDocumentRoot mit 
eingesetztem Hostname.

Die Pfade in den Rewrite-Rules der .htaccess mssen ebenfalls angepat
werden. Falls Sie papaya CMS direkt im Hauptverzeichnis installieren, 
knnen Sie die .htaccess aus dem Unterverzeichnis "files" der 
Installationspaketes kopieren.

D - MySQL >= 4.1 und Zeichenstze

MySQL bringt mit der Version 4.1 Unterstzung fr Unicode und Zeichenstze. 
Falls Sie MySQL 4.1 einsetzen, achten Sie bitte unbedingt darauf, dass als
Zeichensatz in den Tabellen UTF-8 genutzt wird. Erkennbar ist dies an der 
Kollation (engl. Collation). Diese muss mit "utf8" beginnen 
(z.B. utf8_general_ci)
