Quoteoftheday_XH 1.1
For CMSimple_XH >= 1.5.4 or CMSimple 4.x
"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.1
- CSS-frames are now fully responsive. Quotes look good also in smartphones
- Default saving location for quotes now in the userfiles. Saving location can be set in config with option list to userfiles/ plugin (default up to Quoteoftheday 1.0)/ or as subfolder of the content folder.
- Small improvements in admin view.
New in version 1.0
- Quotes can contain links, images and audio files.
Links from a secondary language differ from links to the main language. These links are created at the beginning of the day when the plugin selects the quote. If you use the same quote in main and secondary language, the link will only work in one language, i.e. the language in which the quote is generated first. You can however copy the quote file to a new name and use two identical files, each for one language only. - 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.1
Saving your old installed plugin before updating may always be prudent.
Install the unzipped download into the base folder of CMSimple_XH. This will overwrite your old quoteofthedays plugin, add a file to the filebrowser plugin and add a folder for saving quotes to the userfiles. Your existing quote files should remain intact. Config settings have to be entered again.
In case you made some changes to the css, save you old css file before the update and create later your custom css class as detailed in the next section.
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 max-width or adding a font color with color:black;. To prevent floating images overlapping the bottom 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 was a bug (fixed in 1.6.7), which invalidated a new style plugin call without "PLUGIN:" when on the same page another old style call with "PLUGIN:" was present. So either update to 1.6.7 or 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 can 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. Note: The position of the spaces triggers the floating! 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.