Installation

1. Install the latest stable version:

   $ pip install django-adminlte-full

   or install development version (bugs are possible):

   $ pip install https://github.com/kyzima-spb/django-adminlte-full/archive/dev-master.zip

2. In the settings, add crispy_forms and adminlte_full to your INSTALLED_APPS, like this:

   INSTALLED_APPS = [
       ...
       'crispy_forms',
       'adminlte_full',
   ]

3. In the settings, set the value of the CRISPY_TEMPLATE_PACK option as 'bootstrap4':

   CRISPY_TEMPLATE_PACK = 'bootstrap4'

4. In the settings, add adminlte to the list of context processors, like this:

   TEMPLATES = [
       {
           ...
           'OPTIONS': {
               'context_processors': [
                   ...
                   'adminlte_full.context_processors.adminlte',
               ],
           },
       },
   ]

5. Include the URLconf in your project urls.py like this:

   path('', include('adminlte_full.urls'))

Documentation

Continue reading the documentation.

0.2.0

• Upgrading to Bootstrap 4 and AdminLTE 3.

• Full integration with Django authentication system.

• Added pages for 400, 403, 404 and 500 errors.

• The django-bootstrap dependency has been replaced with a more functional django-crispy-form.

• Color skins for sidebar, navbar and logo.

• The manager provides the following decorators for loaders:

  • manager.@home_page_getter - sets a callback to get the home page.

  • @manager.menu_loader - sets the callback for loading a menu from the database or other source.

  • @manager.messages_loader - sets the callback for loading a messages from the database or other source.

  • @manager.notifications_loader - sets the callback for loading a notifications from the database or other source.

  • @manager.tasks_loader - sets the callback for loading a tasks from the database or other source.

  • @manager.user_getter - sets a callback to get the original user object. It has a default implementation.

• The extension depends on the adminlte-base package, into which all the basic logic has been moved.

• The application menu is now stored in the database.

• The following context managers have been added:

  • config - getting the configuration parameter in the template.

  • ThemeColor - color styles.

  • ThemeLayout - layout Options.

  • adminlte_user - current user.

• The following template filters are added:

  • gravatar - getting an avatar using the Gravatar service.

  • humanize - date output in human-readable format.

• Almost all classes, functions and templates from the previous release are removed. All signals are also deleted.

0.1.1

The release was added only to maintain backward compatibility. All new code will no longer work with the old version.