Contents
EEA Uberlisting enhances and extends the listing layouts capabilities of Plone.
This view is enabled through an action called Enable UberlistingView which is found within the actions dropdown menu for the content types mentioned in the introduction.
- As of 2.0 all of the Plone tips and tricks that are described in the section of tips and tricks can be added through the Uberlisting View form allowing therefore users without permission to the ZMI to make changes to the view
After we load these results we trigger an event which you can hook on in order to modify the listing
ex: $(window).bind('Uberlisting.Success', function(ev) { // Run galleryView on the listing results $('#content').galleryView(); });
By default when doing the ajax load the load is checking if content-core is available and if so it's content is added in the div with the id uber-view-content.
If your template doesn't have the content inside the content-core div then it will return the results of the first div it find on the content that was returned from the ajax load.
Therefore if you want to influence the result or your template doesn't have the content-core id than just wrap the desired content inside of div tag.
- As mentioned in the upgrade steps these steps no longer need to be added manually, however by visiting manage_properties you can see these properties added after using the view form.
In ZMI > context > manage_properties: Add a 'lines' property named bannedUberlistingTemplates.
Here add one by one the template id's that you would like to be skipped from the listing.
ex: folder_summary_view folder_contents
In ZMI > context > manage_properties: Add a 'string' property named defaultUberlistingTemplate and add the template id that should be used as the default template.
ex: folder_summary_view
By default if this property isn't set and no cookie is present with the name of the default template then folder_listing will be used as default.
This packages looks for a png image to use for the views listing in the format of template id + '.png'.
ex: folder_summary_view.png
We have provides some images for the common Plone templates as well as some for our own templates, if you need a different style for the icons you can customize them TTW or you can have a skin layer before uberlisting_imgs with images that have the same name.
If no images are found then the template name will be displayed in the listing.
If you don't want to have the listing of templates with images and you would prefer to have only template name then In ZMI > context > manage_properties: Add a checked boolean property named 'noUberlistingTemplateImages'
- If you have eea.depiction installed you can configure a fallback image for the contenttypes that do not have an image field by default, allowing the content to be displayed in a view where the listing would look better with images like album view.
- If you have eea.facetednavigation installed you can use uberlisting_view as a view for the Faceted Navigation, allowing you to combine the search capabilities of it with the ability to change between views from the same template.
If you are using zc.buildout and the plone.recipe.zope2instance recipe to manage your project, you can do this:
Update your buildout.cfg file:
- Add
eea.uberlisting
to the list of eggs to install - You can skip the ZCML slug since this package is using the z3c.autoinclude include directive
[instance] ... eggs = ... eea.uberlisting
- Add
Re-run buildout, e.g. with:
$ ./bin/buildout
- EEA Uberlisting has the following dependencies:
- Plone 4+
- EEA jQuery - we are depending and loading only the jquery.bbq plugin
- This package also supports other EEA Packages. Thus the following dependencies are optional:
- Latest source code (Plone 4 compatible):
The Initial Owner of the Original Code is European Environment Agency (EEA). All Rights Reserved.
The eea.uberlisting (the Original Code) is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
More details under docs/License.txt
EEA - European Environment Agency (EU)