{"id":18831368,"url":"https://github.com/django-cms/djangocms-frontend","last_synced_at":"2025-12-29T14:25:37.148Z","repository":{"id":37752972,"uuid":"439296697","full_name":"django-cms/djangocms-frontend","owner":"django-cms","description":"django CMS frontend is a plugin bundle for django CMS providing several components for the frontend, currently implemented with the popular Bootstrap 5 framework.","archived":false,"fork":false,"pushed_at":"2025-04-01T14:13:28.000Z","size":11131,"stargazers_count":60,"open_issues_count":8,"forks_count":23,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-04T01:17:35.856Z","etag":null,"topics":["bootstrap5","django","django-cms"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/django-cms.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-17T10:36:26.000Z","updated_at":"2025-03-31T05:28:44.000Z","dependencies_parsed_at":"2023-02-15T23:46:14.342Z","dependency_job_id":"54e04b2c-deab-4018-a85c-d3fa7a177371","html_url":"https://github.com/django-cms/djangocms-frontend","commit_stats":{"total_commits":1084,"total_committers":47,"mean_commits":23.06382978723404,"dds":0.6217712177121771,"last_synced_commit":"1d6a6295b95a39d265c2c7082099820deadcfd58"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fdjangocms-frontend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fdjangocms-frontend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fdjangocms-frontend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fdjangocms-frontend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/django-cms","download_url":"https://codeload.github.com/django-cms/djangocms-frontend/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248637048,"owners_count":21137529,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap5","django","django-cms"],"created_at":"2024-11-08T01:53:34.125Z","updated_at":"2025-12-29T14:25:37.086Z","avatar_url":"https://github.com/django-cms.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"#####################\n django CMS Frontend\n#####################\n\n|pypi| |docs| |coverage| |python| |django| |djangocms| |djangocms4|\n\ndjango CMS Frontend is a versatile plugin suite for django CMS that facilitates\nthe easy creation of reusable frontend components. It supports any CSS framework,\nallowing developers to seamlessly integrate their preferred styling libraries.\nFor immediate use, it includes a comprehensive set of Bootstrap 5 components\nand templates.\n\n\n.. image:: preview.png\n\nKey features\n============\n\n* **Effortless Development of Custom Components**: Create reusable frontend\n  components with ease, utilizing simple templates and declarative form\n  classes. These components can function both as CMS plugins and within\n  standard Django templates. ​\n\n* **Framework-Agnostic Design**: Maintain flexibility in your project's design\n  by decoupling plugins from specific versions of a CSS framework. This ensures\n  that updating frameworks in the future doesn't necessitate rebuilding your\n  site's plugin structure. ​\n\n* **Built-in Bootstrap 5 Components**: Access a ready-to-use collection\n  of Bootstrap 5 components, streamlining the process of building responsive\n  and modern interfaces. ​\n\n* **Extensibility**: Enhance your project by creating custom components with\n  minimal code. The system is designed to be extended both within individual\n  projects and through separate theme applications. ​\n\n* **Consistent User Experience**: Utilize plugins as UI components throughout\n  your project, promoting a cohesive and uniform user interface. ​\n\n\nDescription\n===========\n\nDesigned to be framework-agnostic, django CMS Frontend allows developers to\nselect and change CSS frameworks by adjusting project settings, eliminating\nthe need to reconstruct the CMS plugin tree when upgrading or switching\nframeworks. It leverages `django-entangled\n\u003chttps://github.com/jrief/django-entangled\u003e`_ to store design parameters in\na common JSON field, preventing database bloat and facilitating seamless\nupdates to frontend features.\n\nBy providing a suite of Bootstrap 5-based components for layout structuring,\nincluding grids, components, and forms, django CMS Frontend simplifies the\nprocess of building responsive and structured page designs. Developers can\nalso create custom components with minimal code, ensuring a consistent and\nefficient development experience.\n\nIt is up to you which (if any at all) pre-built components you want to include\nin your project. Each set of components is a separate package you can include\nin your project's ``INSTALLED_APPS``.\n\n\nContributing\n============\n\nBecause this is a an open-source project, we welcome everyone to\n`get involved in the project \u003chttps://www.django-cms.org/en/contribute/\u003e`_ and\n`receive a reward \u003chttps://www.django-cms.org/en/bounty-program/\u003e`_ for their contribution.\nBecome part of a fantastic community and help us make django CMS the best CMS in the world.\n\nWe'll be delighted to receive your\nfeedback in the form of issues and pull requests. Before submitting your\npull request, please review our `contribution guidelines\n\u003chttp://docs.django-cms.org/en/latest/contributing/index.html\u003e`_.\n\nThe project makes use of git pre-commit hooks to maintain code quality.\nPlease follow the installation steps to get `pre-commit \u003chttps://pre-commit.com/#installation\u003e`_\nsetup in your development environment.\n\nWe're grateful to all contributors who have helped create and maintain\nthis package. Contributors are listed at the `contributors\n\u003chttps://github.com/django-cms/djangocms-frontend/graphs/contributors\u003e`_\nsection.\n\nOne of the easiest contributions you can make is helping to translate this addon on\n`Transifex \u003chttps://www.transifex.com/divio/djangocms-frontend/dashboard/\u003e`_.\n\nRequirements\n============\n\nSee ``REQUIREMENTS`` in the `setup.py\n\u003chttps://github.com/django-cms/djangocms-frontend/blob/master/setup.py\u003e`_\nfile for additional dependencies:\n\n-  django-cms, version 3.11 or later\n-  django-filer, version 1.7 or later\n-  djangocms-attributes-field, version 1.0 or later\n-  djangocms-text\n-  djangocms-link\n-  django-entangled 0.6 or later\n\nMake sure `django Filer\n\u003chttp://django-filer.readthedocs.io/en/latest/installation.html\u003e`_ and\n`django CMS Text CKEditor\n\u003chttps://github.com/divio/djangocms-text-ckeditor\u003e`_ are installed and\nconfigured appropriately.\n\n**As of djangocms-frontend 2.0, djangocms-link is needed to use the Link/Button plugin.**\n\nInstallation\n============\n\nFor a manual install:\n\n-  run ``pip install djangocms-frontend``\n\n-  add the following entries to your ``INSTALLED_APPS`` (or only those you need):\n\n   .. code::\n\n      'easy_thumbnails',\n      'djangocms_link',  # Needed for link support\n\n      # Base package template components and custom components\n      'djangocms_frontend',\n\n      # Add built-in Bootstrap 5 components as needed\n      'djangocms_frontend.contrib.accordion',  # optional\n      'djangocms_frontend.contrib.alert',  # optional\n      'djangocms_frontend.contrib.badge',  # optional\n      'djangocms_frontend.contrib.card',  # optional\n      'djangocms_frontend.contrib.carousel',  # optional\n      'djangocms_frontend.contrib.collapse',  # optional\n      'djangocms_frontend.contrib.content',  # optional\n      'djangocms_frontend.contrib.grid',  # optional\n      'djangocms_frontend.contrib.icon',  # optional\n      'djangocms_frontend.contrib.image',  # optional\n      'djangocms_frontend.contrib.jumbotron',  # optional\n      'djangocms_frontend.contrib.link',  # optional\n      'djangocms_frontend.contrib.listgroup',  # optional\n      'djangocms_frontend.contrib.media',  # optional\n      'djangocms_frontend.contrib.tabs',  # optional\n      'djangocms_frontend.contrib.utilities',  # optional\n\n-  run ``python manage.py migrate``\n\n**djangocms-frontend** has a weak dependencies on **djangocms-icon** you can\ninstall separately or by adding an option:\n\n.. code::\n\n    pip install djangocms-frontend[djangocms-icon]  # Installs djangocms-icon for icon support in links\n\n\nDocumentation\n=============\n\nSee readthedocs for the `documentation \u003chttps://djangocms-frontend.readthedocs.io\u003e`_.\n\nLicense\n=======\n\nSee `LICENSE \u003chttps://github.com/django-cms/djangocms-frontend/blob/master/LICENSE\u003e`_.\n\n.. |pypi| image:: https://badge.fury.io/py/djangocms-frontend.svg\n   :target: http://badge.fury.io/py/djangocms-frontend\n\n.. |docs| image:: https://readthedocs.org/projects/djangocms-frontend/badge/?version=latest\n    :target: https://djangocms-frontend.readthedocs.io/en/latest/?badge=latest\n    :alt: Documentation Status\n\n.. |coverage| image:: https://codecov.io/gh/fsbraun/djangocms-frontend/branch/master/graph/badge.svg\n   :target: https://codecov.io/gh/django-cms/djangocms-frontend\n\n.. |python| image:: https://img.shields.io/badge/python-3.7+-blue.svg\n   :target: https://pypi.org/project/djangocms-frontend/\n\n.. |django| image:: https://img.shields.io/badge/django-3.2+-blue.svg\n   :target: https://www.djangoproject.com/\n\n.. |djangocms| image:: https://img.shields.io/badge/django%20CMS-3.8%2B-blue.svg\n   :target: https://www.django-cms.org/\n\n.. |djangocms4| image:: https://img.shields.io/badge/django%20CMS-4%2B-blue.svg\n   :target: https://www.django-cms.org/en/preview-django-cms-40/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjango-cms%2Fdjangocms-frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjango-cms%2Fdjangocms-frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjango-cms%2Fdjangocms-frontend/lists"}