Einführung in das Objekt-Publishing

In Plone veröffentlichen Sie eigentlich Objekte, die sich in Zope befinden. Die meisten davon sind Objekte, die persistent in der Objektdatenbank gespeichert sind. Das Konzept ist komplizierter als bei den üblichen CGI-Umgebungen (Common Gateway Interface), in denen Sie ein Script ausführen und ihm eine Reihe von Anfragevariablen übergeben. In Plone ist alles ein Objekt, in Zope ist alles ein Objekt, und auch in Python ist alles ein Objekt. Bis jetzt habe ich es vermieden, das Wort Objekt zu verwenden, und habe stattdessen Wörter wie Template, Script und Eintrag benutzt, aber all das sind wirklich Objekte, die sich lediglich unterschiedlich verhalten.

Wenn Sie von Plone einen URL (Uniform Resource Locator) abfragen, wird ein Objekt aus der Umgebung aufgerufen. Das macht Plone so, dass es den URL in einen Pfad übersetzt. Das heißt: Falls der URL /Plone/login_form lautet, versucht Plone, aus diesem URL einen Pfad zu bestimmen und all die Objekte darauf in der Datenbank zu finden. Dabei findet es das Objekt Plone und darin dann ein Objekt login_form. Dieses Absuchen des Pfads wird auch Traversierung genannt. Im Grunde genommen traversiert Zope diese Objekte und ruft das letzte Objekt im Pfad auf.

Wenn Zope das Objekt login_form aufruft, wird dieses Objekt in seinem Kontext ausgeführt. Den Begriff Kontext werden Sie im Zusammenhang mit Plone oft hören. Es ist lediglich der aktuelle Kontext des ausgeführten Objekts. In diesem Fall ist es /Plone. Der Kontext verändert sich ständig, während Sie sich in einer Plone-Site bewegen. Falls Sie den URL /Plone/Members/login_form in einem Browser aufgerufen haben, wäre der Kontext /Plone/Members.

Wie oben erwähnt wurde, können Sie per Traversierung mit Hilfe eines Programms genauso auf Objekte in Plone zugreifen, wie Sie es mit einem URL tun. Das ähnelt dem Zugriff auf Dateien in einem Dateisystem. Das heißt: Wenn Sie unter Windows auf ein Bild in Eigene Dateien zugreifen möchten, würden Sie ein Verzeichnis eingeben wie C:\Dokumente und Einstellungen\andym\Eigene Dateien\Mein Portrait.jpg. Auf ein Objekt in Plone könnten Sie zugreifen, indem Sie Members/andy/Mein Portrait.jpg eingeben. Das würde auch funktionieren, sofern Sie eine Reihe von Ordnern und Objekten wie folgt hätten:

Members
  |_ andy
     |_  Mein Portrait.jpg

In der Dateisystemversion gehen Sie auf der Festplatte des Rechners Verzeichnis für Verzeichnis durch. In Plone geschieht das Gleiche, nur ist es so, dass Members und andy Objekte sind.

Ein Unterschied besteht darin, dass Zope die Schreibweise beachtet. Unter Windows können Sie Mein Portrait.jpg oder mein portrait.jpg eingeben. In Plone wird das aber nicht funktionieren, denn Sie müssen die gleiche Schreibweise wie in der Objekt-ID verwenden. Aus diesem Grund empfiehlt es sich, in allen URLs Kleinbuchstaben zu verwenden, damit Ihre Benutzer weniger Fehler machen können.

Plone und Zope haben eine Besonderheit namens Akquisition zu diesem Publishing-System hinzugefügt. Das Konzept dahinter ist das des Enthaltenseins: Objekte befinden sich in anderen Objekten, die als Container bezeichnet werden. Im vorigen Beispiel ist das Objekt andy ein Container innerhalb des Members-Containers innerhalb des Plone-Site-Containers (der sich seinerseits innerhalb des Zope-Application-Containers befindet).

In einer normalen objektorientierten Umgebung erbt ein Objekt Verhalten von seinem Elternobjekt. In Plone und Zope erbt ein Objekt auch Verhalten von seinem Container. Dabei wandert ein Objekt durch eine Container-Hierarchie, um herauszufinden, wo es dieses Verhalten findet.

