This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Contents

Introduction

betahaus.openmember is a database for managing members and tracking changes to their personal information. This includes memberships to fiscal years, participation to events etc.

Installation

buildout:
  • Add betahaus.openmember entries to eggs and zcml in the appropriate buildout configuration file. (typcially buildout.cfg)
  • Re-run buildout. (./bin/buildout)
  • Restart the instance
  • Install via portal_quickinstaller or Site Setup in plone

Events

There are four events available OMemberAddedEvent, OMemberWillBeModifiedEvent, OMemberModifiedEvent and OMemberDeletedEvent. Register a listener like:

<subscriber
  for="betahaus.openmember.interfaces.IOMemberAddedEvent"
  handler=".handlers.added"
  />

where handlers.py looks like:

>>> def added(event):
...     contenttype_object = event.object
...     databse_object = event.om_object

Configuration

After following the install instructions you need to configure the database for what content to monitor and what fields of that content to monitor. Now you can choose to use a shipped content type called MemberPerson. Or you can take any content type that you like and make sure it implements the interface betahaus.openmember.interfaces.IOpenMember. The recommended way is to add a zcml five:implements entry:

<five:implements
    class="path.to.your.contentType"
    interface="betahaus.openmember.interfaces.IOpenMember"/>

Next you need to configure what fields on your content type that will be monitored. This is done via the openmember controlpanel reachable from the Site Setup. Each field configuration should have the structure of:

field_name | index_type | label
field_name
This is the field name of the content type.
index_type
This is the type of index to be used, typical indexes are ZCTextIndex, DateIndex and KeywordIndex.
label
What should be displayed for this field. This parameter is optional.

You can also set what fields that should be title fields. These fields are the fields that show up in the search portlet and result table.

Extending the control panel

Open Member can easily be extended with extra functionality. Sometimes the extension requires configuration using a configuration panel. To help the user in having all the configurations related to OpenMember in the same place you can register sub sections to the OpenMember configuration panel.

Two parts are needed to register an extension to the configuration panel. One schema that defines the fields that make up the configuration panel, and one adapter the implements the schema and takes care of reading/writing the values.

The schema should have the following structure:

>>> from betahaus.openmember.interfaces import IOMControlPanelForm
>>> from zope import schema
>>> class ExampleSchema(IOMControlPanelForm):
...     """Example schema for openmember sub control panel"""
...     example = schema.List(name='example')

The key point here is that the schema must inherit from the IOMControlPanelForm and have a schema based on zope.schema.

The adapter should have the following structure:

>>> from Products.CMFDefault.formlib.schema import SchemaAdapterBase
>>> from Products.CMFPlone.interfaces import IPloneSiteRoot
>>> from betahaus.openmember.browser.controlpanel import
>>> from betahaus.exports.openmember import PROJECTNAME
>>> class ExamplePanelAdapter(SchemaAdapterBase):
...     """Openmember control panel extension for examples settings."""
...     implements(ExampleSchema)
...     adapts(IPloneSiteRoot)
...
...     def getId(self):
...         """The Id must be lowercase"""
...         return 'example'
...
...     def getLabel(self):
...         """The label can be translated to any language"""
...         return _(u'Example')
...
    --- Getters and setters for the schema defined above. ---
>>> registerForm(ExampleSchema, PROJECTNAME)
The key points here are::
  • The adapter should inherit from SchemaAdapterBase or has that in the inheritance chain.
  • The adapter must implement the Schema defined previously, including the functions getId and getLabel
  • The registration of the schema with the OpenMember control panel

The last step is to register the adapter in zcml:

<adapter factory=".controlpanel.ExamplePanelAdapter" />

Now you are done.

Contributors

Change history

0.2b (2011-03-23)

  • Fixed duplicate GopipIndex that caused controlpanel to die. [mlundwall]
  • Fixed problem to display catalog contents in ZMI. [mlundwall]
  • Fixed search results table compatibility with Plone 4. [mlundwall]
  • Added deprecation to install method in setuphandlers - this can be done with GS [robinharms]
  • Changed i18n translations to locales [robinharms]
  • Added possibility for not-operations in the portlet and search view [robinharms]
  • Temporary patch to removed orphaned objects from catalog search results [robinharms]
  • Memberdata shoudln’t be created if id isn’t passed as an argument [robinharms]
  • Added index for mapped portal type [robinharms]
  • Added delete functionality [robinharms]
  • Fixed situation where the search result template could pass an empty query to the catalog [robinharms]

0.1b3 (2010-10-08)

  • Made the options list sorted by Title. [mlundwall]
  • Fixed a bug of clearing indexes on reinstall. [mlundwall]
  • Added possibility to on field level define om_accessor. [mlundwall]
  • Changed the reference caching in the table view to lookup on need. [mlundwall]
  • Fixed a bug with modified date on database objects. [mlundwall]
  • Made an Archetypes independent MemberData implementation [mlundwall]
  • Added roles for searching and managing the database. [mlundwall]
  • MemberData is now responsible for versioning. [mlundwall]
  • Removed import of private AT function that doesn’t exist in Plone 4. [robinharms]
  • Plone 4 compatibility check [mlundwall, robinharms]

0.1b2 (2010-02-15)

  • Made the controlpanel extensions a bit more intelligent. [mlundwall]
  • Easier configuration of indexes in controlpanel. [mlundwall]
  • Update member information if UID in database even on InitializedEvent. [mlundwall]

0.1b (2010-02-10)

  • Results have a link to the original content [mlundwall]
  • Configuration of indexes to show in table and portlet [mlundwall]
  • Batching on search page and Fiscal Year [mlundwall]
  • Lots more…

0.1a1 - (2009-06-16)

  • First Alpha release

Known Issues

  • Unicode characters are displayed weird in Safari. They are not handled properly.
  • The results template don’t display labels from vocabularies but the ids instead.
Release History

Release History

0.2b

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1b3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1b2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1b

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1adev-r1651

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1a

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
betahaus.openmember-0.2b.zip (98.8 kB) Copy SHA256 Checksum SHA256 Source Mar 23, 2011

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting