Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mishbahr/djangocms-forms
The easiest and most flexible Django CMS Form builder — Create forms quickly without ever touching code. Every field type you may need is available within a simple drag and drop interface.
https://github.com/mishbahr/djangocms-forms
Last synced: about 2 months ago
JSON representation
The easiest and most flexible Django CMS Form builder — Create forms quickly without ever touching code. Every field type you may need is available within a simple drag and drop interface.
- Host: GitHub
- URL: https://github.com/mishbahr/djangocms-forms
- Owner: mishbahr
- License: bsd-3-clause
- Created: 2015-04-25T18:13:58.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-04-04T14:54:48.000Z (9 months ago)
- Last Synced: 2024-05-16T11:03:18.310Z (8 months ago)
- Language: Python
- Homepage: https://pypi.python.org/pypi/djangocms-forms/
- Size: 1.84 MB
- Stars: 123
- Watchers: 14
- Forks: 96
- Open Issues: 28
-
Metadata Files:
- Readme: README.rst
- Contributing: CONTRIBUTING.rst
- License: LICENSE
- Authors: AUTHORS.rst
Awesome Lists containing this project
- awesome-django-cms - djangocms-forms - A django CMS Form builder. (Add-ons)
README
================
djangocms-forms
================
.. image:: http://img.shields.io/travis/mishbahr/djangocms-forms.svg?style=flat-square
:target: https://travis-ci.org/mishbahr/djangocms-forms/
.. image:: http://img.shields.io/pypi/v/djangocms-forms.svg?style=flat-square
:target: https://pypi.python.org/pypi/djangocms-forms/
:alt: Latest Version
.. image:: http://img.shields.io/pypi/dm/djangocms-forms.svg?style=flat-square
:target: https://pypi.python.org/pypi/djangocms-forms/
:alt: Downloads
.. image:: http://img.shields.io/pypi/l/djangocms-forms.svg?style=flat-square
:target: https://pypi.python.org/pypi/djangocms-forms/
:alt: License
.. image:: http://img.shields.io/coveralls/mishbahr/djangocms-forms.svg?style=flat-square
:target: https://coveralls.io/r/mishbahr/djangocms-forms?branch=master
This project requires django-cms v3.0 or higher to be properly installed and configured.
This package is compatible with `Aldryn `_.
Quickstart
----------
1. Install ``djangocms-forms``::
pip install djangocms-forms
2. Add ``djangocms_forms`` to ``INSTALLED_APPS``::
INSTALLED_APPS = (
...
'djangocms_forms',
...
)
3. Sync database tables (requires south>=1.0.1 if you are using Django 1.6.x)::
python manage.py migrate
4. Add ``djangocms_forms.urls`` to your project's ``urls`` module or create a django CMS page to hook the application into. In ``Advanced Settings``, set its Application to ``Forms`` (this requires a server restart)::
urlpatterns = patterns(
...
url(r'^', include('djangocms_forms.urls')),
...
)
5. To use reCAPTCHA for spam protection, you need to sign up for an API key pair for your site::
DJANGOCMS_FORMS_RECAPTCHA_PUBLIC_KEY = ''
DJANGOCMS_FORMS_RECAPTCHA_SECRET_KEY = ''
You can register a new site via https://www.google.com/recaptcha/admin
Configuration
--------------
Plugin(s) Module - If module is None, plugin is grouped Generic group::
DJANGOCMS_FORMS_PLUGIN_MODULE = _('Generic')
Name of the plugin::
DJANGOCMS_FORMS_PLUGIN_NAME = _('Form')
The path to the default template used to render the template::
DJANGOCMS_FORMS_DEFAULT_TEMPLATE = 'djangocms_forms/form_template/default.html'
or override the ``Form Template`` dropdown choices to have different template options::
DJANGOCMS_FORMS_TEMPLATES = (
('djangocms_forms/form_template/default.html', _('Default')),
)
HTML5 required - When set to True all required fields inputs will be rendered with HTML5 ``required=required`` attribute::
DJANGOCMS_FORMS_USE_HTML5_REQUIRED = False
By default, ``djangocms-forms`` adds additional css classes to all form inputs. e.g. a ``Text`` field generates an ```` You can override this to integrate your own CSS framework::
DJANGOCMS_FORMS_WIDGET_CSS_CLASSES = {'__all__': ('form-control', ) }
e.g. the above setting would generate `` DJANGOCMS_FORMS_REDIRECT_DELAY > 1000 (default)
Preview
--------
.. image:: http://mishbahr.github.io/djangocms-forms/assets/resized/djangocms_forms_001.jpeg
:target: http://mishbahr.github.io/djangocms-forms/assets/djangocms_forms_001.png
:width: 768px
:align: center
.. image:: http://mishbahr.github.io/djangocms-forms/assets/resized/djangocms_forms_005.jpeg
:target: http://mishbahr.github.io/djangocms-forms/assets/djangocms_forms_005.png
:width: 768px
:align: center
.. image:: http://mishbahr.github.io/djangocms-forms/assets/resized/djangocms_forms_002.jpeg
:target: http://mishbahr.github.io/djangocms-forms/assets/djangocms_forms_002.png
:width: 768px
:align: center
.. image:: http://mishbahr.github.io/djangocms-forms/assets/resized/djangocms_forms_003.jpeg
:target: http://mishbahr.github.io/djangocms-forms/assets/djangocms_forms_003.png
:width: 768px
:align: center
.. image:: http://mishbahr.github.io/djangocms-forms/assets/resized/djangocms_forms_004.jpeg
:target: http://mishbahr.github.io/djangocms-forms/assets/djangocms_forms_004.png
:width: 768px
:align: center
You may also like...
--------------------
* djangocms-disqus - https://github.com/mishbahr/djangocms-disqus
* djangocms-embed - https://github.com/mishbahr/djangocms-embed
* djangocms-fbcomments - https://github.com/mishbahr/djangocms-fbcomments
* djangocms-gmaps - https://github.com/mishbahr/djangocms-gmaps
* djangocms-instagram - https://github.com/mishbahr/djangocms-instagram
* djangocms-responsive-wrapper - https://github.com/mishbahr/djangocms-responsive-wrapper
* djangocms-twitter2 - https://github.com/mishbahr/djangocms-twitter2
* djangocms-youtube - https://github.com/mishbahr/djangocms-youtube