Metadata-Version: 1.0
Name: django-templated-email
Version: 0.2.1
Summary: A Django oriented templated / transaction email abstraction
Home-page: http://github.com/bradwhittington/django-templated-email/
Author: Bradley Whittington
Author-email: radbrad182@gmail.com
License: MIT
Description: ==========
        Django-Templated-Email
        ==========
        :Info: A Django oriented templated email sending class
        :Author: Bradley Whittington (http://github.com/bradwhittington, http://twitter.com/darb)
        
        Overview
        =================
        django-templated-email is oriented towards sending templated emails 
        intended for use with transactional mailers (ala mailchimp, silverpop, 
        etc.), but currently comes out of the box with a backend class which 
        uses django's templating system, and django's core.mail functions.
        
        The send_templated_email method can be thought of as the render_to_response
        shortcut for email.
        
        Getting going - installation
        =============
        
        Installing::
        
            pip install templated_email
        
        You can add the following to your settings.py (but it works out the box)::
        
            TEMPLATED_EMAIL_BACKEND = 'templated_email.backends.vanilla_django.TemplateBackend'
        
            # For the django back-end specifically
            TEMPLATED_EMAIL_DJANGO_SUBJECTS = {
                'welcome':'Welcome to my website',
            }
        
        Getting going - sending your template emails
        =============
        
        Example usage using vanilla_django TemplateBackend backend
        
        Python to send mail::
        
            from templated_email import send_templated_email
            send_templated_email(
                    template_name='welcome',
                    from_email='from@example.com',
                    recipient_list=['to@example.com'],
                    context={
                        'username':request.user.username,
                        'full_name':request.user.get_full_name(),
                        'signup_date':request.user.date_joined
                    },
                    headers={'My-Custom-Header':'Custom Value'}
            )
        
        Which looks in django template directories/loaders for  
        *templated_email/welcome.txt* ::
        
            Hey {{full_name}},
        
            You just signed up for my website, using:
                username: {{username}}
                join date: {{signup_date}}
        
            Thanks, you rock!
        
        It will also use *templated_email/welcome.html* for the html part 
        of the email allowing you to make it so much pretty. It is plausible
        that one day there will be support for attachments and inline mime / images
        
        Using PostageApp:
        =============
        
        To use the PostageApp (http://postageapp.com) send method, you will need to install python-postageapp::
        
            pip install -e git://github.com/bradwhittington/python-postageapp.git#egg=postageapp
        
        And add the following to your settings.py::
        
            TEMPLATED_EMAIL_BACKEND = 'templated_email.backends.postageapp_backend.TemplateBackend'
        
            POSTAGEAPP_API_KEY = 'yourapikey'
        
            #If you are already using django-postageapp:
        
            EMAIL_POSTAGEAPP_API_KEY = POSTAGEAPP_API_KEY
        
        Using MAILCHIMP STS:
        =============
        
        To use the MailChimp STS send method, you will need to install mailsnake (please note, until the main mailsnake has STS support, you need to use my fork)::
        
            pip install -e git://github.com/bradwhittington/mailsnake.git#egg=mailsnake
        
        And add the following to your settings.py::
        
            TEMPLATED_EMAIL_BACKEND = 'templated_email.backends.mailchimp_sts.TemplateBackend'
        
            MAILCHIMP_API_KEY = 'yourapikey'
        
            # For the django back-end specifically
            TEMPLATED_EMAIL_MAILCHIMP = {
                'welcome':{
                  'subject':'Welcome to my website',
                  'track_opens':True,
                  'track_clicks':False,
                  'tags':['my','little','pony'],
                }
            }
        
        
        .. _Django: http://djangoproject.com
        
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Framework :: Django
