Skip to main content

Introduction

This package provides portlet which extends plone collection portlet in order to allow assigning different views for each newly created portlet through it’s edit form.

This is often required to have many collection portlets displaying different information in different places. Plone portlets provide us with portletRenderer directive which in general is really usefull, but it’s not an option because it overrides portlet renderer globally thus allowing to have only one template at a time.

Thus to avoid having some odd conditions in your collection portlet’s template NGCollection extends standard plone collection portlet with a template field where you can select template to use from available templates.

Apart from the ‘template’ field NGCollection portlet also adds ‘show_more_label’ field. This field is here to override default collection’s portlet ‘More…’ link text with some custom one entered by user.

Portlet Templates

In order to register new alternative templates for your portlet this package provides portletTemplates directive:

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

  <include package="collective.portlet.ngcollection" file="meta.zcml" />

  <plone:portletTemplates
      interface="path.to.some.portlet.assignment.Interface"
      directory="alternative_templates"
      />

</configure>

In this example we register templates contained inside alternative_templates folder as alternative templates available for path.to.some.portlet.assignment. Interface portlet. Thus you’ll be able to select one of them on portlet edit form via Plone interface.

You can register more than one directory for your portlet.

This idea with registering directories with custom templates was highly inspired by z3c.jbot package.

Contributors

  • Vitaliy Podoba

  • Roman Kozlovskyi

  • Volodymyr Cherepanyak

Changelog

1.3.1 (2013-02-12)

  • Fixed unexpected keyword argument error [kroman0]

1.3 (2013-01-17)

  • Fixed compatibility with Plone 4.3.x [kroman0]

1.2 (2012-01-23)

  • Fixed import deprecation and removed unused imports [mborch]

1.1 (2011-08-19)

  • fixed filesystem path binding [mylanium]

1.0 (2011-08-08)

  • long overdue release

0.1 (xxxx-xx-xx)

  • Initial release

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

collective.portlet.ngcollection-1.3.1.zip (38.8 kB view details)

Uploaded Source

File details

Details for the file collective.portlet.ngcollection-1.3.1.zip.

File metadata

File hashes

Hashes for collective.portlet.ngcollection-1.3.1.zip
Algorithm Hash digest
SHA256 a03dc115b53a09bc12bf3bcee4e610ad40cd2c21e3ee4f3b9896b8e3e1c1e1d6
MD5 62fc42344dc0c24954127be4cf904758
BLAKE2b-256 027fc65b7553fbeb39b4e92e8174c155fc057c473e0b3f5de97ccf8d5a40c722

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page