Zusatzprodukte¶

Finden, evaluieren und installieren von Zusatzprodukten.

Finden¶

Die meisten Produkte befinden sich mittlerweile auf Github: https://github.com/collective.

Evaluieren¶

Um nun zu überprüfen, ob das Produkt wirklich passend ist, können Sie verschiedene Schritte durchführen:

Zunächst sollten Sie überprüfen, wie sich das Produkt selbst präsentiert:
- Ist es hinreichend gut dokumentiert?
- Gibt es einen Bug Tracker?
  
  Wie viele offene und geschlossene Bugs gibt es?
  
  Wie schnell wurden die Bugs behoben?
- In welcher Version liegt das Produkt vor?
  
  Eine 0.* oder alpha-Version ist voraussichtlich weniger stabil als ein final release.
- Gibt es eine Roadmap?
  
  Sie gibt Ihnen Hinweise, wie die Planung für die weitere Entwicklung aussieht und wie zukunftssicher das Produkt ist.
Wie umfangreich und mit welchen Erfahrungen wird das Produkt eingesetzt?

Fragen Sie in einer Mailingliste nach, welche Erfahrungen mit dem Produkt gemacht wurden.
Dann sollten Sie das Produkt ausführlich in einer Testumgebung testen.
- Kopieren Sie gegebenenfalls die ZODB aus Ihrem Produktivsystem in Ihr Testsystem.
  
  Achten Sie darauf, dass die Buildout-Konfigurationen beider Systeme identisch sind.
- Wie hoch ist die Testabdeckung des Produkts?
  
  In Testabdeckung (Code Coverage) erhalten Sie weitergehende Informationen.
- Durchlaufen Sie die automatisierten Tests sowohl Ihrer eigenen als auch des neuen Produkts.
- Schließlich sollten Sie die Funktionalität und das User Interface auch in Ihrem Browser testen.

Allgemeinere und umfassendere Informationen zur Evaluation von OpenSource- Software erhalten Sie im Artikel Software-Evaluation.

Installation und Aktivierung¶

Zusatzprodukte können unter install_requires in der setup.py``-Datei angegeben werden, also z.B.:
```
install_requires=[
    'setuptools',
    'Plone',
    'vs.event',
],
```

Anschließend wird das Zusatzprodukt noch in der Instanz registriert in der configure.zcml-Datei:

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:five="http://namespaces.zope.org/five"
    xmlns:i18n="http://namespaces.zope.org/i18n"
    xmlns:genericsetup="http://namespaces.zope.org/genericsetup"
    i18n_domain="vs.policy">
    <includeDependencies package="." />
    …
</configure>

<includeDependencies package="." />: fügt alle Pakete der install_requires-Liste einer Site hinzu.

Sollen die Pakete explizit angegeben werden, kann dies z.B. erfolgen mit:

<include package="vs.event" />

Damit unser Zusatzprodukt beim Aufsetzen einer neuen Plone-Site mit unserem vs.policy-Produkt automatisch aktiviert wird, sollten wir es noch in der metadata.xml-Datei eintragen:
```
<?xml version="1.0"?>
<metadata>
  <version>1.0</version>
  <dependencies>
    <dependency>profile-vs.event:default</dependency>
  </dependencies>
</metadata>
```
Schließlich sollten diese Änderungen noch in unserem Buildout-Projekt übernommen werden. Hierzu wird das Buildout-Skript erneut aufgerufen:
```
$ bin/buildout
```

Tests¶

Zunächst müssen wir sicherstellen, dass ``vs.event´´ in unseren Tests zur Verfügung steht:

class VsPolicy(PloneSandboxLayer):
    defaultBases = (PLONE_FIXTURE,)
    def setUpZope(self, app, configurationContext):
        # Load ZCML
        import vs.policy
        xmlconfig.file(
            'configure.zcml',
            vs.policy,
            context=configurationContext
        )
        # Install products that use an old-style initialize()
        # function
        z2.installProduct(app, 'vs.event')

def tearDownZope(self, app):
    # Uninstall products installed above
    z2.uninstallProduct(app, 'vs.event')

def setUpPloneSite(self, portal):
    applyProfile(portal, 'vs.policy:default')

Nun fügen wir den eigentlichen Test hinzu:

def test_vs_event_installed(self):
    portal = self.layer['portal']
    portal_types = getToolByName(portal, 'portal_types')
    self.assertTrue("VSEvent" in portal_types)

Schließlich führen wir diesen Test aus:
```
$ ./bin/test
```