Nehmen Sie z.B. den Zugriff auf Members/andy/Mein Portrait.jpg. Was geschähe, wenn das Objekt Ein Bild.jpg nicht im Ordner andy vorhanden wäre, sondern weiter oben in der Hierarchie? Nun, dank Akquisition würde es für Sie gefunden. Betrachten Sie die folgende Hierarchie:

Members
   |_ andy
   |_ Mein Portrait.jpg

In diesem Fall würde Plone, wenn Sie die URL ausführen, diese bis andy traversieren und dann versuchen, dort Mein Portrait.jpg zu finden, was aber in dem Container nicht existiert. Daher würde es in der Container-Hierarchie suchen, also im Ordner Members, wo es Mein Portrait.jpg findet und zurückgibt. Als Ergebnis sieht der Benutzer das Bild wie sonst auch.

Wenn Sie das jedoch mit dem vorigen Beispiel vergleichen, in dem das Bild im Ordner andy enthalten war, würden Sie folgende Unterschiede feststellen:

• Erstens ist der Kontext der gleiche, auch wenn sich das Objekt an einem anderen Ort befindet. Der Kontext basiert auf dem Ort, von dem aus das Objekt aufgerufen wird.
• Zweitens ist der Container ein anderer, und der Container von Mein Portrait.jpg ist nun ein anderer, nämlich Members und nicht andy.

Worauf will ich also hinaus? Nun, jetzt können Sie ein Objekt in die Wurzel einer Plone-Site setzen, und ein beliebiges anderes Objekt kann darauf zugreifen, weil ersteres mit Hilfe der Akquisition gefunden wird.

Auch wenn das alles vermutlich Sinn macht, sollten Sie wissen, dass Akquisition ziemlich kompliziert werden kann, besonders bei der Suche in der Kontexthierarchie (die vorkommen kann). Wenn Sie gern mehr darüber lernen möchten, können Sie eine hervorragende Abhandlung zum Thema Akquisition von Jim Fulton, dem Systemarchitekten von Zope, unter http://www.zope.org/Members/jim/Info/IPC8/AcquisitionAlgebra/index.html lesen.

Einführung in Template-Ausdrücke

Bevor Sie ins Zope Page Templates-System eintauchen, müssen Sie TALES verstehen. Oft müssen Sie in einer Anwendung Ausdrücke schreiben, die dynamisch ausgewertet werden können. Das sind keine Scripts, sondern einzeilige einfache Ausdrücke, die etwas Einfaches mit einer Zeile Code machen können.

Ein Ausdruck wird mit einer Reihe von lokalen Variablen ausgewertet, die an ihn übergeben werden. Diese Variablen werden durch das bestimmt, was den Ausdruck aufruft. Vom Workflow wird eine Reihe Variablen übergeben, und das Zope Page Templates-System übergibt eine Reihe weiterer. Vorläufig werde ich Beispiele verwenden, die einen context haben. Wie Sie sich hoffentlich erinnern, ist context der Kontext, in dem ein Objekt aufgerufen wird.

Bislang haben Sie schon einige TALES-Ausdrücke wie string:${portal_url}/Software gesehen. Dies ist aber nur ein Beispiel aus einem weiten Spektrum möglicher Ausdrücke. Die Hauptanwendung von TALES liegt bei den Zope Page Templates, dem System, mit dem Plone HTML generiert. Auch wenn der Name vermuten lässt, dass es nur in Templates zu gebrauchen ist, verwenden viele Werkzeuge in Plone diese Syntax bei einfachen Ausdrücken, z.B. Aktionen, Workflow und Sicherheit. Es gibt verschiedene Arten von Ausdrücken, die ich einzeln durchgehen werde.

context/message
context/ordnerA/title
context/Members/andy/Mein Portrait.jpg

context/ordnerA/title|context/ordnerB/title

not: context/message|nothing

nocall: context/einBild

string: Dies ist ein langer String
string: Dies ist der $title

string: Dies ist der ${context/einBild/title}.

string: In $$US kostet es ${context/meinDing/kosten}.

python: 1 + 2

python: path('context/Members')

context/Members

python: test(1 - 1, 0, 1)

python: same_type(irgendwas, '')

Einführung in Page Templates und Inhalt

