Search 1.9 billion lines of Odoo code on GitHub
website_form_recaptcha
<h1 class="title">Website Form - ReCaptcha</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/website/tree/13.0/website_form_recaptcha"><img alt="OCA/website" src="https://img.shields.io/badge/github-OCA%2Fwebsite-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/website-13-0/website-13-0-website_form_recaptcha"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/186/13.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>Adds a ReCaptcha field widget for website forms (extends the <cite>website_form</cite> module).</p>
<p><strong>Translations</strong></p>
<p>This module will try to use the language of your website.
If it can't find it for any reason,
it will default to google API
and use the language of the browser or your location.</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#configuration" id="id4">Configuration</a></li>
<li><a class="reference internal" href="#usage" id="id5">Usage</a></li>
<li><a class="reference internal" href="#known-issues-roadmap" id="id6">Known issues / Roadmap</a></li>
<li><a class="reference internal" href="#changelog" id="id7">Changelog</a><ul>
<li><a class="reference internal" href="#unreleased" id="id8">11.0.1.2.1 (Unreleased)</a></li>
<li><a class="reference internal" href="#id1" id="id9">11.0.1.2.0 (2019-01-10)</a></li>
<li><a class="reference internal" href="#id2" id="id10">11.0.1.1.0 (2019-01-10)</a></li>
<li><a class="reference internal" href="#id3" id="id11">11.0.1.0.0 (2017-10-30)</a></li>
</ul>
</li>
<li><a class="reference internal" href="#bug-tracker" id="id12">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id13">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id14">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id15">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id16">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="configuration"></a>
<h2><a class="toc-backref" href="#id4">Configuration</a></h2>
<p>First of all you must obtain
a ReCaptcha key from <a class="reference external" href="http://www.google.com/recaptcha/admin">Google</a></p>
<p><strong>Multi website setup</strong></p>
<ul class="simple">
<li>Go to website settings</li>
<li>Select the website you want to add / edit the recaptcha key</li>
<li>Set site key and secret key</li>
</ul>
<a name="usage"></a>
<h2><a class="toc-backref" href="#id5">Usage</a></h2>
<p>To use this module, you need to:</p>
<ul class="simple">
<li>Already have a form-enabled model (refer to <cite>website_form</cite> docs)</li>
<li>Set <cite>website_form_recaptcha</cite> to <cite>True</cite> on that model (similar to enabling forms)</li>
<li>Add an element with the <cite>o_website_form_recaptcha</cite> class anywhere in the form</li>
</ul>
<p>Look at <cite>website_crm_recaptcha</cite> module for example implementation.</p>
<a name="known-issues-roadmap"></a>
<h2><a class="toc-backref" href="#id6">Known issues / Roadmap</a></h2>
<ul class="simple">
<li>Add domain validation</li>
<li>Split recaptcha APIs from <cite>website_form</cite> dependency
(ie: new module <cite>website_recaptcha_base</cite>)</li>
</ul>
<a name="changelog"></a>
<h2><a class="toc-backref" href="#id7">Changelog</a></h2>
<a name="unreleased"></a>
<h3><a class="toc-backref" href="#id8">11.0.1.2.1 (Unreleased)</a></h3>
<ul>
<li><p class="first">Fix handling of request attribute</p>
</li>
<li><p class="first">Add backward compatibility for recent API refactoring</p>
<p>[simahawk]</p>
</li>
</ul>
<a name="id1"></a>
<h3><a class="toc-backref" href="#id9">11.0.1.2.0 (2019-01-10)</a></h3>
<ul>
<li><p class="first">Refactor APIs and allow per-website config</p>
<ul class="simple">
<li>API keys can now be configured via website settings
which in turn allow to customize the values per website
in a multi-website instance;</li>
<li>move all internal APIs to the model <cite>website.form.recaptcha</cite>
so that we do not depend anymore on the controller
if we need to integrate it into other pieces of code.</li>
<li>Use readme fragments</li>
</ul>
<p>[simahawk]</p>
</li>
</ul>
<a name="id2"></a>
<h3><a class="toc-backref" href="#id10">11.0.1.1.0 (2019-01-10)</a></h3>
<ul>
<li><p class="first">Improve JS and enforce translations</p>
<p>Make JS modular and pass language parameter according to website lang.</p>
<p>[mpanarin]</p>
</li>
<li><p class="first">Fix duplicated calls</p>
<p>When website_crm_phone_validation is installed,
the captcha validation is called twice
so the form always fail as with a 'timeout-or-duplicate' error.</p>
</li>
<li><p class="first">Fix JS LINT errors</p>
</li>
<li><p class="first">Improve error handling to show all error messages at the same time</p>
<p>[chienandalu]</p>
</li>
</ul>
<a name="id3"></a>
<h3><a class="toc-backref" href="#id11">11.0.1.0.0 (2017-10-30)</a></h3>
<ul>
<li><p class="first">Migrate to v11</p>
<p>[dbo-odoo]</p>
</li>
</ul>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id12">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/website/issues">GitHub Issues</a>.
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
<a class="reference external" href="https://github.com/OCA/website/issues/new?body=module:%20website_form_recaptcha%0Aversion:%2013.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="credits"></a>
<h2><a class="toc-backref" href="#id13">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id14">Authors</a></h3>
<ul class="simple">
<li>LasLabs</li>
<li>Tecnativa</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id15">Contributors</a></h3>
<ul class="simple">
<li>Dave Lasley <<a class="reference external" href="mailto:dave@laslabs.com">dave@laslabs.com</a>></li>
<li>Mykhailo Panarin <<a class="reference external" href="mailto:m.panarin@mobilunity.com">m.panarin@mobilunity.com</a>></li>
<li>Simone Orsi <<a class="reference external" href="mailto:simone.orsi@camptocamp.com">simone.orsi@camptocamp.com</a>></li>
<li><a class="reference external" href="https://www.tecnativa.com">Tecnativa</a>:<ul>
<li>Cristina Martin R.</li>
<li>Jairo Llopis</li>
<li>Alexandre Díaz</li>
</ul>
</li>
<li>Bjorn Billen <<a class="reference external" href="mailto:bjorn.billen@dynapps.be">bjorn.billen@dynapps.be</a>></li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id16">Maintainers</a></h3>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>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.</p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/website/tree/13.0/website_form_recaptcha">OCA/website</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>