Kalender

Das Kalender-Portlet ist eines der Standard-Portlets. Es zeigt rechts auf einer Plone-Seite einen Kalender an. Dieses Portlet zeigt veröffentlichte Termine für den jeweiligen Monat in einem kleinen Kalender an. Das Kalender-Portlet erscheint auch dann, wenn es keine Termine gibt. Mit dem Werkzeug portal_calendar können Sie den Kalender im ZMI weiter konfigurieren (siehe Abbildung 4.8).

Abbildung 4.8. Kalender-Portlet

Der Ausdruck, der hinzugefügt werden muss, lautet here/portlet_calendar/macros/portlet.

Termine

Das Termine-Portlet zeigt eine Liste veröffentlichter kommender Termine an. Wenn Sie diesen Eintrag in der Portlet-Liste haben, wird das Portlet nur dann angezeigt, wenn es solche Termine gibt (siehe Abbildung 4.9).

Abbildung 4.9. Termine-Portlet

Der Ausdruck, der hinzugefügt werden muss, lautet here/portlet_events/macros/portlet.

Favoriten

In der oberen linken Ecke eines Plone-Dokuments sehen Sie ein Plone-Icon. Benutzer können darauf klicken, um einen Favoriten hinzuzufügen. Ein Favorit ähnelt einem Bookmark oder Link auf die Seite, die Sie aufrufen möchten. Dieser Favorit wird jedoch auf der Plone-Site gespeichert. Abbildung 4.10 zeigt das Icon, mit dem ein Favorit hinzugefügt wird.

Abbildung 4.10. Das Icon zum Erstellen eines Favoriten

Favoriten werden zum Benutzerordner eines Benutzers hinzugefügt und werden im Favoriten-Portlet angezeigt, zusammen mit einem Link, der dazu dient, sie zu organisieren (siehe Abbildung 4.11). Die gezeigten Favoriten sind solche, die der Benutzer gespeichert hat. Das heißt, selbst wenn Sie diesen Eintrag in Ihrer Portlet-Liste haben, wird das Portlet nur dann angezeigt, wenn Sie auch wirklich Favoriten haben.

Abbildung 4.11. Favoriten-Portlet

Der Ausdruck, der hinzugefügt werden muss, lautet here/portlet_favorites/macros/portlet.

Anmeldung

Das Einloggen-Portlet zeigt das Anmeldeformular an, über das sich ein Benutzer mit seinem Benutzernamen und Passwort anmelden kann. Wenn er sein Passwort vergessen hat, hat er die Möglichkeit, es sich per E-Mail schicken zu lassen. Auch wenn dieses Portlet in der Portlet-Liste ist, wird es nur dann angezeigt, falls der Benutzer noch nicht angemeldet ist (siehe Abbildung 4.12).

Abbildung 4.12. Einloggen-Portlet

Der Ausdruck, der hinzugefügt werden muss, lautet here/portlet_login/macros/portlet.

Navigation

Das Navigation-Portlet zeigt einen einfachen Baum aller Ordner an der aktuellen Position in Baumform an. Es bietet ein mächtiges und einfaches Navigationswerkzeug. Das Navigation-Portlet ist extrem anpassbar. Sie können es mit einem Klick auf portal_properties und navtree_properties im ZMI ändern, was im Abschnitt "Navigation-Portlet ändern" weiter unten behandelt wird (siehe Abbildung 4.13).

Abbildung 4.13. Navigation-Portlet

Der Ausdruck, der hinzugefügt werden muss, lautet here/portlet_navigation/macros/portlet.

Nachrichten

Das Nachrichten-Portlet zeigt die Liste der letzten Nachrichten mit Links darauf an (siehe Abbildung 4.14). Auch dann, wenn Sie dieses Portlet in der Portlet-Liste haben, wird es nur dann angezeigt, wenn irgendwelche Nachrichten veröffentlicht wurden. Die Nachrichten einer Site sind auch über einen Klick im Nachrichten-Reiter verfügbar.

