{ "info": { "author": "Ben Davis", "author_email": "bendavis78@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "=================\nDjango FormHelper\n=================\n\nDjango FormHelper is a collection of templates and templatetags to ease the \npain in building out web forms. It does this by breaking the form down into\nseparate re-usable and customizable components. This allows you to only \ncustomize the parts you want, and let the rest happen automatically.\n\n\nUsage\n=============\nAfter installing django-formhelper, add ``formhelper`` to your ``INSTALLED_APPS`` in your ``settings.py``.\n\nIn your template, you need to load ``formhelper``::\n\n ...\n {% load formhelper %}\n ...\n\n\nTemplate Tags\n=============\n\n----------\nform_field\n----------\nRender out a single form field. Uses the template ``formhelper/includes/field.html``. Example usage::\n\n {% form_field contact_form first_name %}\n \nIf your form is in your view's context as the variable \"form\", you can omit the first argument::\n\n {% form_field first_name %}\n\nOtherwise, you can use the \"with\" templatetag::\n\n {% with my_form as form %}\n ...\n {% form_field first_name %}\n ...\n {% endwith %}\n\n\n--------\nform_row\n--------\nLike form_field, but renders out multiple fields. Uses the template ``formhelper/includes/form_row.html``. Example usage::\n\n {% form_row first_name middle_name last_name %}\n\n\n----------\nerror_list\n----------\nRender out the form error list as an unordered list. Uses the template ``formhelper/includes/error_list.html`` Example usage::\n\n {% error_list %}\n \nYou may also render out only non-field errors or only field-specific errors::\n\n {% error_list non_field %}\n ... or ...\n {% error_list field %}\n \n-----------\nclass_names\n-----------\nRenders a list of useful class names for a field that includes the field name, the widget type, whether or not the field is requried, and whether or not the field has an error.\n\nFor example, if your field was a textinput named \"first_name\" and it was required::\n \n