Skip to main content

A tile that shows a set of collection results with a customizable layout

Project description

A tile that shows collection results with customizable layouts

Features

  • Emulates the old portlet collection behaviors

  • Mosaic-ready

  • Additional css class field, to append a custom css class to the tile container

  • Customizable layouts list

Installation

Install collective.tiles.collection by adding it to your buildout:

[buildout]
...
eggs =
    collective.tiles.collection

and then running bin/buildout

Usage

You can’t use this tile without a tile manager (or maybe, you can if you create new tiles manually in some specific context) like Mosaic or redturtle.tiles.management

When you try to create a new collection tile, you have a form like the portlet’s one.

Customizable layouts

When you create/edit a collection tile, there is a field that allows you to select the final layout from a list. This list is generated with a specific set of view that satisfy following rules:

  • The Class must implement ICollectiveTilesCollectionLayer interface

  • In the Class there should be an attribute display_name with a human-readable title

  • The template need to define a macro called collection-tile-macro

This is an example:

configure.zcml:

<browser:page
    name="additional_renderer"
    permission="zope2.View"
    for="*"
    class=".additional_render.View"
    layer=".interfaces.ISomeBrowserLayer"
    template="additional_render.pt"
/>

additional_render.py:

from Products.Five.browser import BrowserView
from collective.tiles.collection.interfaces import ICollectionTileRenderer
from zope.interface import implements
from collective.tiles.collection import _


class AdditionalView(BrowserView):
    implements(ICollectionTileRenderer)

    display_name = _("Another tile layout")

additional_render.pt:

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
      xmlns:tal="http://xml.zope.org/namespaces/tal"
      xmlns:metal="http://xml.zope.org/namespaces/metal"
      xmlns:i18n="http://xml.zope.org/namespaces/i18n"
      lang="en"
      metal:use-macro="here/main_template/macros/master"
      i18n:domain="collective.tiles.collection">
  <body>
    <metal:macro define-macro="collection-tile-macro">
      ...
    </metal:macro>
  </body>
</html>

Translations

This product has been translated into

  • Italian

Contribute

Credits

Developed with the support of:

Regione Emilia-Romagna supports the PloneGov initiative.

Authors

This product was developed by RedTurtle Technology team.

RedTurtle Technology Site

License

The project is licensed under the GPLv2.

Contributors

Changelog

1.3.0 (2021-09-10)

  • Python3 compatibility. [cekk]

  • Do not use templates registered from unavailable layers. [cekk]

1.2.1 (2021-05-07)

  • Fix translations. [cekk]

1.2.0 (2019-01-09)

  • Fixed permission to see empty tile collection message.

  • Fixed vocabulary source for schema choice in tile collecton to support pam. [eikichi18]

  • List of renderers is now sorted by title. [cekk]

1.1.3 (2018-08-21)

  • Fix document outline [nzambello]

  • Improved navigation experience when choosing the collection to use [daniele]

1.1.2 (2018-08-02)

  • Enable other content types to be chosen as the More link [daniele]

  • Fixed a bug that hid a tile collection with no elements to display. If a user can edit the tiles, now he can see the empty tile. [arsenico13]

  • Update some italian translations. [arsenico13]

  • Fix templates for container styles in base view and in empty tile handling [nzambello]

1.1.1 (2018-03-06)

  • Added Custom “more…” collection field [fdelia]

1.1 (11/10/2017)

  • Production release [lucabel]

1.0a2 (2017-09-13)

  • Removed unused css class [cekk]

1.0a1 (2017-03-31)

  • Initial release. [cekk]

  • Fix indentation on README.rst

Project details


Download files

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

Source Distribution

collective.tiles.collection-1.3.0.tar.gz (24.3 kB view details)

Uploaded Source

File details

Details for the file collective.tiles.collection-1.3.0.tar.gz.

File metadata

  • Download URL: collective.tiles.collection-1.3.0.tar.gz
  • Upload date:
  • Size: 24.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.7.0 requests/2.25.1 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.7.11

File hashes

Hashes for collective.tiles.collection-1.3.0.tar.gz
Algorithm Hash digest
SHA256 55c6742ae60edad4ba44b31fd31c110b2f2f4ac0c1bddc449c1268fc7ca9d47b
MD5 1ec92e6317f723efab3cbc4cee5e6b3b
BLAKE2b-256 ed49a75e5db44e98500dbe5f9d451005377f21d134108633df86029c11ee66ca

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 Pingdom Monitoring Sentry Error logging StatusPage Status page