Abbildung 4.14. Nachrichten-Portlet

Der Ausdruck, der hinzugefügt werden muss, lautet here/portlet_news/macros/portlet.

Aktuelle Artikel

Das Aktuelle Artikel-Portlet listet die zuletzt auf der Site veröffentlichten Artikel seit dem Zeitpunkt auf, an dem Sie zum letzten Mal angemeldet waren (siehe Abbildung 4.15). Auch wenn es keine solchen Artikel gibt, wird es angezeigt.

Abbildung 4.15. Aktuelle Artikel-Portlet

Der Ausdruck, der hinzugefügt werden muss, lautet here/portlet_recent/macros/portlet.

Dazu passend

Das Dazu passend-Portlet zeigt eine Liste von Artikeln an, die zu dem Artikel passen, den Sie gerade sehen, was anhand der Stichwörter dazu bestimmt wird. Wenn ein passender Artikel ein Link auf eine andere Website ist, wird er in einer eigenen Liste externer Ressourcen angezeigt. Auch dann, wenn dieses Portlet in der Portlet-Liste ist, wird es nur dann angezeigt, wenn es passende Artikel gibt (siehe Abbildung 4.16).

Abbildung 4.16. Dazu passend-Portlet

Der Ausdruck, der hinzugefügt werden muss, lautet here/portlet_related/macros/portlet.

Revisionsliste

Das Revisionsliste-Portlet zeigt eine Liste von Artikeln an, die im Zustand Überprüfen sind und darauf warten, geprüft zu werden. Es wird nur dann angezeigt, wenn der angemeldete Benutzer die Rolle des Redakteurs hat und es zu prüfende Artikel gibt.

Abbildung 4.17. Revisionsliste-Portlet

Der Ausdruck, der hinzugefügt werden muss, lautet here/portlet_review/macros/portlet.

Buch-Website: Slots ändern

Für die Website zum Buch machen die meisten der Slots auf der rechten Seite keinen Sinn. Zu diesem Buch gibt es keine Termine, d.h., die Kalender- und Termine-Slots rechts sind nicht notwendig. Ich rechne zwar mit neuen Dingen, die noch zur Site hinzugefügt werden, aber es werden sehr wenige sein, sobald die Site einmal fertig ist. Also habe ich mich entschlossen, alle rechten Slots auf meiner Site zu entfernen. Das habe ich so gemacht, dass ich im ZMI zum Portal-Wurzelobjekt gegangen bin und auf das Eigenschaften-Objekt geklickt habe. Dann habe ich alle Inhalte in der Eigenschaft right_slots gelöscht. Die anderen Portlets, Navigation, Login und Dazu passend, die normalerweise links vorkommen, sind für mich alle von Nutzen, daher habe ich sie behalten.

So sehen im Moment die Portlet-Eigenschaften der Plone-Buchsite aus:

Verschiedene Portlets in verschiedenen Teilen Ihrer Site

Die Zope-Datenbank, auf der Plone basiert, verfügt über eine Eigenschaft namens Akquisition. In der einfachsten Form bedeutet das, dass bei der Suche nach einem Objekt wie right_slots Plone das nächstgelegene Objekt findet, das diese Eigenschaft enthält. Das heißt, dass Plone bei der Suche nach Portlets, die in der rechten Spalte angezeigt werden sollen, normalerweise das Wurzelobjekt findet und diese Portlets anzeigt.

Auf diese Weise können Sie die Eigenschaften im Portal-Wurzelobjekt ändern, um die ganze Site zu ändern. Sie werden vielleicht bemerken, dass es keinen Kalender gibt, wenn Sie auf den Link Mein Ordner klicken und zu Ihrem persönlichen Ordner gehen. Wenn Sie im ZMI auf Members und dann auf Properties klicken, werden Sie einen Eintrag für right_slots sehen. Für diesen Ordner besteht er aus einer leeren Liste. Wenn die Plone-Site nach einem Wert für die rechts anzuzeigenden Portlets sucht, bewegt sie sich in der Ordnerhierarchie so lange nach oben, bis sie den Ordner Members erreicht. Dort findet sie den Wert right_slots und benutzt ihn. Da der Wert von right_slot im Ordner Members leer ist, wenn Sie Inhalte aus Members sehen, wird der rechte Slot leer sein.

Durch das Hinzufügen und Entfernen von Ordnereigenschaften mit Hilfe des ZMI können Site-Administratoren genau anpassen, welche Portlets auf ihren Sites erscheinen. Zum Glück ist der Properties-Reiter einigermaßen einfach. Sie wählen einfach den Artikel im ZMI und klicken dann auf Properties. Um eine Eigenschaft zu den linken oder rechten Slots hinzuzufügen, benutzen Sie das untere Add-Formular und vergewissern sich, dass der Eigenschaftstyp lines lautet.

Einführung in Aktionen

In Plone können gewisse Personen bestimmte Aufgaben zu verschiedenen Zeiten und an verschiedenen Orten der Site ausführen. Diese Aufgaben werden Aktionen genannt. Plone übersetzt sie in Reiter, Links und andere Elemente. Aktionen sind eine hochgradig konfigurierbare Art, um Navigationselemente für eine Site zu erstellen.

Jede Aktion verfügt über folgende Eigenschaften, die im ZMI konfiguriert werden können. Wo sie genau konfiguriert werden, hängt davon ab, wo die Aktion gespeichert ist. Hier ist eine Liste von Eigenschaften für eine Standardaktion:

• Name: Dies ist ein benutzerfreundlicher Name für die Aktion. Er wird in der Benutzerschnittstelle oft verwendet. Wenn z.B. die Aktion als Reiter benutzt wird, entspricht dieser Wert dem Text im Reiter.
• Id: Dies ist eine eindeutige ID für die Aktion.
• Actions: Dies ist die auszuführende Aktion. Wenn die Aktion z.B. als Reiter definiert wird, wird diese Aktion beim späteren Klick auf diesen Reiter ausgeführt. Dieses Feld enthält einen TALES-Ausdruck (siehe weitere Informationen in Kapitel 5).
• Condition: Dies ist die Bedingung, die erfüllt sein muss, damit die Aktion ausgeführt wird. Wenn die Aktion z.B. als Reiter genutzt wird und diese Bedingung ist erfüllt, dann erscheint der Reiter. Dieses Feld enthält einen TALES-Ausdruck (siehe Kapitel 5).
• Permission: Dies sind die Rechte, die der Benutzer haben muss, damit er diese Aktion ausführen kann. Diese Rechte müssen gegeben sein, damit die Aktion genutzt werden kann (siehe Kapitel 9 für weitere Informationen zum Thema Sicherheit).
• Category: Hiermit werden die Aktionen kategorisiert. In Plone werden Aktionen damit voneinander unterschieden, d.h., sie werden in verschiedenen Abschnitten der Benutzerschnittstelle verwendet. Bei Portalreitern lautet der Kategoriewert portal_tabs.
• Visible: Das bestimmt, ob die Kategorie aktiv ist. Der Begriff visible wird verwendet, weil Aktionen normalerweise mit visuellen Elementen gekoppelt sind.

Einführung in die obersten Reiter

In den folgenden Abschnitten werden Sie als Beispiel die Portalreiter auf zwei verschiedene Weisen ändern. Sie werden den Reiter der Startseite so ändern, dass er Willkommen lautet, und Sie werden den Mitglieder-Reiter nach links neben den Nachrichten-Reiter verlegen. Die Aktionen für die Portalreiter werden in dem Werkzeug portal_actions gespeichert. Um sie also zu ändern, klicken Sie im ZMI auf portal_actions. Wie Sie in Abbildung 4.19 sehen, wird dabei eine lange Liste von standardmäßig vorhandenen Portalaktionen geöffnet. Manche dieser Aktionen werden Ihnen bekannt vorkommen, da sie für Teile der Plone-Site stehen.

