installation-de.txt

= papaya CMS Advanced Community Installation =

== Vorwort ==

Diese Installtionsanleitung ist für eine papaya CMS Standardinstallation
geschrieben. Die in dem Modulpacket enthaltenden Templates sind für
das papaya CMS default-Theme erstellt.

== Dateien kopieren ==

Die in dem Paket enthaltenen Dateien sind je papaya CMS Ordner sortiert.
Es reicht die Hauptordner in das papaya CMS Basisverzeichnis zu kopieren.
Wenn papaya-data und papaya-lib in einem externen Verzeichnis liegen,
müssen die entsprechenden Paketordner dorthin kopiert werden.

=== Patches ===

Es gibt eine Reihe von Patches für die bestehenden papaya CMS Dateien die im Ordner patches liegen.

Zum Patchen müssen sie in ihren papaya CMS Ordner per Kommandozeile gehen
und folgenden Befehl ausführen:
- patch -p 0 < /pfad/zum/packet/patches/papayacms.patches

papayacms.patches ersetzen sie durch einen der folgenden Dateinamen:
- trunk_r38500.patches wenn sie einen nightly-Build benutzen
- release_r38112.patches wenn sie einen 5.5.2 release-Build benutzen

Falls sie den Patchvorgang nicht durchführen können, können sie sich auch eine
gepatchte Version des papaya CMS herunterladen:
"papaya CMS mit Patches" unter https://github.com/MKelm/papaya-cms/archive/master.zip

==== Patches im Detail ====

Eine Liste von Änderungen ist hier zu finden: https://github.com/MKelm/papaya-cms/commits/master

== Module einrichten ==

Um die Advanced Community Module einzurichten gehen sie in das papaya CMS
Backend zum Menüpunkt Module und klicken auf Module suchen. Danach erscheint
in der Liste "Packete" der Punkt "Advanced Community". Wählen sie diesen
Punkt aus und bestätigen sie danach die Frage rechts zum Erstellen von
Pakettabellen mit "Erzeugen".

=== Modulübersicht ===

Das Advanced Community Paket enthält folgende Module:

- Kommentare (Comments Box)
-- Zeigt eine Liste mit Kommentaren und Unterkommentaren an
-- Kommentare können mit gut oder schlecht bewertet werden
-- Enthält ein Eingabeformular für Kommentare oder Unterkommentare
-- Unterstützt Seiten, Surfer und Galleriebilder
--- für Surfer muss ein Seitenparameter mit surfer_handle gesetzt sein
--- für Galleriebilder muss das Surfergallerie-Modul genutzt werden
---- sobald ein Bild ausgewählt wird erscheint die Kommentarbox

- Kommentar-Rangliste (Comments Ranking Box)
-- Zeigt eine Liste mit Kommentaren sortiert nach Bewertung an

- Kommentierer-Rangliste (Commenters Ranking Box)
-- Zeigt eine Liste mit Kommentierern sortiert nach Kommentaranzahl an

- Surferseite (Surfer Page)
-- Optimierte Ausgabe von Surferdetails des aktiven Surfers oder eines gewählten Surfers
-- Unterstützt das Kommentarmodul, siehe oben

- Surfereditor (Surfer Editor Page)
-- eine leicht erweiterte Version von community->content_profile
-- sie sollten dieses Modul nutzen, da sie sonst kein Caching in Surfer Page und Surfer Status Box
   nutzen können

- Surferkontakte Seite (Surfer Contacts Page)
-- zeigt Kontakte, gestellte Kontaktanfragen und empfangene Kontaktanfragen an
--- enthält Links zum entfernen von Kontakten und/oder aktzeptieren, ablehnen von Anfragen
--- enthält Links zu den Surferseiten

- Surfergallerie (Surfer Gallery Page)
-- Zeigt eine Thumbnailgallerie für einen gewählten Surfer an
-- Unterstützt das Kommentarmodul, siehe oben

- Mitteilungen / Benachrichtigungen (Messages Page)
-- Zeigt eine Liste mit Mitteilungen zwischen Surfer an sofern eine Unterhaltung gewählt wurde
--- zum Navigieren zwischen Unterhaltungen benötigen sie eine "Message Conversations Box"
--- zeigt einen Dialog zum Antworten an
-- oder zeigt eine Liste von (System-)Benachrichtigungen an

- Benachrichtigungseinstellungen (Notification Settings Page)
-- Zeigt eine Liste von Einstellungen zu allen verfügbaren Benachrichtigungen an
--- erlaubt die Wahl des Versands als Mitteilung und/oder E-Mail

- Unterhaltungen Box (Message Conversations Box)
-- Zeigt eine Liste mit Surfern an zu denen Mitteilungen existieren
-- Zeigt die letzte Mitteilung einer Unterhaltung mit Text und Zeit je Surferkontakt an

