将抽象用户界面项作为插件添加到django CMS中。
项目描述
django CMS 前端 是一个插件包,它建立在并改进了 djangocms-bootstrap4 的架构之上。它的目标是提供一组独立于当前使用的前端框架(如Bootstrap或其特定版本)的流行前端组件。
主要特性
支持 Bootstrap 5、django CMS 3.8+ 以及即将推出的主要 django CMS 4。
插件与CSS框架分离,即如果将来CSS框架发生变化(例如,从Bootstrap 5到未来版本),则无需重新构建您网站的插件树。
新的链接插件 允许链接到其他应用程序提供的内部页面,例如 djangocms-blog。
美观且组织良好的 djangocms-bootstrap4 管理界面
一个用于从 django-cms-bootstrap4 迁移的管理命令。此命令自动将所有 djangocms-bootstrap4 插件迁移到 djangocms-frontend。
在项目内部以及与单独的项目(例如,主题应用程序)中 可扩展
描述
插件与框架无关,可以通过调整项目的设置来更改框架。此外,它旨在避免在升级(例如,从您的前端框架的一个版本到下一个版本)时需要重新构建您的 CMS 插件树。
django CMS 前端使用 Jacob Rief 的 django-entangled 来避免在您的项目数据库中填充与CSS框架相关的表。相反,所有设计参数都存储在一个公共的JSON字段中,并且改进前端功能的未来版本将不会要求您重新构建您的完整插件树。
链接插件已重写,不仅允许指向其他 CMS 页面的内部链接,而且还允许指向其他 django 模型,例如,例如,djangocms-blog 的帖子。
贡献
由于这是一个开源项目,我们欢迎每个人参与项目,并通过 贡献 来获得奖励。成为这个卓越社区的一部分,帮助我们使 django CMS 成为世界上最好的 CMS。
我们将非常乐意接收您的反馈,形式为问题和拉取请求。在提交您的拉取请求之前,请查看我们的 贡献指南。
该项目使用 git 预提交钩子来维护代码质量。请按照安装步骤在您的开发环境中设置 pre-commit。
我们感谢所有帮助我们创建和维护此包的贡献者。贡献者名单在 贡献者 部分列出。
您可以做出的最简单的贡献之一是帮助翻译此插件在 Transifex 上。
需求
请参阅 需求 文件中的 setup.py 以获取更多依赖项。
django-cms,版本 3.7 或更高
django-filer,版本 1.7 或更高
djangocms-attributes-field,版本 1.0 或更高
djangocms-text-ckeditor,版本 3.1 或更高
django-select2
django-entangled
请确保已正确安装和配置 django Filer 和 django CMS Text CKEditor。
安装
对于手动安装
运行 pip install djangocms-frontend
将以下条目添加到您的 INSTALLED_APPS
'easy_thumbnails', 'djangocms_frontend', 'djangocms_frontend.contrib.accordion', 'djangocms_frontend.contrib.alert', 'djangocms_frontend.contrib.badge', 'djangocms_frontend.contrib.card', 'djangocms_frontend.contrib.carousel', 'djangocms_frontend.contrib.collapse', 'djangocms_frontend.contrib.content', 'djangocms_frontend.contrib.grid', 'djangocms_frontend.contrib.icon', 'djangocms_frontend.contrib.image', 'djangocms_frontend.contrib.jumbotron', 'djangocms_frontend.contrib.link', 'djangocms_frontend.contrib.listgroup', 'djangocms_frontend.contrib.media', 'djangocms_frontend.contrib.tabs', 'djangocms_frontend.contrib.utilities',
运行 python manage.py migrate
djangocms-frontend 对 djangocms-icon 有弱依赖,您可以单独安装或通过添加选项来安装。
pip install djangocms-frontend[djangocms-icon] # Installs djangocms-icon for icon support in links
文档
有关文档,请参阅 readthedocs。
许可证
请参阅 LICENSE。