Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/django-cms/djangocms-admin-style

django CMS Admin Style is a Django Theme tailored to the needs of django CMS.
https://github.com/django-cms/djangocms-admin-style

addon cms django django-admin django-cms python theme

Last synced: about 2 months ago
JSON representation

django CMS Admin Style is a Django Theme tailored to the needs of django CMS.

Awesome Lists containing this project

README 

        
======================

django CMS Admin Style

======================



|pypi| |python| |django| |djangocms| |djangocms4| |coverage|



Adds pretty CSS styles for the django CMS admin interface. Supports optional

``django-admin-shortcuts`` package.



.. note::



    This project is considered 3rd party (no supervision by the `django CMS Association `_). Join us on `Slack                 `_ for more information.



+---------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------+

| .. 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   |

+---------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------+

| .. 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  |

+---------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------+



The shortcuts you see on top of the dashboard are from `django-admin-shortcuts `_



*******************************************

Contribute to this project and win rewards

*******************************************



Because this is a an open-source project, we welcome everyone to

`get involved in the project `_ and

`receive a reward `_ for 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 our `contribution guidelines

`_.



We're grateful to all contributors who have helped create and maintain this package.

Contributors are listed at the `contributors `_

section.



Documentation

=============



See ``REQUIREMENTS`` in the `setup.py `_

file for additional dependencies:



Installation

------------



For a manual install:



* run ``pip install djangocms-admin-style``

* add ``djangocms_admin_style`` to your ``INSTALLED_APPS`` just before ``'django.contrib.admin'``

* run ``python manage.py migrate djangocms_admin_style``



Configuration

-------------



The django CMS Admin Style overrides django admin's ``base_site.html``,

but you can still partially customize this page. Look at the source of

``templates/admin/base_site.html`` and override the templates that are included

in various blocks. For example, you can add your own CSS in

``templates/admin/inc/extrastyle.html``.



The following additional settings can be set:



* ``CMS_ENABLE_UPDATE_CHECK = True``

  Set to ``False`` to 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.



To **compile CSS** run the following commands using **node 16**:



* ``nvm use``

* ``npm install``

* ``npx gulp icons sass bundle``



For further options have a look at the ``gulpfile.js``.



Dark mode support

-----------------



Django 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 name**         | **Color** | **Django admin fallback** | **Color** |

+-------------------------------+-----------+---------------------------+-----------+

| ``--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``             | #79aec8   |

+-------------------------------+-----------+---------------------------+-----------+



Extending styles in your own app

---------------------------------



If 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-style`` selector::



    // 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 using ``color``, ``background`` etc. styles where possible and meaningful

- If 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

  ``#xxxxxx`` represents the light version of the color.



Running Tests

-------------



You can run tests by executing::



    virtualenv env

    source env/bin/activate

    pip install -r tests/requirements/base.txt

    python setup.py test



In order to run **integration tests** you need to have Docker installed,

then run the following command::



    make test



To test other Django versions simply append `VERSION=4.1``. You can also

run the test server through::



    make run



The integration tests are written using Casperjs, phantomcss and

djangocms-casper-helpers.



.. |pypi| image:: https://badge.fury.io/py/djangocms-admin-style.svg

    :target: http://badge.fury.io/py/djangocms-admin-style

.. |build| image:: https://travis-ci.org/django-cms/djangocms-admin-style.svg?branch=master

    :target: https://travis-ci.org/django-cms/djangocms-admin-style

.. |coverage| image:: https://codecov.io/gh/django-cms/djangocms-admin-style/branch/master/graph/badge.svg

    :target: https://codecov.io/gh/django-cms/djangocms-admin-style



.. |python| image:: https://img.shields.io/badge/python-3.5+-blue.svg

    :target: https://pypi.org/project/djangocms-admin-style/

.. |django| image:: https://img.shields.io/badge/django-2.2%2B-blue.svg

    :target: https://www.djangoproject.com/

.. |djangocms| image:: https://img.shields.io/badge/django%20CMS-3.6%2B-blue.svg

    :target: https://www.django-cms.org/

.. |djangocms4| image:: https://img.shields.io/badge/django%20CMS-4-blue.svg

    :target: https://www.django-cms.org/