Wie Sie nun wissen, ist Plone ein Content-Management-System, bei dem Benutzer über das Web Inhalte zur Plone-Site hinzufügen können. Diese Inhaltsobjekte werden innerhalb von Plone gespeichert und dann mit Hilfe von Page Templates für alle Welt dargestellt.

Kommen wir zum früheren Beispiel des Zugriffs auf /Members/andy/Mein Portrait.jpg zurück. Ich werde nun beschreiben, was mit dem Inhalt in Plone wirklich passiert. Zuerst findet Plone das Objekt Mein Portrait.jpg und ruft es auf. Es wird deswegen aufgerufen, weil keine spezielle Methode auf dem Objekt aufgerufen wird. Wenn ein Inhaltstyp aufgerufen wird, wird ein bestimmtes Template gefunden und dargestellt. Der Kontext für dieses Template wird das Bild sein, auf das Sie zugreifen möchten, und das Template ist jenes für dieses Bild.

Wenn eine andere Aktion auf dem Bild aufgerufen würde, z.B. /Members/andy/Mein Portrait/image_edit, dann würde die Aktion image_edit für dieses Objekt gesucht, und das entsprechende Template würde zurückgegeben werden. Wie das funktioniert, beschreibe ich in Kapitel 11 im Detail.

In allen Templates in Plone werden Sie also eine Referenz zu here oder context sehen. Das ist der Kontext des Inhalts, auf den zugegriffen wird. In einem Template können Sie nun context/irgendwas oder wasanderes schreiben, und das wird das irgendwas oder wasanderes sein, das relativ zu dem Stück Inhalt und nicht zum Template gesucht wird. Jetzt werden Sie Ihr erstes Template in Plone erstellen.

Erstellen Ihres ersten Page Templates

Die Standardmethode, ein Page Template zu erstellen, ist das Zope Management Interface (ZMI). Weil das bedeutet, das Template im Textbereich eines Webbrowsers zu bearbeiten, ist das ZMI leider auch die unangenehmste Methode, die man als Entwickler benutzen kann. Verglichen mit den meisten Editoren, bietet dieser Textbereich sehr wenige Funktionen. Es fehlen Eigenschaften wie Zeilennummern, Syntax-Hervorhebung usw. In Kapitel 9 zeige ich Ihnen, wie Sie mit dem External Editor Inhalte bearbeiten können. Damit können Sie den Inhalt der Website in lokalen Editoren wie Macromedia Dreamweaver oder Emacs bearbeiten. In Kapitel 6 zeige ich Ihnen, wie Sie Plone dazu bringen, Page Templates als Dateien von der Festplatte zu lesen, und dann können Sie ein beliebiges Werkzeug dafür benutzen.

Um ein Template zu erstellen, gehen Sie ins ZMI, klicken erst auf portal_skins, dann auf custom und wählen dann Page Template im Dropdown-Menü (siehe Abbildung 5.1). Klicken Sie auf Add, und anschließend sehen Sie die Seite in Abbildung 5.2.

Abbildung 5.1. Wählen der Page Template-Option

Abbildung 5.2. Hinzufügen eines Page Templates

Geben Sie test als ID des Page Templates ein. Klicken Sie dann auf Add und auf den Edit-Button, mit dem Sie zum Management-Schirm gelangen (siehe Abbildung 5.3). Dann können Sie dieses Template über das Web bearbeiten, indem Sie den Textbereich benutzen und auf Save Changes klicken, um die Änderungen zu speichern.

Abbildung 5.3. Bearbeiten eines Page Templates

Nach einem Klick auf Save Changes wird das Page Template kompiliert. Falls Sie Fehler im Template gemacht haben sollten, sehen Sie diese oben auf der Seite hervorgehoben. Abbildung 5.4 zeigt einen Fehler bei einem h1-Tag an, das nicht geschlossen ist. (Wie zuvor erwähnt wurde, müssen Page Templates gültiges XHTML sein.)

Abbildung 5.4. Page Template-Fehler

Nachdem Sie das Page Template erfolgreich gespeichert haben, können Sie auf den Test-Reiter klicken, um den dargestellten Wert des Templates zu sehen. In Abbildung 5.5 sehen Sie, dass die Überschrift durch die ID des Templates ersetzt wurde und dass der Hauptabsatz nun die ID des Templates enthält.

