Quoteoftheday_XH 1.0
"Quote of the day" creates a div box in which a quote is placed. This quote comes from one of several quote collections entered by the user in the backend. The quote is exchanged daily, weekly or monthly, at random or in a fixed order.
The quotes are entered as plain text with simplified markup similar to wiki software.
New in version 1.0:
- Quotes can contain links, images and audio files.
(Because of different the internal links quote files with links, images or audios don't work simultaneously in main and secondary language, contrairy to pure text quote files. You'll have to create language specific quote files.) - Additional formatting possibilities
- Selectable frames for the quotes
- Filebrowser integration: The Quoteoftheday zip file contains also a file to be inserted in the filebrowser folder at plugins/filebrowser/editorhooks/quoteoftheday/ to manage the filename transfer. The unzipped Quoteoftheday file is a ready to use "plugins" folder to be inserted into the website base.
- Single quote view with preview, reordering and deleting possibility, next to the usual total view of all quotes of a quote file.
- Bugfix (0.8 + 0.9 would revert to the standard quote file after preview. Now fixed.)
Update to 1.0
Saving your old installed plugin somewhere may always be prudent.
In case you made some changes to the css, save you old css file and create later your custom css class as detailed in the next section.
Install the unzipped "plugins" folder in the website base. This will overwrite your old quoteofthedays plugin, leaving your quote files intact. Config data has to be entered again.
Updates from 0.5 and earlier version need entering after every quote the new quote separator === and the
trigger for the author line -.
Quote Frames
Quotes are displayed in a frame, which is a div container with a selectable class. The class name is saved in the quote file header. You can easily create additional frame classes: Just enter a new class in the stylesheet.css, the name has to start with .quote_.
Sometimes it is easier to edit one of the existing frame classes, e.g. by changing the value of width or adding a font color with color:black;. To prevent floating images overlapping the quote border, add clear:both;. However in some templates this will affect the design, so a decision has to be made per case.
Calling Quoteoftheday
- on a page in XH 1.6.5 or higher:
{{{quoteoftheday}}}oder{{{quoteoftheday 'Dateiname'}}}. The filename ending.txtdoesn't have to be entered.
In older XH versions the old style method has to be used:{{{PLUGIN:quoteoftheday();}}}or{{{PLUGIN:quoteoftheday('FILENAME');}}}.
Important: In XH 1.6.5 and 1.6.6 there is a bug, which invalidates a new style plugin call without "PLUGIN:" when on the same page another old style call with "PLUGIN:" is present. So don't mix old and new calling styles on the same page. - in the template:
<?php echo quoteoftheday();?>or<?php echo quoteoftheday('FILENAME');?>
Entering and editing quotes
Preset is the language specific quote file, e.g. for English quote_en.txt. Instead of selecting "Standard quote file" you can select quote_en.txt, which amounts to the same. You can create or delete quote files via the options menu. File names may not contain accented letters or spaces.
| Code | Usage |
|---|---|
| === | Quotes are separated by === in the quote file. |
| Empty line | A new paragraph in a quote is created via an empty line or via the use of a markup code. Entering a new line in the input will not create a new line in the output. |
| / | At the end of a line: Line break within a paragraph, e.g. useful for poems. |
| **...** //...// __...__ |
bold italic underlined |
| paragraph triggers: -Text... ?Text... !Text... %Text... %%Text... |
At the beginning of a line: creates new paragraph with css-class: — dash and right aligned (for author's name) smaller font bigger font centered (takes 2nd place combined with other codes, e.g. !%)right aligned (takes 2nd place in code combinations) |
| * Text... * Text... |
|
| # Text... # Text... |
|
| 2-4 spaces | At beginning of a line: Creates new indented line, works also inside of list items, doesn't create a new paragraph. |
| > >> >>> |
At start of quote: If the width of the quote frame is too large for a certain quote, you narrow down the width for this quote in 3 steps. |
| [[URL|Text]] | Creates a link, e.g. external: [[http://cmsimple-xh.org|XH-Website]] internal: [[?Start|to the start page]] |
{{image.jpg}} {{ image.jpg}} {{image.jpg }} {{ image.jpg }} {{image.jpg|width="300"}} {{ image.jpg |width="300"}} {{...|style="width:300px"}} {{...|alt="xxx"}} %{{image.jpg}} %%{{image.jpg}} |
Image files are inserted with the filebrowser at the position of the cursor. An alt value is generated automatically. The following position of the spaces is intended! Floating to the right. Floating on the left. Centered. Set to a width of 300px. Centered and set to a width of 300px. Alternative way to set width or other css-values. xxx as alt-value instead of automatically generated one. Centered image (no float) via paragraph trigger code. Image right aligned via paragraph trigger. |
| {{Sound.mp3}} | Audio files (mp3, wav, ogg) are entered like image files via the filebrowser and get automatically a title value. On the page the player of the browser is shown, e.g. in Firefox: Usually one will place the player into its own paragraph, i.e. at the start of the quote, or after an empty line, or after a paragraph trigger code, e.g. %, so that the player doesn't overlap any text of the quote.Floating of the player not implemented as in images. No flash fallback, Internet Explorer 8 won't show anything. |
| %{{Sound.mp3}} {{Sound.ogg,mp3}} {{Sound.mp3|autoplay}} {{Sound.mp3|loop}} {{...|autoplay loop}} {{...|style="background:red"}} {{...|style="width:200px"}} |
% in front put the player in a centered paragraph. If you have both an ogg- and an mp3 file, you can present Chrome, Firefox, etc. with ogg and Internet Explorer with mp3. Automatic start Loop Both Colored player (here red) To 2/3rd shortened player |
Acknowledgements
With the help of suggestions from all beta testers, especially mhz, cmb, Ludwig, Tata and oldnema, this plugin has become what it is now.
I would like to thank those unknow designers, on whose work some of the frames of Quoteoftheday are based. You can find innumerable useful frames in the internet, sometimes the same designs on multiple sites, where the original creator isn't mentioned.