- Surferstatus Box (Surfer Status Box)
-- zeigt einen Login / Registrierungslink bei inaktivem Login an
-- zeigt Benutzeravatar und -name bei aktivem Login an
--- enthält zudem einen Surferseiten- und Logoutlink
-- zeigt Anzahl von Kontakten und Kontaktanfragen an
--- enthält passende Links zur Kontakteseite
-- enthält einen Link zur "Messages Page"
-- enthält einen Link zur Benachrichtigungsseite (Messages Page)
-- enthält einen Link zur Benachrichtigungseinstellungenseite

- Surferliste Letzte Aktivität Box (Surfers Last Action Box)
-- zeigt Surfer nach letzter Aktivität an und verlinkt auf die Surferseiten

- Surferliste Registrierungen Box (Surfers Registration Box)
-- zeigt Surfer nach Registrierungszeit an und verlinkt auf die Surferseiten

- Surfergallerie Teaser (Surfer Gallery Teaser Box)
-- Zeigt auf einer Surferseite eine Auswahl von maximal n Thumbnails an
-- Muss in eine Surferseite eingehangen werden
-- Verlinkt auf die Gallerieseite

- Surfergallerie Ordner (Surfer Gallery Folders Box)
-- Zeigt in der Surfergallerie alle Ordner des jeweiligen Surfers an
-- Enthält Links zum Löschen und Hinzufügen von Ordnern wenn der angemeldete
   Surfer dem gewählten Surfer entspricht

- Surfergallerie Upload (Surfer Gallery Upload Box)
-- Zeigt in der Surfergallerie ein Feld zum Hochladen von Bilder an
--- der gewählte Surfer muss mit dem angemeldeten Surfer übereinstimmen

- Surferlistenseite (Surfers Page)
-- Zeigt eine Liste von allen registrierten Surfern
-- Enthält einen Filter nach Anfangsbuchstabe
-- Enthält ein Suchformular

- Conntector
-- Enthält eine onDeleteSurfer / onDeletePages Methode für den Action Dispatcher
-- Enthält Methoden zum Verlinken von Seiten
-- Enthält Methoden um Moduloptionen zu ermitteln

== Ansichten einrichten ==

Diese Anleitung geht davon aus das eine papaya CMS Standardinstalltion mit
dem Ausgabefilter "html" besteht.
Unter dem Menüpunkt "Ansichten" finden sie das Formular zum Erstellen von
Ansichten.
In der Combobox "Modul" finden sie alle Module unter dem Abschnitt
"Advanced Community".
Nachdem sie eine Ansicht mit Titel erstellt haben müssen sie diese
Ansicht noch mit dem Ausgabefilter "html" verknüpfen.
Dabei ist ein "XSL-Stylesheet" zu wählen. Hier ist eine Liste mit
Modulbezeichnungen und zugehörigen XSL-Stylesheets:

==> box_acommunity.xsl für
- Commenters Ranking Box
- Comments Box
- Comments Ranking Box
- Surfer Gallery Teaser Box
- Surfer Gallery Folders Box
- Surfer Gallery Upload Box
- Message Conversations Box
- Surfer Status Box
- Surfers Last Action Box
- Surfers Registration Box

==> page_acommunity.xsl für
- Surfer Page
- Surfer Editor Page
- Surfer Gallery Page
- Surfer Contacts Page
- Messages Page
- Notification Settings Page
- Surfers Page

== Boxen und Seiten einrichten ==

=== Community Module ===

Für eine funktionierende Community benötigen sie zuerst ein paar Seiten des regulären Community
Modulpakets:
- Registrierungs-Seite, zum Registrieren
-- Anleitung http://www.papaya-cms.com/doc/papaya-cms/de/basissystem/5.1.5/ch15s10s08.html
-- Anders als in der Anleitung unterstützt das Modul in papaya CMS 5.5.2 auch dynamische Datengruppen
-- Die gepatchte papaya CMS Version enthält eine verbesserte Version
--- die Anzeige von dynamischen Datengruppen im Eingabeformular wurde optimiert
- Login-Seite, zum Anmelden
-- Anleitung http://www.papaya-cms.com/doc/papaya-cms/de/basissystem/5.1.5/ch15s10.html#N18935
- Profil-Seite, zum Bearbeiten von Benutzerdaten mit aktivem Login
-- Anleitung http://www.papaya-cms.com/doc/papaya-cms/de/basissystem/5.1.5/ch15s10s10.html
-- Die gepatchte papaya CMS Version enthält eine verbesserte Version
--- die Anzeige von dynamischen Daten/-gruppen im Eingabeformular wurde hinzugefügt
--- es wurden Beschreibungen für das Feld "Old password" hinzugefügt
-- die Profilseite benötigt auch eine "Profile Change Confirmations"-Seite
-- nutzen sie hier stattdessen das Modul "Surfer Editor Page" das content_profile entspricht