Abbildung 5.5. Erzeugen der Seite

Der Management-Bildschirm eines Page Templates enthält auch die folgenden wichtigen Eigenschaften:

• Title: Dies ist der Titel dieses Templates, der optional ist. Wenn Sie diesen im vorigen Beispiel ändern, z.B. nachdem Sie auf Test geklickt haben, werden Sie feststellen, dass sich das HTML im Ergebnis verändert hat.
• Content-Type: Dies ist der Inhaltstyp dieses Templates, der normalerweise text/html ist.
• Browse HTML source: Hiermit wird das Template als unverarbeitetes HTML dargestellt. So würde das Template erscheinen, wenn es in einem HTML-Editor geladen würde.
• Test: Hiermit wird das Template verarbeitet und dargestellt.
• Expand macros when editing: Bei angekreuztem Kontrollkästchen wird versucht, Makros zu expandieren. Ich empfehle, es meistens nicht angekreuzt zu lassen. Makros sind eine Eigenschaft für Fortgeschrittene und werden in Kapitel 6 behandelt.

Nun, da Sie ein Page Template erzeugt haben, werden Sie ein paar Änderungen daran vornehmen. Dabei werden die Themen demonstriert, die bisher in diesem Kapitel behandelt worden sind. Wenn Sie z.B. möchten, dass Ihr Page Template 1+2 berechnet, könnten Sie folgende Zeile zu Ihrem Page Template hinzufügen:

<p>1+2 = <em tal:content="python: 1+2" /></p>

Klicken Sie dann auf den Test-Reiter, um zu sehen, ob es funktioniert. Sie sollten Folgendes sehen:

1+2 = *3*

Um ein Beispiel für eine Pfadtraversierung zu sehen, geben Sie das Logo Ihrer Plone-Site aus. Sie können einen Ausdruck im Logo Ihrer Plone-Site einfügen, indem Sie Folgendes zu Ihrem Page Template hinzufügen:

<p tal:replace="structure context/logo.jpg" />

Hierdurch wird das passende HTML für das Bild erzeugt und auf der Seite angezeigt.

Einführung in eingebaute Variablen

Die Syntax von Ausdrücken kennen Sie bereits, also werden Sie nun Variablen kennen lernen, die Ausdrücken übergeben werden, wenn Sie ein Page Template darstellen. Alles nun Folgende spielt sich im Kontext eines Zugriffs auf das Bild Ein Bild.jpg im Ordner Members/andy mit dem URL /Members/andy/Ein Bild.jpg ab:

• container: Dies ist der Container, in dem sich das Template befindet. Bei Plone ist das normalerweise der Ordner portal_skins. Sie sollten es vermeiden, einen Container zu verwenden, weil portal_skins unerwartete Änderungen am Container bewirken kann (z.B. eine Referenz auf den Ordner andy).
• context: Dies ist der Kontext, in dem das Template ausgeführt wird. In Plone ist das das angezeigte Objekt, falls Sie ein Portalobjekt anzeigen (z.B. eine Referenz auf das Objekt Ein Bild.jpg).
• default: Manche Anweisungen haben ein spezielles Standardverhalten. Darauf wird bei allen Anweisungen hingewiesen, und diese Variable ist ein Zeiger auf dieses Verhalten.
• here: Dies ist äquivalent zu context.
• loop: Dies ist äquivalent zu repeat.
• modules: Dies ist ein Container für importierte Module. So ist z.B. modules/string/atoi die Funktion atoi aus Pythons string-Modul. Hierunter fallen alle Module, die man gefahrlos ins Zope Page Templates-System importieren kann. Weitere Informationen finden Sie im Abschnitt "Plone mit Python scripten" in Kapitel 6.
• nothing: Dies ist das Äquivalent zu None in Python.
• options: Dies sind die Optionen, die ans Template übergeben werden, was dann passiert, wenn das Template von einem Script oder einer anderen Methode und nicht über das Web aufgerufen wird.
• repeat: Dies ist das wiederholte Element (siehe das Element tal:repeat im Abschnitt "Einführung in die Syntax von TAL-Anweisungen" in diesem Kapitel).
• request: Dies ist die eingehende Anfrage des Clients (alle Werte der eingehenden Anfrage sind mit Hilfe des folgenden Kontext-Testscripts sichtbar). Alle GET- und POST-Parameter werden zwecks leichteren Zugriffs mit dem Python-Modul marshall in ein Dictionary serialisiert. Hier sind einige Beispiele:

