This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

django based newsletter toolkit

Project Description

Penyblack is a newsletter module based on the feincms.org CMS building toolkit. E-mails can either be sent as mass mails (e.g. monthly newsletter) or as part of a customised workflow (e.g. user clicks on a link and in response to that your application sends out an e-mail). Conditional data and variables can be filled in to a newsletter using the django template language. SPF (sender validation) and bounce management can be activated if desired. Key data like bounce rate, opening rate and link clicks is tracked and presented in the admin menu. Sending bulk e-mails is easy on memory. 20’000 and more addresses wont crash your server. From the outset we developed Pennyblack to easily integrate into existing web projects.

Installation

Notice: This is a first draft of an installation guide. It’s not finished and complete.

  1. Make sure you have a working django project setup.

  2. Install Pennyblack over pip:

    pip install pennyblack
    
  3. Make sure that the FeinCMS and Pennyblack Apps are added to your installed apps in your settings.py:

    'feincms',
    'feincms.module.medialibrary',
    'pennyblack',
    'pennyblack.module.subscriber',
    
  4. Add a newsletter url to your urls.py:

    url(r'^newsletter/', include('pennyblack.urls'), name = 'pennyblack'),
    
  5. Install dependencies (over pip):

    • pydns==2.3.4
    • pyspf==2.0.5
  6. Import Pennyblack and add a newsletter template to your models.py:

    from pennyblack.models.newsletter import Newsletter
    from pennyblack.content.richtext import TextOnlyNewsletterContent, \
       TextWithImageNewsletterContent
    
    Newsletter.register_templates({
      'key': 'example',
      'title': 'Example Newsletter',
      'path': 'example_newsletter.html',
      'regions': (
          ('main', 'Main Region'),
          ),
      })
    
    Newsletter.create_content_type(TextOnlyNewsletterContent)
    Newsletter.create_content_type(TextWithImageNewsletterContent)
    
  7. Add Pennyblack Models to south migration modules in your settings.py:

    SOUTH_MIGRATION_MODULES = {
        'pennyblack': 'project_name.migrations_pennyblack',
        'subscriber': 'project_name.migrations_subscriber',
    }
    
  8. Run schemamigrations and migrate:

    ./manage.py schemamigration --initial pennyblack
    ./manage.py schemamigration --initial subscriber
    ./manage.py migrate
    

Dependencies

  • Python
    • django
    • feincms
    • pyspf
    • pydns
    • pil
  • Project Settings
    • TEMPLATE_CONTEXT_PROCESSORS
      • django.core.context_processors.request
    • FEINCMS_ADMIN_MEDIA
    • feincms medialibrary musst be installed
Release History

Release History

This version
History Node

0.3.5

History Node

0.3.4

History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

History Node

0.3.0

History Node

0.2.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pennyblack-0.3.5.tar.gz (82.7 kB) Copy SHA256 Checksum SHA256 Source Jun 27, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting