JPKCom DB
Auf GitHub ansehen (öffnet in neuem Tab)

JPKCom Bootstrap 5 Dark Mode Switch — Anleitung & Tipps

Dark-Mode-Umschalter für Bootstrap 5 per Shortcode in WordPress einbinden — Installation, Shortcode und Praxis-Tipps zu JPKCom Bootstrap 5 Dark Mode Switch.

JPKCom Bootstrap 5 Dark Mode Switch stellt den Shortcode [jpkcom-bs-dark-mode] samt JavaScript bereit, mit dem du einen Dark-Mode-Umschalter für Bootstrap 5 in deine WordPress-Seite einbaust.

Anleitung

Voraussetzungen

  • WordPress 6.9 oder neuer (getestet bis WordPress 7.1)
  • PHP 8.3 oder neuer

Installation

  1. Gehe im Admin-Bereich zu Plugins → Installieren und klicke auf Plugin hochladen.
  2. Wähle die ZIP-Datei des Plugins und klicke auf Jetzt installieren.
  3. Klicke auf Aktivieren — das Plugin wirkt sofort.

Verwendung

Setze den Shortcode an der gewünschten Stelle in deinem Inhalt oder Template ein:

[jpkcom-bs-dark-mode]

In PHP-Templates kannst du ihn über do_shortcode() ausgeben:

<?php
echo do_shortcode( '[jpkcom-bs-dark-mode]' );

Mehr zu do_shortcode() findest du in der WordPress-Funktionsreferenz (öffnet in neuem Tab).

Tipps & Tricks

  • Bootstrap 5 vorausgesetzt: Der Umschalter ist auf das Color-Mode-System von Bootstrap 5 ausgelegt — stelle sicher, dass dein Theme Bootstrap 5 lädt, damit der Dark Mode korrekt greift.
  • Im Template statt im Inhalt: Soll der Schalter fest in Header oder Footer sitzen, binde ihn per do_shortcode( '[jpkcom-bs-dark-mode]' ) direkt im Template ein, statt ihn in jeden Beitrag zu schreiben.
  • Reproduzierbare Updates: Ab Version 2.0.3 nutzt das Plugin sichere, selbst gehostete Updates über GitHub mit SHA256-Prüfsummen und arbeitet mit declare(strict_types=1). Seit 2.0.9 trägt es außerdem den Header Update URI: Die Update-Schnittstelle von wordpress.org liefert für dieses Plugin dann keine Updates mehr, ein dort veröffentlichtes Plugin mit demselben Slug kann sich also nicht als Update ausgeben. Seit 2.0.10 zeigt Dashboard → Aktualisierungen das JPKCom-Logo neben dem Plugin.
  • Updates auch im deaktivierten Zustand: Seit 2.0.11 (Updater 1.5.0) bekommt das Plugin Updates auch dann angeboten, wenn es deaktiviert ist — vorausgesetzt, ein anderes JPKCom-Plugin mit Updater 1.5.0 oder neuer ist aktiv. Dessen Updater beantwortet die Update-Abfrage für alle installierten JPKCom-Plugins, samt Update-Zeile, Icon und „Details anzeigen“, und die SHA256-Prüfung gilt genauso wie für ein aktives Plugin. Auf Multisite muss dafür mindestens ein JPKCom-Plugin netzwerkweit oder auf der Hauptseite aktiv sein. Außerdem seit 2.0.11: Die gespeicherte Update-Liste enthält keine Download-URLs von JPKCom-Plugins mehr, der Updater ergänzt sie nur, solange er geladen ist; die Prüfsumme wird auch bei einem Paket geprüft, das ein anderes Plugin liefert, und für jede GitHub-Adresse der Release-Datei. Liegt das Plugin als Git- bzw. VCS-Checkout vor, erfährst du von einem neuen Release, WordPress aktualisiert es aber nie automatisch — das Update würde den Checkout löschen. Dasselbe gilt für ein aktives Plugin in einem umbenannten Ordner; ein deaktiviertes Plugin in einem umbenannten Ordner findet der Updater gar nicht. Update-Informationen holt der Updater nur für Nutzer, die Plugins aktualisieren dürfen, im Update-Cron und in WP-CLI, nie für anonyme Besucher.

Weiterführende Informationen