armstrong.core.arm_access 1.0.9

限制内容

内容对象可以通过继承自 armstrong.core.arm_access.mixins.AccessMixin 类来限制访问权限到特定级别。这将允许关联 armstrong.core.arm_access.models.Assignment，该关联指定了在特定时间段内授予对该对象的访问权限的级别。

对于基本的付费墙场景，其中一些故事始终为高级别，而其他故事始终为公开级别，创建两个 armstrong.core.arm_access.models.Level。一个将是您的付费级别，其中 is_protected 设置为 True，而另一个将是您的公开级别，其中 is_protected 设置为 False。发布文章时，将其中一个级别分配给内容。

对于一段时间后变为公开的内容，与前述方法创建两个级别。将新内容分配给付费级别，并设置立即的 start_date，同时也要将其分配给公开级别，并设置一个 start_date，以您希望内容免费可用的日期。

要仅允许付费订阅者访问存档，您需要将内容添加到公开级别，并设置立即的 start_date 和您希望停止提供免费访问的日期的 end_date。然后您需要将内容添加到付费级别，并设置立即的 start_date 和无 end_date（默认为 datetime.datetime.max）。

用户会员资格

用户通过 armstrong.core.arm_access.models.AccessMembership 被授予访问级别。每个会员资格都有一个 start_date 和 end_date，它定义了会员资格有效的时段。每个会员资格还有一个 active 布尔字段，可以将其设置为 False 以使会员资格失效。可以使用 user.access_memberships.current() 查询用户的活跃会员资格。

付费墙

阻止用户访问特定内容的实际过程由 armstrong.core.arm_access.paywalls 包中的付费墙处理。目前提供的唯一付费墙是 armstrong.core.arm_access.paywalls.subscription.SubscriptionPaywall，该付费墙检查当前会员资格。SubscriptionPaywall 仅在返回 TemplateResponse 的视图中工作。

要在演示应用程序中使用 SubscriptionPaywall，您将使用以下代码

...

paywall = SubscriptionPaywall()
protected_detail = paywall.protect(object_detail)

...

url(r'^article/(?P<slug>[-\w]+)/', protected_detail, {
                    'queryset':Article.published.all().select_subclasses(),
                    'template_name':'article.html',
                    'slug_field':'slug',
                },
        name='article_detail'),

任何用户访问受保护的文章，但没有相应的访问级别会员资格时，都会引发 AccessDenied。SubscriptionPaywall 还接受一个额外的参数 permission_denied，它确定在失败时采取什么行动。该参数必须是一个接受一个参数（一个 TemplateResponse）并返回表示在访问拒绝时采取的行动的 Response 对象的可调用对象。例如

# to redirect to a new url entirely
from armstrong.core.arm_access.paywalls import redirect_on_deny
redirecting_paywall = SubscriptionPaywall(
        permission_denied=redirect_on_deny='/membership/signup')

# to render the request's context with a new template (to provide teaser
# content)
from armstrong.core.arm_access.paywalls import render_on_deny
rendering_paywall = SubscriptionPaywall(
        permission_denied=render_on_deny='/membership/upsell.html')

如果您只想为没有高级访问级别的用户渲染广告，则可以使用默认不渲染广告的模板和 render_on_deny 来使用 SubscriptionPaywall。

如果您只想允许匿名用户查看一定数量的完整文章，然后显示付费墙，则需要构建自定义的付费墙实现，但 SubscriptionPaywall 应该提供不错的模板。如果您实现它，它将是这个包中一个非常好的候选。