=== Advanced Community Module ==

- Kommentare (Page/Surfer/Image Comments Box)
-- Wählen sie den Menüpunkt "Boxen" um eine Kommentarbox zu erstellen
-- Wählen sie die Boxengruppe "after-content"
-- Erstellen sie eine Box mit der zugehörigen Box-Ansicht und benennen sie diese eindeutig
-- Ändern sie bei Bedarf Einstellungen unter "Inhalt"
-- Publizieren sie die erstellte Box
-- Hängen sie die Box in einer Seite unter dem Punkt "Boxen" ein
--- für Bildkommentare brauchen sie zuerst eine Surfergallerie-Seite, siehe unten
--- Surferkommentare funktionieren mit dem "Surfe Page"-Modul, siehe unten

- Kommentar-Rangliste (Comments Ranking Box)
-- Wählen sie den Menüpunkt "Boxen" um eine Ranglistenbox zu erstellen
-- Wählen sie die Boxengruppe "after-content"
-- Erstellen sie eine Box mit der zugehörigen Box-Ansicht und benennen sie diese eindeutig
-- Wählen sie der Punkt "Inhalt" und ändern sie bei Bedarf die Einstellungen
-- Publizieren sie die Box
-- Hängen sie die Box in einer Seite unter dem Punkt "Boxen" ein

- Kommentierer-Rangliste (Commenters Ranking Box)
-- Wählen sie den Menüpunkt "Boxen" um eine Ranglistenbox zu erstellen
-- Wählen sie die Boxengruppe "additional"
-- Erstellen sie eine Box mit der zugehörigen Box-Ansicht und benennen sie diese eindeutig
-- Wählen sie der Punkt "Inhalt" und ändern sie bei Bedarf die Einstellungen
-- Publizieren sie die Box
-- Hängen sie die Box in einer Seite unter dem Punkt "Boxen" ein

- Surferseite (Surfer Page)
-- Wählen sie den Menüpunkt "Ändern" um eine Surferseite zu erstellen
-- Wählen sie die Hauptseite ihrer Standardinstallation um eine Unterseite zu erstellen
-- Danach benennen sie die neue Unterseite eindeutig
-- Weisen sie der Seite die zugehörige Seitenansicht unter "Ansicht" zu
-- Gehen sie zu "Inhalt" und ändern sie bei Bedarf die Einstellungen
-- Publizieren sie die Seite

- Surferkontakteseite (Surfers Contacts Page)
-- Wählen sie den Menüpunkt "Ändern" um eine Seite zu erstellen
-- Wählen sie die Hauptseite ihrer Standardinstallation um eine Unterseite zu erstellen
-- Danach benennen sie die neue Unterseite eindeutig
-- Weisen sie der Seite die zugehörige Seitenansicht unter "Ansicht" zu
-- Gehen sie zu "Inhalt" und ändern sie bei Bedarf die Einstellungen
-- Publizieren sie die Seite

- Mitteilungen / Benachrichtigungen (Messages Page)
-- Wählen sie den Menüpunkt "Ändern" um eine Surferseite zu erstellen
-- Wählen sie die Hauptseite ihrer Standardinstallation um eine Unterseite zu erstellen
-- Danach benennen sie die neue Unterseite eindeutig
-- Weisen sie der Seite die zugehörige Seitenansicht unter "Ansicht" zu
-- Gehen sie zu "Inhalt" und ändern sie bei Bedarf die Einstellungen
-- Publizieren sie die Seite

- Benachrichtigungseinstellungen (Notification Settings Page)
-- Wählen sie den Menüpunkt "Ändern" um eine Surferseite zu erstellen
-- Wählen sie die Hauptseite ihrer Standardinstallation um eine Unterseite zu erstellen
-- Danach benennen sie die neue Unterseite eindeutig
-- Weisen sie der Seite die zugehörige Seitenansicht unter "Ansicht" zu
-- Gehen sie zu "Inhalt" und ändern sie bei Bedarf die Einstellungen
-- Publizieren sie die Seite

- Surferlistenseite (Surfers Page)
-- Wählen sie den Menüpunkt "Ändern" um eine Surferseite zu erstellen
-- Wählen sie die Hauptseite ihrer Standardinstallation um eine Unterseite zu erstellen
-- Danach benennen sie die neue Unterseite eindeutig
-- Weisen sie der Seite die zugehörige Seitenansicht unter "Ansicht" zu
-- Gehen sie zu "Inhalt" und ändern sie bei Bedarf die Einstellungen
-- Publizieren sie die Seite

