django-maja-newsletter 0.6.0

功能

与其长篇大论，以下列出主要功能列表

• 与其他Django模型耦合的能力。

• 可以在新闻通讯模板中使用变量。

• 邮件列表管理（合并、导入等）。

• 在VCard 3.0中导入/导出联系人。

• 可配置的SMTP服务器，具有流量限制管理。

• 工作组。

• 可以发送新闻通讯预览。

• 订阅和取消订阅邮件列表。

• 新闻通讯中的附件。

• 为用户生成唯一的URL。

• 跟踪统计。

架构

在应用程序架构层面，我们可以看到两个需要解释的原创性。

$ python manage.py send_newsletter

安装

$ python setup.py install

$ pip install -e git://github.com/nephila/django-maja-newsletter.git#egg=maja_newsletter

$ easy_install django-maja-newsletter

INSTALLED_APPS = (
  # Your favorites apps
  'django.contrib.contenttypes',
  'django.contrib.sites',
  'django.contrib.admin',
  'django.contrib.sessions',
  'tagging',
  'maja_newsletter',)

url(r'^newsletters/', include('maja_newsletter.urls')),

url(r'^newsletters/', include('maja_newsletter.urls.newsletter')),
url(r'^mailing/', include('maja_newsletter.urls.mailing_list')),
url(r'^tracking/', include('maja_newsletter.urls.tracking')),
url(r'^statistics/', include('maja_newsletter.urls.statistics')),

NEWSLETTER_DEFAULT_HEADER_SENDER = 'My NewsLetter <newsletter@myhost.com>'

DBMS考虑事项

不推荐在生产中使用SQLite。因为SQLite对SQL查询中的变量有限制，为999个，您不能在Django的admin模块中创建超过此限制的邮件列表。建议使用MySQL或PgSQL。

如何使用TinyMCE编辑新闻通讯

对于最终用户来说，拥有一个WYSIWYG编辑器来创建新闻通讯可能很有用。WYSIWYG编辑器的选择是自由的，描述的方法可以应用于任何东西，但我们将重点关注TinyMCE，因为它具有许多功能和加载模板的有用插件。

首先，将django-tinymce应用程序安装到您的项目中。

完成以上步骤后，您可以享受乐趣了！

如何将您的配置文件应用程序与maja_newsletter关联

如果您想快速将联系人导入到邮件列表中，例如，您可以为您模型编写一个admin操作。

我们假设我们在名为<强>Profile的模型中有字段email、first_name和last_name。

在其AdminModel定义中添加此方法并将其注册到actions属性中。

class ProfileAdmin(admin.ModelAdmin):

    def make_mailing_list(self, request, queryset):
        from maja_newsletter.models import Contact
        from maja_newsletter.models import MailingList

        subscribers = []
        for profile in queryset:
            contact, created = Contact.objects.get_or_create(email=profile.mail,
                                                             defaults={'first_name': profile.first_name,
                                                                       'last_name': profile.last_name,
                                                                       'content_object': profile})
            subscribers.append(contact)
        new_mailing = MailingList(name='New mailing list',
                                  description='New mailing list created from admin/profile')
        new_mailing.save()
        new_mailing.subscribers.add(*subscribers)
        new_mailing.save()
        self.message_user(request, '%s succesfully created.' % new_mailing)
    make_mailing_list.short_description = 'Create a mailing list'

    actions = ['make_mailing_list']

此操作将创建或检索所有需要的<强>联系人实例，用于创建邮件列表。

完成以上操作后，您可以向此邮件列表发送新闻通讯。

开发

提供了一个Buildout脚本，以便任何希望贡献的人正确初始化项目。

首先，请使用VirtualEnv来保护您的系统。

按照以下步骤开始开发

$ git clone git://github.com/nephila/django-maja-newsletter.git
$ virtualenv --no-site-packages maja_newsletter
$ cd maja_newsletter
$ source ./bin/activate
$ python bootstrap.py
$ ./bin/buildout

buildout脚本将解决开发应用程序所需的所有依赖项。

完成上述操作后，您就可以开始在这个项目上进行了。

运行此命令以启动测试。

$ ./bin/test

或者您也可以启动演示。

$ ./bin/demo syncdb
$ ./bin/demo runserver

很简单，不是吗？

数据库表示

变更日志