{ "info": { "author": "Plone Foundation", "author_email": "plone-developers@lists.sourceforge.net", "bugtrack_url": null, "classifiers": [ "Development Status :: 6 - Mature", "Framework :: Plone", "Framework :: Plone :: 5.2", "Framework :: Plone :: Core", "Framework :: Zope :: 4", "License :: OSI Approved :: GNU General Public License (GPL)", "Programming Language :: Python", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "=================\nplone.app.z3cform\n=================\n\nA Plone specific integration and HTML mark-up for z3c.form.\n\n.. contents:: Table of Contents\n\nIntroduction\n==============\n\nThis Plone package is aimed for developers who want to create forms\nin Python code.\n\nPlease read the documentation for `z3c.form`_, which contains important\ninformation about using z3c.form in Zope 2 in general. For the most part,\nthat package contains the \"active\" parts that you need to know about, and\nthis package provides \"passive\" overrides that make the forms integrate with\nPlone.\n\nInstallation\n============\n\nPlone 4.1 and later include *plone.app.z3cform* in Plone core. Older versions need to install\nthe addon separately as your own add-on dependency.\n\nFeatures\n============\n\nThe following Plone and z3c.form integration is added\n\n* Plone *main_template.pt* integration\n\n* Plone specific widget frame\n\n* Date/time pickers\n\n* WYSIWYG widget (TinyMCE visual editor with Plone support)\n\n* CRUD forms\n\nOut of the box form templates\n==================================\n\nThe form and widget templates are applied in the following order\n\n* *plone.app.z3cform* specific\n\n* *plone.z3cform* specific\n\n* *z3c.form* specific\n\n*plone.app.z3cform* package overrides the ``@@ploneform-macros`` view from `plone.z3cform`_,\nusing standard Plone markup for form fields, fieldsets, etc.\n\nAll the macros described in `plone.z3cform`_ are still available. In addition,\nyou can use the ``widget_rendering`` macro to render all the default widgets,\nbut none of the fieldsets (groups) or the fieldset headers (which would be\nrendered with the ``fields`` macro).\n\nEach widget is rendered using the ``@@ploneform-render-widget`` view, which by\ndefault includes the widget's label, required indicator, description, errors,\nand the result of ``widget.render()``. This view may be overridden for\nparticular widget types in order to customize this widget chrome.\n\nCustomizing form behavior\n============================\n\nForm method\n-------------\n\nIf your form instance defines a property called ``method`` it allows\nyou to set whether form is HTTP POST or HTTP GET. The default is POST.\nThis translates to ``