apps-store/website_form_recaptcha

========================
Website Form - ReCaptcha
========================

.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! 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-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fwebsite-lightgray.png?logo=github
    :target: https://github.com/OCA/website/tree/13.0/website_form_recaptcha
    :alt: OCA/website
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/website-13-0/website-13-0-website_form_recaptcha
    :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/13.0
    :alt: Try me on Runbot

|badge1| |badge2| |badge3| |badge4| |badge5| 

Adds a ReCaptcha field widget for website forms (extends the `website_form` module).

**Translations**

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.

**Table of contents**

.. contents::
   :local:

Configuration
=============

First of all you must obtain
a ReCaptcha key from `Google <http://www.google.com/recaptcha/admin>`_

**Multi website setup**

* Go to website settings
* Select the website you want to add / edit the recaptcha key
* Set site key and secret key

For testing purposes you can set this keys (https://developers.google.com/recaptcha/docs/faq#id-like-to-run-automated-tests-with-recaptcha.-what-should-i-do):

* Site key: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
* Secret key: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

Usage
=====

To use this module, you need to:

* Already have a form-enabled model (refer to `website_form` docs)
* The recaptcha code will be injected dinamically.

Known issues / Roadmap
======================

* Add domain validation
* Split recaptcha APIs from `website_form` dependency
  (ie: new module `website_recaptcha_base`)

Changelog
=========

11.0.1.2.1 (Unreleased)
~~~~~~~~~~~~~~~~~~~~~~~

* Fix handling of request attribute
* Add backward compatibility for recent API refactoring

  [simahawk]

11.0.1.2.0 (2019-01-10)
~~~~~~~~~~~~~~~~~~~~~~~

* Refactor APIs and allow per-website config

  * API keys can now be configured via website settings
    which in turn allow to customize the values per website
    in a multi-website instance;

  * move all internal APIs to the model `website.form.recaptcha`
    so that we do not depend anymore on the controller
    if we need to integrate it into other pieces of code.

  * Use readme fragments

  [simahawk]


11.0.1.1.0 (2019-01-10)
~~~~~~~~~~~~~~~~~~~~~~~

* Improve JS and enforce translations

  Make JS modular and pass language parameter according to website lang.

  [mpanarin]

* Fix duplicated calls

  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.

* Fix JS LINT errors

* Improve error handling to show all error messages at the same time

  [chienandalu]


11.0.1.0.0 (2017-10-30)
~~~~~~~~~~~~~~~~~~~~~~~

* Migrate to v11

  [dbo-odoo]

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_recaptcha%0Aversion:%2013.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
~~~~~~~

* LasLabs
* Tecnativa

Contributors
~~~~~~~~~~~~

* Dave Lasley <dave@laslabs.com>
* Mykhailo Panarin <m.panarin@mobilunity.com>
* Simone Orsi <simone.orsi@camptocamp.com>

* `Tecnativa <https://www.tecnativa.com>`__:

  * Cristina Martin R.
  * Jairo Llopis
  * Alexandre Díaz
  * David Vidal

* Bjorn Billen <bjorn.billen@dynapps.be>

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/13.0/website_form_recaptcha>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.