Metadata-Version: 2.1
Name: collective.behavior.banner
Version: 1.3
Summary: An add-on for Plone
Home-page: https://pypi.python.org/pypi/collective.behavior.banner
Author: Philip Bauer
Author-email: bauer@starzel.de
License: GPL version 2
Description: .. image:: https://travis-ci.org/collective/collective.behavior.banner.svg?branch=master
            :target: https://travis-ci.org/collective/collective.behavior.banner
        
        .. image:: https://coveralls.io/repos/github/collective/collective.behavior.banner/badge.svg?branch=master
            :target: https://coveralls.io/github/collective/collective.behavior.banner?branch=master
        
        
        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 <http://pypi.python.org/pypi/z3c.jbot>`_ or `plone.app.themingplugins <https://pypi.python.org/pypi/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.de
        
        
        Compatibility
        =============
        
        collective.behavior.banner works in Plone 4 and Plone 5.
        
        For Plone 4 use Version 0.2. For Plone 5 use 1.0b1 and higher.
        
        The branch `plone4 <https://github.com/collective/collective.behavior.banner/tree/plone4>`_ supports Plone 4 while the branch `master <https://github.com/collective/collective.behavior.banner/tree/master>`_ works in Plone 5 only.
        
        
        Installation
        ============
        
        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  ``<your_package>/profiles/default/types/Folder.xml``:
        
        .. code:: xml
        
            <?xml version="1.0"?>
            <object name="Folder" meta_type="Dexterity FTI">
             <property name="behaviors" purge="False">
              <element value="collective.behavior.banner.banner.IBanner"/>
             </property>
            </object>
        
        
        Contribute
        ----------
        
        * Source Code: https://github.com/collective/collective.behavior.banner
        * Issue Tracker: https://github.com/collective/collective.behavior.banner/issues
        
        
        Support
        -------
        
        If you are having issues, please let us know at https://github.com/collective/collective.behavior.banner/issues.
        
        
        
        - Philip Bauer, bauer@starzel.de
        - Steffen Lindner, lindner@starzel.de
        - Stefan Antonelli, stefan.antonelli@operun.de
        - Fulvio Casali, fulviocasali@gmail.com
        - Valentin Piret, valentin@affinitic.be
        
        
        :orphan:
        
        Changelog
        =========
        
        1.3 (2021-01-22)
        ----------------
        
        - Set RelatedItemsFieldWidget to search to find all banners for a slider.
          [pbauer]
        
        - Fix use of default_page
          [pbauer]
        
        - Use named behaviors.
          [pbauer]
        
        
        1.2 (2019-03-14)
        ----------------
        
        - Add support for Python 3.
          [pbauer]
        
        
        1.1 (2018-09-18)
        ----------------
        
        - Use the banner from the root default content if there is one
          [Vaal24]
        
        
        1.0 (2018-08-16)
        ----------------
        
        - Add alt tag for banner image.
          [tlotze]
        
        
        1.0b2 (2017-06-20)
        ------------------
        
        - Pass full banner-obj to templates to allow accessing object-attibutes.
          [pbauer]
        
        - Test against Plone 5.0.7 and fix all pep8-issues.
          [pbauer]
        
        - Show YouTube and Vimeo videos in a banner.
          [fulv]
        
        
        1.0b1 (2015-11-30)
        ------------------
        
        - Use p5-style resources.
          [pbauer]
        
        - No longer explicitly set the relateditemswidget (it's default in p5).
          [pbauer]
        
        - Fix RelationList widget for slider_relation field. Fixes #1.
          [fulv]
        
        - Remove last traces of grok.
          [fulv]
        
        - Add compatability to Plone 5 with new buildout and test-setup.
          [pbauer]
        
        
        0.2 (2015-11-30)
        ----------------
        
        - Add Documentation.
          [pbauer]
        
        - Remove grok.
          [pbauer]
        
        - Simplify traversing.
          [pbauer]
        
        - Unify css and templates.
          [gomez]
        
        - Basic styling for banner/slider.
          [santonelli]
        
        
        0.1 (26.3.2014)
        ----------------
        
        - Initial release.
          [pbauer, gomez]
        
        
Keywords: Python Plone
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 5.0
Classifier: Framework :: Plone :: 5.1
Classifier: Framework :: Plone :: 5.2
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Provides-Extra: test
