Paket erstellen

Unsere Artikeltypen werden in einem eigenständigen Paket erstellt: vs.registration. Folgende Schritte sind hierzu notwendig:

1. Im /src-Verzeichnis erstellen wir aus der ZopeSkel-Vorlage dexterity das Grundgerüst für unser neues Produkt:

   $ ../bin/zopeskel dexterity vs.registration
   

   Dabei verwenden wir den èasy`-Modus und antworten mit True bei der Frage, ob wir eine GenericSetup_Profil erstellen wollen.

   Dies erzeugt folgende Paketstruktur:

   vs.registration
   ├── CHANGES.txt
   ├── CONTRIBUTORS.txt
   ├── DEXTERITY_README.rst
   ├── README.txt
   ├── bootstrap.py
   ├── buildout.cfg
   ├── docs
   │   ├── LICENSE.GPL
   │   └── LICENSE.txt
   ├── setup.cfg
   ├── setup.py
   └── src
       └── vs
           ├── __init__.py
           └── registration
                   ├── INTEGRATION.txt
               ├── __init__.py
               ├── configure.zcml
               ├── locales
               │   └── README.txt
               ├── profiles
               │   └── default
               │       ├── metadata.xml
               │       └── types.xml
               ├── static
               │   └── README.txt
               ├── testing.py
               └── tests
                   ├── __init__.py
                   ├── robot_test.txt
                   ├── test_example.py
                   └── test_robot.py
   

2. In der generierten setup.py-Datei sind unter install_requires folgende Pakete eingetragen:

   install_requires=[
       'setuptools',
       'plone.app.dexterity',
       'plone.namedfile [blobs]',
   

3. Darüberhinaus werden meistens noch die folgenden Erweiterungen benötigt:

   install_requires=[
       …
       'collective.autopermission',
       'plone.app.referenceablebehavior',
       'plone.app.relationfield',
   ],
   

   collective.autopermission

   erstellt Berechtigungen in Zope2 sobald eine <permission />-Anweisung verwendet wird.

   plone.app.referenceablebehavior

   ermöglicht, dass unsere Dexterity-Artikeltypen von Archetypes-Referenzfeldern aus verfügbar werden.

   plone.app.relationfield

   erlaubt uns, Referenzfelder zu verwenden

   plone.namedfile

   erlaubt uns zusammen mit dem [blobs]-Extra, ZODB-Blobs zum Speichern unserer Dateien und Bilder zu verwenden.

   Weitere bekannte Erweiterungen sind

   plone.app.stagingbehavior

   basierend auf plone.app.iterate bietet es Unterstützung von Staging für Dexterity-Artikeltypen. Erfordert Plone 4.1.

   plone.app.versioningbehavior

   basierend auf Products.CMFEditions bietet Unterstützung beim Speichern von Versionen für Dexterity-Artikeltypen. Erfordert Plone 4.0

   collective.z3cform.datagridfield

   ein z3c.form-Widget zum Editieren von Listen von Subobjects mittels eines tabellenförmigen UI.

   plone.app.lockingbehavior

   Locking-Integration für Dexterity-Artikeltypen.

4. Als nächstes fügen wir in der configure.zcml-Datei die folgenden Zeile ein:

   <configure
       …
       xmlns:grok="http://namespaces.zope.org/grok">
       <includeDependencies package="." />
       <grok:grok package="." />
       …
   </configure>
   

<includeDependencies package="." />

schließt die Konfiguration für die in der setup.py-Datei aufgelisteten Abhängigkeiten ein.

<grok:grok package="." />

ermöglicht Grok, automatisch Schema-Interfaces und content-Klassen zu initialisieren.

1. Als nächstes ändern wir die buildout.cfg-Datei um Dexteritys Known Good Set of Versions hinzuzufügen:

   [buildout]
   extensions =
       mr.developer
       …
   extends =
       …
       http://good-py.appspot.com/release/dexterity/1.0rc1?plone=4.1
       versions.cfg
   …
   [test]
   recipe = zc.recipe.testrunner
   eggs =
       vs.registration
   defaults = ['--exit-with-status', '--auto-color', '--auto-progress']
   
   [sources]
   …
   vs.registration = svn https://dev.plone.org/svn/pen/vs.registrtion/trunk
   

2. Nun können wir das vs.registration-Paket auch als Abhängigkeit in unser vs.policy-Produkt eintragen. Zunächst wird vs.registration in die Liste ìnstall_requires` in src/vs.policy/vs/policy/setup.py eingetragen:

   install_requires=[
       'setuptools',
       'Plone',
       'vs.event',
       'vs.theme',
       'vs.registration',
   ],
   

3. Schließlich editieren wir auch noch profiles/default/metadata.xml im selben Paket:

   <dependencies>
       <dependency>profile-vs.event:default</dependency>
       <dependency>profile-vs.theme:default</dependency>
       <dependency>profile-vs.registration:default</dependency>
   </dependencies>