Abbildung 4.19. Die Portal-Aktionen für Ihre Plone-Site

Scrollen Sie durch diese Aktionen, bis Sie den Eintrag Home finden, und ändern Sie das Namensfeld auf Willkommen. Scrollen Sie dann hinunter zum Seitenende, und klicken Sie auf Save. Zurück in der Plone-Schnittstelle werden Sie bemerken, dass der Reiter nun Willkommen heißt.

Die Reihenfolge der Reiter von links nach rechts auf der Seite wird durch die Reihenfolge von oben nach unten in der Liste der Aktionen bestimmt. Um einen Reiter zu verschieben, müssen Sie ihn in der Liste markieren und ans Seitenende zu den Buttons Move Up und Move Down scrollen. Es ist etwas umständlich, aber durch wiederholtes Markieren der Aktionen und Benutzen der Rauf- und Runter-Buttons können Sie die Reihenfolge ändern. Führen Sie das durch, und Sie werden bemerken, dass die Reiter nun in einer anderen Reihenfolge in Ihrer Plone-Site erscheinen.

Warum erscheint der Text in Kleinbuchstaben?

Plone ändert mit einem Stylesheet die Schreibweise von vielen Dingen, z.B. Reitern, in Kleinbuchstaben. Um das abzustellen, können Sie das Stylesheet ändern, was später in diesem Kapitel im Abschnitt "Bilder und CSS ändern" beschrieben wird.

Icons für ein Dokument ändern

Wenn Sie eine Liste von Links oder Optionen in einer Plone-Site betrachten, ist es sehr wahrscheinlich, dass diese Liste von einer Serie von Aktionen produziert wird. Und wenn es keine Aktionen sind, dann ist es Code; aber viele der wesentlichen Eigenschaften der Plone-Schnittstelle werden aus den Einstellungen im ZMI dynamisch generiert. Zwei weitere Beispiele für Aktionen sind Dokument- und Site-Aktionen.

Die Site-Aktionen erscheinen in der oberen rechten Ecke als Links zum Ändern der Schriftgröße. Diese Links könnten alles Mögliche sein, aber zufällig verweisen sie auf einige clientseitige Scriptfunktionen. Auch diese Links werden in portal_actions konfiguriert und sind nichts weiter als Aktionen, die zu einer anderen Kategorie gehören. Wenn Sie sich die Aktionen in portal_actions anschauen, werden Sie am unteren Seitenende diese drei Aktionen sehen. Sie haben die Kategorie site_actions. Wenn Sie sie entfernen möchten, müssen Sie lediglich die Visible-Option ausschalten. Die Icons stammen aus dem Werkzeug portal_actionicons, das lediglich ein weiteres einfaches Werkzeug ist, das das Icon auf die Aktion abbildet. Unter portal_actionicons sehen Sie eine Übereinstimmung bei normal_text für site_actions, das auf ein Icon passt (siehe Abbildung 4.20).

Abbildung 4.20. Site-Aktionen

Analog dazu befinden sich Dokumentationen in portal_actions. Sie haben die Kategorie document_actions. Auch hier können Sie die Reihenfolge, Icons und den Text ändern und Icons in der Schnittstelle hinzufügen oder entfernen, indem Sie diese Aktionen bearbeiten.

Skins ändern

Sie können die Standard-Skin einer Site ändern, indem Sie das Formular Einstellungen des Aussehens benutzen, zu dem Sie vom Control Panel aus gelangen. Eine Plone-Site können Sie auf einige verschiede Weisen darstellen, indem Sie verschiedene Farben, Stylesheets und Templates auf einer Site benutzen.

Dieses Formular enthält folgende Optionen:

