micro-sidebar 1.2.1__tar.gz → 2.1.0__tar.gz

{micro_sidebar-1.2.1 → micro_sidebar-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: micro_sidebar
-Version: 1.2.1
+Version: 2.1.0
 Summary: A Reusable RTL Django Sidebar App
 Home-page: https://github.com/debeski/micro-sidebar
 Author: DeBeski
@@ -66,6 +66,119 @@ Requires-Dist: Django>=5.1
     ]
     ```
 
+## Auto-Discovery Mode (New in v2.0.0)
+
+The sidebar can **automatically discover** your list views and generate navigation items!
+
+### Setup
+
+1. **Add context processor** to `settings.py`:
+    ```python
+    TEMPLATES = [{
+        'OPTIONS': {
+            'context_processors': [
+                ...
+                'sidebar.context_processors.sidebar_context',
+            ],
+        },
+    }]
+    ```
+
+2. **Use in your sidebar template:**
+    ```html
+    {% extends "sidebar/main.html" %}
+    {% load sidebar_tags %}
+
+    {% block items %}
+        {% auto_sidebar %}
+    {% endblock %}
+    ```
+
+That's it! The sidebar will automatically find all URLs with `list` in their name (e.g., `decree_list`), match them to models, and display `verbose_name_plural` as labels.
+
+### Configuration (Optional)
+
+Add to `settings.py`:
+```python
+SIDEBAR_AUTO = {
+    'ENABLED': True,                    # Enable auto-discovery
+    'URL_PATTERNS': ['list'],           # Keywords to match in URL names
+    'EXCLUDE_APPS': ['admin', 'auth'],  # Apps to exclude
+    'EXCLUDE_MODELS': [],               # Specific models to exclude
+    'CACHE_TIMEOUT': 3600,              # Cache timeout in seconds
+    'DEFAULT_ICON': 'bi-list',          # Default Bootstrap icon
+    'DEFAULT_ITEMS': {},                # See "Default Items" section below
+    'EXTRA_ITEMS': {},                  # See "Extra Items" section below
+}
+```
+
+### Default Items Configuration
+
+Use `DEFAULT_ITEMS` to customize auto-discovered items (labels, icons, ordering) without modifying your models:
+
+```python
+SIDEBAR_AUTO = {
+    # ...
+    'DEFAULT_ITEMS': {
+        'decree_list': {          # Key is the URL name
+            'label': 'Decisions', # Override display label
+            'icon': 'bi-gavel',   # Override icon
+            'order': 10,          # Sort order (lower = first)
+        },
+        'incoming_list': {
+            'order': 20,          # Only setting order
+        }
+    }
+}
+```
+
+Items not in `DEFAULT_ITEMS` will use defaults:
+- **Label**: Model's `verbose_name_plural`
+- **Icon**: `DEFAULT_ICON`
+- **Order**: 100
+
+### Extra Items (Non-Model URLs)
+
+For URLs that don't map to a model (e.g., management pages), use `EXTRA_ITEMS`:
+
+```python
+SIDEBAR_AUTO = {
+    # ... other config ...
+    'EXTRA_ITEMS': {
+        'الإدارة': {  # Group name (accordion header)
+            'icon': 'bi-gear',
+            'items': [
+                {
+                    'url_name': 'manage_sections',
+                    'label': 'إدارة الأقسام',
+                    'icon': 'bi-diagram-3',
+                    'permission': 'documents.manage_sections',
+                },
+                {
+                    'url_name': 'manage_users',
+                    'label': 'إدارة المستخدمين',
+                    'icon': 'bi-people',
+                    'permission': 'is_staff',      # or a special check to Only show to staff users.
+                },
+            ]
+        }
+    }
+}
+```
+
+Then in your sidebar template:
+```html
+{% extends "sidebar/main.html" %}
+{% load sidebar_tags %}
+
+{% block items %}
+    {% auto_sidebar %}
+    {% extra_sidebar %}
+{% endblock %}
+```
+
+Extra items appear at the bottom of the sidebar, grouped in Bootstrap accordions.
+
 ## Customization
 
 ### Override Default Menu
@@ -114,3 +227,6 @@ While it may theoretically work in LTR environments if standard Bootstrap files
 | **v1.1.0** | Renamed `content.html` to `main.html` for clarity. Refactored to use `{% block items %}` for easier extension. |
 | **v1.2.0** | **New Theme Implementation:** Redesigned UI with rounded pill-shaped items, tactile micro-animations, and a refined color palette. Improved responsiveness with dynamic top-offset calculations and inline FOUC fixes for small screens. Fixed tooltip stickiness bug. |
 | **v1.2.1** | **Positioning Fix:** Added `align-self: flex-start` to resolve 60px vertical offset in flex containers. Removed legacy `sidebar-top-offset` CSS variable and JS calculations. Added `box-shadow: none` and `outline: none` to accordion buttons to remove focus ring. Fixed page flickering on wider screens by constraining sidebar height with `calc(100vh - header-height)`. |
+| **v1.2.2** | **CSP Compliance:** Added `nonce` attribute support to inline scripts for Content Security Policy compliance. |
+| **v2.0.0** | **Auto-Discovery:** New feature that introspects Django URL patterns and models to automatically generate sidebar navigation items. Adds `{% auto_sidebar %}` template tag, context processor, and configuration options. |
+| **v2.1.0** | **Refactor & Enhancements:** Decoupled customization from models by introducing `DEFAULT_ITEMS` setting for overriding auto-discovered items' labels/icons/order. Added `EXTRA_ITEMS` setting for manual, permission-aware sidebar links grouped in accordions with `{% extra_sidebar %}` tag. Removed deprecated model-level `sidebar_*` attributes. |

micro_sidebar-2.1.0/README.md

@@ -0,0 +1,206 @@
+# Micro Sidebar - A Reusable RTL Django Sidebar App
+
+[![PyPI version](https://badge.fury.io/py/micro-sidebar.svg)](https://pypi.org/project/micro-sidebar/)
+
+**RTL** lightweight, reusable django app that provides a dynamic sidebar for your django projects.
+
+## Requirements
+
+-   **Django**: >= 5.1
+-   **Bootstrap**: 5 (Required for consistent styling)
+
+## Installation
+
+1.  **Install:**
+    ```bash
+    pip install micro-sidebar
+    # OR
+    pip install git+https://github.com/debeski/micro-sidebar.git
+    ```
+
+2.  **Add to `INSTALLED_APPS`:**
+    In your `settings.py`:
+    ```python
+    INSTALLED_APPS = [
+        ...
+        'sidebar',
+        ...
+    ]
+    ```
+
+3.  **Configure URLs:**
+    In your project's `urls.py`:
+    ```python
+    from django.urls import path, include
+
+    urlpatterns = [
+        ...
+        path('sidebar/', include('sidebar.urls')),
+        ...
+    ]
+    ```
+
+## Auto-Discovery Mode (New in v2.0.0)
+
+The sidebar can **automatically discover** your list views and generate navigation items!
+
+### Setup
+
+1. **Add context processor** to `settings.py`:
+    ```python
+    TEMPLATES = [{
+        'OPTIONS': {
+            'context_processors': [
+                ...
+                'sidebar.context_processors.sidebar_context',
+            ],
+        },
+    }]
+    ```
+
+2. **Use in your sidebar template:**
+    ```html
+    {% extends "sidebar/main.html" %}
+    {% load sidebar_tags %}
+
+    {% block items %}
+        {% auto_sidebar %}
+    {% endblock %}
+    ```
+
+That's it! The sidebar will automatically find all URLs with `list` in their name (e.g., `decree_list`), match them to models, and display `verbose_name_plural` as labels.
+
+### Configuration (Optional)
+
+Add to `settings.py`:
+```python
+SIDEBAR_AUTO = {
+    'ENABLED': True,                    # Enable auto-discovery
+    'URL_PATTERNS': ['list'],           # Keywords to match in URL names
+    'EXCLUDE_APPS': ['admin', 'auth'],  # Apps to exclude
+    'EXCLUDE_MODELS': [],               # Specific models to exclude
+    'CACHE_TIMEOUT': 3600,              # Cache timeout in seconds
+    'DEFAULT_ICON': 'bi-list',          # Default Bootstrap icon
+    'DEFAULT_ITEMS': {},                # See "Default Items" section below
+    'EXTRA_ITEMS': {},                  # See "Extra Items" section below
+}
+```
+
+### Default Items Configuration
+
+Use `DEFAULT_ITEMS` to customize auto-discovered items (labels, icons, ordering) without modifying your models:
+
+```python
+SIDEBAR_AUTO = {
+    # ...
+    'DEFAULT_ITEMS': {
+        'decree_list': {          # Key is the URL name
+            'label': 'Decisions', # Override display label
+            'icon': 'bi-gavel',   # Override icon
+            'order': 10,          # Sort order (lower = first)
+        },
+        'incoming_list': {
+            'order': 20,          # Only setting order
+        }
+    }
+}
+```
+
+Items not in `DEFAULT_ITEMS` will use defaults:
+- **Label**: Model's `verbose_name_plural`
+- **Icon**: `DEFAULT_ICON`
+- **Order**: 100
+
+### Extra Items (Non-Model URLs)
+
+For URLs that don't map to a model (e.g., management pages), use `EXTRA_ITEMS`:
+
+```python
+SIDEBAR_AUTO = {
+    # ... other config ...
+    'EXTRA_ITEMS': {
+        'الإدارة': {  # Group name (accordion header)
+            'icon': 'bi-gear',
+            'items': [
+                {
+                    'url_name': 'manage_sections',
+                    'label': 'إدارة الأقسام',
+                    'icon': 'bi-diagram-3',
+                    'permission': 'documents.manage_sections',
+                },
+                {
+                    'url_name': 'manage_users',
+                    'label': 'إدارة المستخدمين',
+                    'icon': 'bi-people',
+                    'permission': 'is_staff',      # or a special check to Only show to staff users.
+                },
+            ]
+        }
+    }
+}
+```
+
+Then in your sidebar template:
+```html
+{% extends "sidebar/main.html" %}
+{% load sidebar_tags %}
+
+{% block items %}
+    {% auto_sidebar %}
+    {% extra_sidebar %}
+{% endblock %}
+```
+
+Extra items appear at the bottom of the sidebar, grouped in Bootstrap accordions.
+
+## Customization
+
+### Override Default Menu
+The sidebar uses a block-based template system. To define your own menu items:
+
+1. Create a new template (e.g., `templates/sidebar_menu.html`).
+2. Extend `sidebar/main.html`.
+3. Override the `{% block items %}`.
+
+**Example `sidebar_menu.html`:**
+```html
+{% extends "sidebar/main.html" %}
+
+{% block items %}
+<a href="{% url 'home' %}" class="list-group-item list-group-item-action">
+    <i class="bi bi-house me-2" style="font-size: 24px;"></i>
+    <span>Home</span>
+</a>
+<a href="{% url 'settings' %}" class="list-group-item list-group-item-action">
+    <i class="bi bi-gear me-2" style="font-size: 24px;"></i>
+    <span>Settings</span>
+</a>
+{% endblock %}
+```
+
+Then, include your custom template in `base.html`:
+```html
+{% include "sidebar_menu.html" %}
+```
+
+### Positioning
+The sidebar is sticky by default. If your app has a top navigation bar (titlebar), the sidebar will automatically adjust its position below it on small screens. If no titlebar is detected, it will stick to the top of the viewport.
+
+## RTL / LTR Support
+This sidebar is primarily designed for **RTL (Right-to-Left)** interfaces (e.g., Arabic). 
+While it may theoretically work in LTR environments if standard Bootstrap files are used instead of RTL versions, this has **not been fully tested**. 
+> *Future updates are planned to support dynamic language switching between RTL and LTR.*
+
+## Version History
+
+| Version | Changes |
+| :--- | :--- |
+| **v1.0.0** | Initial Release. |
+| **v1.0.1** | Fixed titlebar positioning bug causing overlap/gaps. |
+| **v1.0.2** | Improved documentation clarity and added usage instructions. |
+| **v1.1.0** | Renamed `content.html` to `main.html` for clarity. Refactored to use `{% block items %}` for easier extension. |
+| **v1.2.0** | **New Theme Implementation:** Redesigned UI with rounded pill-shaped items, tactile micro-animations, and a refined color palette. Improved responsiveness with dynamic top-offset calculations and inline FOUC fixes for small screens. Fixed tooltip stickiness bug. |
+| **v1.2.1** | **Positioning Fix:** Added `align-self: flex-start` to resolve 60px vertical offset in flex containers. Removed legacy `sidebar-top-offset` CSS variable and JS calculations. Added `box-shadow: none` and `outline: none` to accordion buttons to remove focus ring. Fixed page flickering on wider screens by constraining sidebar height with `calc(100vh - header-height)`. |
+| **v1.2.2** | **CSP Compliance:** Added `nonce` attribute support to inline scripts for Content Security Policy compliance. |
+| **v2.0.0** | **Auto-Discovery:** New feature that introspects Django URL patterns and models to automatically generate sidebar navigation items. Adds `{% auto_sidebar %}` template tag, context processor, and configuration options. |
+| **v2.1.0** | **Refactor & Enhancements:** Decoupled customization from models by introducing `DEFAULT_ITEMS` setting for overriding auto-discovered items' labels/icons/order. Added `EXTRA_ITEMS` setting for manual, permission-aware sidebar links grouped in accordions with `{% extra_sidebar %}` tag. Removed deprecated model-level `sidebar_*` attributes. |

{micro_sidebar-1.2.1 → micro_sidebar-2.1.0}/micro_sidebar.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: micro-sidebar
-Version: 1.2.1
+Version: 2.1.0
 Summary: A Reusable RTL Django Sidebar App
 Home-page: https://github.com/debeski/micro-sidebar
 Author: DeBeski
@@ -66,6 +66,119 @@ Requires-Dist: Django>=5.1
     ]
     ```
 
