Package: djangocms-admin-style
Adds pretty CSS styles for the django CMS admin interface. Supports optionaldjango-admin-shortcutspackage.NoteThis project is considered 3rd party (no supervision by thedjango CMS Association). Join us onSlackfor more information.The shortcuts you see on top of the dashboard are fromdjango-admin-shortcutsContribute to this project and win rewardsBecause this is a an open-source project, we welcome everyone toget involved in the projectandreceive a rewardfor their contribution.
Become part of a fantastic community and help us make django CMS the best CMS in the world.We’ll be delighted to receive your
feedback in the form of issues and pull requests. Before submitting your
pull request, please review ourcontribution guidelines.We’re grateful to all contributors who have helped create and maintain this package.
Contributors are listed at thecontributorssection.DocumentationSeeREQUIREMENTSin thesetup.pyfile for additional dependencies:InstallationFor a manual install:runpip installdjangocms-admin-styleadddjangocms_admin_styleto yourINSTALLED_APPSjust before'django.contrib.admin'runpython manage.py migrate djangocms_admin_styleConfigurationThe django CMS Admin Style overrides django admin’sbase_site.html,
but you can still partially customize this page. Look at the source oftemplates/admin/base_site.htmland override the templates that are included
in various blocks. For example, you can add your own CSS intemplates/admin/inc/extrastyle.html.The following additional settings can be set:CMS_ENABLE_UPDATE_CHECK = TrueSet toFalseto disable the update notification.CMS_UPDATE_CHECK_TYPE = ('minor')Set to('patch')to get only patch notifications.
(minor = 3.x.x, patch = 3.4.x)The update checker does not gather or record any data.Tocompile CSSrun the following commands usingnode 16:nvm usenpm installnpx gulp icons sass bundleFor further options have a look at thegulpfile.js.Dark mode supportDjango supports a dark mode admin since version 3.1. djangocms-admin-style
introduces css variables that contain color codes and change with the selected
mode:CMS variable nameColorDjango admin fallbackColor--dca-white#ffffff--body-bg#ffffff--dca-black#000000--body-fg#303030--dca-gray#666--body-quiet-color#666--dca-gray-lightest#f2f2f2--darkened-bg#f8f8f8--dca-gray-lighter#ddd--border-color#ccc--dca-gray-light#999--close-button-bg#888--dca-gray-darker#454545--dca-gray-darkest#333--dca-gray-super-lightest#f7f7f7--dca-primary#00bbff--primary#79aec8Extending styles in your own appIf your project or app requires specific styles if djangocms-admin-style is
installed (e.g., to better adjust to the django CMS style) you can add selective
styling by adding the.djangocms-admin-styleselector:// Show widget in CMS colors if djangocms-admin-style is installed
.djangocms-admin-style #my-widget {
    color:  var(--dca-primary, black);
}We recommend to following rules for your app’s admin css:Try avoid usingcolor,backgroundetc. styles where possible and meaningfulIf necessary use as few as possible standard django CMS colors (preferably
from see above list with fallback colors)Usage:var(--dca-color-var,var(--fallback-color-var,#xxxxxx))where#xxxxxxrepresents the light version of the color.Running TestsYou can run tests by executing:virtualenv env
source env/bin/activate
pip install -r tests/requirements/base.txt
python setup.py testIn order to runintegration testsyou need to have Docker installed,
then run the following command:make testTo test other Django versions simply appendVERSION=4.1`. You can also
run the test server through:make runThe integration tests are written using Casperjs, phantomcss and
djangocms-casper-helpers.