Plugin Tutorial für Einsteiger - 1.1 Positionierung des Plugins

Hallo Welt - 1.1 Positionierung des Plugins

In diesem Tutorial beschreiben wir verschiedene Möglichkeiten festzulegen, wo ein Plugin im Forum sichtbar werden soll.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




Plugin Hallo Welt - Positionen



Beschreibung


In diesem Tutorial sollen die verschiedenen Positionierungsmöglichkeiten erlernt werden.
Dazu werden verschiedene Template-Elemente angelegt, die an unterscheidlichen Stellen angezeigt werden.

Allgemeines


Beim Anlegen eines Plugin-Template-Elements muss immer ein zugehöriges Foren-Template bestimmt werden.
Immer dann, wenn das Foren-Template geladen wird, wir später auch das Plugin angezeigt.

Eine Foren-Seite besteht in der Regel aus drei Template-Elementen

Kopfzeile
In der Kopfzeile befinden sich der Foren-Header und das Menü. Sie ist auf jeder Seite des Forums identisch. Das verwendete Template Element heißt obere Leiste

Hauptbereich
Dieser Bereich ist auf jeder Seite unterschiedlich. Auf der Startseite wird z.B. das Template-Element Forum Übersicht geladen. In der Themen-Ansicht das Template-Element Thread Flat
Es kann auch vorkommen, dass im Hauptbereich mehrere Template-Elemente geladen werden. So gibt es z.b. ein Template Element Umfragen welches bei Bedarf von anderen Template-Elementen eingebunden wird.

Fußzeile
Auch dieser Teil ist auf jeder Seite des Forums identisch. Er enthält i.d.R. die Fußzeile und die Links zur Mitgliederliste und FAQ. Das Verwendete Template Element lautet Untere Leiste


Für die Anzeige von Plugin-Elementen bedeutet das also folgendes:
Soll ein Plugin-Template auf jeder Seite des Forums ausgeführt werden, macht es Sinn, es den Template Elementen obere Leiste oder untere Leiste zuzuordnen, da nur diese Elemente überall angezeigt werden.
Soll ein Plugin dagegen auf bestimmten Seiten des Forums angezeigt werden, muss das Plugin-Element dem entsprechenden Template-Element zugeordnet sein. Ein Plugin, welches neben Beiträgen zusätzliche Informationen anzeigt wird also dem Element Thread Flat zugeordnet.

Platzierung innerhalb des zugeordneten Templates


ist das passende Template-Element erst einmal gefunden muss man sich entscheiden, wo genau das Plugin-Template angezeigt werden soll.
Dabei stehen drei Optionen zur Auswahl:

Header
Das Plugin-Template wird VOR dem zugeordneten Foren-Template geladen

Footer
Das Plugin-Template wird NACH dem zugeordneten Foren-Template geladen

Inline-Element
Das Plugin-Template wird INNERHALB des zugeordneten Foren-Template geladen.
Diese Einstellung ermöglicht es, auch komplexere Plugin-Aufgaben zu realisieren. Das Plugin-Template wird dabei einer bestimmmten Markierung innerhalb des Foren-Templates zugeordnet.
Immer, wenn diese Markierung erreicht wird, wird auch das Plugin-template geladen. So kann ein und das selbe Plugin-Element auch innerhalb von Schleifen (z.B. nach jedem Beitrag) ausgeführt werden.

Sobald ein zugehöriges Plugin-Element gewählt wird, aktualisiert sich die Liste der vorhandenen Markierungen automatisch.


Wenn ein Plugin in einem Forum mit veränderten Templates nicht funktioniert, fehlt eventuell einfach nur die entsprechende Markierung im Template. Prüfen Sie in diesem Fall über die Template-entwiklcung, ob alle Markierungen vorhanden sind.
Eine Markierung wird immer mit der Template-Funktion {{tick(markierungsname)}} erzeugt: z.B {{tick(userinfobox_start)}} markiert die Stelle im quellcode vor den Benutzerinformationen neben dem Beitrag
Hinweis



Beispiele


Wir wollen für das "Hallo Welt" Plugin einige Template-Elemente anlegen um die verschiedenen Positionierungen zu testen.

Wir legen dafür drei neue Template-Elemente an:


Feldname Wert
Template Obere Leiste
Ausführung Header
Template-Name test_oben



Feldname Wert
Template Untere Leiste
Ausführung Footer
Template-Name test_unten



Feldname Wert
Template Thread Flat
Ausführung Inline Element
Element thread_after_message
Template-Name test_beitrag


Inhalt
Die neuen Elemente müssen wir nun noch mit Inhalten befüllen. Da es hier nicht um die Funktionalität, sondern nur um das Verständnis der Anzeige geht reichen uns einfache Textausgaben:

Inhalt für das Element test_oben

1
2
3
4
 

Hallo, ich werde vom Plugin auf JEDER Seite des Forums ÜBER der Kopfzeile angezeigt
Einstellungen: Element obere_leiste, Ausführung im header (also vor dem Element)
 
 



Inhalt für das Element test_unten

1
2
3
4
 

Hallo, ich werde vom Plugin auf JEDER Seite des Forums UNTER der Kopfzeile angezeigt
Einstellungen: Element untere_leiste, Ausführung im footer (also nach dem Element)
 
 



Inhalt für das Element test_beitrag

1
2
3
 

Hallo, ich werde vom Plugin immer nach jedem Beitrag auf einer Seite ausgeführt.
Einstellungen: Element thread_flat, Ausführung im Inline-Element thread_after_message (also immer nach jeder Nachricht)
 



Wird die Einstellung "Inline Element" gewählt, zeigt das System automatisch eine Liste der verfügbaren Markeirungen im ausgewählten Foren-Template-Element angezeigt.
Wichtig: Nicht alle Markierungen sind auch in allen Templates (gaia/Standard usw...) vorhanden. Soll ein Plugin in allen Templates funktionieren, muss entsprechend eine Markierung gewählt werden, die auch in allen Templates vorhanden ist.
Hinweis


Testen


jetzt können wir überprüfen, ob alles richtig angezeigt wird.

screenshot
Anzeige des Elementes test_oben

screenshot
Anzeige des Elementes test_unten

screenshot
Anzeige des Elementes test_beitrag. Durch die Einstellung "Inline-Thread after Message" wird das Template nach JEDEM Beitrag ausgeführt.



Elemente löschen


Dieses Tutorial diente nur der Vertiefung des Verständnisses der Positionierung vom Plugin-Template-Elementen. Die angelegten Elemente samt der zugehörigen Seiten können jetzt wieder gelöscht werden.
Dazu löschen wir zunächst die Zuordnungen, welche festlegen welche Pllugin-Elemente bei welchen Foren-Elementen ausgeführt werden:
screenshot
Pages Elemente löschen.


Dann löschen wir die eigentlichen Plugin-Elemente:
screenshot
Plugin Templates löschen.



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





