"Zitat des Tages" erzeugt einen div-Bereich, in dem ein Zitat, Spruch, Bild oder ähnliches erscheint. Dieses stammt aus einer Backend eingegebenen Liste von Sprüchen/Zitaten. Ein neues Zitat wird täglich, wöchentlich oder monatlich ausgewählt, nach Zufall oder nach vorgegebener Reihenfolge.
Die Zitate werden als Textdaten mit Auszeichnungskürzeln eingegeben, ähnlich der Texteingabe in Wikis.
quoteoftheday
die Datei script.php
für die Dateiübergabe mit dem Filebrowser (zur Vereinfachung bereits im Ordner 'filebrowser/editorhooks/quoteoftheday/' enthalten). Die entpackte Quoteoftheday-zip-Datei besteht aus den Ordner "plugins", der alles an richtiger Stelle enthält. Dieser Ordner kann direkt ins XH-Basisverzeichnis kopiert werden.Sicherungskopien ersparen Ärger, falls etwas nicht so abläuft wie erwartet.
Hatte man die CSS-Datei angepasst, sollte man die Anpassungen vor dem Update an anderer Stelle sichern und sie anschließend als eine eigene "Rahmen"-Klasse in der CSS-Datei speichern, wie im nächsten Abschnitt beschrieben.
Die entpackte neue Quoteoftheday-zip-Datei besteht aus den Ordner "plugins", der direkt ins XH-Basisverzeichnis kopiert werden kann und dann die alte quoteoftheday Installation überschreibt. Zitatlisten bleiben erhalten, Konfigurationseinstellungen müssen neu eingeben werden.
Bei Update von Version 0.5 und älter ist der Zitattrenner "===
" nach jedem Zitat sowie, je nach Zitat, das Kürzel für den Zitatautor-Absatz "-
" neu einzugeben.
Die Zitate sind in einem div-Rahmen eingebettet, dem eine einstellbare CSS-Klasse zugeordnet ist. Der Namen dieser "Rahmen"-Klasse wird in der Zitat-Datei gespeichert. Man kann leicht zusätzliche Klassen erstellen: In der Stylesheet.css einem neuen Klasseneintrag eintragen, dessen Namen mit .quote_
beginnt.
Manchmal ist es einfacher, eine bestehende Klasse anzupassen, z.B. durch einen anderen Wert bei width
oder der Angabe einer Schriftfarbe, wie color:black;
. Um zu verhindern, dass floatende Bilder außerhalb des Rahmens zu liegen kommen, fügt man clear:both;
hinzu. Bei manchen Templates verrutscht dann allerdings das Design, da muss man im Einzelfall entscheiden.
{{{quoteoftheday}}}
oder {{{quoteoftheday 'Dateiname'}}}
. Die Dateiendung .txt
braucht nicht angegeben zu werden. {{{PLUGIN:quoteoftheday('Dateiname');}}}
. PLUGIN:
beginnt, die vorausgegangenen ohne PLUGIN:
unterdrückt. Wenn Sie also mehrere Plugins auf einer Seite aufrufen, bitte entweder überall die ältere Aufrufmethode mit PLUGIN:
nutzen, oder nirgends.<?php echo quoteoftheday(); ?>
bzw. <?php echo quoteoftheday('Dateiname'); ?>
Voreingestellt ist die Standardzitatdatei, für deutsch quote_de.txt
. Statt die Standardzitatdatei auszuwählen kann man auch quote_de.txt wählen, was das gleiche bewirkt. Über das Auswahlmenü können weitere Zitatdateien erstellt oder gelöscht werden (Dateinamen dürfen keine Leerzeichen und Umlaute enthalten). Durch Pluginaufruf mit Zitatdateinamen können Zitate aus verschiedenen Zitatdateien gezeigt werden.
Code | Anwendung |
---|---|
=== | Zitattrenner, trennt die Zitate untereinander. Um ein neues Zitat nach einem anderen einzufügen, den Zitat-Trenner ans Ende eines Zitats eingeben und das neue Zitat eintragen. |
Leerzeile | Ein neuer Absatz innerhalb eines Zitats wird erst durch eine Leerzeile oder die Nutzung eines Kürzels zum Zuweisen einer Klasse hervorgerufen. Ein einfacher Zeilenumbruch bewirkt keine neue Zeile. |
/ | Am Zeilenende: Umbruch zur neuen Zeile innerhalb des Absatzes, z.B. für Gedichte. |
**...** //...// __...__ |
fett kursiv unterstrichen |
Absatzkürzel: -Text... ?Text... !Text... %Text... %%Text... |
Am Zeilenanfang: Erzeugt neuen formatierten Absatz: — Spiegelstrich und rechtsbündig (für Autoren-Nennung) kleinere Schrift größere Schrift zentriert (bei Kombination an 2. Stelle, z.B. !%) rechtsbündig (bei Kombination an 2. Stelle) |
* Text... * Text... |
|
# Text... # Text... |
|
2-4 Leerzeichen | Am Zeilenanfang: Erzeugt neue Zeile mit Zeileneinzug, funktioniert auch innerhalb von Listen, erzeugt jedoch von sich aus keinen neuen Absatz. |
> >> >>> |
Am Zitatanfang: Wenn der Zitatrahmen zu breit ist, kann man das gesamte Zitat in drei Stufen weiter in die Mitte rücken. |
[[URL|Text]] | Erzeugt einen Link, z.B. extern: [[http://cmsimple-xh.org|XH-Website]] intern: [[?Startseite|zur Startseite]] |
{{Bild.jpg}} {{ Bild.jpg}} {{Bild.jpg }} {{ Bild.jpg }} {{Bild.jpg|width="300"}} {{ Bild.jpg |width="300"}} {{...|style="width:300px"}} {{...|alt="xxx"}} %{{Bild.jpg}} %%{{Bild.jpg}} |
Bilddateien werden mit dem Filebrowser an der Cursorposition eingefügt und haben ein automatisch generiertes alt-Attribut. Bitte beachten: Die Positionen der Leerzeichen innerhalb von {{...}} sind so beabsichtigt! rechts floatend links floatend zentriert auf Breite von 300px gesetzt zentriert und auf Breite von 300px gesetzt Alternative für Breite oder andere CSS-Werte mit xxx als alt-Attribut statt automatisch generiertem Bilder können (ohne Floating) auch mit Absatzkürzeln mittig oder nach rechts gesetzt werden. |
{{Sound.mp3}} | Audio-Dateien, (mp3, wav, ogg) werden wie Bilddateien mit dem Filebrowser eingefügt und enthalten automatisch ein title-Attribut. Visuell erzeugen sie folgenden Player:![]() Praktischerweise setzt man den Player in einen eigenen Absatz, d.h. an erster Stelle im Zitat oder mit einer Leerzeile vor und nach der Audio-Datei oder mit einem Absatzkürzel, z.B. % vor der Audio-Datei, damit der Player keinen Text überlappt.Für den Player is kein Floating implementiert wie bei Bildern. Es ist auch kein Flash-Fallback eingebaut, im Internet Explorer 8 erscheint deshalb nichts. |
%{{Sound.mp3}} {{Sound.ogg,mp3}} {{Sound.mp3|autoplay}} {{Sound.mp3|loop}} {{...|autoplay loop}} {{...|style="background:red"}} {{...|style="width:200px"}} |
Mit % davor wird er mittig gesetzt. Hat man eine ogg- und eine mp3-Datei, kann man für Chrome, Firefox, etc. ogg und für Internet Explorer mp3 angeben. Automatischer Start Beginnt am Ende wieder neu Beides Farbiger Player (hier z.B. rot) Auf 2/3 verkürzter Player |
Vielen Dank allen Betatestern, vor allem mhz, cmb, Ludwig, Tata, oldnema, ohne deren Vorschläge dieses Plugin nicht zu dem geworden wäre, was es jetzt ist.