用于管理css背景样式的django cms插件
cmsplugin-css-background的Python项目详细描述
django CMS通过css在编辑模式下配置背景图像的插件 规则。
要求
- Django 1.8+
- django CMS 3.3+
安装
在python环境中运行
$ pip install cmsplugin-css-background
这将安装插件包的最新稳定版本。 安装包的最新存储库快照运行
$ pip install -e git+https://github.com/alexmalykh/cmsplugin-css-background.git@master#egg=cmsplugin-css-background
然后将插件添加到INSTALLED_APPS列表:
INSTALLED_APPS=[...,'cmsplugin_css_background',]
最后,滚动数据库迁移:
$ python manage.py migrate cmsplugin_css_background
用法
以这种方式在模板中定义占位符:
{%withcss_selector='#some-element'%}{%placeholder'some_element_background'%}{%endwith%}
占位符可能几乎位于任何位置,不一定 在要更改背景的元素内/旁边但它是 为方便起见,建议两者放在一起。
也可以为占位符添加一个条目 限制允许的插件类型的PLACEHOLDER_CONF设置字典 到CSS Background,并为占位符的 dragbar而不是生成some_element_background。
将CSS Background的实例从Generic插件组添加到 CMS管理中的占位符。
注意
这个包知道cmsplugin-filer如果后者是 安装并启用后,您还可以获得额外的CSS Backgroundplugin 可在Filerplugins组中使用。此选项允许您使用图像 由文件管理器管理。
插件被呈现为<style />html元素,如下所示:
<styletype="text/css">#some-element{/* here 'background-' CSS rules go */...}</style>
有一个模板,位于cms/plugins/css-background.html和 它需要一个额外的上下文变量css_selector,该变量定义 用于指定背景设置的元素。
默认情况下,背景属性呈现为单独规则的列表, 但也有一个线性选项。更改插件呈现的方式 覆盖插件模板并替换
{{instance.as_separate_rules}}
使用
{{instance.as_single_rule}}