====================
Website Form Builder
====================
.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-LGPL--3-blue.png
:target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
:alt: License: LGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fwebsite-lightgray.png?logo=github
:target: https://github.com/OCA/website/tree/12.0/website_form_builder
:alt: OCA/website
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/website-12-0/website-12-0-website_form_builder
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
:target: https://runbot.odoo-community.org/runbot/186/12.0
:alt: Try me on Runbot
|badge1| |badge2| |badge3| |badge4| |badge5|
This module provides websites the feature of adding custom forms in any page.
**Table of contents**
.. contents::
:local:
Installation
============
Install some other addon that provides ``website_form`` support to
benefit from this one's features. Hints:
* ``website_crm``
* ``website_form_project``
* ``website_hr_recruitment``
* ``website_sale``
Configuration
=============
To configure this module, you need to:
#. Have *Administration / Settings* privileges.
#. Go to *Settings > Activate developer mode*.
#. Go to *Settings > Technical > Database Structure > Models*.
#. Search for the model you want to manage website form access for.
#. When you find it, it will have a *Website Forms* section where you can:
* Allow the model to get forms, by checking *Allowed to use in forms*.
* Give the model forms a better name in *Label for form action*.
* Choose the field where to store custom fields data in *Field for custom
form data*. If you leave this one empty and the model is a mail thread,
a new message will be appended with that custom data.
#. In the *Fields* tab, there's a new column called *Blacklisted in web forms*.
It's a security feature that forbids form submitters to write to those
fields. When you create a new website form, all its model fields are
automatically whitelisted for the sake of improving the UX. If you want to
have higher control, come back here after creating the form and blacklist
any fields you want, although that will only work for custom fields.
Usage
=====
To use this module, you need to:
#. Go to any of your website pages.
#. Edit it.
#. Drag and drop the *Form* snippet into the page.
#. Use the snippet overlay to add, edit and remove fields.
#. If you want to set a hidden field, make sure you set a valid default value
on it, or users may get hidden errors and they might even be unable to send
the form!
Known issues / Roadmap
======================
* These type of fields will not appear, they are forbidden since they make no
sense in this module's context, or a correct implementation would be adding
not much value while adding lots of complexity:
* ``id``
* ``create_uid``
* ``create_date``
* ``write_uid``
* ``write_date``
* ``__last_update``
* Any ``one2many`` fields
* Any ``reference`` fields
* Any ``serialized`` fields
* Any read-only fields
* You should include https://github.com/odoo/odoo/pull/21628 in your
installation to get a better UX when a user has already sent a form and
cannot resend it.
* To edit any ``<label>`` text, you need to click twice. Review the problem
once https://bugzilla.mozilla.org/show_bug.cgi?id=853519 gets fixed.
* You cannot edit base fields blacklisted status manually because
`Odoo forbids that for security
<https://github.com/OCA/website/pull/402#issuecomment-356930433>`_.
* ``website_form`` works in unexpected and undocumented ways. If you plan to
add support in your addon, `this is a good place to start reading
<https://github.com/OCA/website/pull/402#discussion_r157441770>`_.
* If you add a custom file upload field to a form that creates records in
models that have no ``mail.thread`` inheritance, your users will be unable
to send the form.
* This module it's incompatible with 'website_form_recaptcha' module.
Bug Tracker
===========
Bugs are tracked on `GitHub Issues <https://github.com/OCA/website/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
`feedback <https://github.com/OCA/website/issues/new?body=module:%20website_form_builder%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
Do not contact contributors directly about support or help with technical issues.
Credits
=======
Authors
~~~~~~~
* Tecnativa
Contributors
~~~~~~~~~~~~
* `Tecnativa <https://www.tecnativa.com>`_:
* Jairo Llopis <jairo.llopis@tecnativa.com>
* Alexandre Díaz <alexandre.diaz@tecnativa.com>
Other credits
~~~~~~~~~~~~~
Images
------
* https://openclipart.org/detail/281632/form
* https://openclipart.org/detail/224192/simple-grey-small-pencil-icon-white-background
Maintainers
~~~~~~~~~~~
This module is maintained by the OCA.
.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org
OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.
This module is part of the `OCA/website <https://github.com/OCA/website/tree/12.0/website_form_builder>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
Raw data
{
"_id": null,
"home_page": "https://github.com/OCA/website",
"name": "odoo12-addon-website-form-builder",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": "",
"keywords": "",
"author": "Tecnativa, Odoo Community Association (OCA)",
"author_email": "support@odoo-community.org",
"download_url": "",
"platform": "",
"description": "====================\nWebsite Form Builder\n====================\n\n.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! This file is generated by oca-gen-addon-readme !!\n !! changes will be overwritten. !!\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n\n.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png\n :target: https://odoo-community.org/page/development-status\n :alt: Beta\n.. |badge2| image:: https://img.shields.io/badge/licence-LGPL--3-blue.png\n :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html\n :alt: License: LGPL-3\n.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fwebsite-lightgray.png?logo=github\n :target: https://github.com/OCA/website/tree/12.0/website_form_builder\n :alt: OCA/website\n.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png\n :target: https://translation.odoo-community.org/projects/website-12-0/website-12-0-website_form_builder\n :alt: Translate me on Weblate\n.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png\n :target: https://runbot.odoo-community.org/runbot/186/12.0\n :alt: Try me on Runbot\n\n|badge1| |badge2| |badge3| |badge4| |badge5| \n\nThis module provides websites the feature of adding custom forms in any page.\n\n**Table of contents**\n\n.. contents::\n :local:\n\nInstallation\n============\n\nInstall some other addon that provides ``website_form`` support to\nbenefit from this one's features. Hints:\n\n* ``website_crm``\n* ``website_form_project``\n* ``website_hr_recruitment``\n* ``website_sale``\n\nConfiguration\n=============\n\nTo configure this module, you need to:\n\n#. Have *Administration / Settings* privileges.\n#. Go to *Settings > Activate developer mode*.\n#. Go to *Settings > Technical > Database Structure > Models*.\n#. Search for the model you want to manage website form access for.\n#. When you find it, it will have a *Website Forms* section where you can:\n\n * Allow the model to get forms, by checking *Allowed to use in forms*.\n * Give the model forms a better name in *Label for form action*.\n * Choose the field where to store custom fields data in *Field for custom\n form data*. If you leave this one empty and the model is a mail thread,\n a new message will be appended with that custom data.\n\n#. In the *Fields* tab, there's a new column called *Blacklisted in web forms*.\n It's a security feature that forbids form submitters to write to those\n fields. When you create a new website form, all its model fields are\n automatically whitelisted for the sake of improving the UX. If you want to\n have higher control, come back here after creating the form and blacklist\n any fields you want, although that will only work for custom fields.\n\nUsage\n=====\n\nTo use this module, you need to:\n\n#. Go to any of your website pages.\n#. Edit it.\n#. Drag and drop the *Form* snippet into the page.\n#. Use the snippet overlay to add, edit and remove fields.\n#. If you want to set a hidden field, make sure you set a valid default value\n on it, or users may get hidden errors and they might even be unable to send\n the form!\n\nKnown issues / Roadmap\n======================\n\n* These type of fields will not appear, they are forbidden since they make no\n sense in this module's context, or a correct implementation would be adding\n not much value while adding lots of complexity:\n\n * ``id``\n * ``create_uid``\n * ``create_date``\n * ``write_uid``\n * ``write_date``\n * ``__last_update``\n * Any ``one2many`` fields\n * Any ``reference`` fields\n * Any ``serialized`` fields\n * Any read-only fields\n\n* You should include https://github.com/odoo/odoo/pull/21628 in your\n installation to get a better UX when a user has already sent a form and\n cannot resend it.\n\n* To edit any ``<label>`` text, you need to click twice. Review the problem\n once https://bugzilla.mozilla.org/show_bug.cgi?id=853519 gets fixed.\n\n* You cannot edit base fields blacklisted status manually because\n `Odoo forbids that for security\n <https://github.com/OCA/website/pull/402#issuecomment-356930433>`_.\n\n* ``website_form`` works in unexpected and undocumented ways. If you plan to\n add support in your addon, `this is a good place to start reading\n <https://github.com/OCA/website/pull/402#discussion_r157441770>`_.\n\n* If you add a custom file upload field to a form that creates records in\n models that have no ``mail.thread`` inheritance, your users will be unable\n to send the form.\n\n* This module it's incompatible with 'website_form_recaptcha' module.\n\nBug Tracker\n===========\n\nBugs are tracked on `GitHub Issues <https://github.com/OCA/website/issues>`_.\nIn case of trouble, please check there if your issue has already been reported.\nIf you spotted it first, help us smashing it by providing a detailed and welcomed\n`feedback <https://github.com/OCA/website/issues/new?body=module:%20website_form_builder%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.\n\nDo not contact contributors directly about support or help with technical issues.\n\nCredits\n=======\n\nAuthors\n~~~~~~~\n\n* Tecnativa\n\nContributors\n~~~~~~~~~~~~\n\n* `Tecnativa <https://www.tecnativa.com>`_:\n * Jairo Llopis <jairo.llopis@tecnativa.com>\n * Alexandre D\u00edaz <alexandre.diaz@tecnativa.com>\n\nOther credits\n~~~~~~~~~~~~~\n\nImages\n------\n\n* https://openclipart.org/detail/281632/form\n* https://openclipart.org/detail/224192/simple-grey-small-pencil-icon-white-background\n\nMaintainers\n~~~~~~~~~~~\n\nThis module is maintained by the OCA.\n\n.. image:: https://odoo-community.org/logo.png\n :alt: Odoo Community Association\n :target: https://odoo-community.org\n\nOCA, or the Odoo Community Association, is a nonprofit organization whose\nmission is to support the collaborative development of Odoo features and\npromote its widespread use.\n\nThis module is part of the `OCA/website <https://github.com/OCA/website/tree/12.0/website_form_builder>`_ project on GitHub.\n\nYou are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.\n\n\n",
"bugtrack_url": null,
"license": "LGPL-3",
"summary": "Build customized forms in your website",
"version": "12.0.1.2.1",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9b4e6921b1b4ffd667ca599aa61902c22f7b43d2ec6211533e30377b46baf19f",
"md5": "c582b592ee676e18c691f64eb0a0956d",
"sha256": "51381673422aeb22d6fc1c92d717a1d9c7f25fe8207e97ec27bca3c6ced24807"
},
"downloads": -1,
"filename": "odoo12_addon_website_form_builder-12.0.1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c582b592ee676e18c691f64eb0a0956d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 41449,
"upload_time": "2020-07-25T04:43:45",
"upload_time_iso_8601": "2020-07-25T04:43:45.552624Z",
"url": "https://files.pythonhosted.org/packages/9b/4e/6921b1b4ffd667ca599aa61902c22f7b43d2ec6211533e30377b46baf19f/odoo12_addon_website_form_builder-12.0.1.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2020-07-25 04:43:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "OCA",
"github_project": "website",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "odoo12-addon-website-form-builder"
}
JSON
