Dieses einfache WordPress Plugin ist eine erweiterte Version des bekannten Plugin Hello Dolly von Matt Mullenweg. Jeder Mensch hat emotionale Bindungen zu gewissen Liedern. Und genau deswegen bringt Hello Dolly For Your Song eine zufällige Zeile des Liedtextes eines beliebigen Songs in das Blog und auf die Administrationsoberfläche. Das Plugin kann aber natürlich für jegliche Texte verwendet werden. ;-)
Funktionen
- Anzeige einer zufälligen Zeile eines Texts im Blog als Gutenberg Block
- Anzeige einer zufälligen Zeile eines Texts im Blog als Widget
- Anzeige einer zufälligen Zeile eines Texts im Blog als Shortcode
- Anzeige einer zufälligen Zeile eines Texts im Theme als Template Tag
- Anzeige einer zufälligen Zeile eines Texts in der Administration
- Unterstützung der WordPress REST API
- Hooks für Entwickler
- Einstellungsseite zur Definition eines benutzerdefinierten Text
- Integration Website-Zustand
- Versteckte Einstellungen
- Sprachen: Englisch, Deutsch, Spanisch, Französisch, Indonesisch, Russisch
Screenshots
Live Demo
Gibt es leider nicht. Probier das Plugin einfach aus! Tut auch nicht weh. Und ich habe extra eine saubere Deinstallationsroutine geschrieben, sodass keine Konfigurationsreste in deinem Blog verbleiben, falls dir das Plugin nicht gefällt. :-)
Anleitung
Installation, Konfiguration, Funktionsübersicht
Installation
Das ist total easy.
- Aus dem WordPress Directory das Plugin laden
- Plugin aktivieren
- Konfigurationsanleitung folgen
Konfiguration
Nach der Installation sind folgende Schritte erforderlich.
- Aktivierung des Plugins in den WordPress Einstellungen
- Einstellungen aufrufen, Text reinkopieren, Abspeichern, Fertig!
Frequently Asked Questions
Ich habe keinen Songtext hinterlegt, trotzdem wird etwas angezeigt.
Das ist Hello Dolly von Louis Armstrong. Wenn kein Text hinterlegt ist, benutzt das Programm den Liedtext von Hello Dolly.
In welcher Kategorie findet man den Gutenberg Block?
Der Block befindet sich in der Kategorie „Widgets“.
Wie kann man den Shortcode benutzen?
Schreibe [hdfys] in eine leere Zeile in deinen Beiträgen oder Seiten. Der Shortcode gibt einen vollständigen Absatz nach der HTML Notation aus.
Kann man das Hello Dolly For Your Song Widget mit Überschrift anzeigen?
Die Überschrift kann man in den Widget Einstellungen definieren.
Wie kann man den Zufallstext im Theme integrieren?
Benutze den Template Tag hello_dolly_for_your_song() im Quellcode des Themes.
Ich möchte nur die Anzeige im Frontend nutzen und den Text im Admin Panel ausblenden. Ist das möglich?
Für diese Anforderung kann man eine versteckte Einstellungen nutzen. Dazu setzt man die Option „hdfys_admin_lyric“ auf 0 in der Tabelle wp_options der WordPress Datenbank. Danach wird der Zufallstext im Admin-Panel ausgeblendet. Um ihn wieder einzublenden, setzt man den Wert wieder zurück auf 1.
Kann man die Elemente der Ausgabe mit benutzerspezifischem CSS versehen?
Ja, das geht. Jedes Element verfügt über einen eigenen Selektor, der über CSS ansteuerbar ist. Bitte benutze deine Debugging-Tools, um die Selektoren zu finden.
Wie kann man Hello Dolly For Your Song deinstallieren?
Das Plugin kann ganz regulär in den Einstellungen von WordPress deinstalliert werden. Nach der Deinstallation ist dein WordPress komplett sauber.
Ich habe einen Fließtext eingepflegt und jetzt ist das Admin-Layout zerrissen?
Hello Dolly For Your Song funktioniert für Texte im Stil von Gedichten. Das bedeutet, man braucht einen Text mit Zeilenumbruch nach jeder Zeile oder jedem Satz. Wenn man einen Fließtext im Plugin verwenden möchte, sollte man nach jedem Satz einen Zeilenumbruch einfügen.
Stellt das Plugin eine API bereit?
Man kann auf die zufällige Textzeile mit der Funktion get_hello_dolly_for_your_song() in anderen Plugins oder über die functions.php zugreifen. Die Funktion liefert den reinen Text ohne weiteres Markup zurück.
Unterstützt das Plugin die WordPress REST API?
Ja! :-D Man kann auf den Endpunkt über http://yourblogdomain/wp-json/restful-hello-dolly-for-your-song/text zugreifen. Der Endpunkt liefert eine zufällige Textzeile zurück. Is aba nicht wirklich REST, is nur READ.
Kann man vor dem Rendering den HTML-Output manipulieren?
Der HTML-Output des Gutenberg Blocks, des Template Tags sowie des ShortCode kann manipuliert werden. Dies funktioniert über den Filter hdfys_output_filter. Weiter unten findest du ein Code-Beispiel.
CSS-Klassen
Jedes Element auf dem User Interface kann über CSS angesteuert und formatiert werden. Nachstehend sind alle Klassen aufgeführt.
| Funktion | Element | Klasse |
|---|---|---|
| Widget | aside | widget hdfys |
| Widget | h3 | widget-title hdfys |
| Widget | p | widget-hdfys |
| Shortcode | p | hdfys shortcode |
| Template Tag | div | hdfys templatetag |
| Gutenberg Block | p | hdfys gutenberg-block |
Shortcode
[hdfys]
Template Tag
hello_dolly_for_your_song()
Getter Function
get_hello_dolly_for_your_song()
REST API Endpoint
http://yourblogdomain/wp-json/restful-hello-dolly-for-your-song/text
Actions
hdfys_new_song
Die Action wird gefeuert, sobald ein neuer Text in den Einstellungen gespeichert wurde.
Folgenden Code kannst du als Vorlage benutzen.
function hdfys_do_anything() {
// Add your code to execute here
}
add_action( 'hdfys_new_song', 'hdfys_do_anything', 10, 3 );
Filter
hdfys_output_filter
Der Filter wird vor dem Output des Gutenberg Blocks, Template Tags und Shortcode ausgeführt.
Folgenden Code kannst du als Vorlage benutzen.
function hdfys_output_manipulate( $output ) {
// Add your filter code here
// Example: $output=strtolower( $output );
return $output;
}
add_filter( 'hdfys_output_filter', 'hdfys_output_manipulate', 10, 1 );
Download
Hello Dolly for your Song @ WordPress Plugin Directory
Hello Dolly for your Song @ GitHub
Hello Dolly for your Song @ unmus
Links
Wie kommt man eigentlich auf die Idee ein so unnötiges Plugin zu schreiben?
Support
Formal wird kein Support für das Plugin angeboten. Für Hinweise und Fehlerberichte bin ich aber trotzdem sehr dankbar. Fehler bitte im Plugin Support Forum auf WordPress.org oder direkt auf GitHub berichten. Verbesserungsvorschläge und Anregungen gerne per eMail an hellodollyforyoursong@unmus.de.
Lizenz
Hello Dolly for Your Song ist Open Source und steht unter der GPLv3 Lizenz.
GitHub
circuscode/hello-dolly-for-your-song
Sprachen
Übersetzungen wurden von nachstehenden Personen bereitgestellt. Danke!
Spanisch: Andrew Kurtis von WebHostingHub
Indonesisch: Jordan Silaen von Chameleonjohn
Russisch: Petra Boppre
Changelog
Version 0.18
April 2023
- Bugfix: Leerzeichen am Ende der Textzeile entfernt
- Bugfix: Installation Process
- Changed: Seite Uploads wurde ausgeschlossen
- Others: Depreciated Authorization ersetzt
Version 0.17
Mai 2020
- Russische Übersetzung
- Bessere Code Inline Documentation
- Fehlerkorrektur: Link @ Plugin Administration
- Viele interne Verbesserungen
Version 0.16
März 2020
- Integration Website-Zustand
- Codeverbesserungen
Version 0.15
Januar 2019
- Gutenberg Unterstützung
- Aktualisierte Aktivierungskriterien
- Bugfix: Update Prozess
Version 0.14
April 2018
- Ausschluss bestimmter Admin Seiten
Version 0.13
13. Januar 2018
- Gutenberg Unterstützung
- Automatische Entfernung von Leerzeilen
- Plugin Actions
- Plugin Filters
- Codeverbesserungen
Version 0.12
16. Juli 2017
- Unterstützung der WordPress REST API
- Mehr Quellcode Kommentare, um besseres Lernen zu ermöglichen.
Version 0.11
04. April 2017
- Template Tag erfordert kein Echo-Befehl mehr
- Hello-Dolly-For-Your-Song-Getter-Function
- Neue Sprache: Indonesisch
Version 0.10
18. März 2017
- Link Einstellungen @ Plugin Page
Version 0.9
26. Dezember 2016
- Französische Sprache
- Versteckte Optionen
- Sicherheitsverbesserungen
- Codeverbesserungen
Version 0.8
1. September 2016
- Template Tag
- Neue Labels
- Codeverbesserungen
Version 0.7
27. August 2016
- Settings API
- Update Routine
Version 0.6
11. August 2014
- Spanische Sprache
Version 0.5
6. September 2013
- Shortcode
- Widget Einstellungen
Version 0.4
26. Juni 2013
- Widget
- Lokalisierung
- Deutsche Sprache
- Saubere Deinstallation
- Bugfix: Handhabung von Apostrophen in Liedtexten
Version 0.3
5. Mai 2013
- Strukturierter und lesbarer Code
- Erste veröffentlichte Version
Version 0.2
4. Mai 2013
- Lauffähige Version ohne Fehler
Version 0.1
3. Mai 2013
- Lauffähige Version