Django Daisy

You can customize how apps appear in the DaisyAdminSite dashboard using two methods:

1. Using DAISY_SETTINGS['APPS_REORDER']

In your Django settings, define a dictionary where keys are app labels and values are configuration overrides. This is useful for quick adjustments without creating new AppConfig classes.

2. Using AppConfig attributes

DaisyAdminSite looks for specific attributes on your Django AppConfig objects. You can add these to your app's apps.py to define how the app is represented in the dashboard:

• icon: The icon identifier (e.g., for Font Awesome).
• divider_title: A title used to group the app under a specific section divider.
• priority: An integer used to sort the app in the list (higher values appear first).
• hide: A boolean to exclude the app from the admin index.

# Example using DAISY_SETTINGS in settings.py
DAISY_SETTINGS = {
    "APPS_REORDER": {
        "myapp": {
            "priority": 10,
            "icon": "fa-rocket",
        }
    }
}

# Example using AppConfig in myapp/apps.py
class MyappConfig(AppConfig):
    name = 'myapp'
    icon = 'fa-rocket'
    divider_title = 'Core Modules'
    priority = 10

Use the DAISY_SETTINGS dictionary in settings.py to control branding, themes, and UI behavior.

Branding

• SITE_TITLE: The title of the site.
• SITE_HEADER: The header text.
• INDEX_TITLE: The welcome message on the dashboard.
• SITE_LOGO: Path to the site logo.

Customization

• EXTRA_STYLES: List of additional CSS files.
• EXTRA_SCRIPTS: List of additional JS files.
• LOAD_FULL_STYLES: Set to True to load the complete DaisyUI library (required for custom themes).
• SHOW_CHANGELIST_FILTER: Boolean to auto-open the filter sidebar.
• DONT_SUPPORT_ME: Boolean to hide the GitHub link.
• SIDEBAR_FOOTNOTE: Custom text for the sidebar footer.

Theme Configuration

• DEFAULT_THEME: The default light theme (e.g., 'corporate').
• DEFAULT_THEME_DARK: The default dark theme (e.g., 'dim').
• SHOW_THEME_SELECTOR: Boolean to show/hide the theme dropdown.
• THEME_LIST: A list of dictionaries defining available themes: [{'name': 'Label', 'value': 'theme-value'}].

Third-Party App Customization

• APPS_REORDER: A dictionary to customize existing apps (like auth). Keys are app names, values are configuration objects containing icon, name, hide, and divider_title.

DAISY_SETTINGS = {
    # Branding
    'SITE_TITLE': 'Django Admin',
    'SITE_HEADER': 'Administration',
    'INDEX_TITLE': 'Hi, welcome to your dashboard',
    'SITE_LOGO': '/static/admin/img/daisyui-logomark.svg',
    
    # Customization
    'EXTRA_STYLES': [],  # Additional CSS files
    'EXTRA_SCRIPTS': [],  # Additional JS files
    'LOAD_FULL_STYLES': False,  # Load complete DaisyUI library
    'SHOW_CHANGELIST_FILTER': False,  # Auto-open filter sidebar
    'DONT_SUPPORT_ME': False,  # Hide GitHub link
    'SIDEBAR_FOOTNOTE': '',  # Custom sidebar footer text
    
    # Theme Configuration
    'DEFAULT_THEME': None,  # e.g., 'corporate', 'dark'
    'DEFAULT_THEME_DARK': None,  # Dark mode default
    'SHOW_THEME_SELECTOR': True,  # Show/hide theme dropdown
    'THEME_LIST': [
        {'name': 'Light', 'value': 'light'},
        {'name': 'Dark', 'value': 'dark'},
        # Add custom themes...
    ],
    
    # Third-Party App Customization
    'APPS_REORDER': {
        'auth': {
            'icon': 'fa-solid fa-person-military-pointing',
            'name': 'Authentication',
            'hide': False,
            'divider_title': "Auth",
        },
    },
}