Metadata-Version: 1.0
Name: crispy-forms-foundation
Version: 0.3.1
Summary: 
Django application to add 'django-crispy-forms' layout objects for Foundation

Home-page: http://pypi.python.org/pypi/crispy-forms-foundation
Author: David Thenon
Author-email: sveetch@gmail.com
License: MIT
Description: .. _docutils: http://docutils.sourceforge.net/
        .. _Django: https://www.djangoproject.com/
        .. _django-crispy-forms: https://github.com/maraujop/django-crispy-forms
        .. _Foundation: http://github.com/zurb/foundation
        .. _Foundation Grid: http://foundation.zurb.com/docs/grid.php
        .. _crispy-forms-foundation-demo: https://github.com/sveetch/crispy-forms-foundation-demo
        
        Introduction
        ============
        
        This is a `Django`_ application to add `django-crispy-forms`_ layout objects for `Foundation`_ version ``3.5.x``.
        
        Actually this is only to use specific templates and changing some CSS class names.
        
        This app does not embed a `Foundation`_ release, you will have to install it yourself.
        
        Links
        *****
        
        * Download his `PyPi package <http://pypi.python.org/pypi/crispy-forms-foundation>`_;
        * Clone it on his `Github repository <https://github.com/sveetch/crispy-forms-foundation>`_;
        
        Requires
        ========
        
        * `django-crispy-forms`_ = 1.4.x;
        
        Installation
        ============
        
        Just register the app in your project settings like this :
        
        .. sourcecode:: python
        
            INSTALLED_APPS = (
                ...
                'crispy_forms',
                'crispy_forms_foundation',
                ...
            )
        
        Then append this part to specify usage of the Foundation set :
        
        .. sourcecode:: python
        
            # Default layout to use with "crispy_forms"
            CRISPY_TEMPLATE_PACK = 'foundation'
        
        All other `django-crispy-forms`_ settings option apply, see its documentation for more details.
        
        Usage
        =====
        
        Import **crispy-forms-foundation** then you can use the layout object in your forms :
            
        .. sourcecode:: python
        
            from crispy_forms_foundation.layout import Layout, Fieldset, Field, SplitDateTimeField, RowFluid, Column, Div, ButtonHolder, Submit, HTML
        
            class YourForm(forms.ModelForm):
                """
                *Page* form
                """
                def __init__(self, *args, **kwargs):
                    self.helper = FormHelper()
                    self.helper.form_action = '.'
                    self.helper.layout = Layout(
                        Fieldset(
                            ugettext('Content'),
                            'title',
                            'content',
                        ),
                        Fieldset(
                            ugettext('Display settings'),
                            RowFluid(
                                Column('template', css_class='six'),
                                Column('order', css_class='three'),
                                Column('visible', css_class='three'),
                            ),
                        ),
                        Fieldset(
                            ugettext('Publish settings'),
                            'parent',
                            RowFluid(
                                Column(SplitDateTimeField('published'), css_class='six'),
                                Column('slug', css_class='six'),
                            ),
                        ),
                        ButtonHolder(
                            Submit('submit_and_continue', ugettext('Save and continue')),
                            Submit('submit', ugettext('Save')),
                        ),
                    )
                    
                    super(YourForm, self).__init__(*args, **kwargs)
        
        The embedded templates are in ``crispy_forms_foundation/templates/foundation``.
        
        Layout items
        ************
        
        For now there is only three layout items dedicated to Foundation (Row, RowFluid, Column), other embedded items are cloned from the **uni_form** layout items from `django-crispy-forms`_.
        
        Row
        ---
        
        Act as a div container row, it will embed his items in a div like this : ::
        
            <div class"row">Your stuff</div>
        
        
        RowFluid
        --------
        
        It has a same behaviour than `Row`_ but add a CSS class "row-fluid" that you can use to have top level row that take all the container width. You have to put the CSS for this class to your CSS stylesheet. It will embed his items in a div like this : ::
        
            <div class"row row-fluid">Your stuff</div>
        
        The CSS to add should be something like this : ::
        
            .row-fluid {
                width: 100%;
                max-width: 100%;
                min-width: 100%;
            }
        
        Column
        ------
        
        This is the column from the `Foundation Grid`_, all columns should be contained in a `Row`_ or a `RowFluid`_ and you will have to define the column type in the ``css_class`` attribute.
        
        With a ``css_class`` attribute defined to ``twelve``, it will embed his items in a div like this : ::
        
            <div class"columns twelve">Your stuff</div>
        
        InlineField
        -----------
        
        Layout object for rendering an inline field with Foundation form.
        
        Example : ::
        
            InlineField('field_name')
        
        InlineJustifiedField
        --------------------
        
        Same as InlineField but default is to be right aligned with a middle vertical position
        
        Changelog
        =========
        
        Version 0.3.1
        *************
        
        * Added InlineField and InlineJustifiedField;
        
        Version 0.3.0
        *************
        
        Some backward incompatible change have been done, be sure to check them before upgrading.
        
        * Removed sample view, url and templates. If needed you can find a Django app sample on `crispy-forms-foundation-demo`_;
        * Moving ``foundation`` template pack name and its directory to ``foundation-3``. You have to change your ``settings.CRISPY_TEMPLATE_PACK`` if you used the old one;
        * Add ``foundation-5`` template pack, it is now the default template pack;
        * Removing camelcase on some css classes :
        
          * 'ctrlHolder' has changed to 'holder';
          * 'buttonHolder' has changed to 'button-holder';
          * 'asteriskField' has changed to 'asterisk';
          * 'errorField' has changed to 'error';
          * 'formHint' has changed to 'hint';
          * 'inlineLabel' has changed to 'inline-label';
          * 'multiField' has changed to 'multiple-fields';
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
