Skip to main content

Django Mailformer

Project description

=================
Django Mailformer
=================

Application setup
=================
Assuming you have added this application in your projects requirements.txt, you
can start using it by following these steps:

First start with installing:

.. code:: console

pip install git+ssh://git@github.com/developersociety/django-mailformer.git@master#egg=django-mailformer


1) Add `mailformer` to your applications in the settings file.
2) In your urls.py add to your url patterns:

.. code:: console

urlpatterns = [
# all the other values
url(r'^email/', include('mailformer.urls')),
]

The actual url these are added to is up to you. Do not define a namespace in
the include as this will prevent the internals of finding the URLs used for
the form and submission success page. It is however possible to manipulate
this if so required, however you will need to directly add the form and
submission page and override the constants.URL_NAME values.

3) In your template add `{% load mailformer %}`
4) Wherever you would display the email replace it with:

.. code:: console

<a href="{% get_url_by_email email_address %}">
contact form
</a>


Where `email_address` is the email_address you want to mail to.
You can also add other keys so that the form get prefilled values.

These keys are: [name, phone_number, subject, message]

The field `identifier` is hidden but required.

5) You should define your own forms by creating a submit form named
`mailformer/mailformer-form.html` and a success form named
`mailformer/mailformer-success.html`.


Development setup
=================

It's recommended you use `virtualenvwrapper <https://virtualenvwrapper.readthedocs.io/en/latest/>`_
and `The Developer Society Dev Tools <https://github.com/developersociety/tools>`_.

Presuming you are using those tools, getting started on this project is pretty straightforward:

.. code:: console

$ dev-clone example_instance
$ make reset

You can now run the development server:

.. code:: console

$ python manage.py runserver


=======
History
=======

0.0.0 (2017-06-14)
------------------

* Initial commit


0.0.0b (2017-06-22)
-------------------

* Refactor to new layout

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-mailformer-0.0.1.tar.gz (9.4 kB view hashes)

Uploaded Source

Built Distribution

django_mailformer-0.0.1-py2.py3-none-any.whl (16.9 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page