jmbo-banner 1.0

安装

1. 安装或添加 jmbo-banner 到您的Python路径。

2. 将横幅添加到您的INSTALLED_APPS设置中。

3. 运行manage.py migrate banner。

使用

jmbo-banner允许用户在管理员中创建和编辑横幅。每个横幅可以选择性地包含落款、描述块、图片和CTA按钮。这些组件在每个横幅中的布局方式由横幅样式定义。

内容类型

jmbo-banner定义以下内容类型

按钮

• 横幅可以由多个按钮组成，尽管通常只有两个按钮被使用。

• 按钮有一个文本字段，可以用来指定其标签，以及一个链接对象，可以用来指定其点击链接。

横幅

• 可以将横幅视为促销内容的容器。它可以由按钮、图片和促销文本组成。每个横幅还有一个样式，它控制其内容如何渲染。

横幅样式

jmbo-banner允许您控制每个横幅的渲染方式。横幅可以渲染的不同方式可以在预定义的样式列表中找到。一个样式通过模板部分控制不同的组件（按钮、图片、描述）如何渲染。

添加您自己的横幅样式

有时需要更多样式来渲染横幅。这可以通过向自己的应用添加一个包，即banner_config，并在一个styles.py文件中创建自定义样式来实现。一个示例结构如下

<your app>/
    ...
    banner_config/
        __init__.py
        styles.py

所有自定义样式应该继承自BaseStyle。对于大多数情况，覆盖template_name就足够了。重要的是要记住，一个样式的模板旨在用作只包含横幅内容的部分。

from banner.styles import BaseStyle


class CustomStyle(BaseStyle):
    """
    Custom banner style
    """
    template_name = "banner/custom_banner.html"

然后，CustomStyle应该在样式的列表中选择可用。

在页面上渲染横幅

横幅通常作为页面的一部分进行渲染。这可以通过使用以下所示的render_banner模板标签来实现。模板标签接受横幅对象或其缩略名。

{% extends "base.html" %}
{% load banner_tags %}

{% block content %}
    {% render_banner <object_or_slug> %}
{% endblock %}

1.0

1. Django 1.11 兼容性。

2. 重新创建了具有标题、正文和按钮组件的Banner模型。

3. 移除了对django-dfp的依赖。

0.6

1. Django 1.6 兼容性。

0.5

1. 移除了对jmbo-foundry的依赖。

2. 添加测试。

0.4

1. 将get_absolute_url方法重命名为get_target_url，因为它破坏了Jmbo约定。如果您已自定义imagebanner_*.html，则需要更新它们。

0.3

1. 移除冗余测试。

2. 使用较新版本的django-dfp。如果您已自定义dfpbanner_detail.html或dfpbanner_list_item.html，则需要更新它们。

0.2.6

1. 如果没有实际的横幅，并且横幅代理没有设置图片，则不渲染任何内容。

2. 缓存模板。

0.2.5

1. 匹配正则表达式的多个横幅现在将被随机化以实现横幅轮播。

0.2.4.4

热修复。在任意空白处拆分路径。

0.2.4.3

1. 热修复。跳过空路径以避免异常。

0.2.4.2

1. 热修复。如果已设置，则正确回退到默认横幅。

0.2.4.1

1. 热修复。添加缺失的迁移。

0.2.4

1. 使用搜索代替匹配进行正则表达式。

2. 横幅代理现在有一个可选的默认横幅。

3. 在为横幅代理进行正则表达式匹配时，考虑查询字符串。

0.2.3

1. 添加一个BannerProxy模型，该模型检查URL并渲染为该URL指定的横幅。

0.2.2

1. DFP横幅通过ajax加载时自行绘制。代码在新的banner.js中。

0.2.1

1. 热修复版本。添加缺失的文件。

2. 在管理员界面显示错误消息，通知缺少横幅URL。

0.2

1. Google DFP横幅功能适用于Web和移动端。这方便使用Google的DFP服务进行广告和跟踪。

2. urls.py已创建。请确保将其添加到您的项目URL中。

3. 依赖关系为django-dfp>=0.1.2。

4. 我们现在有South迁移。

0.1.3

1. 为代码横幅创建列表项模板。

0.1.2

1. 使用正确的照片尺寸名称。

0.1.1

1. 使用较旧的jmbo-foundry API来处理图像URL。

0.1

1. 添加对jmbo-foundry>=0.7的依赖。

0.0.6

1. 修复错误的photosizes.json文件。