emencia.django.newsletter 0.2

功能

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

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

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

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

• VCard 3.0格式的联系信息导入/导出。

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

• 工作组。

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

• 订阅和退订邮件列表。

• 新闻通讯中的附件。

• 为每个用户提供唯一的URL。

• 跟踪统计。

架构

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

$ python manage.py send_newsletter

安装

您可以从http://github.com/Fantomas42/emencia-django-newsletter获取最新资源，并运行安装脚本

$ python setup.py install

或使用pip

$ pip install -e git://github.com/Fantomas42/emencia-django-newsletter.git#egg=emencia.django.newsletter

对于最新稳定版本，请使用easy_install

$ easy_install emencia.django.newsletter

INSTALLED_APPS = (
  # Your favorites apps
  'django.contrib.contenttypes',
  'django.contrib.admin',
  'tagging',
  'emencia.django.newsletter',)

TEMPLATE_CONTEXT_PROCESSORS = (
  'django.core.context_processors.auth',
  'django.core.context_processors.i18n',
  'django.core.context_processors.request',
  'django.core.context_processors.media',
  'emencia.django.newsletter.context_processors.media',)

url(r'^newsletters/', include('emencia.django.newsletter.urls')),

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

数据库管理系统考虑事项

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

如何使用TinyMCE编辑新闻通讯

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

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

现在，您将在项目的根目录中编写一个名为admin.py的模块。此模块将覆盖emencia.django.newsletter提供的NewsletterAdmin类，并使用TinyMCE编辑器，并将覆盖的类注册到admin站点中。

from django import forms
from django.contrib import admin

from tinymce.widgets import TinyMCE
from emencia.django.newsletter.models import Newsletter
from emencia.django.newsletter.admin import NewsletterAdmin


class NewsletterTinyMCEForm(forms.ModelForm):
    content = forms.CharField(widget=TinyMCE(attrs={'cols': 150, 'rows': 80}))

    class Meta:
        model = Newsletter

class NewsletterTinyMCEAdmin(NewsletterAdmin):
    form = NewsletterTinyMCEForm

admin.site.unregister(Newsletter)
admin.site.register(Newsletter, NewsletterTinyMCEAdmin)

最后一步是调用您的模块以加载代码。一个好的解决方案是在项目的urls.py文件中导入admin.py模块。

import yourproject.admin

享受吧！

如何将您的配置文件应用程序与emencia.django.newsletter关联

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

我们假设我们有一个名为Profile的模型中的字段email、first_name和last_name。

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

class ProfileAdmin(admin.ModelAdmin):

    def make_mailing_list(self, request, queryset):
        from emencia.django.newsletter.models import Contact
        from emencia.django.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',]

此操作将创建或检索所有为创建邮件列表所需的Contact实例。

在此之后，您可以向此邮件列表发送新闻通讯。

开发

提供了一个Buildout脚本，以正确初始化任何想要贡献的项目。

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

按照以下步骤开始开发

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

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

完成这些操作后，您就可以开始开发项目了。

运行此命令以启动测试。

$ ./bin/test

很简单，不是吗？

数据库表示

变更日志

0.1dev（未发布）

• 初始发布