- Unterhaltungen Box (Message Conversations Box)
-- Wählen sie den Menüpunkt "Boxen" um eine Ordnerbox zu erstellen
-- Wählen sie die Boxengruppe "additional"
-- Erstellen sie eine Box mit der zugehörigen Box-Ansicht und benennen sie diese eindeutig
-- Wählen sie der Punkt "Inhalt" und ändern sie bei Bedarf die Einstellungen
-- Publizieren sie die Box
-- Hängen sie die Box auf ihren Seiten unter dem Punkt "Boxen" ein

- Surfergallerie (Surfer Gallery Page)
-- Wählen sie den Menüpunkt "Dateien"
-- Erstellen sie einen neuen (Unter-)Ordner für Surfergallerien
-- Wählen sie den Menüpunkt "Ändern" um eine Surfergallerie-Seite zu erstellen
-- Wählen sie die Hauptseite ihrer Standardinstallation um eine Unterseite zu erstellen
-- Danach benennen sie die neue Unterseite eindeutig
-- Weisen sie der Seite die zugehörige Seitenansicht unter "Ansicht" zu
-- Gehen sie zu "Inhalt" und wählen sie unter "Ordner" den zuvor erstellen Dateiordner
-- Ändern sie auch folgende Optionen um eine optimale Anzeige der Surfergallerie zu ermöglichen
--- Vorschaubilder, Anzahl Vorschaubilder auf 4
--- Vorschaubilder, Spaltenanzahl auf 2
--- Vorschaubilder, Größe verändern auf "Minimum cropped"
--- Vorschaubilder, Breite und Höhe auf 200
--- Bilder, Display in Lightbox? auf "Nein"
---- Die Lightbox kann aktiviert werden, wenn keine Kommentarbox in der Surfergallerie genutzt wird
--- Bilder, Anzeigemodues auf "Resized Image" oder "Resized image with download link" oder
    "Resized image with original image link"
--- Bilder, Breite und Höhe auf 410
-- Ändern sie bei Bedarf weitere Einstellungen
-- Publizieren sie die Seite

- Surferstatus Box (Surfer Status Box)
-- Wählen sie den Menüpunkt "Boxen" um eine Ordnerbox zu erstellen
-- Wählen sie die Boxengruppe "additional"
-- Erstellen sie eine Box mit der zugehörigen Box-Ansicht und benennen sie diese eindeutig
-- Wählen sie der Punkt "Inhalt" und ändern sie bei Bedarf die Einstellungen
-- Publizieren sie die Box
-- Hängen sie die Box auf ihren Seiten unter dem Punkt "Boxen" ein

- Surfergallerie Teaser (Surfer Gallery Teaser Box)
-- Wählen sie den Menüpunkt "Boxen" um eine Ordnerbox zu erstellen
-- Wählen sie die Boxengruppe "after-content"
-- Erstellen sie eine Box mit der zugehörigen Box-Ansicht und benennen sie diese eindeutig
-- Wählen sie der Punkt "Inhalt" und ändern sie bei Bedarf die Einstellungen
-- Publizieren sie die Box
-- Hängen sie die Box auf ihrer Surferseite unter dem Punkt "Boxen" ein

- Surfergallerie Ordner (Surfer Gallery Folders Box)
-- Wählen sie den Menüpunkt "Boxen" um eine Ordnerbox zu erstellen
-- Wählen sie die Boxengruppe "before-content"
-- Erstellen sie eine Box mit der zugehörigen Box-Ansicht und benennen sie diese eindeutig
-- Wählen sie der Punkt "Inhalt" und ändern sie bei Bedarf die Einstellungen
-- Publizieren sie die Box
-- Hängen sie die Box auf ihrer Surfergallerieseite unter dem Punkt "Boxen" ein

- Surfergallerie Upload (Surfer Gallery Upload Box)
-- Wählen sie den Menüpunkt "Boxen" um eine Ranglistenbox zu erstellen
-- Wählen sie die Boxengruppe "after-content" oder "before-content"
-- Erstellen sie eine Box mit der zugehörigen Box-Ansicht und benennen sie diese eindeutig
-- Wählen sie der Punkt "Inhalt" und ändern sie bei Bedarf die Einstellungen
-- Publizieren sie die Box
-- Hängen sie die Box auf ihrer Surfergallerieseite unter dem Punkt "Boxen" ein

