Plugins für WordPress CMS
BSoft :: Herrnhuter Losungen
Die täglichen Losungen und Lehrtexte der Herrnhuter Brüdergemeine können mit diesem Plugin als Shortcode oder Widget angezeigt werden. Das Layout kann in vielfältiger Weise auf das Erscheinungsbild der Website abgestimmt werden. Dabei können eigene CSS-Dateien außerhalb der Plugin-Struktur abgespeichert werden; diese Daten bleiben bei Updates von Plugin oder Theme erhalten.
Diese Einstellungen sind im Admin-Dashboard für Benutzer mit ausreichenden Zugriffsberechtigungen zugänglich. Im Dashboard-Menü am linken Bildschirmrand befindet sich nach erfolgreicher Installation der Menüpunkt „Herrnhuter Losungen“. Diese Einstellungen gelten für alle Aufrufe des Plugins über den Shortcode, können aber dort überschrieben werden. Sie gelten nicht für Widgets.
Abschnitt „Datenquelle“
Die Eingabefelder „URL des Download-Verzeichnisses“ und „Name der Archivdatei“ sind mit den gültigen Werten vorbelegt. Tragen Sie in diesen Feldern nichts ein, sofern Sie nicht ausdrücklich zu einer Eingabe in einem der beiden Felder aufgefordert werden. Der Name der Archivdatei ändert sich automatisch mit jedem Jahr.
Die automatische Datenaktualisierung kann in den Monaten Oktober, November oder Dezember aktiviert werden. Beginnend vom ausgewählten Monat versucht das Plugin in einem wöchentlichen Rhythmus, die Archivdatei des Folgejahres herunter zu laden. Nach einem erfolgreichen Downloadversuch schaltet sich die Automatik für das betreffende Jahr ab.
Abschnitt „Quellen für weitere Informationen“
Die Website bibleserver.com des ERF Wetzlar bietet die Möglichkeit, den Kontext der Losung oder des Lehrtextes zu entdecken. Sie können zwischen 13 Bibelausgaben wählen. Vorbelegt ist die Lutherbibel 2017.
Beachten Sie, dass die Wahl der Bibelausgabe keinen Einfluss auf die angezeigten Losungen und Lehrtexte hat, sondern sich nur auf den angezeigten Kontext bei bibleserver.com bezieht.
Abschnitt „Layout-Einstellungen“
„Liturgische Farben verwenden“: Um die Option „Grafische Elemente“ verwenden zu können, muss ein Satz passender Bilddateien im Verzeichnis uploads/bshl-mottos/images vorhanden sein. Die Dateinamen müssen wie folgt aufgebaut sein: „bg<Farbcode>.png“, wobei <Farbcode> einer der folgenden fünf Hexcodes ist (die tatsächlich verwendete Farbe darf natürlich in Nuancen abweichen):
000000 (schwarz), 1FB53D (grün), A61FB5 (violett), B22D00 (rot), FFFFFF (weiß).
Die Dateien werden in der unteren rechten Ecke des Plugins angezeigt. Eine passende Dateigröße ist etwa 300 x 150 px (96 dpi). Ein Beispiel-Datensatz steht im Downloadbereich zum Herunterladen und freien Verwendung zur Verfügung.
„Benutzerdefinierte CSS-Klasse“: Wenn in diesem Eingabefeld eine CSS-Klasse angegeben wird, dann deaktiviert das die Standardklassen „bshl-title“ und „bshl-container“. Sie müssen dann einen kompletten Satz der benötigten CSS-Anweisungen selbst erstellen. Das kann sinnvoll sein, wenn Sie ein völlig anderes Aussehen des Plugins erzeugen möchten.
Sie können die CSS-Deklarationen aber auch in der Theme-Datei oder – falls der Pagebuilder das zulässt – auf Seitenebene definieren. Wenn Sie das Standardlayout nur punktuell ändern möchten, ist das die bessere Alternative.
Ihre eigene CSS-Datei, die die Anweisungen für die in diesem Eingabefeld angegebene Klasse enthält, muss sich in dem Verzeichnis uploads/bshl-mottos/css befinden. Die Bezeichnung der Datei ist frei wählbar; die Dateiendung muss .css sein. Wenn beim Start des Plugins festgestellt wird, dass sich in dem Verzeichnis eine CSS-Datei befindet, dann wird diese anstelle der Standard-CSS-Datei, die mit dem Plugin geliefert wird, geladen.
| [bshl_motto] | |||
| Mit diesem Shortcode werden die Herrnhuter Losungen für den aktuellen Tag angezeigt. Das Layout wird zunächst mit den Plugin-Einstellungen festgelegt („Herrnhuter Losungen“ im Seitenmenü); alle hier aufgeführten Attribute können aber zusätzlich im Shortcode geändert werden. |
|||
| Ausgabe von: Titel (optional) – Datum (optional) – Losungen und Lehrtexte mit Bibelstellen – Bibelstellen als Links zu bibleserver.com (optional) - Copyrightangaben | |||
| Attribut: | Datentyp: | Standard: | Zweck: |
title | String | „Die Losung des Tages“ | Titelzeile des Shortcodes |
showtitle | String | „Y“ | „Y“ - Titel wird angezeigt „N“ - Titel wird nicht angezeigt |
showdate | String | „Y“ | „Y“ - Datum wird angezeigt „N“ - Datum wird nicht angezeigt |
showlink | String | „Y“ | „Y“ - Link zu bibleserver.com wird angezeigt „N“ - Link wird nicht angezeigt |
source | String | „LUT“ | Bezeichnung der verwendeten Bibelausgabe auf bibleserver.com „DBU“ – Das Buch „EU“ – Einheitsübersetzung 2016 „ELB“ – Elberfelder Bibel „GNB“ – Gute Nachricht Bibel 2018 „HFA“ – Hoffnung für alle „LUT“ – Lutherbibel 2017 „MENG“ – Menge Bibel „NeÜ“ – Neue evangelistische Übersetzung „NGÜ“ – Neue Genfer Übersetzung „NLB“ – Neues Leben. Die Bibel „SLT“ – Schlachter 2000 „VXB“ – VOLXBIBEL „ZB“ – Zürcher Bibel |
cssclass | String | „“ | Bezeichnung einer eigenen CSS-Klasse |
usecolours | String | „N“ | „B“ – Hintergrundfarben und farbige Balken an der linken Textseite verwenden „C“ – Hintergrundfarben verwenden „G“ – Grafische Elemente verwenden „N“ – Liturgische Farben werden nicht verwendet |
darkmode | String | „N“ | „Y“ – Darkmode-Modus ist aktiviert „N“ – Darkmode-Modus ist deaktiviert |
Widget-Name: „BSoft :: Die Losungen“
Die Setup-Optionen ähneln den Plugin-Einstellungen, die bei Verwendung des Shortcodes Anwendung finden, sind aber davon völlig unabhängig. Die meisten Optionen sind selbsterklärend.
„Theme-Einstellungen anwenden“: Manche Themes haben Standard-CSS-Einstellungen, die das Layout des Widgets als Ganzes betreffen. Manchmal kann dies unerwünschte Auswirkungen haben. Durch Deaktivierung dieser Option werden die Standardeinstellungen des Themes für diese Widgetinstanz abgeschaltet.
„Benutzerdefinierte CSS-Klasse“: Wenn hier eine CSS-Klasse angegeben wird, dann deaktiviert das die Standardklassen „bhl-title“ und „bhl-container“.
„Liturgische Farben verwenden“: Wenn diese Option aktiviert ist, wird dem Widget ein angedeuteter farblicher Hintergrund in der unteren rechten Ecke hinzugefügt. Die Farbe entspricht der liturgischen Farbe für den jeweiligen Tag.
Ausgabe: Titel (optional) – Datum (optional) – Losungen mit Bibelstellen – Bibelstellen als Links zu bibleserver.com (optional) – Copyrightangaben
BSoft :: Herrnhuter Losungen
Woher kommen die Daten für die Losungen und Lehrtexte?
Die Daten werden von der Herrnhuter Brüdergemeine kostenlos zur Verfügung gestellt. Dieses Plugin lädt bei der Installation automatisch die Daten für das aktuelle Jahr von dort herunter und bereitet sie auf. Das Plugin funktioniert also „out of the box“.
Wie komme ich an die Texte für die nächsten Jahre?
In den Plugin-Einstellungen können Sie die Daten entweder manuell von der Website der Herrnhuter Brüdergemeine herunterladen, oder Sie können dort die automatische Downloadfunktion des Plugins aktivieren.
Beachten Sie bitte, dass die Daten für das Folgejahr gewöhnlich erst im Spätherbst verfügbar sind.
Was kostet die Nutzung des Plugins?
Die Nutzung des Plugins wie auch der zugrunde liegenden Daten ist kostenlos.
Gibt es die Losungstexte auch in anderen Sprachen?
Die Texte sind grundsätzlich auch in englischer Sprache verfügbar. Die Herrnhuter Brüdergemeine kann diese Daten aber aus lizenzrechtlichen Gründen nicht anbieten.
Aktuell ist nicht beabsichtigt, die englischsprachigen Daten in das Plugin zu implementieren.
Beinhaltet das Plugin alle Texte aus dem Losungsbuch?
Die Daten, die von der Herrnhuter Brüdergemeine zur Verfügung gestellt werden, umfassen den Losungsvers (Altes Testament) und den Lehrtext (Neues Testament) mit den entsprechenden Angaben der Bibelstellen. Die Wochentage und Sonntagsbezeichnungen sind ebenfalls in den Datensätzen vorhanden.
Aus lizenzrechtlichen Gründen können jedoch die im Losungsbuch veröffentlichten dritten Texte (Liedverse, Gebete), die den beiden Bibeltexten zugeordnet sind, nicht angeboten werden.
Was ist der „Darkmode-Modus“?
Manche Pagebuilder bieten eine Möglichkeit zur Auswahl eines hellen oder dunklen Textmodus an. Dabei kann es aber sein, dass bestimmte Elemente (wie z.B. Links) farblich nicht berücksichtigt werden. Der Modus „Darkmode“ ist eine Hilfe, dieses Problem durch eine zusätzliche CSS-Klasse „darkmode“ zu lösen.
Mindestanforderungen
- WordPress Version 6
- PHP Version 7.4
- MySQL Version 8 oder MariaDB Version 10
Automatische Installation
- Laden Sie das Plugin von hier herunter.
- Melden Sie sich bei Ihrem WordPress-Dashboard an.
- Navigieren Sie zum Menü „Plugins“, klicken Sie auf „Plugin hinzufügen“ und dann auf „Plugin hochladen“.
Laden Sie das vorher von hier heruntergeladene Archiv hoch, und klicken Sie anschließend auf „Jetzt installieren“ – WordPress übernimmt den Rest.
Manuelle Installation
Bei der manuellen Installation müssen Sie das Plugin von hier herunterladen und über Ihr FTP-Programm auf Ihren Webserver hochladen. Eine Anleitung dazu finden Sie hier im WordPress-Codex.
Für neue Installationen verwenden Sie bitte nur die jeweils aktuellste Version.
.zip-Dateien zum Herunterladen und Installieren:
Optionale Hintergrundgrafiken
Wichtiger Hinweis:
Dieses Plugin ist nicht im WordPress-Plugin-Verzeichnis zu finden. Deshalb gibt es auch keine automatischen Benachrichtigungen über Updates.
Wenn Sie das Plugin nutzen, empfehlen wir Ihnen deshalb dringend, sich auf unserer Supportliste eintragen zu lassen. Schreiben Sie uns eine kurze E-Mail, und wir erledigen den Rest.
Unsere Entwicklungen