Installation¶
Stable release¶
To install Wagtail Form Blocks, run this command in your terminal:
$ pip install wagtailformblocks
This is the preferred method to install Wagtail Form Blocks, as it will always install the most recent stable release.
If you don’t have pip installed, this Python installation guide can guide you through the process.
From sources¶
The sources for Wagtail Form Blocks can be downloaded from the Github repo.
You can either clone the public repository:
$ git clone git://github.com/LUKKIEN/wagtailformblocks
Or download the tarball:
$ curl -OL https://github.com/LUKKIEN/wagtailformblocks/tarball/master
Once you have a copy of the source, you can install it with:
$ python setup.py install
Configure Django¶
Add wagtailformblocks
, wagtail.wagtailforms
and wagtail.contrib.modeladmin
to your INSTALLED_APPS
in settings:
INSTALLED_APPS += [
'wagtailformblocks',
'wagtail.wagtailforms',
'wagtail.contrib.modeladmin'
]
Add wagtailformblocks.url
to your url config to enable the form processing views:
from wagtailformblocks import urls as wagtailformblock_urls
urlpatterns = [
...
url(r'^forms/', include(wagtailformblock_urls)),
...
]
For wagtailformblocks
to work correctly the form submit actions has to be processed
by a javascript. A simple implementation is provided as a static file.
To use this example add the following line to you HTML template:
<script src="{% static 'wagtailformblocks/js/formhandler.js' %}"></script>
Make sure jQuery is loaded as well.