+## Auto-Discovery Mode (New in v2.0.0)
+
+The sidebar can **automatically discover** your list views and generate navigation items!
+
+### Setup
+
+1. **Add context processor** to `settings.py`:
+    ```python
+    TEMPLATES = [{
+        'OPTIONS': {
+            'context_processors': [
+                ...
+                'sidebar.context_processors.sidebar_context',
+            ],
+        },
+    }]
+    ```
+
+2. **Use in your sidebar template:**
+    ```html
+    {% extends "sidebar/main.html" %}
+    {% load sidebar_tags %}
+
+    {% block items %}
+        {% auto_sidebar %}
+    {% endblock %}
+    ```
+
+That's it! The sidebar will automatically find all URLs with `list` in their name (e.g., `decree_list`), match them to models, and display `verbose_name_plural` as labels.
+
+### Configuration (Optional)
+
+Add to `settings.py`:
+```python
+SIDEBAR_AUTO = {
+    'ENABLED': True,                    # Enable auto-discovery
+    'URL_PATTERNS': ['list'],           # Keywords to match in URL names
+    'EXCLUDE_APPS': ['admin', 'auth'],  # Apps to exclude
+    'EXCLUDE_MODELS': [],               # Specific models to exclude
+    'CACHE_TIMEOUT': 3600,              # Cache timeout in seconds
+    'DEFAULT_ICON': 'bi-list',          # Default Bootstrap icon
+    'DEFAULT_ITEMS': {},                # See "Default Items" section below
+    'EXTRA_ITEMS': {},                  # See "Extra Items" section below
+}
+```
+
+### Default Items Configuration
+
+Use `DEFAULT_ITEMS` to customize auto-discovered items (labels, icons, ordering) without modifying your models:
+
+```python
+SIDEBAR_AUTO = {
+    # ...
+    'DEFAULT_ITEMS': {
+        'decree_list': {          # Key is the URL name
+            'label': 'Decisions', # Override display label
+            'icon': 'bi-gavel',   # Override icon
+            'order': 10,          # Sort order (lower = first)
+        },
+        'incoming_list': {
+            'order': 20,          # Only setting order
+        }
+    }
+}
+```
+
+Items not in `DEFAULT_ITEMS` will use defaults:
+- **Label**: Model's `verbose_name_plural`
+- **Icon**: `DEFAULT_ICON`
+- **Order**: 100
+
+### Extra Items (Non-Model URLs)
+
+For URLs that don't map to a model (e.g., management pages), use `EXTRA_ITEMS`:
+
+```python
+SIDEBAR_AUTO = {
+    # ... other config ...
+    'EXTRA_ITEMS': {
+        'الإدارة': {  # Group name (accordion header)
+            'icon': 'bi-gear',
+            'items': [
+                {
+                    'url_name': 'manage_sections',
+                    'label': 'إدارة الأقسام',
+                    'icon': 'bi-diagram-3',
+                    'permission': 'documents.manage_sections',
+                },
+                {
+                    'url_name': 'manage_users',
+                    'label': 'إدارة المستخدمين',
+                    'icon': 'bi-people',
+                    'permission': 'is_staff',      # or a special check to Only show to staff users.
+                },
+            ]
+        }
+    }
+}
+```
+
+Then in your sidebar template:
+```html
+{% extends "sidebar/main.html" %}
+{% load sidebar_tags %}
+
+{% block items %}
+    {% auto_sidebar %}
+    {% extra_sidebar %}
+{% endblock %}
+```
+
+Extra items appear at the bottom of the sidebar, grouped in Bootstrap accordions.
+
 ## Customization
 
 ### Override Default Menu
