{ "info": { "author": "Florent Lebreton", "author_email": "florent.lebreton@makina-corpus.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.2", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Topic :: Utilities" ], "description": "A simple way to use `jSignature jQuery plugin `_ in your `Django `_ projects.\n\nIt provides:\n\n* A form field and a form widget to handle jquery plugin through a Django form;\n* A model field to store a captured signature;\n* A mixin adding two fields (signature / signature_date) in any of your Django models.\n\n.. image:: https://travis-ci.org/fle/django-jsignature.png?branch=master\n :target: https://travis-ci.org/fle/django-jsignature\n\n.. image:: https://coveralls.io/repos/fle/django-jsignature/badge.png\n :target: https://coveralls.io/r/fle/django-jsignature\n\n\n.. image:: https://github.com/fle/django-jsignature/blob/master/screen.png\n\n==================\nINSTALL\n==================\n\nFor now:\n\n::\n\n pip install django-jsignature\n\n==================\nUSAGE\n==================\n\n* Add ``jsignature`` to your ``INSTALLED_APPS``:\n\n::\n\n # settings.py\n INSTALLED_APPS = (\n ...\n 'jsignature',\n )\n\n* Use provided form field and widget:\n\n::\n\n # forms.py\n from django import forms\n from jsignature.forms import JSignatureField\n\n class SignatureForm(forms.Form):\n signature = JSignatureField()\n\n* In your template\n\n::\n\n {{ form.media }}\n
\n {% for field in form %}\n {{ field.label_tag }}\n {{ field }}\n {% endfor %}\n \n {% csrf_token %}\n
\n\n* Render image after form validation:\n\n::\n\n # views.py\n from jsignature.utils import draw_signature\n from myapp.forms import SignatureForm\n\n def my_view(request):\n form = SignatureForm(request.POST or None)\n if form.is_valid():\n signature = form.cleaned_data.get('signature')\n if signature:\n # as an image\n signature_picture = draw_signature(signature)\n # or as a file\n signature_file_path = draw_signature(signature, as_file=True)\n\n==================\nCUSTOMIZATION\n==================\n\nJSignature plugin options are available in python:\n\n* Globally, in your settings:\n\n::\n\n # settings.py\n JSIGNATURE_WIDTH = 500\n JSIGNATURE_HEIGHT = 200\n\n* Specifically, in your form:\n\n::\n\n # forms.py\n from jsignature.forms import JSignatureField\n from jsignature.widgets import JSignatureWidget\n\n JSignatureField(widget=JSignatureWidget(jsignature_attrs={'color': '#CCC'}))\n\nAvailable settings are:\n\n* ``JSIGNATURE_WIDTH`` (width)\n* ``JSIGNATURE_HEIGHT`` (height)\n* ``JSIGNATURE_COLOR`` (color)\n* ``JSIGNATURE_BACKGROUND_COLOR`` (background-color)\n* ``JSIGNATURE_DECOR_COLOR`` (decor-color)\n* ``JSIGNATURE_LINE_WIDTH`` (lineWidth)\n* ``JSIGNATURE_UNDO_BUTTON`` (UndoButton)\n* ``JSIGNATURE_RESET_BUTTON`` (ResetButton)\n\n==================\nIN YOUR MODELS\n==================\n\nIf you wan to store signatures, provided mixin gives a ``signature`` and a ``signature_date`` that update themselves:\n\n::\n\n from django.db import models\n from jsignature.mixins import JSignatureFieldsMixin\n\n class JSignatureModel(JSignatureFieldsMixin):\n name = models.CharField()\n\n\n==================\nAUTHORS\n==================\n\n * Florent Lebreton \n\n|makinacom|_\n\n.. |makinacom| image:: http://depot.makina-corpus.org/public/logo.gif\n.. _makinacom: http://www.makina-corpus.com\n\n\n\n=========\nCHANGELOG\n=========\n\n0.8 (2014-12-04)\n==================\n\n** New **\n\n- Add support for Python 3 (@Gagaro)\n- Add support for Django 1.7 (@Gagaro)\n\n\n0.7.6 (2014-11-26)\n==================\n\n** New features **\n\n- A setting to display (or not) the reset button has been added (@jsayles)\n\n** Internal changes **\n\n- Rendering is now based on a template (@andybak)\n- Javascript is properly initialized (@andybak)", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/fle/django-jsignature/tarball/0.8", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/fle/django-jsignature", "keywords": null, "license": "LPGL, see LICENSE file.", "maintainer": null, "maintainer_email": null, "name": "django-jsignature", "package_url": "https://pypi.org/project/django-jsignature/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/django-jsignature/", "project_urls": { "Download": "https://github.com/fle/django-jsignature/tarball/0.8", "Homepage": "https://github.com/fle/django-jsignature" }, "release_url": "https://pypi.org/project/django-jsignature/0.8/", "requires_dist": null, "requires_python": null, "summary": "Use jSignature jQuery plugin in your django projects", "version": "0.8" }, "last_serial": 1330926, "releases": { "0.7.6": [ { "comment_text": "", "digests": { "md5": "afc03f4be5252cb105fe929c96347957", "sha256": "8e41ca6b7325f3faa888117f13e504f41c191556862d547174485da9629941e6" }, "downloads": -1, "filename": "django-jsignature-0.7.6.tar.gz", "has_sig": false, "md5_digest": "afc03f4be5252cb105fe929c96347957", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21127, "upload_time": "2014-11-27T10:18:17", "url": "https://files.pythonhosted.org/packages/10/b8/75fc15aa37e867f4f4728e9f5b26b33a1b0d21acbdf505cdedf31634bea5/django-jsignature-0.7.6.tar.gz" } ], "0.8": [ { "comment_text": "", "digests": { "md5": "718e8ca123c8ca6f1ef9c9a4f7f514b1", "sha256": "c534c664315214accc630a515a1c904f14aad48a3e573d8edbc906d6e48d3589" }, "downloads": -1, "filename": "django-jsignature-0.8.tar.gz", "has_sig": false, "md5_digest": "718e8ca123c8ca6f1ef9c9a4f7f514b1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21413, "upload_time": "2014-12-04T12:59:01", "url": "https://files.pythonhosted.org/packages/79/12/7f583fd5bee867e9451c687d85a49f5ad0b83842d16602182337f1c3c778/django-jsignature-0.8.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "718e8ca123c8ca6f1ef9c9a4f7f514b1", "sha256": "c534c664315214accc630a515a1c904f14aad48a3e573d8edbc906d6e48d3589" }, "downloads": -1, "filename": "django-jsignature-0.8.tar.gz", "has_sig": false, "md5_digest": "718e8ca123c8ca6f1ef9c9a4f7f514b1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21413, "upload_time": "2014-12-04T12:59:01", "url": "https://files.pythonhosted.org/packages/79/12/7f583fd5bee867e9451c687d85a49f5ad0b83842d16602182337f1c3c778/django-jsignature-0.8.tar.gz" } ] }