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 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



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

screenshot
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:
screenshot
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
screenshot
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
 

<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.

screenshot
Fertige Anzeige im Forum



Du willst es noch genauer wissen?
Weiter geht's im zweiten Teil des Tutorials:
Hinweis





Login
Activity Feed
forum_message forum_message
Mike48 und spotter46 haben 2 neue Beiträge im Thema Zugang Wiki begrenzen geschrieben.
Das Plugin funktioniert leider schon lange nicht mehr. Es arbeitet mit Action Elemente und die sind von Miranus abgeschaltet.
rating rating
m3ontour und spotter46 haben sich bedankt!
Beitrag: Zugang Wiki begrenzen
%usernames% haben sich bedankt!
forum_message forum_message
Ingmar und m3ontour haben 2 neue Beiträge im Thema Zugang Wiki begrenzen geschrieben.
Zitat von m3ontour im Beitrag #3Das ist ja aber nicht Sinn der Sache. Dieser Zustand soll ja Beitrags- und Beteiligungsabhängig sein!Naja dann musst du eben eine Beitrags- und Beteiligungsabhängige Gruppe erstellen.Automatisiert geht das zwar nicht. Aber du kannst natürlich alle Mitglieder, die eine...
forum_message forum_message
spotter46 hat einen neuen Beitrag im Thema Zugang Wiki begrenzen geschrieben.
Wo liegt das Problem ?Du kannst doch, wie in fast allen Bereichen, entsprechende Rechte vergeben. Die "Absauger" einfach in eine besondere Gruppe packen und dieser Gruppe nur eingeschränkte Rechte zuteilen.Geht auch im WIKI[[File:Wiki-Rechte.jpg|none|auto]]
forum_topic forum_topic
m3ontour hat das Thema Zugang Wiki begrenzen erstellt
Hallo,ich habe mal wieder ein Problemchen.Wir haben im Wiki einen Datenpool angelegt.Gibt es die Möglichkeit den Zugang zu diesem Datenpool erst zu erlauben wenn sich das Mitglied aktiv am Forum beteiligt?Also z.B. wenn er 20 Beiträge geschrieben hat, oder so etwas in der Art.In diesem Datenpool sin...
rating rating
spotter46 hat sich bedankt!
Beitrag: Beiträge schreiben
%usernames% hat sich bedankt!
rating rating
Ingmar hat sich bedankt!
Beitrag: E-Mail abgelehnt wegen fehlender DKIM Signatur
%usernames% hat sich bedankt!
forum_message forum_message
m3ontour hat einen neuen Beitrag im Thema Beiträge schreiben geschrieben.
Hallo,vielen Dank. Mit Ruhe hab ich es jetzt gefunden,Zwischen Tür und Angel sollte man auch nicht wegen so etwas agieren.Danke
rating rating
m3ontour hat sich bedankt!
Beitrag: Beiträge schreiben
%usernames% hat sich bedankt!
forum_message forum_message
Mike48 und Ingmar haben 3 neue Beiträge im Thema E-Mail abgelehnt wegen fehlender DKIM Signatur geschrieben.
Feed Mails. Neuigkeiten aus dem Forum sind wahrscheinlich die Mails, die die User in ihrem Profi einstellen können.
forum_message forum_message
spotter46 und m3ontour haben 2 neue Beiträge im Thema Beiträge schreiben geschrieben.
Zitat von spotter46 im Beitrag #3Bitte sorgfältig lesen und die Einstellungen nach Wunsch verändern - neue Administration verwendenSicherheit in Foren - Forum Update für besseren Schutz vor SpamIm Adminbereich auf Benutzer > Gruppen dann nach und nach jede Gruppe anklicken, etwas runterscrollen und ...
rating rating
catwiesel und Wolfgang haben sich bedankt!
Beitrag: Favicon nur bei Xobor-Homepage?
%usernames% haben sich bedankt!
rating rating
Kipper-Spedition hat sich bedankt!
Beitrag: YouTube "Shorts" einbetten
%usernames% hat sich bedankt!
rating rating
Kipper-Spedition und Wolfgang haben sich bedankt!
Beitrag: YouTube "Shorts" einbetten
%usernames% haben sich bedankt!
rating rating
Wolfgang hat sich bedankt!
Beitrag: Grafischer Fehler unterhalb einer Infobox.
%usernames% hat sich bedankt!
forum_message forum_message
Ingmar und pasdoe haben 9 neue Beiträge im Thema Favicon nur bei Xobor-Homepage? geschrieben.
Ich habe gerade gemerkt, dass in der mobilen Version die Standard-Icons verwendet werden, wenn kein V6 Template aktiv ist. Eventuell ist das ein Problem für die Anzeige bei Google. Ich versuche das morgen zu beheben.
forum_message forum_message
Mike48 und Muenggi haben 3 neue Beiträge im Thema Portal mittlere Box geschrieben.
Bastelbinchen in der Überschrift aber bitte mit ie schreiben.
forum_topic forum_topic
Muenggi hat das Thema Portal mittlere Box erstellt
Ich richte mein Forum neu ein und wollte das Bild in der mittleren Portal-Box auswechseln.Irgend etwas ist falsch gelaufen, der grüne Balken ist weg.Sieht jetzt so aus.
forum_message forum_message
Wolfgang, Ingmar und l2otbart_57 haben 4 neue Beiträge im Thema YouTube "Shorts" einbetten geschrieben.
Hallo Ingmar,wow, super und ein großes Dankeschön! Die Shorts werden so auch in der richtigen Größe angezeigt, ohne Rahmen, gut für die mobile Ansicht, denke ich...**************Der "Embed-Code" taucht nur beim Rechtsklick und "Einbettungscode kopieren" auf!Wenn man sich den Embed-Code herauskopiert...
rating rating
Jaden hat sich bedankt!
Beitrag: Keine Rückmeldungen auf Anfrage per E-Mail
%usernames% hat sich bedankt!
rating rating
Wolfgang hat sich bedankt!
Beitrag: YouTube "Shorts" einbetten
%usernames% hat sich bedankt!
rating rating
Gabriella hat sich bedankt!
Beitrag: YouTube "Shorts" einbetten
%usernames% hat sich bedankt!
forum_message forum_message
Wolfgang hat einen neuen Beitrag im Thema YouTube "Shorts" einbetten geschrieben.
Zitat von Rika1 im Beitrag #1Die Shorts (Kurzvideos) kann man nicht wie die sonstigen Videos einbetten.Vielleicht könnt Ihr das mal ändern, das man sie wie die Videos über die Iconbar einfügen kann in einen Beitrag.Hallo zusammen,vielleicht habe ich da etwas, um das Umbenennen einzusparen.Besser wär...
rating rating
Gabriella und spotter46 haben sich bedankt!
Beitrag: Facebook Videos über Video-Tag einbinden?
%usernames% haben sich bedankt!
rating rating
Gabriella und Portaljäger haben sich bedankt!
Beitrag: V6 - Kein Mail Benachrichtung bei Mitglied sperren
%usernames% haben sich bedankt!
forum_message forum_message
pasdoe, balea und Ingmar haben 4 neue Beiträge im Thema Favicon nur bei Xobor-Homepage? geschrieben.
Zitat von Ingmar im Beitrag #13Zitat von balea im Beitrag #12Bei uns wird auch das Xobor Logo bei Google angezeigt. Wir haben ein .png Foto hochgeladen. Bei .jpeg das gleicheIhr habt das Template-Element "Obere Leiste" verändert und nicht aktualisiert. So kann das nicht klappen...Servus! Ich habe da...
forum_message forum_message
Ingmar und Jaden haben 4 neue Beiträge im Thema Keine Rückmeldungen auf Anfrage per E-Mail geschrieben.
Zitat von Jaden im Beitrag #15Hallo Ingmar,dann weiß ich Bescheid, hatte mich schon gewundert, denn es ist nichts angekommen.Sorry dafür. In diesem Fall ist es besonders gemein, da die Mails irgendwo in einer Endloss-Zustellschleife hängen. Wir haben daher nicht mal eine "konnte nicht zugestellt"-Rü...
forum_message forum_message
Ludger hat einen neuen Beitrag im Thema Facebook Videos über Video-Tag einbinden? geschrieben.
auch "öffentliche" Reels lassen sich mit dem Video-Tag einbettenhttps://www.facebook.com/reel/1615823202413690so verändernhttps://www.facebook.com/watch?v=1615823202413690reel/ durchwatch?v=ersetzen
forum_message forum_message
Ingmar hat einen neuen Beitrag im Thema Grafischer Fehler unterhalb einer Infobox. geschrieben.
Zitat von Mike48 im Beitrag #5In den zweispaltigen V6 Design HPM Gaia, Zeitlos Blau hat der Aktivity Feed einen leeren Footer.Es geht dabei nicht um die Anzahl der Spalten. In diesen Design sind "abgerundete Ecken" vorgesehen. Um die Rundungen auch "unten" in der Box anzuzeigen, braucht es bisher ei...
rating rating
Mike48 hat sich bedankt!
Beitrag: E-Mail abgelehnt wegen fehlender DKIM Signatur
%usernames% hat sich bedankt!
forum_message forum_message
l2otbart_57 hat einen neuen Beitrag im Thema Plugin: showMods - zuständige Moderatoren im Thema anzeigen geschrieben.
Danke Ingmar,Plugin showMods ist online2 Werte lassen sich unabhängig voneinander konfigurieren• Icon hinter dem Namen, z.B. Flagge: 🏁 • Hintergrund des Namen: linear-gradient(to bottom, violet, transparent, transparent, purple) als Farbverlauf.mehr Beispiele https://wiki.selfhtml.org/wiki/CSS/Tut...
rating rating
Ludger hat sich bedankt!
Beitrag: YouTube "Shorts" einbetten
%usernames% hat sich bedankt!
rsummary rsummary
spotter46 und Ingmar haben 2 Beiträge bewertet (Details)
%usernames% hat sich bedankt!
rsummary rsummary
catwiesel, Wolfgang und Kipper-Spedition haben 4 Beiträge bewertet (Details)
%usernames% hat sich bedankt!
rsummary rsummary
Jaden, Wolfgang und Gabriella haben 3 Beiträge bewertet (Details)
%usernames% hat sich bedankt!
rsummary rsummary
Gabriella, spotter46 und Portaljäger haben 2 Beiträge bewertet (Details)
%usernames% haben sich bedankt!
Wer ist Online?
1 Mitglied und 53 Gäste sind Online
Besucher Statistiken
54 Aktive User
1 Mitglied und 53 Gäste sind Online:
Johannes

Heute waren Online
balea, Ingmar, JanB, Johannes, kacz, Moby, nobody

Besucherrekord
1274 Benutzer gleichzeitig online (11.10.2019 18:19)

Besucherzähler
Heute waren 513 Gäste und 7 Mitglieder, gestern 2215 Gäste und 22 Mitglieder online.

Statistiken
Themen 42011
Beiträge 307696
Mitglieder 12.584
Forum empfehlen