English — user guide#

The dashboard can show a welcome block, quick start, statistics, core widgets, custom information widgets, plugin widgets, onboarding, notifications, profile completion, recent activity, and subscription information. Administrators control visibility and order; members only see enabled items allowed for their account.

If dashboard_enabled is false, the member dashboard does not become an error page: the runtime redirects to the profile page. A read-only administrator preview uses saved, normalized values and example data.

English — technical reference#

Runtime settings consumed by MemberController include:

PluginDashboardRegistry::getAll() filters sections by capability and the database setting member_dashboard_plugin_{plugin}. A missing visibility option means visible. getMenuItems() supplies /member/plugin/{slug} entries through member_menu_items; duplicate slugs are not added. getDashboardWidgets() excludes child sections (parent_slug) and explicit dashboard_widget=false, safely sanitizes text, six-digit colors, and local/HTTP(S) admin links, and ignores statistics callback exceptions.

The controller validates links and colors, trims text, removes unknown ordering values, limits displayed arrays, and uses fallback labels and colors. member_dashboard_widgets can modify the final widget list. Dashboard feature usage is recorded as member.dashboard.

365CMS Member-Dashboard

Deutsch — Anwenderblock#

Das Dashboard kann Begrüßung, Schnellstart, Statistiken, Kern-Widgets, eigene Infokarten, Plugin-Widgets, Onboarding, Benachrichtigungen, Profilfortschritt, aktuelle Aktivitäten und Abonnementinformationen anzeigen. Administratoren steuern Sichtbarkeit und Reihenfolge; Mitglieder sehen nur aktivierte und für ihr Konto zulässige Inhalte.

Bei dashboard_enabled=false entsteht keine Fehlerseite: Die Runtime leitet zum Profil um. Die schreibgeschützte Admin-Vorschau verwendet gespeicherte, normalisierte Werte und Beispieldaten.

Deutsch — Technikblock#

Die von MemberController verwendeten Einstellungen sind:

PluginDashboardRegistry::getAll() filtert nach Berechtigung und der Datenbankoption member_dashboard_plugin_{plugin}. Eine fehlende Sichtbarkeitsoption bedeutet sichtbar. getMenuItems() liefert über member_menu_items Einträge nach /member/plugin/{slug}; doppelte Slugs werden vermieden. getDashboardWidgets() überspringt Unterbereiche (parent_slug) und dashboard_widget=false, bereinigt Texte, sechsstellige Farben und lokale/HTTP(S)-Admin-Links und ignoriert Fehler in Statistik-Callbacks.

Der Controller validiert Links und Farben, kürzt Texte, entfernt unbekannte Sortierwerte, begrenzt Arrays und verwendet sichere Fallbacks. member_dashboard_widgets kann die fertige Widget-Liste verändern. Die Feature-Nutzung wird als member.dashboard erfasst.

Ergänzung (Stand 2026-10-02): Plugin-Bereiche und -Widgets registrieren#

Plugins tragen sich im Hook member_dashboard_init in die CMS\Member\PluginDashboardRegistry ein. Pflichtfelder: slug, label, render_callback.

\CMS\Hooks::addAction('member_dashboard_init', static function (\CMS\Member\PluginDashboardRegistry $registry): void {
    $registry->register([
        'plugin'     => 'mein-plugin',
        'slug'       => 'meine-buchungen',
        'label'      => 'Meine Buchungen',
        'icon'       => '📅',
        'category'   => 'plugins',
        'priority'   => 20,                 // kleiner = weiter oben
        'capability' => null,               // null = alle Mitglieder, 'admin' = nur Administratoren
        'dashboard_widget' => [
            'title'          => 'Buchungen',
            'description'    => 'Offene und kommende Termine',
            'color'          => '#0ea5e9', // #rrggbb
            'stats_callback' => [MeinPlugin\Member::class, 'stats'], // gibt ['count' => int, 'label' => string] zurück
        ],
        'render_callback' => static function (object $user, array $params): void {
            // Ausgabe innerhalb des Member-Layouts; $params enthält action/id aus der URL
        },
        'post_callback' => static function (object $user, array $params): void {
            // optional: POST-Verarbeitung (eigenes CSRF-Token prüfen!)
        },
    ]);
});

• Aufruf: /member/plugin/meine-buchungen[/<aktion>[/<id>]]; die Aktion steht in $_GET['action'], die numerische ID in $_GET['id'].
• Unterbereiche über parent_slug erscheinen nicht als eigene Dashboard-Kachel.
• dashboard_widget => false blendet die Kachel aus; die Sichtbarkeit lässt sich zusätzlich im Admin unter Mitglieder-Dashboard → Plugin-Widgets steuern (Option member_dashboard_plugin_<plugin>, Reihenfolge member_dashboard_plugin_order).
• Fehler im stats_callback werden ignoriert; die Kachel bleibt sichtbar.
• Achtung Capability: außer null und 'admin' werden andere Werte derzeit als „erlaubt“ gewertet. Feinere Rechte prüft das Plugin im Callback selbst (Auth::instance()->hasCapability(...)).

Filter#

Admin-Konfiguration aller Dashboard-Optionen: ../admin/member/README.md.