- Surfer nach letzte Aktivität Box (Surfers Last Action Box)
-- Wählen sie den Menüpunkt "Boxen" um eine Ordnerbox zu erstellen
-- Wählen sie die Boxengruppe "after-content" oder "additional-content"
-- Erstellen sie eine Box mit der zugehörigen Box-Ansicht und benennen sie diese eindeutig
-- Wählen sie der Punkt "Inhalt", ändern sie bei Bedarf Einstellungen
-- Publizieren sie die Box
-- Hängen sie die Box auf ihren Seiten unter dem Punkt "Boxen" ein

- Surfer nach Registrierung Box (Surfers Registration Box)
-- Wählen sie den Menüpunkt "Boxen" um eine Ordnerbox zu erstellen
-- Wählen sie die Boxengruppe "after-content" oder "additional-content"
-- Erstellen sie eine Box mit der zugehörigen Box-Ansicht und benennen sie diese eindeutig
-- Wählen sie der Punkt "Inhalt", ändern sie bei Bedarf Einstellungen
-- Publizieren sie die Box
-- Hängen sie die Box auf ihren Seiten unter dem Punkt "Boxen" ein

== Action Dispatcher einrichten ==

Der Action Dispatcher sollte eingerichtet werden um Daten gelöschter Surfer und Seiten
in der Advanced Community korrekt zu handhaben.

Bitte lesen sie auch die Action Dispatcher Anleitung auf
http://de.wiki.papaya-cms.com/wiki/Action_Dispatcher

=== Surferdaten löschen ===

Sie brauchen im Action Dispatcher eine Gruppe "community" und eine Aktion "onDeleteSurfer"
danach können sie die Observerklasse "ACommunityConnector" der Aktion
hinzufügen.

Der Advanced Community Connector führt über den Action Dispatcher beim
Löschen eines Surfers folgende Aktionen aus:
- Seitenkommentare werden mit einem Flag versehen, dass der Surfer gelöscht wurde
-- in den Kommentarlisten werden später Surferhandles mit "Deleted user" ö.ä. ersetzt
-- im Kommentiererranking werden gelöschte Surfer ignoriert
- Surferkommentare zum gelöschten Surfer werden komplett gelöscht
- Surfergallerien werden mitsamt aller Ordner, Bilder und Bildkommentaren gelöscht
-- Zeitstempel von letzten Bildkommentaränderungen, der zu löschenden Bilder, werden gelöscht
- Mitteilungen des gelöschten Surfers werden gelöscht
- Zeitstempel von letzten Änderungen, des zu löschenden Surfers, werden gelöscht

=== Seitendaten löschen ===

Sie brauchen im Action Dispatcher eine Gruppe "system" und eine Aktion "onDeletePages".
Dann können sie die Observerklasse "ACommunityConnector" der Aktion hinzufügen.

Der Advanced Community Connector führt über den Action Dispatcher beim
Löschen einer Seite folgende Aktionen aus:
- Seitenkommentare zur gelöschten Seite werden komplett gelöscht
- Zeitstempel von letzten Kommentaränderungen, der zu löschenden Seiten, werden gelöscht

== Verlinkungen von Seiten ==

Um Surfer in Boxen und Seiten korrekt zu verlinken, müssen sie die Moduloptionen des Connectors anpassen.
Diese Moduloptionen werden von vielen Advanced Community Modulen genutzt um Links zu erzeugen.
Bevor sie die Optionen ändern, benötigen sie entsprechende Seiten in ihrem Seitenbaum.

Moduloptionen ändern, z.B. für "Surfer Page" und "Surfer Gallery Page":
- Öffnen sie die Modulübersicht im Menüpunkt "Module"
- Öffnen sie das Paket "Advanced Community"
- Wählen sie das Modul "Connector" aus
- Wählen sie rechts den Punkt "Optionen" aus
- Setzen sie die Option "Page IDs" -> "Surfer" und "Page IDs" -> "Surfer Gallery" korrekt
- Danach können sie von Kommentarboxen aus die Surferdetailseite erreichen
-- Beispiel-URL: infis-page.70.de.html?acs:surfer_handle=infi
- Danach können sie von Gallerieteaserboxen aus die Surfergallerie erreichen
-- Beispiel-URL: infis-gallery.71.de.html?acg:surfer_handle=infi

Sie können auch die Parametergruppe der Surferseiten einstellen. Sie brauchen jedoch nur eine andere
Parametergruppe, wenn sie ein anderes Seitenmodul als "Surfer Page" nutzen. Dieser Ansatz ist
z.B. mit dem "Show user"-Modul der Community kompatibel, dessen Parametergruppe "bab" lautet.