• Voreingestelltes Aussehen: Dies ist die Standard-Skin, wenn Benutzer auf die Site zugreifen. Es gibt nur eine standardmäßig vorgegebene Skin, nämlich Plone Default.
• Flexibilität des Aussehens: Damit bestimmen Sie, ob es Benutzern erlaubt ist, ihre eigene Skin auszuwählen. Wenn ja, dann kann ein Benutzer in seinen Voreinstellungen eine neue Skin wählen. Standardmäßig ist diese Option gewählt.
• Wirkungsdauer des Cookies für das Aussehen: Wenn ein Benutzer eine Skin wählen kann, dann sollten Sie diese Option wählen, damit das entsprechende Cookie beliebig lange gültig ist. Damit wird ein Benutzer immer diese Skin sehen, wenn er sich bei der Site anmeldet. Diese Option ist standardmäßig nicht gewählt.

Nehmen Sie die gewünschten Änderungen vor, und klicken Sie auf Speichern, um diese zu bestätigen. Um die Performance auf der Site zu verbessern, können Sie ein Caching von Bildern und Stylesheets verwenden. Um sicherzustellen, dass Sie die neue Skin auch wirklich so sehen, wie sie sein soll, löschen Sie den Cache Ihres Browsers (beim Internet Explorer drücken Sie dazu Strg+F5).

Ein anderes Logo einstellen

Das Logo einer Plone-Site zu ändern und statt des Plone-Logos ein anderes zu verwenden, ist eine leichte Übung, aber die einzelnen Schritte können ein wenig verwirrend sein. Daher sollten Sie sie sorgfältig befolgen.

Zuerst greifen Sie auf das ZMI zu, klicken auf portal_skins, dann auf plone_images und schließlich auf logo.jpg. Danach wird die Seite zu diesem Objekt geöffnet. Sie sollte in etwa so aussehen wie in Abbildung 4.21.

Abbildung 4-21. Das Standard-Logo

Dieses Objekt stellt das Logo dar, wie es in Zope benutzt wird. In Abbildung 4.21 können Sie deutlich Informationen zum Bild sehen, seine Größe, seinen Typ und seinen Platz im Dateisystem. In der Seitenmitte befindet sich der Customize-Button, den Sie nun anklicken. Dabei wird eine Kopie des Objekts namens logo.jpg im custom-Ordner erzeugt (siehe Abbildung 4.22).

Abbildung 4.22. Das angepasste Bild

Diese Seite sieht vielleicht ähnlich wie die vorherige Seite in Abbildung 4.21 aus, aber es gibt eine Reihe von Unterschieden. Erstens: Wenn Sie in die obere linke Ecke der Seite schauen, werden Sie bemerken, dass sich der meta_type und der Ort dieses Objekts verändert haben. Nun sind Sie sind nicht mehr in portal_skins/plone_images/logo.jpg, sondern Sie sind in portal_skins/custom/logo.jpg. Zweitens können Sie nun einen Browse-Button sehen, mit dem Sie ein Bild auswählen und hochladen können, d.h., Sie können dieses Bild ändern. Klicken Sie auf diesen Button, um Ihr neues Bild zu finden, und klicken Sie auf Save, um die Änderung zu bestätigen. In Abbildung 4.23 füge ich als Beispiel ein kanadisches Plone-Logo hinzu.

Abbildung 4.23. Das kanadische Plone-Logo

Wenn Sie nun zur Plone-Schnittstelle zurückgehen, sehen Sie, dass sich das Bild verändert hat. Um sicherzugehen, dass Sie das neue Bild sehen, sollten Sie den Cache Ihres Browsers löschen (beim Internet Explorer drücken Sie dazu Strg+F5).

Was tun Sie, wenn Ihr Bild nicht im JPEG-Format vorliegt?

