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.
License
The project is licensed under the GPLv2.
Contributors
RedTurtle Technology, sviluppoplone@redturtle.it
Changelog
2.1.1 (2024-03-06)
Avoid error when getting collection by UID. [daniele]
2.1.0 (2023-11-28)
Add ‘Show Description’ option, default disabled to match rendering in previous versions of the tile. [fredvd]
Plone 6 support: Refactor Mosaic addon support to use zcml condition instead of using the quickinstaller tool. [fredvd]
Plone 6 support: Remove unused dependency on plone.formwidget.contenttree [fredvd]
2.0.0 (2022-09-14)
Drop includeDependencies=”.” in order to work with pip [mamico]
1.3.1 (2021-09-27)
Simplified and improved checks for registered renderers. [cekk]
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file collective.tiles.collection-2.1.1.tar.gz.
File metadata
- Download URL: collective.tiles.collection-2.1.1.tar.gz
- Upload date:
- Size: 25.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.8.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d87eb4f98f3495720fe33c83412b5ee7f64733978a99235569c70a72cd3231ae |
|
| MD5 | b592da9cdc6f793bcb6c3afe24bfe2fe |
|
| BLAKE2b-256 | b34f083dd82168546a36ff77010b0031c12fa70f1a5f5f77718bc116d5620494 |
