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
Description: 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]
        
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
Provides-Extra: test
