django-newsletter icondjango-newsletter 0.4

Django app for managing multiple mass-mailing lists
django-newsletter is a Django application for managing multiple mass-mailing lists with both plaintext as well as HTML templates (and TinyMCE editor for HTML messages), images and a smart queueing system all right from the admin interface.

Status

We are currently using this package in several production environments, but it should still be considered a work in progress.

Requirements

Please refer to requirements.txt for an updated list of required packes.

Installation

 1. Get it from the Cheese Shop:

 pip install django-newsletter

 Or get the latest & greatest from Github and link it to your application tree:

 pip install -e git://github.com/dokterbob/django-newsletter.git#egg=django-newsletter

 (In either case it is recommended that you use VirtualEnv in order to keep your Python environment somewhat clean.)

 2. Add newsletter and to INSTALLED_APPS in settings.py and make sure that django-tinymce is there as well:

 INSTALLED_APPS = (
 ...
 'tinymce',
 ...
 'newsletter',
 ...
 )


3. Make the media dir available as {{ MEDIA_URL }}newsletter/ and do the same for the django-tinymce app.

 Preferably use something like django-staticmedia to manage the media files for your installed apps so you won't have to worry about this. You can simply pip install django-staticmedia and add the following to urls.py to make everything accessible in the development server:

 import staticmedia
 urlpatterns += staticmedia.serve()


 4. Configure TinyMCE if you have not already done so. At the very least make sure you set TINYMCE_JS_URL in settings.py to point to wherever tiny_mce.js is located. (Typically /media/tinymce/tiny_mce/tiny_mce.js)

 5. Create required data structure and load default template fixture:

 ./manage.py syncdb
 ./manage.py loaddata default_templates


 6. Run the tests to see if it all works:

 ./manage.py test

 If this fails, please contact me! If it doesn't: that's a good sign, chap. You'll probably have yourself a working configuration!

Usage

 1. Start the development server: ./manage.py runserver
 2. Navigate to /admin/ and: behold!
 3. Put a submission in the queue.
 4. Submit your message with ./manage.py runjob submit
 5. For a proper understanding, please take a look at the model graph.

http://github.com/dokterbob/django-newsletter/raw/master/graph_models.png

Unit tests

Fairly extensive tests are available for internal frameworks, web (un)subscription and mail sending. One feature currently untested is actually sending mail to very large numbers of recipients (1000+), but feel free to try around.

last updated on:
November 22nd, 2012, 3:29 GMT
price:
FREE!
developed by:
Mathijs de Bruin
license type:
AGPL (Affero General Public License) 
category:
ROOT \ Internet \ Django Plugins

FREE!

In a hurry? Add it to your Download Basket!

user rating

UNRATED
0.0/5
 

0/5

1 Screenshot
django-newsletter

Add your review!

SUBMIT