Systemseitige Einstellungen

PHPModule@PHP-Module|(

Um herauszufinden, welche PHP-Module auf Ihrem Webserver installiert sind, laden Sie folgende kleine Datei namens info.php in das Document Root Stammverzeichnis Webdaten-Stammverzeichnis (auch Document Root genannt) [*] Das ist meistens DocRoot das Stammverzeichnis, in dem Sie bei Benutzung Ihres FTP-Zugangs standardmäßig zu Beginn landen. Je nachdem, wie Ihr Provider den Webserver konfiguriert hat, kann es aber auch sein, dass Sie zuerst in ein Verzeichnis wie htdocs oder httpdocs wechseln müssen, um in das Stammverzeichnis des Webservers zu gelangen. auf den Server (im Buch www.example.com genannt) und rufen diese in einem Browser über http://www.example.com/info.php auf:

Aus Gründen der Einfachheit nutzen wir für diese Beispiel URLs das ungesicherte http:// Protokoll-Präfix, empfehlen aber dringend im realen Leben immer https:// über ein vertrauenswürdiges Zertfikat zu verwenden!

    <?php phpinfo(); ?>

Der Browser sollte dann eine Übersicht darstellen, aus der Sie Ihre aktuellen Einstellungen herauslesen können. Folgende Module benötigt Serendipity:

PHPModule@PHP-Module PHPKonfiguration@PHP-Konfiguration Konfiguration!PHP

• libxml (PHP-Modul) session session (PHP-Modul) Das PHP-Modul session muss installiert und aktiviert sein sowie Session-Cookies zulassen. Dies erreicht man mit der php.ini-Einstellung session.use_cookies = On Serendipity verlangt darüber hinaus, dass die PHP-Sessiondateien schreibbar sind. Die php.ini-Einstellung session.save_path muss demnach auf ein Verzeichnis zeigen, in dem der Webserver bzw. PHP Schreibrechte hat. Gerade bei Windows-Servern enthält diese Variable häufig ein nicht existierendes oder nicht beschreibbares Verzeichnis.
• libxml (PHP-Modul) xml/libxml Damit Serendipity in anderen Zeichensätzen verfasste Texte nach UTF-8 konvertieren und seine XML-Funktionalitäten ausspielen kann, muss das (standardmäßig vorhandene) PHP-Modul xml/libxml installiert und aktiviert sein.
• iconv (PHP-Modul) mbstring (PHP-Modul) iconv/mbstring Für andere Zeichensatzkonvertierungen, die besonders bei Import- und Exportvorgängen (zB. von RSS-Feeds) nötig werden, kann Serendipity sowohl das PHP-Modul iconv als auch mbstring verwenden. Beide Module sind in aktuellen PHP5-Versionen standardmäßig aktiviert.
• PCRE (PHP-Modul) PCRE Um Zeichenketten zu finden und zu bearbeiten, setzt Serendipity häufig reguläre Ausdrücke ein. Diese Funktionalität liefert das (standardmäßig installierte) PHP-Modul pcre.
• libgd (PHP-Modul) ImageMagick gd/imageMagick Um die Mediathek vernünftig nutzen zu können, benötigen Sie entweder das PHP-Modul gd oder das Paket ImageMagick. Sollten Sie Letzteres benutzen, müssen die Dateien des Pakets für Ihren Web-Benutzer ausführbar sein.
• socket (PHP-Modul) Firewall socket Damit Serendipity auf fremde Webseiten zugreifen kann, um zB. Webservices zu integrieren und den Download von Plugins zu ermöglichen, benötigt es das (standardmäßig aktivierte) PHP-Modul socket, das Netzwerkfunktionen bereitstellt. Selbst wenn das Modul vorhanden ist, kann es sein, dass Firewall-Einstellungen am Server die Verbindung zu fremden Servern auf HTTP-Port 80 (oder anderen) verbieten. Je nach Einsatzzweck müssen Sie Verbindungen zu den Servern, die Serendipity von sich aus anspricht (zB. github.com für den Download von Plugins), explizit erlauben. Sollte dies nicht möglich sein, können Sie Serendipity zwar nutzen, müssen aber auf die entsprechende Funktionalität verzichten.
• openssl (PHP-Modul) openssl Damit die Serendipity-Komponenten intern auf https-URLs zugreifen können (und beispielsweise Trackbacks zu solchen geschützten URLs senden können), wird das PHP-Modul openssl benötigt. Ebenso wichtig ist, dass Ihr Serversystem mindestens openSSL ab Version 1.1.1d (zB. in Debian Buster) einsetzt, damit keine Kompromisse bei der Verschlüsselungsstärke für "langlebig" gespeicherte Auto-Logins (siehe Wartung) gemacht werden müssen.
• zlib (PHP-Modul) zlib Soll Serendipity die HTML-Seiten per gzip-Kompression bündeln, wird das PHP-Modul zlib benötigt.
• sendmail sendmail Um E-Mails zu versenden (zB. um auf neue Kommentare hinzuweisen), muss PHP mit der sendmail-Option kompiliert worden sein.
• MySQL PostgreSQL SQLite mysql, pgsql, sqlite Abgesehen von einem Datenbanksystem muss auf Ihrem Server auch die Client-Schnittstelle für die jeweilige Datenbank (MySQL(i), PostgreSQL, SQLite) als PHP-Modul (mysqli, pgsql, sqlite) eingebunden sein. Standardmäßig wird PHP mit MySQL-Bibliotheken eingerichtet; seit PHP 5 ist auch das Datenbanksystem SQLite üblicherweise aktiviert.
• Cache APC ZendCache ionCube APC, ZendCache, ionCube Um die Geschwindigkeit zu erhöhen, empfiehlt sich der Einsatz von PHP-Bytecode-Caches wie APC (apc), ZendCache oder ionCube. PHPModule@PHP-Module|)

PHP!Konfigurationseinstellungen

PHP bietet zahlreiche sicherheitsrelevante Parameter, deren aktueller Wert bei der Installation des Blogs angezeigt und auf optimale Einstellung überprüft wird. All diese Einstellungen werden in der php.ini-Konfigurationsdatei geändert phpini@php.ini und bedürfen je nach Serverumgebung eines Neustarts der Webserver-Software. Für Hilfe zur Konfiguration von PHP und des jeweiligen Webservers schlagen Sie bitte in der Anleitung der jeweiligen Software nach, da dies den Rahmen dieses Buchs sprengen würde.

VirtualHost Kommt Apache zum Einsatz, können die Einstellungen auch pro Domain konfiguriert werden. Im jeweiligen <VirtualHost>-Abschnitt der Konfigurationsdatei (je nach Apache-Version unterschiedlich, meist httpd.conf httpd.conf oder auch in Dateien unterhalb des Apache conf.d-Verzeichnisses) muss dazu php_admin_value option wert bzw. php_value option wert eingetragen werden. Alle per php_value einstellbaren Optionen lassen sich auch über eine .htaccess-Datei htaccess@.htaccess im Stammverzeichnis des Webauftritts verändern. Einstellungen in dieser Datei haben Vorrang vor den globalen Optionen, die in der Webserverkonfiguration oder in php.ini definiert wurden. Via php_admin_value gesetzte Werte lassen sich von .htaccess-Dateien nicht mehr verändern.

Serendipity selbst legt bei der Installation eine solche Datei im Serendipity-Verzeichnis an. Sollte Ihr Webserver deren Auswertung unterbinden, können Sie die von Serendipity erstellte Datei gefahrlos löschen, verlieren dadurch aber die Möglichkeit, sprechende URLs zu benutzen sowie den Download einiger interner Dateien zu verhindern. Daher sollten Sie dies nur dann tun, wenn Ihr Provider auch nach Rücksprache die Auswertung der .htaccess-Dateien nicht genehmigt.

htaccess@.htaccess Haben Sie die Möglichkeit, die .htaccess-Nutzung über AllowOverride (Apache-Option) die Option AllowOverride in der Webserver-Konfigurationsdatei zuzulassen, geschieht dies im <VirtualHost>-Abschnitt mittels

    <Directory /pfad/zum/serendipity-verzeichnis>

      AllowOverride All

      Require all granted

    </Directory>

AllowOverride (Apache-Option) Notfalls reicht auch AllowOverride Options FileInfo. Der Wert All erlaubt es Plugins grundsätzlich, weitere Webserver-Optionen zu setzen, und gibt Ihnen damit mehr Flexibilität.

Serendipity setzt in seiner .htaccess-Datei (siehe Seite htaccess) die Optionen session.use_trans_sid (Seite session-trans-sid) und register_globals (Seite register-globals). Bei der Benutzung des Apache-Moduls mod_rewrite kommen auch die Optionen RewriteEngine, RewriteBase und RewriteRule zum Einsatz. Die .htaccess-Optionen ErrorDocument und DirectoryIndex ermöglichen freie Permalinks (siehe Seite urlformung). Damit der Webserver bestimmte Serendipity-Dateien nicht im Klartext darstellt, folgt ein Deny from All als Sicherheitsmaßnahme.

    RewriteEngine off

Für Serendipity relevante PHP-Konfigurationsoptionen

phpini@php.ini|( httpd.conf|(

Folgende Optionen sind/waren für Serendipity maßgeblich:

phpini@php.ini!session.use_cookies php_value session.use_cookies .htaccess, php.ini oder Webserverkonfiguration;

Serendipity speichert temporäre Dateien in PHP-Sessions. Um eine Session eindeutig zu identifizieren, vergibt das System Session-IDs, die üblicherweise in einem HTTP-Cookie gespeichert werden. Damit Serendipity Cookies Session-Cookies PHP-Session-Cookies nutzen kann, muss diese Option aktiviert sein.

session-trans-sid phpini@php.ini!session.use_trans_sid php_value session.use_trans_sid wird von Serendipity selbst in der .htaccess-Datei auf 0 gesetzt, kann aber auch in der php.ini oder der Webserverkonfiguration geändert werden;

Wenn der Browser keine Cookies akzeptiert, kann die Session-ID auch an URL!mit Session-ID die URL angehängt werden. PHP macht dies automatisch, wenn die Option session.use_trans_sid aktiviert ist. Diese Automatik ist seitens Serendipity jedoch aus Sicherheitsgründen unerwünscht. Sollte die Option dennoch aktiviert sein, können fremde Nutzer ungültige Session-IDs in die URL Angriff!auf Session-Dateien einschleusen und somit möglicherweise Ihre Session-Dateien kompromittieren. Ein Serendipity-Blog sollte daher niemals die Session-ID in einer URL angeben. Gibt Ihnen jemand eine Serendipity-URL wie http://www.example.com/serendipity/index.php?PHPSESSID=23213123adasd, kann es sein, dass diese Person Missbrauch!von Session-Daten verhindern Ihre Daten ausspähen will. Die serverseitige Deaktivierung der PHP-Option session.use_trans_sid beugt solchem Missbrauch vor.

phpini@php.ini!allow_url_fopen php_admin_value allow_url_fopen nur in der php.ini oder in der Webserverkonfiguration änderbar;

PHP liest und behandelt URLs wie normale Dateien, wenn diese Option aktiviert ist. Gerade in älteren PHP-Versionen öffnet die Aktivierung Angriff!auf das System dieser Option die Tür für Angriffsszenarien, in denen Code von fremden Internetseiten bei Ihnen ausgeführt werden kann (und so das System kompromittiert).

Damit die Aktivierung dieser sicherheitsrelevanten Option nicht erforderlich ist, greifen alle wichtigen Serendipity-Funktionen stattdessen über Sockets auf Netzwerk-Ressourcen zu. Nur veraltete Plugins erfordern möglicherweise die Aktivierung dieser Option. Es empfiehlt sich, sie zu deaktivieren und nur bei Bedarf zuzuschalten.

register-globals phpini@php.ini!register_globals php_value register_globals wird von Serendipity selbst in der .htaccess-Datei auf off gesetzt, kann aber auch in php.ini oder der Webserverkonfiguration festgelegt werden;

Wenn diese Variable aktiviert ist, stellt PHP URL-Variablen im globalen Namensraum zur Verfügung. Ältere PHP-Programme benötigen diese Option, Serendipity greift jedoch nicht auf dieses Feature zurück. Aus Sicherheitsgründen ist es daher sehr zu empfehlen, die Option zu deaktivieren, sofern sie nicht für andere auf dem Webserver laufende Anwendungen benötigt wird.

phpini@php.ini!safe_mode php_admin_value safe_mode php_admin_value safe_mode_include_dir php_admin_value safe_mode_gid lediglich via php.ini oder Webserverkonfiguration änderbar;

Safe Mode (PHP) Safe Mode PHPs Safe Mode stellt sicher, dass lokale PHP-Anwendungen wie Serendipity nur auf die Daten im eigenen Stammverzeichnis zugreifen und keine fremden Dateien einbinden können. Obwohl Serendipity mit dieser Einschränkung generell funktioniert, hat die Aktivierung dieses Modus folgende Nachteile: Die Optionen safe_mode_include_dir und safe_mode_gid legen fest, auf welche Verzeichnisse ein PHP-Skript Zugriff hat. Solange die Benutzerrechte (Permissions) und die Eigentumsverhältnisse (Ownership) auf dem Webserver für das Serendipity-Installationsverzeichnis korrekt gesetzt sind, lassen sich zB. Mediathek-Dateien problemlos hochladen. Ein falsch eingerichteter Safe Mode hat zur Folge, dass man mittels FTP oder Administrationsoberfläche keine Templates und andere Dateien hochladen und keine Bilder im Nachhinein löschen oder bearbeiten kann.

phpini@php.ini!open_basedir php_admin_value open_basedir nur via php.ini oder in der Webserverkonfiguration änderbar;

Ähnlich wie der Safe Mode lässt sich der Datei-Zugriffsschutz von PHP auf gewisse Verzeichnisse beschränken. Üblicherweise wird diese Option in Zusammenhang mit den Safe-Mode-Parametern konfiguriert. Während der Safe Mode lediglich den globalen Dateizugriff auf Gruppen- und Benutzerebene regelt, schränkt open_basedir den Zugriff auf vordefinierte Verzeichnisse ein.

Verwendet Ihr Webserver diese Option, gehört das Serendipity-Installationsverzeichnis unbedingt in die damit konfigurierte Verzeichnisliste. Anderenfalls kann der Webserver die Installationsdateien nicht aufrufen. Als Trennzeichen zwischen zwei Verzeichnispfaden dient in dieser Option das Semikolon (;).

Bleibt diese Option leer, ist der Zugriff auf alle Verzeichnisse möglich. Befindet sich bereits der Verzeichniseintrag . in der Auflistung, steht dieser Punkt synonym für das Verzeichnis, in dem ein PHP-Programm ausgeführt wird.

Gerade auf Servern, die viel mit symbolischen Dateisystemlinks arbeiten, muss der Administrator sorgfältig auf die korrekte Konfiguration der involvierten Verzeichnispfade achten.

phpini@php.ini!session.cookie_domain php_value session.cookie_domain .htaccess, php.ini oder Webserverkonfiguration;

Wenn Serendipity einen HTTP-Cookie setzt (also zB. die Session-ID oder Login-Daten), enthalten diese den Namen der Domain, auf dem sich die Serendipity-Installation befindet. Falls in der PHP-Variable session.cookie_domain ein Domainname eingetragen ist, nutzt Serendipity stattdessen diese Domainangabe. In dem Fall stellen Sie sicher, dass sich dieser Wert mit dem Domainnamen des s9y-Servers deckt. Wenn ein Webserver für mehrere Domains konfiguriert ist und an dieser Stelle einen zentralen Domainnamen setzt, ist dies oft Ursache für spätere Probleme.

phpini@php.ini!session.save_path php_value session.save_path .htaccess, php.ini oder Webserverkonfiguration;

Alle von Serendipity gespeicherten Sessiondaten werden im mit dieser Option angegebenen Verzeichnis gespeichert. Der ausführende PHP-Prozess muss darauf Schreibrechte besitzen. Stellen Sie bei Windows-Servern sicher, dass hier ein gültiger Verzeichnisname (zB. C:/Temp) eingetragen ist. Sollten PHP-Sessions nicht schreibbar sein, zeigt Serendipity Fehlermeldungen an.

file-uploads phpini@php.ini!file_uploads phpini@php.ini!post_max_size phpini@php.ini!upload_max_filesize phpini@php.ini!max_input_time php_admin_value file_uploads php_value post_max_size php_value upload_max_filesize php_value max_input_time .htaccess, php.ini oder Webserverkonfiguration - file_uploads nur via php.ini oder Webserverkonfiguration änderbar;

Damit man überhaupt Dateien hochladen kann, muss file_uploads aktiv sein. Die maximale Dateigröße einer hochgeladenen Datei legen post_max_size, das ein Limit für HTTP-Requests mitsamt aller Daten definiert, und upload_max_filesize fest, das seinerseits eine spezielle Obergrenze nur für die mittels HTTP-Request übermittelten Dateien setzt. Die maximale Zeit für die Verarbeitung einer Datei beim Upload legt die Variable max_input_time fest.

memory-limit phpini@php.ini!memory_limit php_admin_value memory_limit Einstellung via php.ini oder Webserverkonfiguration;

Serendipity benötigt einiges an Arbeitsspeicher auf dem Webserver. In einer Grundkonfiguration reichen meist zwischen drei und vier MB RAM. Der Speicherbedarf kann mit der Anzahl und der Komplexität von Plugins jedoch zunehmen.

Wie viel verfügbaren Speicher PHP-Anwendungen insgesamt nutzen dürfen, legt die Variable memory_limit fest. Sollte der Arbeitsspeicher Fehlermeldungen zufolge nicht mehr ausreichen, müssen Sie entweder dieses Limit hochsetzen oder Serendipity-Plugins löschen.

phpini@php.ini!display_errors php_value display_errors php_value error_log .htaccess, php.ini oder httpd.conf;

Einige Server geben PHP-Fehlermeldungen nicht an den Browser weiter, um Fehlermeldungen!PHP-Fehlermeldungen nicht an Browser geben PHPFehlermeldungen@PHP-Fehlermeldungen!nicht an Browser geben Angriff!Informationen über ~e weniger leicht angreifbar zu sein.[*] Fehlermeldungen können kritische Dateipfade eines Servers offenlegen (Information Disclosure). Solche Informationen erlauben es Angreifern, bestimmte Rückschlüsse auf die Einrichtung eines Server zu ziehen. Wenn Sie allerdings einmal auf Probleme stoßen oder eigene Anpassungen eine leere Seite zum Ergebnis haben, empfiehlt es sich ggf., diese beiden Optionen temporär zu aktivieren. Die bessere Alternative heißt: häufiger die Fehler-Logfiles des Webservers prüfen.

phpini@php.ini|) httpd.conf|)

Die Serendipity .htaccess-Datei

htaccess htaccess@.htaccess

Befehle, die Serendipity eigenständig in die .htaccess-Datei im Stammverzeichnis einträgt, fasst die Software in einen Block ein, der mit #Begin s9y beginnt und mit #End s9y endet. Wenn Sie eigene Parameter in diese Datei einfügen, tun Sie dies daher vor #Begin s9y oder nach #End s9y. Das verhindert, dass Serendipity diese Zeilen ändert. Wenn Sie eine von Serendipity gesetzte Option überschreiben müssen, fügen Sie die Option mit dem von Ihnen gewünschten Wert am besten nach dem s9y-Block nochmals ein.

Auf einem Server ohne mod_rewrite sieht der s9y-Block wie folgt aus:

# BEGIN s9y

DirectoryIndex /serendipity/index.php

php_value session.use_trans_sid 0

php_value register_globals off



<Files *.tpl.php>

    deny from all

</Files>



<Files *.tpl>

    deny from all

</Files>



<Files *.sql>

    deny from all

</Files>



<Files *.inc.php>

    deny from all

</Files>



<Files *.db>

    deny from all

</Files>



# END s9y

Der erste Parameter, DirectoryIndex, legt die zentrale Serendipity-Datei index.php als Startseite des Blogs fest. Wenn in der Serendipity-Konfiguration bei der URL-Umformung (siehe Seite urlformung) die Option Apache ErrorHandling eingestellt wurde, folgt als nächste Zeile der Eintrag ErrorDocument 404 /serendipity/index.php. Die darin genannte Datei dient als Weiterleitungsziel für alle virtuellen URLs, auch bei der Verwendung von mod_rewrite.

Die nächsten beiden Zeilen deaktivieren die PHP-Einstellungen session.use_trans_sid und register_globals.

Zuletzt folgen mehrere Abschnitte, die den Zugriff auf interne Serendipity-Dateien (*.tpl.php, *.tpl, *.sql, *.inc.php und *.db) verbieten.

Wurde mod_rewrite aktiviert, sieht die .htaccess bis auf einen Block genauso aus wie die eben gezeigte:

# BEGIN s9y



ErrorDocument 404 /serendipity/index.php

DirectoryIndex /serendipity/index.php

php_value session.use_trans_sid 0

php_value register_globals off



RewriteEngine On

RewriteBase /serendipity/

RewriteRule ^((id/([0-9]+))/?) index.php?/$1 [NC,L,QSA]

RewriteRule ^(authors/([0-9]+)\-[0-9a-z\.\_!;,\+\-\%]+) index.php?/$1 [NC,L,QSA]

...

RewriteRule (.*.html?) index.php?url=/$1 [L,QSA]



<Files *.tpl.php>

    deny from all

</Files>

...



# END s9y

Hinzugekommen ist der Befehl RewriteEngine On, der mod_rewrite aktiviert. RewriteBase legt den Stammpfad für alle Operationen fest. Die einzelnen RewriteRules legen fest, wohin der Nutzer weitergeleitet wird, wenn er spezielle URLs aufruft. Der erste Teil hinter einer RewriteRule gibt an, welches Muster in der URL gesucht wird, der zweite Teil legt fest, welche Datei aufgerufen wird, und zuletzt folgen spezielle mod_rewrite-Optionen in eckigen Klammern.

L gibt eine abschließende Regel an: Sobald eine URL auf das jeweilige Muster zutrifft, werden die übrigen Muster nicht mehr geprüft. QSA bedeutet, dass URL-Parameter (die sogenannten GET-Variablen) an die Ziel-URL angehängt werden. NC besagt, dass Groß- und Kleinschreibung bei einer URL nicht unterschiedlich behandelt wird.

Die jeweiligen Regeln werden mittels regulärer Ausdrücke formuliert, die bestimmte Muster in Zeichenketten detailliert beschreiben.

PEAR

PEAR PEAR

Das PHP Extension and Application Repository (kurz PEAR) ist eine Sammlung von PHP-Skripten und -Modulen, von der zahlreiche Web-Anwendungen Gebrauch machen. Auch Serendipity setzt mehrere PEAR-Komponenten ein: Cache::Lite, HTTP::Request, Onyx, Net::Socket, Text::Wiki und XML::RPC. Damit diese nicht zentral auf dem Webserver installiert sein müssen, liefert Serendipity die Komponenten im Unterverzeichnis bundled-libs mit.

Wenn die entsprechenden PEAR-Komponenten bereits auf dem Webserver vorhanden sind, räumt Serendipity diesen standardmäßig den Vorrang ein, damit Systemadministratoren bei kritischen Updates nicht auch das bundled-libs-Verzeichnis anfassen müssen. Dabei kommt es manchmal zu (Versions-)Konflikten.

In diesem Fall kann man in der globalen Serendipity-Konfigurationsdatei serendipity_config.inc.php mit

    $serendipity['use_PEAR'] = false;

darauf beharren, dass die von Serendipity Styx mitgelieferten Komponenten zum Einsatz kommen. Serendipity!Voraussetzungen|)

XHTML, XML und CSS

XHTML HTML CSS XML

HTML [*] https://meiert.com/de/publications/indices/html-elements/ stellte ursprünglich eine einfache Syntax zur Formatierung von Dokumenten im Web bereit. Während es anfangs nur sehr primitive Auszeichnungselemente gab (Überschriften, Fettungen, Tabellen), sorgten viele Entwickler-Gremien schnell und leider auch unübersichtlich für Erweiterungen. Parallel zu HTML wurde XML (Extensible Markup Language) als universelles Dateiformat entwickelt, um beliebige maschinen- und menschenlesbare Inhalte darzustellen. Im Gegensatz zu Binärformaten lassen sich für XML plattformübergreifend Schnittstellen bereitstellen und standardisiert eigene Unterformate für alle erdenklichen Einsatzzwecke erfinden.

Auch HTML wurde mittels XHTML-Standard mit der XML-Syntax aufgefrischt und konsolidiert. Strenge Regeln sorgen nun dafür, dass sich HTML-Dokumente von vielerlei Programmen interpretieren und "validieren" (also auf syntaktische Korrektheit prüfen) lassen. In der Theorie ermöglicht dies weitgehende Abstraktion von Layout und Inhalt. Der besseren Interpretation durch Software wegen konnte das CSS-Format (Cascading Style Sheets) seinen Siegeszug antreten. CSS-Dateien lassen sich auf Elemente in XHTML-Dokumenten anwenden und legen so die Formatierung der strukturellen Elemente eines Dokuments fest.

Auch wenn viele Webseiten heute noch nicht mit gültigem XHTML entwickelt werden und es Bemühungen gibt, die "dumme Einfachheit" von HTML mit laxeren Prüfungen wieder aufleben zu lassen, ist ein Vorteil von XHTML unumstritten: Weiterverwendbarkeit.

Inzwischen sind wir bei dem universalen HTML 5 [*] https://www.w3.org/TR/html5/ und gar HTML 5.1 [*] https://w3c.github.io/html/ gelandet.

Browser

Webbrowser

Ein Browser ist eine Software auf Ihrem Computer, mit der Sie Internetadressen aufrufen und ansehen können. Bekannte Browser sind der Mozilla Firefox, Google Chrome oder auch Apple Safari. Der Begriff "Browser" steht dabei für das "Stöbern" (neudeutsch "Surfen") im Internet, denn erst durch diese Software wird aus einem speziell formatierten HTML-Dokument etwas, das ein Besucher am Bildschirm wirklich ansehen und benutzen kann.

Die am Markt verfügbaren Browser unterscheiden sich in Merkmalen wie Sicherheit, Geschwindigkeit, Funktionsumfang und auch Darstellungsqualität. Obwohl HTML und CSS festgelegte Standards sind, weicht jeder Browser bei deren Interpretation doch geringfügig ab, daher stellen verschiedene Browser ein und dieselbe Webseite möglicherweise unterschiedlich dar.

Client, Server

Client Server Client-Server

Bei der Kommunikation im Internet sind Millionen von Computern miteinander vernetzt. Beim Abrufen von Daten aus dem Internet über Ihren Browser verbindet sich Ihr Computer mit einem fremden Computer, auf dem diese Daten liegen.

Ihr Computer stellt dabei einen Client dar, also den Empfänger. Der Rechner, der Daten ausliefert, dient dabei als Server, also als Absender. Bei Nutzung fast jedes Internet-Protokolls spielen für die Kommunikation zwei Datenkategorien eine Rolle: das, was ein Client sendet und empfängt, und das, was ein Server sendet, empfängt und verarbeitet.

RSS, Feeds, Syndication und Aggregation

RSS RSS

RSS ist die Abkürzung für Rich Site Summary oder auch Really Simple Syndication und der Name eines Datenformats, das gemeinsam mit den Blogs die Web-Welt verändert hat.

Eine Datei im RSS-Format ist grundsätzlich erst einmal nur eine XML-Datei, die einen speziellen Satz von Elementen enthält. Diese legen die Eigenschaften von Blog-Artikeln, wie Titel, Inhalt oder Hyperlinks, fest.

Eine RSS-Datei stellt eine Art Newsticker dar, der meistens die chronologisch neuesten Änderungen an News-Artikeln oder Blog-Einträgen aufführt. Solche Dateien werden kontinuierlich (meist automatisch) aktualisiert und auch Feeds als Feed bezeichnet. Dafür ausgelegte Software kann eine solche maschinenlesbare RSS-Datei weiterverarbeiten und mit dem Inhalt Syndication Aggregation anderer Webseiten zusammenführen (hier seien die Schlagworte Aggregation und Syndication genannt).

RSS-Reader RSS-Reader-Programme ermöglichen es Internet-Nutzern, die RSS-Dateien von Webseiten ähnlich wie mit einem E-Mail-Programm regelmäßig zu überprüfen, und informieren so leicht und übersichtlich über Änderungen.

Manche RSS-Dateien liefern den Inhalt eines neuen Artikels mit, so dass der Nutzer ihn sich unabhängig von der Webseite ansehen kann. Diese Einbindungsweise fokussiert auf den eigentlichen Inhalt von Webseiten, da sie es erlaubt, Inhalte beinahe darstellungsneutral zu beziehen.

Unterschiedliche Gremien haben zahlreiche RSS-Versionen erarbeitet, teilweise inkompatibel zueinander und mit jeweils anderen Attributen. Das verbreitetste RSS-Format ist Version 2.0. Serendipity unterstützt auch RSS 0.9, 0.91 und 1.0. Diese gelten heutzutage aber als veraltet.

Webservices, Web 2.0, Social Web

Webservices Webservices Web 2.0 Social Web

In dem Maße, wie Webserver in Skriptsprachen wie PHP und Perl geschriebene Anwendungen zu interpretieren lernten, wurde es immer einfacher und interessanter, verschiedene Komponenten miteinander zu verbinden. Dynamische Software eröffnete ganz neue Möglichkeiten, Besuchern einer Webseite Zusatzdienste, sogenannte Webservices, zu präsentieren. Als Beispiel seien die Anzeige von neuen Terminen, die Darstellung von Wetterdaten, spezielle passwortgeschützte Bereiche oder auch die Darstellung von Bookmarks genannt.

Auf zahlreichen Webseiten kann man oft kostenlos Community-Dienste in Anspruch nehmen, die sich mittels Webservices an die eigene Webseite anbinden lassen - sei es die Liste aktueller Fotos von der eigenen Flickr-Fotoseite, die Darstellung der Lieblingslinks, des aktuellen Wetters zuhause oder auch die Einbindung fremder Werbung. Derartige Services bezeichnet man auch als Social Web, da ein Gedankenaustausch in einer gemeinsamen Community stattfindet.

Der Begriff Web 2.0 steht gesamtheitlich für die Wandlung des ehemals statischen Web 1.0 hin zu einer Web-Welt mit verflochtenen Diensten und großen Interaktionsmöglichkeiten unter Einbeziehung der Web-Nutzer.

XML-RPC, SOAP, REST

Damit ein Webservice angesprochen werden kann, benötigt man eine gemeinsame Schnittstelle zwischen Empfänger (Client) und Absender (Server). Eine solche lässt sich mittels verschiedener Techniken anbieten.

XML-RPC

Die im PHP-Umfeld verbreitetste Schnittstelle nennt sich XML-RPC. RPC steht hierbei für Remote Procedure Call, also der Aufruf einer Funktion durch ein fremdes Programm. Zur Datenübergabe und -annahme wird hierbei XML verwendet. Der Server erhält eine XML-Datei mit speziellen Anforderungen. Die ausführende Server-Software interpretiert diese, wertet sie aus und schickt das Ergebnis wieder im XML-Format zurück an den Client.

SOAP

Eine dazu konkurrierende Schnittstelle nennt sich SOAP (Simple Object Access Protocol). Auch SOAP arbeitet mit XML-Datensätzen, hat aber eine wesentlich komplexere Datenarchitektur und wird aufgrund dieses Overheads im Web eher selten eingesetzt.

REST

Als dritte bekannte Schnittstelle bietet sich REST an: Representational State Transfer. Diese simpelste der Schnittstellen führt Abfragen anhand einfacher URL-Parameter durch und gibt üblicherweise auch einfach zu interpretierende XML-Daten zurück.

XML-RPC ist für die Weblog-Welt insofern interessant, als sie es erlaubt, Inhalte neutral von der verwendeten Blogsoftware zu erfassen. Die meisten Blogsysteme binden eine gemeinsame XML-RPC-Schnittstelle ein, die das Erstellen und Bearbeiten von Artikeln mittels "Fernsteuerung" ermöglicht. Dadurch kann ein Benutzer seine Artikel mit ganz normaler Desktop-Software wie zB. ecto, marsEdit, WindowsLive Writer oder sogar Microsoft Word schreiben, anstatt sie in der Web-Oberfläche seiner Blogsoftware zu verfassen. Gerade für Benutzer, die sich nicht mit neuer Schreib-Software auseinandersetzen wollen, ist diese Variante sehr interessant.

Atom

Um die verschiedenen Varianten von RSS wieder zueinanderzuführen, entwickelte das W3C-Gremium einen Standard namens Atom. In einem vollständig gültigen XML-Format deckt es alle Fähigkeiten von RSS ab, wird aber aufgrund der höheren Komplexität heute immer noch als Konkurrenz zu RSS 2.0 angesehen.

Der Begriff Atom steht nicht nur für ein Dateiformat, sondern auch für eine Implementation der XML-RPC- oder SOAP-Protokollschnittstelle, die es erlaubt, entsprechend ausgerüstete Weblog-Software fernzusteuern.

Trackback und Pingback

Da Blogs letztlich Sprachrohre von Individuen darstellen, ist es für einen Blog-Betreiber meist sehr wichtig, sein Blog mit anderen zu vernetzen. Ganz im Sinne des interaktiven Webs bestand ein wichtiger Gedanke bei der Erfindung des Blogs darin, Beiträge eines Autoren auf dessen Seite kommentieren zu können und so in Dialog zu treten.

Leser von Blogs sind häufig selber Blogbetreiber und möchten -- gerade bei abweichender Meinung - eine Diskussion gern auf der eigenen Seite weiterführen, ohne dabei die Verbindung mit dem Initiator zu verlieren. Trackbacks Hierfür wurde die Technik der Trackbacks erfunden, die es einem Autor erlaubt, seinen Artikel mit einem anderen zu verketten. Die Besonderheit dabei: Die fremde Webseite wird davon automatisch in Kenntnis gesetzt. Somit befindet sich nicht nur auf der eigenen Seite ein Link auf den Quellartikel, sondern es gibt auch einen, der vom Quellartikel auf die eigene Seite zeigt. Wie das bei Serendipity funktioniert, behandelt Kapitel trackback ab Seite trackback.

Pingback Ein Pingback ist eine abgeschwächte Form des Trackbacks. Der Initiator kann auf diese Weise den Ursprungsautor darauf hinweisen, dass er sich auf ihn bezogen hat. Dabei wird auf dessen Blog kein (ausführlicher) Verweis für andere Besucher erzeugt.

API und Plugin

API API

Eine API (Application Programming Interface) stellt ein Software-Regelwerk (meist eine konkrete Liste an Funktionen oder Klassen) zur Verfügung, an das man sich als Programmierer halten kann, um auf gewisse Funktionen einer Software zuzugreifen. Bei Serendipity benötigt man ein solches Regelwerk vor allem für Erweiterungen mit eigenen Plugins oder den Zugriff von fremder Software.

Serendipity bietet eine funktionsorientierte Kern-API zur Verwaltung von Artikeln und Datenbankabfragen. Weiterhin gibt es eine spezielle, objektorientierte Plugin-API, die alle notwendigen Methoden abdeckt, die man als Entwickler eigener Plugins benötigt.

Plugins Ein Plugin ist Software, die sich nahtlos in ein Hauptprogramm einbindet (to plug bedeutet einstöpseln). Es hat Vorteile, gewisse Funktionalitäten in Plugins bzw. Programmmodule auszulagern. Dadurch hält man zum einen die Kernsoftware schlank, zum anderen kann man losgelöst von der Kernsoftware Aktualisierungen durchführen und Funktionalitäten erweitern. Ein Benutzer hält sein System schlank und performant, indem er nur die Plugins installiert, die er für seine Anwendungsfälle nutzt. Auch bei Webservices gibt es zahlreiche APIs, die den Verkehr zwischen Client und Server jeweils strukturieren.

Mashup

Der Begriff Mashup bezeichnet die Verkettung mehrerer Webservices. Dank der Offenheit vieler APIs lassen sich die abgefragten Daten beliebig miteinander kombinieren, zB. die Wetterdaten eines mittels Google Maps dargestellten Orts anzeigen. Oder man bindet auf der Karte die Bilder ein, die Flickr-Benutzer zu diesen Geo-Koordinaten eingestellt haben. Die Verknüpfungsmöglichkeiten sind oft nur durch Ihre Phantasie begrenzt.

Usability, Barrierefreiheit, Accessibility

Usability ist ein Forschungsfeld, das sich damit beschäftigt, wie man zB. eine Webseite am besten bedienen kann. Es beschäftigt sich ua. mit der konzeptionellen Struktur einer Seite, dem Aufbau der Navigation, der Gliederung der Inhalte und auch der Einbindung von Formularen, Suchen und anderen interaktiven Elementen.

Da sich eine Webseite häufig stark von einer normalen Software auf dem Computer unterscheidet, lassen sich Software-Usability-Weisheiten nicht einfach auf Webseiten übertragen. Wie man dennoch zielgerichtet auf Benutzer eingeht und deren Erwartungen erfüllt, ist Aufgabe der Web-Usability.

Barrierefreiheit Accessibility|see{Barrierefreiheit}

Eine Teilmenge des Oberbegriffs Usability ist die Barrierefreiheit (englisch Accessibility). Diese beschreibt Techniken und Maßnahmen, die auch behinderten Personen die Benutzung einer Webseite ermöglichen. Darunter zählen Dinge wie eine geschickte Farbwahl, sinnvolle Kontraste, aber auch der gezielte Einsatz von Bildern nur an Stellen, wo sie nötig sind.

XHTML!und Barrierefreiheit

XHTML erlaubt zudem die Trennung von Layout und Inhalt, die man der Barrierefreiheit zuliebe stets beachten sollte. Gültiger, valider Quellcode ist Voraussetzung dafür, dass jeder Browser (und damit jeder Besucher) Ihre Webseite problemlos bedienen kann. Denken Sie auch an blinde Menschen, die die Inhalte Ihrer Seite vorgelesen bekommen müssen: Wenn Sie die Navigation nicht speziell hervorheben, kann es sein, dass dem Benutzer diese beim Vorlesen vorenthalten wird.

Serendipity Standard-Templates versuchen so barrierefrei wie möglich zu sein und bei der Usability auf klare Strukturen zu achten. Erfahrungsgemäß ist dies bei einem Open-Source-Projekt recht schwer, da meist nur Programmierer und erfahrene Benutzer am Werk sind, die keinen Wert auf einfache Zugänglichkeit legen. Serendipity hat hier im Laufe der letzten Jahre sehr stark zugelegt und ist daher für eine barrierefreie Zukunft bestens gerüstet. Wie Sie diese in Ihrem Blog letztlich selber umsetzen, wird ab Seite Anpassungen ausführlich besprochen.

BBCode, Textile, Markup und Textformatierung

Markup Textformatierung

Üblicherweise werden Blog-Artikel in HTML-Syntax formatiert. Da HTML jedoch gerade für Anfänger nicht ganz trivial ist, gibt es mehrere Standards, die das Ziel einfacher Textformatierung verfolgen. Solche Standards, darunter BBCode BBCode [*] https://www.phpbb.com/community/help/bbcode Textile Markdown [*] https://michelf.ca/home/ oder Textile [*] https://textile-lang.com/ bieten Tags eigene Tags (also Formatierungsmarker) an, die ein System wie Serendipity später in HTML-Format konvertiert.

BBCode basiert auf in Foren üblichen Markierungen: Fettung!in BBCode Textformatierung!fett|see{Fettung} Formatierung!fett|see{Fettung} [b]text[/b] formatiert zB. das Wort text fett. Alle Tags werden in eckigen Klammern geschrieben; Vereinfachungen wie [URL=http://www.google.com]Google[/url] Links!in BBCode erlauben es, relativ einfach Links zu setzen.

Serendipity bietet für alle bekannteren Markups Plugins an, so dass auch Kommentatoren zu einem Blog-Eintrag auf diese Syntax zugreifen können. Kommentare!Formatierung Die direkte Eingabe von HTML ist bei Kommentaren nicht möglich, daher stellen solche Plugins die einzige Möglichkeit der Formatierung dar.

WYSIWYG

Eine weitere Möglichkeit, die Redakteuren die Eingabe von Text erleichtert, ist der sogenannte WYSIWYG-Modus: What You See Is What You Get. JavaScript JavaScript-Module erstellen im Webbrowser ein Texteingabefeld. Dieses enthält Formatierungsbuttons ähnlich wie bei OpenOffice bzw. Microsoft Word, die es erlauben, die Farbe oder den Schriftstil zu ändern, per Drag&Drop Texte und eingebundene Bilder zu verschieben oder Tabellen einzufügen.

Im Folgenden wird also zwischen dem PLAIN TEXT Editor, also dem einfachen Textfeld mit oder ohne BB-Code artige Formatierungshilfen, und dem Rich Text Format (WYSIWYG-Modus) unterschieden.

Artikel die mit dem PLAIN TEXT Editor erstellt und gespeichert wurden, werden zur Laufzeit des Abrufes in HTML umgewandelt. Dazu dienen verschiedenste Plugins. Benutzen Sie die fortschrittlicheren markdown oder textile Formatierungen, geschieht das gleiche. Auch diese wandeln als vereinfachte Auszeichnungssprachen bestimmte Formatierungshilfen in HTML zur Ausgabe um.

Das Rich Text Editor Format (WYSIWYG-Modus) speichert derweil gleich das komplette HTML fertig zur Ausgabe. Dies ist insbesondere wichtig zu wissen, damit man sein System konsistent halten kann.

Wenn Sie allerdings um die Tücken wissen, macht es nichts aus ein altes Blog von beispielsweise markdown auf den CKEditor umzustellen. Es ist heutzutage einfach das zu präferierende Format.

Serendipity wird standardmäßig mit dem WYSIWYG-Editor CKEditor [*] https://ckeditor.com/ ausgeliefert. Dieser Editor läuft problemlos mit allen aktuellen Browsern (Chrome, Firefox, Internet Explorer, Firefox, Safari, etc) und wird professionell und aktiv weiterentwickelt. Er hat sich mittlerweile zum quasi-Standard der HTML Editoren am Markt entwickelt. In Serendipity ist er als Core-BASIC-Editor im /templates/_assets Ordner angesiedelt. Außerdem existiert noch das CKEditor Plus-Plugin, das immer die neueste Version mit leichter Zeitverzögerung mitbringt und per Plugin Konfiguration sehr leicht verschiedenste Ausbaustufen de Editors zulässt. Im Grunde ist es damit unnötig geworden irgendein anderes WYSIWYG-Editor-Plugin wie TinyMCE einzusetzen, wenn nicht absolut wichtige persönliche Präferenzen dafür sprechen. (Siehe WYSIWYG)

Widgets, Nuggets, Blogroll

Widget Nugget Klötze

Viele Webservices erlauben es, ihre Dienste mit einem einfachen Code-Schnipsel auf der eigenen Seite einzubinden. Beliebte Beispiele dafür sind zB. Google AdSense, das aktuelle Wetter, die letzten Flickr-Bilder und vieles mehr. Solche eingebundenen Schnipsel bezeichnet man als Widgets oder Nuggets/Klötze. Diese lassen sich bei Serendipity leicht in das eigene Blog einbauen.

Blogroll Ein Beispiel für ein Widget ist die sogenannte Blogroll. Dies ist letztlich nichts anderes als eine Liste von Blogs, die man persönlich liest oder als empfehlenswert betrachtet. Sie erlaubt es zB., den eigenen Freundeskreis virtuell zu präsentieren. Durch Blogrolls werden die Leser eines Blogs auch auf thematisch ähnliche oder sozial verbundene Blogs aufmerksam. Kein unwichtiges Feature, wenn man bedenkt, dass sich die Popularität häufig verlinkter Blogs in Suchmaschinen steigert.

Upload der Dateien

Download Serendipity!Download

Serendipity Styx sollten Sie natürlich direkt auf der GitHub-Projektseite.[*] https://github.com/ophian/styx/releases unter Releases herunterladen. Es ist ratsam mit den namentlich ausgezeichneten Downloads zu beginnen, denn die Source code (zip) und Source code (tar.gz) Dateien sind reine Developer snapshots, während die namentlichen Serendipity Archive über eine interne Bereinigung und mehrere Sicherheitsmaßnahmen wie Berechtigungen etc. verfügen.

Nightlies Snapshots Lite Release Tarball Auf GitHub finden Sie sowohl die aktuellste Ausgabe als auch Beta- und ältere Versionen und die täglichen Snapshots. Obwohl es sich bei Letzteren um die tagesaktuellen Entwicklerversionen handelt, sind diese bei Serendipity für gewöhnlich sehr stabil.

Außerdem können Sie die Pakete in mehreren Archivformaten herunterladen: als zip-Datei, sowie als xz (Dateinamensendung tar.xz) oder gzip (Dateinamensendung tar.gz) gepackten Tarball. Alle drei Varianten enthalten die gepackten PHP-Dateien, die Sie auf Ihren Webserver hochladen müssen. Für Windows-Benutzer ist das zip-Archiv am einfachsten zu handhaben, unter Unix empfiehlt sich der Tarball. Am besten schauen Sie vorher kurz einmal nach welches Format tatsächlich angeboten wird.

Falls Sie via ssh direkten Shellzugriff auf Ihren Webserver haben, laden Sie das Paket mittels wget ohne Umwege direkt auf den Server und entpacken es mit einem Kommandozeilen-Programm:

    user@server:~# cd /var/www/example.com/

    user@server:~# wget "https://github.com/ophian/styx/releases/download/3.2.0/serendipity-3.2.0.tar.xz"

    [...]

    user@server:~# tar -xvf serendipity-3.2.0.tar.xz

    [...]

Anderenfalls laden Sie das Paket auf Ihren eigenen Rechner und entpacken es dort mit einem geeigneten Programm in ein temporäres Verzeichnis. Aus diesem Ordner heraus laden Sie alle Dateien und Unterverzeichnisse des entpackten serendipity-Unterverzeichnisses mit allen Dateien mittels FTP-Programm auf Ihren Webserver.

Fehler!beim Upload Achten Sie beim Aufspielen der Dateien unbedingt darauf, dass der Transfer nicht an einer Stelle abbricht oder fehlschlägt. Teilweise hochgeladene Dateien können Serendipity unbenutzbar machen. Da insgesamt mehrere hundert kleine Dateien hochgeladen werden, empfiehlt es sich, im FTP-Programm die Benutzung sogenannter Threads zu aktivieren. Damit öffnet es mehrere parallele FTP-Verbindungen und lädt die Dateien so schneller hoch. In jedem Fall sollten Sie sorgfältig auf etwaige Fehlermeldungen achten.

Abgesicherte Installation

Download Serendipity!Download

Serendipity Styx wird über eine sogenannte abgesicherte Installation geschützt, um zufällige andere Gäste aus dem Installationsprozess herauszuhalten. Dazu dient eine temporäre install_token.php Datei, die man schnell per FTP heraufladen und im Root Verzeichnis von Serendipity platzieren muss. Um eine abgesicherte Installation auszuführen, müssen Sie diese Datei namens install_token.php mit dem String (Beispiel Token)

<?php $install_token = 'ea032be371d64ec77009257f6f0f9b424b182519'; ?>

in diesem Wurzelverzeichnis erstellen. Achten Sie darauf keine zusätzlichen Leerzeichen oder Zeilen am Anfang oder Ende der Datei einzufügen. Dieser Token ist einzigartig und fixiert die Autorisierungs-Beziehung zwischen Ihnen und dem Installer.

Sobald diese Datei existiert, müssen Sie die Installation innerhalb der nächsten XX Minuten ausführen und dürfen ihren Browser währenddessen nicht schließen. Sie müssen Cookies erlauben.

Fügen Sie also nun den Sicherheits Install Token ein, der Ihnen auf der Seite angegeben wird, laden Sie die Datei hoch und reloaden Sie die Browserseite.

Sie sind nicht autorisiert die Installation auszuführen, wenn Ihr vorgegebener Install-Token nicht demjenigen aus der hochgeladenen Datei install_token.php entspricht. Stellen Sie sicher, dass Sie die Datei mit dem korrekten Inhalt erstellt haben. Sie können einen neuen Token erstellen, in dem Sie die Datei löschen.

Ist ihr sicherer Install-Token gültig, können Sie Serendipity wie gehabt installieren.

Selbst wenn Sie vergessen sollten die Datei nach getanem Werk wieder zu löschen, richtet diese keinen Schaden an.

Einrichten der Verzeichnisse

Nach dem Upload finden Sie auf Ihrem Webserver im Verzeichnis serendipity einige Dateien mit .php-Endung (index.php, comment.php, serendipity_admin.php ...) sowie einige Unterverzeichnisse (bundled-libs, docs, include, lang, plugins, ...).

Um Zugriffsrechte auf einem Server zu verwalten, bedienen sich sowohl Windows- als auch Linux-Systeme sogenannter Eigentümer- und Gruppenrechte. Jeder Benutzer des Systems kann Dateieigentümer und jeder Eigentümer kann Mitglied einer oder mehrerer Benutzergruppen sein.

Schreibrechte Zugriffsrechte Benutzergruppen!Rechte Zugriffsrechte Jede Datei (und jedes Verzeichnis) auf einem Server ist einem Eigentümer und einer Gruppe zugewiesen. Für beide wird der Zugriff auf eine Datei über ein Zugriffs- (oder Ausführbarkeits-), Lese- und Schreibrecht geregelt. Meist hat ein Eigentümer die vollen Rechte an einer Datei: Er kann sie ansehen, ändern und löschen. Die anderen Mitglieder derselben Benutzergruppe können jedoch abweichende Rechte haben, so dass sie die Datei nur ansehen, aber nicht verändern dürfen. Zudem muss noch geregelt werden, welche Zugriffsrechte Benutzer haben, die weder Eigentümer noch Gruppenmitglieder sind. Auch für diese "anderen Benutzer", also den "Rest der Welt", werden Zugriffs-, Lese und Schreibrecht aufgeteilt.

Wenn Sie eine Datei mittels FTP auf einen Webserver laden, tun Sie dies (zwangsläufig) mit dem Benutzeraccount, der für den FTP-Zugriff eingerichtet wurde. Hochgeladene Dateien werden diesem Benutzeraccount und standardmäßig einer Gruppe zugewiesen, der Ihrem Benutzerkonto angehört. Dieses Vorgehen stellt sicher, dass andere Benutzer, die auf demselben Server tätig sind, nicht einfach Ihre Dateien lesen oder verändern können. Optimalerweise haben diese keine Möglichkeit, auf von Ihnen hochgeladene Dateien zuzugreifen.

Die Webserver-Software, die die von Ihnen hochgeladenen Dateien interpretiert und als Webseite ausliefert, läuft ebenfalls mit den Rechten eines bestimmten Benutzers. Dieser heißt häufig www-data, wwwrun oder auch nobody. Damit dieser Systembenutzer Software wie Serendipity ausführen kann, muss er bestimmte Rechte an den von Ihnen hochgeladenen Dateien haben. Das müssen Sie sicherstellen. In üblichen Konfigurationen ist Ihr Benutzeraccount Mitglied derselben Gruppe wie der Webserver-Nutzer, die Lesezugriff auf alle hochgeladenen Dateien hat.

Beim Hochladen von Dateien mittels FTP können Sie in diese Rechte eingreifen. Dazu bieten viele Programme bei Rechtsklick auf eine Datei oder ein Verzeichnis ein Menü namens Permission oder CHMOD an (Abbildung 2.1a).

Dort trägt man, Unix-Konventionen entsprechend, die Zugriffsrechte für Eigentümer/Benutzer (Owner), Gruppe (Group) und Rest (Other) ein: für jede dieser drei Nutzerkategorien eine Zahl.

Eine 0 bedeutet "kein Zugriff", eine 1 "Ausführen möglich", eine 2 "Schreiben erlaubt" und eine 4 "Lesen erlaubt". Diese Zahlen lassen sich addieren, so dass ein Lese- und Schreibzugriff durch die Zahl 6 angegeben wird. Für Verzeichnisse gilt dabei, dass diese nur betreten werden dürfen, wenn das Recht mit der Zahl 1 in der Summe enthalten ist, etwa beim Vollzugriff mit 7.

Mit der Zugriffsmaske 777 erhält jeder Nutzer volle Zugriffsrechte auf die betroffene Datei. Damit stellt man einfach sicher, dass sowohl der eigene Benutzeraccount als auch der des Webservers volle Zugriffsrechte haben -- allerdings auch andere Benutzer auf demselben Server. Daher ist es besser, die Zugriffsrechte von Dateien und Verzeichnissen so strikt wie möglich zu setzen. Wie dies konkret bei Ihnen aussieht, klären Sie am besten mit Ihrem Provider.

Als Beispielhaft gelten also 775 für Verzeichnisse und 644 für Dateien. Am besten konsultieren Sie die Serendipity Styx FAQ für mehr.

Damit der Webserver Serendipity ausführen kann, benötigt er Leserechte für alle Dateien und Verzeichnisse. Um Serendipity zu installieren, braucht er zudem anfangs Schreibzugriff auf das Stammverzeichnis, damit er die Dateien serendipity_config_local.inc.php und .htaccess erstellen kann. Darüber hinaus wird das Installationsprogramm die Unterverzeichnisse templates_c, archives und uploads zu erstellen versuchen. Sollte es diese schon geben, müssen Schreibrechte für den Webserver-Benutzer dafür vergeben werden. Nach der Installation benötigt der Webserver nur noch Schreibrechte auf die genannten drei Unterverzeichnisse und zwei Dateien, den globalen Schreibzugriff auf das Stammverzeichnis können Sie also wieder entfernen.

Wenn Sie darüber hinaus das Spartacus-Plugin zum Download von Templates und Plugins nutzen wollen (siehe Kapitel Spartacus ab Seite Spartacus), müssen auch die Verzeichnisse plugins und templates beschreibbar sein (und bleiben).

Einrichten der Datenbank

DBeinrichten Datenbank!einrichten|(

Nachdem nun also alle notwendigen Dateien hochgeladen wurden und Sie die Zugriffsrechte konfiguriert haben, müssen Sie eine Datenbank für Serendipity einrichten.

Je nachdem, welche Datenbanksoftware auf Ihrem Webserver zur Verfügung steht, kann dieser Vorgang unterschiedlich ausfallen.

Verwendet Ihr Webserver mindestens PHP5, ist die SQLite!einrichten Datenbank SQLite automatisch verfügbar. Dieses Datenbanksystem speichert alle seine Datenbanken und Tabellen in einer einzigen Datei. Diese wird im Serendipity-Verzeichnis abgelegt und während der Installation ohne Ihr Zutun automatisch erstellt, es sind daher keine vorbereitenden Eingriffe notwendig.

Beim Einsatz von MySQL und PostgreSQL geht Serendipity davon aus, einen Datenbankbenutzer und eine leere Datenbank vorzufinden. Üblicherweise erhält man die Zugangsdaten von seinem Provider, da der Benutzeraccount bereits besteht. Manche Provider gestehen Ihnen nur eine einzelne Datenbank zu, so dass Sie keine neuen erstellen können. Das ist nicht weiter tragisch, da sich Serendipity problemlos mit anderen Anwendungen innerhalb derselben Datenbank betreiben lässt. Viele Provider bieten zudem eigene Oberflächen zur Erstellung einer Datenbank an.

Serendipity benötigt lediglich irgendeine Datenbank für seine Tabellen -- man kann also problemlos eine bereits bestehende Datenbank für die Installation benutzen.

Für Styx und MariaDB/MySQL geben Sie der Datenbank am besten gleich die korrekte utf8mb4_unicode_ci, bzw. noch besser die neuere und erweiterte utf8mb4_unicode_520_ci Kollation mit auf den Weg.

Wie auch an anderer Stelle erwähnt, wird der Name MySQL hier als Synonym für MariaDB/MySQL Datenbanken benutzt. Empfohlen ist auf MariaDB zu setzen, ein Unternehmen das vom MySQL-Gründer Michael "Monty" Widenius betrieben wird, und das in wesentliches Details gegenüber Oracles MySQL zu empfehlen ist.

Datenbank!Rechte Privileges Sollte noch kein Datenbankbenutzeraccount bestehen, müssen Sie ihn anlegen. Dabei ist wichtig, dass der Benutzer über alle Rechte verfügt, die Serendipity später im Betrieb benötigt. Konkret heißt das, dass er Tabellen anlegen (CREATE), aktualisieren (ALTER) und indizieren (INDEX) sowie Datensätze anlegen (INSERT), aktualisieren (UPDATE), lesen (SELECT) und löschen (DELETE) darf.

Um für MySQL einen solchen Benutzer anzulegen, benutzt man (in einem Programm wie phpMyAdmin, welches die meisten MySQL!einrichten phpMyAdmin!Nutzer anlegen Provider anbieten) folgende SQL-Syntax:

    CREATE DATABASE serendipity;

    GRANT SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, INDEX ON serendipity

    TO 'serendipity'@'%' IDENTIFIED BY PASSWORD 'passwort';

Diese beiden Befehle erstellen die leere Datenbank namens serendipity und den gleichnamigen Benutzer, der die notwendigen Zugriffsrechte erhält und sich über das Passwort passwort ausweisen muss. Bei PostgreSQL benutzt man folgende Syntax: PostgreSQL!einrichten

    CREATE USER serendipity WITH PASSWORD 'passwort';

    CREATE DATABASE serendipity WITH OWNER = serendipity;

    GRANT SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER ON DATABASE

    serendipity TO 'serendipity'

Um die Serendipity-Installation erfolgreich durchzuführen, benötigen Sie den Benutzernamen des Datenbanknutzers (hier serendipity), dessen Passwort, den Namen einer leeren Datenbank und den Namen (oder die IP-Adresse) des Datenbankservers. Datenbank!einrichten|)

Die grafische Installationsroutine

Installation!aufrufen Fehler!Installation} webinstaller

Nach diesen Vorarbeiten rufen Sie die URL Ihrer Serendipity-Installation im Browser auf, hier also http://www.example.com/serendipity/. Versuchen Sie nicht, eine Datei Ihrer lokalen Festplatte aufzurufen oder eine Datei mittels FTP-Zugriff zu öffnen (zB. via Doppelklick). Dies würde Ihnen lediglich den Quellcode der PHP-Anwendung anzeigen. Stattdessen müssen Sie den Webbrowser einsetzen, damit Ihr Webserver die PHP-Anwendung ausführt.

Bei korrekter Einrichtung des Webservers sehen Sie nun eine Kurzübersicht wie in Abbildung 2.2, die aufführt, welche Voraussetzungen der Server erfüllen muss, ehe Sie fortfahren können. Sollte sich diese entgegen Ihren Wünschen in englischer Sprache präsentieren, konfigurieren Sie Ihren Browser so um, dass Deutsch die bevorzugte Sprache darstellt.

Fehler!bei der Installation Weist Sie die Übersicht auf einen Fehler bei den Schreibrechten oder den Server-Einstellungen hin, beheben Sie ihn und rufen Sie die Installationsoberfläche erneut auf. Warnungen werden mit roter Schriftfarbe dargestellt, eingeschränkte Funktionen oder Hinweise in Gelb; korrekte Einstellungen sind grün hervorgehoben.

Hinweise der Installationsoberfläche zeigen dabei einen Unterschied zwischen dem von Serendipity empfohlenen Wert und der Einstellung auf Ihrem Webserver an. Im Gegensatz zu Fehlern können Sie Serendipity bei solchen Hinweisen aber trotzdem betreiben, jedoch entweder mit Einbußen bei der Performance oder Funktionalität.

Stimmen die systemseitigen Voraussetzungen, was gerade bei den Rechten oft schon die Regel ist, starten Sie die Installationsoberfläche über einen der beiden Links am Ende der Seite: Einfache Installation oder Fortgeschrittene Installation.

Die Einfache Installation verlangt von Ihnen nur die absolut notwendigen Angaben. Dagegen bietet die Fortgeschrittene Installation sämtliche Konfigurationsoptionen an, die sich auch später im laufenden Betrieb ändern lassen. Da wir in Kapitel Konfiguration ab Seite Konfiguration detailliert auf alle Optionen eingehen, klicken Sie an dieser Stelle am besten auf Einfache Installation.

Die Folgeseite (Abbildung 2.3) stellt alle Installationsoptionen in Gruppen unterteilt dar.

Abschluss der Installation

Sind alle Optionen eingetragen (keine Angst, Sie können sie später allesamt wieder verändern), schließen Sie den Installationsvorgang durch einen Klick auf Vollständige Installation ab.

Die letzte Seite der Installationsroutine (Abbildung 2.4) informiert Sie über die von Serendipity durchgeführten Aktionen. Dazu gehört das Anlegen der notwendigen Tabellen und des Standardbenutzers und die Einrichtung der Standard-Plugins. Sollten Sie an dieser Stelle noch nicht über eine passende Datenbank verfügen oder andere Fehler auftreten, informiert Sie Serendipity auch darüber. Dann heißt es zurück zu Abschnitt DBeinrichten ab Seite DBeinrichten.

Bei fehlerfreier Installation können Sie über die URL http://www.example.com/serendipity/ das Frontend aufrufen und unter http://www.example.com/serendipity/serendipity_admin.php mit den gewählten Login-Daten auf das Backend zugreifen.

Die Konfigurationsdatei serendipity_config_local.inc.php

serendipity-configlocalincphp@serendipity_config_local.inc.php

Alle grundlegenden Konfigurationsvariablen wie die Daten für den Datenbankzugang und die aktuelle Versionsnummer speichert Serendipity in der Datei serendipity_config_local.inc.php im Stammverzeichnis. Diese Datei sieht ungefähr wie folgt aus:

<?php

    /*

      Serendipity configuration file

      Written on Thu, 14 Apr 2022 11:22:27 +0200

    */



    $serendipity['versionInstalled']  = '3.8.2';

    $serendipity['dbName']            = 'serendipity';

    $serendipity['dbPrefix']          = 'styx_';

    $serendipity['dbHost']            = '127.0.0.1';

    $serendipity['dbUser']            = 'root';

    $serendipity['dbPass']            = 'root';

    $serendipity['dbType']            = 'mysqli';

    $serendipity['dbPersistent']      = false;



    // End of Serendipity configuration file

    // You can place your own special variables after here:



?>

Ähnlich wie bei der .htaccess-Datei (siehe Seite htaccess) können Sie in dieser Datei später auch eigene Konfigurationsparameter nachtragen. Fügen Sie diese nach der Zeile You can place your own special variables after here: ein, so dass Serendipity sie bei einer Konfigurationsänderung nicht versehentlich überschreibt. Je nach Konfiguration des Webservers kann es sein, dass Sie keine Schreibrechte für diese Datei besitzen. Dies fixperm.php lässt sich mit dem fixperm.php-Skript (siehe Seite fixperm) ändern.

Fehler bei der Installation

installationsfehler Installationsfehler|see{Fehler} Fehler!bei der Installation

Die zahlreichen Konfigurationsmöglichkeiten von Webservern geben Spielraum für hinterlistige Fehler.

    php_value display_errors on

<?php



$ziel = '/var/www/example.com/serendipity/serendipity_config_local.inc.php';

if (chmod($ziel, 0777)) {

  echo "Rechte geändert.";

} else {

  echo "Fehler: Rechte dürften nicht verändert werden.";

  echo "Sie müssen den Provider kontaktieren.";

}



?>

    Warning: session_write_close() [function.session-write-close]:

    open(/var/lib/php/session/sess_h5a8jerb22q54pkqcjb4qtnqr1, O_RDWR)

    failed: Permission denied

<?php



$input  = file_get_contents('dump-iso.sql');

$output = @utf8_encode($input);

$fp     = fopen('dump-utf8.sql', 'wb');

if ($fp) {

  fwrite($fp, $output);

  fclose($fp);

} else {

  echo "Keine Schreibrechte, bitte korrigieren.";

}



?>

    @define('DATE_LOCALES', 'de_DE.ISO-8859-1, de_DE.ISO8859-1, german, de_DE, de_DE@euro, de');

Kommentare zu einzelnen Artikeln

Die Ansicht der Kommentare (und Trackbacks) zu einem Beitrag erreicht man entweder durch einen Klick auf die Detailseite eines Beitrags oder indem man auf den Link Kommentare (x) klickt. Je nach Einstellung des Blogs (siehe Seite config-popups) öffnet sich dann ebenfalls die Detailseite des Beitrags oder ein Popup-Fenster mit den Kommentaren.

Trackbacks zu einem Artikel werden unterhalb eines Beitrags vor den Kommentaren chronologisch geordnet angezeigt. Ein Trackback ist ein Artikel eines fremden Blogs, der sich auf Ihren geschriebenen Beitrag bezieht. Dabei führt der Link des Trackbacks zu diesem fremden Beitrag, und zur Orientierung werden die ersten Absätze des fremden Beitrags mit angezeigt. Damit ein fremdes Blog sich auf Ihren Artikel beziehen konnte, war der Link Trackback für spezifische URI dieses Eintrags vorgesehen. Ein Klick darauf, oder das Überfahren mit der Maus verriet, dass dieser Link nicht für die Ansicht im Browser gedacht war, sondern für fremde Blogsysteme übernommen werden sollte. Besucher mussten diesen Link verwenden, um ein Trackback zu Ihnen zu senden. Heutzutage ist dies aber viel einfacher gelöst, denn sollte ihr Theme bereits über einen "link rel" tag im Seitenkopf verfügen <link rel="trackback" type="application/x-www-form-urlencoded" href="https://ihrBlog.de/styx/comment.php?type=trackback&entry_id=28"> (als beispielhaften Eintrag), was heutzutage die Regel ist, ist die genannte URL für alte Systeme obsolet, denn ihr System "lauscht" bereits automatisch auf eventuell gesetzte Trackbacks, wenn jemand die eigentliche URL ihres Artikels https://ihrBlog.de/styx/archives/28-titel.html im eigenen Blog verlinkt.

Nach den Trackbacks folgt die Auflistung der Kommentare. Standardmäßig werden diese thread-basiert aufgelistet. Dabei startet die Auflistung mit dem chronologisch ersten Kommentar, und mögliche andere Kommentare, die sich auf diesen beziehen, werden eingerückt darunter dargestellt. Daher nennt sich diese Ansicht Verschachtelt. Falls Sie eine chronologisch sortierte Ansicht bevorzugen, kann man diese über den Link Linear aufrufen.

Kommentare!sperren Trackbacks!sperren Als Redakteur des Blogs sehen Sie zudem noch den Link Kommentare für diesen Eintrag nicht mehr zulassen, mit dem Sie die Kommentarfunktionalität eines Beitrags (auch übergangsweise) sperren können. An derselben Stelle erscheint danach auch wieder ein Link zum Entsperren.

Zu jedem Kommentar wird der Name des Kommentatoren dargestellt, sowie (falls von ihm angegeben) seine E-Mail-Adresse und Homepage.

Nach der Auflistung der vorhandenen Kommentare kann ein eigener, neuer Kommentar eingefügt werden. In das Eingabeformular trägt man dazu seine Daten (Name, E-Mail, Homepage, Bezug) sowie den gewünschten Kommentartext ein. Unterhalb der Eingabebox befindet sich ein Hinweis, welche Textformatierungsmöglichkeiten es gibt, um gewisse Dinge hervorzuheben.

Die Auswahlbox Daten merken? kann genutzt werden, damit der eingetragene Name in Zukunft vom Browser vorausgefüllt wird. Die Box Bei Aktualisierung dieser Kommentare benachrichtigen bestimmt, ob man bei einem neuen Kommentar zu dem Beitrag per E-Mail informiert werden soll.

Um einen Kommentar vor Übermittlung zu überprüfen, kann man den Button Vorschau benutzen. Die Folgeseite zeigt den eigenen Kommentar dann so innerhalb der Webseite, wie er danach für alle Besucher erscheinen sollte. Gerade wenn Sie Sonderzeichen oder HTML-Code in Ihrem Kommentartext benutzen, dient die Vorschau der Kontrolle, ob später auch wirklich alles angezeigt werden kann.

Nach Abschicken eines Kommentars kann es je nach Einstellung des Artikels zu einer Moderation kommen - in diesem Fall muss ein Redakteur einen Kommentar erst autorisieren, bevor er angezeigt wird (siehe Seite Kommentare).

Kommentarübersichten

Kommentarübersicht Frontend!Kommentarübersicht

Neben der gezielten Ansicht von Kommentaren zu einem Artikel gibt es auch eine Übersichtsseite, auf der alle Kommentare unabhängig vom Artikel dargestellt werden.

Dies eignet sich besonders, um zu sehen, zu welchen Einträgen bestimmte Personen kommentiert haben. Die Seite zeigt dabei wie üblich seitenweise blätterbar die Überschrift eines Artikels an, und darunter die getätigten Kommentare.

Diese /comments/ Ansichten haben eine fest eingestellte, optionslose und spezifische Limitierung von 10 Kommentaren pro Seite, können aber über die manuell gesetzte $serendipity['CBAfetchLimit'] Variable zB. in der serendipity_config_local.inc von Hand überschrieben werden. Als ein gutes Maß haben sich 20 Kommentare per Seite herausgestellt, deshalb ist es zu empfehlen diese Variable zu setzen, wenn Sie solcherlei Übersichten anbieten. Ab Styx 4.1 wird dies zu einer normalen Konfigurationsoption.

Diese Übersichtsseite ist bisher in wenigen Templates eingebaut und wird daher von Besuchern auch seltener genutzt.

Das Permalink-Schema sieht dabei wie folgt aus: Permalinks!Kommentare

/comments/kommentator/ stellt die Übersicht aller Kommentare dar, die vom Benutzer kommentator stammen. Die Kommentatoren werden dabei in der Datenbank nach exakter Übereinstimmung mit dem Namen in der URL herausgesucht. Ohne Angabe eines solchen Wertes werden die Kommentare aller Benutzer angezeigt. Sollten Sie nach Namen mit Leerzeichen suchen, müssen Sie ein + anstelle des Leerzeichens einfügen, zB. /comments/John+Doe/.

/comments/last_5/ stellt die Übersicht der Kommentare der letzten fünf Tage zu allen Artikeln des aktuellen Monats ab Uhrzeit dar. Ohne Angabe eines solchen Wertes werden alle Kommentare angezeigt.

/comments/from_2007-12-01/ stellt alle Kommentare seit dem 01.12.2007 dar. Das Datum muss hierbei der GNU DATE-Syntax entsprechen, siehe https://www.gnu.org/software/coreutils/manual/html_node/Examples-of-date.html. Ohne Angabe dieses Wertes wird keine minimale Zeitbeschränkung gesetzt.

/comments/to_2007-12-31/ stellt alle Kommentare dar, die bis zum 31.12.2007 gemacht wurden. Das Datum muss ebenfalls der GNU DATE-Syntax entsprechen. Ohne Angabe dieses Wertes wird keine maximale Zeitbeschränkung gesetzt.

/comments/trackbacks/ stellt anstelle einer Übersicht zu Kommentaren die Übersicht der Trackbacks dar.

/comments/comments_and_trackbacks/ stellt sowohl Kommentare als auch Trackbacks dar.

/comments/comments/ stellt nur Kommentare dar. Da die Variable dem Standard entspricht, kann man sie üblicherweise weglassen.

/comments/P2.html stellt die zweite Seite einer Übersicht dar. Die Pfadkomponente P (für Page) wird gefolgt von einer Seitennummer.

Auch bei diesem Schema lassen sich die Pfadkomponenten miteinander kombinieren, um besondere Ansichten zu erhalten:

/comments/garvin/last_5 stellt die Übersicht der Kommentare der letzten fünf Tage des Benutzers garvin dar.

/comments/from_2007-01-01/to_2007-12-31/ stellt die Übersicht aller Kommentare vom 01.01. bis zu 31.12.2007 dar.

/comments/comments_and_trackbacks/from_2007-01-01/P2/ stellt die zweite Übersichtsseite aller Kommentare und Trackbacks seit dem 01.01.2007 dar.

Caching von RSS-Feeds

Caching von RSS-Feeds Caching Conditional GET Fehler!RSS-Feeds

Da RSS-Feeds von den RSS-Readern Ihrer Besucher relativ häufig aufgerufen werden (meist halbstündlich), ist es wichtig, dort so wenig wie möglich Redundanz für die Datenübertragung zu verursachen.

Bei 200 Abonnenten Ihres RSS-Feeds und einem größeren Artikelbestand kommt es durchaus vor, dass die XML-Datei des Feeds 100kb und größer ist. Bei dieser Benutzerzahl würden Sie pro Stunde 4MB (das sind im Monat gut 3GB!) an Daten übertragen. Wenn Sie durchschnittlich nur alle drei Tage einen neuen Artikel schreiben, wäre ein Großteil dieser Datenmenge unnötig übertragen worden.

Um dieses Problem zu lösen, wurde im HTTP-Standard ein Caching [*] Ein Cache ist ein Zwischenspeicher oder Puffer, der einmal erstellte Daten erneut ausgeben kann, anstatt sie neu zusammenzustellen. -Mechanismus vorgesehen. Dabei überträgt der RSS-Reader (und auch jeder Webbrowser) den Zeitpunkt des letzten Abrufs an den Server. Der Server vergleicht, ob sich seit diesem Zeitpunkt etwas am RSS-Feed geändert hat. Falls das nicht der Fall ist, wird eine leere Antwort an die Software zurückgeschickt, und es werden keine Daten übertragen.

Wenn sich etwas verändert hat, kann der Server lediglich die seit dem letzten Aufruf erneuerten Daten übermitteln und spart so nochmals an Übertragungszeit (und damit auch Server-Performance).

Dieser Vorgang wird als Conditional GET bezeichnet und ist in Form einer verbindlichen RFC 2616 RFC 2616 (Richtlinie des HTT-Protokolls) festgehalten. Dennoch gibt es leider einige Clients, die das Caching nicht vollständig implementieren und mit derartig ausgelieferten RSS-Feeds Probleme haben. Solche Probleme können sich darin äußern, dass ein RSS-Reader ständig bereits bekannte Einträge des RSS-Feeds als neu ansieht oder womöglich gar keine neuen Artikel empfangen kann.

Um bei solchen kaputten Clients dennoch einen Serendipity-Feed korrekt abrufen zu können, ist der eingangs erwähnte Parameter nocache=true an den Aufruf der rss.php-URL anzuhängen.

Im Zusammenhang mit dem globalen Caching unterstützt Serendipity die Auslieferung von Artikeln ab einem bestimmten Datum. Da üblicherweise RSS-Feeds nur die letzten 15 Artikel [*] Siehe: Konfiguration: Design und Optionen: Anzahl der Artikel auf der Startseite, enthalten und man möglicherweise einmal für eine Weile den RSS-Feed nicht empfangen kann [*] Vielleicht hat man ja einmal sein Notebook oder die UMTS-Karte im Urlaub vergessen ... ;-), könnte es also passieren, dass man Artikel schlichtweg verpasst. Bei der Übermittlung einer Angabe des zuletzt gesehenen Artikels wird dies vermieden, und Serendipity würde in so einem Fall auch alle weiteren Artikel über dem 15. ausliefern.

Diese Auslegung des RFC-Standards verursacht in manchen RSS-Readern und vor allem Aggregatoren wie der Software Planet jedoch Probleme. In der Konfiguration des Blogs wird daher die Option angeboten, das strikte RFC2616 zu veranlassen (siehe Seite rfc2616). Zwei weitere Variablen (siehe Seite Caching-Variablen) dienen darüber hinaus der Feineinstellung von Caching-Inhalten.

Sobald diese Option aktiviert ist, wird Serendipity, wie andere Software auch, stur nur die letzten 15 Artikel ausliefern und somit das Feature der Urlaubsschaltung deaktivieren.

Mögliche Fehler beim Login

Fehler!Login

Das häufigste Problem beim Login ist ein PHP-Server, bei dem die Sessions nicht, wie im Kapitel Voraussetzungen auf Seite Voraussetzungen beschrieben, korrekt eingerichtet sind. Dies kann sich darin äußern, dass Sie sich nach jedem Klick neu einloggen müssen.

Ältere Serendipity-Versionen verursachten zudem ähnliche Probleme, wenn die URL http://localhost/... lautete. Viele Browser akzeptieren keine Login-Cookies, wenn der Servername nicht mindestens zwei Punkte enthält. Auch sollten Sie generell prüfen, ob Ihr Browser möglicherweise Cookies ablehnt oder eine Antiviren-Software auf Ihrem Rechner Session-Cookies blockiert.

Auch Umlaute im Passwort oder Benutzernamen können dazu führen, dass Ihr Passwort nicht korrekt abgeglichen werden kann. In manchen Fällen kann es helfen, wenn Sie in Ihrem Browser alle Cookies löschen, die in Verbindung mit Ihrer Blog-URL gespeichert sind, dann den Browser neu starten und sich so neu einloggen können.

Passwort vergessen

Fehler!Passwort vergessen Passwort!vergessen

Serendipity speichert Ihr Passwort aus Sicherheitsgründen nicht im Klartext in der Datenbank ab. Sollte man daher sein Passwort vergessen haben, kann man dieses nicht einfach irgendwo nachschlagen, sondern muss das Passwort neu setzen.

Bis Serendipity 1.5 verwendete Serendipity MD5-Hashes um Ihre Passwörter für Logins in der Datenbanktabelle serendipity_authors zu sichern.

Da aber die Mechanismen MD5-Hashes mit Rainbow-Tabellen zu knacken, oder sogar "Wörterbuch Hash" -lookups immer mehr zunahmen und immer populärer wurden, vollzog Serendipity schon im Jahre 2009 den Schritt, den Serendipity-Hashing-Mechanismus auf einen gesalzenen und sicheren SHA1-Hash zu erhöhen. Damit wurde es aber unmöglich per phpMyAdmin mal eben so ein Passwort in der Datenbanktabelle zu ersetzen.

Später, in 2018/Q1, wurde der Hashing-Mechanismus noch einmal erhöht und benutzt jetzt BCRYPT.

Serendipity, mit seinem Anspruch höchster Rückwärts-Kompatibilität, nutzte für diese Modernisierung einen "weichen" Upgrade Ansatz. Neue Serendipity Versionen akzeptierten die alten MD5 Logins einmalig, um dann das vom Benutzer angegebene Passwort zu verwenden, die sicheren neuen Hashes zu erstellen und in der Datenbank speichern.

Ein Beispiel wie man seit den 2009er Versionen von Serendipity ein Passwort neu setzen kann, liefert folgendes kleines Script, mit dem sich problemlos arbeiten lässt, wenn man seinen Usernamen noch weiß, oder durch einen Blick in die serendipity_authors-Tabelle herausgefunden hat. Speichern Sie es im Serendipity root Verzeichnis als fixpass.php ab und rufen Sie es in ihrem Browser auf. Nach erfolgreichem Update löschen Sie es anschließend wieder von dort.

fixpass.php

    <?php

    $username = "YOURusername";

    $password = "YOURpassword";

    include 'serendipity_config.inc.php';

    echo serendipity_db_query("UPDATE {$serendipity['dbPrefix']}authors SET password = '" . serendipity_hash($password) . "', hashtype=2 WHERE username = '" . serendipity_db_escape_string($username) . "'");

    echo "Password changed.";

Das Script enthält zwei Variablen: $username und $password. Diese Variablen müssen Sie auf Ihre Gegebenheiten anpassen. Tragen Sie in die Variable $password das neue Passwort (in Anführungszeichen gesetzt) ein. In die Variable $username müssen Sie logischerweise den Usernamen des Autors setzen.

Versionen vor Serendipity Styx 2.5-beta1 müssen hashtype=1 verwenden!

XSRF/CSRF-Schutz

XSRF Fehler!Ihr Browser hat keinen gültigen HTTP-Referrer übermittelt XSRF CSRF

Bei allen Zugriffen auf das Backend führt Serendipity eine Prüfung durch, ob Sie berechtigt sind, die gewünschte Aktion (das Löschen von Beiträgen etc.) durchzuführen.

Eine im Internet derzeit verbreitete Angriffsart ist die sogenannte Cross-Site Request Forgery (XSRF, CSRF). Dabei enthält eine fremde Seite ein verstecktes JavaScript. Wenn der Angreifer die Adresse Ihres Blogs kennt und Sie die fremde Webseite besuchen, könnte diese über das versteckte JavaScript administrative Aktionen in Ihrem Blog in Ihrem Namen ausführen. Sozusagen eine bösartige, von Ihnen ungewollte Fernsteuerung Ihres Blogs. Denn für Ihr Blog erscheint es so, als würden Sie selbst die Aktion bewusst ausführen.

Um derartigem Missbrauch vorzubeugen, setzt Serendipity zweierlei Methoden ein.

Die wirkungsvollste ist, dass jede Aktion im Backend durch einen sogenannten Token Token geschützt wird. Dieser Token wird anhand Ihrer Logindaten automatisch und zufallsgeneriert erstellt, daher kann er von böswilligen Angreifern nicht ohne Eindringen in Ihren eigenen Rechner (oder die Netzwerkverbindung) ausgelesen werden. Wenn eine fremde Webseite also Ihren Browser fernsteuern möchte, scheitert die Aktion daran, dass der gültige Token fehlt.

Eine derartige Aktion quittiert Serendipity dann mit der Meldung:

    Ihr Browser hat keinen gültigen HTTP-Referrer übermittelt. Dies kann
    entweder daher kommen, dass Ihr Browser/Proxy nicht korrekt konfiguriert
    ist, oder dass Sie Opfer einer Cross Site Request Forgery (XSRF)
    waren, mit der man Sie zu ungewollten Änderungen zwingen wollte. Die
    angeforderte Aktion konnte daher nicht durchgeführt werden.

Wenn Sie diese Meldung erhalten, obwohl Sie eine Aktion veranlasst haben, kann dies darauf hinweisen, dass Ihr Browser den Token nicht korrekt übermittelt hat. Cookies Fehler!Cookies Ein Token wird in einem Browser-Cookie gespeichert, daher muss Ihr Browser Cookies zwingend akzeptieren. Weiterhin kann die Fehlermeldung erscheinen, wenn Sie Ihr Backend nicht unter der URL aufrufen, unter der Sie sich eingeloggt haben [*] Beispielsweise auch, wenn Sie sich über https://www.example.com/serendipity/ eingeloggt haben, aber über http://example.com/serendipity/ eine Aktion aufrufen.. Im Zweifelsfall kann es helfen, wenn Sie sich komplett aus dem Backend ausloggen, im Browser sämtliche Cookies des Blogs löschen und sich neu einloggen.

Die zweite Sicherheitsmethode besteht darin, dass Serendipity den HTTP-Referrer HTTP-Referrer prüft. Bei jedem Aufruf, den Ihr Browser tätigt, wird an den Server die URL der vorausgehenden Webseite übermittelt und in einer sogenannten HTTP-Kopfzeile namens Referrer (Verweis) gespeichert. Anhand dieses Wertes kann Serendipity erkennen, ob Sie vor dem Aufruf Ihres Serendipity-Backends möglicherweise eine fremde Webseite besucht haben. Im regulären Betrieb von Serendipity kann es niemals vorkommen, dass Sie eine administrative Aktion ausführen, ohne dass der HTTP-Referrer Ihrer Blog-URL entspricht.

Wenn dieser Fall eintritt, gibt Serendipity ebenfalls die oben genannte Fehlermeldung aus. Da die HTTP-Referrer-Kopfzeile jedoch laut Spezifikation kein Pflichtfeld ist und auch gewisse private Informationen über Sie ausliefert, können Sie in vielen Browsern die Übermittlung dieser Variable unterdrücken. Dann kann keine Webseite herausfinden, welche Seite Sie vorher besucht haben - und auch Serendipity kann dies nicht mehr erkennen.

Am einfachsten ist es, dass Sie in Ihrem Browser die Übermittlung des HTTP-Referrers für Ihr Serendipity-Blog aktivieren. Wenn dies nicht möglich ist, können Sie Serendipity nach wie vor betreiben, werden jedoch die oben genannte Warnmeldung sehen.

Im Gegensatz zur Sicherheitsprüfung durch den Token wird die Prüfung des HTTP-Referrers jedoch standardmäßig die auszuführende Aktion nicht abbrechen, damit der Betrieb von Serendipity auch mit derartig konfigurierten Browsern funktionieren kann. Wenn Sie in Ihrem Browser die Übermittlung des HTTP-Referrers zulassen, können Sie als weitere Sicherheitsoption die globale Variable $serendipity['referrerXSRF'] aktivieren - in so einem Fall wird eine Aktion im Backend abgebrochen, wenn der HTTP-Referrer fehlt (siehe Seite referrerXSRF).

Neuer Eintrag

Neuer Eintrag Eintrag!neuer|see{Backend, neuer Eintrag} Backend!neuer Eintrag Artikel!erstellen

Der Menüpunkt Neuer Eintrag stellt nach der Einrichtung des Blogs üblicherweise die meistgenutzte Funktionalität zur Verfügung: die einfache Erstellung eines Artikels. Dahinter verbirgt sich die Eintrags-Maske, die in einem übersichtlich strukturierten Bereich alle Optionen für einen Artikel darstellt.

Die jeweiligen Eingabefelder sind:

Eintrag!Titel Titel In diesem Feld wird der Titel des Artikels eingetragen, so wie er auch im Frontend dargestellt werden soll. Im Titel können Sonderzeichen und Umlaute enthalten sein, jedoch können keine HTML-Tags dort eingetragen werden.

Eintrag!Artikelmodus Artikelmodus Veroeffentlichung@Veröffentlichung Entwurf Im Auswahlfeld rechts neben dem Titel kann bestimmt werden, ob der Artikel beim Speichern veröffentlicht werden soll oder nur als Entwurf abgelegt wird. Die Standardeinstellung richtet sich nach der Festlegung in den Eigenen Einstellungen. Je nach den Rechten Ihres Redakteurs kann es sein, dass dieses Auswahlfeld nur die Option Entwurf zulässt. In diesem Fall muss ein Chefredakteur Ihre Artikel veröffentlichen.

Eintrag!Datum Datum Das Datum wird in dem Feld unterhalb des Artikeltitels festgelegt. Es muss dabei in einem maschinenlesbaren Format gespeichert werden: Jahr-Monat-Tag Stunde:Minute. Um die aktuelle Uhrzeit Ihres Rechners dort einzufügen, konnten Sie früher auf ein Uhr-Symbol rechts neben dem Eingabefeld klicken. Diese Uhr ist mit derselben Funktion in die erste Zeile fes Formulares gerückt. Heutzutage mit HTML5 gibt es im Datumfeld das date-local Attribut, das einen kleinen Kalender aufklappt und das ebensolche Funktion und mehr bietet. Leider handhaben die Browser das selbst heute noch unterschiedlich. Zur Not müssen Sie halt selber Hand anlegen. Dies ist in solchen Fällen hilfreich, wenn Sie einen Artikel überarbeiten (oder einen Artikel im Entwurfsmodus veröffentlichen wollen) und dabei die Uhrzeit aktualisieren möchten.   Abbildung 4.4-ts: Einträge: Datumfeld (Beispiel für Chrome Browser) Mozilla Firefox und andere zeigen hier - je nach Version - etwas Ähnliches, oder einen String wie 2018-01-10T16:18. Lassen Sie sich durch das T (für time) nicht verunsichern. Sie müssen sich nicht darum kümmern, auch wenn sie den Timestamp selbst ändern. Zeitgesteuerte Veröffentlichung Wenn Sie hier einen zukünftigen Zeitpunkt eintragen, wird Serendipity einen derart veröffentlichten Eintrag in der Übersicht nicht anzeigen. Sobald jedoch der eingetragene Zeitpunkt erreicht wurde, wird der Artikel ohne Ihr eigenes Zutun automatisch dargestellt. Somit können Sie dieses Eingabefeld auch für eine zeitgesteuerte Veröffentlichung nutzen.

eintraege-kategorie-dropdown Eintrag!Kategorie Kategorie Eintrag!mehreren Kategorien zuweisen Mehrere Kategorien!zuweisen Während eine einzelne, bereits gesetzte Kategorie durch einen Klick auf ihren angezeigten Namen für den Artikel festgelegt wird, können Sie einem Artikel zusätzlich mittels Klick auf den Kategorien-Titel oder das Hamburger-Symbol in der ersten Zeile auch mehrere Kategorien zuweisen. Nach einem Klick auf das Symbol werden Sie - je nach persönlicher Einstellung in den Eigenen Einstellungen - auf ein Popup oder den Kategorienblock des Eintragsformulares weitergeleitet. Dort sehen Sie eine Liste aller erstellten Kategorien in hierarchischer Gliederung. Mit gedrückter (Strg/Apfel)-Taste und einem linken Mausklick können Sie dabei mehrere Kategorien markieren und mit einem zweiten Klick eine Markierung auch wieder aufheben. Alle ausgewählten Kategorien werden dabei vom Browser markiert dargestellt.

Eintrag!Eintragstext Eintrag Den größten Platz dieser Seite nimmt das Feld für den eigentlichen Artikeltext ein. Je nachdem, ob Sie den WYSIWYG-Editor in den Eigenen Einstellungen aktiviert haben, sieht dies etwas unterschiedlich aus. Eintrag!ohne WYSIWYG-Editor Eintrag mit deaktiviertem WYSIWYG-Editor Bei deaktiviertem WYSIWYG-Editor (siehe obige Abbildung 4.4) sehen Sie ein Feld, in das direkt HTML-Code eingetragen wird. Wenn Sie einfachen, unformatierten Text schreiben wollen, können Sie diesen hier einfach einfügen. In HTML werden Umbrüche nicht durch einen üblichen Zeilenumbruch mittels Eingabe-Taste angegeben, sondern mittels des HTML-Tags <br />. Damit Sie aber Artikel trotz HTML-Tags bequem verfassen können, ist standardmäßig bei der Serendipity-Installation ein Plugin namens Textformatierung: NL2BR aktiviert worden. Dieses kümmert sich beim Speichern Ihrer Artikel darum, automatisch den gewohnten Zeilenumbruch in einen HTML-Zeilenumbruch umzuwandeln. Rechts oberhalb des Eingabebereichs für den Eintrag befindet sich eine kleine Symbolleiste, auf der mehrere Buttons verteilt sind. Damit können Sie einige Formatierungsoptionen auf Ihren Artikeltext anwenden. Geben Sie dazu einen kleinen Text in Eintrag ein und markieren Sie ein Wort daraus per Maus. noBR Aktiviert einen Block indem das nl2br Plugin nicht aktiv sein darf. Dies ist ratsam, wenn einzelne Textpassagen im Textfeld bereits HTML-formatiert sind. I, B, U I formatiert ein Wort kursiv, ein Klick auf B formatiert es fett, und ein Klick auf U unterstreicht das gewählte Wort. Zitat markiert einen größeren gewählten Textbereich als Zitat markieren. Gerade bei Blog-Einträgen ist die Form des Zitierens sehr gebräuchlich. [group: external files] Die letzten vier Buttons dienen der Einbindung von externen Dateien und benötigen daher keine vorherige Textauswahl. Ein Klick auf einen der Buttons img, Mediathek oder URL wird an der Stelle, wo sich der Cursor im Text befindet, das gewünschte Objekt einbinden. img bindet ein externes Bild ein. Bei einem Klick auf den Button werden Sie über ein Popup-Fenster aufgefordert, die URL des Bildes einzugeben. Tragen sie die URL vollständig mit http://-Präfix ein. Nach dem Klick auf OK wird automatisch der benötigte HTML-Code in Ihren Eintrag eingefügt - so können Sie sich auch direkt merken, wie ein Bild bei Gelegenheit auch manuell eingefügt werden kann. [Gallery] öffnet beim Anklicken ein neues Popup-Fenster, in dem eine Vorschau-Bilderserie als einfache Bildergalerie aus der eigenen Mediathek eingefügt werden kann. Eine detaillierte Beschreibung dieses Popups folgt auf Seite Mediathek-Popup. [Media] öffnet beim Anklicken ein neues Popup-Fenster, in dem ein Bild aus der eigenen Mediathek eingefügt werden kann. Eine detaillierte Beschreibung dieses Popups folgt auf Seite Mediathek-Popup. URL öffnet ein Eingabefenster, um einen Hyperlink zu einer Webseite einzutragen. Geben Sie dort die URL wieder vollständig mit http://-Präfix ein. Nach dem Klick auf OK können Sie zusätzlich die Beschreibung des Hyperlinks eingeben, wie er später dem Benutzer dargestellt wird. Sie können hierbei auch vor dem Klick auf den Button URL einen Text in Ihrem Artikel mit der Maus markieren, dieser wird dann beim Einfügen eines Hyperlinks automatisch als Beschreibungstext eingesetzt. Zuletzt fordert Sie der Einfügedialog noch auf, einen title/tooltip zu vergeben. Der Text, den Sie dort eintragen, wird später beim Darüberfahren mit der Maus für den Besucher in einem Info-Popup angezeigt. WYSIWYG Eintrag!WYSIWYG wysiwyg Eintrag mit aktiviertem WYSIWYG-Editor Abbildung 4.4a: Inhalt: Neuer Eintrag (aktivierter Kern WYSIWYG-Editor - Basic Toolbar im Dark Mode, Spracheinstellung: EN) Alternativ hier noch einmal die Standard Toolbar des CKEditor Plus Plugins in der CKEditor Version 4.8 aus dem Dezember 2017. Das CKEditor Plus Plugin bietet 3 Auswahlmöglichkeiten für die Toolbar: Standard, Full oder Basic. Abbildung 4.4d: Inhalt: Neuer Eintrag (aktivierter CKEditor Plus WYSIWYG-Editor - Basic Toolbar). Letztere ist auf einen Einzeiler reduziert und bietet nur die nötigsten Formatierungen. Als Beispiel sind hier aber der optionale Codesnippet-Button, der stets aktive Mediaembed-Button, das optionale Embed-Snippet-Button und 3 Serendipity Plugins (Linktrimmer, Amazonchooser, Emoticonchooser) aktiv gesetzt. Wie man sieht, sind solche gehookten Serendipity Plugin Buttons, wie auch die beiden für die Bedienung der Mediathek, in Farbe, im Gegensatz zum sonst üblich gehaltenen Schwarz. Auf die Abbildung der vollständigen Toolbar wurde hier verzichtet, da solche Vollversionen in der Praxis wohl kaum genutzt werden. Sie beanspruchen einfach zuviel Platz und man wird diese zusätzlichen Funktionen auf einem Blogsystem auch nicht wirklich gebrauchen können. Abbildung 4.4e: Inhalt: Neuer Eintrag (aktivierter CKEditor Plus WYSIWYG-Editor - Standard Toolbar) Ist in Ihren Eigenen Einstellungen der WYSIWYG-Editor aktiviert, sehen Sie einen Eingabebereich, der aus Microsoft Word oder OpenOffice bekannte Bedienelemente abbildet. Die meisten der Symbole werden auf einen markierten Text im Artikel angewendet. Wenn Sie mit der Maus darüberfahren und etwas warten, wird ein Info-Popup die jeweilige Beschreibung des Icons anzeigen. Dabei wird ab Serendipity 2.0+ der im Kern bereits implementierte CKEditor verwendet. Die Default Buttons des Editors sind in in schwarzer Schrift/Icon auf grauem Grund gehalten, die per Serendipity Plugin dazu installierten Plugins haben ein farbiges Icon. Dazu gehört per Default auch das Mediathek- und das Galerie-Icon. Weitere Hinweise zur individuellen Anpassung befinden sich in den Dateien templates/_assets/ckebasic/config.js und templates/_assets/ckebasic_plugin.js. Im Einzelnen bedeuten die Buttons und Gruppen Folgendes (Auswahl): font formatiert einen ausgewählten Textbereich mit der im Auswahlfeld gewählten Schriftart. size formatiert einen ausgewählten Textbereich mit der im Auswahlfeld gewählten Schriftgröße. format stellt ein, welchem Texttyp ein ausgewählter Textbereich entspricht. Überschriften werden später auch als HTML-Überschriften gesetzt. B formatiert einen ausgewählten Textbereich fett. I formatiert einen ausgewählten Textbereich kursiv. U formatiert einen ausgewählten Textbereich unterstrichen. S formatiert einen ausgewählten Textbereich durchgestrichen. x² Die beiden x-Zeichen mit hoch- und tiefgestellter 2 können einen ausgewählten Textbereich entsprechend positionieren group: clipboard Im letzten Bereich der oberen Symbolleiste befinden sich die Funktionen für die Zwischenablage. Ein markierter Text kann hiermit in die Zwischenablage kopiert oder ausgeschnitten und von dort in den Text eingefügt werden. Die beiden Pfeile zurück und vor können eine vorherige Aktion rückgängig machen oder wiederherstellen. group: textflow Der erste Bereich der unteren Symbolzeile ermöglicht es, den Textfluss eines gewählten Absatzes zu verändern: linksbündig, zentriert, rechtsbündig und Blocksatz. Beachten Sie beim Blocksatz, dass dies aufgrund fehlender Browser-Unterstützung für Wortumbrüche selten empfehlenswert ist. group: textdirection Die beiden Symbole mit dem Paragraphen-Symbol können einen markierten Textbereich in eine bestimmte Textrichtung (links nach rechts oder rechts nach links) fließen lassen. Dies ist hauptsächlich für arabische Sprachen interessant. group: lists Im nächsten Bereich befinden sich Icons, die den jeweiligen markierten Text in eine nummerierte oder geordnete Listenaufzählung formatieren können. Die Buttons rechts daneben dienen zur Einrückung eines Textes. group: colors Die Textfarbe und Hintergrundfarbe eines markierten Textbereichs stellen Sie über die beiden Icons mit dem T-Symbol bzw. dem Farbeimer ein. Bei einem Klick darauf öffnet sich ein Farbauswahlfenster. - Der Button mit dem horizontalen Strich fügt ein Trennzeichen in den Text an der aktuellen Cursorposition ein. chain Der Button mit dem Kettensymbol fügt an der aktuellen Cursorposition im Text einen Hyperlink ein. Bei einem Klick auf den Button werden Sie in einem Popup-Fenster aufgefordert, das Linkziel und die Linkbeschreibung einzutragen. Etwaiger vormarkierter Text wird hierbei als Beschreibung vorausgewählt. picture frame [Intern] Das Symbol mit dem Bilderrahmen ermöglicht das Einfügen eines externen Bildes. Bei einem Klick hierauf öffnet sich ein Dialog, in dem Sie die URL eines Bildes sowie weitere Optionen eintragen können. Diese sind Alternate text (für eine manuell vergebene Bildbeschreibung), Alignment (für die Ausrichtung des Bildes), Border thickness (für die Randstärke eines Bildes), Horizontal spacing (für den horizontalen Abstand in Pixel des Bildes zum Text), Vertical spacing (für den vertikalen Abstand in Pixel des Bildes zum Text). Bei einem Klick auf OK wird das gewählte Bild in den Text eingefügt. Achtung: Aus Gründen der Einbindung und der Besonderheiten der Serendipity Medien Datenbank und der HTML-CSS-Auszeichnung ihrer Inhalte, wurde dieser CKEditor eigene Button per CSS deaktiviert, so dass er zwar für den Editor weiterhin wirksam, aber weder anklickbar noch sichtbar ist. [Media] Die komfortablere Art, ein Bild einzufügen, führt über die integrierte Mediathek von Serendipity. Das Symbol hierfür befindet sich rechts neben dem Bilderrahmen und soll eine stilisierte Bilderübersicht in einer Liste darstellen. Ein Klick hierauf öffnet das Mediathek-Popup, das auf Seite Mediathek-Popup eingehender erklärt wird. [Gallery] Mit Styx haben Sie die Möglichkeit an dieser Stelle eine einfache Bildergalerie einzufügen. Dieser Button öffnet beim Anklicken ein neues Popup-Fenster, in dem eine Vorschau-Bilderserie als einfache Bildergalerie aus der eigenen Mediathek eingefügt werden kann. Eine detaillierte Beschreibung dieses Popups folgt auf Seite Mediathek-Popup. table Über den Button Tabelle lässt sich eine HTML-Tabelle einbinden. Dies ist leider relativ komplex gelöst und erfordert viel Fingerspitzengefühl bei der Einrichtung einer Tabelle, da Spalten- und Zeilenanzahl vorher festgelegt werden müssen. Eine Tabelle kann nach ihrem Einfügen im Eingabetext selber gefüllt werden. <> Der letzte Button <> hat eine ganz besondere Bedeutung: Er schaltet vom normalen WYSIWYG-Modus in den HTML-Modus um. Sobald der HTML-Modus aktiviert ist, kann man sozusagen einen Blick hinter die Kulissen werfen und prüfen, wie der Editor die eigenen Eingaben in HTML umsetzt. Wenn man sich mit HTML etwas auskennt, kann man hier möglicherweise manuell einige Fehler beheben, die der WYSIWYG-Editor bei einigen Operationen einfügen könnte. Während der HTML-Modus aktiv ist, sind alle weiteren Optionen des WYSIWYG-Editors so lange ausgeblendet, bis der HTML-Modus durch erneuten Klick wieder deaktiviert wird. min/max Der Button rechts neben dem HTML-Modus ermöglicht das Öffnen eines Popup-Fensters, in dem man den Text des Artikels in einem größeren Bereich bearbeiten kann. Diese Ansicht muss man mit erneutem Klick auf den Button wieder schließen, um die Änderungen in das Serendipity-Fenster zu übernehmen. ? öffnet eine kleine Informationsseite von CKEditor. Im Textbereich können Sie wie gewohnt Text eintippen. Wenn Sie die (Enter)-Taste drücken, wird ein neuer Absatz begonnen, wenn Sie (Shift)+(Enter) drücken, wird ein einfacher Zeilenumbruch eingefügt. Fehler!doppelte Zeilenumbrüche Fehler!Leerzeilen vor/nach Tabellen Eintrags Markup Fehler Beachten Sie, dass Sie bei aktiviertem WYSIWYG-Editor das Textformatierungs-Plugin Textformatierung: NL2BR (siehe Seite nl2br) besser deinstallieren sollten. Andernfalls könnte es zu doppelten Zeilenumbrüchen kommen oder bei Tabellen zu überflüssigen Zeilenumbrüchen vor/nach der Tabelle. Alternativ können Sie das NL2BR-Plugin auch gezielt nur für einzelne Artikel deaktivieren, indem Sie es mithilfe des Plugins Erweiterte Eigenschaften von Artikeln (siehe Seite entryproperties) in den Erweiterten Optionen des jeweiligen Artikels aus der Liste auswählen. Ab Serendipity 2.0 sorgt das mitgelieferte entryproperties-Plugin aber automatisch dafür, dass die Nutzung des WYSIYWG Editors selbstständig erkannt und die Nutzung von NL2BR per Eintrag ausgeschaltet wird.

Eintrag!Kommentar-Optionen Kommentarmoderation Kommentar-Optionen Unterhalb des Eingabebereichs für den Text, im Klappmenu: Eintrags Metadaten, gibt es ein Kommentar Optionsfeld mit zwei Optionen, mit denen man steuern kann, ob Kommentare zu diesem Artikel zugelassen sind, und wenn ja, ob diese Kommentare nach dem Abschicken durch den Besucher erst von einem Redakteur freigeschaltet werden müssen. Die Voreinstellung dieser beiden Optionen wird in den Eigenen Einstellungen vorgenommen.

Eintrag!Aktionen Eintrag!Vorschau Aktionen Rechts oben in der ersten Zeile des Eintragsformulares befinden sich außerdem zwei Aktions-Buttons. Der Button Vorschau lädt die Seite neu und zeigt oberhalb der Erfassungsmaske eine Voransicht des gerade erstellten Artikels an. Die Voransicht ist nur eine vage Annäherung, wie der Artikel später im Blog aussehen wird, kann aber dennoch als grobe Richtlinie dienen, um dessen Formatierung zu prüfen. Mittels des Buttons Speichern wird ein Artikel im System gespeichert. Sollte vor einem Klick auf diesen Button der Computer abstürzen, sind die Einträge unwiderruflich verloren. Daher empfiehlt es sich sehr, einen längeren Artikel erst in den Entwurfs-Modus zu setzen und zwischendurch häufiger zu speichern, oder alternativ den Text in einem normalen Schreibprogramm vorzutippen. Was beim Speichern eines Artikels geschieht, erfahren Sie auf Seite Eintrag-speichern.

erweiterter-eintrag Eintrag!Erweiterter Eintrag Teaser Erweiterter Eintrag Der Artikeltext, den Sie im Bereich Eintrag verfasst haben, wird später im Frontend vollständig auf den Übersichtsseiten angezeigt. Dieser Text stellt somit einen Teaser [*] Ein Teaser ist ein Kurztext, der dem Leser einen Vorgeschmack auf die ausführliche Fassung geben soll. dar. Der vollständige Text eines Artikels kann im Bereich Erweiterter Eintrag verfasst werden. Der hier eingegebene Text wird später im Frontend erst auf der Detailseite eines Artikels angezeigt und ist auch standardmäßig nicht im RSS-Feed enthalten. Bei der Ansicht der Detailseite eines Artikels wird der normale Artikeltext zusätzlich angezeigt. Verfassen Sie daher Ihre Beiträge so, dass die beiden Textbereiche ineinander übergehen. Der Bereich Erweiterter Eintrag ist identisch formatiert wie der normale Eintrag. Sie können diesen erweiterten Bereich mittels des Ausklappmenus ein- und ausklappen.

Erweiterte Optionen Eintrag!Erweiterte Optionen Erweiterte Optionen Unterhalb des erweiterten Eintrags und des Ausklappmenus Eintrags Metadaten, befindet sich ein Block mit dem Titel Erweiterte Optionen. Hier werden diverse Optionen von eingebundenen Plugins angezeigt, und auch eigene Plugins können an dieser Stelle eingebunden werden. Die angebotenen Optionen an dieser Stelle können Sie der jeweiligen Erklärung der Plugins in den folgenden Kapiteln entnehmen.

Mediathek!Popup Eintrag!Mediathek-Popup Mediathek-Popup Mediathek-Popup Das Mediathek-Popup ist ein Fenster, das sich an mehreren Stellen von Serendipity öffnen lässt, vor allem beim Einfügen von Bildern bei der Artikel-Erstellung. Abbildung 4.5a: Mediathek-Popup zum Einfügen einer Datei im Dark Mode Das Popup-Fenster enthält eine vereinfachte Ansicht der Mediathek Serendipitys. Abhängig von der Option Symbolleiste für das Mediathek-Popup anzeigen in den Eigenen Einstellungen wird Ihnen jedoch zusätzliche Funktionalität angeboten, die im Kapitel Mediathek auf Seite Mediathek detailliert beschrieben wird. Solange das Popup-Fenster geöffnet ist, sollten Sie im Ursprungsfenster von Serendipity keine Änderungen vornehmen. Sollten Sie dies tun, kann das Popup-Fenster ein ausgewähltes Bild nicht mehr an den ursprünglich vorgesehenen Platz stellen. Standardmäßig sehen Sie die Bilder aller Verzeichnisse in chronologischer Reihenfolge, also unabhängig von einem gewählten Verzeichnis. In dieser Dateiübersicht sehen Sie jeweils Vorschaubilder für alle hochgeladenen Dateien. Auch können dort Nicht-Bilddateien (Word-Dokumente, PDF-Dateien, ZIP-Archive ...) angezeigt werden. Wenn Sie eine bestimmte Datei suchen, werden Ihnen die Filteroptionen der Mediathek sehr hilfreich sein. Diese sind ebenfalls detailliert im Kapitel Mediathek ab Seite Mediathek Filter beschrieben. Da wir das Popup-Fenster nur aufgerufen haben, um ein Bild auszuwählen, dient die Dateiübersicht der einfachen Auswahl jenes Bildes. Ein Klick auf eines der Vorschaubilder führt zu einer Folgeseite, in der Sie bestimmen können, wie das Bild eingefügt werden soll. Abhängig vom Kontext, in dem Sie das Popup-Fenster aufgerufen haben, kann es sein, dass die Folgeseite nicht erscheint, sondern das Objekt direkt in die aufrufende Seite eingetragen wird. Auch wenn Sie eine einfache Datei anstelle eines Bildes einfügen wollen, wird die Folgeseite nicht erscheinen, sondern die Datei wird direkt in den Artikel eingebunden. Formatierung!Bilder Abbildung 4.5b: Mediathek-Popup zur Formatierung einer eingefügten Datei im Dark Mode Auf dieser Folgeseite sehen Sie im oberen Bereich, für welche Datei Sie sich entschieden haben. Die kleine Vorschaugrafik wird ebenfalls dargestellt. Es folgen nun einige Bereiche, in denen Sie das Layout des eingefügten Bildes bestimmen: Bei dem Bereich der Bildgröße legen Sie fest, ob nur das kleine Vorschaubild eingefügt werden soll oder das Bild in seiner Originalgröße. Über die Bildausrichtung bestimmen Sie, wie das Bild im Text des Artikels arrangiert wird. Dabei wird das Layout durch eine kleine Grafik visuell dargestellt. Die erste Option richtet ein Bild oberhalb eines Absatzes, also für sich allein stehend aus. Die zweite Möglichkeit bettet ein Bild so ein, dass es vom folgenden Text linksbündig umflossen wird. Die letzte Möglichkeit bindet ein Bild so ein, dass es innerhalb des Textes rechtsbündig dargestellt wird. Im Abschnitt Bild als Link können Sie zusätzlich einen Link auf ein Bild legen. Bei einem Klick auf ein Bild wird dann die eingetragene URL aufgerufen. Standardmäßig wird der Dateipfad zu der großen Version eines Bildes in dem Eingabefeld Das Bild soll hierhin linken: eingefügt. Über die Option Ziel dieses Links kann man einstellen, wie dieser Link im Browser geöffnet wird. Popup-Fenster (JavaScript) wird das Bild in einem Fenster öffnen, das sich der Bildgröße genau anpasst. Eigenständige Seite wird eine spezielle Frontend-Seite öffnen, die ausschließlich Ihr Bild im umgebenden Layout und mögliche Meta-Daten eines Bildes anzeigt. Die Option Popup-Fenster (target=_blank) nutzt eine einfachere Version eines Popup-Fensters, die auch ohne aktiviertes JavaScript des Besuchers ein neues Fenster öffnen kann. Zuletzt haben Sie noch die Möglichkeit, zu einem Bild eine Bildunterschrift in das Feld Kommentar hinzuzufügen. Dieses wird dann im Artikel später dem Bild zugehörig angezeigt. Abbildung 4.6: Mediathek-Popup zum Einfügen einer Galerie im Dark Mode Die hier gezeigte Abbildung 4.6 zeigt das Popup-Fenster das mit dem Styx Galerie Button geöffnet wird. Wie Sie sehen, sieht das ähnlich zum normalen Fenster aus, mit dem Unterschied, dass sie verkleinerte Bild-Vorschauen eines Ordners, je nach Einstellung und Auswahl der Anzeige von Dateien aus Unterverzeichnissen in der Sortierung, angezeigt bekommen. Die strikte Sortierung auf eine Ordnerebene ist hier anzuraten (und ist deshalb im Galeriefall strikte und gesetzte Voraussetzung), da aus Performancegründen nur eine bestimmte Anzahl von 48 Elementen angezeigt werden. Die Auszeichnung der Seite und Markup Elemente für Bildkommentare etc. bleibt wie gehabt. Sie können allerdings keine bestehenden Galerie-Selektierungen erweitern, so dass Sie im Falle des Falles im Quellcode die alte Selektierung löschen müssen, um dann eine neue mit der gewünschten Vervollständigung vornehmen zu können. Wie Sie sich vorstellen können, ist es also ratsam eine saubere Ordner- und Dateistruktur in der Mediathek angelegt zu haben. Serendipity Styx hat besonderen Wert darauf gelegt, die Möglichkeiten einen tiefen Dateistruktur und ihrer Medien-Administrations-Aufgaben, wie Verschieben, Umbenennen, Ändern in Einträgen, etc zu verbessern, auszuarbeiten und vorhandene Bugs auszumerzen. Wenn Sie abschließend auf Fertig klicken, wird das Bild, bzw. die Galerie an die aufrufende Stelle (textarea) von Serendipity zurückgeliefert und mittels HTML-Code eingebunden. Dort können Sie es gegebenenfalls auch noch innerhalb des Eintrages verschieben und anpassen. Fehler!Einfügen von Bildern Sämtliche Einfügeoperationen des Mediathek-Popups benötigen JavaScript. Sollte das Einfügen bei Ihnen also fehlschlagen, prüfen Sie, ob Sie JavaScript im Browser korrekt aktiviert haben. Auch mögliche Popup-Blocker oder die Firefox-Erweiterung NoScript könnten den erfolgreichen Aufruf der Mediathek verhindern. Wenn Sie gerne ein Bild einfügen möchten, das Sie noch nicht in die Mediathek hochgeladen haben, dann müssen Sie dafür nicht extra auf den Menüpunkt Medien hinzufügen im Hauptmenü klicken. Stattdessen ermöglicht es das Mediathek-Popup in der Bildübersicht, direkt, mittels Klick auf den Button Medien hinzufügen eine neue Datei von Ihrem Computer hochzuladen. Diese Datei wird dann direkt für die Folgeseite zur Bestimmung der Einfügungsoptionen übernommen, was Ihnen einiges an Klickarbeit abnimmt. Details zum Hochladen von Dateien finden Sie im Kapitel Medien hinzufuegen auf Seite Medien hinzufügen, die auch für das Mediathek-Popup gelten.

Eintrag!speichern Eintrag-speichern Speichern eines Eintrags picture-container medien-speichern Je nachdem, ob Sie nun ein einzelnes Bild mit fest definiertem Format als einfaches <img...> in ihren Blogeintrag einfügen wollen, oder ob dies über das fortschrittlichere <picture...> container HTML Format erfolgen soll, müssen Sie nun selbst im Speichern Dialog entscheiden. Im Kapitel Mediathek auf Seite 4.5 - Mediathek, lernen Sie was Letzteres vom Ersten unterscheidet. Um es kurz zu machen, schicken Sie mit dem container Format mehrere Bilder zur Auswahl an denjenigen Browser, der es später auf Besucherseite laden und darstellen soll. Dieser wird immer das kleinste Format wählen, das die <source... srcset...> Zeilen bereitstellen und damit die Ladezeit ihres Blogs erheblich beschleunigen. Je weniger groß (MB / KB) eine zu ladende Datei ist, desto schneller wird sie natürlich auch übertragen. Ihre Besucher (ebenso wie Suchmaschinen) werden es Ihnen danken! Abbildung 4.5c: Mediathek-Popup zum Einfügen von Bildern als <img...> oder über <picture...> container HTML tags Woher kommen aber nun diese unterschiedlichen Größen und Formate? Sie werden beim upload der Bilder automatisch vom System erzeugt und in relativen Unterverzeichnissen ".v/" des aktuellen Bildes in der Mediathek "versteckt" gespeichert. Dies sind WebP (webp) Format Dateien und die brandneuen AV Image File (avif) Dateien, wenn Sie Letztere über die Image Konfiguration selbst zur Nutzung erlaubt haben. Solche Dateien sind also nur als "interne Erweiterung" der Mediathek zu verstehen. Sie selbst, als Backenduser, greifen nur indirekt auf diese zu, obwohl sie, soweit vorhanden, überall wo ein Bild der Mediathek [*] Auch die Template(s) Vorschau Bilder gehorchen bereits diesem neuen Prinzip. im Backend angezeigt wird, wie auch der Mediathek selbst, auch schon eifrig benutzt werden. Dies geschieht über die genannten <picture...> container, so dass auch das Backend schon sehr eindeutig vom schnelleren Ladeverhalten durch dieses HTML Container Format profitiert. Das Kapitel Mediathek auf Seite 4.5 - Mediathek und folgend, bringt Sie diesbezüglich auf den letzten Stand. Wenn Sie einen Beitrag speichern, wird Serendipity in einem eigenen Bereich einige Aktionen durchführen. Zuerst wird der Artikel vollständig in der Datenbank gespeichert. Danach können etwaige Plugins ausgeführt werden, die individuelle Funktionen auf den Artikel anwenden und ihn umwandeln. So könnte ein Plugin zB. den neuen Artikel an Google und andere Suchmaschinen wie Technorati übermitteln, oder der Text könnte auf korrekte Syntax geprüft werden. Trackbacks Sollte der Artikel als Veröffentlichung gespeichert sein, wird in einem weiteren Schritt der Artikeltext automatisch nach allen enthaltenen Hyperlinks durchsucht. Jeder gefundene Hyperlink wird daraufhin von Serendipity aufgerufen und geprüft, ob ein Trackback (siehe Seite trackback) an diese Adresse gesendet werden soll. Für jede gefundene URL wird auf dem Bildschirm eine Nachricht ausgegeben, ob ein Trackback an diese URL geschickt werden konnte. Auch etwaige Fehlermeldungen werden Ihnen beim Speichern an dieser Stelle angezeigt. Der Prozess endet mit einer Meldung Serendipitys, dass der Eintrag gespeichert wurde. Falls der Artikel direkt veröffentlicht wurde, können Sie die URL mit diesem Artikel direkt anklicken. Wenn Serendipity lediglich den Entwurf eines Beitrags gespeichert hat, wird keine Trackback-Analyse durchgeführt, und Serendipity meldet nach dem Speichern, dass der Entwurf eines Artikels gespeichert wurde. Fehler!beim Speichern von Einträgen Sollten Sie nach dem Speichern eines Artikels keine solche Meldung erhalten, bedeutet dies möglicherweise, dass der Webserver Fehler verursacht hat. In diesem Fall sollten Sie die Fehler-Logfiles des Servers prüfen, da hierfür meist Netzwerk-Verbindungsprobleme oder Firewalls zuständig sind. In so einem Fall müssten Sie möglicherweise die Trackback-Funktionalität deaktivieren (siehe Seite commentphp). Um vorab Probleme mit verlorenen Artikeltexten zu vermeiden, können Sie die auf Seite automatic-backup beschriebenen Maßnahmen einsetzen. Nach dem Speichern landen Sie erneut auf der Seite zur Bearbeitung des Artikels, um gegebenenfalls Änderungen vorzunehmen und den Artikel erneut zu speichern.

Einträge bearbeiten

Einträge bearbeiten Backend!Einträge!bearbeiten Eintrag!Bearbeiten

Um einen geschriebenen Beitrag später zu bearbeiten, benutzen Sie den Hauptmenüpunkt Einträge bearbeiten. Bei einem Klick auf diesen Menüpunkt wird eine blätterbare Liste aller geschriebenen Einträge dargestellt.

Bei einem Klick auf den jeweiligen Eintrag gelangt man auf die Seite, in der man einen Neuen Eintrag erstellen kann. Die Felder sind dabei vorausgefüllt mit den jeweiligen Daten des gewählten Eintrags, und ein Speichern erstellt keinen neuen Eintrag, sondern überarbeitet den bestehenden.

ID eines Artikels Artikel-ID Die Liste der Einträge stellt in der ersten Zeile den Titel des Artikels dar. Sollte der Artikel noch nicht veröffentlicht worden sein, wird das Wort Entwurf im Listeneintrag grau hinterlegt auf der rechten Seite eingeblendet. Wenn Sie mit der Maus über einen Beitragstitel fahren, wird ein Info-Popup angezeigt, in dem die Artikel-ID angezeigt wird. Diese ID kann an einigen Stellen des Serendipity-Backends eingetragen werden, unter anderem über den Stift-Button unter dem Titel dieser Seitenliste zum schnellen Bearbeiten einer bekannten Artikelnummer oder zur Erstellung eines neuen Artikels.

Unterhalb des Titels wird die Erstellungszeit des Artikels angezeigt. Wenn rechts daneben das Uhrsymbol steht, heißt dies, dass der Artikel seit seiner Erstellung mindestens einmal überarbeitet wurde. Wenn Sie mit der Maus über dieses Icon fahren (oder klicken), zeigt ein Info-Popup den Zeitpunkt der letzten Aktualisierung an.

In dieser Zeile unterhalb des Titels wird auch angegeben, wer der Eigentümer eines Artikels ist. Bei Bearbeitung eines Artikels durch andere Redakteure ändert sich der Eigentümer nicht. Sollte ein Artikel in einer oder mehreren Kategorien zugeordnet sein, werden alle Kategorienamen nach dem Autornamen aufgelistet. Ein Klick auf den Kategorienamen ruft die Frontend-Ansicht der jeweiligen Kategorie auf.

Innerhalb der Box, die den Artikel anzeigt, werden auf der rechten Seite drei Buttons dargestellt. Der erste Button mit einer Lupe-Symbol zeigt bei einem Klick abhängig vom Veröffentlichungsstatus entweder die Ansicht oder Vorschau des Artikels im Frontend in einem neuen Fenster an. Der zweite Button stellt mit dem Stift-Symbol die Möglichkeit bereit, einen Artikel zu bearbeiten (wie bei einem Klick auf den Artikeltitel). Eintrag!löschen Der Button mit Mülleimer-Symbol löscht einen Artikel unwiderruflich. Zur Sicherheit werden Sie beim Löschen gefragt, ob Sie die Aktion wirklich ausführen wollen.

Als Letztes wird eine Auswahlbox neben dem Löschen-Button angezeigt. Hier können Sie mehrere Artikel auswählen, um anschließend am Seitenende durch den Klick auf Markierte Einträge löschen diese Artikel gesammelt zu löschen.

Auswahl umkehren Der Button Auswahl umkehren wird jeden gewählten Artikel deselektieren und jeden deselektierten Artikel wieder auswählen. Wenn Sie also einmal alle Artikel bis auf einen löschen wollen, markieren Sie nur diesen einen Artikel, klicken auf Auswahl umkehren, wodurch automatisch die anderen Artikel ausgewählt werden, und können danach löschen.

Artikel-ID Über den Knopf mit dem Stift-Symbol am Anfang der Seite finden Sie, wie schon erwähnt, eine Eingabebox, in der Sie die Artikel-ID eingeben können, um einen Eintrag direkt zu bearbeiten. Alle Artikel in Serendipity werden bei 1 beginnend automatisch durchnummeriert. Wenn ein Artikel einmal gelöscht werden sollte, verändert sich die ID aller anderen Artikel nicht, daher können ggf. Lücken entstehen. Sie sollten mit dem Löschen eines Artikels dennoch mit Bedacht vorgehen, denn der Sinn eines Blogsystems besteht ja darin, aktuelle Artikel zu erstellen, die mit der Zeit verdrängt und durch das Weiterrücken sozusagen archiviert werden. Es ist nicht dazu gedacht, beliebig erstellt und gelöscht zu werden, wie in einem CMS-System

Am Anfang der Seite neben dem gerade beschriebenen Button-Knopf, sehen Sie mehrere Filtermöglichkeiten, die die Anzeige der Artikel beeinflussen. Standardmäßig werden Ihnen die chronologisch aktuellsten Artikel angezeigt. Die Liste ist über die Buttons Weiter und Zurück und Anfang und Ende ober- und unterhalb der Artikel blätterbar, sobald genügend Artikel vorhanden sind.

Eintrag!filtern Eintrag!suchen Folgende Filteroptionen sind verfügbar:

Autor Das Auswahlfeld neben der Option Autor schränkt die Darstellung der Artikel auf den ausgewählten Autor ein.

Artikelmodus Unterhalb des Autors gibt es ein weiteres Auswahlfeld, mit dem Sie auswählen können, ob nur Entwürfe, Veröffentlichungen oder beide Artikelarten angezeigt werden sollen.

Kategorie Um nur Artikel einer gewissen Kategorie anzuzeigen, können Sie im Auswahlfeld Kategorie die gewünschte Auswahl treffen.

Inhalt In das Feld Inhalt können Sie ein beliebiges Suchwort eingeben, das in einem Artikeltext (oder dem erweiterten Artikeltext) vorhanden sein muss. Die Suche berücksichtigt dabei auch Teilworte und ignoriert die Klein- und Großschreibung, wenn Sie also miet eingeben, werden auch Artikel angezeigt, die vermieten oder Mietbüro enthalten.

Sortieren nach Die Sortierung der gefilterten Artikel bestimmen Sie durch das Auswahlfeld Sortieren nach. Folgende Sortierungsmöglichkeiten stehen zur Verfügung: Datum, Veröffentlichung/Entwurf, Autor (Autorname, alphabetisch), Kategorie (Kategoriename, alphabetisch), Zuletzt aktualisiert, Titel (Artikeltitel, alphabetisch) und die ID eines Artikels.

Sortierung Die Rangfolge der Sortierung (Absteigend oder Aufsteigend) können Sie durch das Auswahlfeld Sortierung einstellen. Dadurch bestimmen Sie, ob die Liste vom aktuellsten/ersten Eintrag bis zum ältesten/letzten Eintrag sortiert wird oder umgekehrt.

Artikel pro Seite Standardmäßig enthält die Übersicht die letzten 12 Artikel. Um eine größere Übersicht zu ermöglichen, können Sie die Artikel pro Seite auf die Werte 12, 16, 15, 50 oder 100 stellen. Beim Blättern wird die jeweilige Folgeseite ebenso viele Artikel darstellen.

Ein Klick auf Los! führt die gewünschte Filterung aus und zeigt die daraus resultierende Artikelauswahl in der eingetragenen Sortierung. Bei Angabe mehrerer Filterkriterien werden diese alle miteinander UND-verkettet, d.h. es müssen alle Filterbedingungen zutreffen, damit ein Artikel in der folgenden Liste aufgeführt wird.

Die zuletzt eingestellten Filter- und Sortierungsoptionen werden in einem Cookie gespeichert und beim nächsten Aufruf des Menüs erneut angewendet. Wenn Sie also einmal eine chronologische Auswahl erwarten würden, prüfen Sie zuerst, ob die Filtereinstellungen dies verhindern.

Der Filter-Reset-Button setzt getroffene Filter auf die Default-Einstellung zurück.

Kategorien

Kategorien Kategorien|see{Backend, Kategorien} Backend!Kategorien

Im Bereich Kategorien können die für Artikel gültigen Kategorien erstellt und verändert werden.

Auf der Übersichtsseite sieht man die Auflistung aller verfügbaren Kategorien in ihrer hierarchischen Ordnung. Für jede Kategorie gibt es eine einzelne Zeile, und Kategorien können unendlich tief ineinander verschachtelt werden, um Unterkategorien zu ermöglichen.

Pro Zeile gibt es die bekannten zwei Buttons zum Bearbeiten und Löschen einer Kategorie. In ihrer Mitte befindet sich ein Plus-Symbol für die Erstellung einer Unterkategorie der jeweiligen Kategorie. Unter dem Namen einer Kategorie liegen, versteckt in einer Klappbox, die über das kleine rechtsweisende Dreiecks-Symbol aktiviert wird, weitere Angaben zur Beschreibung einer Kategorie, und abschließend den Namen des Eigentümers einer Kategorie.

Der Eigentümer einer Kategorie bestimmt im späteren Verlauf, welche Redakteure Artikel für diese Kategorie erstellen dürfen. Gewähren gewisse Rechtekonstellationen (siehe Kapitel Gruppenverwaltung auf Seite Gruppenverwaltung) keinen Zugriff, wird die Kategorie auf dieser Übersichtsseite für unbefugte Redakteure nicht angezeigt und ist auch beim Erstellen eines Beitrags nicht auswählbar. Wenn an der Stelle des Eigentümers Alle Autoren steht, bedeutet dies, dass die Kategorie keinen speziellen Eigentümer besitzt, sondern für alle Redakteure zur Verfügung steht.

Am Ende der Seite führt der Button Neue Kategorie zu der Erstellungsmaske für eine neue Kategorie.

Sowohl der Klick auf Neue Kategorie als auch das Bearbeiten einer Kategorie führen zu derselben Maske. Dort können folgende Daten erfasst werden:

Kategorien!Name Name Der Name einer Kategorie wird in das Feld Name eingetragen; sie wird später im Frontend jeweils mit diesem Namen dargestellt. Sonderzeichen und Leerzeichen sind erlaubt. Die Zeichenlänge ist grundsätzlich unbeschränkt, aber sehr lange Kategorienamen könnten zu problematischen Zeilenumbrüchen in Auswahlboxen führen.

Kategorien!Beschreibung Beschreibung Die Beschreibung einer Kategorie wird an einigen Stellen im Backend und als Meta-Beschreibung zur Kategorie im Frontend angezeigt. Hier können Sie auch längere Beschreibungen eintragen.

Kategorien!Bild Bild Wenn Sie einen Artikel in einer Kategorie veröffentlichen, können Sie ein Bild mit dieser Kategorie verbinden. Dieses Bild wird dann bei der Darstellung eines Artikels im Frontend im Inhaltsbereich ausgegeben und ermöglicht den Besuchern eine einfache Assoziation des Textes mit einem Thema. Über den Button Bild können Sie das Mediathek-Popup (siehe Seite Mediathek-Popup) aufrufen und die gewünschte Bilddatei einfügen. Alternativ tragen Sie in das Eingabefeld Bild eine vollständige URL mit dem Bildziel ein.

kategorie-leserechte Kategorien!Leserechte Zugriffsrechte Lesebeschränkung Leserechte Wenn Sie einen Artikel in einer Kategorie verfassen, kann es sein, dass nicht jeder Besucher der Webseite Einträge aus dieser Kategorie lesen soll. Über das Auswahlfeld Leserechte können Sie diejenigen Benutzergruppen wählen, die später im Frontend die Befugnis haben, einen Artikel zu lesen. Mehrere Gruppen können mit gedrückter (Strg/Apfel)-Taste und einem Mausklick gewählt werden. Die Sondergruppe Alle Autoren wird benutzt, wenn eine Kategorie von jedem Besucher (also nicht eingetragenen Redakteuren) aufgesucht werden darf. Sobald eine Einschränkung auf eine Benutzergruppe eingerichtet wurde, muss ein Redakteur dieser Gruppe(n) sich erst ins Backend eingeloggt haben, bevor er im Frontend die Artikel lesen kann. Alle derart geschützten Artikel sind auch im normalen RSS-Feed nicht mehr vorhanden. Die Option der Einschränkung von Leserechten kann durch die globale Serendipity-Konfigurationsoption Leserechte auf Kategorien anwenden (siehe Kapitel Konfiguration, Seite Konfiguration) ausgehebelt werden. Um im Seitenleisten-Plugin Kategorien (Seite categoriesplugin) ebenfalls nur die Kategorien anzuzeigen, für die man Leserechte besitzt, muss in der Konfiguration dieses Plugins die Option Quelle der Kategorien auf Derzeitiger Autor eingestellt werden.

Kategorien!Schreibrechte Schreibrechte Analog zu den Leserechten können bei Serendipity die Schreibrechte einer Kategorie vergeben werden. Nur die ausgewählten Benutzergruppen werden später die Möglichkeit haben, einen Artikel für diese Kategorie zu schreiben. Sobald eine Einschränkung des Schreibrechts auf mindestens eine Benutzergruppe vorgenommen wird, wird für die Kategorie der aktuelle Redakteur als Eigentümer der Kategorie vermerkt und in der Kategorieübersicht dargestellt. Die spezielle Option Alle Autoren bedeutet, dass der Schreibzugriff auf die Kategorie nicht eingeschränkt ist.

Kategorien!übergeordnetekategorien@übergeordnete Kategorie Übergeordnete Kategorie Kategorien können beliebig verschachtelt werden. Um eine Kategorie einer Oberkategorie zuzuordnen, muss diese Kategorie im Auswahlfeld Übergeordnete Kategorie ausgewählt werden. In diesem Auswahlfeld sind alle bisher angelegten Kategorien hierarchisch (durch Leerzeichen eingerückt) dargestellt. Beim Bearbeiten einer Kategorie kann diese somit leicht (mitsamt allen untergeordneten Kategorien) an einen anderen Punkt des Kategoriebaums eingehängt werden.

Kategorien!Artikel von Unterkategorien verstecken Fehler!Artikel aus Unterkategorien nicht angezeigt Artikel von Unterkategorien verstecken? Wenn Sie im Frontend eine Kategorie zur Ansicht ausgewählt haben, werden standardmäßig alle Einträge dieser Kategorie und auch alle Einträge in den zugehörigen Unterkategorien dargestellt. Dies ermöglicht dem Besucher, dass er bei der Auswahl von Oberkategorien nicht jede Unterkategorie einzeln anklicken muss. Wenn Serendipity jedoch eher als Content-Management-System eingesetzt wird, ist dieses Verhalten recht untypisch und häufig nicht gewünscht. Daher können Sie für jede Oberkategorie die Option Artikel von Unterkategorien verstecken aktivieren. Daraufhin werden bei Auswahl einer derart konfigurierten Kategorie im Frontend ausschließlich die Artikel angezeigt, die auch in exakt dieser Kategorie eingetragen wurden.

Kategorien!Plugins!Weitere Kategorie Felder Weitere Kategorie Felder Plugins, wie zB. das Statische Seiten-Plugin, können über einen Hook ("eine Art Sprungmarker", siehe Ereignis-Hooks) hier weitere Felder, wie eine "Zugeordnete statische Seite", einfügen.

Ein Klick auf Erstellen (für neue Kategorien) bzw. Speichern schließt die Erstellungs-/Bearbeitungsmaske und speichert die Änderungen.

Wenn Sie eine Kategorie löschen möchten, wird Serendipity Sie fragen, was mit Einträgen geschehen soll, die dieser Kategorie bisher zugeordnet waren. Mittels eines Auswahlfeldes können Sie festlegen, ob diese Einträge stattdessen einer anderen bestehenden Kategorie zugeordnet werden sollen. Ohne eine Neuzuordnung werden Artikel nicht gelöscht, sondern sind dann einfach keiner Kategorie mehr zugeordnet.

KategorieID@Kategorie-ID ermitteln Kategorie-ID ermitteln Einige Plugins benötigen zur Konfiguration die Kategorie-ID. Eine ID identifiziert eine Kategorie eindeutig und bleibt auch gleich, wenn Sie eine Kategorie einmal umbenennen. Diese ID wird üblicherweise weder im Frontend noch im Backend wirklich deutlich angezeigt; sie ist jedoch meist Bestandteil der URL (zB. /categories/17-Generelles).

Um die ID ohne Nachschlagen in der Datenbank oder Durchsuchen des HTML-Quellcodes zu ermitteln, können Sie in der Kategorie-Übersicht im Backend-Bereich Kategorien mit der Maus über das Stift-Symbol fahren. Wenn Sie dann kurz warten, wird Ihr Browser unterhalb der Mausposition ein kleines Fenster anzeigen, in dem die ID der Kategorie steht.

Medien hinzufügen

Um Ihre Mediathek mit Daten zu füllen, müssen Sie die Dateien in dieser Datenbank anmelden. Um eine Datei komfortabel über die Oberfläche hochladen zu können, gibt es den Menüpunkt Medien hinzufügen.

Auf dieser Seite können Sie zwischen zwei Varianten wählen, von welcher Quelle eine Datei eingestellt werden soll.

Die erste Variante ist der Download einer Datei, die bereits im Internet unter einer URL verfügbar ist. Wenn Sie also auf einer Webseite eine Bilddatei sehen, können Sie über Ihren Browser (meist mittels eines Rechtsklicks auf die Grafik) die URL dieses Bildes heraussuchen und in das Feld URL zum Download angeben eintragen.

Urheberrecht Achten Sie bitte beim Download einer Grafikdatei aus dem Internet immer darauf, dass die Bilder/Dateien urheberrechtlich geschützt sein könnten und die Einbindung einer solchen Datei in Ihrem Blog rechtlich nicht erlaubt ist. Stellen Sie daher immer sicher, dass Sie das Recht haben, eine Datei zu vervielfältigen.

Hotlink Hotlink Unterhalb der Eingabebox zum Download einer Datei aus dem Internet befindet sich das Auswahlfeld Download-Methode. Wenn Sie hier Bild auf diesem Server speichern auswählen, bedeutet das, dass die Daten der eingetragenen URL heruntergeladen und auf dem eigenen Webserver gespeichert werden. Wenn Sie ein solches Bild später einbinden, wird es von den Besuchern von Ihrem eigenen Webserver heruntergeladen und verursacht auf Ihrem Webserver Kosten für den aufgekommenen Traffic (Datenverkehr). Die zweite Möglichkeit stellt die Option Nur zum Quellserver linken dar. Ist diese Option gewählt, wird die von Ihnen eingetragene Datei nicht wirklich heruntergeladen, sondern nur ein Verweis auf den Zielserver gespeichert. Wenn Sie eine derartige Datei später einbinden, werden die Daten dann vom fremden Webserver geladen -- dies nennt man hotlinking. Dies hat den Vorteil, dass auf Ihrer eigenen Seite kein erhöhter Datenverkehr entsteht und dass, formaljuristisch gesehen, die Einbindung solcher Bilder urheberrechtlich unterschiedlich gehandhabt wird, da Sie das Bild nicht eigenständig anbieten.[*] Diesen Hinweis genießen Sie bitte mit Vorsicht. Im Zweifelsfall sollten Sie den Eigentümer einer Datei immer um Erlaubnis bitten oder mit der Hilfe eines Fachanwalts den Sachverhalt klären. Der Nachteil einer solchen Einbindung ist jedoch, dass, wenn einmal der verwiesene Server nicht mehr betrieben oder die Datei entfernt wird, ein solches Bild natürlich auch in Ihrem Artikel nicht mehr angezeigt werden kann.

Als zweite Variante zum Hinzufügen einer Datei können Sie diese von Ihrer eigenen Festplatte auswählen. Wenn Sie auf den Button Durchsuchen neben der Eingabebox Datei zum Hochladen angeben klicken, öffnet sich ein Dateiauswahldialog Ihres Betriebssystems, und Sie können eine Datei aus Ihrer Verzeichnisstruktur auswählen.

Sie können immer nur eine dieser beiden Varianten des Hinzufügens wählen. Entweder Sie laden eine Datei aus dem Internet, oder Sie laden sie vom eigenen Computer. Wenn Sie beide Eingabefelder ausfüllen, wird nur die Datei aus dem Internet geladen und die selbst hochgeladene Datei ignoriert. Wenn Sie also sowohl eine Datei aus dem Internet als auch eine vom eigenen Computer hochladen wollen, müssen Sie dies nacheinander tun.

Wenn Sie eine Datei von der eigenen Festplatte hochladen, können Sie noch weitere Details bestimmen. Im Eingabefeld Datei speichern mit dem Namen können Sie einen Dateinamen für die hochgeladene Datei vergeben. Standardmäßig wird hier der Originalname der Datei von Ihrer Festplatte eingetragen. Im Feld In diesem Verzeichnis ablegen können Sie das Unterverzeichnis auswählen, in dem die Datei später gespeichert wird. Unterverzeichnisse werden über den Mediathek-Menüpunkt Verzeichnisse verwalten (siehe Kapitel Verzeichnisse verwalten auf Seite Verzeichnisse verwalten) erstellt.

Wenn Sie mehr als eine Datei hochladen möchten, können Sie auf den Button Mehr Bilder hinzufügen klicken. Jeder Klick auf diesen Button stellt ein zusätzliches Eingabefeld für eine auszuwählende Datei zur Verfügung, und in jedem dieser Blöcke können Sie danach auch den Dateinamen und das Zielverzeichnis bestimmen.[*] Diese Funktion benötigt aktiviertes JavaScript und wird von allen gängigen Browsern unterstützt. Beachten Sie bitte, dass Sie nicht zu viele Dateien in einem Schritt hochladen sollten. Je nach Einstellung des Webservers (siehe Kapitel file-uploads auf Seite file-uploads) dürfen Sie ein gewisses Limit (meist 4MB) nicht überschreiten.

Inzwischen gibt es aber die Möglichkeit beim Durchsuchen gleich mehrere Bilder “In-Once” zugleich emporzuladen, die, durch ein kleines Javascript Programm gesteuert, automatisch abgearbeitet werden. Im Zuge der in Kapitel 5.0 erklärten Veränderungen (siehe oben) mit den AVIF Variation Dateien und der mitunter erheblich Kodierungszeit, sollten sie von mehrfachen Uploads vorerst absehen, wenn Sie dies Feature nutzen, auch wenn das hier genannte Javascript nur eines zur Zeit bearbeitet.

Nachdem Sie also die Dateien ausgewählt haben, haben Sie zwei Möglichkeiten der Speicherung. Ein Klick auf Los! speichert die Datei und erstellt ggf. automatisch kleine Voransichten. Wenn Sie jedoch auf Los und Eigenschaften angeben klicken, werden Sie auf einer Folgeseite gebeten, zu einer Datei optionale Meta-Informationen anzugeben. Diese Meta-Informationen können Sie auch später noch nachtragen oder überarbeiten, wenn sie in der Mediathek bereits gespeichert sind.

Medien: Probleme beim Upload

Medien-Probleme beim Upload Medien!Probleme beim Upload|see{Backend, Medien: Probleme beim Upload} Backend!Medien!Probleme beim Upload Fehler!Datei-Upload

Scheitert das Speichern einer neuen Datei, liegt dies meist an falschen Zugriffsrechten (Kapitel Zugriffsrechte auf Seite Zugriffsrechte). Stellen Sie sicher, dass Ihr Webserver Schreibzugriff auf den Ordner uploads besitzt. Auch eine falsche Einstellung durch den PHP SafeMode kann Schreibprobleme verursachen.

Wenn eine Datei aufgrund der Größenbeschränkung des Webservers nicht hochgeladen werden kann, wird Serendipity darüber einen Hinweis geben.

Einige Webserver filtern zudem spezielle Dateien, um Sicherheitsprobleme zu verhindern. Wenn Sie also merkwürdige Fehlermeldungen erhalten, sollten Sie Webserver-Module wie mod_security oder suhosin in Betracht ziehen und gemeinsam mit dem Serverprovider anpassen.

Beim Upload großer Dateien kann es zudem auch passieren, dass Ihre Verbindung aufgrund der großen Transferdauer entweder sehr lange dauert oder sogar abbricht. In so einem Fall sollten Sie besonders große Dateien lieber mittels FTP-Programm auf den Server laden.

Medien: Eigenschaften

Medien-Eigenschaften hinzufügen Medien!Eigenschaften hinzufügen|see{Backend, Medien: Eigenschaften hinzufügen} Backend!Medien!Eigenschaften hinzufügen

Wenn Sie beim Hochladen einer Datei auf den Button Los und Eigenschaften angeben geklickt oder innerhalb der Mediathek-Übersicht auf das Blacklist-Symbol einer Datei geklickt haben, landen Sie auf einer Seite, in der Sie die Eigenschaften einer Datei überarbeiten können.

Diese Seite stellt die betreffenden Meta-Informationen einer Datei dar. Als Erstes wird dabei entweder das Vorschaubild einer Grafikdatei oder ein Dateityp-Icon von Nicht-Grafikdateien angezeigt.

Unterhalb dieses Icons bzw Vorschaubildes sehen Sie den Namen und den Typ der gewählten Datei. Direkt darunter wird aufgeführt, wer die Datei zu welchem Datum hochgeladen hat und wie groß die Datei ist. Im Falle einer Grafikdatei wird hier zudem die Auflösung der Grafik und die Auflösung des kleineren Vorschaubildes angezeigt.

Es folgt der Block mit den Medien-Eigenschaften. Auch hier werden abhängig vom Dateityp gewisse Zusatzinformationen angezeigt. Bei Bildern wird die DPI DPI-Zahl [*] Die DPI-Zahl (Dots Per Inch) eines Bildes bestimmt, wie fein die Datei beim Ausdruck gerastert wird. Je höher die Zahl ist, desto mehr Pixel passen auf ein Inch und desto feiner wird eine Grafik dargestellt. Druckgrafiken haben meist 300 DPI und Dateien, die nicht für den Druck vorgesehen sind, 72 DPI. angegeben. Bei Video- und Audiodateien wird die Länge der Datei dargestellt. Serendipity versucht die DPI-Zahl und die Spieldauer einer Datei automatisch auszulesen, jedoch kann dies bei den vielen unterschiedlichen Dateiformaten manchmal misslingen. Daher können Sie diese Angaben auch manuell korrigieren und in die Eingabefelder eintragen.

Für alle Dateitypen werden die folgenden Felder angezeigt:

Medieneigenschaften@Medien-Eigenschaften!verknüpftes Datum Verknüpftes Datum Jede Datei kann einen Zeitstempel enthalten, wann sie erstmals gespeichert wurde. Bei Bildern, Videos oder Musikstücken entspricht dies oft dem Aufnahmedatum. Diese Information versucht Serendipity anhand der Datei automatisch zu erkennen. Sollten Sie das Datum ändern wollen, können Sie es (beliebig formatiert) hier eintragen.

Medieneigenschaften@Medien-Eigenschaften!Copyright Copyright Das Feld Copyright kann Urheberrechtsinformationen für die jeweilige Datei enthalten.

Medieneigenschaften@Medien-Eigenschaften!Titel Titel Der Titel einer Datei wird vom Redakteur manuell festgelegt.

Medieneigenschaften@Medien-Eigenschaften!Kurzer Kommentar Medieneigenschaften@Medien-Eigenschaften!Langer Kommentar Kurzer Kommentar Langer Kommentar Eine kurze sowie eine ausführliche Beschreibung einer Datei können Sie in diesen beiden Eingabefeldern eintragen.

Medieneigenschaften@Medien-Eigenschaften!Bildinhalt im ALT-Attribut Bildinhalt (im ALT-Attribut) Der HTML Markup Ersetzungstext der angezeigt wird, falls das Bild aus irgendwelchen Gründen nicht im Frontend angezeigt werden kann.

Medieneigenschaften@Medien-Eigenschaften!Verzeichnis Verzeichnis oder Bildformat Wenn eine Dateiveränderung erforderlich ist, verwenden Sie entweder die Änderung des Verzeichnisses oder die Änderung der Bildformatauswahl per Übertragung. Sie können beide nicht gleichzeitig verändern! Dies funktioniert ebenfalls nicht, wenn bereits ein Dateiname mit diesem neuen Format existiert und sollte deshalb vorher überprüft werden! Das Auswahlfeld Verzeichnis bestimmt, in welchem Verzeichnis eine Datei gespeichert wird. Wenn Sie später eine Datei verschieben wollen, können Sie das zugeordnete Verzeichnis an dieser Stelle ändern. Das Auswahlfeld Bildformat bestimmt, in welches andere Bildformat das Bild konvertiert werden soll. Medien!verschieben Bei beiden Veränderung werden die Original Datei, sowie das Vorschaubild in das gewünschte Verzeichnis auf dem Server physikalisch verschoben, oder eben konvertiert und der alte Speicherort bzw. der komplette Name existiert dann also nicht mehr. Serendipity versucht nun automatisch alle Ihre Artikel anzupassen, die das verschobene oder veränderte Bild referenziert haben. Prüfen Sie also bitte sicherheitshalber, ob alle Ihnen bekannten Verweise auf die Datei nach dem Verschieben bzw der Konvertierung noch stimmen. Generell empfiehlt es sich, nachdem Sie eine Datei bereits eingebunden haben, den Speicherort der Datei als auch ihre Extension, also das Bildformat nicht mehr zu verändern. Folgerichtig ist eine gut durchdachte Planung ihrer Mediathek, des Dateiverzeichnisses und des Bilduploads durchaus etwas Wert! Medien!konvertieren Bei dieser Konvertierung wird die Datei mit all ihren Formaten und Variationen physikalisch, als auch in der Mediendatenbank verändert. Natürlich werden entsprechende Blogeinträge auf nötige Veränderunegn untersucht. WEBP / AVIF Formatvariationen von Originaldateien existieren wahrscheinlich bereits und sind von dieser Änderung nicht betroffen.

Diese Felder können später von Redakteuren in der Mediathek eingesehen und durchsucht werden und stehen auch in speziellen Galerie-Ansichten (siehe Seite mdb-profi) für normale Besucher zur Verfügung. Sie können auch individuell weitere Meta-Informationsfelder für Dateien erfassen. Dies wird über die Option Medien-Eigenschaften in der Serendipity-Konfiguration (siehe Kapitel Konfiguration ab Seite Konfiguration) eingestellt.

Medienschluesselwoerter@Medien-Schlüsselwörter Der Abschnitt Medien-Schlüsselwörter kann für eine Datei vorher festgelegte Schlüsselwörter angeben. Die verfügbaren Schlüsselwörter werden dabei ebenfalls an zentraler Stelle der Serendipity-Konfiguration (so.) über die Option Medien-Schlüsselwörter festgelegt.

Jedes Schlüsselwort kann über die Aktivierung der links daneben stehenden Auswahlbox aktiviert werden. Schlüsselwörter machen es später leichter, eine Datei mit bestimmten Kriterien über eine Suche in der Mediathek wieder aufzufinden.

EXIF IPTC XMP Am Ende der Seite befindet sich im Abschnitt EXIF/IPTC/XMP eine von der Datei abhängige Liste an Datei-Angaben. Das EXIF-Format stellt spezielle Angaben wie das Erstellungsdatum, Angaben über die verwendete Digitalkamera, Blendenwerte, involvierte Software und Weiteres innerhalb einer Datei zur Verfügung und kann von Serendipity daher ausgelesen werden. Da diese Angaben fest in der Datei gespeichert sind, können sie von Ihnen nicht bearbeitet werden, sondern dienen nur der Information. Moderne Digitalkameras speichern diese Informationen in den erstellten Bilddateien automatisch ab.

Sollte eine Datei über die Mediathek im Frontend speziell eingebunden werden (siehe Seite mdb-by-id), können Sie in einem weiteren Abschnitt alle Verweisquellen aufgelistet sehen. Die dort aufgeführten Webseiten stellen also Internet-Seiten dar, auf denen das aktuelle Bild dargestellt wird. So können Sie leicht herausfinden, ob ein Bild überhaupt eingesetzt wird oder ob Sie es problemlos löschen/verändern können.

Mediathek: Übersicht

Backend!Mediathek

Über den Menüpunkt Mediathek wird die zentrale Übersicht aller in der Mediathek eingetragenen Dateien aufgerufen.

Diese Seite haben Sie möglicherweise auch schon im Kapitel Mediathek-Popup auf Seite Mediathek-Popup gesehen, dort jedoch noch ohne Bearbeitungsoptionen für jede Datei.

Die Übersicht besteht aus einem Kopfbereich verschiedenster Einstellungen für die Mediathek und darunter einer mehrspaltigen Ansicht aller von Ihnen hochgeladenen Dateien, oder eines einzelnen Ordners.

Die Seite stellt standardmäßig jeweils acht Dateien pro Seite dar und kann über die Buttons Weiter und Zurück (in einem Bereich vor und nach der Dateiübersicht) geblättert werden. Mit Serendipity 2.1 kamen noch Seitenanfang und Seitenende Buttons, wie auch für die Blog Eintrags Liste hinzu. Ebenfalls neu ist die Möglichkeit, analog zur bisherigen Sammel-Löschung mittels checkbox Auswahl, einer Sammel-Verschiebung von Dateien innerhalb der Mediathek über den "Bewegen" Knopf und das Verzeichnis Auswahl Feld am unteren Ende. Damit können etwas ausgeuferte Mediendatei-Sammlungen effizient in Form gebracht werden.

Ebenfalls interessant ist die buttonartige schmale Gitter Funktionsleiste in der rechten oberen Ecke (siehe Abbildung 4.x), die die Ansicht der Mediatheksdaten in ein 2-Spalten, 3-Spalten oder 4-Spalten-Layout wechselt. Durch die Ladeverhalten-Verbesserungen die mit den neuen Bildvariationen erreicht wurden, können Sie diese Spalten natürlich auch mit mehr als den standardmäßigen 8 Dateien pro Seite betreiben. Dazu wurde die Auswahl an zugleich gezeigten Dateien im Sortierungsfilter erheblich erweitert, so dass Sie immer eine passende Ansicht und Zahl zu der von Ihnen gewählten Spaltenansicht erhalten können, ohne Löcher in der Dateienansicht zu erzeugen. Ein sehr praktisches Tool, um damit schnell einen Überblick zu gewinnen, oder ein gesuchtes Bild zu finden.

In dem mehrspaltigen Bereich wird pro Box ein Objekt aus der Mediathek dargestellt, mit den jeweiligen Informationen und Optionen dieses Objekts:

Mediathek!Symbolleiste Symbolleiste Die Symbolleiste unterhalb jeder Infobox stellt die möglichen Funktionen für eine Datei dar. Abhängig davon, ob eine Datei ein Bild oder etwas anderes darstellt, bietet die Symbolleiste unterschiedliche Optionen an. Die Lupe öffnet eine Ansicht der Originaldatei in einem separaten Popup-Fenster. Bei Bildern wird hierin passgenau das Originalbild angezeigt, bei anderen Dateitypen wie PDF-Dokumenten wird das damit assoziierte Programm auf Ihrem Computer gestartet. Medien!umbenennen Das Stift-Icon ermöglicht Ihnen, eine Datei umzubenennen. Ein Popup-Fenster wird Sie nach dem neuen Dateinamen fragen. Beim Umbenennen der Datei müssen Sie darauf achten, dass, sofern die Datei bereits in Blog-Artikeln referenziert wird, Sie den Namen der Datei dort ebenfalls anpassen müssen, damit er dem neuen entspricht. Beim Umbenennen einer Datei kann nur der Stammname verändert werden und nicht die Dateiendung. Bei Bilddateien sehen Sie nun drei weitere Buttons: Das Diagonale Pfeile Symbol ermöglicht es, ein Bild zu vergrößern oder zu verkleinern. Bei einem Klick darauf öffnet sich eine Seite, die das Originalbild und dessen Originalauflösung darstellt, sie aber skaliert (d.h. Seitengerecht verkleinert) anzeigt, und Sie können in einer Texteingabebox die neue Auflösung eintragen. Die Auswahlbox Proportionen beibehalten sollte hier aktiviert sein und bewirkt, dass das Seitenverhältnis einer Datei bei der Verkleinerung beibehalten wird. Die Auswahlbox Variationsformat ändern, sollte nur aktiviert sein, wenn Sie das eigentliche Proportionsverhältnis des Bildes verändern. Näheres wird in den Info Boxen der Seite selbst erläutert. Siehe nachfolgend: Abbildung 4.14b. Die beiden weiteren Buttons in der Symbolleiste (Rotation nach links, Rotation nach rechts) drehen ein Bild im oder gegen den Uhrzeigersinn jeweils um 90 Grad. Sie können daher ein im Querformat hochgeladenes Bild ins Hochformat umwandeln und umgekehrt. Achten Sie auf die gemachten Einschränkungen bezüglich der Nutzung von AVIF Variations Dateien. Der nächste Button ist nun wieder für jeden Dateityp identisch. Das Picture-Symbol öffnet die Medien-Eigenschaften einer Datei (siehe Seite Medien-Eigenschaften hinzufügen und übernächste Abbildung 4.14c). Das Löschen eines einzelnen Bildes kann mit dem (vor-)letzten Button dieser Reihe, über das allseits verwendete Mülleimer-Symbol, oder global für mehrere Bilder über die Löschung mittels Checkbox und des Button Auswahl umkehren Auswahl umkehren und Löschen am Seitenende geschehen. Siehe vorhergehende Abbildung 4.14a. Bilddateien mit einer Bild-Variation (WebP/AVIF) zeigen einen weiteren Button, der auf Klick das größere Bild in der Variation anzeigt. Das macht zwar auch der Klick auf das gezeigte Vorschau Bild selbst auch, doch ist es dort mit seinem Originalnamen ausgezeichnet. Da aber, wie bereits erwähnt, das Styx Backend vollends auf die Ansichts Möglichkeiten von <picture> Containern setzt, wird auch hier schon das kleinstmögliche der möglichen Variationen geladen und angezeigt. Der Name allerdings orientiert sich am Originalbild, so dass Sie in etwa das sehen: "Vollbild: Blumenkohl.jpeg (AVIF)". Nur die Auszeichnung in der Klammer deutet auf die Variation hin. Drücken Sie aber den Variations Button, so sehen Sie: "Bild Variation: Blumenkohl.avif, 2500x1666px".

Vorschaubild/Icon Bei Bildern sehen Sie oben das Vorschaubild. Bei anderen Dateien kann hier ein Symbol für das jeweilige Dateiformat stehen.

Datei-Informationen Relevante und vorhandene Dateiinformationen, werden direkt darunter angezeigt. Auf einen Eigentümer Informationsausgabe wurde verzichtet, da seit vielen Serendipity Versionen keine Eigentümer Struktur für Medieninhalte mehr vergeben wird.

Üblicherweise richten sich die dargestellten Dateien nach deren chronologischem Hochlade-Zeitpunkt. Das erste dargestellte Bild ist also das, was zuletzt hochgeladen wurde - ganz gleich, in welchem Verzeichnis die Datei abgelegt wurde. Diese Reihenfolge und die Kriterien, nach denen Dateien angezeigt werden, können Sie im Kopfbereich anpassen:

Mediathek Filter Mediathek!Filter Mediathek!Sortieren

Filter: Verzeichnis Im Auswahlfeld Verzeichnis können Sie wählen, aus welchem Unterverzeichnis Dateien dargestellt werden sollen.

Filter: Dateiname Wenn Sie die Mediathek nach einem ganz speziellen Dateinamen durchsuchen wollen, können Sie diesen in dem Eingabefeld Dateiname eintragen. Dabei wird die Suche später auch nach Teilwörtern und ohne Berücksichtigung der Groß- und Kleinschreibung ausgeführt. So könnten Sie beispielsweise nach allen PDF-Dateien suchen, indem Sie dort .pdf eintragen. Über die Vereinfachte Filter-Einstellung in den Eigenen Einstellungen können Sie bestimmen, wieviel an Filteroptionen hier angezeigt und erlaubt werden.

Filter Die beiden vorangestellten Pfeile vor dem Button Filter deuten darauf hin, dass ein Klick einen Unterbereich im Filtermenü ausklappt. Dieser belegt recht viel Bildschirmplatz und wird standardmäßig ausgeblendet. Sie finden innerhalb dieses eingeblendeten Bereichs zahlreiche Filtermethoden, die Sie ausfüllen können, um Dateien nach bestimmten Kriterien zu suchen. Alle ausgefüllten Filterkriterien werden dabei miteinander so verkettet (UND-Verkettung), dass nur Dateien angezeigt werden, auf die jedes Kriterium zutrifft. Wenn Sie daher nach Dateien suchen wollen, die mehreren unterschiedlichen Kriterien entsprechen könnten, müssen Sie dafür jeweils erneut eine Suche ausführen. Filter: Medien-Schlüsselwörter In das Eingabefeld Medien-Schlüsselwörter können Sie, mit Semikolon getrennt, mehrere Schlüsselwörter eingeben, die auf ein Bild zutreffen müssen. Rechts neben dem Eingabefeld sehen Sie die Liste aller verfügbaren Schlüsselwörter, die Sie auch direkt durch Anklicken in das Eingabefeld übernehmen können. Filter: Upload-Datum Um nur Dateien anzuzeigen, die in einem gewissen Zeitraum eingestellt worden sind, können Sie das Start- und Enddatum in das Feld Upload-Datum eintragen. Das Dateiformat kann dabei der Syntax Tag.Monat.Jahr oder Jahr-Monat-Tag oder Monat/Tag/Jahr entsprechen - die Angabe einer Uhrzeit ist nicht möglich. Wenn Sie nur das Startdatum eintragen, werden alle Dateien seit diesem Zeitpunkt bis heute angezeigt. Ist nur das Enddatum ausgefüllt, werden alle Dateien bis zu diesem Zeitpunkt angezeigt. Filter: Dateiname Die Filterung nach einem Dateinamen konnten Sie bereits oberhalb des Filter-Bereichs einstellen, aber er wird hier der Vollständigkeit halber nochmals aufgeführt. Filter: Autor Wenn Sie nach Dateien suchen, die ein bestimmter Autor hochgeladen hat, können Sie diesen aus dem Auswahlfeld Autor aussuchen. Filter: Dateiendung Wollen Sie nach einem Dateinamen und einer Dateiendung suchen, reicht es nicht aus, nur das Feld Dateiname auszufüllen, da Sie dort ja nur nach einer einzigen Teilzeichenkette suchen. Daher können Sie zusätzlich im Feld Dateiendung nach einer Endung suchen und Dateiname für den eigentlichen Dateityp verwenden. Um zB. nach allen PDF-Dateien mit der Zeichenkette hund im Dateinamen zu suchen, tragen Sie pdf in Dateiendung ein und hund in Dateinamen. So werden Schäferhund.pdf wie auch Hundekuchen.pdf gefunden. Hätten Sie für den Dateinamen nur hund.pdf eingetragen, wäre nur Schäferhund.pdf gefunden worden! Filter: Dateigröße Die Dateigröße kann ähnlich wie das Upload-Datum in einem von-bis-Bereich angegeben werden. So können Sie alle Dateien zwischen X und Ykb Größe anzeigen. Filter: Bildbreite Filter: Bildhöhe Auch die Bildbreite und Bildhöhe lassen sich hier in Pixeln in einem minimalen und maximalen Bereich angeben. Wenn Sie also nach besonders kleinen oder großen Bildern suchen wollen, können Sie diese Einschränkung hier vornehmen. Filter: DPI Die DPI-Angaben einer Bilddatei lassen sich im Eingabefeld DPI filtern. Sollte man also nach einer druckfähigen Bilddatei suchen, könnte man hier 300 angeben. Filter: Laufzeit Bei einer Video- oder Audio-Datei könnte man im Eingabefeld Laufzeit den Bereich der Spieldauer eintragen. Die Angabe erfolgt dabei in Sekunden. Filter: Verknüpftes Datum Wenn Sie nach einer Datei suchen, die zu einem speziellen Zeitpunkt erstellt wurde und in den Meta-Daten einer Datei festgehalten wurde, können Sie im Eingabefeld Verknüpftes Datum danach suchen. Die zeitliche Einschränkung wird im selben Format vorgenommen wie bei der Filterung nach Upload-Datum. Filter: Copyright Suchen Sie Dateien mit einem speziell hinterlegten Urheber, können Sie im Eingabefeld Copyright danach suchen. Teilwörter werden dabei auch akzeptiert. Achten Sie darauf, dass das Copyright ein vom Redakteur optional ausgefülltes Informationsfeld ist und daher nicht zwingend bei jeder Datei verfügbar ist. Filter: Titel, Kurzer Kommentar, Langer Kommentar Die letzten drei Filterfelder Titel, Kurzer Kommentar und Langer Kommentar können ebenfalls Teilwörter enthalten, nach denen Sie in den entsprechend vom Redakteur ausgefüllten Meta-Feldern suchen können.

Die verfügbaren Filter-Felder der Meta-Informationen lassen sich mittels der Option Medien-Eigenschaften in der Serendipity-Konfiguration (siehe Kapitel Konfiguration ab Seite Konfiguration) einstellen. Alle dort festgelegten Felder können als Filterkriterium dienen.

Unterhalb des Filter-Bereichs können Sie die Sortierung der Anzeige beeinflussen:

Sortieren nach Über das Auswahlfeld Sortieren nach stellen Sie ein, wie die Bilder innerhalb der Übersicht sortiert werden. Zur Auswahl steht das Upload-Datum, der Dateiname (alphabetisch), der Autorname (alphabetisch), die Dateiendung (alphabetisch), die Bildbreite oder Bildhöhe und zuletzt die Sortierung nach allen konfigurierten Meta-Feldern.

Sortierung Die Sortierungsreihenfolge (absteigend oder aufsteigend) wird über das Auswahlfeld Sortierung festgelegt.

Dateien pro Seite Die letzte Option der Suche gibt an, wie viele Dateien pro Seite in der Übersicht angezeigt werden sollen. Die Auswahl ist auf 8, 16, 50 oder 100 Dateien begrenzt.

Per Verzeichnis Die Option der nächsten Zeile gibt an, ob nur Dateien des ausgewählten Verzeichnissebene, oder alle Mediendateien inklusive der Unterverzeichnisse dargestellt werden sollen. Diese Option ist ungemein hilfreich, wenn Sie über eine gut und verschachtelt sortierte Mediathek verfügen.

Ein Klick auf den Button Los! wird die gewünschten Filterkriterien auswerten und danach alle Suchergebnisse in der gewohnten blätterbaren Übersicht darstellen.

Verzeichnisse verwalten

Verzeichnisse verwalten Verzeichnisse verwalten|see{Backend, Verzeichnisse verwalten} Backend!Verzeichnisse verwalten

Zugriffsrechte Mediathek!Zugriffsrechte Ähnlich wie die Verwaltung der Kategorien (siehe Kapitel Kategorien auf Seite Kategorien) können Schreib- und Leserechte von Mediathek-Dateien verwaltet werden.

Hinter dem Menüpunkt Verzeichnisse verwalten sehen Sie eine Übersicht aller Unterverzeichnisse der Mediathek (uploads-Verzeichnis im Serendipity-Stammverzeichnis).

Neben allen Verzeichnissen, die jeweils wie im Dateisystem verschachtelt untereinander angezeigt sind, sehen Sie drei Buttons zum Bearbeiten, Duplizieren und zum Löschen eines Verzeichnisses.

Ein Klick auf den Button Neues Verzeichnis anlegen öffnet eine Seite, in der Sie den Namen eines neuen Verzeichnisses sowie dessen übergeordnetes Stammverzeichnis aus einem Auswahlfeld wählen können. Wenn Sie danach auf Verzeichnis anlegen klicken, wird Serendipity versuchen, das neue Verzeichnis zu erstellen. Damit dies erfolgreich durchgeführt werden kann, müssen die Zugriffsrechte (siehe Seite Zugriffsrechte) korrekt eingerichtet sein.

mdb-zugriffsrechte Ein erstelltes Verzeichnis kann bearbeitet werden, indem Sie auf das Stift-Icon klicken. In dieser Maske sehen Sie zum einen den Namen des Verzeichnisses und zum anderen zwei größere Auswahlfelder für die Leserechte und die Schreibrechte.

Diese Zugriffsrechte bestimmen ausschließlich die Zugriffsmöglichkeiten innerhalb Serendipitys. Wenn Ihre Redakteure allerdings auch per FTP Zugriff auf die Dateien der Mediathek haben, entzieht sich dies Serendipitys Zugriffsmöglichkeiten.

Die Zugriffsrechte in der Mediathek werden auch nicht herangezogen, wenn eine in einem Artikel eingebundene Datei im Frontend angezeigt wird. Der Link für eine eingebundene Datei zeigt direkt auf den Dateinamen und kann außerhalb von Serendipity über den normalen Webserver heruntergeladen werden. Serendipity selbst ist also beim Download der Datei nicht involviert und kann daher auch keine Zugriffsrechte auswerten.[*] Um Bilder nicht über den vollständigen URL-Pfad auszugeben und so Zugriffsrechte abzufragen, gibt es jedoch einen Trick, der auf Seite mdb-by-id erklärt wird. Einzig das Mediathek-Popup und weitere Funktionalitäten für Redakteure werten später die Zugriffsrechte aus und zeigen entsprechend der Rechte eines Redakteurs die ihm verfügbaren Optionen an.

Hat ein Redakteur kein Schreibrecht auf ein Verzeichnis, gilt dies auch für alle darin enthaltenen Dateien. Solche Dateien könnte ein Redakteur daher später nicht löschen. Wenn ein Redakteur auch keine Leserechte in einem Verzeichnis besitzt, wird er derartige Bilder in der Mediathek-Ansicht erst gar nicht angezeigt bekommen.

Die Lese- und Schreibrechte können jeweils für mehrere Benutzergruppen definiert werden, indem Sie die (Strg/Apfel)-Taste gedrückt halten und anklicken. Die Option Alle Autoren gibt ein Verzeichnis für alle Redakteure frei.

Alle Lese- und Schreibrechte gelten ausschließlich für das aktuell bearbeitete Verzeichnis. Etwaige Unterverzeichnisse müssen alle separat konfiguriert werden. Dadurch ist es später möglich, zwar ein Stammverzeichnis für Redakteure zu sperren, aber Unterverzeichnisse gezielt wieder zugänglich zu machen. Wenn Sie im Nachhinein bei einer bestehenden Verzeichnisstruktur Rechte vergeben, möchten Sie vielleicht gerne diese Rechte auch für alle Unterverzeichnisse identisch vergeben. Dafür müssen Sie das Ankreuzfeld Identische Rechte auch auf alle Unterverzeichnisse anwenden aktivieren.

Standardmäßig stehen die Lese- / Schreibrechte auf "0", das heißt "Alle Autoren". Setzen Sie sie aber als Administrator beispielsweise auf Redakteur, gleich "1", können Sie anschließend nicht mehr zurück wechseln, da Sie sich selbst das Recht entzogen haben. Achten Sie also darauf, höherrangige Usergruppen immer mit zu inkludieren, wenn Sie selbst weiterhin darauf Zugriff haben sollen. Und das wollen Sie!

Mediathek!Verzeichnisse löschen Um ein Verzeichnis zu löschen, klicken Sie auf das Mülleimer Symbol. Sie gelangen danach auf eine Unterseite, die Sie nochmals fragt, ob Sie das Verzeichnis inklusive aller Dateien löschen (sowohl in der Mediathek als auch im Dateisystem) wollen. Mediathek!FTP Wenn Sie einmal Dateien mittels FTP in das zu löschende Verzeichnis (oder eines seiner Unterverzeichnisse) hochgeladen haben, kann es sein, dass sich darin Dateien befinden, die die Mediathek noch nicht synchronisiert/importiert hat. Standardmäßig löscht Serendipity jedoch nur alle Dateien, die in der Mediathek auch verzeichnet sind. Wenn Sie die Option Alle Dateien dieses Verzeichnisses löschen aktivieren, wird Serendipity auch alle dem System unbekannten Dateien zu löschen versuchen. Auch hier gilt wieder, dass Serendipity nur Dateien löschen kann, auf die es auch Schreibzugriff hat.

Vorschauen erneuern

Vorschauen erneuern Vorschauen erneuern|see{Backend, Vorschauen erneuern} Backend!Vorschauen erneuern FTP!Synchronisation Mediathek!Synchronisierung Synchronisierung Thumbnails

Mit Serendipity 2.0 rückte dieser administrative Teil der Mediathek an sich, in die Wartungs Sektion der Backend: Einstellungen, genauer Wartung: Vorschauen erneuern.

Wie am Anfang des Kapitels Mediathek auf Seite Mediathek erklärt, muss Serendipity zwischen den Dateien innerhalb der Verzeichnisstruktur auf dem Server und einer Datenbanktabelle mit Meta-Informationen synchronisieren.

Wenn Sie also Dateien mittels FTP in das Mediathek-Verzeichnis uploads hineinkopieren, wird Serendipity davon erst einmal nichts mitbekommen. Damit Serendipity einen Abgleich zwischen Dateien auf dem Server und der Mediendatenbank durchführen kann, nutzen Sie den Menüpunkt Vorschauen erneuern.

Wenn Sie auf diesen Menüpunkt klicken, wird Serendipity alle Dateien und Unterverzeichnisse des uploads-Verzeichnisses durchgehen und prüfen, ob die Datei bereits (oder noch) in der Mediendatenbank vorhanden ist. Etwaige gelöschte Dateien auf dem Server werden daraufhin aus der Mediathek entfernt und neue Dateien importiert.

Auch schon der normale Aufruf der Mediathek selbst kann ihre Daten automatisch synchronisieren (siehe Seite MDB-Synchronisation), ist aber mit der genannten Option nicht zu hundert Prozent identisch. Es kann daher ratsam sein, dann und wann die erste Option der Mediathek Wartungsaufgaben ("Behalte alle vorhandenen Vorschaubilder") laufen zu lassen, damit auch kleinste Unebenheiten bereinigt werden und Sie über diese auch informiert werden.

Für jede gelöschte oder neu hinzugefügte Datei wird daraufhin ein Hinweis auf die durchgeführte Aktion ausgegeben. Die Meldung Fertig (xx Bilder synchronisiert) am Ende des Vorgangs gibt genaue Information darüber, wie viele Dateien bearbeitet wurden.

Fehlerhafte und nicht lesbare Dateien werden ebenfalls in dieser Ausgabe angezeigt, so dass Sie diese Dateien möglicherweise manuell via FTP löschen oder verändern müssen.

Performance Wenn Sie besonders viele Dateien und Verzeichnisse in der Mediathek gespeichert haben, kann die Ausführung dieser Funktion möglicherweise sehr lange dauern oder gar zu Server/PHP-Timeouts führen. Wenn dies passiert, sollten Sie entweder überlegen, alte Dateien in der Mediathek zu löschen, oder Sie können alternativ in der Serendipity-Konfiguration die automatische Synchronisierung der Mediathek aktivieren (siehe Seite MDB-Synchronisation). Sobald die automatische Synchronisierung aktiviert ist, werden extern hochgeladene Dateien beim Betrachten der Mediathek automatisch importiert. Dies beansprucht weniger Zeit, da bei einem etwaigen Verbindungsabbruch an der Stelle fortgefahren werden kann, bei der zuletzt abgebrochen wurde. Ein Löschen von bereits in Artikeln benutzten Mediendateien ist nur bedingt anzuraten, denn diese bedingt ein sauberes System. Die Fehlerquellen - gerade in alten Blogs - mit alten Fehlern und weiteren Ungereimtheiten machen dies zu einem gewagten Spiel.

Ein weiteres Feature der Funktion Vorschauen erneuern ist, dass alle Vorschaugrafiken von Bildern überprüft und ggf. neu erstellt werden. Falls Sie also versehentlich eine Vorschaugrafik namens .serendipityThumb auf dem Server gelöscht haben, kann diese Datei immer neu erstellt werden. Wenn Sie in der Serendipity-Konfiguration (siehe Seite Vorschaubildgröße) die Auflösung der Vorschaugrafiken einmal verändert haben (standardmäßig 400 Pixel), könnten sämtliche Vorschaubilder mit der neuen Auflösung neu berechnet werden.

Die automatische Synchronisierung kann Änderungen in der Vorschaubild-Auflösung nicht automatisch durchführen. Wenn also Ihre Mediathek zu groß geworden ist, um die Ausführung der Funktion Vorschauen erneuern erfolgreich zu beenden, müssen Sie die Vorschaubilder leider manuell mittels anderer Bildverwaltungsprogramme verkleinern. Allerdings kann die genannte Funktion durchaus mehrfach aktualisiert werden wenn eventuelle Fehler auftreten oder es gar einen Abruch aus Zeitüberschreitung gab, denn es werden ja jeweils nur die neueren oder fehlenden Bilder synchronisiert.

Mit Serendipity Styx wurden schon allerlei Bugs und Ungereimtheiten gefixt, die die fehlerfreie Funktion der Mediendaten-Synchronisation, und/oder die korrekte Konvertierung der Einträge die bereits Mediendaten enthielten, behinderten. Es ist einfach ein komplizierter Prozess und jede weitere Neuerung macht es noch komplizierter. Und so finden sich in den Randbereichen bis heute Prozesse, die weiter und immer weiter optimiert werden müssen.

Auch wurde ein neuer Menüpunkt Konvertiere alte Vorschaubild-Namen hinzugefügt, der es ermöglicht, einen Abgleich und Umschrieb der Mediendaten auf eine veränderte Vorschaubild-Endung durchzuführen, falls Sie sich mittendrin entscheiden sollten, die Serendipity .serendipityThumb oder Styx .styxThumb Standardeinstellung des Vorschaubild-"Präfixes" zu verändern. Diese Option ist solange nicht zu sehen, wie das bisherige thumbSuffix nicht geändert wurde. Wenn es geändert wurde, muss schon mindestens eine neue Mediatheksdatei neu damit erstellt worden sein damit sie in der Wartung und den Optionen der Bildersynchronisation auftaucht. Sie konvertiert bestehende Thumbnails, die nicht nach dem aktuellen thumbSuffix-Schema benannt sind: fooThumb (als Beispiel), in der Datenbank, im Dateisystem und bereits in Einträgen verwendet, in das gleiche Suffix-Benennungsschema.

Das sollten Sie aber nicht unbedarft tun, denn die Möglichkeiten eines riesigen Kuddelmuddels sind groß. Ein wenig Erfahrung und vielleicht das eine oder andere Backup der Mediathek, sowohl real im Filesystem als auch der Datenbank, können nicht schaden, um eventuelle Schäden zu verhindern. Sie können ohne weiteres mit zwei verschiedenen Thumbnail Auszeichnungen leben, wenn es sich durch ein Update eines alten Blogs so ergeben hat. Nur in einem Fall ist die Synchronizität im Vorwege wirklich erforderlich, wenn Sie die "Erneuere alle [...]" Option laufen lassen wollen. Dann müssen Sie die Thumbname Präfix Auszeichnung überall gleich haben! Ansonsten laufen die Find und Replace Anweisungen in ihren Blogeinträgen möglicherweise Amok.

Der Punkt "Erstelle/Lösche alle zusätzlichen Picture-Format Variationen" ist die Aufgabe gedacht, wenn Sie alle Bild Variationen auf einmal löschen und danach neu erstellen lassen wollen. Je nach Zustand (haben oder nicht haben) wird aus diesem Punkt ein "Löschen" oder "Erstellen". Für das Erstellen gelten natürlich alle bisher gemachten Einschränkungen und Bedachtsamkeitem bezüglich Auslastung und Fehlerquellen, insbesondere wenn Sie die AVIF Option aktiv gesetzt haben. Löschen Sie ein Bild mit den üblichen dafür vorgesehenen Werkzeugen, werden natürlich auch dessen Variationen gelöscht. Das ist also hier nicht gemeint!

Kommentare

Kommentare Kommentare|see{Backend, Kommentare} Backend!Kommentare Moderieren!Kommentare Plugins!Spamschutz!

Ähnlich wie die Übersichtsseite Einträge bearbeiten enthält die Seite Kommentare eine Übersicht aller übermittelten Kommentare und Trackbacks Ihrer Besucher.

Von dieser Oberfläche aus können Sie Kommentare löschen, freischalten, überarbeiten oder auch nach speziellen Kommentaren suchen.

Systemmeldungen, wie erfolgreiches Moderieren, Löschen, oder Fehlermeldungen, werden in den Systemfarben für diese Ereignisse am Anfang der Seitenliste oberhalb des Kommentare-Titels ausgegeben.

Die Kommentar Liste:

Der Inhaltsbereich zeigt die Kommentare in einzelnen Boxen untereinander an. Direkt oberhalb dieser Boxen befindet sich ein Informationstext, der die Anzahl der dargestellten Kommentare und die Nummer der aktuellen Seite angibt. Die Möglichkeit zum Blättern mittels Weiter und Zurück, Anfang und Ende befindet sich, wie bei solchen Listendarstellungen üblich, sowohl oberhalb als auch unterhalb der Kommentarauflistung, wenn genügend Listeneinträge vorhanden sind.

Die erste Zeile jeder Box zeigt Informationen über den Autor, zu welchem Artikel der Kommentar gehört und wann er erstellt wurde. Die Detailangaben zum Autor und seiner Verbindung zum Artikel werden über eine ausklappbare Box über den Informations-Button am Ende dieser Informationszeile realisiert und klappen unterhalb dieser auf. Jede Kommentarbox enthält folgende Angaben:

Kommentare!Ueberschrift@Überschrift Überschrift Der Bezug zu einem Artikel ist klickbar und führt ins Frontend Ihres Blogs. Nicht freigeschaltete Kommentare und Trackbacks werden durch eine graunterlegte Markierung im rechten oberen Teil der Kommentarbox vom Rest abgehoben.

Kommentare!Autor Autor Der Name des Verfassers eines Kommentars wird gleich am Anfang dargestellt.

Kommentare!Detailbox Detailbox Autor: Wenn das Spamblock-Plugin (siehe Seite spamblock) installiert ist, wird in der Detailbox neben dem Namen des Autors ein Symbol mit durchstrichenem Kreis, im folgenden Blacklist-Symbol genannt, angezeigt. Ein Klick auf dieses Symbol wird in Zukunft Kommentare des gleichnamigen Autors in eine Blacklist einfügen und abweisen. Erscheint ein Erfolgs-Symbol an dessen Stelle, wird der Name bereits gefiltert, und ein erneuter Klick hebt diesen Filter wieder auf. Kommentare!E-Mail E-Mail: Die E-Mail-Adresse eines Kommentators wird neben E-Mail angezeigt. Auch hier kann bei aktiviertem Spamblock-Plugin die E-Mail-Adresse in einen Filter aufgenommen werden. Sicherheit Kommentare!IP IP: In der zweiten Zeile der Kommentarbox wird die IP-Adresse des Kommentators angezeigt. IP-Adresse Eine IP-Adresse identifiziert einen Benutzer im Internet beim Aufruf einer Seite. Sollte Sie einmal rechtswidrige Inhalte in einem Kommentar auffinden, kann eine Strafverfolgungsbehörde mit Hilfe dieser IP möglicherweise den wahren Täter aufspüren. Meist werden für derartige Straftaten aber offene Proxies eingesetzt, die die eigene IP-Adresse des Täters verschleiern, so dass er sozusagen nur über einen Decknamen auf Ihren Server zugreift. Kommentare!URL URL: Die Homepage eines Kommentators wird unterhalb seiner E-Mail-Adresse angezeigt. Ein Klick hierauf öffnet die Homepage direkt in einem neuen Browserfenster. Auch die URL kann als Filter für das Spamblock-Plugin durch Klick auf das Blacklist-Symbol gesetzt werden. Kommentare!Referrer Referrer Referrer: Wenn ein Besucher Ihre Webseite aufruft, übermittelt sein Browser üblicherweise die URL der zuletzt aufgerufenen Webseite. Wenn ein Besucher über eine Suchmaschine den Weg zu Ihnen findet, gibt der sogenannte Referrer Auskunft darüber, nach welchen Begriffen er gesucht hat. Möglicherweise ist es also für Sie interessant zu erfahren, von welcher Webseite ein Besucher zu Ihnen kam und dann einen Kommentar hinterlassen hat. Genau diese vorherige Webseite wird in der Kommentarbox beim Punkt Referrer eingebunden, ein Klick darauf öffnet die entsprechende Webseite. Wenn ein Besucher keine vorherige Webseite besucht hat, ist in diesem Feld meistens die URL des kommentierten Artikels enthalten.

Kommentare!Text Kommentar Der eigentliche Text, den der Besucher als Kommentar (oder Trackback) hinterlassen hat, wird im Hauptteil der Box angegeben. Damit zu lange Texte nicht den Rahmen sprengen, und die Kommentar-Vorschauzeile möglichst eine Kurzzeile bleibt, werden sie nach ~72 Zeichen mit einem ... abgekürzt. Wenn gekürzt wurde, also tatsächlich mehr Text vorhanden ist, wird ein neuer Aufklapp-Button für die vollständige Anzeige ans Ende der Kommentar Symbolleiste am rechten Rand der untersten Zeile hinzugefügt (siehe übernächste Abbildung 4.9-sx für Serendipity Styx). Solche Kürzungen werden für die Einhaltung des Darstellungsdesigns an mehreren Stellen vorgenommen und können auch schon nach ~25 Zeichen erfolgen. Da dies unverifizierte Eingaben aus dem Internet sind, werden all diese Angaben zu ihrer eigenen Sicherheit mittels serendipity_specialchars() "unbrauchbar" gemacht, so dass kein ausführbarer Code weitergegeben, dargestellt, oder ausgeführt wird. Solche Einträge werden als reiner Textstring angezeigt. Aktive HTML-Kommentaren werden mittels eines roten …</> Abschlußsymbols kenntlich gemacht.

Kommentare!Symbolleiste Symbolleiste Unterhalb jedes Kommentars befindet sich eine Symbolleiste mit Buttons. Die Buttons richten sich dabei danach, ob das Objekt ein Kommentar oder ein Trackback ist, ob es freigeschaltet, versteckt oder moderiert ist und ob der Text länger als ~72 Zeichen ist oder nicht. Bei noch nicht freigeschalteten Beiträgen erscheint der Button als Like-"Bewilligen"-Symbol. Ein Klick darauf wird den gewählten Beitrag freischalten. Ist ein Kommentar bereits freigeschaltet, erscheint der Button als Dis-Like-"Moderieren"-Symbol mit dem abgesenktem Daumen, um den Kommentar erneut zu verstecken. Da es manchmal vorkommen kann, dass man einen Kommentar gerne behalten, aber eben auch nicht anzeigen lassen möchte, und Wert darauf legt, dass ein solcher nicht die Liste der unbewilligten und zu bearbeitenden Kommentare unnötig aufbläht, wurde der "Bewilligen, aber versteckt" Button (siehe Abbildung 4.9-sx) über das Auge-"Inaktiv/Aktiv setzen"-Symbol eingeführt. Bei Beiträgen, die länger als ~72 Zeichen sind, wird der Button ganz anzeigen als nach rechts weisender kleiner Dreieckspfeil eingeblendet. Per Klick wird der vollständige Kommentartext angezeigt, ein erneuter Klick reduziert die Ansicht wieder auf die gekürzte Fassung. Desweiteren gibt es Buttons, die immer verfügbar sind. Die Lupe (Anzeigen) öffnet bei einem Klick ein neues Fenster, in dem der Kommentar im Kontext des Artikels im Frontend dargestellt wird. Das Stift-"Bearbeiten"-Symbol öffnet wie immer eine Oberfläche, in der ein Kommentar von Ihnen bearbeitet und redaktionell verändert werden kann. Abbildung 4.9: Aktivität: Kommentar bearbeiten mit PLAIN TEXT Editor In dieser Oberfläche können Sie wie beim Kommentieren im Frontend die bekannten Felder ändern, die mit den Eingaben des Besuchers vorausgefüllt sind. Ein Klick auf Kommentar abschicken speichert die von Ihnen überarbeitete Fassung des Kommentars. Achten Sie bei der Moderation von Kommentaren darauf, dass dies möglicherweise von Besuchern als Zensur aufgefasst werden könnte. Zensur Überarbeiten Sie also einen Kommentar eines fremden Users wirklich nur dann, wenn Sie entweder darauf hinweisen oder es unabdingbar ist. Abbildung 4.9b: Aktivität: Kommentar bearbeiten mit HTML Editor HTML Kommentare - bzw den Rich-Text-Editor - können Sie für das Frontend und das Backend in der Konfiguration - Generelle Einstellungen per Konfigurationsoption erlauben. Die notwendigen Sicherheitsmaßnahmen sind getroffen, um dies als eine wählbare Alternative für größere Nutzerfreundlichkeit zu erlauben. Kommentare!löschen Der Button mit dem Mülleimer-Symbol entfernt einen Kommentar vollständig aus der Datenbank. Wenn sich bereits andere Kommentare auf einen zu löschenden Kommentar beziehen (also im Frontend verschachtelt darunter dargestellt werden), wird ein Kommentar beim Löschen erst nur gekürzt. Der Text wird ausgeschnitten, aber die Grunddaten des Kommentars bleiben intakt, um die Verschachtelung nicht durcheinander geraten zu lassen. Erst wenn ein derartiger Kommentar ein zweites Mal gelöscht wird, werden die Bezüge zerstört und der Kommentar komplett entfernt. Die Symbolleiste stellt auch den Antwort-Button als Chat-Symbol zur Verfügung. Dies ermöglicht Ihnen, direkt zu einem internen Popup-Fenster zu springen, um den betreffenden Text direkt mit einer Antwort kommentieren zu können. Das Eingabefeld Antwort zu ist dabei korrekt mit dem betreffenden Kommentar vorausgefüllt, ebenso Ihr Name und Ihre E-Mail-Adresse.

Innerhalb jeder Kommentarbox befindet sich linksseitig eine HTML Checkbox. Wenn diese ausgewählt wird, kann man die markierten Kommentare über den Button "Markierte Kommentare" Löschen am Ende der Seite entfernen. Der Button Auswahl umkehren dreht die Markierungen um, so dass vorher ausgewählte Kommentare nun nicht mehr gewählt sind und stattdessen alle anderen. So lässt sich besonders leicht Spam herausfiltern, da eine ganze Seite mit dargestellten Kommentaren durch einen Klick auf Auswahl umkehren markiert und gelöscht, oder bewilligt werden kann.

Die Serendipity Styx Kommentarliste:

Ob die einzelne Kommentar-Box einen Trackback, einen Pingback oder einen User-Kommentar darstellt, ist in Serendipity Styx über eine verschiedenfarbene Belegung der unteren linken Ecke realisiert und Kommentare werden als C, Trackbacks als T und Pingbacks als P gekennzeichnet. Ob der Kommentar von Ihnen selbst als Blogautor geschrieben wurde, ist mittels eines kräftig blauen diagonalen Dreiecks in der rechten oberen Ecke ausgewiesen. Allgemein wirkt das Design der Serendipity Styx Kommentarliste aufgeräumter und die wesentlichen Komponenten sind schneller erfassbar und strukturierter angeordnet.

Die Kommentar Filterung:

Ebenfalls analog zu der Oberfläche Einträge bearbeiten kann die Darstellung der Kommentarübersicht nach bestimmten Kriterien gefiltert werden:

Autor In das Feld Autor können Sie den Namen eines Kommentators eingeben, nach dessen Kommentaren Sie suchen möchten. Dabei wird ein Autorenname unabhängig von Groß- und Kleinschreibung nach Teilwörtern durchsucht. Eine Suche nach ann wird also sowohl Kommentare von Hanni als auch von Nanni darstellen.

E-Mail Um nur Kommentare von Benutzern mit einer bestimmten E-Mail-Adresse anzuzeigen, können Sie deren Adresse in diesem Eingabefeld eintragen. Hierbei gilt dasselbe Suchmuster wie bei der Suche nach Autor.

URL Um nur Kommentare von Benutzern mit einer speziellen URL-Adresse anzuzeigen, können Sie diese URL eintragen. Hierbei gilt dasselbe Suchmuster wie bei der Suche nach Autor.

IP Um nur Kommentare von Benutzern mit einer speziellen IP-Adresse anzuzeigen, können Sie diese hier eintragen. Hierbei gilt dasselbe Suchmuster wie bei der Suche nach Autor. Bei der Angabe von IPs empfiehlt es sich daher, immer die vollständige Zahlenreihe einzugeben und nicht nur Teile davon.

Inhalt Hier können Sie Kommentare nach dem Auftreten bestimmter Wörter im Inhaltstext des Kommentars durchsuchen. Es gilt dasselbe Suchmuster wie bei der Suche nach Autor.

Referrer Die URL der Webseite, auf der sich ein Kommentator zuletzt befunden hat, kann in dem Eingabefeld Referrer eingetragen werden. Auch hier können Teilwörter wie bei der Suche nach Autor eingetragen werden.

Kommentare Das Auswahlfeld Kommentare ermöglicht es, mehr als nur 10 Kommentare pro Seite anzuzeigen. Die Auswahl reicht hier von 10, 20 und 50 bis hin zu allen Kommentaren. Achten Sie darauf, dass bei der Anzeige aller Kommentare die HTML-Seite sehr groß werden kann und Ihren Browser sehr lange beschäftigen könnte.

Zeige Über dieses Auswahlfeld kann man einstellen, ob man in der Kommentarübersicht noch freizuschaltende Kommentare/Trackbacks sehen möchte, nur freigeschaltete oder Kommentare/Trackbacks beiden Typs.

Typ Das Auswahlfeld schränkt ein, ob man nur Kommentare, nur Trackbacks oder beide Sorten von Kommentaren dargestellt bekommen möchte.

Diese Filteroptionen werden durch einen Klick auf Los! gesetzt und beim Blättern der Folgeseiten auch angewendet. Falls Sie das Spamblock-Plugin verwenden, können Sie übrigens durch einen Klick auf Anti-Spam-Maßnahmen konfigurieren direkt zu dessen Konfigurationsoberfläche springen.

Spamschutz

Spamschutz Anti-Spam Spamblock Spamschutz Spamschutz|see{Backend, Spamschutz} Backend!Spamschutz Plugins!serendipity_event_spamblock

Der Menüpunkt Spamschutz verlinkt direkt in die Konfiguration des serendipity_event_spamblock Plugins (Spamschutz). Bitte lesen Sie dort nach, welche vielfältigen Möglichkeiten des Spamabwehr und der Spambehandlung es in Serendipity gibt. Dieses Plugin sollte immer aktiviert sein!

Serendipity Styx hat diesen extra Menüpunkt entfernt, ist er doch als Button unter Kommentare und als Plugin Konfigurationseinstellung weiterhin zugänglich; also an den Orten die nötig sind um konkrete Einstellungen zur Laufzeit oder zur Installation anzupassen.

Option ein-/ausblenden

Option ein-/ausblenden toggle

Das Symbol vom Menüpunkt Option ein-/ausblenden dient dem schnellen Überblick und klappt alle zur Zeit gezeigten Kommentare der Liste direkt auf oder zu, so wie es der Button mit dem rechts-/himmelweisendem Dreieck es auch für jeden einzelnen Kommentar tun kann.

Themes verwalten

Themes verwalten Styles!verwalten|see{Backend, Themes verwalten} Backend!Themes verwalten Themes!verwalten|see{Backend, Themes verwalten} Template-S@Templates!verwalten|see{Backend, Themes verwalten} Themes Template-S@Templates Styles Layout Frontend

Bei Serendipity sind die Begriffe Style, Theme und Template synonym verwendet. Alle drei Begriffe bezeichnen eine Sammlung von Dateien, die das Layout Ihres Frontends (und auch in begrenztem Maße des Backends) bestimmen.

Alle Templates werden im Verzeichnis templates verwaltet. Dort befindet sich pro Template ein Unterverzeichnis, das eine Sammlung von Dateien enthält (siehe Kapitel templatefiles ab Seite templatefiles).

Um eigene oder fremde Templates in Serendipity einzubinden, müssen sich die Template-Dateien in diesem Unterverzeichnis befinden. Erst dann kann Serendipity über den Menüpunkt Themes auf diese Verzeichnisse zugreifen.

Smarty Eine Template-Datei stellt dabei bestimmte Elemente (Einträge, Übersichten, Kommentare ...) in einfachem HTML-Format dar. Innerhalb der Template-Datei (*.tpl) werden Platzhalter verwendet, die bei der Ausführung von Serendipity durch eigentliche Inhalte ersetzt werden. Für diese Platzhalter-Logik verwendet Serendipity eine Software-Bibliothek namens Smarty [*] https://www.smarty.net/. Smartys Aufgabe ist es, die Template-Dateien nach Platzhaltern zu durchsuchen, zu kompilieren (in PHP-Code umwandeln) und danach auszugeben. Dabei kann Smarty weitaus mehr, als nur Variablen zu ersetzen: Smarty bietet Kontrollstrukturen (IF-Abfragen), Schleifen und PHP-Funktionsaufrufe an. Dies alles kann von Template-Entwicklern benutzt werden, um ganz individuelle Darstellungen des Frontends zu erreichen, und wird in Kapitel Smarty-Templates ab Seite Smarty-Templates ausführlich erklärt.

Ein Klick auf den Menüpunkt Themes stellt eine Liste aller verfügbaren Templates dar. Dabei werden auch kleine Vorschaubilder zu den Themes untereinander angezeigt, die einen Eindruck vermitteln, wie Ihr Frontend später aussehen könnte.

Jede Template-Box enthält dabei als Überschrift den Namen des Templates und Informationen über den Autor, das Erstellungsdatum und ob eine Eigene Admin-Oberfläche vorhanden ist. Zu einigen Templates wird Ihnen auch ein größeres Vorschaubild angeboten, wenn Sie auf das Vorschaubild klicken.

Um ein Template zu aktivieren, klicken Sie einfach auf den Installieren-Button unterhalb der Vorschau. Daraufhin wird das Template aktiviert, und wenn Sie das Frontend nun öffnen (Zurück zum Blog), werden Sie das neue Layout schon betrachten können. Fehler!Template-Änderung wirkt sich nicht aus Je nach eingesetztem Browser könnte es notwendig sein, dass Sie den Browser neu starten oder den Browsercache leeren müssen, bevor die Änderungen am Layout bei Ihnen sichtbar sind. Dies könnte erforderlich sein, da das Design zum Teil von der geladenen Stylesheet-Datei bestimmt wird, die aus Geschwindigkeitsgründen von vielen Browsern zwischengespeichert wird.

Jede Template-Box enthält einen Informations-Button, mittels dem nützliche Informationen zum Theme, wie Autor, letztes Aktualisierungsdatum, Angaben zu einer eigenen Konfigurationsdatei, oder sogar einer eigenen Admin-Oberfläche ausgegeben werden. Ebenso kann diese Ausgabe eine Zusammenfassung der Möglichkeiten des Themes und/oder sogar zusätzlich eine Beschreibung des eigenen Backends oder überhaupt seiner Eigenschaften enthalten. Dies ist mit Serendipity Styx grundlegend erweitert worden, ebenso wie die Möglichkeit die Informations-Texte nach der eingestellten Sprache auszugeben, soweit diese schon übersetzt wurde. Siehe: lang_info_en.inc.php und analog für Deutsch lang_info_de.inc.php etc. ebenso wie im UTF-8 Verzeichnis des Themes.

Die mitgelieferten Themes sind in drei Kategorien eingeteilt. Die ersten beiden beschreiben die aktuell ausgewählten Themes für das Frontend und das Backend. Darunter befindet sich die Sektion der empfohlenen Themes, die in ihrer Mehrheit heutigen Erfordernissen entsprechen oder sonstwie als herausragend angesehen werden. Darunter sind alle anderen, wie auch einige Besondere, wie ein default-php oder auch default-xml Template, oder Beispiele für Engine Templates.

Die Serendipity Styx 3.x Series hat dieses Konzept der empfohlenen Themes wieder verworfen und vereinfacht. Die mitgelieferten Themes heißen nun einfach "Kern Themes"; die per Spartacus hinzugefügten "Verfügbare Themes".

Diese mitgelieferten Kern Themes bestehen zum Teil aus den Standard Themes der verschiedenen Jahre und Revisionen, wie das "pure" Theme 2020/22, das "2k11" aus 2011/13, usw., bis hin zum originären "default" Theme das für die Zugriffs-Kaskade in der Datei-/Template-Suche einen besonderen Platz als Endpunkt einnimmt. Zum anderen Teil aus möglichen Standard Derivaten (wie "Next"), verschiedenen Framework-Themes ("bootstrap4" oder "skeleton"), Besonderheiten, wie dem PHP-Template Beispiel Theme, und weiteren interessanten Engine Themes, die als Beispiele für eigene Versuche gelten können. Ihnen gemein ist, dass sie mit den Styx Revisionen kontinuierlich gepflegt wurden.

Weitere Themes werden nur geladen und angezeigt, wenn Sie Spartacus dazu verwenden und die erweiterte Theme Option in dessen Konfiguration aktiviert haben. Per default macht das keinen Sinn, da es viele Themes auf Spartacus gibt, die schon sehr lange kein grundlegendes Update mehr erfahren haben. Die Aktivierung dieser Option kann manch schwache Systeme, auf Grund der Menge der zu verarbeitenden Information beim ersten Laden dieser Seite, durchaus kurz außer Gefecht setzen. Die Empfehlung lautet daher, sich erst einmal an die empfohlenen Themes zu halten, bis man genügend Vertrautheit mit den Gegebenheiten erlangt hat.

Durch das Konzept der webP Bild-Variationen mit Styx 3.0 und der zum Teil erheblichen Reduzierung der Datei Größe, gilt obige Warnung heute nur noch bedingt. Ebenso wurden all diese alten Themes auf Funktionalität und Kompatibilität getestet und soweit generalüberholt bzw. ergänzt, dass sie unter neuen Styx Versionen wenigstens funktionieren. Tauglich für heutige Mobilgeräte sind, und/oder über ein vollständiges Responsives Verhalten verfügen, dennoch nur wenige!

Template-Optionen

Template-Optionen

Seit Serendipity 1.1 besteht für Templates die Möglichkeit, eigene Optionen zu konfigurieren. Das bedeutet, dass ein Template individuell entscheiden kann, was für zusätzliche Möglichkeiten und Darstellungsarten Sie gerne aktivieren möchten.

Wenn Sie ein Template ausgewählt haben, das diese Optionen bereitstellt, sehen Sie einen zusätzlichen Bereich im ersten Abschnitt des Styles verwalten-Menüpunktes. Nur wenige der von Serendipity mitgelieferten Templates unterstützen diese Optionen. Das Serendipity (pure) Standard-Template bietet z. B. diese Template-Optionen an, um den Inhalt der zusätzlichen Navigations-Links im Frontend einstellen zu können.

Ist dieses Template gewählt, so befinden sich im oberen Bereich jeweils zwei Eingabeboxen pro Menüpunkt. Über diese Eingabeboxen können Sie den jeweiligen Link eines Menüpunkts im Frontend bestimmen und festlegen, wie der Text des Menüpunktes lauten soll.

Spartacus Andere Templates, die via Spartacus (siehe Seite Spartacus) bezogen werden können, bieten Template-Optionen für weitaus fortgeschrittenere Konfigurationsmöglichkeiten, die Sie z. B. zwischen mehreren Farbvarianten wählen lassen oder auch bestimmen, wie die Inhaltsbreite festgelegt wird.

Besondere Templates

Template-S@Templates!besondere Template-S@Templates!für Programmierer

Bei Serendipity gibt es eine kleine Zahl besonderer Templates, die Sie nur in Sonderfällen aktivieren sollten. Dies sind:

PHP Engine (Dev) Das Template PHP Engine (Dev) benutzt eine vom Standard abweichende Template-Engine. Anstelle von Smarty kommt hier PHP-Syntax zum Einsatz. Dieses Template ist nur für Entwickler gedacht und kann ev. zu Fehldarstellungen des Frontends führen, wenn es ohne weitere Modifikationen eingesetzt wird. Serendipity Styx hat dieses besondere Template ausführlicher ausgearbeitet.

XML Engine (Dev) Auch das Template XML Engine (Dev) benutzt eine vom Standard abweichende Template-Engine. Hier kommt XSLT zum Einsatz, und auch dieses Template kann ohne weitere Anpassung die Darstellung des Frontends unbenutzbar machen. Für beide genannten Templates gilt, dass der Namenszusatz Dev für Developer (Entwickler) steht und daher auch nur von dieser Zielgruppe benutzt werden sollte.

Newspaper Blog Dieses Template existiert eher nur noch aus historischen Gründen und stammt aus einer Zeit, in der Serendipity-Templates noch nicht mittels Smarty-Syntax erstellt wurden. Dementsprechend erhalten Sie die Warnung: Hinweis: Das aktuelle Template verwendet eine ältere Methode der HTML-Erzeugung. Falls möglich, bitte das Template auf die Nutzung von Smarty optimieren. wenn das Template aktiviert wurde. Im Grunde genommen soll dieses Template also nur demonstrieren, dass auch ganz alte Templates mit Serendipity noch grundsätzlich funktionstüchtig sind.

Plugins verwalten

Plugins verwalten Plugins!verwalten|see{Backend, Plugins verwalten} Backend!Plugins verwalten

Das Herzstück des Serendipity-Systems zur Erweiterung des Blogs ist der Menüpunkt Plugins.

Plugins Als Plugin bezeichnet man eine eigenständige PHP-Datei, die zusätzliche Funktionalität in das System "stöpselt". Das Aktivieren eines Plugins erfolgt komfortabel über eine Verwaltungsoberfläche, Sie müssen also selber keine Dateien bearbeiten oder Kenntnisse des Systems haben.

Ein Plugin hat zudem den Vorteil, dass bestimmte Funktionen so einfach optional nachgerüstet werden können. Für viele Benutzer ist möglicherweise ein Umfrage-Modul interessant, während andere Benutzer damit gar nichts anfangen können. Da liegt es nahe, diese optionale Funktionalität so loszulösen, dass nur diejenigen die Komponente installieren, die sie auch benötigen. Das hält das Grundsystem schlank und macht es einfacher wartbar. Durch die Auslagerung von Code in Plugins können auch kleine Bestandteile des Blogs einzeln aktualisiert werden. Wenn eine neue Version einer Komponente veröffentlicht wird, müssen Sie also nicht direkt das ganze Blogsystem aktualisieren.

Bei Serendipity gibt es zwei verschiedene Arten von Plugins. Seitenleisten-Plugins Seitenleisten-Plugins stellen Inhalte und Funktionen in der Seitenleiste eines Blogs im Frontend dar. Ereignis-Plugins Ereignis-Plugins sind interne Funktionen von Serendipity, die Anpassungen des Kernsystems ermöglichen und sich nicht nur im Frontend, sondern auch im Backend auswirken können. Ein Seitenleisten-Plugin sieht man daher immer an einer festgesetzten Stelle im Frontend, während ein Ereignis-Plugin eher im Hintergrund arbeitet, dafür aber umso mächtiger ist und meist wichtige neue Backendaufgaben bereitstellt.

Nach einem Klick auf Einstellungen: Plugins in der Backend Seitenleiste, sehen Sie die Liste der Seitenleisten- oder Ereignis-Plugins, je nachdem, welche sie zuletzt genutzt haben. Pro Plugin gibt es eine einzelne "schwebende" Inhaltsbox. Die Seitenleisten-Plugins sind in verschiedene Bereiche unterteilt: links, rechts und versteckt. Diese Bereiche entsprechen also der Positionierung des Seitenleisten-Plugins im Frontend, auf der linken oder rechten Seite. Dabei gilt es zu beachten, dass einige Templates möglicherweise nur eine Seitenleiste anbieten, und manchmal sind beide Seitenleisten auch rechts oder links angegliedert. Abhängig vom Template und seinen konfigurierbaren Eigenschaften kann es auch sein, dass hier noch weitere Plugin-Bereiche dargestellt werden, zB. in Sliver.

Der Bereich versteckt ist dabei ein Sonderbereich. Alle Plugins, die dort aufgeführt sind, sind inaktiv gesetzt und werden später im Frontend nicht dargestellt.

Innerhalb der Pluginbox sind folgende Informationen/Einstellungen enthalten:

Drag and Drop Plugin-Reihenfolge verändern Reihenfolge!von Plugins verändern Drag and Drop-Rahmen Jede einzelne Pluginbox kann mittels JavaScript Drag'n'Drop in ihrer Position verändert werden. Das heißt, sowohl die Reihenfolge der Plugins untereinander als auch die Wahl der linken oder rechten Seitenleiste kann bestimmt werden. Dazu klicken Sie mit der Maus auf den Anfassbereich in der linken oberen Ecke jeder Pluginbox (der Cursor verwandelt sich dann in einen Positionierungspfeil), halten die Maus gedrückt und verschieben dann die Box an die gewünschte Position. Dabei wird der jeweilige Bereich, über dem Sie sich befinden, mit einem Rahmen hervorgehoben. Sobald Sie die Maustaste loslassen, wird das Plugin in den gerade hervorgehobenen Bereich eingefügt. Diese Funktionalität wird mittels JavaScript eingebunden. Sollte Ihr Browser dies nicht unterstützen, sehen Sie anstelle der Anfasser für jedes Plugin eine Auswahlbox, mit der Sie angeben, ob das Plugins links, rechts oder versteckt platziert wird. Die Reihenfolge kann in diesem Falle dann über zwei eigenständige Pfeil-Buttons verändert werden. Es ist wichtig, dass Sie nach der Änderung der Positionierung auf den Button Speichern klicken. Erst wenn Sie diesen Button auch anklicken, werden die Änderungen tatsächlich gespeichert. Sollten Sie also einmal nach einer längeren Sortierungsaktion unzufrieden mit dem Ergebnis sein, können Sie die Seite einfach neu laden oder verlassen, und die Änderungen werden verworfen.

Plugins!entfernen Markierungsbox Neben jedem Plugin-Titel ist eine Auswahlbox dargestellt, die angekreuzt werden kann. Um ein oder mehrere Plugins zu löschen, müssen Sie die Boxen der jeweiligen Plugins aktivieren und danach auf den Button Löschen (Markierte Plugins entfernen) klicken.

Plugins!konfigurieren Zahnrad-Symbol Einige Plugins bieten spezielle Konfigurationsoptionen an. Jedes Plugin mit solchen Optionen zeigt ein Zahnrad-Symbol an, auf das Sie klicken können.

Plugin-Titel Der Name eines Plugins wird im Zentrum der Pluginbox angezeigt. Plugins, die eigene Konfigurationseinstellungen anbieten, kann man mit einem Klick auf das Zahnrad-Symbol bearbeiten.

Plugin-Beschreibung In der Plugin-Beschreibung, die sich nach einen Klick auf den angezeigten Pluginnamen als details-HTML Box entfaltet, wird die Funktionalität eines Plugins kurz beschrieben. Dies ist auch diejenige Beschreibung, die auf Spartacus angezeigt wird.

Versionsnummer eines Plugins Plugin-Version Da Plugins öfter aktualisiert werden und mit neuen Versionen Fehler behoben oder neue Funktionen angeboten werden, ist es ab und zu interessant zu erfahren, welche Version eines Plugins man gerade wirklich einsetzt. Diese Versionsnummer wird unterhalb der Plugin-Beschreibung angezeigt.

Plugin-Eigentümer Eigentümer eines Plugins Plugin-Eigentümer Zuletzt gibt ein Auswahlfeld den Eigentümer eines Plugins an. Bei einigen Plugins ist nur der hier festgelegte Eigentümer (oder ein Administrator) autorisiert, Änderungen an der Konfiguration eines Plugins durchzuführen. Ob ein Plugin solche Einschränkungen festlegt, ist dem Plugin selbst überlassen. Das Plugin HTML Klotz ist ein Beispiel hierfür. Diese Einstellung regelt nicht, wer den Inhalt eines Plugins im Frontend sehen darf! Wenn solche Beschränkungen vorgenommen werden sollen, muss das Plugin Seitenleisten ein/ausklappen (siehe Seite sidebarhider) verwendet werden.

Um bestimmte Plugins zu entfernen, markieren Sie diese und klicken auf Markierte Plugins entfernen. Um Änderungen an dem Eigentümer eines Plugins zu speichern, müssen Sie das Plugin markieren und danach auf Speichern klicken. Für Änderungen an der Positionierung oder Reihenfolge eines Plugins klicken Sie einfach nur auf Speichern, eine Auswahl der beteiligten Plugins ist in diesem Fall nicht notwendig.

Plugins!aktivieren Ein neues Seitenleisten-Plugin können Sie installieren, indem Sie den Link Seitenleisten-Plugin installieren benutzen.

Analog zu der Auflistung der Seitenleisten-Plugins werden die Ereignis-Plugins dargestellt. Da diese im Frontend keinem Bereich entsprechen, sind sie nicht weiter unterteilt und gliedern sich nur in Aktiv und Inaktiv. Ein aktives Ereignis-Plugin wird bei jedem Seitenaufruf von Serendipity in den Speicher geladen und ausgeführt. Wenn Sie ein Plugin vorübergehend deaktivieren wollen, können Sie es einfach in den Bereich Inaktiv verschieben.

Reihenfolge!von Ereignis-Plugins Die Reihenfolge von Ereignis-Plugins kann in einigen Situationen wichtig sein. Die Liste dieser Plugins wird vom ersten bis zum letzten in dieser Reihenfolge ausgeführt; dabei kann die Ausgabe des vorigen Plugins miteinbezogen werden. Textformatierungs-Plugins Gerade bei Textformatierungs-Plugins, die gewisse Umformatierungen Ihrer Einträge vornehmen, ist diese Reihenfolge von Interesse. Wenn bspw. ein Textformatierungs-Plugin wie Textformatierung: Smilies ausgeführt wird und danach ein Plugin wie das Textformatierung: Wiki-Markup, dann könnte dies dazu führen, dass die HTML-Formatierung der Smilies durch das Wiki-Markup-Plugin zerstört wird. Richtig wäre es daher, das Wiki-Markup-Plugin als eines der ersten Textformatierungs-Plugins anzuwenden. Bei welchen Fällen Sie auf die Reihenfolge zu achten haben, wird bei der Beschreibung des jeweiligen Plugins in diesem Buch erwähnt.

Ereignis-Plugins können ähnlich wie Seitenleisten-Plugins über Ereignis-Plugin installieren neu hinzugefügt werden.

Fehler bei Plugins

Fehler!Arbeitsspeicher voll Fehler!Plugins werden nicht geladen

Performance

Je länger die Liste der Ereignis-Plugins, desto mehr Arbeitsspeicher benötigt Serendipity auf dem Webserver. So kann es passieren, dass nach der Installation eines neuen Ereignis-Plugins der Arbeitsspeicher ausgereizt ist.

Es kann durchaus passieren, dass zu viele Plugins die fehlerfreie Ausführung des Frontends oder Backends verhindern. In so einem Fall müssen Sie also Ereignis-Plugins löschen oder Ihren Provider bitten, den Arbeitsspeicher (siehe Kapitel memory-limit auf Seite memory-limit) zu vergrößern.

Im Zuge der heutzutage üblichen und flexiblen Kontingent-Containerisierung ist dies dieser Zustand wohl nur noch dann zu erreichen, wenn man es praktisch übertreibt. Deshalb: Nutzen Sie nur so viel Plugins wie unbedingt nötig!

Sollten Sie nicht mehr auf die Plugin-Verwaltungsoberfläche gelangen, können Sie ein Plugin auch entfernen, indem Sie das entsprechende Verzeichnis im plugins-Unterverzeichnis löschen. Sobald Serendipity eine angeforderte Plugin-Datei nicht mehr findet, wird das entsprechende Plugin einfach temporär deaktiviert. Sie werden es dann trotzdem noch in der dann wieder aufrufbaren Plugin-Verwaltung sehen können, dort wird dann jedoch nur eine Meldung wie

    Fehler! serendipity_event_xxx

zu sehen sein. Ein solches Plugin können Sie jedoch wie gewohnt löschen.

Abgesehen von der absichtlichen Löschung eines Plugins kann es auch einmal vorkommen, dass Sie die obige Meldung bei Plugins sehen, die eigentlich fehlerfrei funktionieren sollten. Diese Meldung kann auch angezeigt werden, wenn eine Plugin-Datei für Serendipity nicht lesbar ist oder womöglich fehlerhaft via FTP hochgeladen wurde. Prüfen Sie daher, ob diese Dateien auch dem richtigen Zustand (Dateigröße und Dateirechte) entsprechen.

Fehler!Plugins nach Serverumzug defekt Auch nach einem Serverumzug kann es vorkommen, dass früher funktionierende Plugins plötzlich nicht mehr aufrufbar sind. In diesem Fall finden Sie in der Datenbanktabelle serendipity_plugins eine Auflistung aller aktivierten Plugins inklusive deren Dateipfad. Diesen Pfad müssen Sie möglicherweise auf neue Gegebenheiten anpassen.

Manchmal kann es sein, dass nach der Installation mehrere Instanzen eines Plugins aktiviert wurden. Sie können daher doppelte Plugins leicht wieder aus der Verwaltungsoberfläche löschen.

Wenn Sie eine Plugin-Datei selbständig editieren, kann es passieren, dass Sicherungskopien eines Plugins mit der Dateiendung .bak oder .php~ von Ihrem Editor im jeweiligen Plugin-Verzeichnis gespeichert werden. Diese Dateien können die Plugin-Verwaltung von Serendipity stören und müssen daher unbedingt gelöscht werden. Auch ganze Kopien eines Verzeichnisses unter einem zweiten Namen dürfen niemals im plugins-Unterverzeichnis gespeichert werden, verschieben Sie derartige Sicherheitskopien immer an einen von Serendipity unabhängigen Speicherort! Es ist aber alles eine Frage der Reihenfolge. Ein vorangestelltes _ zum Beispiel, erlaubt es aber dennoch ein Plugin vorübergehend aus der Liste und der Bearbeitung zu nehmen.

Neue Plugins installieren

Plugins!installieren Plugins!aktivieren

Wenn Sie ein neues Ereignis- oder Seitenleisten-Plugin installieren, wird Serendipity Ihnen die verfügbaren Plugins auf einer Plugin-Übersicht darstellen. Dort wird jedes Plugin, das im Serendipity-Verzeichnis vorhanden ist, aufgelistet. Auch bereits installierte Plugins werden daher an dieser Stelle dargestellt, da es einige Arten von Plugins gibt, die mehrfach installiert (genauer: instanziert) werden können. Plugin-Instanz

Serendipity wird mit einer kleinen Auswahl an verfübaren Plugins ausgeliefert, die nicht alle von Anfang an aktiviert sind. Sollten Sie weitere Plugins benötigen, können Sie diese entweder vom Server https://ophian.github.io/plugins/ manuell herunterladen [*] Github kann momentan keine Plugins einzeln als ZIP verpackt bereitstellen. Sie sind aber sehr einfach über diese URL https://github.com/ophian/additional_plugins aufrufbar und können entweder komplett als ZIP Datei heruntergeladen oder in Einzelteilen per einzelner RAW Datei gespeichert werden., automatisch mittels des Spartacus-Plugins installieren oder ein selbst entwickeltes Plugin auswählen. Siehe Serendipity Styx und sein eigenes darauf abgestimmtes Plugin-Repository. Wenn Sie aus dem Internet ein Serendipity-Plugin als ZIP-Datei heruntergeladen haben, müssen Sie dieses in die Unterverzeichnisstruktur von plugins entpacken. Serendipity kann mit der ZIP-Datei selber nichts anfangen, und auch wenn eine Plugin-Datei versehentlich nur ins Stammverzeichnis kopiert werden sollte, kann dies dazu führen, dass es später in der Plugin-Übersicht nicht aufgeführt wird.

Plugins müssen also in zwei Schritten für Serendipity verfügbar gemacht werden. Zum einen muss ein Plugin in einem Unterverzeichnis des plugins-Verzeichnisses gespeichert werden, damit Serendipity das Plugin überhaupt sehen kann. Im zweiten Schritt muss dann das hochgeladene Plugin für Serendipity über die Plugin-Verwaltung aktiviert werden.

In der Plugin-Übersicht für die Installation sehen Sie pro Zeile jeweils einen Plugin-Namen. Die Plugins sind unterteilt in verschiedene Gruppen, die Sie speziell auch über das Auswahlfeld Filter am Seitenanfang anwählen können.

Unter jedem Plugin-Namen wird eine Beschreibung des Plugins angezeigt, sowie der Autor und die Versionsnummer des Plugins. Unterhalb der Beschreibung sehen Sie entweder einen Button zur Installation des gewünschten Plugins oder die Information, dass ein Plugin bereits installiert ist.

Wenn Sie auf den Installations-Button klicken, werden Sie ggf. direkt zur Konfiguration des gerade gewählten Plugins weitergeleitet. Dort werden Ihnen die Standardoptionen bereits vorausgefüllt, Sie müssen also nicht sofort die vollständige Konfiguration aufrufen, sondern können die Konfiguration auch jederzeit später vervollständigen. Nach diesem Vorgang ist ein Plugin installiert und kann wie gewohnt über den Menüpunkt Plugins verschoben und konfiguriert werden.

SPARTACUS

spartacus Spartacus

SPARTACUS steht für das Serendipity Plugin Access Repository Tool And Customization/Unification System. Trotz des zugegebenermaßen konstruierten Akronyms wird deutlich, dass Spartacus ein System ist, das Plugins und Templates zur Verfügung stellt.

Spartacus besteht aus zwei Komponenten: Zum einen der zentrale Server https://ophian.github.io/plugins, auf dem sämtliche verfügbaren offiziellen Plugins vorhanden sind und auch für Nicht-Serendipity-Benutzer übersichtlich dargestellt werden. Zum anderen wird bei Serendipity ein gleichnamiges Ereignis-Plugin mitgeliefert, das direkt auf diesen zentralen Server zugreifen und Plugins herunterladen kann. Das Plugin stellt einige Anforderungen an den Server, auf dem Sie Serendipity installiert haben:

Fehler!Spartacus

• Der Webserver darf nicht durch eine Firewall blockiert werden. Er muss Zugriffe auf github.com, sourceforge.net und spartacus.s9y.org auf Port 80 ermöglichen.
• Die PHP-Konfiguration muss den Zugriff auf Netzwerk-Sockets erlauben.
• Damit Serendipity Dateien selbständig herunterladen und auf dem Server speichern kann, muss Schreibzugriff auf die Verzeichnisse plugins und templates gewährt werden.

Auf manchen Webservern schlägt die erste Bedingung fehl, was dazu führt, dass keine PHP-Anwendung nach draußen zugreifen kann. Gerade bei großen Providern ist aus Sicherheitsgründen ein derartiger Zugriff nicht gestattet. In so einem Fall können Sie Spartacus also leider nicht einsetzen und müssen die Plugins manuell vom Server https://ophian.github.io/plugins/ bzw der Weiterleitung auf GitHub beziehen. Seit langem besteht auch behelfsweise die Möglichkeit, Dateien direkt über Ihren FTP-Zugang auf den Webserver hochzuladen - dadurch werden die PHP-Beschränkungen umgangen. Die Zugangsdaten müssen Sie in der Konfiguration des Spartacus-Plugins festlegen.

Der Autor hat diese Einschränkungen in den letzten 10 Jahren aber nicht mehr erlebt, so dass Serendipity und Spartacus heutzutage auf nahezu allen Systemen out-of-the-box funktionieren sollte!

Wenn das Spartacus-Plugin auf solchen blockierten Servern installiert wird, kann das zu einer Reihe von Problemen führen: von der vollständigen Fehlfunktion der Plugin-Installationsoberfläche bis hin zu weißen Seiten beim Klick auf ein zu installierendes Plugin.

Sollten Sie also beim Installieren von Plugins eine leere Seite erhalten, oder Ihr Browser gibt an, die Datei serendipity_admin.php müsse lokal auf der Festplatte gespeichert werden, oder die Installation eines Plugins führt zu langen Ladezeiten, dann können Sie sich sicher sein, dass Spartacus auf Ihrem Server nicht gestartet werden kann. Eine Fehlermeldung, die in diesem Zusammenhang auch auftreten kann, ist:

Access denied!in PEAR.php at line 848 Fehler!Access denied in PEAR.php at line 848

    Access Denied in /var/www/example.com/serendipity/bundled-libs/PEAR.php at line 848

Dies ist eine generische Fehlermeldung, die bedeutet, dass die für den Download zuständige PEAR-Komponente keine Verbindung zu einem Server aufnehmen konnte.

Proxy-Server Möglicherweise kann Ihr Webserver auf fremde Server zugreifen, wenn Sie einen Proxy-Server benutzen. Um einen Proxy für Spartacus einzustellen, bietet das Plugin Trackbacks kontrollieren (siehe Seite trackbacks) eine Möglichkeit, den Proxy-Server zu konfigurieren. Der dort eingestellte Proxy-Server gilt dann für alle Serendipity-Funktionalitäten und aktuellen Plugins.

Wenn Sie ein älteres Plugin nutzen, das sich nicht von der im Trackback-Plugin konfigurierten Proxy-Einstellung beeindrucken lässt, können Sie notfalls auch manuell in der Datei bundled-libs/HTTP/Request2.php in Zeile 136 folgende Variablen setzen:

    $this->_proxy_host = null;

    $this->_proxy_port = null;

    $this->_proxy_user = null;

    $this->_proxy_pass = null;

Beachten Sie, dass diese Änderung einer zentralen Bibliothek nicht gerade die feine englische Art ist, da die lokale Bibliothek auf einigen Servern durch eine zentrale PEAR-Bibliothek übergangen werden könnte.

In älteren Serendipity Releases war das Spartacus-Plugin aufgrund der aufgeführten potenziellen Probleme standardmäßig nach der Installation nicht aktiviert. Sie mussten es daher über den Menüpunkt Klicken Sie hier, um Ereignis-Plugin zu installieren erst auswählen und aktivieren. In der Konfiguration des Spartacus-Plugins konnten und können einige wichtige Optionen festgelegt werden, siehe Seite Spartacus.

Kann Spartacus auf dem Server eingesetzt werden, fügt es sich nahtlos in die Serendipity-Oberfläche ein. Wenn Sie sich mit aktiviertem Plugin dann die Plugin-Verwaltung zur Installation eines neuen Plugins ansehen, wird das Plugin automatisch aus dem Internet eine aktuelle Liste der verfügbaren Plugins laden und Ihnen darstellen. Bei Klick auf ein Plugin wird Spartacus automatisch alle benötigten Dateien herunterladen und Sie über diesen Download benachrichtigen.

Sollte der Download eines Plugins mittels Spartacus einmal fehlschlagen, können Sie über FTP das entsprechende Plugin-Verzeichnis einfach komplett löschen und die Neuinstallation probieren.

Aktualisierte Plugins anzeigen Auch die Aktualisierung von Plugins kann mittels Spartacus komfortabel vorgenommen werden. Anstatt über die Spartacus-Webseite nach neuen Versionen zu suchen, können Sie über die Plugin-Verwaltung den Button Plugins updaten anklicken, um Spartcus nach updatefähigen Seitenleisten- und Ereignis-Plugins zu durchsuchen. Dort werden dann alle aktualisierbaren Plugins aufgelistet und können auf den einzeln oder oder automatisch eingespielt werden. Das CKEditor Plus Plugin sollte als bisher einziges Plugin immer nur einzeln aktualisiert werden, wenn es ein neues und aktualisiertes Zip mitbringt.

Leider gibt es bei einem Upgrade in der Plugin-Oberfläche nicht immer einen Hinweis, welche Dinge sich bei einem Plugin verändert haben. Als Faustregel gilt, dass nur große Versionssprünge in einem Plugin tiefgreifende Änderungen mit sich bringen. Die meisten Updates sind Bugfixes oder kleinere neue Features. Da Plugin-Entwickler oft faule Leute sind, ist die Dokumentation der Updates jedoch meist dürftig, und Sie müssen sich die Aktualisierungen manuell in der Spartacus-Versionsverwaltung ansehen.[*] https://github.com/ophian/additional_plugins Details zu dieser Webseite finden Sie im Kapitel sourcecodeverwaltung ab Seite sourcecodeverwaltung.

Auch bei Plugins werden Updates immer unter großer Beachtung der Rückwärts-Kompatibilität durchgeführt. Sie müssen also nicht fürchten, dass sich bei einem Update eines Plugins etwas für Sie ändern könnte oder zu Bruch geht - diese Gefahr ist relativ gering. Lediglich wenn Sie selbst Änderungen an den Plugin-Dateien gemacht haben, müssen Sie diese sichern und nach dem Update erneut einfügen. Die Konfigurationsoptionen Ihrer Plugins bleiben bei einer Aktualisierung weiterhin bestehen.

Wenn Sie mehrere Plugins auf einmal aktualisieren wollen, müssen Sie sie diese mittels des rechten Mausbuttons in neue Tabs installieren oder jenen bereits genannten automatischen Einspieler nutzen. Achtung: Dies kann, je nach Menge und zur Verfügung gestellter Kapazität des Servers durchaus zu Fehlern führen, wenn die Grenzen der zugestandenen Auslastung erreicht sind. Besser und sicherer ist es jedoch, jedes Plugin einzeln und nacheinander upzudaten, auch, da es wie beim CKEditor Plus-Plugin mittlerweile durchaus Plugins geben kann, die augenblicklich für wichtige Upgrade-Aufgaben in ihre eigenen Konfigurationsseiten zurückfallen möchten.

Oberhalb jeder Übersichtsseite werden Sie einige Meldungen von Spartacus sehen, die Sie darüber informieren, dass gerade eine Übersichtsdatei oder Weiteres aus dem Internet geladen wird. Diese Meldungen helfen Ihnen, im Fall von Zugriffsproblemen die Schreibrechte zu prüfen.

Die XML-Dateien, die Spartacus herunterlädt, werden in dem temporären Verzeichnis templates_c gespeichert. Damit das Plugin nicht bei jedem Zugriff auf Ihre Plugin-Verwaltung diese Dateien neu lädt, wird Spartacus die Dateien zwischenspeichern und nur alle 12 Stunden auf Aktualisierung prüfen. Aufgrund dieser Zwischenspeicherung kann es also passieren, dass neue Plugins im Spartacus-Archiv erst mit maximal 12 Stunden Verzögerung dargestellt werden. Wenn Sie unbedingt forcieren wollen, dass Spartacus den Zwischenspeicher leert, dann können Sie über die Plugin-Konfiguration von Spartacus einfach auf den Button Speichern klicken. Dadurch werden die temporären Dateien alle gelöscht. Auf Wunsch könnten Sie die Dateien natürlich auch mit einem FTP-Programm löschen.

Alle Inhalte des Spartacus-Systems können Sie auch ohne Serendipity unter https://ophian.github.io/plugins/ ansehen und dort bzw auf GitHub Plugins als ZIP-Datei manuell herunterladen (siehe vorherige Fußnote).

Die Plugins von Spartacus werden, ebenso wie Serendipity selbst, öffentlich über ein Versionskontrollsystem gepflegt. Alle vorgenommenen Änderungen werden darin protokolliert. Details finden Sie in Kapitel sourcecodeverwaltung auf Seite sourcecodeverwaltung.

Konfiguration

Konfiguration Backend!Konfiguration Installation!fortgeschrittener Modus

Hinter Konfiguration finden Sie alle Einstellungen des Blogs, die Sie auch bei der Installation im Fortgeschrittenen-Modus festlegen können.

Der Konfigurationsbereich ist dabei in mehrere Bereiche untergliedert, um etwas Struktur in die Oberfläche zu bringen. Jeder Bereich kann dabei über den Zeilenlangen-Button aus- und eingeklappt werden. Um alle Bereiche auf einmal auszuklappen, klicken Sie auf den obersten Button, um alle Optionen gemeinsam ein-/ausblenden.

Datenbankeinstellungen

Konfiguration!Datenbankeinstellungen

Die Datenbankeinstellungen bestimmen den Zugang zur zentralen Serendipity-Datenbank und deren möglichen Optionen.

Hier müssen immer die aktuell gültigen Zugangsparameter zur Datenbank eingetragen werden. Diese Datenbankinformationen werden zusätzlich in der Datei serendipity_config_local.inc.php gespeichert. Wenn sich also einmal die Zugangsdaten ändern, könnte es sein, dass Sie manuell zuerst diese Datei (siehe auch Kapitel Installation erneut ausführen auf Seite Installation erneut ausführen) überarbeiten müssen, bevor Sie sich wieder ins Backend einloggen können.

 

Datenbank!Typ Konfiguration!Datenbanktyp

Datenbanktyp In diesem Auswahlfeld sind die verfügbaren Datenbanktypen aufgeführt, zu denen Serendipity Verbindung aufnehmen kann. Die Liste der verfügbaren Typen richtet sich nach der Konfiguration Ihres PHP-Servers. PHP muss für jeden Datenbankserver eine sogenannte Client-Libary Client-Library eingebunden haben, um auf die Funktionen des jeweiligen Datenbanktyps zugreifen zu können. Wenn Sie sich sicher sind, dass auf Ihrem Server ein MySQL-Server läuft, muss das nicht automatisch bedeuten, dass PHP darauf auch zugreifen kann. Zahlreiche Linux-Distributionen bieten die Client-Libraries in eigenen Paketen an, bei Debian beispielsweise php-mysql. MySQL mysqli sqlite postgres sqlite3 PDO postgres PDO-sqlite3 Serendipity kann auf folgende Client-Libraries zugreifen: mysqli (ab MySQL 4), postgres (PostgreSQL), PDO postgres (spezielle PHP5-Variante der PostgreSQL-Library), sqlite, sqlite3 und PDO-sqlite3. SQLite ist ein Sonderfall einer Datenbank, da es ohne einen Datenbankserver auskommen kann. Ab PHP5 ist SQLite fester Bestandteil von PHP und somit immer verfügbar. Die Vorteile von SQLite sind eine sehr hohe Performance beim Lesen von Datenbanken und die Erstellung einer einzelnen Datenbankdatei, von der man sehr leicht ein Backup aufnehmen kann. Der Nachteil ist, dass SQLite nicht alle Datenbank-Operationen mittels SQL-Syntax unterstützt und gerade bei komplexeren Datenbankabfragen doch eher langsam wird. Am besten getestet ist Serendipity bei Verwendung der MySQL-Datenbank. Die Kernfunktionen von Serendipity laufen auch problemlos mit allen anderen Datenbanktypen, aber einige Plugins könnten spezielle MySQL-Funktionen einsetzen. Wenn Sie den Datenbanktyp bei einer aktiven Serendipity-Installation ändern, richtet Serendipity keine neue Datenbank auf dem gewünschten System ein! Alle Datenbankeinstellungen richten sich nach dem Ist-Zustand, Serendipity geht also davon aus, dass Sie mit diesen Optionen die aktuellen Gegebenheiten abbilden, und nicht, wie Sie es in Zukunft gerne hätten. Um Serendipity auf eine andere Datenbank umzustellen, müssen Sie die Migration mithilfe der Dokumentation des Datenbankservers leider selbständig vornehmen.

Konfiguration!Datenbankservername@Datenbank-Servername Datenbank Servername Der Servername der Datenbank kann entweder eine IP-Adresse (zB. 127.0.0.1), ein lokaler Hostname (localhost) oder ein Internet-Hostname (www.example.com) sein. Wird für SQLite nicht benötigt.

Konfiguration!Datenbankusername@Datenbank-Username Datenbank Username Der Benutzername für den Datenbankserver. Wird für SQLite nicht benötigt.

Konfiguration!Datenbankpasswort Datenbank Passwort Das Passwort für den Benutzer des Datenbankservers. Wird für SQLite nicht benötigt.

Konfiguration!Datenbankname Datenbankname Der Name der Datenbank, in der Serendipity installiert wurde. Bei Verwendung von SQLite wird hier der Dateiname der .db-Datenbank gespeichert.

Konfiguration!Datenbankpräfix Datenbank-Präfix Datenbank-Präfix Jede Serendipity-Tabelle in einer Datenbank muss einen vordefinierten Präfix besitzen, damit sich die Tabellennamen von möglicherweise gleichnamigen Tabellen anderer Anwendungen in derselben Datenbank abheben können. Standardmäßig wird hier styx_ eingetragen. Wenn Sie den Tabellenpräfix nachträglich ändern, müssen Sie die bestehenden Tabellen manuell in der Datenbank umbenennen, Serendipity führt dies nicht selbständig aus.

Konfiguration!persistente Verbindungen nutzen Persistente Verbindungen Persistente Verbindungen nutzen Bei jedem Aufruf einer Seite von Serendipity wird eine Verbindung zur Datenbank aufgebaut. Im "Lebenszyklus" einer PHP-Anwendung wird diese Datenbankverbindung nach der Ausführung automatisch wieder geschlossen. Um etwas Zeit zu sparen, können PHP-Anwendungen sogenannte Persistent Connections (Ständige Verbindungen) nutzen. Diese Option wird in der PHP-Dokumentation [*] https://www.php.net/manual/de/features.persistent-connections.php ausführlicher beschrieben und bewirkt - kurz gesagt -, dass mehrere PHP-Aufrufe dieselbe Datenbankverbindung nutzen können, ohne diese ständig neu auf- und abzubauen. Generell birgt diese Option einige Gefahren, da bei Datenbankproblemen eine Verbindung nicht mehr automatisch neu aufgebaut wird und möglicherweise viele Zugriffe auf die Webseite das Ressourcenlimit an Verbindungen schneller erschöpfen könnten. Daher sollte diese Option nur dann aktiviert werden, wenn Sie sich mit ihren Vor- und Nachteilen auskennen.

Konfiguration!Datenbankzeichensatz@Datenbank-Zeichensatzkonvertierung aktivieren Datenbank!Zeichensatzkonvertierung Datenbank-Zeichensatzkonvertierung aktivieren Diese Option gilt nur für MySQL-Datenbanktypen und bringt Serendipity dazu, beim Verbinden mit der Datenbank anzugeben, welchen Zeichensatz das Blog benutzt. Gerade bei den damals aktuellen MySQL-Versionen ab 4.1 konnte die falsche Verwendung von Zeichensätzen zu Fehlern führen, siehe Kapitel Falsche Anzeige von Datumsangaben oder Sonderzeichen ab Seite Falsche Anzeige von Datumsangaben oder Sonderzeichen. Sonderzeichen Fehler!Sonderzeichen Sollte Ihr Blog bei der Darstellung von Sonderzeichen Probleme machen, könnte die Umstellung dieser Option Abhilfe schaffen. Ansonsten ist das aktivieren der Datenbank-Zeichensatzkonvertierung heutzutage aber die empfohlene Einstellung.

Pfade

Konfiguration!Pfade

Im Bereich Pfade tragen Sie einige Optionen zur Festlegung der URLs ein. Bitte beachten Sie, dass Sie an dieser Stelle die derzeit gültigen Pfade eintragen müssen, die mit Ihrer Installation übereinstimmen.

Wenn Sie eine Serendipity-Installation auf dem Server verschieben wollen, müssen Sie dies vorher manuell (mittels FTP-Programm oder Ähnlichem) erledigen und nachträglich die geänderten Pfade an dieser Stelle eintragen.

Fehler: Seite nicht gefunden Seite nicht gefunden Fehler!falsche Pfadangaben Fehler!Seite nicht gefunden Bitte achten Sie darauf, dass alle Pfadangaben immer mit einem Schrägstrich enden müssen. Etwaige fehlerhaft eingestellte Pfade können dazu führen, dass Links in Ihrem Blog nicht aufgerufen werden können und zu leeren Seiten führen. Auch wenn Ihre Seite unformatiert aussieht und keine Grafiken darstellt, kann das seine Ursache in einem falsch konfigurierten Pfad haben.

Konfiguration!voller Pfad Pfad Backslash Trailing Slash Document Root Schrägstrich

Voller Pfad Diese Option enthält den vollständigen Pfad der Serendipity-Installation auf dem Server. Dieser Pfad entspricht also dem eigentlichen Dateisystem (zB. /var/www/example.com/serendipity/), und nicht dem Schema der URL (/serendipity/). Bitte stellen Sie sicher, dass der Pfad immer einfache Schrägstriche (/) verwendet und nicht den Backslash (\). Auf Windows-Systemen können Sie den Backslash einfach mit einem normalen Schrägstrich ersetzen, und lassen Sie das Laufwerk (C:/) am Anfang weg.[*] Den Laufwerksbuchstaben bräuchten Sie nur, wenn Ihr DocumentRoot nicht auf demselben Laufwerk liegen würde wie das Verzeichnis von Serendipity. Da Serendipity aber immer innerhalb des DocumentRoot liegen muss, kann dieser Fall effektiv nicht eintreten. Wenn möglich, sollten Sonderzeichen in den Verzeichnispfaden vermieden werden, und der Pfad muss immer mit einem Schrägstrich enden.

Konfiguration!Upload-Pfad Upload-Pfad Upload-Pfad Unterhalb des im Voller Pfad eingetragenen Verzeichnisses befindet sich der Ordner, in dem die Dateien der Mediathek gespeichert werden sollen (üblicherweise uploads). Wenn Sie Ihre Mediendateien in einem anderen Verzeichnis speichern wollen, können Sie den gewünschten Speicherort relativ zum vollen Pfad hier eintragen. Sollte das Upload-Verzeichnis außerhalb des Serendipity-Verzeichnisses liegen, dürfen Sie hier nicht einfach einen absoluten Pfad eintragen, sondern müssen mittels ../../ die jeweiligen Verzeichnisebenen höher wechseln. Wenn Sie also Serendipity im Verzeichnis /var/www/example.com/serendipity/ gespeichert haben und Ihr Upload-Verzeichnis sich in /var/uploads/ befindet, müssen Sie für den Upload-Pfad ../../../uploads/ eintragen. Wenn Sie dieses Verzeichnis umkonfigurieren, müssen Sie bereits hochgeladene Dateien manuell in das neue Verzeichnis verschieben.

Konfiguration!relativer HTTP-Pfad Relativer HTTP-Pfad Relativer HTTP-Pfad Der Relative HTTP-Pfad gibt die Pfadkomponente der URL an, in der Serendipity installiert wurde. Dabei muss der HTTP-Pfad sämtliche Verzeichnisnamen hinter dem Domain-Namen enthalten. Wäre Serendipity unter http://example.com/~john/serendipity/ installiert, müsste der relative HTTP-Pfad den Eintrag /~john/serendipity/ enthalten.

Konfiguration!relativer Template-Pfad Relativer Template-Pfad Relativer Template-Pfad Um Grafiken und Stylesheets der Templates anzuzeigen, muss Serendipity auf den Stammordner zugreifen, in dem sich die Templates befinden. Der Relative Template-Pfad gibt dabei die notwendige Verzeichnisstruktur (relativ zum HTTP-Pfad) an. Sie sollten diese Option möglichst nicht ändern, da an zahlreichen Stellen in Serendipity der Template-Pfad templates/ fest vorgesehen ist. Eine Änderung macht nur Sinn, wenn Sie mit symbolischen Links auf dem Webserver arbeiten, die unterschiedliche Pfadangaben benötigen.

Konfiguration!relativer Upload-Pfad Relativer Upload-Pfad Relativer Upload-Pfad Wenn Sie den Upload-Pfad wie im Beispiel oben ändern, wird sich auch dessen URL ändern. Die Option Relativer Upload-Pfad gibt dabei den Verzeichnisnamen des Speicherorts der Mediendateien an, relativ zur Stamm-URL. symbolischer Link Symlink Sollte sich das Serendipity-Verzeichnis auf einem anderen VirtualHost oder einer ganz abweichenden Pfad-Struktur befinden, kann dies nur funktionieren, wenn Sie einen symbolischen Link [*] Symbolische Links sind häufig auf Linux-Servern zu finden und ermöglichen einen Datei- oder Verzeichnisverweis zu völlig anderen Verzeichnissen. Symbolische Links können nur mit direktem Zugriff zum Dateisystem eines Servers erstellt werden und sind daher meist Administratoren bzw. Shell-Benutzern vorbehalten. zum Ziel-Upload-Verzeichnis erstellen.

Konfiguration!URL zum Blog URL!zum Blog URL zum Blog Im Eingabefeld URL zum Blog tragen Sie die vollständige URL (mit Protokoll und Domainnamen) ein. Dabei können Sie, falls verfügbar, auch gerne https:// benutzen, wenn Ihr Server dies anbietet. Fehler!verschiedene URLs für das Blog Sollte Ihr Blog unter mehreren URLs erreichbar sein [*] zB. http://example.com/serendipity/, https://www.example.com/serendipity/ und http://blog.example.com/serendipity/, dann müssen Sie lediglich eine dieser URLs hier konfigurieren und die Option HTTP-Hostnamen automatisch erkennen aktivieren (siehe unten). Auch hier gilt: Wenn Sie Serendipity auf eine andere URL verschieben möchten, müssen Sie die Verzeichnisse und Dateien manuell verschieben und können erst danach diese Konfigurationsoption den neuen Gegebenheiten anpassen.

HTTP-Hostname Fehler!HTTP-Hostname Konfiguration!HTTP-Hostnamen automatisch erkennen Fehler!verschiedene URLs für das Blog HTTP-Hostname HTTP-Hostnamen automatisch erkennen Wenn Ihr Blog unter mehreren URLs erreichbar ist, können Sie Serendipity zwar unter allen drei URLs aufrufen, aber alle Verweise innerhalb des Blogs werden ausschließlich auf die in URL zum Blog konfigurierte URL verweisen. Wenn Sie gerne möchten, dass für jeden Besucher die URL weiterbenutzt wird, die er zum Aufrufen verwendet hat, dann können Sie die Option HTTP-Hostnamen automatisch erkennen aktivieren. Diese Funktion kann jedoch nur dann korrekt funktionieren, wenn sich die Pfadkomponente der URL niemals ändert. Sollte Ihr Blog aber unter den URLs http://example.com/serendipity/ und auch http://serendipity.example.com/ verfügbar sein, dann wäre dies nicht der Fall. In so einem Fall können Sie nur eine der beiden URLs für den korrekten Betrieb von Serendipity wählen. Mögliche Lösungen dieses Problems finden Sie im Kapitel Weiterleitung auf Seite Weiterleitung.

Index-Datei Konfiguration!Index-Datei index-Datei Index-Datei Diese Option legt fest, welche zentrale Datei Serendipity benutzt, um jeden Seitenaufruf dorthin umzulenken. Üblicherweise sollten Sie diese Option nur ändern, wenn Sie Serendipity in einer anderen Webseite einbetten (siehe Option Eingebettete Nutzung von Serendipity aktivieren auf Seite embedding). htaccess@.htaccess In der Datei .htaccess wird die hier konfigurierte Datei als ErrorDocument und DirectoryIndex eingebunden. Sollten Sie einmal eine eigene Datei hier angeben, müssen Sie in dieser Datei sicherstellen, dass das Serendipity-Framework über index.php eingebunden wird. Sie sollten die Option nicht zweckentfremden, um eine eigene HTML-Seite als Startseite für Serendipity festzulegen. Dies würde dazu führen, dass auch andere URLs von Serendipity nicht mehr zugänglich wären. Eine individuelle Startseite für Serendipity können Sie mittels des Plugins Statische Seiten einstellen, siehe Kapitel staticpage ab Seite staticpage.

Permalinks

permalinkconfig Permalinks Konfiguration!Permalink-S@Permalinks

Sämtliche Permalinks [*] Permalinks sind sprechende URLs (siehe Seite urlformung), die im Frontend eindeutig zu den jeweiligen Funktionalitäten führen. können im gleichnamigen Konfigurationsbereich eingestellt werden.

Fehler!Permalinks Bei den Permalinks ist es sehr wichtig, dass Sie genau wissen, in welchem Rahmen die Pfade verändert werden können. Es ist bei jedem Permalink wichtig, dass ein festes Verzeichnis-Präfix (wie archives, categories und andere) für jeden Permalink-Typen definiert wird, damit Serendipity beim Aufruf einer URL erkennen kann, welche Unterseite angefordert wird. Sie können also nicht einfach einen Pfadteil weglassen und Eintrags-URLs ohne vorangestellten Pfad konfigurieren, da Serendipity dann keine Pfad-Zuordnung treffen kann.

Jeder konfigurierte Pfad muss exakt in der Permalink-Struktur übernommen werden, Sie können also Pfad zu den Einträgen nicht auf eintraege setzen und dann für die Permalink-Struktur artikel/%id%-%title%.html einsetzen. In beiden Fällen müssen Sie entweder eintraege oder artikel benutzen. Vermeiden Sie möglichst Sonderzeichen (also auch Leerzeichen) in der URL.

Ein Hinweis noch zu dem Parameter %id%, den Sie bei mehreren Permalinks aufgeführt sehen. Obwohl dies später im Frontend als sprechende URL möglicherweise nicht sexy aussieht, birgt die Verwendung von %id% einen großen Performancevorteil. Denn sobald diese ID enthalten ist, kann Serendipity ohne weitere Datenbankabfrage herausfinden, welche Inhalte es anzeigen muss.

Bei der Umstellung von Permalinks ist darauf zu achten, dass dadurch die vorher gültigen URLs nicht mehr aktiv sind! Sollte eine Suchmaschine Ihre Seiten also bereits indiziert haben, kann eine Umstellung der Permalinks bedeuten, dass die Suchmaschine sämtliche Ihrer Seiten aus dem Index wirft und neu bewerten muss. Legen Sie sich daher möglichst früh auf Ihr gewünschtes URL-Muster fest.

Die Seiten, die sich hinter den jeweiligen Permalinks befinden, sind ausführlich im Kapitel Permalinks-Frontend ab Seite Permalinks-Frontend beschrieben.

Konfiguration!Permalink-Struktur!für Artikel-URLs Permalink-Struktur für die Artikel-URLs Hier wird die Struktur des Permalinks eingetragen, die beim Aufrufen eines einzelnen Artikels verwendet wird. Platzhalter dienen jeweils dazu, dynamische Teile in die URL zu übernehmen: %id% für die ID eines Artikels. %title% für den Titel eines Artikels. %day% für den Tag, an dem der Artikel verfasst wurde. %month% für den Monat, in dem der Artikel verfasst wurde. %year% für das Jahr, in dem der Artikel verfasst wurde. Diese (und auch alle folgenden) Permalink-Strukturen können weitere beliebige Pfadkomponenten enthalten.

Konfiguration!Permalink-Struktur!für Autoren-URLs Permalink-Struktur für Autoren-URLs Für die Darstellung der Einträge eines Autors wird dieser Permalink verwendet. Folgende Variablen sind verfügbar: %id% für die ID eines Autors. %realname% für den Benutzernamen eines Autors, wie er üblicherweise bei Artikeln angezeigt wird. %username% für den Login-Namen eines Autors. %email% für die E-Mail-Adresse eines Autors.

Konfiguration!Permalink-Struktur!für Kategorie-URLs Permalink-Struktur für Kategorie-URLs Dieser Permalink stellt Einträge pro Kategorie dar. Verfügbare Variablen sind: %id% für die ID einer Kategorie. %name% für den Namen einer Kategorie. %description% für die Beschreibung einer Kategorie (Vorsicht bei langen URLs durch lange Beschreibungen!). %email% für die E-Mail-Adresse eines Autors.

Konfiguration!Permalink-Struktur!für RSS-Kategorien-Feed-URLs Permalink-Struktur für RSS-Kategorien-Feed URLs Die Artikel einer Kategorie für einen RSS-Feed können über diese konfigurierte URL aufgerufen werden. Es sind dieselben Variablen wie für den normalen Kategorie-Permalink verfügbar.

Konfiguration!Permalink-Struktur!für RSS-Autoren-Feed-URLs Permalink-Struktur für RSS-Autoren-Feed URLs Die Artikel eines Autors für einen RSS-Feed werden in diesem Permalink festgehalten. Es gelten dieselben Variablen wie für die normalen Autoren-Permalinks.

Konfiguration!Pfad!zu den Einträgen Pfad zu den Einträgen Der erste Verzeichnisname für alle Artikelübersichten, standardmäßig archives.

Konfiguration!Pfad!zu den Archiven Pfad zu den Archiven Der Verzeichnisname für die Archivübersicht, in der die Artikel nur chronologisch dem jeweiligen Monat zugeordnet sind.

Konfiguration!Pfad!zu den Kategorien Pfad zu den Kategorien Der Verzeichnisname für die Artikelübersicht einer Kategorie.

Konfiguration!Pfad!zu den Autoren Pfad zu den Autoren Der Verzeichnisname für die Artikelübersicht eines Autors.

Konfiguration!Pfad!zum Abbestellen/Löschen/Bewilligen von Kommentaren Pfad zum Abbestellen/Löschen/Bewilligen von Kommentaren Wenn Sie als Autor oder Administrator über den Eingang eines neuen Kommentars per E-Mail benachrichtigt werden, können Sie innerhalb der E-Mail auf Links klicken, die den Kommentar freischalten oder löschen. Für Personen, die neue Kommentare bei einem Artikel abonniert haben, gibt es zusätzlich einen Link, der dieses Abonnement wieder aufhebt. Alle drei Pfadvariablen können über diese Konfigurationsfelder angepasst werden.

Konfiguration!Pfad!zu den RSS-Feeds Pfad zu den RSS-Feeds Der Verzeichnisname für alle RSS-Feeds.

Konfiguration!Pfad!zu einem externen Plugin Pfad zu einem externen Plugin Ereignis-Plugins können eigenständige, neue Unterseiten in Ihrem Blog zur Verfügung stellen. Diese Unterseiten können unabhängig vom Serendipity-Layout von einem Plugin ausgegeben werden; unter anderem werden die Anti-Spam-Grafiken vom Spamblock-Plugin derart ausgegeben. Dafür benutzen die Plugins das Unterverzeichnis plugin. Sie sollten dieses Verzeichnis möglichst nicht ändern, da es mehrere Plugins gibt, die immer fest auf das Verzeichnis plugin zugreifen und möglicherweise nicht mehr funktionieren, wenn Sie den Verzeichnisnamen ändern!

Konfiguration!Pfad!zur Administration Pfad zur Administration Der Pfad, den Sie aufrufen, um das Backend (die Administrationsoberfläche) hervorzubringen.

Konfiguration!Pfad!zur Suche Pfad zur Suche Der Pfad zur Suche nach Begriffen in Artikeltexten.

Konfiguration!Pfad!zu Kommentaren Pfad zu Kommentaren Der Pfad zur Übersicht von Kommentaren zu Artikeln.

Generelle Einstellungen

Konfiguration!Generelle Einstellungen

Weitere globale Einstellungen befinden sich im Bereich Generelle Einstellungen.

Konfiguration!Blog-Titel Blog-Titel Der Blog-Titel legt die Überschrift Ihres Blogs fest. Hier können Sie auch Sonderzeichen einfügen, jedoch keinen HTML-Code oder Grafiken. Eine derartige Sonderdarstellung müssen Sie über Anpassungen in Ihrem Template vornehmen (siehe Seite templatefiles).

Konfiguration!Blog-Beschreibung Blog-Beschreibung Die Blog-Beschreibung wird unterhalb des Blog-Titels im Frontend angezeigt. Auch hier können Sie Sonderzeichen einfügen, aber keinen HTML-Code.

Fehler!kein E-Mail-Versand Konfiguration!Emailadresse@E-Mail-Adresse des Blogs E-Mail-Adresse des Blogs Wenn Serendipity E-Mails an Autoren oder Kommentatoren schickt, muss eine E-Mail-Adresse für den Absender eingetragen werden. Da Serendipity E-Mails über den Webserver verschickt, muss die hier eingetragene E-Mail-Adresse auch vom Mailserver als gültig anerkannt werden. Ansonsten könnte der Mailserver Ihre E-Mail als Spam deklarieren und verwerfen. Meist können an dieser Stelle nur E-Mail-Adressen eingetragen werden, die auch auf demselben Server gehostet werden. sendmail Sollte Serendipity einmal keine Mails an Sie verschicken, prüfen Sie, ob Sie hier eine gültige Adresse eingetragen haben und ob Ihr Webserver auch in der Lage ist, E-Mails mittels sendmail [*] Sendmail ist ein Unix-Mailbefehl, der von PHP nur genutzt werden kann, wenn dieses Paket auf dem Server installiert ist. zu versenden. Fehler!Windows-Server Auf Windows-Servern muss ein Mailserver in der php.ini-Datei eingetragen werden.

Konfiguration!HTML Kommentare HTML Kommentare Mit dieser Einstellung erlauben Sie den Rich-Text-Editor für Kommentarfelder, sowohl im Frontend als auch im Backend. Es wirde das Möglichste getan um dieses Feature so sicher wie möglich zu machen. Wenn die Rich-Text-Editor (WYSIWYG)-Option in den "Eigenen Einstellungen" erlaubt ist, können Sie hier also zusätzlich "tag"-beschränkte HTML-Kommentare und "pre/code" HTML-Auszeichnungs-Bestandteile zulassen, die in Backend- und Frontend-Seiten als HTML verarbeitet, aber vom Editor nur im Backend bearbeitet werden. Bitte beachten Sie: Diese Option gibt auch alte Kommentare frei, um ihren eventuellen Markup Inhalt als HTML anzuzeigen. Überprüfen Sie diese also besser vor der Erlaubnis (!), damit Sie keine versehentlich genehmigten, aber unsichere (javascript oder links, etc) Kommentar Inhalte in Ihrer Datenbank gespeichert haben. Ansonsten eignen sich Rich-Text-Editor-Kommentare auch hervorragend, um lästige Bot-Programm-Spammer loszuwerden.

Eintrags-Abonnement Konfiguration!Abonnieren von Einträgen erlauben E-Mail!Benachrichtigungen Abonnieren von Einträgen erlauben? Wenn Sie es Ihren Besuchern erlauben wollen, dass sie per E-Mail über Kommentare benachrichtigt werden, muss diese Option aktiviert sein. Ein Benutzer kann Kommentare jedoch nur abonnieren, wenn er selber zu einem Beitrag kommentiert hat.

Double-Opt In für Kommentar-Abonnementmails Konfiguration!Double-Opt In für Kommentar-Abonnementmails E-Mail!Double-Opt In für Benachrichtigungen Double-Opt In für Kommentar-Abonnementmails? Falls aktiviert, wird einem Besucher Kommentator, der E-Mail-Benachrichtigungen zu neuen Kommentaren abonnieren möchte, eine E-Mail zugeschickt. Diese enthält einen Bestätigungslink nach dem z.B. für Deutsche Gesetze erforderlichen Opt-In-Schema.

Schnelle Kommentar-Moderation verwenden Konfiguration!Schnelle Kommentar-Moderation verwenden E-Mail!Token für Benachrichtigungen Schnelle Kommentar-Moderation verwenden? Diese Methode setzt Tokens ein, damit Kommentare direkt aus der Hinweis-E-Mail heraus gelöscht oder akzeptiert, also administriert werden können. Diese Funktion ist für höheren Komfort gedacht, geht aber zu Lasten der Sicherheit: Wenn jemand die E-Mail abfängt, kann diese Person entsprechende Kommentare ohne weitere Authentifikation löschen oder freischalten.

Konfiguration!Sprache Sprache An dieser Stelle können Sie die Sprache der Oberfläche des Blogs wählen. Serendipity zeigt dann alle eigenen Meldungen in dieser Sprache an. Im Gegensatz zur Spracheinstellung im Menü Eigene Einstellungen wird hier nur die Sprache für Besucher des Blogs eingestellt. Ihre persönliche Spracheinstellung "überschreibt" diesen Wert.

Konfiguration!Zeichensatz-Auswahl UTF-8 Zeichensatz-Auswahl Serendipity ermöglicht die Darstellung aller Meldungen und Ihrer eigenen Artikel in verschiedenen Zeichensätzen. Alle Sprachen können im Zeichensatz UTF-8 abgebildet werden, daher ist dieser Zeichensatz mittlerweile der Standard im Internet. Einige andere Sprachen, besonders Chinesisch, verwenden jedoch eigene, nationale Zeichensätze zur korrekten Darstellung. Wenn Sie in dem Auswahlfeld dieser Option Nationaler Zeichensatz wählen, wird dieser spezielle nationale Zeichensatz benutzt (abhängig von der jeweils gewählten Sprache). Fehler!Sonderzeichen Wenn Ihr Blog bereits Artikel enthält, wird die Umstellung dieser Option dazu führen, dass die Sonderzeichen Ihrer Artikel falsch angezeigt werden. Sie müssen daher die Konvertierung in diesem Fall manuell vornehmen, wie im Kapitel Falsche Anzeige von Datumsangaben oder Sonderzeichen ab Seite Falsche Anzeige von Datumsangaben oder Sonderzeichen beschrieben.

Konfiguration!Kalendertyp Kalendertyp Für einige Kulturen gibt es möglicherweise unterschiedliche Arten der Kalender-Darstellung. Für Serendipity wurde daher der persische Kalender als Alternative zum bekannten gregorianischen Kalender eingebaut und kann hier ausgewählt werden.

Konfiguration!Sprache!des Browsers eines Besuchers verwenden Sprache des Browsers eines Besuchers verwenden Wenn diese Option aktiviert ist, wird Serendipity die Sprache des Frontends abhängig von der im Browser des Besuchers eingestellten Sprache auswählen. So können Sie es Ihren Besuchern erleichtern, die umgebenden Texte zu verstehen, wenn sie Ihre Artikel in der Landessprache nicht lesen können. Bitte beachten Sie, dass diese Sprachauswahl die Artikel nicht automatisch übersetzen kann.

Benutzergruppen Pluginrechte Konfiguration!Plugin-Rechte für Benutzergruppen Plugin-Rechte für Benutzergruppen aktivieren? Serendipity ermöglicht es, pro Benutzergruppe zu definieren, welche Plugins von dieser Gruppe im Backend ausgeführt werden dürfen. Über die Definition in der Gruppenverwaltung kann verhindert werden, dass bestimmte Autoren zum Beispiel Zugriff zu dem Plugin Statische Seiten haben. Performance Da es in Blogs relativ selten vorkommt, dass Sie den Zugriff derart strikt eingrenzen müssen, ist diese Option standardmäßig nicht aktiviert und muss daher bewusst von Ihnen eingeschaltet werden. Das Einschalten dieser Option kann die Performance von Serendipity spürbar negativ beeinflussen, da für jede Ausführung eines Plugins nun erst geprüft werden muss, ob Zugriff darauf erlaubt ist. Wenn Sie also auf diese Flexibilität verzichten können, sollten Sie die Option Plugin-Rechte für Benutzergruppen aktivieren weiterhin auf Nein stellen.

Konfiguration!Update!-Hinweis Update-Hinweis Mit dieser Option aktivieren Sie den Serendipity Update Hinweis und den "1-Klick"-Upgrade Task in der Backend Startseite, wenn das serendipity_event_autoupdate Plugin installiert ist und ein neues Update bereitsteht. Aus Performancegründen wird das Ergebnis für 6 Stunden gecached.

Konfiguration!Update!-RELEASE-Datei URL Update-RELEASE-Datei URL Mit dieser URL positionieren Sie den Zeiger auf die Serendipity Styx Release Datei. Dies ist Bestandteil der vorangegangen (aktiv gesetzten) Update-Hinweis Option.

Konfiguration!Debug!Log Level Log Level Wenn diese Option aktiviert ist, schaltet Serendipity in verschiedenen Bereichen ein Developer Debug Level ein. Je nach Implementierung im Serendipity-Code wurden Debugging-Ausgaben platziert und in eine Tagesdatei unter templates_c/logs/ geschrieben. Diese Option sollte nur aktiviert werden, wenn Probleme in der Funktionsausführung bestehen. Wird die Option auf "Fehler" gesetzt, werden PHP-Fehler in jenes Logfile geschrieben. Hierbei wird die PHP error_log Option überschrieben. Das Serendipity Styx event_changelog Plugin erlaubt diese Logdateien am Tage selbst komfortabel aus dem Wartungsbereich und innerhalb der eingelogten Sitzung heraus zu lesen. Ansonsten sind Vorkehrungen getroffen, dass auf diese Textdateien nicht ohne weiteres von außen zugegriffen werden kann und alte Logdateien in der Wartung gelöscht werden können, da sie eventuell relevante interne Daten enthalten.

Konfiguration!Caching!Erlaube caching (EXPERIMENTAL) Erlaube caching (EXPERIMENTAL) Wenn diese Option aktiviert ist, erlaubt Serendipity einen internen Puffer (cache) einzuschalten, um spezifische SQL queries zwischenzuspeichern. Dadurch verringert sich die Last auf Servern mit mittlerem bis hohem Verkehr und verbessert die Ladezeit. Diese Option ist immer noch experimentell und bisher nur ungenügend validiert und getestet.

Design und Optionen

Konfiguration!Design und Optionen

Optionen, die das Aussehen des Blogs betreffen, sind im Bereich Design und Optionen zusammengefasst.

Konfiguration!Anzahl der Artikel auf der Startseite Anzahl der Artikel auf der Startseite Standardmäßig zeigt Serendipity die letzten 15 Artikel auf der Startseite. Über die Einstellung Anzahl der Artikel auf der Startseite können Sie diese Anzahl kontrollieren, die auch für alle Übersichtsseiten angewendet wird.

Konfiguration!Einträge im Feed Einträge im Feed Analog zu der Anzahl der Artikel auf der Startseite bestimmt die Option Einträge im Feed, wie viele Artikel in Ihrem RSS-Feed standardmäßig enthalten sind. Traffic Eine hohe Einstellung dieser Zahl stellt Ihren Besuchern zwar mehr Einträge dar, vergrößert aber auch die Dateigröße des RSS-Feeds (und damit den Traffic) erheblich.

Konfiguration!Stabile Archive Sortierung Stabile Archive Diese Option sortiert die Archiv-Seiten absteigend, so dass sie auf einer festen Seite bleiben und Suchmaschinen sie nicht immer wieder neu indizieren müssen. Voreingestellt ist aber die fortlaufende Sortierung.

Konfiguration!Wie sollen Such-Resultate sortiert werden Sortierung Wie sollen Such-Resultate sortiert werden? Diese Auswahlbox sortiert die Such-Resultate nach Datum oder Relevanz.

rfc2616 Konfiguration!strikte RFC2616-RSS-Feed-Kompatibilität RFC 2616 Strikte RFC2616 RSS-Feed Kompatibilität Wie im Kapitel Caching von RSS-Feeds auf Seite Caching von RSS-Feeds erklärt, können RSS-Feeds bei Ihren Besuchern zwischengespeichert werden. Dieses Caching macht möglicherweise bei einer kleinen Anzahl von Software-Programmen Probleme. Sollte die benutzerseitige Deaktivierung des Cachings (siehe erwähntes Kapitel) nicht ausreichen, können Sie die Option Strikte RFC2616 RSS-Feed Kompatibilität aktivieren. Serendipity verhält sich dann absolut standardgemäß, verzichtet jedoch auf das zusätzliche Feature der fallweisen Artikelauslieferung abhängig vom letzten Besuchsdatum. Zwei weitere Einstellungen, die das Caching beeinflussen, können Sie auf Seite Caching-Variablen nachschlagen.

Konfiguration!GZIP-Kompression verwenden Traffic GZIP-Kompression verwenden Wenn Serendipity den HTML-Code des Frontends an den Browser Ihrer Besucher ausgibt, wird dabei eine Menge an Klartext-Daten übertragen. Klartext lässt sich mittels ZIP-Kompression relativ stark bündeln und bietet sich daher zum Einsparen von Traffic an. Gerade bei Besuchern mit niedriger Bandbreite (Benutzer von Modems, GPRS-Verbindungen) kann die GZIP-Komprimierung einige Vorteile bringen. Leider benötigt das Packen mit GZIP-Kompression einiges an CPU-Leistung. Daher muss man abwägen, ob der eigene Server eher einen Engpass bei der CPU-Leistung oder bei der Trafficmenge hat. Zwar wird eine Aktivierung der GZIP-Kompression weniger Daten übertragen, aber die Performance von Serendipity wird dadurch sinken. Hier müssen Sie eine Entscheidung treffen. Da Bandbreite heutzutage ein selteneres Problem ist, empfehle ich, zugunsten der Servergeschwindigkeit diese Option zu deaktivieren.

config-popups Konfiguration!Popups für Kommentare, Trackbacks usw. verwenden Popups Popups für Kommentare, Trackbacks usw. verwenden? Blendet Serendipity im Frontend einen Link auf Kommentare und Trackbacks eines Artikels ein, können diese Links entweder auf die vollständige Artikelansicht zeigen oder auch ein Popup-Fenster mit der gewünschten Darstellung öffnen. Wenn Sie diese Popups benutzen wollen, aktivieren Sie die Option Popups für Kommentare, Trackbacks usw. verwenden. Beachten Sie jedoch, dass Popups bei vielen Internet-Nutzern verpönt sind und es daher empfehlenswert ist, Ihren Besuchern die Wahl zu lassen, ob sie etwas als Popup öffnen möchten oder nicht. Jeder moderne Browser bietet dazu das Öffnen von Links in einem neuen Fenster mit einfachem Mausklick der mittleren Taste an.

Konfiguration!eingebettete Serendipity-Nutzung aktivieren Konfiguration!Embedding Eingebettete Nutzung von Serendipity aktivieren? Wenn Sie Serendipity in eine andere Anwendung einbetten wollen, können Sie die Ausgaben von Serendipity zentral speichern und in der PHP-Anwendung weiterverarbeiten. Damit diese Einbindung gelingt, darf Serendipity dann keine HTML-Kopf- und -Fußzeilen senden. Die Aktivierung dieser Option bietet genau dies: Serendipity sendet dann nur den eigentlichen Inhalt des Blogs, der von der fremden Anwendung im Zusammenspiel mit der Option Index-Datei (siehe Seite index-Datei) genutzt werden kann. Diese Option war besonders für ältere Serendipity-Versionen notwendig. Seit es Smarty-Templates gibt, kann man diese Templates auch leicht so anpassen, dass keine Kopf- und Fußzeilen mehr gesendet werden müssen. Schlagen Sie im Kapitel sharedinstall ab Seite sharedinstall nach, um eine Anleitung zur Einbettung von Serendipity zu erhalten. Fehler!kaputtes Layout Sollte Ihr Serendipity-Blog ein merkwürdiges Layout aufweisen, ist womöglich die Aktivierung dieser Option "schuld" daran.

Konfiguration!externe Links (un)klickbar Externe Links klickbar? Für die Seitenleisten-Plugins Top Exits und Top Referrer kann man mittels dieser Option einstellen, ob in diesen Plugins dargestellte Links mittels HTML klickbar dargestellt werden oder nicht. Eigentlich gehört diese Option mittlerweile in die Konfigurationsseite der beiden Plugins. Aus historischen Gründen ist die Option jedoch in der globalen Konfiguration enthalten und wird möglicherweise in zukünftigen Versionen verschwinden.

Konfiguration!Referrer-Tracking (de)aktivieren Referrer-Tracking trackreferrer Referrer-Tracking aktivieren? Wenn Sie die Option Referrer-Tracking aktivieren, wird bei jedem Aufruf einer Serendipity-Seite ausgewertet, von welcher Seite ein Besucher kam. Diese Daten können dann in den Statistiken verwendet werden und zeigen Ihnen, von welchen Webseiten häufig zu Ihnen verlinkt wird. Spam Leider wurde diese Option im Laufe der Zeit sehr oft durch Spammer missbraucht und zeigt nur noch in seltenen Fällen wirklich nutzbare Daten an.

Konfiguration!geblockte Referrer Geblockte Referrer Um ein wenig Kontrolle auf Referrer-Spammer auszuüben, können Sie in diesem Eingabefeld mehrere Stichwörter eintragen, die Sie mittels ; voneinander trennen. Sobald eines dieser Stichwörter in der URL eines Besuchers vorkommt, wird diese URL nicht mit in die Referrer-Statistik übernommen.

Konfiguration!URL Formung@URL-Formung URL-Formung sprechende URLs SEO urlformung URL-Formung Die Option URL-Formung ist zuständig, um sprechende URLs zu aktivieren (siehe Seite mod-rewrite). Ob Serendipity URLs hübsch formatieren kann, hängt davon ab, ob Ihr Webserver dies unterstützt. Die Unterstützung können Sie ausprobieren, indem Sie testweise einfach die Methoden zur URL-Formung aktivieren und die Konfiguration abspeichern. Besuchen Sie danach Ihr Frontend und prüfen Sie, ob der Link zu einer Artikel-Detailseite noch funktioniert. Wenn Sie Fehlermeldungen erhalten oder dies nicht klappt, müssen Sie die URL-Formung wieder deaktivieren. Die Administrationsoberfläche können Sie immer unter http://www.example.com/serendipity/serendipity_admin.php auch im Fehlerfall aufrufen. Möglicherweise müssen Sie dazu die Datei .htaccess löschen, wenn bei Ihrem Webserver sonst alle Aufrufe fehlschlagen. Folgende Arten der URL-Formung sind möglich: Disable URL Rewriting Bei dieser Methode werden sprechende URLs deaktiviert. Ein Link sieht dann aus wie: http://www.example.com/serendipity/index.php?/archives/1-MeinArtikel.html Diese URLs mögen für Sie zwar sprechend aussehen, aber für eine Suchmaschine wie Google sind sie es nicht und können daher nicht zur Aufwertung der Auffindbarkeit dienen (siehe Kapitel SEO). Apache!ErrorHandling Use Apache ErrorHandling Auf vielen Apache-basierten Webservern ist diese Methode einsetzbar. Mittels eines kleinen Tricks werden Fehlerseiten dazu benutzt, um die eigentlich nicht existierende virtuelle Seite aufzurufen. Eine URL sieht dann aus wie: http://www.example.com/serendipity/archives/1-MeinArtikel.html Der Nachteil dieser Methode ist, dass für jeden URL-Aufruf in Ihrem Apache Fehler-Logfile ein Eintrag erscheint, was man als unsexy bezeichnen könnte. mod_rewrite Use Apache mod_rewrite Die performanteste Methode der URL-Formung stellt Use Apache mod_rewrite dar. Sie produziert identische URLs wie das Apache ErrorHandling, ist aber flexibler und erzeugt keine Fehler-Logfile-Einträge.

Konfiguration!Basiert die Zeitdifferenz auf der Server-Zeitzone Zeitunterschied Zeitzone Basiert die Zeitdifferenz auf der Server-Zeitzone? Wenn Ihr Webserver in einer anderen Zeitzone als Ihr eigener Computer steht, kann es zu einem Zeitversatz kommen. Mir dieser Auswahl werden Eintragszeiten nach Server-Zeitzone eintragen oder nicht. YES wählt die Server-Zeitzone als Basis, NO wählt GMT.

Konfiguration!Zeitunterschied des Servers Zeitunterschied Zeitunterschied des Servers Wenn Ihr Webserver in einer anderen Zeitzone als Ihr eigener Computer steht, kann es zu einem Zeitversatz kommen. Ihr Server würde Artikel, die Sie um 15:00 Uhr Ortszeit erstellen, je nach Serverzeit möglicherweise für 03:00 Uhr morgens auszeichnen. Um diesen Zeitversatz zu korrigieren, können Sie in dem Eingabefeld Zeitunterschied des Servers eintragen, wie viele Stunden Zeitunterschied zwischen Ihrem Computer und dem Server liegen. Um diesen Zeitunterschied herauszufinden, wird die aktuelle Serverzeit im Text neben der Eingabebox für Sie angezeigt. Sie können halbe Stunden mit einer Angabe wie 1.5 eintragen. Negative Zeitunterschiede geben Sie mit einem vorangestellten - an.

Zeitgesteuerte Veröffentlichung Zeitgesteuerte Veröffentlichung Konfiguration!zukünftige Einträge zeigen Zukünftige Einträge zeigen Üblicherweise wird Serendipity nur Artikel darstellen, deren Uhrzeit nicht vor der aktuellen Serverzeit liegt. So können Sie zukünftige Einträge bereits verfassen, ohne dass Sie zum jeweiligen Zeitpunkt manuell etwas freischalten müssen. Wenn Sie jedoch auch zukünftige Artikel anzeigen wollen (zum Beispiel für ein Blog mit in der Zukunft stattfindenden Ereignissen), können Sie die Option Zukünftige Einträge zeigen aktivieren.

Konfiguration!Leserechte auf Kategorien anwenden Leserechte auf Kategorien anwenden Serendipity unterstützt die Möglichkeit, Artikel in Kategorien mit einem Leseschutz zu versehen. So können Sie einer Kategorie Leserechte nur für bestimmte Benutzergruppen zuweisen, und alle anderen Benutzergruppen (insbesondere anonyme Besucher des Frontends) können dann Artikel in dieser Kategorie nicht lesen. Dies ermöglicht es, Serendipity auch als CMS einzusetzen. Performance In vielen Blogs ist ein derartiger Zugriffsschutz jedoch nicht notwendig, da alle Artikel von allen Besuchern gelesen werden sollen. Ist dies der Fall, können Sie die Option Leserechte auf Kategorien anwenden gerne auf Nein setzen. Dies wird die Geschwindigkeit der Darstellung im Frontend positiv beeinflussen, da weitaus weniger Datenbankabfragen ausgeführt werden müssen, um die Artikelübersicht zu erzeugen.

Feed-Einstellungen

Konfiguration!Feed-Einstellungen

Der vorletzte Bereich, Feed-Einstellungen, legt einige Optionen für die Blog Feeds fest.

Einträge mit erweitertem Text im RSS-Feed einbinden Feeds!Einträge mit erweitertem Text im RSS-Feed einbinden Feeds!YYY Einträge mit erweitertem Text im RSS-Feed einbinden Erweiterte Ja - Nein - Client Abfrage. Voreinstellung: Nein. Ein RSS-Feed enthält üblicherweise nur den Text eines Artikels, den Sie im Feld Eintrag erfasst haben. Der Erweiterte Eintrag ist nicht Bestandteil der RSS-Feeds, und somit muss ein Benutzer Ihr Blog besuchen, um den vollständigen Artikel lesen zu können. Dies ist häufig gewünscht, um mehr Besucher auf die Webseite zu "locken". Um Ihren Besuchern mehr Komfort zu bieten, können Sie aber auch den vollständigen Artikel im RSS-Feed eintragen. Mit dieser Konfigurationsoption können Sie dieses Verhalten beeinflussen. Wenn Sie die Option Client aktivieren, kann, wie im Abschnitt FullFeed auf Seite FullFeed erwähnt, der Leser selbst bestimmen, ob er einen vollständigen RSS-Feed haben will oder nicht. Dazu muss er Ihren RSS-Feed über die Datei rss.php?fullFeed=true abonnieren. Dies ist natürlich relativ versteckt, so dass Sie Ihre Besucher über diese mögliche Variante informieren müssten.

Bild für den RSS-Feed Feeds!Bild für den RSS-Feed Feeds!YYY Bild für den RSS-Feed Ein (string) input Feld. Voreinstellung: Leer (leer heißt: Binde das Serendipity-Logo ein). URL für ein Bild im GIF/JPEG/PNG Format, falls vorhanden.

Breite des Bildes Feeds!Breite des Bildes Feeds!YYY Breite des Bildes Ein (string) input Feld. Voreinstellung: Leer (in Pixeln, max. 144).

Höhe des Bildes Feeds!Höhe des Bildes Feeds!YYY Höhe des Bildes Ein (string) input Feld. Voreinstellung: Leer (in Pixeln, max. 400).

E-Mail-Adressen einbinden? Feeds!E-Mail-Adressen einbinden Feeds!YYY E-Mail-Adressen einbinden Einfache Ja - Nein Abfrage. Voreinstellung: Nein.

Feld "managingEditor" Feeds!Feld "managingEditor" Feeds!YYY Feld "managingEditor" Ein (string) input Feld. Voreinstellung: Leer (leer heißt: nicht verwenden). E-Mail-Adresse des verantwortlichen Editors, falls vorhanden. [RSS 2.0]

Feld "webMaster" Feeds!Feld "webMaster" Feeds!YYY Feld "webMaster" Ein (string) input Feld. Voreinstellung: Leer (leer heißt: nicht verwenden). E-Mail-Adresse des Webmasters, falls vorhanden. [RSS 2.0]

Feld "ttl" (time-to-live) Feeds!Feld "ttl" (time-to-live) Feeds!YYY Feld "ttl" (time-to-live) Ein (string) input Feld. Voreinstellung: Leer (leer heißt: nicht verwenden). Anzahl der Minuten, nachdem das Blog von fremden Seiten nicht mehr gecached werden sollte. [RSS 2.0]

Feld "pubDate" Feeds!Feld "pubDate" Feeds!YYY Feld "pubDate" Einfache Ja - Nein Abfrage. Voreinstellung: Ja. Soll das "pubDate"-Feld für den RSS-Kanal eingebettet werden, um das Datum des letzten Eintrags zu enthalten?

Individuelle Feed-URL Feeds!Individuelle Feed-URL Feeds!YYY Individuelle Feed-URL Ein (string) input Feld. Voreinstellung: Leer. Wenn gesetzt, wird die eingetragene URL verwendet um Feedreader dorthin weiterzuleiten. Dies ist hilfreich für Statistikdienste wie z.B. Feedburner, so dass hier die Feedburner-URL des eigenen Feeds hinterlegt werden kann.

Erzwingen der individuellen Feed-URL? Feeds!Erzwingen der individuellen Feed-URL Feeds!YYY Erzwingen der individuellen Feed-URL Einfache Ja - Nein Abfrage. Voreinstellung: Nein. Wenn aktiviert, werden alle Feedreader automatisch zu der eingetragenen individuellen Feed-URL weitergeleitet.

Bildkonvertierung

Konfiguration!Bildkonvertierung

Der letzte Bereich, Bildkonvertierung, legt einige Optionen für die Mediathek und die Vorschaubild-Erzeugung fest.

Fehler!Erstellung von Vorschaubildern Konfiguration!ImageMagick zur Skalierung verwenden ImageMagick gdlib ImageMagick zur Skalierung verwenden Wenn auf Ihrem Webserver die Software ImageMagick [*] https://imagemagick.org/ installiert ist, können Sie diese Software zur Erstellung und Konvertierung von Vorschaubildern benutzen. Ist ImageMagick nicht aktiviert, kann Serendipity auch die PHP-Bibliothek gdlib (für JPG, PNG, GIF, WBMP, WebP, XBM und XPM Dateien) einsetzen. Jede dieser Bildverarbeitungsbibliotheken hat ihre Vor- und Nachteile. Sowohl GD als auch ImageMagick bieten einige grundlegende Funktionen wie: - Größenanpassung und Zuschneiden von Bildern, - Erstellen von Bildern, die aus benutzerdefinierten Formen, Text und anderen Bilddateien bestehen, - Anwendung von Bildfiltern (Änderung von Helligkeit, Kontrast, Einfärbung usw.). Die GD-Bibliothek ist durch die direkte Einbindung in PHP weit verbreitet, so dass sie wahrscheinlich überall -out-of-the-box- funktionieren wird. ImageMagick bietet den Vorteil, dass zB. auch Vorschaubilder von PDF-Dateien erzeugt werden können, oder TIFF Bilddateien bearbeitet werden können. Bis auf diesen Vorteil sind GD-Lib und ImageMagick in den Grundfunktionen ungefähr gleichwertig; anderseits aber unterstützt ImageMagick mehr Dateitypen und kann Bilder auf viel mehr Arten transformieren als die GD-Bibliothek. Es erlaubt Ihnen, Code von größerer Klarheit und Qualität zu schreiben. Und ImageMagick kann exaktere Zuschnitte von Bildern forcieren, was eventuell bei der Serendipity Mediathek von Bedeutung sein kann.

Konfiguration!Pfad!zur convert-ImageMagick-Datei Pfad zur "convert" ImageMagick-Datei In diesem Eingabefeld müssen Sie den vollständigen Pfad zur ImageMagick-Datei auf dem Webserver eintragen. ImageMagick kann nur ausgeführt werden, wenn der Webserver-Benutzer für diese Datei Zugriffsrechte gewährt. Gerade bei aktiviertem Safe Mode ist dies selten der Fall. Deaktivieren Sie ImageMagick, falls Fehlermeldungen bei der Vorschaubild-Erzeugung auftreten.

Vorschaubildendung Konfiguration!Vorschaubild-Endung Thumbnails serendipity-Thumb@styxThumb serendipity-Thumb@serendipityThumb Vorschaubild-Endung Als Thumbnail bezeichnet man die Vorschaugrafiken, die Serendipity von einer Bilddatei automatisch erzeugt. Jede dieser Vorschaugrafiken enthält standardmäßig den Namenszusatz styxThumb. Die Vorschaudatei zum Bild logo.jpg wird also logo.styxThumb.jpg heißen und im selben Verzeichnis angelegt werden. Diesen Dateinamen können Sie über die Option Vorschaubild-Endung selber festlegen. Wenn Sie den Dateinamen ändern und bereits Dateien in der Mediathek vorhanden sind, müssen Sie im Menü Mediathek auf Vorschauen erneuern klicken.

Vorschaubildgröße Konfiguration!Vorschaubildgröße Thumbnails!Größe Vorschaubildgröße Jede Grafikdatei wird standardmäßig auf maximal 400 Pixel Breite oder Höhe für die Vorschaugrafik verkleinert. Der jeweils größere Wert (Breite oder Höhe) wird dabei auf 400 Pixel verkleinert und der jeweils kleinere Wert unter Berücksichtigung der Bildproportionen errechnet. Serendipity zeigt die Vorschaubilder in der Mediathek stets in der hier konfigurierten Größe an. Wenn Sie also größere (oder kleinere) Vorschaubilder bevorzugen, können Sie die maximale Größe unter Vorschaubildgröße einstellen. Auch hier müssen Sie auf Vorschauen erneuern klicken, wenn Sie diesen Wert ändern, obwohl Sie schon Dateien in die Mediathek eingestellt haben.

Bestimmung der maximalen Vorschaubildgröße Konfiguration!Vorschaubildgröße Thumbnails!Größe Thumbnails!Bestimmung Bestimmung der maximalen Vorschaubildgröße Legt fest, wie die Größe der Thumbnails angepasst werden soll. Der Standard "Längste Seite" nutzt die größte Seite als Beschränkung, so dass weder Breite noch Höhe die festgelegte Zahl überschreiten dürfen. "Breite" und "Höhe" legen lediglich die Höhe bzw. Breite als größte Seite fest, so dass die jeweils andere Angabe auch größer als die festgelegte Zahl sein darf.

uploadlimit Konfiguration!maximale Dateigröße für den Upload Upload-Limit Dateigröße!für den Upload beschränken Maximale Dateigröße für den Upload Wenn Sie den Upload von Dateien künstlich einschränken wollen, können Sie die maximale Dateigröße einer in die Mediathek hochgeladenen Datei über das Feld Maximale Dateigröße für den Upload einstellen. Beachten Sie, dass Sie diesen Wert nicht größer einstellen können als die ebenfalls limitierenden Konfigurationsoptionen upload_max_filesize, post_max_size und max_input_time der php.ini (siehe Kapitel file-uploads auf Seite file-uploads).

uploadlimit2 Konfiguration!maximale Breite/Höhe eines hochgeladenen Bildes Maximale Breite eines hochgeladenen Bildes Maximale Höhe eines hochgeladenen Bildes Abgesehen von der Dateigröße können Sie ein hochgeladenes Bild auch auf eine maximale Auflösung festlegen. Wenn das Bild eine dieser Dimensionen überschreitet, wird es nicht akzeptiert. So können Sie verhindern, dass Redakteure Bilder hochladen, die für den Einsatz im Internet nicht geeignet sind.

Vor dem Upload Größe anpassen Konfiguration!Vorschaubildgröße Thumbnails!Größe Thumbnails!Upload Thumbnails!Automatik Vor dem Upload Größe anpassen Mittels Javascript werden Bilder vor dem Upload an die gewählte Maximalgröße angepasst. Wenn aktiv, wird Ajax für den Bildupload verwendet, was auch zur Entfernung des "Eigenschaften angeben"- Buttons führt. Dieses muss dann separat geschehen. ACHTUNG: Diese Einstellung verhindert andere Optionen, insbesondere dann, wenn das imageselectorplus event Plugin genutzt wird!

Nutzung von AVIF Variationen (PHP 8.1+) aktivieren Konfiguration!Variationen Thumbnails!Extension Thumbnails!Upload Thumbnails!Automatik Nutzung von AVIF Variationen (PHP 8.1+) aktivieren Image AVIF Variationen können sehr ressourcenintensiv sein, da viel Ram und CPU/GPU Kerne benötigt werden um Bilder in das AV1 Format zu kodieren. Massenuploads und Massenkonvertierungen (siehe "Wartung") sind daher nicht zu empfehlen. Erlernen Sie den Umgang erst an ein paar Beispielen, bevor Sie die Nutzung verbleibend erlauben. ACHTUNG: PHP 8.1 fehlt noch eine entscheidende Funktion, um Größenangaben mit den üblichen Methoden aus AVIF Dateien auszulesen. Dies bedingt vorläufig auch, dass die Bild-Funktionen der Mediathek "Dateiausmaße ändern" und "Bild um 90° drehen" für alle Formate nicht verwendet werden können, wenn Sie AVIF verwenden, da ja jede dieser Aktionen das Originalbild, sowie dessen Variationen betrifft. Das Problem ist mit PHP 8.2 gelöst, welches die fehlende Funktion nachliefert.

MDB-Synchronisation Automagische Synchronisation Synchronisierung Konfiguration!Automagische Synchronisation der Mediathek Fehler!beim Zugriff auf Mediendateien Automagische Synchronisation der Mediathek Da Serendipity, wie im Kapitel Mediathek ab Seite Mediathek beschrieben, den Dateibestand des Upload-Verzeichnisses mit einer eigenen Datenbanktabelle abgleicht, kann es hier zu Unterschieden kommen. Serendipity kann bei jedem Aufruf der Mediathek prüfen, ob möglicherweise Dateien hinzugekommen oder gelöscht worden sind. Dazu werden alle Verzeichnisse und Dateien auf dem Server mit der Datenbank abgeglichen. Serendipity optimiert den Zugriff dabei, indem es diese Aktion nur ausführt, wenn sich etwas an der Menge der Dateien und Unterverzeichnisse getan hat. Performance Dieser Vorgang kann bei einer großen Mediathek möglicherweise zu Ressourcen-Engpässen führen. In so einem Fall müssen Sie die automagische Synchronisation deaktivieren. Wenn der automatische Synchronisationsvorgang eine neue Datei findet oder eine alte Datei löscht, wird dies direkt innerhalb der Mediathek dargestellt.

Konfiguration!dynamische Bildgrößenanpassung erlauben Dynamische Bildgrößenanpassung erlauben Üblicherweise kann Serendipity von einem Bild entweder nur die Originalgrafik oder die Vorschaugrafik zurückliefern. Ein Teil der Mediathek kann aber auch (manuell) über das Frontend angesprochen und benutzt werden, um Grafiken auch in jeder anderen beliebigen Dateigröße auszugeben (siehe Seite mdb-profi).

Konfiguration!EXIF/JPEG-Metadaten übernehmen EXIF/JPEG Metadaten übernehmen? Wenn Sie ein Bild in die Mediathek von Serendipity hochladen, kann Serendipity automatisch die Binärdaten des Bildes auswerten und in der Mediathek speichern. In solchen Binärdateien können EXIF sogenannte EXIF-Daten [*] https://www.exif.org/ gespeichert werden, die zB. von Digitalkameras automatisch eingefügt werden und Informationen über Belichtungszeit und Aufnahmezeitpunkt enthalten. Performance Serendipity kann diese Metadaten innerhalb der Mediathek anzeigen. Da das Auslesen der Binärdaten einiges an Server-Ressourcen beanspruchen kann, könnte dies möglicherweise zu sehr großen Datenmengen in der Datenbank (dort werden die Metadaten zwischengespeichert) oder auch dazu führen, dass das Hochladen von Dateien fehlschlägt. Deaktivieren Sie in diesem Fall die Option EXIF/JPEG Metadaten übernehmen.

Medieneigenschaften@Medien-Eigenschaften Medien-Eigenschaften Konfiguration!Medien-Eigenschaften Medien-Eigenschaften Zu jeder Datei in der Serendipity-Mediathek können Sie eine selbst definierte Menge von möglichen Metadaten eintragen. Standardmäßig greift Serendipity dabei auf die Felder DPI (nur bei Bildern), Laufzeit (nur bei Video/Audio), Datum, Copyright, Titel, Kurzer Kommentar und Langer Kommentar zurück. Diese verwendeten Felder werden in der Eingabebox Medien-Eigenschaften festgelegt. Die Eingabebox mag für Sie etwas kryptisch erscheinen, ist aber für Serendipity ein sehr schneller Weg, ohne umständliche Zusatzoberfläche Ihre Eingaben zu erfassen. DPI IPTC Meta-Daten@Metadaten Alle gewünschten Felder werden dabei mit einem ;-Zeichen getrennt: DPI;DATE;COPYRIGHT;TITLE;COMMENT1;COMMENT2 Jedes Feld kann einen beliebigen Namen haben, der aber keine Sonderzeichen und Leerzeichen beinhalten darf. Wie der Name eines Feldes später in der Mediathek angezeigt wird, richtet sich ebenfalls nach diesem Feld. Serendipity sucht dabei in den Sprachdateien (siehe Kapitel lang-dir, Seite lang-dir) nach einer definierten Konstante MEDIA_PROPERTY_DPI. Ist diese Konstante definiert, wird die darin definierte Bezeichnung in der Mediathek angezeigt. Gäbe es keine solche Konstante, würde der Begriff selbst dargestellt werden. Wenn Sie also das Feld QUALITAET am Ende einfügen, wird in der Mediathek auch QUALITAET angezeigt. Um eine eigene, klarere Bezeichnung zu wählen, müssen Sie die Konstante selbst definieren, wie im angesprochenen Kapitel erwähnt. Nun kann jedes aufgeführte Feld noch einige Optionen aufweisen, die jeweils durch das :-Zeichen getrennt werden. Vier Optionen sind verfügbar: :IMAGE wenn das vorangehende Feld nur für Bilddateien benutzt werden soll. :VIDEO wenn das vorangehende Feld nur für Videos benutzt werden soll. :AUDIO wenn das vorangehende Feld nur für Sounddateien benutzt werden soll. :MULTI wenn eine Medien-Eigenschaft einen längeren Eingabetext anstelle nur einer einzeiligen Eingabebox zulassen soll. Beispielsweise möchten Sie gerne für Bilder ein Eingabefeld Bildqualität, für Videos Bewegungsqualität und für alle Dateien pauschal ein großes Eingabefeld Einsatzzweck speichern. Dafür würden Sie folgende Konfiguration vornehmen: Bildqualitaet:IMAGE;Bewegungsqualitaet:VIDEO;Einsatzzweck:MULTI

Medien-Schluesselwörter Medienschluesselwoerter@Medien-Schlüsselwörter Konfiguration!Medien-Schlüsselwörter Medien-Schlüsselwörter Jeder Datei in der Datenbank können Sie über die Eigenschaftsoberfläche einer Liste von selbst definierten Schlüsselwörtern zuordnen. Dabei können mehrere Schlüsselwörter einer einzelnen Datei zugewiesen werden, und die Mediathek kann später auch nach diesen Schlüsselwörtern durchsucht werden. Schlüsselwörter werden fest in der Eingabebox Medien-Schlüsselwörter vorgegeben. Alle möglichen Schlüsselwörter müssen Sie mit einem Semikolon voneinander trennen. Ein einzelnes Schlüsselwort darf in diesem Fall auch Sonderzeichen und Leerzeichen enthalten.

Erlaube, Daten über lokale URLs abzurufen Konfiguration!Medien Intranet Erlaube, Daten über lokale URLs abzurufen Standardmäßig ist es aus Sicherheitsgründen verboten, Daten über lokale URLs abzurufen, um Server-Side Request Forgery (SSRF) zu vermeiden. Wenn Sie ein lokales Intranet verwenden, können sie die Datenabfrage über diese Option explizit erlauben.

 

serendipity-configlocalincphp@serendipity_config_local.inc.php htaccess@.htaccess Über den Button Testen & speichern können Sie die geänderte Konfiguration sichern. Serendipity wird die Datei serendipity_config_local.inc.php immer neu abspeichern, egal ob und welche Änderungen erfolgt sind. Bei Änderungen an der Permalink-Struktur oder den Pfaden wird zusätzlich die Datei .htaccess erneut erstellt.

Fehler!htaccess neu erzeugen@.htaccess im ~fall neu erzeugen Durch einen Klick auf diesen Button können Sie daher auch eine versehentlich gelöschte .htaccess-Datei wieder neu erzeugen.

Benutzerverwaltung

Benutzerverwaltung Benutzerverwaltung|see{Backend, Benutzerverwaltung} Backend!Benutzerverwaltung

In der Benutzerverwaltung von Serendipity können Sie die Redakteure und ihre Zugriffsmöglichkeiten verwalten.

Auf dieser Übersichtsseite sehen Sie eine Liste aller Redakteure, auf die Sie Zugriff haben.

Zugriffsrechte Benutzerrang Userlevel

In Serendipity werden Zugriffsrechte aufgrund von zwei Eigenschaften geregelt. Die eine ist der globale Benutzerrang/Userlevel, der der Zahl 0 (einfacher Redakteur), 1 (Chefredakteur) oder 255 (Administrator) entspricht. Die zweite ist die Zugehörigkeit zu einer Benutzergruppe, wobei jede Benutzergruppe flexible Rechte besitzen kann.

Benutzergruppen Die festen Benutzerlevel wurden in Serendipity 0.6 eingeführt und mittlerweile in fast allen Bereichen durch die Eingliederung in eigenständige Benutzergruppen abgelöst, die den Zugriff viel kleinstufiger regeln können. Dennoch gilt der Benutzerrang nach wie vor als ein Kriterium für einige zusätzliche Plugins. Sollte ein Redakteur keiner Gruppe zugehörig sein, regelt sein Benutzerrang alle ihm zur Verfügung stehenden Zugriffsmöglichkeiten.

Grundsätzlich empfiehlt es sich daher weiterhin, neue Redakteure auch einem Benutzerrang grob zuzuordnen. Bestimmen Sie dabei, ob ein Redakteur volle Rechte zu einem Blog haben soll (Administrator), ob er als Chefredakteur über anderen Redakteuren stehen soll oder ob er nur einen ganz schlichten Redakteur zur Texterfassung darstellen soll.

Ein Administrator sieht in der Übersicht alle Redakteure. Ein Chefredakteur sieht hier nur noch andere Chefredakteure und normale Redakteure. Normale Redakteure wiederum sehen nur andere normale Redakteure.

In der Benutzerübersicht wird dem Benutzerrang entsprechend ein kleines Symbol dem Namen vorangestellt. Es folgen der Benutzerrang und drei Links, als ein Button zur Ansicht der Frontend-Einträge des Nutzers und zwei administrative zum Bearbeiten und Löschen eines Benutzers.

Über den Button Einen neuen Benutzer anlegen können Sie einen neuen Benutzer anlegen, die Oberfläche ähnelt dabei den Optionen bei der Bearbeitung eines Redakteurs. Beachten Sie beim Bearbeiten eines Redakteurs, dass Ihre Möglichkeiten zum Ändern der Daten von Ihren Rechten abhängig sind, daher wird Ihnen unter Umständen beim Speichern eines Benutzers das Recht verwehrt, diese Änderung durchzuführen.

Einen neuen Benutzer anlegen oder einen Benutzer bearbeiten

Backend!Benutzerverwaltung Benutzer!anlegen

Die Oberfläche zum Bearbeiten/Anlegen eines Redakteurs sieht größtenteils exakt so aus wie die Seite der Eigenen Einstellungen (siehe Kapitel Eigene Einstellungen ab Seite Eigene Einstellungen). Hier können Sie einen Benutzer so bearbeiten, als wären es Ihre eigenen Einstellungen. Tun Sie dies bitte nur mit Vorsicht, denn üblicherweise sollten die Redakteure ihre Einstellungen selbständig vornehmen.

Passwort!aendern@ändern Das Alte Passwort eines Benutzers muss an dieser Stelle nur eingegeben werden, wenn der Benutzer Ihrem eigenen Redakteurs-Account entspricht. Andernfalls kann ein Administrator bzw. befugter Benutzer Änderungen auch ohne Passwortangabe vornehmen und so auch ein neues Passwort setzen.

 

Abweichend von den Eigenen Einstellungen sind in dieser Oberfläche zusätzlich die folgenden Optionen aufgeführt:

Zugriffsrechte

Zugriffsrechte Die Zugriffsrechte entsprechen der groben Einordnung eines Benutzers in einen Benutzerrang. Wählen Sie aus dem Auswahlfeld, welchem Rang der Benutzer am ehesten entspricht. Fehler!keine Zugriffsrechte Achten Sie darauf, dass Sie, wenn Sie Ihren eigenen Benutzer bearbeiten, Ihre eigenen Rechte beschränken könnten. Wenn Sie versehentlich Ihren Benutzerrang auf Redakteur stellen, sind Ihre Rechte erstmal eingeschränkt. Um in diesem Fall Ihren Benutzerrang zu reaktivieren, müssen Sie das Script fixpriv.php auf Seite fixpriv.php ausführen.

Gruppenzugehörigkeit Gruppenzugehörigkeit Die Gruppenzugehörigkeit des gewählten Redakteurs wird über das Mehrfachauswahlfeld Gruppenzugehörigkeit gesteuert. Ein Redakteur kann dabei Mitglied in mehreren Gruppen sein, um alle Rechte jeder einzelnen Gruppe zu vereinen. Achten Sie auch hier darauf, dass, wenn Sie sich (versehentlich) als Mitglied der Gruppe entfernen, Sie möglicherweise Ihren Zugriff auf Serendipity zerstören.

Benutzer!deaktivieren Rechte!entziehen Fehler!keine Backend-Menüs no-create Benutzer deaktivieren / Rechte entziehen Eine globale Option, um einem Benutzer sämtliche Zugriffsrechte außer dem Einloggen zu verbieten, stellt der Punkt Benutzer deaktivieren dar. Ist der Wert Ja aktiviert, ist ein Benutzer sozusagen gesperrt. Dies ist besonders nützlich, wenn Sie Benutzer anlegen wollen, die eigentlich nur im Frontend Artikel lesen, aber im Backend keinerlei Möglichkeiten nutzen sollen. Über das Plugin Freie Benutzer-Registrierung können Sie Besuchern ermöglichen, sich selbst einen Redakteurs-Account anzulegen (Details siehe Seite adduser) - auch bei solchen Redakteuren wird es oft gewünscht sein, den Zugriff stark einzuschränken. Achten Sie darauf, nicht versehentlich für sich selbst diese Option zu aktivieren. Auch dies können Sie nur mittels des fixpriv.php-Scripts rückgängig machen.

rightpublish Fehler!Einträge können nicht veröffentlicht werden Rechte: Einträge veröffentlichen Die Option Rechte: Einträge veröffentlichen bestimmt, ob es einem Redakteur erlaubt ist, einen Artikel als Veröffentlichung zu speichern. Ist diese Option nicht aktiviert, kann ein Benutzer lediglich Entwürfe speichern. Diese Entwürfe müssen dann von einem höherrangigen Redakteur veröffentlicht werden.

 

Beim Erstellen eines neuen Benutzers achten Sie bitte auf die Voreinstellungen, da zB. die Option Rechte: Einträge veröffentlichen standardmäßig auf Nein steht. Möglicherweise entspricht dies nicht der Einstellung, die Sie beabsichtigen.

Gruppenverwaltung

Gruppenverwaltung Gruppenverwaltung|see{Backend, Gruppenverwaltung} Backend!Gruppenverwaltung

Ähnlich wie bei der Verwaltung der Benutzer sehen Sie in der Übersicht der Gruppenverwaltung alle angelegten Benutzergruppen.

Sie können von dort aus entweder eine Neue Gruppe anlegen, bestehende Gruppen Bearbeiten oder Löschen. Beim Löschen einer Gruppe müssen Sie vorsichtig sein, dass Sie damit bestehenden Redakteuren nicht den Zugriff auf das Backend vollständig entziehen.

Benutzergruppen Standardmäßig werden in Serendipity drei Benutzergruppen angelegt: Administrator, Chefredakteur und Redakteur. Jede dieser Gruppen ist so eingerichtet, dass sie den Zugriff für die Mitglieder dieser Gruppen so einschränkt, wie es zu erwarten wäre: Redakteure dürfen nur Artikel anlegen und eigene Artikel bearbeiten, Chefredakteure dürfen zusätzlich Plugins und das Aussehen des Blogs verwalten und Einträge anderer Redakteure überarbeiten. Administratoren dürfen natürlich alles.

Jede Gruppe kann eine große Menge an kleinstufigen Rechten festlegen, die Sie in der Detailseite einer neuen oder bestehenden Gruppe ankreuzen können.

Eine Gruppe erstellen oder bearbeiten

Die Detailseite einer Gruppe listet alle Rechte auf. Sie können dabei nur diejenigen Rechte mittels einer Auswahlbox auswählen, die Sie selber aufgrund Ihrer Gruppenmitgliedschaft besitzen.

Hier im Beispiel der Bearbeitung für die Gruppe Redakteur, also der niedrigsten der vorgesehen Gruppenrechte.

Wenn Sie aber als Mitglied der Gruppe Chefredakteur beispielsweise eine neue Gruppe erstellen, können Sie keine Rechte zur Administration des Blogs vergeben - denn das wäre natürlich eine einfache Art, sich die Blog-Herrschaft anzueignen.

Bei solchen nicht vergebbaren Rechten sehen Sie also nur den aktuellen Wert des jeweiligen "gesperrten" Rechtes.

Folgende Rechte stehen zur Verfügung:

Rechte

Name Der Name einer Gruppe kann von Ihnen frei gewählt werden und darf auch Sonderzeichen enthalten. Bei den von Serendipity vordefinierten Gruppen steht an dieser Stelle nicht der jeweilige Gruppenname, sondern etwas in der Art USERLEVEL_CHIEF_DESC. Dies wird später bei der Darstellung durch den jeweiligen "echten" Namen ersetzt, damit bei anderssprachigen Redakteuren deren Gruppenzugehörigkeit nicht auf einen deutschen Begriff festgelegt wird.

Gruppenzugehörigkeit In dieser Auswahlbox werden alle verfügbaren Redakteure dargestellt. So können Sie einer neuen Gruppe relativ leicht bestehende Redakteure hinzufügen, indem Sie sie einfach in dem Mehrfachauswahlfeld markieren. Einen Benutzer können Sie auf zwei Arten aus einer Gruppe entfernen: Entweder Sie heben die Zugehörigkeit in diesem Mehrfachauswahlfeld auf, oder Sie bearbeiten den jeweiligen Benutzer und heben dort die Gruppenzuordnung auf. Mehrere Redakteurszuordnungen können Sie mit gedrückter (Strg/Apfel)-Taste und der linken Maustaste vornehmen.

Zugriffsrechte Benutzerrechte Gruppenrechte Rechte!adminCategories Rechte!adminCategoriesDelete Rechte!adminCategoriesMaintainOthers adminCategories, adminCategoriesDelete, adminCategoriesMaintainOthers Wenn das Recht adminCategories aktiviert ist, kann ein Redakteur Kategorien verwalten (neue Kategorien anlegen und bestehende Kategorien bearbeiten). Besitzt er das Recht adminCategoriesDelete, darf er auch Kategorien löschen. Dabei ist der Zugriff nur auf selbst angelegte Kategorien möglich. Erst wenn ein Benutzer auch das Recht adminCategoriesMaintainOthers besitzt, darf er auch Kategorien anderer Benutzer verwalten.

Rechte!adminComments adminComments Damit ein Redakteur die Kommentarübersicht aufrufen kann, muss er das Recht adminComments besitzen. Ohne dieses Recht darf er nur Kommentare zu von ihm geschriebenen Artikeln (mittels der E-Mail-Benachrichtigung) freischalten.

Rechte!adminEntries Rechte!adminEntriesMaintainOthers adminEntries, adminEntriesMaintainOthers Nur wenn ein Redakteur das Recht adminEntries besitzt, darf er Einträge im Blog erstellen. Dabei darf er nur selbst erstellte Artikel im Nachhinein überarbeiten. Wenn er das Recht adminEntriesMaintainOthers besitzt, darf er zusätzlich auch auf Artikel anderer Redakteure zugreifen. Ob ein Benutzer überhaupt Einträge erstellen und veröffentlichen darf, wird zusätzlich individuell pro Benutzer in dessen Einstellungen (siehe Seite Benutzerverwaltung) festgelegt.

Rechte!adminImages adminImages und weitere Um auf die Mediathek zuzugreifen, benötigt ein Redakteur das Recht adminImages. Weitere feinstufige Rechte kontrollieren, was der Redakteur innerhalb der Mediathek durchführen darf. Mittels adminImagesAdd darf er neue Mediendateien hochladen. Das Recht adminImageDelete ermöglicht es ihm, Mediendateien auch wieder zu löschen. Neue Unterverzeichnisse kann er mit dem Recht adminImagesDirectories anlegen. Um Vorschaubilder erneut zu erstellen, benötigt er das Recht adminImagesSync. Die Mediathek selbst kann ein Redakteur zum Einbinden von Dateien nur aufrufen, wenn er das Recht adminImagesView besitzt. Um auch die Dateien anderer Redakteure anzusehen, benötigt er das Recht adminImagesViewOthers. Um auch die Mediendaten anderer Redakteure bearbeiten/löschen zu können, ist das Recht adminImagesMaintainOthers erforderlich.

Rechte!adminImport adminImport Das Recht adminImport regelt, ob ein Redakteur die Einträge fremder Blogsysteme importieren darf.

Rechte!adminPlugins adminPlugins Besitzt ein Redakteur das Recht adminPlugins, kann er Seitenleisten- und Ereignis-Plugins installieren. Dabei wird der Redakteur als Eigentümer eines Plugins aufgeführt und kann daraufhin nur seine eigenen Plugins auch konfigurieren. Über das Recht adminPluginsMaintainOthers kann ein Redakteur auch die Konfiguration fremder Plugins ändern.

Rechte!adminTemplates adminTemplates Um ein anderes Template zu aktivieren und Template-Optionen zu konfigurieren, benötigt der Redakteur das Recht adminTemplates.

Rechte!adminUsers adminUsers und weitere Ob ein Redakteur die Benutzerverwaltung aufrufen darf, wird mit dem Recht adminUsers eingestellt. Neue Benutzer darf er mit dem Recht adminUsersCreateNew anlegen, Benutzer löschen mit adminUsersDelete. Den Benutzerrang darf er nur verändern, wenn er das Recht adminUsersEditUserlevel besitzt. Ansonsten darf er nur Redakteure niederen Ranges anpassen. Die Gruppenverwaltung darf der Benutzer mit dem Recht adminUsersGroups anlegen. Besitzt er das Recht adminUsersMaintainSame, darf er gleichrangige Benutzer bearbeiten, und wenn er das Recht adminUsersMaintainOthers besitzt, darf er auch alle anderen Benutzer verwalten.

Rechte!blogConfiguration blogConfiguration Wenn der Redakteur das Recht blogConfiguration besitzt, darf er Änderungen an der globalen Konfiguration des Blogs vornehmen. Darunter fallen jedoch keine Änderungen der Datenbankkonfiguration oder systemnaher Einstellungen.

Rechte!personalConfiguration Rechte!personalConfiguratioNoCreate personalConfiguration, personalConfigurationNoCreate Die Eigenen Einstellungen darf ein Redakteur nur mit dem Recht personalConfiguration aufrufen. Das Sonderrecht, einen Benutzer zu sperren, darf ein Redakteur nur ausüben, wenn er das Recht personalConfigurationNoCreate besitzt. Analog dazu darf er die Sondervariablen zum Veröffentlichungsrecht von Artikeln und den Benutzerrang nur bearbeiten, wenn er über die Rechte personalConfigurationRightPublish und personalConfigurationUserlevel verfügt.

Rechte!siteAutoUpgrades siteAutoUpgrades Das "besondere" Recht siteAutoUpgrades wurde mit Serendipity Styx 2.8.0 eingeführt und ermöglicht, einem bestimmten Benutzer, mit der Gruppeneigenschaft "Chefredakteur", die Erlaubnis zu erteilen, das Serendipity Autoupdate über die Backend Startseite auszuführen, sobald ein Upgrade vorliegt. Dieses Recht darf nur der Administrator vergeben und entziehen und sollte nur auf Multiuser-Systemen mit diesem besonderen Bedürfnis vergeben werden. Als empfohlenes Beispiel gehen Sie wie folgt vor: Erstellen Sie als Administrator unter "Gruppe" eine neue Gruppe mit beliebigem Namen und vergeben in dieser nur die Hauptkategorien, sowie das spezielle Feld siteAutoUpgrades und das - in diesem Fall - besonders wichtige Feld Hidden group / Non-Author, damit diese Gruppe für andere Benutzer verborgen bleibt. Danach verbinden sie unter "Benutzer" den gewünschten Nutzer mit der Eigenschaft "Chefredakteur" zusätzlich mit eben dieser neu erstellten Gruppe.

Rechte!siteConfiguration siteConfiguration Die systemweite Konfiguration (mit Einstellungen der Datenbank und anderer systemnaher Optionen) darf ein Redakteur nur verändern, wenn er über das Recht siteConfiguration verfügt.

Rechte!userlevel userlevel Die vordefinierten Gruppen von Serendipity können mit einem Benutzerrang verkettet werden. Dies ist nicht veränderbar und lediglich für die vordefinierten Gruppen von Interesse. Daher sehen Sie an dieser Stelle auch in allen Fällen nur ein Nein.

Verbotene Plugins Rechte!verbotene Plugins Verbotene Plugins Verbotene Plugins Ist die globale Option Sollen persönliche Plugin-Rechte für Benutzergruppen aktiviert werden? in der Konfiguration des Blogs (Abschnitt Generelle Einstellungen) aktiviert, werden Sie an dieser Stelle eine Liste aller installierten Plugins sehen. Sollte die Option (wie standardmäßig der Fall) deaktiviert sein, sehen Sie hier nur einen Hinweis, der auf die Konfigurationsoption Bezug nimmt. In dem Mehrfach-Auswahlfeld können Sie alle Plugins auswählen, auf die eine Benutzergrupe keinen Zugriff hat. So können Sie Redakteure von der Benutzung einiger Plugins gezielt ausnehmen.

Verbotene Ereignisse Rechte!verbotene Ereignisse Ereignisse Events Hooks Verbotene Ereignisse verboteneereignisse Die Ereignis-Plugins von Serendipity werden an speziellen Stellen des Systems ausgeführt. Diese Stellen nennen sich Ereignisse und tragen alle einen individuellen Namen. Plugins können sich zu einem Ereignis einklinken und dann beliebige Aktionen durchführen. Wenn man ein Plugin nicht zentral verbieten will, kann über dieses Mehrfachfeld gezielt nur eine Menge von gewünschten Ereignissen für die Benutzergruppe blockiert werden. Die Namen der Ereignisse lassen auf deren Bedeutung schließen, sind aber nur für erfahrenere Benutzer von Belang. Auch von Plugins selbst eingebundene Ereignisse sind in dieser Liste enthalten. Eine Übersicht über die üblichen Serendipity-Ereignisse sehen Sie im Abschnitt Ereignisse ab Seite Ereignisse.

Wenn Sie eine neue Gruppe anlegen wollen, sehen Sie am Ende der Eingabemaske den Button Neue Gruppe anlegen.

Sollten Sie eine bestehende Gruppe bearbeiten, können Sie die vorgenommenen Änderungen über den Menüpunkt Speichern übernehmen. Auch hier sehen Sie dann den Button Neue Gruppe anlegen. Dieser dient dazu, eine ganz neue Gruppe mit den konfigurierten Möglichkeiten zu erstellen. Sie können diese Methode also nutzen, wenn Sie eine Gruppe erstellen wollen, die einer bestehenden Gruppe ähnelt. Bearbeiten Sie dann diese Gruppe als Vorlage, nehmen Sie die Änderungen vor und klicken Sie auf Neue Gruppe anlegen, um dies durchzuführen.

Wartung: Installation prüfen

Installation prüfen Installation!prüfen|see{Backend, Installation prüfen} Backend!Installation!prüfen prüfen

Bei jedem Serendipity Release, bei Styx sogar bei den Beta-Releases, wird eine Checksumme jeder einzelnen Datei erstellt. Den Vergleich mit ihren aktuellen Dateien können Sie hier vornehmen. Natürlicherweise können nur Dateien verglichen werden, die auf ihrem augenblicklichen System, wie auch in einem Release Zip zu finden sind. Veränderte Dateien, und seien es nur veränderte Speicherzeiten, werden Ihnen angemahnt. Dies muss nicht immer einen Fremdzugriff bedeuten, denn oft war man es selbst, der eine Datei geöffnet und neu gespeichert hat.

Wartung: Template Cache leeren

Template Cache leeren Template!Cache leeren|see{Backend, Template Cache leeren} Backend!Template!Cache leeren Cache leeren

Die Smarty Zwischenschicht Dateien, einer simplen Abstraktion von PHP, werden im templates_c-Ordner kompiliert und gespeichert. Siehe: System/Plugin/Smarty-Template "Cache" Dateisystem für temporär erstellte Dateien. Um zu vermeiden, dass sie nach einem Systemupgrade oder einer eigenen Veränderung der Template (*.tpl) Dateien möglicherweise einem Cache-Effekt unterliegen, können Sie hier die Template Dateien ihres Themes löschen lassen. Smarty wird diese sofort neu anlegen, sobald ein Request dafür vorliegt.

Wartung: Einträge exportieren

Einträge exportieren Eintrag!exportieren|see{Backend, Einträge exportieren} Backend!Einträge!exportieren Export

Hinter dem Menüpunkt Einträge exportieren befindet sich nur ein einzelner Button: Vollständigen RSS-Feed exportieren.

Dieser Button ist lediglich ein Link auf Ihren RSS-Feed im Frontend, dem der Parameter all=1 angehängt ist.

Als Ergebnis dieser Exportaktion wird Ihr Browser also einen RSS-Feed mit allen Ihren Einträgen anzeigen. Diesen RSS-Feed können Sie speichern und in andere Anwendungen importieren.

Bitte beachten Sie unbedingt, dass der RSS-Feed nur einen ganz kleinen Teil Ihres Blogs enthält, nämlich nur den Beitragstext sowie die Überschriften Ihrer Artikel und einige zusätzliche Informationen wie den Autor, die zugeordnete Kategorie und die Veröffentlichungszeit. Nicht enthalten sind in diesem RSS-Feed die erweiterten Artikelinhalte, Benutzerinformationen, alle verfügbaren Kategorien und noch vieles mehr. Daher ist ein RSS-Export definitiv nicht als Backup geeignet.

Um die Daten von Serendipity in ein anderes Blogsystem zu überführen, müssen Sie daher auf manuelle Importwege zurückgreifen (siehe Kapitel Wartung) oder auf die Entwicklung eines Import-Moduls des Fremdsystems für Serendipity hoffen. Serendipity selbst bietet eine Reihe von Import-Modulen für andere Blogsysteme an. Häufig sind die Datenbankstrukturen fremder Systeme nicht so weit entfernt voneinander, so dass mit etwas SQL-Kenntnis ein Import vorgenommen werden kann.

Wartung: Daten importieren

Daten importieren Daten importieren|see{Backend, Daten importieren} Backend!Daten importieren

Serendipity kann von anderen Blogsystemen Daten importieren. Über den Menüpunkt Daten importieren finden Sie eine Auswahl des betreffenden Systems, von dem Sie importieren wollen.

Abhängig vom gewählten System können nur Teile der Daten dieses Systems importiert werden, und da es bei fremder Software öfter zu Änderungen der Datenbankstruktur kommt, kann die exakte Versionsnummer beim Import sehr wichtig sein.

Sollte Ihre Blogsoftware in der Liste nicht aufgeführt sein, ist ein Import zu Serendipity dennoch nicht unmöglich. Fragen Sie in diesem Fall in den Serendipity-Styx-Discussions unter https://github.com/ophian/styx/discussions einfach einmal nach, dort wird man sicher helfen können. Grundsätzlich müssen beim Import lediglich Daten auf Datenbankbasis eingelesen und in einem neuen Format gespeichert werden. Wenn Sie über SQL-Kenntnisse verfügen, könnten Sie Ihren eigenen Importer so relativ einfach entwickeln. Details zur Datenbankstruktur von Serendipity finden Sie ab Seite er-schema.

Nachdem Sie das Quell-Blogsystem (siehe vorherige Abbildung: 4.28) gewählt haben, klicken Sie auf Los!. Auf der Folgeseite werden Ihnen abhängig vom gewählten System einige Optionen präsentiert.

Meist ist es wichtig, dass die Datenbank des Zielsystems sich auf demselben Server wie das Serendipity-Blog befindet, um auf die Datensätze zugreifen zu können. Sie sollten auf jeden Fall mittels einer Software wie phpMyAdmin vor dem Import ein Backup sowohl der Serendipity-Datenbank als auch des Quell-Blogs machen.

Der Import-Vorgang in Serendipity kann beliebig oft durchgeführt werden und führt bei jedem neuen Aufruf zum erneuten Import. So kann es also passieren, dass bei mehreren Importversuchen die Artikel mehrfach importiert werden. Nach jedem fehlgeschlagenen Import sollten Sie daher die möglicherweise bereits erstellten Einträge, Kategorien und Autoren wieder löschen.

Folgende Blogsysteme stehen zum Import bereit:

Import!Serendipity Serendipity Serendipity Importiert werden: Daten aus Serendipity Standard Release Datenbank Tabellen. Serendipity Import ist kein Serendipity Upgrader oder Installer und dient nur dazu Tabellendaten eines anderen Blogs in einen weiterführenden und existierenden anderen Blog zu integrieren. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Tabellen-Gruppen, Testlauf. Die Option Zeichensatz gibt an, in welchem Zeichensatz das Import-Serendipity seine Artikel gespeichert hat. Dies ist in neuen Serendipity-Versionen meist UTF-8, und ISO-8859-1 in älteren. Sonderzeichen In Serendipity-Artikeln werden früher Sonderzeichen gerne auch mit HTML-Syntax maskiert. Aus einem Ä wird so ein &Auml;. Serendipity bevorzugt jedoch die echten Sonderzeichen. Wenn Sie die Option Soll versucht werden, HTML-Instanzen automatisch zu konvertieren aktivieren, werden derartige Sonderzeichen wieder korrekt umgewandelt. Sollten Sie beim Import der Einträge später einmal merkwürdige Sonderzeichen erhalten, probieren Sie einmal diese beiden Optionen aus. Mit der Option Imortiere gruppierte Tabellen (aus Gründen der PHP max_execution_time limits bei Blogs mit vielen Einträgen) können Sie erzwingen, dass Datenbank Tabelleneinträge nur gruppiert eingelesen und importiert werden, was die Last und Ausführungszeit deutlich verringern kann. Die wichtigste Option ist der virtuelle Testlauf-Import. Mit seiner Hilfe können Sie recht gefahrlos testen, ob beim Auslesen und Importieren eventuelle Fehler geschehen würden, die vorher dringend gefixt werden müssten. Sie sollten nur Daten gleicher Serendipity Versionen importieren und immer mit einem vollständigen Backup ihrer Datenbank beginnen. Tabellendaten von Plugins, wie zB. Staticpages, sind unbekannt und müssen, ebenso wie anderes, zB die Mediendaten in "/uploads", per Hand importiert werden.

Import!WordPress WordPress WordPress Importiert werden: Autoren, Passwörter, Kategorien, Kommentare, Artikel, Statische Seiten. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks. Die Option Zeichensatz gibt an, in welchem Zeichensatz WordPress seine Artikel gespeichert hat. Dies ist in neuen WordPress-Versionen meist UTF-8, und ISO-8859-1 in älteren. Sonderzeichen In WordPress-Artikeln werden oft Sonderzeichen mit HTML-Syntax maskiert. Aus einem Ä wird so ein &Auml;. Serendipity bevorzugt jedoch die echten Sonderzeichen. Wenn Sie die Option Soll versucht werden, HTML-Instanzen automatisch zu konvertieren aktivieren, werden derartige Sonderzeichen wieder korrekt umgewandelt. Sollten Sie beim Import der Einträge später einmal merkwürdige Sonderzeichen erhalten, probieren Sie einmal diese beiden Optionen aus. Mit der Option Trackbacks an erkannte Links im Eintrag senden können Sie erzwingen, dass alle Trackbacks zu den importierten Einträgen nochmals geschickt werden. Üblicherweise ist dies unerwünscht, daher ist die Voreinstellung auf Nein gesetzt. WordPress kann neben Artikeln auch sogenannte attachments und staticpages speichern. Wenn Sie die Option Auch attachments und staticpages als normale Blog-Einträge importieren aktivieren, werden diese Sonderseiten auch als Serendipity-Artikel importiert.

Import!WordPress PostgreSQL WordPress PostgreSQL Importiert werden: Autoren, Passwörter, Kategorien, Kommentare, Artikel. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks. Eine Abspaltung von WordPress stellt WordPress PostgreSQL dar. Dieses läuft mit einer PostgreSQL- statt MySQL-Datenbank und kann mit identischen Optionen (Datenbankeinstellungen, Sonderzeichen, Trackbacks) wie WordPress importiert werden.

Import!b2Evolution b2Evolution b2Evolution 0.9.0.11 Paris Importiert werden: Autoren, Passwörter, Kategorien, Kommentare, Artikel. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks.

Import!LifeType LifeType LifeType Importiert werden: Autoren, Passwörter, Kategorien, Kommentare, Artikel. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks.

Import!bBlog bBlog bBlog 0.7.4 Importiert werden: Autoren, Passwörter, Kategorien, Kommentare, Artikel. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks.

Import!blogger.com blogger.com Blogger Importiert werden: Autoren, Kommentare, Artikel. Konfigurationsoptionen: Blogger.com-Exportdatei, Passwort für neue Autoren, Zeichensatz, Einteilung erweiterter Artikel. blogger.com stellt einen recht komplizierten Fall des Imports dar. Dieses System läuft nicht auf dem eigenen Webserver, sondern wird von Google bereitgestellt. Daher gibt es auch keinen direkten Datenbankzugriff zum System. Der Blogger-Import besteht aus einer ausführlichen Beschreibung, wie man sein Blog bei Blogger.com konfigurieren muss, um eine Exportdatei herzustellen. Diese Datei kann dann Serendipity wiederum importieren und auslesen. Leider sind die Anweisungen auf die alten Templates von Blogger.com bezogen und können bei der neuen Blogger-Oberfläche nicht ohne Umstellung angewendet werden. Notfalls müssen Sie daher Ihre Einträge von Blogger mittels des Allgemeinen RSS-Imports importieren.

Import!boastMachine boastMachine boastMachine 3.0 Importiert werden: Autoren, Passwörter, Kategorien, Kommentare, Artikel. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks.

Import!Geeklog Geeklog Geeklog 1.3.11 Importiert werden: Autoren, Passwörter, Kategorien, Kommentare, Artikel. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks.

Import!LiveJournal LiveJournal LiveJournal Importiert werden: Nur Artikel. Konfigurationsoptionen: XML-Quelldatei, zugeordnete Kategorie, Artikelstatus. Ähnlich wie Blogger.com ist LiveJournal ein Online-Dienst, der Ihnen keinen direkten Zugriff auf Ihre geschriebenen Artikel ermöglicht. Jedoch ermöglicht es LiveJournal, eine XML-Datei der Einträge zu exportieren. Diese können Sie auf Ihren Webserver hochladen und dem Importer benennen. Leider können über diese XML-Datei nur die Artikel importiert werden und keinerlei andere Informationen.

Import!MovableType MovableType MovableType Importiert werden: Autoren, Passwörter, Kategorien, Kommentare, Artikel. Konfigurationsoptionen: MovableType-Datensätze, Zeichensatz, Debugging, Trackbacks. MovableType speichert seine Daten (in älteren Versionen) in einem für Serendipity nicht zugänglichen Datencontainer. Von der MovableType-Administrationsoberfläche aus können Sie jedoch eine Exportdatei erzeugen. Diese Exportdatei können Sie dann auf den Serendipity-Server hochladen und den Pfad zu dieser Datei beim Importvorgang eintragen. Die MoveableType-Datensätze liegen leider in einem relativ "chaotischen" Format vor, und daher kann es leicht zu defekten Importen kommen. Daher gibt es eine Debugging-Option und die Möglichkeit, trotz defekter Datei lesbare Einträge zu importieren.

Import!Nucleus Nucleus Nucleus Importiert werden: Autoren, Passwörter, Kategorien, Kommentare, Artikel. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks.

Import!Pivot Pivot Pivot Importiert werden: Kategorien, Kommentare, Artikel. Konfigurationsoptionen: Pivot-Datensätze. Pivot speichert seine Dateien in einer zentralen PHP-Datei. Den Pfad zu dieser Datei müssen Sie beim Importvorgang angeben. Alle importierten Artikel werden dem aktuellen Serendipity-Benutzer zugeordnet.

Import!pMachine pMachine pMachine Pro 2.4 Importiert werden: Autoren, Passwörter, Kategorien, Kommentare, Artikel. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks.

Import!sunlog sunlog sunlog 0.4.4 Importiert werden: Autoren, Kategorien, Kommentare, Artikel. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks. Sunlog bietet zwar diverse Zugriffsrechte für seine Redakteure, diese sind jedoch inkompatibel zu Serendipity. Dabei werden beim Import nur die Stammdaten der Redakteure übernommen, und alle Redakteure werden als Administratoren übernommen. Da Sunlog seine Passwörter in einem für Serendipity nicht lesbaren Format speichert, müssen die Passwörter aller Autoren erneut vergeben werden. Standardmäßig wird ein Redakteur dabei mit dem Passwort sunlog angelegt.

Import!Textpattern Textpattern Textpattern 1.0rc1 Importiert werden: Autoren, Kategorien, Kommentare, Artikel. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks. Da Textpattern seine Passwörter in einem für Serendipity nicht lesbaren Format speichert, müssen die Passwörter aller Autoren erneut vergeben werden. Standardmäßig wird ein Redakteur dabei mit dem Passwort txp angelegt.

Import!phpNuke phpNuke phpNuke Importiert werden: Autoren, Kategorien, Kommentare, Artikel. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks.

Import!Voodoopad Voodoopad Voodoopad Importiert werden: Inhalte. Konfigurationsoptionen: VoodooPad-Datendatei. Voodoopad ist eigentlich kein Blogsystem, sondern eher ein Offline-Wiki. Der Importer kann exportierte Daten von Voodoopad übernehmen und als statische Seiten importieren. Daher wird das Serendipity-Plugin Statische Seiten benötigt (siehe Seite staticpage). Im Importer geben Sie den Pfad zu der XML-Datei an, und alle Datensätze darin können daraufhin importiert werden.

Import!phpBB phpBB phpBB Importiert werden: Autoren, Kategorien, Postings. Konfigurationsoptionen: Zugangsdaten, Zeichensatz, HTML-Maskierung, Trackbacks. phpBB ist ein Forensystem. Was in einem Blog die Artikel und Kategorien sind, wird in einem Forum als Bereiche und Postings definiert. Serendipity kann alle eingetragenen Benutzer des Forums importieren und als Serendipity-Redakteur übernehmen. Dabei wird auch erkannt, ob ein Forenbenutzer Administratorrechte hat, und er erhält diese dann auch in Serendipity. Die einzelnen Foren und Unterforen werden in Serendipity als Kategorien und Unterkategorien übernommen. Der jeweils erste Eintrag in einem Foren-Thread wird als Blog-Artikel importiert, alle folgenden Postings des Threads werden als Blog-Kommentar importiert.

Import!RSS RSS-Import Allgemeiner RSS-Import Importiert werden: Nur Artikel. Konfigurationsoptionen: RSS-Feed URL, Artikelstatus, Zugeordnete Kategorie, Zeichensatz, Erweiterter Eintrag. Als letzte Möglichkeit des Artikel-Imports gilt der Allgemeine RSS-Import. Hiermit können Sie einen RSS-Feed in Ihr eigenes Blog importieren. Dabei werden die importierten Artikel dem aktuell eingeloggten Serendipity-Benutzer zugeschrieben. Da in einem RSS-Feed nur sehr wenige Daten vorhanden sind, können nur Artikelstammdaten (Veröffentlichungszeitpunkt, Titel, Text) importiert werden. Sollte eine Kategoriezuordnung im RSS-Feed enthalten sein, versucht der Importer eine gleichnamige Kategorie im Blog zu finden und zuzuordnen. Schlägt das fehl, wird die im Importer festgelegte Standard-Kategorie zugeordnet. In einigen RSS-Feeds kann neben den Artikel-Teasern auch ein erweiterter Artikeltext enthalten sein, der ebenfalls importiert wird. Wenn Sie die Option Füge den gesamten importierten Text in das einzelne Text-Feld ein auf Ja setzen, wird sämtlicher verfügbarer Inhalt in das Hauptfeld des Blog-Artikels übernommen. Andernfalls versucht Serendipity, den Teaser-Text und vollständigen Text des RSS-Artikels sinnvoll aufzuteilen. Als Sonderfall des RSS-Imports dient das WPXRSS-Format. Dieses wird von WordPress-Blogs eingesetzt und enthält außer Artikeln auch Informationen zu Kategorien, Kommentaren und Redakteuren. Das WPXRSS-Format funktioniert nur auf Webservern mit PHP5-Unterstützung. Bitte beachten Sie, dass dieser Importvorgang nicht für den regelmäßigen Import eines RSS-Feeds gedacht ist. Dafür gibt es das RSS Aggregator-Plugin, siehe Seite aggregator.

Wartung: Vorschauen erneuern

Vorschauen erneuern Vorschauen!erneuern|see{Backend, Vorschauen erneuern} Backend!Vorschauen!erneuern erneuern

Dieser Vorgang wurde bereits im Kapitel der Mediathek genauer beschrieben. Siehe: Vorschauen erneuern. Bitte lesen Sie dort nach was es mit dieser Wartungsaufgabe auf sich hat.

Spamblog Log Wartung

Spamblog Log Wartung Spamblog!Log!Wartung|see{Backend, Spamblog Log Wartung} Backend!Spamblog!Log!Wartung Log!Wartung Wartung

Wie bereits in Kapitel VIII beschrieben, verursachen Datenbank Logeinträge, wie zum Beispiel beim Spamblock Plugin, mit der Zeit eine unnötig große Aufblähung ihrer Datenbank. Dies kann Ihr System mit der Zeit also stetig verlangsamen. Siehe: Spamblocklog Dateineinträge Löschen. Die dort vorgeschlagenen manuellen SQL Queries zum Aufräumen solchen Masseneinträge, sind hier schon einmal automatisiert gelistet, so dass Sie diese Wartungsaufgabe einfach nur ab und an selber anklicken müssen. Sodann werden Datenbank-Logeinträge gelöscht, die bestimmten Kriterien unterliegen. Erfahrungsgemäß sind, je nach Einstellung der vorhandenen Spamblog Plugins, die beiden Typen (moderate und rejected) hauptsächlich mit Spam bestückt. Sie haben hier die Wahl entweder grob oder selektiv Löschungen anzustoßen.

Wartung: Service Wartungs Modus

Service Wartungs Modus Service!Wartungsmodus|see{Backend, Service Wartungs Modus} Backend!Service!Wartungsmodus Wartungsmodus

Über das zu installierende serendipity_event_modemaintain modemaintain event Plugin, kann Ihr öffentliches Blog - das Frontend - in einen “503 - Service Temporarily Unavailable” Modus (einen temporären 503 Wartungsmodus) versetzt werden. Die Bedingung dafür ist, dass sie sich mit der LogIn Daten speichern Methode angemeldet haben und sich während des Vorganges weder ausloggen, noch ihr Browserfenster schließen. Diese LogIn Methode geschieht über das Login-Cookie, welches Ihnen erlaubt, über die temporäre Sitzung hinaus angemeldet zu bleiben. Wie das geht, können Sie bei Login unter Option Daten speichern nachlesen. Ansonsten können Sie ihr Blog frei im Backend und im Frontend bedienen und anschauen. Ist der Vorgang der Wartung, zB ein Serendipity Upgrade, abgeschlossen, deaktvieren Sie dem Modus wieder. Bitte lesen Sie die Informationen zu dieser Wartungsaufgabe genau durch, damit Sie sich nicht versehentlich selber aussperren!

Wartung: Zeige Serendipity Logfiles

Zeige Serendipity Logfiles Serendipity Logfiles|see{Backend, Serendipity Logfiles} Backend!Serendipity Logfiles Logfiles

Wenn Sie das changelog event Plugin installiert haben (default) und die Konfigurationsoptions Log Level auf Fehler oder Debug gestellt haben, werden bestimmte Ereignisse zB. bei Trackbacks oder bei bestimmten Mediathekaktionen während des Vorganges im Hintergrund still in eine Logdatei geschrieben. Diese können Sie dann hier und nur hier einsehen. Der Zugriff auf diese Logdateien sollte über das Frontend sollte nicht möglich sein. Löschen Sie die alten Logfiles trotzdem regelmäßig, wenn sie ihren Dienst getan haben, denn sie könnten relevante Informationen enthalten. Die default Einstellung zur Logausgabe lautet: Nein. Ohne weiteres Zutun kann hier ansonsten nur das Serendipity Styx ChangeLog einfach im Browserfenster ausgelesen werden, damit Sie sich über all die kleineren und größeren Veränderungen zwischen den Release Versionen auf dem Laufenden halten können.

Wartung: UTF-8 MB4 Migration

UTF-8 MB4 Migration UTF-8MB4!Migration|see{Backend, UTF-8 MB4 Migration} Backend!UTF-8MB4!Migration Migration

UTF8MB4 ist mit Serendipity Styx 2.4+ und MySQL die Default Installations-Kollation, wenn vom Server unterstützt. In diesem Fall sehen Sie bereits die grün hervorgehobene Erfolgsmeldung, wie auf der Abbildung 4.28: Einstellungen: Wartung (Beispielseite) zu sehen.

Für Serendipity (+ Styx) Upgrader: Wenn Sie Serendipity Styx 2.4+ mit MySQLi- und UTF-8-Zeichensätzen (Standard) verwenden, können die Datenbanktabellen und Indizes von UTF-8 nach UTF-8 mit Multibyte-Erweiterung migriert werden, um auch Unicode-Zeichen außerhalb des "Basic Multilingual Plane" (BMP) zu unterstützen, wie zB. Emojis. UTF8mb4 ist für MySQL eine Obermenge von UTF-8. Wenn ihr MySQLi-Treiber oder die MySQL Server-Version kleiner ist als Version 5.5.3, oder ihre aktuelle Installation den UTF-8 Zeichensatz nicht verwendet, ist UTF8MB4 nicht unterstützt. Um UTF8MB4 verwenden zu können, stellen Sie sicher, dass Ihr Blog für den UTF-8 Zeichensatz konfiguriert ist, und bestehende Daten nach UTF-8 konvertiert wurden, indem Sie ein Tool wie mysqldump für Export, Konvertierung nach UTF-8 und den Import verwenden.

Die grüne Erfolgsmeldung über ihre Systemvoraussetzung ist natürlich, oder spätestens nach einiger Zeit, überflüssig zu behalten und kann seit Serendipity Styx 3 über das eingefügte icon permanent weggeklickt werden.

Wartung: Plugin Altlastenmanager

Plugin Altlastenmanager Backend!Plugin Altlastenmanager Altlastenmanager

Das mächtige Plugin Werkzeug muss ebenso wie die Mediathek mit der Datenbank synchron gehalten werden. Mit der Zeit aber sammeln sich hier ehemals installierte Plugins, werden dann deaktiviert oder nur unvollständig deinstalliert. Jedenfalls existierten über Jahre solche Zombies ohne jemals mit ihrer remote Version von Spartacus aktualisiert zu werden. Häufig wurden diese dann zur erneuten Installaton vorgeschlagen, wenn Sie die Liste der neue-plugins-installieren aufriefen. Solch alte Versionen konnten dann mitunter das ganze System aus dem Tritt bringen. Löschen Sie die alten Plugins also regelmäßig, wenn sie ihren Dienst getan haben. Der Button Suche nach Plugin Zombies zeigt eine multi-select Liste, aus der alle darin von Ihnen gewählten Plugins wirklich vom System gelöscht werden können.

Wartung: Theme Altlastenmanager

Theme Altlastenmanager Backend!Theme Altlastenmanager Altlastenmanager

Auch die Themes bieten ein schier endloses Kuddelmuddel, wenn sie nicht den jeweils aktuellen Versionen entsprechen. Zu unterscheiden sind Core-Themes und Remote-Themes. Letztere werden über Spartacus geholt und bereitgestellt. Ihre Leichen aber liegen oft über Jahre herum und sollten wirklich gelöscht werden. Wenn Sie sie wieder benötigen, laden Sie sie neu herunter, dann aber guten Gewissens, dass diese wirklich dem letzten Stand entsprechen. Die einzigen Themes die sie vielleicht behalten wollen sind jene, an die Sie selbst Hand angelegt haben und sie als eine Art sentimentale Grabbelkiste behalten wollen. Doch wenn Jahre vergehen, ist das Vorgänger-Theme auf Spartacus möglicherweise dem alten Zustand schon entrückt. Gerade Styx hat alle alten Themes aus dem additional_themes Repository auf einen halbwegs akzeptablen Zustand gebracht und tut dies bis Heute, wenn etwas Wichtiges und das wirklich alle Theme betrifft auffällt. Der Button Suche heruntergeladene Themes zeigt eine multi-select Liste aus der alle darin von Ihnen Themes Plugins wirklich von Ihrem System gelöscht werden können.

Archive
serendipity_plugin_archives

Plugins!Archive Plugins!serendipity_plugin_archives

Das Plugin Archive zeigt eine Übersicht der letzten Monate an. Ein Klick auf den jeweiligen Monat öffnet die Artikelübersicht für den gewünschten Zeitraum.

In der Konfiguration des Plugins können Sie neben der Überschrift des Plugins auch angeben, ob das Plugin Monate, Wochen oder Tage gliedern soll. Die Anzahl der Einträge im Archiv gibt an, wie viele Ausgaben im Plugin erfolgen sollen.

Wenn Sie die Option Anzahl der Einträge pro Kategorie anzeigen aktivieren, wird hinter jeder Ausgabe des Plugins in der Seitenleiste die Anzahl von Einträgen eingeblendet, die Sie in diesem Zeitraum erstellt haben. Achten Sie beim Aktivieren dieser Option darauf, dass diese die Geschwindigkeit des Plugins stark verringert. Das Auslesen der Anzahl aller Artikel pro Zeitraum ist eine komplexe Datenbankabfrage.

Wenn Sie die Option Versteckt den Archiv-Link, wenn es keine Einträge für einen Zeitraum gab... aktivieren, können in der Ausgabe der Monatsarchive diejenigen Monate übergangen werden, in denen Sie keine Blog-Artikel geschrieben haben. Damit dies klappt, müssen Sie die Option Anzahl der Einträge pro Kategorie anzeigen ebenfalls aktivieren.

Stapelbare Plugins wie dieses - also Plugins die Mehrfachinstallationen erlauben - werden mit einem Icon vor dem Pluginnamen ausgezeichnet. Der Info Button öffnet die zusätzliche Plugin Beschreibung bzw räumt dies aus dem Weg.

Kategorien
serendipity_plugin_categories

Plugins!Kategorien Plugins!serendipity_plugin_categories categoriesplugin

Dieses Plugin blendet die im Blog verfügbaren Kategorien ein. Wenn Sie Ihr Blog als eine Art CMS betreiben, wird dieses Seitenleisten-Plugin daher oft als Menü benutzt, um auf die jeweiligen Unterbereiche zu gelangen.

Ein Klick auf die im Plugin dargestellte Kategorie ruft dabei jeweils die Artikelübersicht dieser Kategorie auf.

Konfigurationsoptionen sind:

Quelle der Kategorien Wie im Kapitel kategorie-leserechte auf Seite kategorie-leserechte erwähnt, können für Kategorien besondere Leserechte gelten, so dass nur eingeloggte Mitglieder einer Benutzergruppe Einträge dieser Kategorie lesen können. Standardmäßig stellt das Kategorien-Plugin alle Kategorien dar, die im Blog angelegt sind - ganz gleich, ob dafür besondere Leserechte gelten, oder nicht. Wenn ein Besucher auf eine solche Kategorie klickt, kann es daher sein, dass er darin keine Artikel angezeigt bekommt. Deshalb ist es möglicherweise wünschenswert, wenn einem Leser auch nur die Kategorien angezeigt werden, zu denen er auch Leserechte besitzt. Dafür ist das Auswahlfeld Quelle der Kategorien vorgesehen. Dort wählen Sie eine Benutzergruppe aus, so dass nur Kategorien angezeigt werden, die für die gewählte Benutzergruppe sichtbar sind. Standardmäßig steht diese Option auf Alle Autoren. Sie müssen die Sonderoption Derzeitiger Autor wählen, wenn die Kategorieliste sich nach den Rechten des aktuell eingeloggten Besuchers richten soll.

Zeige nur Kategorien unterhalb... Da Kategorien in Serendipity schachtelbar sind, kann es recht komplexe Kategorie- bzw. Menüstrukturen abbilden. Möglicherweise soll in der Seitenleiste aber nur ein Teil dieser Struktur angezeigt werden. Daher können Sie im Auswahlfeld Zeige nur Kategorien unterhalb... festlegen, ab welcher Oberkategorie die Unterrubriken angezeigt werden.

Die gewählte Oberkategorie verstecken Wenn Sie im obigen Konfigurationsfeld eine Kategorie ausgewählt haben, bestimmt die Option Die gewählte Oberkategorie verstecken, ob der Name dieser Oberkategorie angezeigt (Nein) oder versteckt (Ja) wird.

XML-Button Für die Artikel jeder einzelnen Kategorie kann ein RSS-Feed abonniert werden. Dazu wird neben jedem Kategorienamen ein kleines Bild eingeblendet, auf das ein Benutzer klicken kann, um den RSS-Feed der Kategorie zu abonnieren. Dieses Bild stellt üblicherweise ein universelles RSS-Icon dar, das von zahlreichen Blogsystemen und Browsern einheitlich benutzt wird. Sie können aber gerne in dem Konfigurationsfeld XML-Button ein abweichendes Bild eintragen. Dazu müssen Sie den vollständigen HTTP-Pfad (alles hinter http://www.example.com/) eingeben. Wenn Sie kein Bild einbinden wollen, tragen Sie hier none ein.

Sortierung!Kategorien Sortierung Zwei Auswahlfelder untereinander werden bei der Konfigurationsoption Sortierung dargestellt. Das obere Auswahlfeld bestimmt, nach welchem Kriterium die Liste der Kategorien sortiert werden soll. Da Kategorien innerhalb Serendipity noch nicht beliebig sortiert werden können, entscheidet also ausschließlich diese Sortierungsreihenfolge die Reihenfolge der Darstellung in der Seitenleiste. Standardmäßig werden die Kategorien nach dem Namen der Kategorie alphabetisch sortiert. Weitere Möglichkeiten sind eine Sortierung nach Beschreibung oder der ID einer Kategorie. Auch kann eine Sortierung nach keinem Kriterium ausgewählt werden, in diesem Fall werden die Kategorien so wie sie in der Datenbank abgelegt sind geordert. Das zweite Auswahlfeld gibt dabei an, ob die Kategorien absteigend (also von A bis Z oder 0 bis 9) oder aufsteigend (von Z bis A bzw. 9 bis 0) sortiert werden sollen. Wenn Sie eine ganz individuelle Auflistung von Kategorien haben möchten, gibt es zwei Möglichkeiten. Die erste Möglichkeit wäre, einfach eine manuelle HTML-Liste der Kategorien zu erstellen und als HTML-Klotz Seitenleisten-Plugin (Seite htmlnugget) einzufügen. Dadurch verlieren Sie natürlich die anderen dynamischen Möglichkeiten des Plugins. Die zweite Möglichkeit wäre, das Feld Beschreibung einer Kategorie zu missbrauchen, indem Sie nicht einen Text, sondern eine Zahl darin aufschreiben. Durch die Eingabe einer Zahl für die Reihenfolge der Kategorien können Sie in der Sortierung die Reihenfolge beeinflussen. Das bedeutet jedoch auch, dass Sie dann keine normale textliche Beschreibung der Kategorie mehr nutzen können. Da diese Beschreibung sonst aber nur für Redakteure gilt, ist dies möglicherweise zu verkraften.

Mehrere Kategorien!darstellen Besuchern erlauben, mehrere Kategorien gleichzeitig darzustellen? Wenn ein Besucher in der Darstellung des Plugins auf eine einzelne Kategorie klickt, sieht er alle Einträge dieser Kategorie. In manchen Fällen möchte ein Besucher aber gerne Inhalte mehrerer Kategorien auf einmal ansehen. Wenn Sie die Option Besuchern erlauben, mehrere Kategorien gleichzeitig darzustellen aktivieren, wird neben jeder Kategorie ein Ankreuzfeld angezeigt. Der Besucher kann alle gewünschten Kategorien markieren und danach auf den Button Los klicken, um die Auswahl zu setzen. Ist die Option deaktiviert, wird diese Auswahlbox nicht mehr angezeigt. Dennoch kann ein Besucher spezielle URLs aufrufen, in denen er mehrere Kategorien auf einmal ansehen kann (siehe Seite Permalinks-Kategorien). Die Deaktivierung der Option nimmt dem Benutzer also höchstens die komfortable Möglichkeit zu einer solchen Übersicht und beeinflusst die Darstellungsweise des Plugins.

Kategorien verstecken, die nicht Teil des vom Besucher gewählten Kategoriebaums sind Wenn Sie eine verschachtelte Kategoriestruktur eingerichtet haben, stellt diese eine Baumstruktur dar. Dabei sind jeweils einer Oberkategorie eine oder mehrere Unterkategorien zugeordnet. Wenn Sie Serendipity als eine Art CMS einsetzen, bei dem die Kategorien Menüpunkten entsprechen, wünschen Sie sich möglicherweise, dass bei einem Klick auf eine Unterkategorie die anderen "parallelen" Menüpunkte nicht mehr angezeigt werden. Stellen Sie sich folgenden Kategorienbaum vor: Oberkategorien A, B und C. Jede Kategorie besitzt zwei Unterkategorien: A1 und A2, B1 und B2 sowie C1 und C2. Wenn der Besucher nun auf die Unterkategorie A1 klickt, würden Sie gerne nur die Kategorien A und A2 anzeigen. Die Kategorien und Unterkategorien von B und C sollen verschwinden. Genau zu diesem Zweck dient die Option Kategorien verstecken... Wenn diese Option aktiviert ist, werden die nicht zum gewählten Kategoriebaum passenden restlichen Kategorien nicht mehr in der Ausgabe des Plugins angezeigt. Sie müssten dann zuerst wieder auf die Startseite zurück (oder auf andere Menüpunkte klicken), um die ausgeblendeten Kategorien wieder zu sehen.

Anzahl der Einträge pro Kategorie anzeigen Wenn Sie möchten, dass die Anzahl der Artikel in einer Kategorie in der Ausgabe des Plugins neben dem Kategorienamen angezeigt wird, können Sie die Option Anzahl der Einträge pro Kategorie anzeigen aktivieren. Performance Beachten Sie auch hier, dass die Aktivierung die Geschwindigkeit des Plugins stark beeinflusst, da das Zählen aller Artikel der Datenbank einige Zeit beansprucht. Wenn Sie Einträge zu mehr als einer Kategorie zuweisen, wird dieses Plugin (leider) für jede zugewiesene Kategorie den Artikel erneut zählen. Daher kann es passieren, dass die angezeigte Artikelzahl höher ist als die in Wirklichkeit vorhandenen Artikel.

Smarty-Templating aktivieren Damit Sie dieses Plugin möglichst komfortabel anpassen können, gibt es die Template-Datei Template-Dateien!plugin_categories.tpl plugin_categories.tpl. Nur wenige Seitenleisten-Plugins verfügen über ein eigenes Smarty-Template, da meistens Änderungen per CSS bereits vollkommen ausreichen. Aus Performancegründen wird diese Template-Datei daher auch standardmäßig nicht benutzt. Wenn Sie also ein eigenes Template für das Aussehen der Kategorie-Auflistung benutzen wollen, müssen Sie die Konfigurationsoption Smarty-Templating aktivieren auf Ja setzen. Die eingesetzten Variablen dieser Datei werden auf Seite plugin-categories-tpl erklärt.

Powered by
serendipity_plugin_plug

Plugins!Powered by Plugins!serendipity_plugin_plug plugplugin

Ein ebenfalls recht simples Plugin ist Powered by. Es gibt das Logo von Serendipity mit einem Link zur Webseite https://ophian.github.io/ aus und erlaubt es Ihren Besuchern, zu sehen, welche großartige Software hinter Ihrem Blog steckt.

Die Konfigurationsoptionen des Plugins ermöglichen eine Feineinstellung, ob man nur das Logo oder nur den Text anzeigen möchte.

Verwaltung des Blogs
serendipity_plugin_superuser

Plugins!Verwaltung des Blogs Plugins!serendipity_plugin_superuser

Mit dem Plugin Verwaltung des Blogs binden Sie einen einfachen Link im Frontend ein, auf den Sie als Redakteur klicken können, um ins Backend zu gelangen. Das Plugin erkennt dabei automatisch, ob Sie schon eingeloggt sind, und gibt dementsprechend entweder einen Link zum Login oder direkt zum Backend aus.

HTTPS Die einzige Konfigurationsoption des Plugins gibt an, ob Sie das HTTPS zum Login benutzen möchten. Ihr Server muss HTTPS (siehe Terminologie auf Seite https) unterstützen und ein gültiges Zertifikat für den Server besitzen, auf dem Serendipity installiert ist. Nur bei der Benutzung von HTTPS ist gewährleistet, dass Ihr Benutzername und Passwort nicht im Klartext (sondern verschlüsselt) an den Server übertragen werden und niemand Ihre Logindaten abfangen kann.

Blog abonnieren
serendipity_plugin_syndication

Plugins!Blog abonnieren Plugins!serendipity_plugin_syndication syndication

Das Plugin stellt die verschiedenen Optionen zum Abonnieren Ihres Blogs mittels RSS-Feed dar. Dabei wird in der Seitenleiste für jedes gewünschte Format ein Link eingebunden, den Ihre Besucher in ihr RSS-Programm übernehmen können.

Neben dem Titel des Plugins in der Seitenleiste sowie der Aktivierung der zahlreichen Feed-Formate bietet das Plugin folgende Konfigurationsoptionen:

FullFeed syndication-fullfeed Vollständige RSS-Feeds Volle Einträge mit erweitertem Text im RSS-Feed einbinden Ein RSS-Feed enthält üblicherweise nur den Text eines Artikels, den Sie im Feld Eintrag erfasst haben. Der Erweiterte Eintrag ist nicht Bestandteil der RSS-Feeds, und somit muss ein Benutzer Ihr Blog besuchen, um den vollständigen Artikel lesen zu können. Dies ist häufig gewünscht, um mehr Besucher auf die Webseite zu "locken". Um Ihren Besuchern mehr Komfort zu bieten, können Sie aber auch den vollständigen Artikel im RSS-Feed eintragen. Mit dieser Konfigurationsoption können Sie dieses Verhalten beeinflussen. Wenn Sie die Option Client aktivieren, kann, wie im Abschnitt FullFeed auf Seite FullFeed erwähnt, der Leser selbst bestimmen, ob er einen vollständigen RSS-Feed haben will oder nicht. Dazu muss er Ihren RSS-Feed über die Datei rss.php?fullFeed=true abonnieren. Dies ist natürlich relativ versteckt, so dass Sie Ihre Besucher über diese mögliche Variante informieren müssten.

syndication-feedburner FeedBurner FeedBurner Feed Der Webservice feedburner ist ein auslaufendes Angebot von Google, das Statistiken über die Auslieferung Ihres RSS-Feeds und einige weitere Möglichkeiten der Einbettung bietet. Bei einem FeedBurner-Feed kann der Aufruf des RSS-Feeds im Browser direkt hübsch formatiert sein, statt als für den Besucher merkwürdiger XML-Datensatz zu erscheinen. FeedBurner ermöglicht auch die Einbindung von Werbung und verwandten Tags. Bei FeedBurner müssen Sie sich separat anmelden und dem Service die URL Ihres RSS-Feeds mitteilen. FeedBurner wird dann regelmäßig diese URL aufrufen, Ihren RSS-Feed einlesen, ihn konvertieren und danach unter einer eigenen FeedBurner-URL (die Sie konfigurieren können) anbieten. Damit die Statistikzählung aktiviert wird, müssen Ihre Besucher künftig diesen FeedBurner-Feed abonnieren und nicht den üblichen Serendipity-Feed. Dazu dient die Einstellung Feedburner Feed im Plugin. Wenn diese Variable auf Ja steht, wird der Link zum Feedburner-Feed in Ihrer Seitenleiste angezeigt. In diesem Fall sollten Sie alle anderen Feed-Formate deaktivieren, da die Besucher ja nur noch den FeedBurner-Feed aufrufen sollen. Wenn Sie die FeedBurner-Option lediglich auf Ja gestellt haben, bleiben die URLs zu Ihren alten RSS-Feeds weiterhin intakt, sie werden lediglich versteckt. Wenn Sie Ihre Besucher aber in Zukunft auch von diesen verstecken URLs fernhalten wollen, stellen Sie die FeedBurner-Option auf Erzwingen. Dadurch wird jeder Aufruf des Serendipity-RSS-Feeds automatisch auf die FeedBurner-Feeds umgeleitet. Zu welchem FeedBurner-Feed Serendipity verweist, stellen Sie am Ende der Konfigurationsoptionen ein.

E-Mail-Adresse einbinden? Standardmäßig muss ein RSS-Feed zu jedem Autor eine E-Mail-Adresse anzeigen. Dies wird leider gegenwärtig häufig von SPAM-Robotern missbraucht, um E-Mail-Adressen im Internet zu sammeln. Daher können Sie über die Option E-Mail-Adresse einbinden einstellen, ob Ihre echte E-Mail-Adresse oder eine vorgetäuschte E-Mail-Adresse (nospam@example.com) eingebunden wird. Beachten Sie, dass, wenn Sie im Anti-Spam-Plugin (Seite spamblock) die gleichnamige Option aktiviert haben, diese ebenfalls die Darstellung der E-Mail-Adressen beeinflusst. In abgegrenzten Blogs (im Intranet zum Beispiel) macht die Aktivierung dieser Option noch Sinn, beim Einsatz im Internet ist es jedoch empfehlenswert, die Option auf Nein zu setzen.

Feld "managingEditor" Der RSS 2.0-Feed ermöglicht die Einbindung eines optionalen Feldes, das die E-Mail-Adresse des leitenden Redakteurs eines Blogs enthalten kann. Abonnenten des RSS-Feeds können sich so leicht an den inhaltlich Verantwortlichen wenden. Auch hier gelten die obigen Bedenken, dass enthaltene E-Mail-Adressen oft Spammern zum Opfer fallen könnten.

Feld "webMaster" Analog zu einem inhaltlich Verantwortlichen kann diese Option eine E-Mail-Adresse des technisch Verantwortlichen enthalten.

Feld "ttl" (time-to-live) RSS-Feeds müssen von RSS-Readern regelmäßig abgerufen werden, damit neue Artikel gefunden werden können. Üblicherweise wird ein solcher RSS-Reader alle 30 oder 60 Minuten (je nach Einstellung Ihrer Besucher) Ihre RSS-Feeds abrufen. Sie können über das Feld ttl (Gültigkeitsdauer) innerhalb des RSS-Feeds für RSS-Reader vorschlagen, wie lange Ihr Feed üblicherweise gültig ist. Diesen eingestellten Wert können RSS-Programme dann als Richtlinie für die Aktualisierungshäufigkeit benutzen. Traffic Der ttl-Wert wird in Minuten angegeben, wenn Sie also üblicherweise nur einen Artikel pro Tag online stellen, können Sie ihn auf 1440 stellen (entspricht 24 Stunden). Damit können Sie dann möglicherweise einiges an Traffic auf Ihrem Webserver sparen, wenn sich die RSS-Reader daran halten.

Feld "pubDate" Ein RSS-Feed kann ein optionales pubDate-Feld enthalten, das Auskunft über den Erstellungszeitpunkt des letzten Artikels gibt. Dieser Wert wird von vielen RSS-Readern benutzt, um Aktualisierungen festzustellen, daher raten wir von der Deaktivierung dieser Option ab.

XML-Button Neben jedem RSS-Feed wird in der Seitenleiste eine kleine Grafik angezeigt, die standardmäßig dem Standardsymbol für RSS-Feeds entspricht. Wenn Sie eine eigene Grafik benutzen wollen, können Sie den Pfad zu der Grafik in dem Feld XML-Button eintragen. Die Grafik muss sich dabei in Ihrem Template-Verzeichnis befinden, und der hier eingetragene Pfad muss relativ zu Ihrem Template-Verzeichnis sein. Wenn die Datei also in /var/www/example.com/serendipity/templates/meinTemplate/bilder/MeinRSS.gif liegt, tragen Sie im Konfigurationsfeld bilder/MeinRSS.gif ein.

Bild für den RSS-Feed Das RSS 2.0-Format ermöglicht es, ein eigenes Logo für den Feed einzutragen. Diese Grafik kann dann von RSS-Readern in der Titelzeile oder an anderen Stellen angezeigt werden. Wenn Sie hier nichts eintragen, wird standardmäßig das Serendipity-Logo eingebunden. Tragen Sie in diesem Feld die vollständige URL zu einem Bild ein, also etwa http://www.example.com/MeinLogo.jpg. Diese Grafikdatei darf maximal 144 Pixel breit und 400 Pixel hoch sein. Die genauen Maße des Bildes müssen Sie in den beiden darunterliegenden Feldern Breite des Bildes und Höhe des Bildes eintragen.

FeedBurner-ID, Titel, Bildunterschrift und Bild Die letzten vier Konfigurationsoptionen betreffen Sie nur, wenn Sie den oben erwähnten FeedBurner-Service benutzen. Als ID müssen Sie die im FeedBurner dargestellte ID Ihres Feeds eintragen, sie entspricht dem Namen, den Sie in der URL https://feeds.feedburner.com/ID sehen. Wenn Sie den Feedburner-Feed aktiviert haben, wird ein Link dorthin im Seitenleisten-Plugin angezeigt. Dieser Link wird begleitet von einem Bild und einem Linktitel. Im Feld FeedBurner Titel können Sie diesen Titel vergeben, der neben der Grafik dargestellt wird. Die Grafikdatei müssen Sie mit einer vollständigen URL wie https://www.example.com/feedburner.jpg eintragen. Wenn Sie dieses Feld leer lassen, sehen Sie eine Standardgrafik, die den Besucherzähler darstellt. Im Feld FeedBurner Bild-Unterschrift können Sie einen Text hinterlegen, der angezeigt wird, wenn Sie mit der Maus über die FeedBurner-Grafik fahren. Dort können Sie beispielsweise eine kurze Beschreibung eintragen, warum Sie FeedBurner benutzen.

Autoren
serendipity_plugin_authors

Plugins!Autoren Plugins!serendipity_plugin_authors

Das Plugin Autoren stellt in der Seitenleiste eine Liste aller im Blog eingetragenen Redakteure dar. Ein Klick auf einen Autor führt dann zu der Übersicht der von ihm geschriebenen Artikel.

Die Konfigurationsoptionen des Plugins sind:

XML-Button Für jeden Autor steht ein eigener RSS-Feed-Link zur Verfügung, über den Einträge dieses Autors abonniert werden können. Die Grafik muss sich dabei in Ihrem Template-Verzeichnis befinden, und der hier eingetragene Pfad muss relativ zu Ihrem Template-Verzeichnis sein. Wenn die Datei also in /var/www/example.com/serendipity/templates/meinTemplate/bilder/MeinRSS.gif liegt, tragen Sie im Konfigurationsfeld bilder/MeinRSS.gif ein.

Mehrfachauswahl von Autoren erlauben? Ähnlich wie bei der Liste aller Kategorien, kann in der Liste aller Autoren vom Besucher eine Auswahl getroffen werden, welche Artikel er dargestellt sehen will. Üblicherweise kann er mit dem Klick auf den Link eines Redakteurs nur die Einträge eines einzelnen Redakteurs sehen. Ist die Option Ermöglicht Besuchern, Einträge mehrerer Autoren gleichzeitig darzustellen aktiviert, wird neben jedem Redakteur ein Ankreuzfeld angezeigt, das der Besucher für alle gewünschten Redakteure markieren kann, um so die Übersicht der Artikel dieser Redakteursgruppe lesen zu können.

Anzahl der Artikel neben dem Autor-Namen anzeigen Wenn Sie diese Option aktivieren, wird in Klammern hinter dem Redakteursnamen die Anzahl der von ihm verfassten Artikel angezeigt. Bitte beachten Sie, dass die Aktivierung dieser Zählung relativ datenbankintensive Abfragen durchführen muss und daher möglicherweise zu Geschwindigkeitseinbußen führen kann.

Nur Autoren mit mindestens X Beiträgen anzeigen Möglicherweise möchten Sie nur aktive Redakteure des Blogs aufführen. Daher können Sie in dem Eingabefeld eine Mindestzahl an Beiträgen eintragen, die ein Redakteur geschrieben haben muss, um in der Seitenleiste angezeigt zu werden. Für diese Option gelten dieselben Performance-Bedenken wie bei der vorherigen. Sollten Sie eine von beiden aktivieren, wird die Aktivierung der anderen Option jedoch darüber hinaus keine weiteren Einbußen zur Folge haben.

Kalender
serendipity_plugin_calendar

Plugins!Kalender Plugins!serendipity_plugin_calendar

Dieses Plugin wurde mit Serendipity 2.0+ aus der Liste aktiver Plugins gestrichen, da der Kalender als Artikelnavigation heutzutage kaum noch genutzt wird und als mehr oder weniger nicht mehr zeitgemäß betrachtet wird.

Der Kalender zeigt einen blätterbaren Kalender eines Monats in der Seitenleiste an. Einzelne Tage des Kalenders können dabei hervorgehoben werden und zeigen dem Besucher an, dass an diesem Tag ein Blog-Artikel verfasst wurde. Der aktuelle Tag wird ebenfalls hervorgehoben.

In den Konfigurationsoptionen können Sie den Tag des Wochenanfangs festlegen und die Anzeige von Artikeln zu einem Tag auf eine spezielle Kategorie beschränken.

Die Option Plugin-Schnittstelle aktivieren können Sie aktivieren, wenn Sie anderen Plugins erlauben wollen, Tage im Kalender hervorzuheben. Das Plugin Mein Kalender kann diese Option beispielsweise benutzen, um Ihre persönlichen Termine anzufügen.

Zuletzt können Sie einstellen, welche Kategorie als Ausgangspunkt der im Kalender angezeigten Blog-Artikel verwendet wird. Standardmäßig werden alle Kategorien dafür benutzt, Sie können aber auch eine spezielle Kategorie auswählen. Wenn der Besucher die Blog-Artikel selbständig auf eine spezielle Kategorie eingrenzt und das Plugin als Ausgangspunkt Alle Kategorien verwendet, so wird automatisch die aktuelle Kategorie als Datenquelle zur Kalenderdarstellung eingesetzt.

Die Darstellung erfolgt mittels der Template-Datei Template-Dateien!plugin_calendar.tpl plugin_calendar.tpl, deren Variablen auf Seite plugin-calendar-tpl erklärt werden.

Kommentare
serendipity_plugin_comments

Plugins!Kommentare Plugins!serendipity_plugin_comments Plugin-Kommentare

Wenn Ihre Besucher Kommentare zu einem Beitrag hinterlassen, können Sie als Redakteur diese relativ leicht über den Backend-Menüpunkt Kommentare einsehen oder werden sogar per E-Mail darüber benachrichtigt. Normale Besucher haben diese Möglichkeit nicht und können daher entweder den RSS-Feed der letzten Kommentare abonnieren oder müssten jeden Blog-Artikel individuell aufrufen, um sich über neue Kommentare zu informieren.

Daher bietet das Seitenleisten-Plugin Kommentare eine einfache Möglichkeit, die letzten Kommentare aller Artikel anzuzeigen und so für den Besucher übersichtlich einzubinden.

Folgende Konfigurationsoptionen bietet das Plugin, abgesehen vom Seitenleisten-typischen Titel:

Zeilenumbruch In der Seitenleiste steht meist nur begrenzt Platz zur Darstellung von Text zur Verfügung. Gerade Kommentare können jedoch die zur Verfügung stehende Breite übermäßig strapazieren. Daher bietet die Option Zeilenumbruch die Möglichkeit, den Platzbedarf einzuschränken, indem nach einer festgelegten Anzahl von Buchstaben ein harter Zeilenumbruch eingefügt wird. Der Zeilenumbruch wird dabei auch Wörter mittendrin trennen, um das Limit nicht zu überschreiten. Dies ist notwendig, damit überlange Wörter Ihrer Besucher (wie zB. "Coooooooooooooooooooool!") nicht das Layout Ihrer Seite sprengen. Leider bereitet der Zeilenumbruch gerade dann Probleme, wenn Besucher lange Links posten, die dann auseinandergebrochen werden. Sollte dies bei Ihnen häufig vorkommen, können Sie die Buchstabenanzahl des Zeilenumbruchs auf eine hohe Zahl wie 999 setzen und dann den Zeilenumbruch dem Browser überlassen. Dabei empfiehlt es sich dann, mittels CSS mögliche Layoutprobleme zu verhindern. Fügen Sie dazu die Zeile .plugin_comment_body { overflow: scroll } am Ende der Datei style.css Ihres gewählten Templates hinzu (siehe Kapitel template-css). Dies wird den Browser dazu anweisen, überlange Wörter durch Scrollbalken innerhalb der Seitenleiste anzuzeigen und nicht die ganze Seitenleiste an die Wortbreite anzupassen.

Zeichen pro Kommentar Um nicht zu viel Platz zu beanspruchen, werden immer nur die ersten 120 Zeichen eines Kommentars in der Seitenleiste angezeigt. Dies reicht meistens, um sich als Besucher einen Überblick zu verschaffen und bei Interesse den vollständigen Kommentar in der Artikel-Detailseite zu lesen. Im Eingabefeld Zeichen pro Kommentar können Sie diese Zeichenanzahl vorgeben.

Anzahl an Kommentaren Üblicherweise zeigt das Plugin die letzten 15 Kommentare. Diese Anzahl können Sie mit dem Eingabefeld Anzahl an Kommentaren verändern.

Datumsformat Zu jedem Kommentar wird das Erstellungsdatum mit angezeigt. Wie dieses formatiert wird, tragen Sie im Feld Datumsformat ein. Die zur Verfügung stehenden Variablen finden Sie auf https://www.php.net/manual/de/function.strftime.php.