Zope bestimmt den MIME-Typ (Multipurpose Internet Mail Extensions) nicht aus der Dateierweiterung, sondern aus dem Inhalt. Daher können Sie ein GIF-Bild unter logo.jpg hochladen, und es funktioniert trotzdem, weil der korrekte MIME-Typ image/gif angewendet wird. Um die Verwirrung in Grenzen zu halten, möchten Sie das Bild aber vielleicht doch logo.gif oder logo.png nennen.

CSS-Code ändern

CSS bestimmt einen Großteil des Look-and-Feel Ihrer Website, darunter die Reiter, Bilder, Kästen und das allgemeine Layout. Die Tatsache, dass Plones CSS durchgehend angepasst werden kann, bedeutet, dass die Benutzer viele Aspekte einer Site mit ein paar Stylesheets vollkommen umgestalten können.

Noch einmal: Kapitel 7 beschreibt, was die einzelnen Elemente bewirken. In diesem Abschnitt zeige ich Ihnen nur schnell, wie Sie den CSS-Code einer Plone-Site ändern können. Zuerst gehen Sie ins ZMI. Dort klicken Sie auf portal_skins, dann auf plone_styles und schließlich auf ploneCustom.css. Danach erscheint eine Seite zu diesem Objekt. Dieses Stylesheet ist ziemlich einfach, ja, es ist sogar leer. Plone macht nämlich Gebrauch von der Kaskadierungseigenschaft von CSS. Da der HTML-Code für Plone zuerst plone.css importiert und dann ploneCustom.css, überschreiben alle Änderungen in letzterem das Standard-Stylesheet. Warum ist das eine gute Idee? Weil es bedeutet, dass Sie kleine inkrementelle Änderungen an ploneCustom.css vornehmen können, ohne das Kern-Stylesheet kaputtzumachen oder zu verändern.

Um also das Objekt ploneCustom.css anzupassen, klicken Sie auf portal_skins, dann auf plone_styles und auf ploneCustom.css. Danach klicken Sie auf den Customize-Button. Wieder wurde dieses Objekt angepasst, und Sie bemerken, dass Sie nicht mehr unter portal_skins/plone_styles/ploneCustom.css, sondern nun unter portal_skins/custom/ploneCustom.css sind. Da Dateiobjekte nun über das Web bearbeitet werden können, können Sie das Stylesheet direkt über das Web bearbeiten.

Ändern Sie als Beispiel den Hintergrund so, dass er ein Bild in der Mitte enthält (das ist nicht unbedingt die beste Benutzerschnittstelle, aber ein klares Beispiel dafür, wie Sie den CSS-Code anpassen können). Zuerst müssen Sie ein Bild in Plone hochladen. Dazu klicken Sie auf portal_skins, auf custom und dann auf den Add-Button, und schließlich wählen Sie ein Bild aus, wie in Abbildung 4.24 zu sehen ist.

Abbildung 4.24. Ein neues Bild hinzufügen

Als Datei habe ich ein Bild gewählt, das ich im Web gefunden habe (und das auch auf der Website zum Plone-Buch verfügbar ist), aber Sie können ein beliebiges Bild nehmen. Vergewissern Sie sich, dass die ID des Bildes background.gif ist, wie in Abbildung 4.25 zu sehen ist.

Abbildung 4.25. Prüfen des neuen Bildes

Nun müssen Sie den CSS-Code ändern, damit er auf das neue Bild zeigt. Den CSS-Code haben Sie schon angepasst, gehen Sie also zu portal_skins/custom/ploneCustom.css zurück, und ändern Sie den Text von

/* DELETE THIS LINE AND PUT YOUR CUSTOM STUFF HERE */

in Folgendes:

body {
   background-image: url(background.jpg);
   background-repeat: no-repeat;
   background-position: center;
}

Klicken Sie auf Save Changes, um die Änderungen an dieser Datei nicht zu verlieren. Gehen Sie dann zur Plone-Schnittstelle zurück. Wenn alles gut ging, sollten Sie das neue Bild sehen (siehe Abbildung 4.26).

Abbildung 4.26. Das neue Hintergrundbild