Metadata-Version: 2.1
Name: aldryn-forms-recaptcha-plugin
Version: 0.0.1
Summary: This package provides a simple invisible recaptcha v3 implementation
Home-page: https://gitlab.com/what-digital/aldryn-forms-recaptcha-plugin/tree/master
Author: what.digital
Author-email: mario@what.digital
License: UNKNOWN
Download-URL: https://gitlab.com/what-digital/aldryn-forms-recaptcha-plugin/-/archive/0.0.1/aldryn-forms-recaptcha-plugin-0.0.1.tar.gz
Platform: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: aldryn-forms (>=4)
Requires-Dist: django-recaptcha (>=2)

# Aldryn Forms Recaptcha Plugin

This python module is open-source, available here: https://gitlab.com/what-digital/aldryn-forms-recaptcha-plugin/


## Versioning and Packages

- versioning is done in versioning in `aldryn_forms_recaptcha_plugin/__init__.py`
- for each version a tag is added to the gitlab repository in the form of `^(\d+\.)?(\d+\.)?(\*|\d+)$`, example: 0.0.10

- There is a PyPI version which relies on the gitlab tags (the download_url relies on correct gitlab tags being set): https://pypi.org/project/aldryn-forms-recaptcha-plugin/
- There is a DjangoCMS / Divio Marketplace add-on which also relies on the gitlab tags: https://marketplace.django-cms.org/en/addons/browse/aldryn-forms-recaptcha-plugin/

In order to release a new version of the Divio add-on:

- Increment version number in `addons-dev/aldryn-forms-recaptcha-plugin/aldryn_forms_recaptcha_plugin/__init__.py`
- divio addon validate
- divio addon upload
- Then git add, commit and tag with the version number and push to the repo

```
git add .
git commit -m "<message>"
git tag 0.0.XX
git push origin 0.0.19
```

Then, in order to release a new pypi version:

- python3 setup.py sdist bdist_wheel
- twine upload --repository-url https://test.pypi.org/legacy/ dist/*
- twine upload dist/*

### Development

- Run `pip install -e ../aldryn-forms-recaptcha-plugin/` in your demo project
- You can open aldryn_forms_recaptcha_plugin in pycharm and set the python interpreter of the demo project to get proper django support and code completion.


## Dependencies

- aldryn_forms

## Setup


- install the add-on on divio.com or via pypi `pip install aldryn-forms-recaptcha-plugin`
- add `aldryn-forms-recaptcha-plugin` to your requirements.txt or requirements.in
- add `aldryn_forms_recaptcha_plugin` to `INSTALLED_APPS`
- possibly, you want to copy the captcha widget from templates/ and adapt it according to the styling of error messages in your form. The example in this package is compatible with bootstrap4 and works well  with https://gitlab.com/what-digital/djangocms-aldryn-forms-bootstrap4-templates


### settings.py configuration

Configure the following settings in your `settings.py`:

```

INSTALLED_APPS += (
    # for the ReCaptchaField
    'aldryn_forms_recaptcha_plugin',  # needs to be before 'captcha' for template overriding
    'captcha',  # django-recaptcha
)

RECAPTCHA_PUBLIC_KEY = env('ALDRYN_FORMS_RECAPTCHA_SITE_KEY', '123')
RECAPTCHA_PRIVATE_KEY = env('ALDRYN_FORMS_RECAPTCHA_SECRET', '123')
# set this to 0 (or 1) to deactivate (or always activate) the captcha protection
RECAPTCHA_REQUIRED_SCORE = 0.85

```


## TODOs

- For this to work https://github.com/divio/aldryn-forms/issues/146 needs to be resolved by the maintainers of aldryn-forms 



