Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/collective/collective.behavior.banner
Add banners and create slider/carousel from banners
https://github.com/collective/collective.behavior.banner
Last synced: about 2 months ago
JSON representation
Add banners and create slider/carousel from banners
- Host: GitHub
- URL: https://github.com/collective/collective.behavior.banner
- Owner: collective
- Created: 2014-10-08T13:00:53.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-07-08T15:02:25.000Z (2 months ago)
- Last Synced: 2024-07-09T00:19:17.226Z (2 months ago)
- Language: Python
- Homepage:
- Size: 426 KB
- Stars: 3
- Watchers: 111
- Forks: 6
- Open Issues: 10
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES.rst
Awesome Lists containing this project
- awesome-plone - collective.behavior.banner - A behavior to create banners and sliders from banners. (Media)
README
collective.behavior.banner
==========================A behavior to create banners and sliders from banners.
Features
========Banner
------A banner is usually some text and an image that is displayed above of the content.
The behavior ``collective.behavior.banner.banner.IBanner`` has various fields (image, title, subtitle, richtext, link, linkcaption etc) that are combined to build a banner. You can enable the behavior on any Dexterity type (tested with plone.app.contenttypes) or for the whole Plone site.
Slider
------The behavior ``collective.behavior.banner.slider.ISlider`` adds the option to add relations to several banners (i.e. items that have the Banner behavior enabled). These banners are then displayed like a banner but fade.
The slider viewlet uses the javascript library http://responsiveslides.com and fades from one banner to another. You can easily use a different javascript libray by overriding the viewlet templates (see below).
Before you use a slider/carousel on your website, please take time to read http://shouldiuseacarousel.com.
Inheriting
----------Banners are inherited by child objects. In a controlpanel you can configure which types should display inherited banners. You can also prevent inheriting banners for an item and its child objects by enabling the option *Do not inherit banner from parents* on the banner tab. If you want a banner for the entire site, you can assign one to the default content of the Navigation Root (or Plone site root).
Customization
=============To change the appearance (e.g. if you use a bootstrap theme or want to use a different effect in the slider) you can easily override the respective viewlets with `z3c.jbot `_ or `plone.app.themingplugins `_ (if you use plone.app.theming). The names of the files to create would be ``collective.behavior.banner.browser.banner.pt`` and ``collective.behavior.banner.browser.slider.pt``.
Demo
====collective.behavior.banner is used on the following sites:
* http://www.plone.de
* http://python-verband.org
* http://www.bildungswerk-bayern.deCompatibility
=============collective.behavior.banner works in Plone 4, 5 and 6.
* Plone 6: 2.x
* Plone 5: 1.x
* Plone 4: 0.xInstallation
============To install `collective.behavior.banner` you simply add ``collective.behavior.banner`` to the list of eggs in your buildout, run buildout and restart Plone. Then, install `collective.behavior.banner` using the Add-ons control panel.
Enable the behavior by hand or in the FTI ``/profiles/default/types/Folder.xml``:
.. code:: xml
Contribute
----------* Source Code: https://github.com/collective/collective.behavior.banner
* Issue Tracker: https://github.com/collective/collective.behavior.banner/issuesSupport
-------If you are having issues, please let us know at https://github.com/collective/collective.behavior.banner/issues.