request/HTTP_USER_AGENT # der Browser des Benutzers
request/REMOTE_ADDRR  # der Browser des Benutzers
request/someMessage   # der Wert einer Meldung im Abfrage-String

• root: Dies ist das Zope-Wurzelobjekt. Mit root/Control_Panel erhalten Sie beispielsweise das Control Panel für Zope.
• template: Dies ist das aufgerufene Template. Mit template/id erhalten Sie z.B. die ID des dargestellten Templates.
• traverse_subpath: Dies enthält eine Liste von Elementen, die noch traversiert werden müssen. Es handelt sich um eine Variable für Fortgeschrittene, die Sie besser erst dann verwenden sollten, wenn Sie Traversierung und Akquisition verstanden haben.
• user: Dies ist das aktuelle Benutzerobjekt. user/getUserName ist der Benutzername des aktuellen Benutzers.
• CONTEXTS: Dies ist eine Liste mit den meisten dieser Werte.

Das Page Template test_context zeigt die Werte all dieser Variablen sowie den Ort einiger Objekte (siehe Listing 5.1). Es kann hilfreich bei der Fehlersuche und beim Bestimmen von Variablenwerten sein. Fügen Sie es als Page Template namens test_context hinzu, und klicken Sie dann auf Test, um die Ergebnisse zu sehen.

Listing 5.1. test_context

<html>
  <head />
  <body>
    <h1>Debug information</h1>
  <h2>CONTEXTS</h2>
  <ul>
    <tal:block
        tal:repeat="item CONTEXTS">
    <li
        tal:condition="python: item != 'request'"
        tal:define="context CONTEXTS;">
            <b tal:content="item" />
            <span tal:replace="python: context[item]" />
    </li>
    </tal:block>
  </ul>
  <h2>REQUEST</h2>
  <p tal:replace="structure request" />
  </body>
</html>

Das Page Template test_context produziert die Ausgabe, die Sie in Abbildung 5.6 sehen.

Abbildung 5.6. Ein Beispiel für alle Standardvariablen in einem Script

Einführung in die Syntax von TAL-Anweisungen

Die Sprache TAL (Template Attribute Language) bietet alle grundlegenden Bausteine für eine dynamische Präsentation. TAL definiert acht Anweisungen: attributes, condition, content, define, omit-tag, on-error, repeat und replace.

Da Page Templates gültiges XML sind, müssen alle TAL-Attribute in Kleinbuchstaben geschrieben werden. Außerdem darf jedes Element eine Anweisung nur einmal enthalten. In den folgenden Beispielen habe ich in den Elementen Zeilenumbrüche eingefügt, um die Lesbarkeit zu verbessern. Das ist absolut gültiger Code und kommt recht häufig im Plone-Quellcode vor. Dennoch ist es optional und wird nicht verlangt.

<a href="#"
   tal:attributes="href context/absolute_url">
   Link hierher
</a>

<a href="http://plone.org/Members/andy/book">Link hierher</a>

<a href="#"
   tal:attributes="href context/absolute_url;
      title context/title_or_id">Link</a>

<a href="http://plone.org/Members/andy/book" title="Plone Book">Link</a>

<a href="#"
    tal:attributes="href
        python:request.get('message', default)">
    Link</a>

<p tal:condition="request/message">
    Es gibt eine Message
</p>
<p tal:condition="not: request/message">
    Keine Message
</p>

<i tal:content="context/title_or_id">Ein Titel</i>

<i>Ein Titel</i>

<i tal:content="structure here/title_or_id">HTML nicht schützen</i>

<p tal:define="title here/title_or_id">
    ... <i tal:content="title">Ein Titel</i> ...
</p>

<p tal:define="global title string:Foo bar">
    ... <i tal:content="title">Ein Titel</i> ...
</p>
<i tal:content="title">Immer noch ein Titel</i>

<p tal:content="portal_title" />

