Installation von Plone auf Windows

Es gibt einen Windows Installer für Plone, der nichts als ein paar Klicks mit der Maus braucht, um eine vollständige Plone Installation zu machen. Diese Variante ist OK für jemanden, der Plone nur ein wenig beschnupppern will. Will man es jedoch "seriös" brauchen, empfehle ich Zope und Plone von Grund auf zu installieren. Man hat so eine wesentlich bessere Kontrolle über das was passiert.

Zuerst ist Zope korrekt zu installieren (siehe Workshop Zope Einfuehrung)

Bei der Installation von Zope wurde eine Zope Instanz angelegt(nachlesen!!) Entpacken Sie Plone im Instanz-Produkte-Verzeichnis. Plone ist auf der CD im Verzeichnis ZopedownloadPloneXX.tar.gz

Ev. gibt es auf http://plone.org/downloads eine neuere Version. Bitte nicht den Windows-Installer, sonder Plone-Core verwenden.

Wenn alle Vorgaben übernommen wurden, muss Plone im folgenden Directory entzippt werden:

c:\Zope-Instance\Products

Dabei wird darin ein Directory angelegt:

c:\Zope-Instance\Products\Plone-XX

Unter Windows müssen alle in diesem Directory angelegten Directories eine Hierarchiestufe hoch kopiert werden. Das Resultat muss in etwa so aussehen:

C:\Zope-Instance\Products>dir /b
    Archetypes
    BTreeFolder2
    CMFActionIcons
    CMFCalendar
    CMFCore
    CMFDefault
    CMFFormController
    CMFPlone
    CMFQuickInstallerTool
    CMFTopic
    DCWorkflow
    Epoz
    ExternalEditor
    Formulator
    generator
    GroupUserFolder
    PlacelessTranslationService
    Plone-2.0.5
    PloneErrorReporting
    PortalTransforms
    README.txt
    validation

Der Ordner PloneXX kann anschliessend gelöscht werden.

Plone ist jetzt fertig installiert und kann gestartet werden. Dazu muss Zope gestoppt und wieder gestartet werden (ca 100x ^C im Dos Fenster drücken, anschliessend aus Windos start->Programme->!ZopeXX->Run Zope In Console).

Einfügen eines Reiters (action)

- im ZMI portal_actions suchen und darauf klicken
- ganz unten eine neue Action mit fogenden Werten einfügen:

• Name Hilfe
• Id help
• Action string$portal_url/help
• Permission View
• Category User

Ein Hilfe Button bei jedem Dokument

• Icon help.gif in Customordner einfügen

Damit ein Hilfe-Button bei den Document-Buttons erscheint, muss die Kategorie der Aktion auf document_action geändert werden und der Action ein Icon zugeordnet werden

In der oben beschriebenen Hilfe Action ändern wir:

• Category document_action

Der Aktion können wir ein Icon mit dem portal_actionicons Tool zuordnen. Dazu:

- im ZMI portal_actions suchen und darauf klicken
- ganz unten eine neue Zeile mit fogenden Werten einfügen:

• Category plone_introduction
• Action ID help
• Action Title Hilfe
• Priority 0
• Expression help.gif

Navigationselemente

web/schule->Properties (wert 3)
web/bauprojekt->Properties (wert 3)

Das bedeutet, dass in beiden Fällen der Baum nur Elemente des jeweiligen Ordners
und den Unterordner zeigt.

- Name       Schule
- Id         schule
- Action     string$portal_url/web/schule
- Permission View
- Category   portal_tabs

- Name       Bau
- Id         bau
- Action     string$portal_url/web/bauprojekt
- Permission View
- Category   portal_tabs

Navigation

Zur Navigation werden dem Nutzer folgende Elemente zur Vefügung gestellt:

• Navigationsmenu im linken Slot

  Dieses wird über portal_properties->navtree_properties konfiguriert

• Verschiedene Reiter(-Kategorien)

  Diese werden über die Actions der verschiedenen Actionprovider (Tools) konfiguriert

• Seiten-Abfolge

  Welche Seite einer gewissen Nutzer-Aktion folgt (z.B. nach erfolgter Aenderung), wird mit dem Werkzeug portal_form_controller verwaltet. Hier werden auch die Gültigkeit der Eingabe und die Sicherheitsbestimmungen kontrolliert.

• Portles

  Das sind Subfenster, die in einem der Slots positioniert werden können. Sie stellen üblicherweise Inhalt und Navigation zu einem bestimmten Thema zur Verfügung.

