Metadata-Version: 2.1
Name: plone.formwidget.hcaptcha
Version: 1.0.0
Summary: Hcaptcha widget for Plone.
Home-page: https://github.com/plone/plone.formwidget.hcaptcha
Author: Timo Stollenwerk - Plone Foundation
Author-email: plone-developers@lists.sourceforge.net
License: GPLv2
Keywords: plone discussion plone.app.discussion spam captcha hcaptcha
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: Addon
Classifier: Framework :: Plone :: 5.2
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: plone.app.registry
Requires-Dist: plone.registry
Requires-Dist: Products.CMFCore
Requires-Dist: setuptools
Requires-Dist: z3c.form
Requires-Dist: zope.annotation
Requires-Dist: zope.component
Requires-Dist: zope.i18nmessageid
Requires-Dist: zope.interface
Requires-Dist: zope.publisher
Requires-Dist: zope.schema
Requires-Dist: Zope2
Provides-Extra: test
Requires-Dist: plone.api ; extra == 'test'
Requires-Dist: plone.app.testing ; extra == 'test'

Introduction
============

plone.formwidget.hcaptcha is a ``z3c.form`` HCaptcha widget for use with Plone.

It is a re-work of the 'plone.formwidget.recaptcha'_ package original written by Timo Stollenwerk.

.. _plone.forwwidget.recaptcha: http://github.com/plone/plone.formwidget.recaptcha


Buildout Installation
---------------------

Add the following code to your buildout.cfg to install plone.formwidget.hcaptcha::

    [buildout]
    ...

    [instance]
    ...
    eggs =
        ...
        plone.formwidget.hcaptcha
        ...


ReCaptcha setup
---------------

There is a control panel at ``http://path/to/site/@@hcaptcha-settings`` to configure the Addon.
HCaptcha provides test keys, that can be used to try out the hcaptcha form and
documentation at https://docs.hcaptcha.com/.

``Site key: 10000000-ffff-ffff-ffff-000000000001``

``Secret key: 0x0000000000000000000000000000000000000000``

To actually use the service, you must obtain a site key and secret key from
`https://www.hcaptcha.com/signup-interstitial <https://www.hcaptcha.com/signup-interstitial/>`_

Usage
-----
See the `demo <https://github.com/plone/plone.formwidget.hcaptcha/tree/master/src/plone/formwidget/hcaptcha/demo>`_ folder inside the distribution for an example usage.

Supermodel
^^^^^^^^^^
You can add a captcha field in an XML model by adding something like this::

    <field name="captcha" type="plone.formwidget.hcaptcha.HCaptchaWidget">
      <title>Solve Captcha</title>
      <description></description>
    </field>



Source Code
-----------

Contributors please read the document `Process for Plone core's development <http://docs.plone.org/develop/plone-coredev/index.html>`_

Sources are at the `Plone code repository hosted at Github <https://github.com/plone/plone.formwidget.hcaptcha>`_.

Changelog
=========

.. You should *NOT* be adding new change log entries to this file, this
   file is managed by towncrier. You *may* edit previous change logs to
   fix problems like typo corrections or such.

.. towncrier release notes start

1.0.0 (2021-06-10)
------------------

Breaking changes:


- Move from Recaptcha to Hcaptcha, using different api and captcha service provider [andreasma]
  Remove compatibility with Python 2 and Plone versions minor to 5.2 [andreasma] (#30)


1.0.0 (unreleased)
------------------

- Initial release. [andreasma]


