Für CMSimple_XH >= 1.5.4 oder CMSimple 4.x
"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.
Die entpackte neue Quoteoftheday-zip-Datei direkt ins XH-Basisverzeichnis kopieren. Sie überschreibt die alte quoteoftheday Installation, dem Filebrowser-Plugin wird eine Datei hinzugefügt, den Userfiles wird ein Ordner zum Speichern der Zitate hinzugefügt. Vorhandene Zitatlisten bleiben erhalten, Konfigurationseinstellungen müssen neu eingeben werden.
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.
Bei Update von Version 0.5 und älter ist der Zitattrenner "===
" nach jedem Zitat sowie gegebenenfalls das Kürzel für den Zitatautor-Absatz "-
" neu einzugeben.
Die Zitate sind in auswählbaren Rahmen eingebettet. Programmtechnisch handelt es sich um einen div-Abschnitt mit auswählbarer CSS-Klasse, deren Namen in der Zitat-Datei gespeichert wird. Um zusätzliche (Rahmen-)Klassen zu erstellen braucht man nur in der Stylesheet.css eine neue Klasse einzutragen, deren Name mit .quote_
beginnt.
Bestehende Rahmen-Klassen kann man leicht anpassen, z.B.:
max-width
..quote_Grunge p:last-of-type {margin-bottom:0;}
, d.h. nach dem letzten Absatz fällt der Absatzabstand weg. Eventuell will man das nicht. Dann gibt es die Angabe .quoteoftheday h4, .quoteoftheday h5 {margin-top:0;}
, die bewirkt, dass die Überschrift keinen Abstand zum oberern Rahmenrand hat. Hier könnte man auch gut Änderungen durchführen. color:black;
.clear:both;
in der Klassenanweisung verhindern. 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ückte. Wenn Sie also mehrere Plugins auf einer Seite aufrufen, empfiehlt es sich daher auf 1.6.7 upzudaten oder immer dieselbe Aufrufmethode zu nutzen.<?php echo quoteoftheday(); ?>
bzw. <?php echo quoteoftheday('Dateiname'); ?>
Voreingestellt ist die Standardzitatdatei, der jeweilig eingestellten Sprache, z.B. 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. |
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 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 {{...}} steuern die Bildausrichtung! 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. Der Browser zeigt an dieser Stelle seinen eingebauten Player, je nach Browser leicht unterschiedlich, bei Firefox z.B.: ![]() 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 vorgesehen 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 so für Chrome, Firefox, etc. ogg und für Internet Explorer mp3 bereithalten. 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.
Vielen Dank auch den unbekannten Designern, deren Entwürfe im Internet wieder und wieder kopiert und modifiziert werden und die als Ausgangspunkt der Rahmen von Quoteoftheday dienten.