{"id":13469020,"url":"https://github.com/django-cms/djangocms-admin-style","last_synced_at":"2025-12-12T00:34:10.312Z","repository":{"id":5262200,"uuid":"6440559","full_name":"django-cms/djangocms-admin-style","owner":"django-cms","description":"django CMS Admin Style is a Django Theme tailored to the needs of django CMS.","archived":false,"fork":false,"pushed_at":"2025-04-09T06:41:23.000Z","size":10146,"stargazers_count":428,"open_issues_count":11,"forks_count":117,"subscribers_count":38,"default_branch":"master","last_synced_at":"2025-04-11T08:36:53.509Z","etag":null,"topics":["addon","cms","django","django-admin","django-cms","python","theme"],"latest_commit_sha":null,"homepage":"http://www.django-cms.org/","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"llad/spark-restclient","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":"2012-10-29T12:59:23.000Z","updated_at":"2025-04-09T06:41:27.000Z","dependencies_parsed_at":"2024-01-04T10:39:19.359Z","dependency_job_id":"ce3eaf9c-50e9-4691-a667-6de2fc91b205","html_url":"https://github.com/django-cms/djangocms-admin-style","commit_stats":{"total_commits":1158,"total_committers":52,"mean_commits":22.26923076923077,"dds":"0.36269430051813467","last_synced_commit":"14081d52213bc5fb3aab392ca592a6505619e23d"},"previous_names":["divio/djangocms-admin-style"],"tags_count":45,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fdjangocms-admin-style","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fdjangocms-admin-style/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fdjangocms-admin-style/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fdjangocms-admin-style/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/django-cms","download_url":"https://codeload.github.com/django-cms/djangocms-admin-style/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248550634,"owners_count":21122933,"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":["addon","cms","django","django-admin","django-cms","python","theme"],"created_at":"2024-07-31T15:01:24.629Z","updated_at":"2025-12-12T00:34:10.277Z","avatar_url":"https://github.com/django-cms.png","language":"SCSS","funding_links":[],"categories":["SCSS","Best Django Admin Interface Resources"],"sub_categories":["Older or Deprecated Projects"],"readme":"======================\ndjango CMS Admin Style\n======================\n\n|pypi| |python| |django| |djangocms| |djangocms4| |coverage|\n\nAdds pretty CSS styles for the django CMS admin interface. Supports optional\n``django-admin-shortcuts`` package.\n\n\n.. note::\n\n    This project is considered 3rd party (no supervision by the `django CMS Association \u003chttps://www.django-cms.org/en/about-us/\u003e`_). Join us on `Slack                 \u003chttps://www.django-cms.org/slack/\u003e`_ for more information.\n\n+---------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------+\n| .. image:: https://raw.githubusercontent.com/divio/djangocms-admin-style/master/preview/dashboard.png   | .. image:: https://raw.githubusercontent.com/divio/djangocms-admin-style/master/preview/listview.png   |\n+---------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------+\n| .. image:: https://raw.githubusercontent.com/divio/djangocms-admin-style/master/preview/datepicker.png  | .. image:: https://raw.githubusercontent.com/divio/djangocms-admin-style/master/preview/shortcuts.png  |\n+---------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------+\n\nThe shortcuts you see on top of the dashboard are from `django-admin-shortcuts \u003chttps://github.com/alesdotio/django-admin-shortcuts/\u003e`_\n\n*******************************************\nContribute to this project and win rewards\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\nWe're grateful to all contributors who have helped create and maintain this package.\nContributors are listed at the `contributors \u003chttps://github.com/django-cms/djangocms-admin-style/graphs/contributors\u003e`_\nsection.\n\n\nDocumentation\n=============\n\nSee ``REQUIREMENTS`` in the `setup.py \u003chttps://github.com/divio/djangocms-admin-style/blob/master/setup.py\u003e`_\nfile for additional dependencies:\n\n\n\nInstallation\n------------\n\nFor a manual install:\n\n* run ``pip install djangocms-admin-style``\n* add ``djangocms_admin_style`` to your ``INSTALLED_APPS`` just before ``'django.contrib.admin'``\n* run ``python manage.py migrate djangocms_admin_style``\n\n\nConfiguration\n-------------\n\nThe django CMS Admin Style overrides django admin's ``base_site.html``,\nbut you can still partially customize this page. Look at the source of\n``templates/admin/base_site.html`` and override the templates that are included\nin various blocks. For example, you can add your own CSS in\n``templates/admin/inc/extrastyle.html``.\n\nThe following additional settings can be set:\n\n* ``CMS_ENABLE_UPDATE_CHECK = True``\n  Set to ``False`` to disable the update notification.\n* ``CMS_UPDATE_CHECK_TYPE = ('minor')``\n  Set to ``('patch')`` to get only patch notifications.\n  (minor = 3.x.x, patch = 3.4.x)\n\nThe update checker does not gather or record any data.\n\nTo **compile CSS** run the following commands using **node 16**:\n\n* ``nvm use``\n* ``npm install``\n* ``npx gulp icons sass bundle``\n\n\nFor further options have a look at the ``gulpfile.js``.\n\nDark mode support\n-----------------\n\nDjango supports a dark mode admin since version 3.1. djangocms-admin-style\nintroduces css variables that contain color codes and change with the selected\nmode:\n\n+-------------------------------+-----------+---------------------------+-----------+\n| **CMS variable name**         | **Color** | **Django admin fallback** | **Color** |\n+-------------------------------+-----------+---------------------------+-----------+\n| ``--dca-white``               | #ffffff   | ``--body-bg``             | #ffffff   |\n+-------------------------------+-----------+---------------------------+-----------+\n| ``--dca-black``               | #000000   | ``--body-fg``             | #303030   |\n+-------------------------------+-----------+---------------------------+-----------+\n| ``--dca-gray``                | #666      | ``--body-quiet-color``    | #666      |\n+-------------------------------+-----------+---------------------------+-----------+\n| ``--dca-gray-lightest``       | #f2f2f2   | ``--darkened-bg``         | #f8f8f8   |\n+-------------------------------+-----------+---------------------------+-----------+\n| ``--dca-gray-lighter``        | #ddd      | ``--border-color``        | #ccc      |\n+-------------------------------+-----------+---------------------------+-----------+\n| ``--dca-gray-light``          | #999      | ``--close-button-bg``     | #888      |\n+-------------------------------+-----------+---------------------------+-----------+\n| ``--dca-gray-darker``         | #454545   |                           |           |\n+-------------------------------+-----------+---------------------------+-----------+\n| ``--dca-gray-darkest``        | #333      |                           |           |\n+-------------------------------+-----------+---------------------------+-----------+\n| ``--dca-gray-super-lightest`` | #f7f7f7   |                           |           |\n+-------------------------------+-----------+---------------------------+-----------+\n| ``--dca-primary``             | #00bbff   | ``--primary``             | #79aec8   |\n+-------------------------------+-----------+---------------------------+-----------+\n\n\nExtending styles in your own app\n---------------------------------\n\nIf your project or app requires specific styles if djangocms-admin-style is\ninstalled (e.g., to better adjust to the django CMS style) you can add selective\nstyling by adding the ``.djangocms-admin-style`` selector::\n\n    // Show widget in CMS colors if djangocms-admin-style is installed\n    .djangocms-admin-style #my-widget {\n        color:  var(--dca-primary, black);\n    }\n\nWe recommend to following rules for your app's admin css:\n\n- Try avoid using ``color``, ``background`` etc. styles where possible and meaningful\n- If necessary use as few as possible standard django CMS colors (preferably\n  from see above list with fallback colors)\n- Usage: ``var(--dca-color-var, var(--fallback-color-var, #xxxxxx))`` where\n  ``#xxxxxx`` represents the light version of the color.\n\nRunning Tests\n-------------\n\nYou can run tests by executing::\n\n    virtualenv env\n    source env/bin/activate\n    pip install -r tests/requirements/base.txt\n    python setup.py test\n\nIn order to run **integration tests** you need to have Docker installed,\nthen run the following command::\n\n    make test\n\nTo test other Django versions simply append `VERSION=4.1``. You can also\nrun the test server through::\n\n    make run\n\nThe integration tests are written using Casperjs, phantomcss and\ndjangocms-casper-helpers.\n\n\n.. |pypi| image:: https://badge.fury.io/py/djangocms-admin-style.svg\n    :target: http://badge.fury.io/py/djangocms-admin-style\n.. |build| image:: https://travis-ci.org/django-cms/djangocms-admin-style.svg?branch=master\n    :target: https://travis-ci.org/django-cms/djangocms-admin-style\n.. |coverage| image:: https://codecov.io/gh/django-cms/djangocms-admin-style/branch/master/graph/badge.svg\n    :target: https://codecov.io/gh/django-cms/djangocms-admin-style\n\n.. |python| image:: https://img.shields.io/badge/python-3.5+-blue.svg\n    :target: https://pypi.org/project/djangocms-admin-style/\n.. |django| image:: https://img.shields.io/badge/django-2.2%2B-blue.svg\n    :target: https://www.djangoproject.com/\n.. |djangocms| image:: https://img.shields.io/badge/django%20CMS-3.6%2B-blue.svg\n    :target: https://www.django-cms.org/\n.. |djangocms4| image:: https://img.shields.io/badge/django%20CMS-4-blue.svg\n    :target: https://www.django-cms.org/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjango-cms%2Fdjangocms-admin-style","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjango-cms%2Fdjangocms-admin-style","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjango-cms%2Fdjangocms-admin-style/lists"}