<p tal:omit-tag="">Irgendein Text</p>

Irgendein Text

<p tal:omit-tag="nothing">Irgendein Text</p>

<p  tal:content="request/message"
    tal:on-error="string: Keine Message">Message</p>

<p
  tal:content="request/message"
  tal:condition="request/message|nothing">
    Es gibt eine Message
</p>
<p tal:condition="not: request/message|nothing">
    Keine Message
</p>

<table>
  <tr tal:repeat="row context/portal_catalog">
    <td tal:content="row/Title">Title</td>
  </tr>
</table>

<table>
  <tr tal:repeat="row context/portal_catalog">
    <td tal:content="repeat/row/number">1</td>
    <td tal:content="row/Title">Title</td>
  </tr>
</table>

<ul>
  <li tal:repeat="val context/objectValues">
    First: <i tal:content="repeat/val/first/meta_type" />,
    Last: <i tal:content="repeat/val/last/meta_type" />:
    <b tal:content="val/meta_type" />,
    <b tal:content="val/title_or_id" />
  </li>
</ul>

<p tal:replace="context/title_or_id">Ein Titel</p>

<p
  tal:content="here/title_or_id"
  tal:omit-tag="">Ein Titel</p>

Einführung in die Ausführungsreihenfolge

Die Reihenfolge, in der TAL-Attribute geschrieben werden, ist nicht die gleiche, in der sie ausgeführt werden, weil sie Teil von XML-Elementen sind (und XML kümmert sich nicht um die Reihenfolge von Attributen). Die Attribute werden in der folgenden Reihenfolge ausgeführt:

1. define
2. condition
3. repeat
4. content
5. replace
6. attributes
7. omit-tag

Die Anweisungen content und replace können Sie nicht im gleichen Element verwenden, da sie sich gegenseitig ausschließen. Die Anweisung attributes zusammen mit replace oder omit-tag ist sinnlos in einem Element, weil die Attribute entfernt werden. Das on-error-Tag wird nicht erwähnt, weil es verwendet wird, wenn der erste Fehler in irgendeinem der vorigen Elemente auftritt.

Beispiel: Benutzerinformationen anzeigen

Damit Sie sich die bisher gelernten Punkte veranschaulichen können, werden Sie nun ein Page Template erstellen, das eine einfache Aufgabe hat: Informationen über einen Benutzer im System anzuzeigen.

In diesem Beispiel verwendet eine Firma Plone intern in einem Intranet. Jeder Angestellte ist in Plone registriert und kann sich anmelden. Es gibt jedoch keine einfache Seite, die alle Angestellten anzeigt oder darüber informiert, wie man sie kontaktieren kann. Sie werden eine einfache Informationsseite für die Benutzer erstellen, die für alle Benutzer deren E-Mail-Adresse, Homepage und Bild anzeigt und die angibt, wann sie sich das letzte Mal angemeldet haben.

Ein erster Prototyp dieser Seite ist mit TAL, TALES und ein wenig Grundlagenwissen über CMF-Werkzeuge (Content-Management-Framework) schnell erstellt. Weil die APIs (Application Programming Interfaces) zu diesen Werkzeugen aber leider sehr verworren sind, ist ein Teil dieses Codes länger, als er sein sollte. Seien Sie erst einmal unbesorgt wegen der API dieser Werkzeuge, sie werden in Kapitel 9 behandelt. Wenn Sie das API erst einmal als gegeben hinnehmen, können Sie sich auf TAL konzentrieren.

Zuerst müssen Sie ein Page Template erstellen. Klicken Sie also auf portal_skins, dann auf custom, und fügen Sie ein Page Template mit der ID user_info hinzu. Als Zweites werden Sie es wie folgt bearbeiten. Ein vollständiges Listing diese Page Templates finden Sie in Anhang A. Wenn Sie dieses Listing untersuchen, sehen Sie, dass es mit HTML- und body-Tags beginnt.

Aus Gründen der Bequemlichkeit setzen Sie die Hauptdefinitionen in ein div-Tag:

<div
  tal:omit-tag=""
  tal:define="
    userName request/userName|nothing;
    userObj python: here.portal_membership.getMemberById(userName);
    getPortrait nocall: here/portal_membership/getPersonalPortrait;
    getFolder nocall: here/portal_membership/getHomeFolder
    ">

