Modul Article List Reloaded
v 1.0

Das Modul basiert in Grundzgen auf Article List Advanced von funomat, wurde aber in weiten Teilen neu programmiert.
Es verwendet noch einzelne Ablufe und Formularelemente des Originals.

Zur Verwendung:
- Modul importieren, einem Template und Artikel zuordnen
- Die Konfiguration des Moduls erfolgt in der Vorlage des Artikels/der Kategorie.
- Das Modul ist komplett mehrsprachenfhig und fr deutsch bersetzt.

Grundstzliches:
- Die Konfigurationsseite wurde wesentlich entschlackt. Das Modul berechnet sehr viele unterschiedliche Varianten aus den ausgewhlten  Elementen, und die Konfiguration dient eher dazu, eine Auswahl dieser Varianten in feststehende Variablen zu kopieren, damit diese in  im HTML-Template einmal eingebunden werden knnen und ihren Inhalt je nach Einstellung ndern (die Variable article.headline kann z.B. mal eine Artikelberschrift, eine Zusammenfassung oder einen gekrzten Seitentitel enthalten).
- Alle hierfr berechneten Variablen stehen aber fr umfassende hndische Anpassung der HTML-Vorlage stets zur Verfgung (article.headline enthlt z.B. den Seitentitel als "berschriftsfavoriten", article.summary steht aber zur Verfgung, egal was in der Vorlage angeklickt ist oder nicht).
- Einige Variablen (Datum, bersichtslink, "weiter"-Links, Datum) bentigen begleitende Textfetzen (als Linktext oder vorgeschaltete Einleitungstexte). Hierfr stehen je Variable 3 Strings in der bersetzung zur Verfgung, die sich in der HTML-Vorlage aufrufen lassen, z.B. $listObj->more1 oder $listObj->authorLabel1).
- Eine umfangreiche Liste mglicher Variablen findet sich am Ende der beigefgten HTML-Vorlage.
- Es werden auch Variablen produziert, die in der Konfiguration erstmal gar nicht erscheinen, z.B. article.author.

Changelog (Auszug):
- NEU: erstmals steht jetzt auch der CMS_Typ "Date" als Element zur Verfgung und kann aus Artikeln ausgelesen werden.
- Der Inputbereich wurde komplett neu geschrieben, damit er zuknftig besser an neue Anforderungen angepasst werden kann.
- Der Outputbereich wurde durch Zusammenlegung etlicher Schleifen wesentlich vereinfacht.
- Die Paginierungsfunktion wurde berarbeitet und liefert nun keinen festen Endlosstring mehr; statt dessen produziert sie fr jeden Typ identisch strukturierte Arrays, die mit foreach-Schleifen in der HTML-Vorlage durchlaufen werden knnen.
- Paginierungstyp 05 wurde komplett neu geschrieben, um auf die externe PHP-Datei verzichten zu knnen.
- Das Auslesen der Bilder-Metatags erfolgt nun auch mit Bordmitteln statt externer Datei.
- Funktionen und Dateien, die wg. Kompatibilitt mit PHP4 enthalten waren, wurden entfernt, da CON 4.9 bereits zwingend PHP5.2 voraussetzt.
- Alle Teile der Artikelliste, die auf "Elemente" (Bilder, Artikeltexte) zurckgreifen sowie deren Eigenschaften werden ebenfalls als Array geliefert.
- bergeordnete Variablen (bersichtslink, Zusatztexte), die nicht vom konkreten Artikel abhngen, werden als Objekt geliefert.
- Die Umstellung auf Arrays und Objekte wird die Erweiterung und Anpassung erheblich vereinfachen.
- Bitte die umgebaute Article List Advanced, die ich im Forum gepostet habe, nicht weiter verwenden. Ich werde sie nicht weiter pflegen, und beim Umprogrammieren dieser Version hat sich gezeigt, dass diese doch noch mehr Anpassungen an 4.9 bruchte als ich gedacht habe.
- Einiges ist immer noch zu kompliziert gelst, aber es muss ja noch Luft nach oben geben ;-)

Lschen von Dateien:
- Alle bentigten externen Dateien wurden in den Unterordner /php des Moduls verschoben und entsprechend inkludiert. 
- Dateien, die von den Vorgngerversionen nach /cms/includes verschoben werden mussten, knnen gelscht werden, inkl. des Ordners /pagination (sofern diese nicht fr andere Module gebraucht werden).

	
Konfiguration der Vorlage:
- Modul on- und offline stellen
- NEU: Akkordeonfunktion kann ausgeschaltet werden, besonders hilfreich bei der Erstkonfiguration - erspart viele Clicks.
- GENDERT: viele "verwenden"-Button sind entfernt, da ohnehin alle denkbaren Werte erzeugt werden und je nach Vorlage gar nicht sichergestellt sein kann, dass - obwohl angeklickt - der Wert auch dargestellt wird. Der Webmaster muss sich auf der Basis der zur Verfgung gestellten Variablen um eine funktionierende Vorlage kmmern (dies war bisher aber auch stets der Fall).
- NEU: Umstellung auf Smarty-Templates, da diese differenziertere Ausgaben ermglichen.
- NEU: Das Feld "Headline-Element" muss nicht mehr zwingend mit einem Container-Element bestckt werden. Alles ist mglich: keinerlei Zuordnung, oder Zuordnung von Zusammenfassung (Summary) oder Seitentitel (PageTitel). Als Konsequenz kann article.headline am Ende auch leer sein und gar nicht zum Einsatz kommen.
- Wird z.B. bei Feldern wie "Zusammenfassung krzen" ein Wert eingetragen, so werden mehrere Variablen produziert: article.summary_long mit dem vollen Text, article.summary_short mit dem gekrzten Text, article.summary mit dem "Favoriten" aus diesen  beiden Strings, der sich aus der Konfiguration der Vorlage ergibt und sich dynamisch anpasst.
- Elementtyp "Text": ist angehakt, dass alle oder einige Tags im String verbleiben sollen, wird automatisch eine evtl. eingegebene Textkrzung unterbunden.


Ausgabe-Template (HTML) des Moduls:
- Das Modul kommt mit einer Vorlage, die die Smarty-Funktionen schon gut nutzt. Ein erstes rudimentres CSS ist beigefgt, MUSS aber angepasst werden (enthlt Deklarationen, die nur auf mein Projekt passen).
- Zum Ein-/Ausklappen der Backendkonfiguration ist jQuery erforderlich, ebenso ein Codeschnipsel im Header der Webseite, der sich im Ordner /doku des Moduls befindet.
- GENDERT: es gab bisher immer Verwirrung, mit welcher Nummer welches Element in der Vorlage anzusprechen ist. Jetzt gilt: die Vorlage bernimmt die laufende Element-Nummer und Typ aus der Konfiguration. Ist das 1. Element ein Text, heit die Variable "article.1_text". Ist das 3. Element ein Bild, heit die Variable "article.3_image".


Bekannte Einschrnkungen derzeit:
- keine, aber bestimmt finden sich recht schnell ein paar Bugs ...

Update 2013-12-19:
- Kam ein Bildername in unterschiedlichen Uploadordnern doppelt vor, so produzierte "Bild aus Text" gelegentlich Fehler und zog das falsche Bild. Dies ist behoben mit corr03 (Dank an Forenuser "Faar").
- Das Datumsformat wurde ggf. falsch ausgeschossen bei CMS_DATE. Behoben in corr03 (Dank an Forenuser "Spl4sh3r").

September 2013, Viktor Lehmann, TONE2TONE
