Plugin Tutorial für Einsteiger - 1.2 Konfigurations Variablen
Hallo Welt - 1.2 Konfigurations Variablen
In diesem Tutorial beschreiben wir den Weg der Plugin-Erstellung anhand eines Beispiels in verständlichen Worten und mit vielen ergänzenden Informationen. Zur Startseite des Tutorials
Allgemeiner Hinweis: Es empfiehlt sich, dieses Tutorial in einem Testforum auszuprobieren, um den laufenden Betrieb im Hauptforum nicht zu beinträchtigen. Erstellen Sie dazu einfach bei Bedarf ein neues Forum unter www.xobor.de
Hinweis
Konfigurationsvariablen für das Plugin Hallo Welt
Beschreibung
In diesem Tutorial wollen wir dem Admin die Möglichkeit geben, die Schriftgröße sowie die Ausrichtung des angezeigten Textes zu verändern.
Wie kann das funktionieren?
Über Konfigurationsvariablen, die vom Admin eingestellt werden und danach vom Plugin ausgelesen werden können.
Bedarfsanalyse
Für die Planung unseres Plugins müssen wir zunächst überlegen, welche Plugin-Elemente wir benötigen.
- Template-Elemente
- an welchen Stellen im Forum soll das Plugin später ausgeführt werden? - Konfigurations-Variablen
- welche Einstellungen soll der Admin später vornehmen können. - Daten/Globale Variablen
- welche Daten müsssen vom Plugin gespeichert werden
Plugin-Dokumentation: Übersicht der Plugin-Elemente
Plugin API
Plugin Elemente erstellen
Template-Elemente
- für diesen Teil des Tutorials benötigen wir keine zusätzlichen Template-Elemente
Konfigurations Variablen
wir benötigen 2 Einstellmöglichkeiten: Die Position und die Schriftgröße des Textes
Wir wählen also in der Plugin-Entwicklung zunächst neue Config-Variable und legen dort eine Variable mit folgenden Werten an:
Name: hallowelt_ausrichtung
Gewichtung: 1
Titel: Ausrichtung des Willlkommens-Textes
Beschreibung: Bitte wählen Sie hier die Ausrichtung des Textes (left, right oder center)
Hidden: Nein
Type: Chars
Chars: center //standardwert
Tipp: Um Probleme mit Variablen anderer Plugins zu vermeiden sollte ein eindeutiger Name vergeben werden. In diesem Fall wird einfach die PluginID und ein Unterstrich vor den eigentlichen Varablennamen hinzugefügt
Hinweis
Plugin-Dokumentation: Weitere Infos zur Erstellung einer Variablen
Plugin API
Die zweite Variable soll die Schriftgröße speichern und wird dafür mit folgenden Werten erstellt:
Name: hallowelt_schriftgroesse
Gewichtung: 2
Titel: Schriftgröße des Willlkommens-Textes
Beschreibung: Bitte geben Sie hier die gewünschte Schriftgröße ein. (z.B. 12px)
Hidden: Nein
Type: Chars
Chars: 12px //standardwert
Abbildung 1: Konfigurations-Variablen im "Plugin bearbeiten"-Modus
Zwischenergebnis:
Der Administrator kann nun in den Einstellungen des Plugin die Werte der Konfigurationsvariablen bei Bedarf anpassen:
Abbildung 2: Konfigurations-Variablen aus Sicht des Administrators
Daten/Globale Variablen
In dieser Version des Plugins werden auch keine Daten gespeichert. Es werden daher auch keine Datenvariablen benötigt.
Plugin Elemente füllen
Damit die Einstellungen des Administrators auch umgesetzt werden, müssen wir natürlich das Plugin Template "obere leiste" entsprechend bearbeiten.
Genau wie andere Template-Variablen werden Plugin-Variablen immer über doppelte geschweifte Klammern gekennzeichnet. Der Name der Variable wird dabei immer nach dem gleichen Muster erzeugt:
{{plugin_pluginid_variablentyp_variablenname}}
Auf die Konfigurationsvariable hallowelt_schriftgroesse können wir daher über folgenden aufruf zugreifen:
{{plugin_hallowelt_config_hallowelt_schriftgroesse}}
Damit man sich diese langen Variablennamen nicht merken muss gibt es eine einfache Möglichkeit, den Namen ins Template zu übernehmen.
Dazu muss man nur mit der Maus über den Text "Config Variablen" in der oberen rechten Ecke fahren - schon öffnet sich ein Fenster, welches alle Konfigurationsvariableen auflistet.
Durch einen Klick auf TPL-Insert wird der Template-Code automatisch in das Plugin-Template eingefügt.
JS-Insert erzeugt übrigens einen Javascript-Code, der die Variable per Javascript zur Laufzeit lädt. Das ist aber Teil eines anderen Tutorials
Abbildung 3: Konfigurations-Variablen einfügen
Damit die Einstellungen des Admins auch greifen übernehmen wir die Werte der Config-Variablen in den Code:
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
<div style="text-align:{{plugin_hallowelt_config_hallowelt_ausrichtung}}">
{{user_registered==true.start}}
Hallo {{user_name}}<br/>
Willkommen im Forum<br/><br/>
{{user_registered==true.else}}
Hallo lieber Besucher<br/>
Bitte <a href="/anmeldung.php">melde dich an</a>, um alle Bereiche des Forum zu sehen.<br/><br/>
{{user_registered==true.end}}
</div>
Fertig
Nun sollte auf jeder Seite des Forums ein Text ausgegeben werden.
Mitglieder werden mit ihrem Benutzernamen begrüßt, Gästen wird der Link zur Anmeldung angezeigt.
Fertige Anzeige im Forum
Du willst es noch genauer wissen?
Weiter geht's im zweiten Teil des Tutorials:
Weiter geht's im zweiten Teil des Tutorials:
Hinweis
Login
Activity Feed
Gestern 11:50
Dieter Weißbach hat das Thema Verschieben von Beiträgen an ein vorhandenes Thema - Zielthema schlecht zu finden erstellt
Hallo in die Runde,wir sind bei uns im Historischen Modellbahnforum auf ein unschönes Verhalten beim Verschieben von Beiträgen an ein vorhandenes Thema gestoßen.Zur Erläuterung:Es gibt bei uns die öffentlichen Unterforen, wo relativ unstrukturiert gepostet wird.Manchmal ist ein neues Thema so intere...
Hallo Ihr,gibt es die Möglichkeit das sich normale Mitglieder einen Textbaustein erstellen?Bitte keine Diskussion über Sinn oder Unsinn! Ein sehr aktives Mitglied bei uns möchte sich gerne ein Paar Textbausteine anlegen die er dann nach dem Einfügennur noch personalisiert.Ich habe aber keinen Plan o...
27.01.2025 16:18
Silberfischchen hat das Thema Umlaute nur von und bei einer einzige Userin als Hieroglyphen angezeigt. erstellt
Hallo, liebe Supporter.Eine Userin bei uns nickname bleutje berichtet hier inkl. Screenshots vom Problem falsch dekodierter Umlaute, was erst seit 2 oder 3 Tagen so ist und nach Aussage der Userin ausschließlich in unserem Forum auftritt. https://www.haar-hausen.de/t34f41196-Fra...0.html#msg69669Was...
Im Wike ist alles noch auf die alte Admin ausgerichtet, die Beschreibungen und die Bilder.Wenn ihr aber bald nur noch die neue Admin haben wollt, dann sollte auch möglichst bald das Wiki auch die neue Admin zeigen und beschreiben. Würde bestimmt vielen den Wechsel in die neue Admin erleichtern. Waru...
@Ingmar Es dürfte wohl kein wirklich großes Problem sein, aber vielleicht kannst du bei Gelegenheit mal kurz draufschauen. Es könnte ja auch häufiger passieren, nur bei größeren Zählerständen fällt das dann nicht mehr aufBei einem User werden 4 Beiträge laut Zähler gezeigt, in seinem Profil sind jed...
%usernames% hat sich bedankt!
%usernames% hat sich bedankt!
%usernames% hat sich bedankt!
Wer ist Online?
1 Mitglied und 10 Gäste sind OnlineBesucher Statistiken
Statistiken
Themen | 41779 |
Beiträge | 305809 |
Mitglieder | 12.472 |
Forum empfehlen