Login
Activity Feed
rating rating
Bussinchen hat sich bedankt!
Beitrag: Großes Lob an das Xobor-Team
%usernames% hat sich bedankt!
forum_message forum_message
Bussinchen, l2otbart_57 und Mike48 haben 13 neue Beiträge im Thema Forum für Persisch - per CSS formatieren geschrieben.
Jetzt habe ich das Script von https://test-2022.xobor.de/t119f21317-ke...rtl.html#msg576 kopiert und in meine Kopfzeile eingefügt. Ergebnis:Im Editiermodus werden die persische Threadüberschrift und der persische Text im Texteingabefeld nun RTL und rechtsbündig angezeigt. Im Editiermodus wird auch e...
forum_message forum_message
spotter46 und Mike48 haben 3 neue Beiträge im Thema Bildergalerie - verlinken geschrieben.
@Mike48 Hallo Mike,im Template V6 gibt's die Option "verlinken" nicht, nur in den Templates V1 bis V4.Da die Mobilansicht der letztgenannten Templates quasi dem Template V6 entspricht, vermute ich, dass dies die Ursache ist, dass mobil die Verlinkungen nicht angezeigt werden.Ingmar hat ja in Beitrag...
rsummary rsummary
Bussinchen hat 2 Beiträge bewertet (Details)
%usernames% hat sich bedankt!
rating rating
Bussinchen hat sich bedankt!
Beitrag: Forum für Persisch - per CSS formatieren
%usernames% hat sich bedankt!
rating rating
Bussinchen hat sich bedankt!
Beitrag: Forum für Persisch - per CSS formatieren
%usernames% hat sich bedankt!
forum_message forum_message
Mike48, Olaf und Ingmar haben 3 neue Beiträge im Thema Im Plugin "eigene Seite" können Variablen nicht bearbeitet werden geschrieben.
Die eigene Seite im Plugin ohne Kopf- und Fußzeile ist ja ein leeres Blatt Papier. Einzig die Dateierweiterung .html ziegt, dass es sich um eine HTML Seite handeln soll. Keine Ahnung warum du ohne Kopf- und Fußzeile die Seite anlegst. Ich machte das bisher immer mit Kopf-, Fußzeile und Navi. Ich hab...
forum_message forum_message
Bussinchen hat einen neuen Beitrag im Thema Danke Ingmar von Herzen Meine Idee und Umsetzung geschrieben.
Na da bin ich ja gespannt zu erfahren, worum es hier geht!
rsummary rsummary
Bussinchen und 5 weitere haben 7 Beiträge bewertet (Details)
%usernames% haben sich bedankt!
rating rating
Bussinchen hat sich bedankt!
Beitrag: Danke Ingmar von Herzen Meine Idee und Umsetzung
%usernames% hat sich bedankt!
rating rating
Bussinchen hat sich bedankt!
Beitrag: Danke Ingmar von Herzen Meine Idee und Umsetzung
%usernames% hat sich bedankt!
rating rating
Bussinchen hat sich bedankt!
Beitrag: Danke Ingmar von Herzen Meine Idee und Umsetzung
%usernames% hat sich bedankt!
rating rating
Bussinchen hat sich bedankt!
Beitrag: Danke Ingmar von Herzen Meine Idee und Umsetzung
%usernames% hat sich bedankt!
rating rating
Bussinchen hat sich bedankt!
Beitrag: Forum für Persisch - per CSS formatieren
%usernames% hat sich bedankt!
rating rating
Bussinchen hat sich bedankt!
Beitrag: Forum für Persisch - per CSS formatieren
%usernames% hat sich bedankt!
rating rating
Katja23101971 und 4 weitere haben sich bedankt!
Beitrag: Ich mag kein Ideenklau respektive Urheberrecht !
%usernames% haben sich bedankt!
forum_message forum_message
Ingmar hat einen neuen Beitrag im Thema Ich mag kein Ideenklau respektive Urheberrecht ! geschrieben.
Hey @cleo Auch wenn ich gut nachvollziehen kann, dass du das Bedürfnis hast die Sache zu "klären" würde ich euch bitten, das in privaten Mails zu erledigen. Es handelt sich hier offensichtlich um privaten Ärger, der nichts mit unserer Forensoftware zu tun hat. Ich bitte um Verständnis, dass das Supp...
forum_message forum_message
l2otbart_57 und 1 weitere haben 3 neue Beiträge im Thema Forum für Persisch - per CSS formatieren geschrieben.
Auf der Hauptseite greift doch dein CSS für die Kategorien[[File:rtl_1.png|none|fullsize]]aber diese Sektoren greifen nicht: 123 .postbody,#forumid-28390 .threadtitle,#forumid-28390 .topic {..} nehme an, sie sollten in der Forumansicht und Threadansicht wirkenich würde es definieren: 123456789 body....
forum_topic forum_topic
Hallöchen wie fasse ich das jetzt zusammen um niemand auf die Füße zu treten und noch mit Respekt zu begegnen ? Frau..Du warst bei mir Co Admin. Unsere Wege haben sich getrennt. Habe Dir nahegelegt mach ein eigenes Forum mit Premium bei Xobor Miranus. Das hast Du jetzt getan. Du hast mein Wortlaut ...
rating rating
BeaBielecki hat sich bedankt!
Beitrag: Großes Lob an das Xobor-Team
%usernames% hat sich bedankt!
forum_topic forum_topic
Bussinchen hat das Thema Forum für Persisch - per CSS formatieren erstellt
Hallo allerseits!Ich habe mir ein neues Forum mit dem Business Template (v4) zugelegt, in dem sowohl auf Englisch als auch auf Persisch geschrieben werden soll. Ich habe eine Kategorie angelegt, wo in den dort angelegten Foren und den verschiedenen Threads nur auf Persisch geschrieben wird bzw. werd...
forum_message forum_message
l2otbart_57 und 3 weitere haben 10 neue Beiträge im Thema Im Plugin "eigene Seite" können Variablen nicht bearbeitet werden geschrieben.
Zitat von Mike48 im Beitrag #9Zitat von l2otbart_57 im Beitrag #6um die Bibliotheken mache ich mi gar keine Gedanken.Musst du aber wenn du die Seite ohne Kopf- Fußzeile einrichtest. Vielleicht reicht die Fußzeile.Ich habe meine leere Seite z. B. als game.js gespeichert. Die enthält dann meine Funkti...
rating rating
Ludger und 3 weitere haben sich bedankt!
Beitrag: Wann wird sich mal mit den Plugins in der neuen Admin beschäftigt
%usernames% haben sich bedankt!
forum_message forum_message
Diese Fehlermeldung ist schon 3 Monate her.Ist jetzt auch nicht sooooo wichtig,aber es ist ein Fehler.Die Bilder fliegen immer noch von einer Seite zur anderen,ohne das ich sie mir ansehen kann.Gut zu sehen in meinem Plugin "Kalenderfarben ändern".GrußOlaf
forum_topic forum_topic
Die Konfigurations Einstellungen in der neuen Admin sehen furschtbar aus. Die einzelnen Einstellungen in einem Plugin sind nicht durch eine Linie getrennt. Sehr unübersichtlich.In Plugin Home sind so viele Plugins gelistet dass man Mühe hat, an die Liste der installierten zu kommen. Die Seite Plugin...
forum_message forum_message
Ingmar hat einen neuen Beitrag im Thema Spendenbox wird auch bei Ziel 0 angezeigt geschrieben.
Ich glaube die einstellung greift nur, wenn das Ziel mehr als 0 euro sind.Du kannst nebenan einstellungen, welche gruppen die box sehen sollen (oder auch nicht sehen sollen)
forum_topic forum_topic
quiclic hat das Thema Spendenbox wird auch bei Ziel 0 angezeigt erstellt
Hi,bei uns (untis-anwender.at) wird die Spendenbox derzeit angezeigt, obwohl unser Spendenziel 0 € ist und das Konto auch auf 0 € ist. Die Einstellungen sind:[[File:Forenkonto Null.png|none|auto]]Eigentlich möchte ich die Box erst wieder im Herbst anzeigen (unsere Rechnung kommt im Januar). Was tun?...
forum_message forum_message
Rika1 und 1 weitere haben 9 neue Beiträge im Thema Favicon wird nicht angezeigt geschrieben.
Favicon nur in der Browser-Favoriten-Leiste oben. Ganz oben in der Browseranzeige nicht.
forum_topic forum_topic
Ich weiß nicht genau ob es ein Bug ist oder ob es mit Absicht so gewollt ist.Wenn ich im Plugin eine "eigene Seite" anlege und dort eine Globale Variable oder eine Konfigurationsvariable erstelle,dann kann ich sie weder beschreiben noch lesen.Aber andersherum frage ich mich dann,wieso man die Variab...
rsummary rsummary
l2otbart_57 und 2 weitere haben 6 Beiträge bewertet (Details)
%usernames% hat sich bedankt!
rating rating
l2otbart_57 hat sich bedankt!
Beitrag: V6-Galerie: Apostroph im Bildtitel
%usernames% hat sich bedankt!
rating rating
l2otbart_57 hat sich bedankt!
Beitrag: Springt nicht zum letzten Beitrag der Seite
%usernames% hat sich bedankt!
rating rating
l2otbart_57 hat sich bedankt!
Beitrag: V6: "Das Pflichtfeld (....) muss ausgefüllt werden"
%usernames% hat sich bedankt!
rating rating
Rika1 hat sich bedankt!
Beitrag: Favicon wird nicht angezeigt
%usernames% hat sich bedankt!
rating rating
Rika1 hat sich bedankt!
Beitrag: Favicon wird nicht angezeigt
%usernames% hat sich bedankt!
rating rating
%usernames% hat sich bedankt!
forum_topic forum_topic
Rika1 hat das Thema Favicon wird nicht angezeigt erstellt
Seit heute früh wird das Favicon auf meiner Forum-Seite nicht mehr angezeigt.Woran kann das liegen?
rating rating
%usernames% hat sich bedankt!
forum_message forum_message
Ingmar und 2 weitere haben 4 neue Beiträge im Thema FAQ, Statistik, etc. in Fußzeile ausblenden. (Gaia Template v3) geschrieben.
Zitat von spotter46 im Beitrag #11Da zitieren aktuell nur sporadisch funktioniertDanke für die Erinnerung. Das sollte jetzt wieder besser klappen.Ich hatte das heutige Update hier im Forum noch nicht eingespielt.
forum_message forum_message
Marlies Stockmann und 2 weitere haben 4 neue Beiträge im Thema Zeitumstellung geschrieben.
Erst mal Dankecwerd heute um 0 Uhr sehen ob ok
Wer ist Online?
6 Mitglieder und 91 Gäste sind Online
Besucher Statistiken
97 Aktive User
6 Mitglieder und 91 Gäste sind Online:
spotter46, DoKo, Gabriella, nobody, Bussinchen, Johannes


Besucherrekord
1274 Benutzer gleichzeitig online (11.10.2019 18:19)

Besucherzähler
Heute waren 3407 Gäste und 32 Mitglieder, gestern 4662 Gäste und 36 Mitglieder online.

Statistiken
Themen 41866
Beiträge 306666
Mitglieder 12.546
Forum empfehlen