Adds abstract User Interface items as plugins.
Project description
django CMS Frontend is a blugin bundle based on djangocms_bootstrap5. Its objective is to provide a set of popular frontend components independent of the currently used frontend framework such as Bootstrap, or its specific version.
Key features
Support of Bootstrap 5.
Separation of plugins from css framework, i.e., no need to rebuild you site’s plugin tree if css framework is changed in the future, e.g., from Bootstrap 5 to a future version.
New link plugin allowing to link to internal pages provided by other applications, such as djangocms-blog.
Nice and well-arranged admin frontend of djangocms-bootstrap4
Management command to migrate from djangocms-bootstrap4. This command automatically migrates all djangocms-bootstrap4 plugins to djangocms-frontend.
Extensible within the project and with separate project (e.g., a theme app)
Accordion plugin and simple forms plugin w/ Bootstrap-styled forms on your cms page.
Description
The plugins are framework agnostic and the framework can be changed by adapting your project’s settings. Also, it is designed to avoid having to rebuild your CMS plugin tree when upgrading e.g. from one version of your frontend framework to the next.
django CMS Frontend uses django-entangled by Jacob Rief to avoid bloating your project’s database with css framework-dependent tables. Instead all design parameters are stored in a common JSON field and future releases of improved frontend features will not require to rebuild your full plugin tree.
The link plugin has been rewritten to not only allow internal links to other CMS pages, but also to other django models such as, e.g., posts of djangocms-blog.
Feedback
This project is in a early stage. All feedback is welcome! Please mail me at fsbraun(at)gmx.de
Also, all contributions are welcome.
We’re grateful to all contributors who have helped create and maintain this package. Contributors are listed at the contributors section.
Requirements
See REQUIREMENTS in the setup.py file for additional dependencies:
django-cms, version 3.7 or later
django-filer, version 1.7 or later
djangocms-attributes-field, version 1.0 or later
djangocms-text-ckeditor, version 3.1 or later
djangocms-icon, version 1.4 or later
django-select2
django-entangled
Make sure django Filer and django CMS Text CKEditor are installed and configured appropriately.
Installation
For a manual install:
run pip install https://github.com/fsbraun/djangocms-frontend/archive/master.zip
add the following entries to your INSTALLED_APPS:
'djangocms_icon', '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.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',run python manage.py migrate
If you use Django < 3.2 please also add django-jsonfield-backport to your requirements.txt and django_jsonfield_backport to your INSTALLED_APPS list.
Documentation
See readthedocs for the documentation.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file djangocms-frontend-0.9.0.tar.gz.
File metadata
- Download URL: djangocms-frontend-0.9.0.tar.gz
- Upload date:
- Size: 206.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.10.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b5ec97ddd31aff20896db4417ad51933a2a306989c44c47dbcb742eda51b818e |
|
| MD5 | 2d9450ba4f3bd5a0f5e4f5930f606962 |
|
| BLAKE2b-256 | 9e280bfca0494f58f2c34f5845cae5d486939bef961f229e82f1a37cd03caf30 |
File details
Details for the file djangocms_frontend-0.9.0-py3-none-any.whl.
File metadata
- Download URL: djangocms_frontend-0.9.0-py3-none-any.whl
- Upload date:
- Size: 296.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.10.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | ad4bf4594904fcaf39fb25e9aabc5c1af1dd62ae1ee05d47d3cfda9c5c29d54b |
|
| MD5 | 8c278a659d96e7a14c435443c5aef337 |
|
| BLAKE2b-256 | 45ff5cd4d6aaf091ebd41a87ecccbc7a3a339bed4a22246cdddb4ac62b4a78d7 |
