Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

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


Release history Release notifications

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django_mailformer-0.0.1-py2.py3-none-any.whl (16.9 kB) Copy SHA256 hash SHA256 Wheel 3.5
django-mailformer-0.0.1.tar.gz (9.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page