async-notifications 0.1.28

Features

• Celery integration

• Administrative view

• Enqueued mail system and instantly send

• Problems notification

• User filter email

• Template system with template context

• Send to User, Group or external email

• Django cms integration (djcms_async_notifications) and standalone.

• Custom text area widget support

• Allow send group mail list if it’s defined.

• Newsletter with model context, preview and extra email configuration

Adding context dummy object

When you need to pass a default template message base on template, but you have not the template object and also you need to write the object with django template sintaxis you can use DummyContextObject that return always something like {{ myobj.attr1.objattr }}

from async_notifications.register import update_template_context, DummyContextObject
context = [
    ('myobj', 'Field description'),
    ...
]
message = render_to_string('some/template.html',
                       context={
                           'myobj': DummyContextObject('myobj')
                       }
                       )
update_template_context("yourcode",  'your email subject', context, message=message )

Newsletter email extra configuration

As recomendation install django-markitup and markdown to generate preview templates using django template system and configure ASYNC_NEWSLETTER_WIDGET to overwrite default text area editor in template newsletter.

If you want to incorporate custom email sender you can configure with ASYNC_NEWSLETTER_SEVER_CONFIGS

ASYNC_NEWSLETTER_SEVER_CONFIGS={
    'host': 'localhost',
    'port': '1025',
    'fail_silently': False,
    'backend': None,
    'from': 'From user <user@example.com>'
    'username':'my_username',
    'password':'my_password',
    'use_tls': True
}

Newsletter setup

In your app edit at the end of admin.py to register your model

register_model('app.model_label', model class, prefix='prefix used to include in template')
register_news_basemodel('app.model_label', Title, class manager)

To create a new manager you need to create a class like

from async_notifications.interfaces import NewsLetterInterface
class MembershipManager(NewsLetterInterface):
    name = name used to include in template
    model = Model
    form = Filter form class

Take a look to NewsLetterInterface to know what methods you need to overwrite

Django cms integration

This configuration could help you to integrate with Django CMS.

include in your INSTALLED_APPS:

INSTALLED_APPS = [
    ...
  'async_notifications',
  'async_notifications.djcms_async_notifications',
]

Configure how models and field async_notifications will use, ej. aldryn_people

ASYNC_NOTIFICATION_GROUP = 'aldryn_people.Group'
ASYNC_NOTIFICATION_GROUP_LOOKUP_FIELDS = {
    'order_by': 'translations__name',
    'email': 'email',
    'group_lookup': 'translations__name',
    'display': 'name',
    'filter': ['translations__name__icontains']}


ASYNC_NOTIFICATION_USER = 'aldryn_people.Person'

ASYNC_NOTIFICATION_USER_LOOKUP_FIELDS = {
    'order_by': 'translations__name',
    'display': 'name',
    'filter': [
        'user__first_name__icontains',
        'user__last_name__icontains',
        'translations__name__icontains'],
    'group_lookup': 'groups__translations__name'}

cmsplugin-contact-plus

CONTACT_PLUS_SEND_METHOD = ‘async_notifications.djcms_async_notifications.contact_plus.send_email’ ASYNC_NOTIFICATION_CONTACT_PLUS_EMAIL = ‘email’

Default text area widget

For example using ckeditor widget

ASYNC_NOTIFICATION_TEXT_AREA_WIDGET = ‘ckeditor.widgets.CKEditorWidget’

Extra settings configuration

• ASYNC_NOTIFICATION_MAX_PER_MAIL default 40 mails per email

• ASYNC_BCC include always email in BCC comma separed email (without spaces)

• ASYNC_SEND_ONLY_EMAIL for testing send all email to this address

• ASYNC_SMTP_DEBUG configure smtp debug for logs

• ASYNC_TEMPLATES_NOTIFICATION path for save templates created in emails