Es gibt noch weitere Page ID-Einstellungen in den Moduloptionen des Connectors:
- Login Page = Seiten ID der Anmeldeseite, wird in "Surfer Status Box" genutzt
- Registration Page = Seiten ID der Registrierungsseite, wird in "Surfer Status Box" genutzt
- Editor Page = Seiten ID der Profilseite, wird in "Surfer Status Box" genutzt
- Contacts Page = Seiten ID der Kontakteseite, wird in "Surfer Status Box" genutzt
- Messages / Notifications Page = Seiten ID eines "Message Page"-Moduls mit Ausgabe von Mitteilungen
-- wird in "Surfer Status Box" für die Verlinkung "Messages" und "Notifications" genutzt
-- wird in der "Message Conversations Box" für Verlinkungen genutzt
- Notification Settings Page = Seiten ID eines "Notification Settings Page"-Moduöls
-- wird in der "Surfer Status Box" für die Verlinkung "Notification settings" genutzt

== Benachrichtigungen ==

Um Benachrichtigungen (Notifications) zu nutzen, müssen sie die Dateien aus dem Ordner "import-data"
in ihre Datenbank importieren.

- Öffnen sie dazu papaya CMS, gehen sie auf den Menüpunkt "Module", Pakete -> "Advanced Community"
  und wählen sie die Tabelle "papaya_acommunity_notifications" aus
- Gehen sie auf den Menüpunkt "Daten importieren" oben rechts
- Wählen sie die passende CSV Datei aus dem Ordner "import-data"
- Bestätigen sie das Formular
- Wählen sie die Tabelle "papaya_acommunity_notification_trans" aus
- Gehen sie auf den Menüpunkt "Daten importieren" oben rechts
- Wählen sie die passende CSV Datei aus dem Ordner "import-data"
- Bestätigen sie das Formular

Danach werden in ihrer Community Benachrichtigungen über Mitteilungen versendet.
Per Standard ist der Versand für neue Benutzer via E-Mail deaktiviert.

Sie können jedoch unter Pakete -> "Advanced Community", Modul -> "Connector" -> Menüpunkt "Optionen"
die Einstellungen für Benachrichtigungen (Notifications) ändern:
- Sender E-Mail, eine Adresse die als Absender in Benachrichtigungmails genutzt wird
- Sender Name, ein Name der als Absender in Benachrichtigungmails genutzt wird
- Notify By Message, Benachrichtigungen an (neue) Benutzer ohne Einstellungen mittels Mitteilung ja/nein
- Notify By E-Mail, Benachrichtigungen an (neue) Benutzer ohne Einstellungen mittels E-Mail ja/nein

Es gibt drei Benachrichtigungen die unterstützt werden:
- new-surfer-comment, wenn ein fremder Surfer auf einer Surferseite ein Kommentar abgibt
- new-surfer-image-comment, wenn ein fremder Surfer ein Bild in einer Surfergallerie kommentiert
- new-contact-request, wenn ein Surfer bei einem anderen Surfer eine Kontaktanfrage stellt

Die Versandeinstellungen dieser Benachrichtigungen kann jeder Surfer auf einer
"Notification Settings Page" ändern.

== Performance / Caching ==

Sie können die Performance ihrer Communityseite steigern indem sie Seiten und Boxen cachen.
Die Einstellungen zum Cache finden sie unter Menüpunkt "Einstellungen" -> "Optionen" -> "Cache".
Die einzelnen Optionen werden hier beschrieben:
http://www.papaya-cms.com/doc/papaya-cms/de/basissystem/5.1.5/ch33s02s12.html

Ich empfehle PAPAYA_CACHE_BOXES = on und PAPAYA_CACHE_PAGES = on zu setzten.
Die Zeiteinstellungen sollten sie je Seite und Box individuell einstellen.

Wenn sie php-Module installieren können, empfehle ich die APC Erweiterung zu installieren und
die PAPAYA_CACHE_SERVICE Optionen auf APC zu stellen.
Siehe auch http://www.papaya-cms.com/doc/papaya-cms/de/basissystem/5.1.5/ch33s02s12.html und
http://php.net/manual/de/book.apc.php

=== Caching Community ===

Das Cachen der Login-, Registrierungs- und Profilseite eignet sich nicht, da die Module Daten
dynamisch laden und speichern.

=== Caching Advanced Community ===

Bei vielen Modulen kann eine hohe Cachezeit eingestellt sein, da der Cacheinhalt sich automatisch
bei Veränderung von Daten aktualisiert. Bei einer hohen Benutzeraktivität können die Cachzeiten daher
real sehr viel niedriger sein als in den Vorschlägen angegeben. Die hohen Cachezeiten eignen sich
allerdings für Bereiche in denen wenig Aktivität der Benutzer zu verzeichnen ist, wogegen die Anzahl
von Hits hoch bleibt.

Hier eine Liste mit Vorschlägen für Cachezeiten je Modul:

- Surfer Page
-- z.B. 604800 Sekunden
-- die Seite erkennt wann sich ein Surferaufruf ändert
-- die Seite erkennt wann sich Kontaktdaten zwichen dem aktiven und gewählten Benutzer verändern
-- die Seite erkennt wann sich Daten des gewählten Benutzers verändern
-- sobald ein aktiver Benutzer einen "command" ausführt wird das Caching deaktiviert um
   wiederholte Änderungen an Kontaktdaten zu ermöglichen

- Surfer Editor Page
-- der Cache wird stets deaktiviert da Daten stets dynamisch geladen und gespeichert werden

- Surfer Status Box
-- z.B. 604800 Sekunden
-- die Box erkennt wann sich relevante Daten ändern
--- beachtet aktiven Surfer und die letzte Änderung von Kontaktdaten

- Commenters Ranking Box
-- z.B. 1800 Sekunden
-- die Box erkennt nicht wann sich relevante Daten in der Liste ändern, da eine Erfassung aller
   Veränderungen in Listenelemente für die Cacheberechnung zu aufwendig wäre
--- sie können durch eine kleinere Cachezeit die Aktualität der Liste steigern, wägen sie ab wie
    aktuell sie die Box halten möchten
--- da die Box kein Paging enthält, können keine Inkonsistenzen in der Liste entstehen

- Page Comments Box, Surfer Comments Box und Image Comments Box
-- z.B. 604800 Sekunden
-- für angemeldete Surfer ist wird der Cache deaktiviert, da das Formular zum Antworten stets einen
    gültigen Token braucht
-- für alle anderen Surfer wird der Cache aktiviert
--- die Box erkennt wann sich relevante Daten in der Liste ändern
---- beachtet RessourceTyp (Page/Surfer/Image), RessourceId, Zeitstämpel der letzten Änderung von
     Kommentaren der aktiven Ressource
---- beachtet Parameter command, comment_id und alle comment_page-Parameter

-- Comments Ranking Box
-- z.B. 604800 Sekunden
-- die Box erkennt wann zuletzt sich Kommentare verändert haben und erneuert den Cache daraufhin

- Surfer Contacts Page (Kontakte und Kontaktanfragen)
-- z.B. 604800 Sekunden
-- diese Seite erkennt wann sich relevante Daten ändern
--- beachtet SurferId und letzte Änderungszeit aller Kontakttypen
--- beachtet Parameter command, surfer_handle und alle ..._list_page-Parameter
--- bei Parameter command wird das Caching deaktiviert um Änderungen an Kontaktdaten zu ermöglichen

- Surfer Contacts Box
-- z.B. 604800 Sekunden
-- diese Box erkennt wann sich relevante Daten ändern
--- beachtet SurferId, letzte Änderungszeit von Surferkontakten und Parameter contacts_list_page
-- sie können in papaya-lib/modules/externale/ACommunity/Surfers/Box.php die Konstante
    PAPAYA_ACOMMUNITY_CACHE_CONTACTS_BOX_USE_LAST_CHANGE_TIME auf 0 setzten wenn sie dieses Modul
    ohne Paging nutzen und ihnen die Aktualität der Liste nicht so wichtig ist.
    Die Option ignoriert die letzte Änderungszeit von Kontakten, somit reagiert der Cache nicht auf
    Veränderungen der Listenlänge.
--- in diesem Fall sollten sie die Cachezeit auf z.B. 1800 Sekunden stellen, um eine relativ aktuelle
    Liste je Surfer zu erhalten

- Surfers Last Action Box
-- z.B. 604800 Sekunden
-- diese Box erkennt, wann sich relevante Daten ändern
--- beachtet letzten Zeitstempel der Surfereigenschaft "lastaction" und Parameter lastaction_list_page
-- je nach Aktivität der gesamten Community kann die Aktualisierungsrate der Box sehr hoch sein,
    oder beachten sie den nächsten Punkt um die Aktualisierungsrate generell gering zu halten
-- sie können in papaya-lib/modules/externale/ACommunity/Surfers/Box.php die Konstante
    PAPAYA_ACOMMUNITY_CACHE_LAST_ACTIONS_BOX_USE_LAST_TIME auf 0 setzten wenn sie dieses Modul ohne
    Paging nutzen und ihnen die Aktualität der Liste nicht so wichtig ist. Die Option ignoriert
    Veränderungen des neusten Eintrags, somit reagiert der Cache nicht auf Veränderungen der gesamten
    Liste.
--- in diesem Fall sollten sie die Cachezeit auf z.B. 300 Sekunden stellen, um eine ralativ aktuelle
    Liste zu erhalten

- Surfers Registrations Box
-- z.B. 604800 Sekunden
-- diese Box erkennt, wann sich relevante Daten ändern
--- beachtet letzten Zeitstempel der Surfereigenschaft "registration" und Parameter registration_list_page
-- je nach Beliebtheit der gesamten Community kann die Aktualisierungsrate der Box hoch sein,
    oder beachten sie den nächsten Punkt um die Aktualisierungsrate generell gering zu halten
-- sie können in papaya-lib/modules/externale/ACommunity/Surfers/Box.php die Konstante
    PAPAYA_ACOMMUNITY_CACHE_REGISTRATIONS_BOX_USE_LAST_TIME auf 0 setzten wenn sie dieses Modul ohne
    Paging nutzen und ihnen die Aktualität der Liste nicht so wichtig ist. Die Option ignoriert
    Veränderungen des neusten Eintrags, somit reagiert der Cache nicht auf Veränderungen der gesamten
    Liste.
--- in diesem Fall sollten sie die Cachezeit auf z.B. 1800 Sekunden stellen, um eine ralativ aktuelle
    Liste zu erhalten

- Surfer Gallery Page
-- z.B. 604800 Sekunden
-- das Caching wird beim Parameter command deaktiviert um Änderungen an Daten zu ermöglichen
-- das Caching beachtet Änderungen relvanter Daten
--- beachtet wird die Surferauswahl, die Ordnerauswahl, der Zeitstempel der letzten Bildänderung
    in einem Ordner, sowie die Parameter index, offset, enlarge

- Surfer Gallery Folders Box
-- z.B. 604800 Sekunden
-- der Cache wird deaktiviert, wenn ein Benutzer angemeldet ist und das Formular zum
   "Ordner hinzufügen" aktiviert, da dabei stets ein gültiger Token gebraucht wird
-- ansonsten ist der Cache aktiv und beachtet Änderungen relevanter Daten
--- beachtet die letzte Änderungszeit der Ordner und die Parameter command und folder_id

- Surfer Gallery Upload Box
-- z.B. 604800 Sekunden
-- der Cache wird deaktiviert, wenn das Uploadformular angezeigt wird, da stets ein gültiger Token
   gebraucht wird
-- wenn das Formular nicht angezeigt wird kann ein Cache aktiv sein
--- der Mehrnutzen zwischen aktivem und inaktivem Cache ist gering, da nur wenige Prozesse vermieden
    werden

- Surfer Gallery Teaser Box
-- z.B. 604800 Sekunden
-- beim Caching wird der gewählte Surfer und die letzte Änderungszeit von Bildern im Basisordner
   beachtet, zudem ob der gewählte Surfer auch der aktive Surfer ist

- Message Conversations Box
-- z.B. 604800 Sekunden
-- diese Box erkennt, wann sich relevante Daten ändern
--- beachtet aktiven Surfer und letzten Zeitstempel einer Mittelung in der Unterhaltungen-Liste

- Messages Page
-- z.B. 604800 Sekunden
-- für Mitteilungen zwischen Benutzern wird der Cache deaktiviert, da das Formular zum Antworten
   stets einen gültigen Token braucht
-- für die Benachrichtigungsliste wird der Cache aktiviert
--- dieser Modus erkennt wann sich relevante Daten ändern
--- beachtet den aktiven Surfer, den letzten Zeitstempel einer Mitteilung in
    der Benachrichtigungsliste und Parameter messages_page

- Notification Settings Page
-- der Cache wird stets deaktiviert, da die Seite stets dynamisch Daten lädt und speichert

- Surfers Page
-- z.B. 604800 Sekunden
-- die Seite erkennt wann sich die Anzahl an registrierten Benutzern ändert
-- die Seite erkennt wann sich Namen von Benutzern ändern
-- die Seite beachtet die Parameter surfers_character, surfers_search und surfers_list_page

== URL-Verarbeitung in Texten ==

Textinhalte in Kommentaren und Mitteilungen werden über einen Filter automatisch verarbeitet.
Dabei werden URLs identifiziert und verlinkt:
- Normale URLs erhalten einen a-Tag
- Bild URLs erhalten einen a-Tag
-- optional können in "Module" -> Paket: "Advanced Community" -> Modul: "Connector" -> "Optionen"
   die Optionen für "Text Thumbnails" aktiviert werden
--- dabei werden zusätzlich Thumbnails der verlinkten Bilder erstellt.
    Die Thumbnails werden danach unter dem Textinhalt ausgegeben.

== Moderator Features ==

In den Moduloptionen des Connectors gibt es einen Bereich "Moderators". Dort kann eine Surfergruppe
für Moderatoren definiert werden. Moderatoren haben folgende Rechte:
- Löschen von Galleriebildern
- Löschen von Kommentaren