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 19:12
sikookis hat das Thema Dateisuche in den Dateianhänger nur nach Dateinamen möglich? erstellt
Board-Nr.: 779879In den Dateianhängen kann man eine Suche starten. Diese scheint aber nur für Dateinamen zu funktionieren.Jeder Dateianhang hat jedoch auch einen Titel:[[File:Dateianhang.png|none|fullsize]]Die Dateinamen sind allesamt bei mir kryptisch. Nach dem Titel zu suchen wäre wesentlich besse...
Gestern 09:05
Meikel hat das Thema Gibt es ein Red-Flag-Plugin bzw. Scan-Plugin für automatische Verwarnungen? erstellt
Hallo Team!ich bin auf der Suche nach einem Plugin in für automatische Verwarnungen. Die Idee dahinter ist, wenn ein Forenmitglied Wörter benutzt, die laut den Forenregeln nicht gestattet sind, dann sollen diese automatisch zu einer Verwarnung führen beziehungsweise gelöscht werden. Eine andere Idee...
@Ingmar Es kam eben in unserem Forum die Frage auf, weshalb plötzlich der Zugriff auf das Forum als nicht sicher angezeigt wird. Das ist seit irgendwann heute tatsächlich der Fall, egal mit welchem Browser.Ist ein Sicherheitszertifikat abgelaufen oder ist das durch ein Update von euch passiert? Auf...
%usernames% hat sich bedankt!
%usernames% hat sich bedankt!
%usernames% hat sich bedankt!
%usernames% hat sich bedankt!
Besucher Statistiken
Heute waren Online
balea, creator, Franz-Jupp, Gabriella, Hajo22, Ingmar, Johannes, kacz, Kipper-Spedition, Kräuterhexe, Lady of the light, Lobbo, m3ontour, Meikel, michaelschiller, Mike48, Nico1981, nobody, Olaf, Remember MJ, sikookis, Sternenfrau, TripleM, Wolfgang
balea, creator, Franz-Jupp, Gabriella, Hajo22, Ingmar, Johannes, kacz, Kipper-Spedition, Kräuterhexe, Lady of the light, Lobbo, m3ontour, Meikel, michaelschiller, Mike48, Nico1981, nobody, Olaf, Remember MJ, sikookis, Sternenfrau, TripleM, Wolfgang
Besucherrekord
1274 Benutzer gleichzeitig online (11.10.2019 18:19)
Besucherzähler
Heute waren 902 Gäste und 24 Mitglieder, gestern 1646 Gäste und 39 Mitglieder online.
Statistiken
Themen | 41408 |
Beiträge | 302334 |
Mitglieder | 12.393 |
Forum empfehlen