Metadata-Version: 1.1
Name: rt.calendarinandout
Version: 1.1.0
Summary: A LinesWidget-like for Plone, used for selecting dates
Home-page: http://plone.org/products/rt.calendarinandout
Author: RedTurtle Technology
Author-email: sviluppoplone@redturtle.it
License: GPL
Description: Introduction
        ============
        
        **rt.calendarinandout** provides an archetype widget that allows to add and remove
        dates using the fancy `jquery.ui.datepicker plugin`__
        
        __ http://jqueryui.com/demos/datepicker/
        
        Usage
        =====
        
        The widget stores the information in to a LinesField archetype field.
        To use it just add a field like this in your archetype schema::
        
            from Products.Archetypes.atapi import LinesField
            from rt.calendarinandout.widget import CalendarInAndOutWidget
        
            LinesField(
                'dates',
                 widget = CalendarInAndOutWidget(
                    label=u"Dates",
                    description=u"Enter the dates in the form yyyy-mm-dd.",
                    ),
            )
        
        Then you can start enjoyng this widget!
        
        Configuration
        -------------
        
        You can use following additional widget options:
        
        ``auto_add``
            Instead of showing an "add date" button/icon, automatically add the date
            when selected on the calendar. Default is false.
        ``allow_duplicate``
             Allow the selection of the same date more and more times. Default is false.
        
        Screenshots
        -----------
        
        * The widget when no date is selected
        
          .. image:: http://keul.it/images/plone/rt.calendarinandout-0.png
             :alt: The widget when no date is selected
             :target: http://keul.it/images/plone/rt.calendarinandout-0.png
        
        * Data can be entered manually or clicking. If you click the calendar a nice datepicker will popup
        
          .. image:: http://keul.it/images/plone/rt.calendarinandout-1.png
             :alt: Data can be entered manually or clicking. If you click the calendar a nice datepicker will popup 
             :target: http://keul.it/images/plone/rt.calendarinandout-1.png
        
        * Clicking the plus the date will be added to the selected values, the red cross will remove the date
        
          .. image:: http://keul.it/images/plone/rt.calendarinandout-2.png
             :alt: Clicking the plus the date will be added to the selected values, the red cross will remove the date
             :target: http://keul.it/images/plone/rt.calendarinandout-2.png
        
          You can also set the ``auto_add`` option for not displaying any "plus" icon, and add the date to the list
          when a date is selected.
        
        * Add and remove all the dates you want
        
          .. image:: http://keul.it/images/plone/rt.calendarinandout-3.png
             :alt: Add and remove all the dates you want
             :target: http://keul.it/images/plone/rt.calendarinandout-3.png
        
        * With JavaScript disabled the widget is still fully functional, falling back to a normal textarea where
          you can insert dates manually
        
          .. image:: http://keul.it/images/plone/rt.calendarinandout-4.png
             :alt: With JavaScript disabled the widget is still fully functional
             :target: http://keul.it/images/plone/rt.calendarinandout-4.png
        
        * In view the dates are rendered as an unordered list
        
          .. image:: http://keul.it/images/plone/rt.calendarinandout-5.png
             :alt: In view the dates are rendered as an unordered list
             :target: http://keul.it/images/plone/rt.calendarinandout-5.png
        
        Add this egg to your buildout
        =============================
        
        Direct installation
        -------------------
        
        You can easily include **rt.calendarinandout** in your buildout by adding
        it in both in the eggs and zcml sections::
        
            eggs=...
                 rt.calendarinandout
                 ...
        
        Triggering the installation from your own egg
        ---------------------------------------------
        
        If you are developing your own egg you can make it depend on **rt.calendarinandout** 
        by following those three steps:
        
        * add **rt.calendarinandout** it in the install_requires section of the setup.py
          of *your egg*::
          
            install_requires=[...
                              'rt.calendarinandout'
                              ...]
        
        * add the dependency in *your egg* profiles/default/metadata.xml file::                   
        
            <?xml version="1.0"?>
            <metadata>
              <version>...</version>
              <dependencies>
                <dependency>profile-rt.calendarinandout:default</dependency>
              </dependencies>
            </metadata>
        
        * add the dependency in the configure.zcml at the root of your package, including this line::
        
            <include package="rt.calendarinandout" />
        
        Credits
        =======
        
        Developed with the support of:
        
        * `Rete Civica Mo-Net - Comune di Modena`__
          
          .. image:: http://www.comune.modena.it/grafica/logoComune/logoComunexweb.jpg 
             :alt: Comune di Modena's logo
        
        * `Regione Emilia Romagna`__
        
        All of them supports the `PloneGov initiative`__.
        
        __ http://www.comune.modena.it/
        __ http://www.regione.emilia-romagna.it/
        __ http://www.plonegov.it/
        
        Authors
        =======
        
        This product was developed by RedTurtle Technology team.
        
        .. image:: http://www.redturtle.it/redturtle_banner.png
           :alt: RedTurtle Technology Site
           :target: http://www.redturtle.it/
        
        
        TODO
        ----
        
        * Complete internazionalization
        * Add an option to trigger the client side validation of the added date format
        * Gives to developer a way to control date format used
        * Some artwork will be a nice plus :)
        
        Changelog
        =========
        
        1.1.0 (2013-10-30)
        ------------------
        
        * removed any deprecated reference to ``jq`` [keul]
        * do not pollute global namespace anymore [keul]
        * fixed disabled option ``allow_duplicate`` [keul]
        * when ``auto_add`` option is used, automatically clear
          the new date field [keul]
        * code cleanup
        
        1.0.3 (2012-05-02)
        ------------------
        
        * Egg changes as we moved to github [keul]
        * Enabled adding a date also with "enter" key [cekk]
        
        1.0.2 (2012-02-23)
        ------------------
        
        * Fix problem with widget activation on IE [lucabel] 
        
        1.0.1 (2011-10-04)
        ------------------
        
        * fix the problem with duplicate widgets in one schema [amleczko]
        
        1.0.0 (2011-02-07)
        ------------------
        
        * No more fix the the collective.js.jqueryui version; leave this to buildouts [keul]
        * removed "strip" non-standard method, replaced with a custom ".trim" method [keul]
        * added the "*auto_add*" option, for automatically add dates to the field when
          they are selected [keul]
        
        1.0.0-rc3 (2010-11-19)
        ----------------------
        
        * In view dates are rendered in an unordered list
        * Added documentation
        
        1.0.0-rc2 (2010-09-15)
        ----------------------
        
        * Fixed Javascript docstrings [keul]
        * Removed unused locales directory [keul]
        * Removed unused widget parameter "dateformat" [keul]
        * Some relative URL are now absolute, not breaking browser cache [keul]
        
        1.0.0-rc1 (Unreleased)
        ----------------------
        
        * Initial release
        
Keywords: plone widget lines calendar jquery jquery-ui
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 3.3
Classifier: Framework :: Plone :: 4.0
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Programming Language :: Python
Classifier: Programming Language :: JavaScript
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