@@ -114,3 +227,6 @@ While it may theoretically work in LTR environments if standard Bootstrap files
 | **v1.1.0** | Renamed `content.html` to `main.html` for clarity. Refactored to use `{% block items %}` for easier extension. |
 | **v1.2.0** | **New Theme Implementation:** Redesigned UI with rounded pill-shaped items, tactile micro-animations, and a refined color palette. Improved responsiveness with dynamic top-offset calculations and inline FOUC fixes for small screens. Fixed tooltip stickiness bug. |
 | **v1.2.1** | **Positioning Fix:** Added `align-self: flex-start` to resolve 60px vertical offset in flex containers. Removed legacy `sidebar-top-offset` CSS variable and JS calculations. Added `box-shadow: none` and `outline: none` to accordion buttons to remove focus ring. Fixed page flickering on wider screens by constraining sidebar height with `calc(100vh - header-height)`. |
+| **v1.2.2** | **CSP Compliance:** Added `nonce` attribute support to inline scripts for Content Security Policy compliance. |
+| **v2.0.0** | **Auto-Discovery:** New feature that introspects Django URL patterns and models to automatically generate sidebar navigation items. Adds `{% auto_sidebar %}` template tag, context processor, and configuration options. |
+| **v2.1.0** | **Refactor & Enhancements:** Decoupled customization from models by introducing `DEFAULT_ITEMS` setting for overriding auto-discovered items' labels/icons/order. Added `EXTRA_ITEMS` setting for manual, permission-aware sidebar links grouped in accordions with `{% extra_sidebar %}` tag. Removed deprecated model-level `sidebar_*` attributes. |

