.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================== EXT: Losungen (de) ================== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: André Spindler :Changed: 2010-01-01T21:04:32.540000000 :Classification: losungen :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: losung watchwords :Author: André Spindler :Email: typo3@andre-spindler.de :Info 4: :Language: en |img-1| |img-2| EXT: Losungen (de) - losungen .. _EXT-Losungen-de: EXT: Losungen (de) ================== Extension Key: losungen Language: en Keywords: losung watchwords Copyright 2000-2009, André Spindler, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from `www.typo3.org `_ .. _Table-of-Contents: Table of Contents ----------------- `EXT: Losungen (de) 1 <#1.EXT:%20Losungen%20(de)|outline>`_ **`Introduction 3 <#1.1.Introduction|outline>`_** `What does it do? 3 <#1.1.1.What%20does%20it%20do_|outline>`_ `Screenshots 3 <#1.1.2.Screenshots|outline>`_ **`Users manual 4 <#1.2.Users%20manual|outline>`_** `FAQ 4 <#1.2.1.FAQ|outline>`_ **`Configuration 5 <#1.3.Configuration|outline>`_** `Charset (utf-8 / iso-latin) 5 <#1.3.1.Charset%20(utf-8%20/%20iso- latin)|outline>`_ **`To-Do list 6 <#1.4.To-Do%20list|outline>`_** **`ChangeLog 7 <#1.5.ChangeLog|outline>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ - This extension adds a new content-element to fetch and display the daily german watchwords (“Losungen”). - Important: This extension can only display the german verses from the official website `www.losungen.de `_ . As defined in the terms of use, the copyright-links have to be displayed. - When called, the extension checks if the data-file has been fetched before. If so, the verses of the current day are read and displayed. If not, the zipped-XML-file from `www.losungen.de `_ is downloaded and unpacked in the folder “typo3temp” before. So the extension always gets the current contents by itself, it's not necessarry to download and instell them manually every year. - From version 0.4.0, the output of the plugin can be of charset utf-8. .. _Screenshots: Screenshots ^^^^^^^^^^^ The plugin in the Backend: |img-3| The plugin in the Frontend: |img-4| (Example taken from `www.lkg-marktredwitz.de `_ on 05.01.2008) .. _Users-manual: Users manual ------------ This extension comes with a fully working TypoScript configuration, so you can use it 'out-of-the-box'. So just download and install it and add the included TypoScript to your current template. You will notice that there was a new content-element created: .. _img-5-FAQ: |img-5| FAQ ^^^^^^^^^^^ - After installation of the extension I receive the error “TYPO3 Fatal Error: Extension key "div" was NOT loaded!“ What must I do?/ Where can I get these extension(s)?EXPLANATION: This may happen if You download the extension directly with the browser and upload it in the import- view of the extension-manager in typo3. Checking of dependencies fails here for some circumstances.SOLUTION (in extension-manager):- deactivate extension „Losungen“- install extension "div"- install extension "lib"- activate extension „losungen“ again - I receive the message „FEHLER: Temporäre Datei nicht gefunden!"EXPLANATION: The temporary xml-file with the content of the verses could not been found. In must cases the unzip-command could not be found and so the downloaded archive-file could not be unpacked.SOLUTION: First, find out the full path to the unzip-command on your OS (or ask your hoster for it). Second, in the install-tool of typo3 set this path as "['BE']['unzip\_path']". - I didn't get any output of the extension.EXPLANATION: TS-templates are still missing.SOLUTION: In Your TS-template, add the entry „watchwords\_de (losungen)“ to the list of „include static templates (from extensions)“ - I have problems with german umlauts.EXPLANATION: The charset used for extension-output differs from the charset set in the page- header.SOLUTION: In the constant-editor of your TS-template, select the right charset. .. _Configuration: Configuration ------------- The extension is per default setup to use the watchwords from `www.losungen.de `_ . But if necessary, you can modify the URL of the server and the required filenames. Every change can be done in the constants-editor in the template- section. You may also adapt the template for layout and the stylesheet. .. _Charset-utf-8-iso-latin: Charset (utf-8 / iso-latin) ^^^^^^^^^^^^^^^^^^^^^^^^^^^ In version 0.4.0 a selector was added to the constants-editor to create output as utf-8. You can choose between utf-8 and iso-latin1 (ISO-8859-1). .. _To-Do-list: To-Do list ---------- - Check performance and if necessary use caching and defined cache- clearing at the first call the next day. - If necessary and possible, include other languages (check copyrights) - In the current version (1.2.0) the name of the XML datafile has to be configured in TS template. But from 2009 to 2010 the naming changed (from "Losungen ***F*** ree YYYY.xml" to "Losungen ***f*** ree YYYY.xml). To prevent same problem the next time, the file should be recognized automatically. .. _ChangeLog: ChangeLog --------- See file “ChangeLog” in maindir of extension. 15 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 38 .. :id: Grafik5 .. :name: Grafik5 .. :width: 601 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 418 .. :id: Grafik1 .. :name: Grafik1 .. :width: 168 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 171 .. :id: Grafik3 .. :name: Grafik3 .. :width: 472