In diesem div-Tag gibt es vier define-Anweisungen: eine, um an den Benutzernamen zu gelangen, der im request-Objekt übergeben wird, und eine weitere, um diesen Benutzernamen in ein Benutzerobjekt zu übersetzen. Die letzten beiden define-Anweisungen stellen sicher, dass Sie eine gültige Referenz auf die Methoden haben, mit denen Sie an die Bilder und Ordner der Benutzer gelangen. Auch diese sind bequem, weil sie den Code später vereinfachen. Ein solches div-Tag oder auch anderes Tag einzurichten, das eine Reihe von Definitionen enthält, ist ein übliches Vorgehen beim Zope Page Templates-System. Der Code wird dadurch einfach sauberer.

Als Nächstes erstellen Sie zwei einfache Bedingungen, um zu prüfen, ob Sie einen Benutzer haben:

<p tal:condition="not: userName">
    Keinen Benutzernamen gewählt.
</p>
<p tal:condition="not: userObj">
    Dieser Benutzername existiert nicht.
</p>

Wenn die Anfrage keinen Benutzernamen enthält, resultiert der Ausdruck request/username|nothing darin, dass userName gleich nothing ist, und der einfache Test schlägt fehl. Wenn der Benutzername ungültig ist, wird userObj zu None, und es werden Fehlermeldungen für diese beiden Bedingungen ausgegeben.

Nun sind Sie so weit, dass Sie den Benutzer bearbeiten können:

<table tal:condition="userObj">
  <tr>
    <td>
      <img src=""
      tal:replace="structure python: getPortrait(userName)" />
    </td>

Da Sie einen Benutzer nur dann anzeigen können, wenn Sie einen gefunden haben, werden Sie sicherstellen, dass es eine einfache Bedingung für diese Tabelle tal:condition="userObj" gibt. Um das Bild eines Benutzers anzuzeigen, verwenden Sie die zuvor definierte Methode getPortrait. Diese Funktion gibt das gesamte Tag zurück, d.h., das structure-Tag stellt sicher, dass das ganze Bild korrekt dargestellt wird. Als Nächstes möchten Sie einige Eigenschaften wie name und email anzeigen. Im Folgenden wird dies für eine dieser Optionen, den home-Ordner, gezeigt:

<li
    tal:define="home python: getFolder(userName)"
    tal:condition="home">
    <a href=""
        tal:attributes="href home/absolute_url"
        >Home-Ordner</a>
</li>

Zuerst verwenden Sie ein define, um an den Ordner zu gelangen, und weisen ihn der Variablen home zu. In einer Plone-Site ist das Erstellen eines home-Ordners für einen Benutzer optional, d.h., beim Verweis auf einen Ordner müssen Sie sicher sein, dass dieser auch existiert. Wegen der Ausführungsreihenfolge von TAL kommt die Definition vor der Bedingung. Danach zeigen Sie einen Link auf den Ordner mit Hilfe des Ordnerattributs absolute_url an.

Dieses Page Template enthält ein paar weitere Zeilen, um einige andere nützliche und aufregende Eigenschaften zu finden, die es dem Benutzer zeigen kann. Wie bei den meisten Dingen in Plone kommt es darauf an, die korrekten API-Aufrufe zu finden und die Ausgabe entsprechend weiterzuverarbeiten.

Die Seite endet schließlich mit dem Schließen aller relevanten Tags. Wenn alles gut geht, sollten Sie die Seite aufrufen können, indem Sie auf den URL http://ihresite/user_info?userName=[einbenutzer] zugreifen, wobei einbenutzer ein vorhandener Benutzername in Ihrer Plone-Site ist.

Momentan ist dieses Page Template ziemlich beschränkt. Nur ein Benutzer mit Managerrechten kann diese Seite sehen, sie kann nur jeweils ein Mitglied zu einem Zeitpunkt anzeigen, und die Information über diesen Benutzer ist recht mager. In Kapitel 6 werde ich zeigen, wie Sie dieses Beispiel ausbauen und einiges an Wiederverwendbarkeit von Komponenten hinzufügen - sowie die Möglichkeit, den Text in andere Sprachen zu übersetzen.