collective.portlet.collectionmultiview 2.1.5

A collection portlet product which supports multiple views

Introduction

The collectionmultiview portlet is a collection portlet which supports multiple view modes. It inherits the built-in plone.portlet.collection and extend it with view adapters support.

Writing additional views

Creating an additional view is as simple as writing a class which inherits from BaseRenderer, and register it as a named adapter

Sample code:

from collective.portlet.collectionmultiview import BaseRenderer
from zope.app.pagetemplate.viewpagetemplatefile import ViewPageTemplateFile

class MyCustomRenderer(BaseRenderer):
    title = 'My Custom Renderer'
    template = ViewPageTemplateFile('path/to/template.pt')

ZCML:

<configure
   xmlns="http://namespaces.zope.org/zope">

   <adapter name="mycustomrenderer"
       factory=".package.MyCustomRenderer"/>

</configure>

Extending portlet schema

You can also extend the portlet schema with additional fields by setting the ‘schema’ attribute in the renderer class.

Sample code:

from collective.portlet.collectionmultiview import BaseRenderer
from zope.app.pagetemplate.viewpagetemplatefile import ViewPageTemplateFile

from zope import schema
from zope.interface import Interface
from plone.app.form.widgets.wysiwygwidget import WYSIWYGWidget

class IExtraFields(Interface):
    my_extra_field = schema.Text(title=u'Extra field')

class MyCustomRenderer(BaseRenderer):
    title = 'My Custom Renderer'

    schema = IExtraFields
    template = ViewPageTemplateFile('path/to/template.pt')


    #optional
    custom_widgets = {
        'my_extra_field': WYSIWYGWidget
    }

Changelog

2.1.5 (2013-01-24)

• returning None on attribute not found introduced a major bug when editing, fixed it by moving this as an adapter in renderer [kagesenshi]

2.1.4 (2013-01-24)

• return None if attribute not found on Assignment to avoid crashy behavior when new fields are introduced by schema extender [kagesenshi]

2.1.3 (2013-01-03)

• ‘random’ field should be in primary schema rather than on default

  renderer schema [kagesenshi]

2.1.2 (2013-01-02)

• Add ‘available’ property to portlet renderer [kagesenshi]

2.1.1 (2012-12-06)

• Fix unicode decode error for unicode chars in href title for default renderer [kaerumy].

  Supported by: Centre for Internet Society, India

2.1.0 (2012-11-06)

• Added support for new style collection [kagesenshi]

2.0.2 (2012-03-26)

• Added way to assign custom widget [kagesenshi]

2.0.1 (2012-03-20)

• Fixed problem with installation of 2.0 due to missing README.rst [jone]

2.0 (2012-03-20)

• Added mechanism for additional views to extend the portlet schema [kagesenshi]

• Massive code cleanups [kagesenshi]

• CREDIT: changes above funded by cis-india.org

1.1.2 (2011-06-06)

• Plone 4.1 compat [aclark]

1.1.1 (2011-03-31)

• bugfix release. fixed a bug with the renderer selector using title as value

  instead of id

1.1 (2011-03-27)

• Plone4 compatibility

• Renderers now may have a human readable __name__

• Removed GalleryRenderer as it is broken anyway

• Hide unnecessary fields from the base Plone collection portlet.

1.0 (2010-12-19)

• fix permission used for portlet [vangheem]

0.1 (2009-12-31)

• Initial release