micro_sidebar-2.1.0/micro_sidebar.egg-info/SOURCES.txt

@@ -0,0 +1,34 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+micro_sidebar.egg-info/PKG-INFO
+micro_sidebar.egg-info/SOURCES.txt
+micro_sidebar.egg-info/dependency_links.txt
+micro_sidebar.egg-info/requires.txt
+micro_sidebar.egg-info/top_level.txt
+sidebar/__init__.py
+sidebar/apps.py
+sidebar/context_processors.py
+sidebar/discovery.py
+sidebar/urls.py
+sidebar/views.py
+sidebar/migrations/__init__.py
+sidebar/static/sidebar/sidebar.css
+sidebar/static/sidebar/sidebar.js
+sidebar/static/sidebar/css/theme_picker.css
+sidebar/static/sidebar/js/theme_picker.js
+sidebar/static/themes/blue.css
+sidebar/static/themes/dark.css
+sidebar/static/themes/gold.css
+sidebar/static/themes/green.css
+sidebar/static/themes/light.css
+sidebar/static/themes/main.css
+sidebar/static/themes/main.js
+sidebar/static/themes/red.css
+sidebar/templates/sidebar/auto.html
+sidebar/templates/sidebar/extra_groups.html
+sidebar/templates/sidebar/main.html
+sidebar/templatetags/__init__.py
+sidebar/templatetags/sidebar_tags.py