• Links

  Sprungziele zu internen und externen Dokumenten

• Ordner

  Eine Plone-Site wird sinvollerweise mit Ordnern (Folder) strukturiert. Diese werden je nach Status und Ort im Navigationsbaum angezeigt.

Inhalt

Inhalt sind Dokumente, Webseiten, Formular usw. Navigation und Inhalt überschneiden sich offensichtlich. Was des einen Inhalt ist, ist des andern Navigation.

Funktion

Funktion stellt Automatismen zur Verfügung, die den Nutzer einer Site beim Erstellen von Inhalt oder Navigieren durch die Site unterstützen. Es stehen uns eine Vielzahl von Quellen solcher Funktionen zur Verfügung.

• Templates

  Das sind Html-Seiten-Vorlagen, die in der Lage sind, Bereiche mit dynamischem Inhalt zu füllen (siehe Workshop Zope Einfuehrung )

• Python Scripts

  Scripts, die fast beliebige Manipulationen sowohl am Inhalt einer Site als auch mit der Navigation machen können (siehe Workshop Zope Einfuehrung )

• Werkzeuge

  Das sind Funktionssammlungen, die als Objekte in einer Plone-Site zur Verfügung stehen. Sie werden meist mit dem Werkzeug portal_quickinstaller installiert. Es ist üblich (aber nicht notwendig), dass ihre Namen in der Art von portal_XXX lauten. Dabei gibt XXX einen Hinweis auf die Art der Funktionen, die das Werkzeug bereitstellt. Mehr dazu finden Sie unter portal_form_tools. Ein Werkzeug kann erst gebraucht werden, wenn es als (Teil eines) Produkt(es) auf Betriebssystem-Ebene in die Zope Umgebung installiert wurde

• Produkte

  Ein Produkt ist eine Sammlung von Python-Programmen. Es muss auf Betriebssystem-Ebene in das Products_verzeichnis von Zope oder einer Zope-Instanz installiert werden.

Kontrolle

Üblicherweise soll kontrolliert werden, wer was wo auf einer Zope/Plone Site machen darf. Dazu stellt uns Zope ein sehr feinkörniges Sicherheitskonzept zur Verfügung. Es stehen uns folgende Konzepte zur Verfügung, die aber hier nicht weiter vertieft werden.

• User

  Ein in der Nutzerdatenbank (acl_users) registrierter Benutzer

• Rolle

  Eine Rolle, die einem Nutzer zugeordnet ist. Zugriffsrechte werden einer Rolle nie einem User zugeordnet.

• Gruppen

  Eine Möglichkeit, einer Gruppe von Nutzern Rollen zuzuteilen.

• Lokale Rollen

  Die Rolle, die ein Nutzer hat, bezieht sich immer auf ein Objekt. Dabei ist ein Objekt das Dokument, das gerade dargestellt wird. Beim Darstellen eines Objektes werden immer eine Reihe weiterer Objekte (z.B. die Portlets) angefasst. Es genügt daher in der Regel nicht, nur das Recht des aktuellen Nutzers auf einem bestimmten Objekt zu betrachten.

Aussehen/Verhalten

Aussehen und Verhalten einer Site wird von Skins bestimmt. Das sind geordnete, auswechselbare Sammlungen von Templates und Scripts. Sie bestimmen in ihrer Gesammtheit, wie sich eine Site in einem bestimmten Zustand (also z.B. wenn die Seite XY geöffnet ist) aussieht und verhält.

Eine Skin bezeichnet eigentlich zwei verschiedene Dinge:

• Einen Skin-Pfad

  Das ist, analog einem Programm-Suchpfad, eine Abfolge von Orten, wo ein bestimmtes Template, Script, Dokument oder sonstiges Objekt gesucht wird. Der Ordner portal_skins/custom ist immer das erste Element dieses Suchpfades. Objekte in diesem Ordner werden also zuallererst gefunden. Dementsprechend dient der Custom-Odner dazu, Objekte anzupassen, die von Plone oder einem anderen Produkt zur Verfügung gestellt werden.

• Eine Vielzahl von Skin-Directories (bzw. "Filesystem Directories").

  Das sind Ordner im Filesystem, in denen Sammlungen von Python-Scripts, Templates, Bilder usw abgelegt sind. Jedes Produkt bringt seine eigene Sammlung solcher Skins mit sich, die bei der Installation des Produktes in das portal_skins Tool "eingehängt" werden.

Installation eines neuen Produktes

