Quoteoftheday_XH 1.0

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

Neu in Version 1.0

Update auf 1.0

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.

CSS

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.

Aufrufen von Quoteoftheday

Zitate eingeben

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.

CodeAnwendung
=== 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
# Text...
# Text...
  1. Text
  2. 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:
player.png, 2,3kB
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

Danksagung

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.