# django-grappelli-captcha-admin
Easy added captcha to Django administration login page. inherit from a-roomana/django-multi-captcha-admin
---
## Dependency
To use this module you need to install django and one of the captcha engines, which you can install it with easy_install or pip.
---
## Installation
Install:
pip install django-grappelli-captcha-admin
if you are using python 2 then install version 1.0.0 (*`pip install django-multi-captcha-admin==1.0.0`*)
Add `'multi_captcha_admin'` to your `INSTALLED_APPS` setting before `'django.contrib.admin'` app.
```python
INSTALLED_APPS = [
...
'captcha_admin',
'django.contrib.admin',
...
]
CAPTCHA_CHALLENGE_FUNCT = 'captcha.helpers.math_challenge'
CAPTCHA_TIMEOUT = 1
CAPTCHA_GET_FROM_POOL_TIMEOUT = 0
CAPTCHA_BACKGROUND_COLOR = '#bbaaaa'
```
### Engines
We support three famous engines to render CAPTCHA. You need to install one of them, then add it to your django project according to their documents.
- [simple-captcha](https://github.com/mbi/django-simple-captcha)
- [recaptcha](https://github.com/praekelt/django-recaptcha)
- [recaptcha2](https://github.com/kbytesys/django-recaptcha2)
For more information, please go to the engine site.
Then add the following to your `settings.py` with the name of the installed engine:
```python
MULTI_CAPTCHA_ADMIN = {
'engine': 'simple-captcha',
}
```
----------
## Results
[simple captcha](https://github.com/mbi/django-simple-captcha)
![captcha of recaptcha](https://github.com/xcai/django-grappelli-captcha-admin/blob/main/django-simple-captcha.png)
[recaptcha2](https://github.com/kbytesys/django-recaptcha2)
![captcha of recaptcha2](http://bayanbox.ir/view/2417903076718397977/reCaptcha2.png)
[recaptcha](https://github.com/praekelt/django-recaptcha)
![captcha of recaptcha](http://bayanbox.ir/view/2014387201108001651/reCaptcha.png)
Raw data
{
"_id": null,
"home_page": "http://github.com/xcai/django-grappelli-captcha-admin",
"name": "django-grappelli-captcha-admin",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": "",
"keywords": "django captcha recaptcha recaptcha2 simple-captcha admin grappelli",
"author": "xcai",
"author_email": "xxiaocai@163.com",
"download_url": "https://files.pythonhosted.org/packages/7a/f9/5939bc0136658987867b00ab7f57ec380d8929b4ac0aeee8298dcc426136/django-grappelli-captcha-admin-1.0.0.tar.gz",
"platform": "any",
"description": "# django-grappelli-captcha-admin\n\n\nEasy added captcha to Django administration login page. inherit from a-roomana/django-multi-captcha-admin\n\n---\n## Dependency\n\nTo use this module you need to install django and one of the captcha engines, which you can install it with easy_install or pip.\n\n---\n## Installation\n\nInstall:\n\n pip install django-grappelli-captcha-admin\n\nif you are using python 2 then install version 1.0.0 (*`pip install django-multi-captcha-admin==1.0.0`*)\n\n\nAdd `'multi_captcha_admin'` to your `INSTALLED_APPS` setting before `'django.contrib.admin'` app.\n\n```python\nINSTALLED_APPS = [\n\t...\n\t'captcha_admin',\n\t'django.contrib.admin',\n\t...\n]\n\nCAPTCHA_CHALLENGE_FUNCT = 'captcha.helpers.math_challenge'\nCAPTCHA_TIMEOUT = 1\nCAPTCHA_GET_FROM_POOL_TIMEOUT = 0\nCAPTCHA_BACKGROUND_COLOR = '#bbaaaa'\n```\n\n### Engines\n\nWe support three famous engines to render CAPTCHA. You need to install one of them, then add it to your django project according to their documents.\n\n - [simple-captcha](https://github.com/mbi/django-simple-captcha)\n - [recaptcha](https://github.com/praekelt/django-recaptcha)\n - [recaptcha2](https://github.com/kbytesys/django-recaptcha2)\n\nFor more information, please go to the engine site.\n\nThen add the following to your `settings.py` with the name of the installed engine:\n\n```python\nMULTI_CAPTCHA_ADMIN = {\n 'engine': 'simple-captcha',\n}\n```\n\n----------\n## Results\n[simple captcha](https://github.com/mbi/django-simple-captcha)\n\n![captcha of recaptcha](https://github.com/xcai/django-grappelli-captcha-admin/blob/main/django-simple-captcha.png)\n\n[recaptcha2](https://github.com/kbytesys/django-recaptcha2)\n\n![captcha of recaptcha2](http://bayanbox.ir/view/2417903076718397977/reCaptcha2.png)\n\n\n[recaptcha](https://github.com/praekelt/django-recaptcha)\n\n![captcha of recaptcha](http://bayanbox.ir/view/2014387201108001651/reCaptcha.png)\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "easy added captcha to login page of django grappelli admin",
"version": "1.0.0",
"project_urls": {
"Download": "https://pypi.python.org/pypi/django-grappelli-captcha-admin/",
"Homepage": "http://github.com/xcai/django-grappelli-captcha-admin"
},
"split_keywords": [
"django",
"captcha",
"recaptcha",
"recaptcha2",
"simple-captcha",
"admin",
"grappelli"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "77fea586ab29fa7e56020158711153f009956fc16fb93adfe3c70c89dab1009c",
"md5": "c6b53e055a0b03abb56e584bf0b88fd4",
"sha256": "c21d0d3d09505d1d322f04eed2c99bd1308ebeb1248cd65112aec013c1804cb9"
},
"downloads": -1,
"filename": "django_grappelli_captcha_admin-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c6b53e055a0b03abb56e584bf0b88fd4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 6409,
"upload_time": "2023-08-11T09:26:08",
"upload_time_iso_8601": "2023-08-11T09:26:08.380463Z",
"url": "https://files.pythonhosted.org/packages/77/fe/a586ab29fa7e56020158711153f009956fc16fb93adfe3c70c89dab1009c/django_grappelli_captcha_admin-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7af95939bc0136658987867b00ab7f57ec380d8929b4ac0aeee8298dcc426136",
"md5": "1b3f90b1da585cf46cc2cf3493aa9969",
"sha256": "68736172ab54019bcaa9d1515b9142af232a5c2b6dd1545898d610260813ba87"
},
"downloads": -1,
"filename": "django-grappelli-captcha-admin-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "1b3f90b1da585cf46cc2cf3493aa9969",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 5451,
"upload_time": "2023-08-11T09:26:10",
"upload_time_iso_8601": "2023-08-11T09:26:10.077087Z",
"url": "https://files.pythonhosted.org/packages/7a/f9/5939bc0136658987867b00ab7f57ec380d8929b4ac0aeee8298dcc426136/django-grappelli-captcha-admin-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-11 09:26:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "xcai",
"github_project": "django-grappelli-captcha-admin",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "django-grappelli-captcha-admin"
}