Damit ein neues Produkt in Zope verfügbar ist, muss es installiert werden. Dazu sind folgende Schritte notwendig.

• Produkt-Archiv aus dem Internet auf den eigenen Rechner laden.

• Archiv im Produkte-Verzeichnis von Zope (hier c:\Zope-instance\Products) auspacken.

• README.txt und INSTALL.txt lesen.

  • ev weitere Installationschritte ausführen

• Zope restarten

Epoz ist hier zu finden Kupu ist hier zu finden

Sobald das neue Produkt in Zope verfügbar ist, kann es mit dem quick_installer Tool in die Plone-Umgebung eingebettet werden.

Um Epoz (bzw Kupu) zu nutzen sind folgende Schritte notwendig:

• Reiter "plone konfiguration" wählen
• Produkte hinzufügen/löschen
• Epoz XX wählen -> installieren

Für den eigenen Bedarf einrichten

Epox ist jetzt zwar installiert, steht dem eingeloggten Nutzer aber noch nicht zur Verfügung.

Dazu sind noch die folgenden Schritte notwendig:

• Reiter "meine einstellungen" wählen

• Meine Einstellungen

  • E-Mail Feld füllen
  • Texteditor wählen

Für alle Nutzer einrichten

Damit jedem Nutzer automatisch Epoz als Editor eingetragen wird, müssen wir Einstellungen über das ZMI vornehmen:

• Tool portal_memberdata wählen
• Reiter Properties wählen
• Feld wysiwyg_editor füllen

Was ist ein Wiki

Ein Wiki ist ein Werkzeug, um sehr schnell und einfach "akzeptabel" formatierte Informationen in ein Portal einzubringen.

Einfügen eines neuen Wiki Folders

Dazu sind folgende Schritte notwendig:

• Ordner anlegen
• in diesem Ordner eine Wikipage einfügen, Namen "sinnvoll" d.h. themenbezogen wählen

Eine automatische Sicht mit einem index_html

Das neue Wiki wird nicht automatisch angezeigt, wenn auf den "Wiki"-Ordner gewechselt wird. Dazu ist ein Objekt mit Namen "index_html" im Ordner notwendig, das die Haupt-Wikiseite aufruft. Um ein solches Objekt in den Ordner einzubringen, sind folgende Schritte nötig:

• im ZMI in den "Wiki"-Ordner wechseln

• ein Objekt von Typ "DTML method" anlegen. Als ID erhält sie 'index_html'

• ihr Inhalt ist:

  <dtml-call ="" response.redirect(_['url1="" +="" '/xxx="">
  

  Wobei XXX für den Namen der Hauptwikiseite steht.

Mein eigener News Folder

Ein Objekt-Typ mit mehr Intelligenz

Wir haben gesehen, dass das Erstellen eines Wiki-Folders recht mühsam ist, wir wollen dies automatisieren. Dazu erstellen wir im Custom Ordner ein Script mit folgendem Inhalt:

## Script (Python) "AATest"
##bind container=container
##bind context=context
##bind namespace=
##bind script=script
##bind subpath=traverse_subpath
##parameters=self, id
##title=
##
def addWikiFolder(self, id):
    # Create a regular plone folder
    self.invokeFactory(type_name = 'Folder', id = id)
    wiki = getattr(self, id)

    # Populate the folder with the default pages
    wiki.manage_addProduct['ZWiki'].addWikiPage(id)
    content='<dtml-call ="" response.redirect(_[\'url1="" +="" \'/%s="">' % id
    wiki.manage_addProduct['OFSP'].manage_addDTMLMethod('index_html', id)
    dtml = wiki['index_html']
    dtml.manage_edit(content, id)
    return wiki

wiki = addWikiFolder(self, id)
context.REQUEST.RESPONSE.redirect(wiki.absolute_url())

Einen eigenen Portal-Typ von diesem Script ableiten

Um einen eigenen Portal-Typ von diesem Script abzuleiten, gehen wir wie folgt vor:

in ZMI:

    * goto portal_types
    * add new (Script) Python
        o id: addPopulatedFolder
        o title: prepopulated folder
        o parameters: container, id


In portal_types in the drop down list there is a 'Scriptable Type Information'; add it.

    * you only need to fill out two fields:
        o id: Populated Folder
        o use Default Type Information: CMFPlone: Plone Folder
    * now that you've created the type information, click on it to edit it.
        o Constructor permission: Add portal content    

</dtml-call></dtml-call></div></div>