Configuration

Dj Signals Panel works out of the box with no required configuration. All options are set via a DJ_SIGNALS_PANEL_SETTINGS dict in your Django settings.

DJ_SIGNALS_PANEL_SETTINGS = {
    'SHOW_SOURCE': False,
    'SIGNAL_MODULES': [],
    'LOAD_DEFAULT_CSS': True,
    'EXTRA_CSS': [],
}

Settings Reference

SHOW_SOURCE

Type: bool
Default: False
Description: When True, each receiver row on the signal detail page includes an expandable View Source section that renders the receiver's source code with syntax highlighting.

DJ_SIGNALS_PANEL_SETTINGS = {
    'SHOW_SOURCE': True,
}

SIGNAL_MODULES

Type: list[str]
Default: []
Description: Additional Python module paths to include in signal discovery, on top of what is found automatically. Useful when your signals are defined in modules that are not picked up by default.

DJ_SIGNALS_PANEL_SETTINGS = {
    'SIGNAL_MODULES': [
        'myapp.signals',
        'otherapp.events',
    ],
}

LOAD_DEFAULT_CSS

Type: bool
Default: True
Description: Whether to load the built-in Signals Panel stylesheet. Set to False to provide your own styles from scratch.

EXTRA_CSS

Type: list[str]
Default: []
Description: Additional stylesheets to load after the default CSS. Accepts static file paths or full URLs.

Static file paths are relative to your app's static/ subdirectory (same convention as Django's {% static %} tag). A file at myapp/static/myapp/css/overrides.css is referenced as myapp/css/overrides.css.

DJ_SIGNALS_PANEL_SETTINGS = {
    'EXTRA_CSS': [
        # File lives at: myapp/static/myapp/css/overrides.css
        'myapp/css/overrides.css',
        # Full URLs are also supported
        'https://cdn.example.com/theme.css',
    ],
}

URLs Configuration

# urls.py
urlpatterns = [
    path('admin/dj-signals-panel/', include('dj_signals_panel.urls')),
    path('admin/', admin.site.urls),
]

Security

Dj Signals Panel uses Django's built-in admin authentication:

• Only staff users (is_staff=True) can access the panel
• All views require authentication via @staff_member_required
• No additional security configuration needed