{micro_sidebar-1.2.1 → micro_sidebar-2.1.0}/pyproject.toml

@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "micro_sidebar"
-version = "1.2.1"
+version = "2.1.0"
 description = "A Reusable RTL Django Sidebar App"
 readme = "README.md"
 requires-python = ">=3.9"

{micro_sidebar-1.2.1 → micro_sidebar-2.1.0}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="micro_sidebar",
-    version="1.2.1",
+    version="2.1.0",
     author="DeBeski",
     author_email="debeski1@gmail.com",
     description="A Reusable RTL Django Sidebar App",

micro_sidebar-2.1.0/sidebar/apps.py

@@ -0,0 +1,15 @@
+from django.apps import AppConfig
+
+
+class SidebarConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'sidebar'
+    
+    def ready(self):
+        """
+        Called when Django starts.
+        Import discovery module to ensure it's available.
+        """
+        # Import to make discovery available
+        from . import discovery  # noqa: F401
+

micro_sidebar-2.1.0/sidebar/context_processors.py

@@ -0,0 +1,127 @@
+"""
+Context processor for auto-discovered sidebar items.
+
+Injects sidebar navigation items into every request context,
+filtered by user permissions.
+"""
+import hashlib
+import json
+from django.core.cache import cache
+from django.urls import reverse, NoReverseMatch
+from .discovery import discover_list_urls, get_sidebar_config
+
+
+def _get_config_hash(config):
+    """Generate a hash of the config for cache key."""
+    # Exclude EXTRA_ITEMS from hash since they're processed separately
+    config_copy = {k: v for k, v in config.items() if k != 'EXTRA_ITEMS'}
+    config_str = json.dumps(config_copy, sort_keys=True)
+    return hashlib.md5(config_str.encode()).hexdigest()[:8]
+
+
+def _process_extra_items(config, request):
+    """
+    Process EXTRA_ITEMS config into sidebar-ready format.
+    
+    Returns dict of groups, each with icon and list of items with resolved URLs.
+    """
+    extra_items = config.get('EXTRA_ITEMS', {})
+    processed_groups = {}
+    
+    for group_name, group_config in extra_items.items():
+        group_icon = group_config.get('icon', 'bi-gear')
+        items = []
+        
+        for item in group_config.get('items', []):
+            url_name = item.get('url_name', '')
+            
+            # Check permission if specified
+            permission = item.get('permission')
+            if permission:
+                if permission == 'is_staff' and not request.user.is_staff:
+                    continue
+                elif permission == 'is_superuser' and not request.user.is_superuser:
+                    continue
+                elif permission not in ['is_staff', 'is_superuser'] and not request.user.has_perm(permission):
+                    continue
+            
+            # Resolve URL
+            try:
+                url = reverse(url_name)
+                active = request.path == url or request.path.startswith(url.rstrip('/') + '/')
+            except NoReverseMatch:
+                url = '#'
+                active = False
+            
+            items.append({
+                'url_name': url_name,
+                'url': url,
+                'label': item.get('label', url_name),
+                'icon': item.get('icon', 'bi-link'),
+                'active': active,
+            })
+        
+        if items:  # Only add group if it has visible items
+            processed_groups[group_name] = {
+                'icon': group_icon,
+                'items': items,
+                'has_active': any(item['active'] for item in items),
+            }
+    
+    return processed_groups
+
+
+def sidebar_context(request):
+    """
+    Add auto-discovered sidebar items to template context.
+    
+    Items are cached for performance and filtered by user permissions.
+    Only authenticated users see sidebar items, and only items they
+    have view permission for.
+    
+    Returns:
+        Dictionary with 'sidebar_auto_items' and 'sidebar_extra_groups' keys.
+    """
+    config = get_sidebar_config()
+    # Include config hash in cache key so settings changes invalidate cache
+    cache_key = f'sidebar_auto_items_{_get_config_hash(config)}'
+    items = cache.get(cache_key)
+    
+    if items is None:
+        items = discover_list_urls()
+        cache.set(cache_key, items, timeout=config['CACHE_TIMEOUT'])
+    
+    # Filter by user permissions
+    if request.user.is_authenticated:
+        if request.user.is_superuser:
+            # Superusers see everything
+            visible = items
+        else:
+            visible = []
+            for item in items:
+                if not item.get('permissions'):
+                    visible.append(item)
+                elif any(request.user.has_perm(p) for p in item['permissions']):
+                    visible.append(item)
+            items = visible
+        
+        # Process extra items for authenticated users
+        extra_groups = _process_extra_items(config, request)
+    else:
+        items = []
+        extra_groups = {}
+    
+    return {
+        'sidebar_auto_items': items,
+        'sidebar_extra_groups': extra_groups,
+    }
+
+
+def clear_sidebar_cache():
+    """
+    Clear the sidebar items cache.
+    
+    Call this when models or URLs change and sidebar needs refresh.
+    """
+    cache.delete('sidebar_auto_items')
+