https://de.contaowiki.org/api.php?action=feedcontributions&feedformat=atom&user=Hschottm 2026-05-02T13:25:55Z Benutzerbeiträge MediaWiki 1.22.6 https://de.contaowiki.org/Tags 2014-02-23T08:13:51Z

<p>Hschottm: /* Insert Tags */</p> <hr /> <div>[[Kategorie:tags]]<br /> <br /> Auszeichnungen zum Kategorisieren von Elementen.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/tags<br /> | ExtVersion=3.2.0<br /> | Version=3.2.0 - 3.2.3<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/tags.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> | Comment=Versionen ältere Contao-Versionen verfügbar<br /> }}<br /> <br /> <br /> == Modul tags (Auszeichnungen) ==<br /> <br /> tags ist ein Contao-Modul zum Erstellen und Anzeigen von Auszeichnungen innerhalb von Contao. Mit Hilfe des Moduls lassen sich für Entwickler mit geringem Aufwand Auszeichnungen für beliebige Contao Datacontainer (Tabellen) hinzufügen. Es ist zu beachten, dass zum vollständigen Funktionieren der Erweiterung die Mootools Unterstützung im Contao Seitenlayout aktiviert sein muss.<br /> Das Modul stellt ein Eingabefeld-Widget zur Verfügung, das für den aktuellen Datacontainer, in dem es eingesetzt wird, die Auszeichnungen in der Datenbank ablegen und auslesen kann. Die Auszeichnungen werden dabei als kommagetrennte Liste von den Autoren eingegeben oder können, falls JavaScript aktiviert ist, per Mausklick hinzugefügt oder entfernt werden (dies gilt allerdings nur für bereits bestehende Auszeichnungen).<br /> <br /> [[Datei:tags_backend.png|center|frame|Eingabefeld für Auszeichnungen im Backend]]<br /> <br /> In der vorliegenden Abbildung sieht man, dass das ''title''-Attribut der URL einer Auszeichnung die Anzahl der Verwendung derselben anzeigt, d.h. neben dem Namen der Auszeichnung wird die Anzahl der Verwendungen in Klammern hinter den Namen ausgegeben. ''Mathematik (8)'' bedeutet also z.B., dass die Auszeichnung Mathematik insgesamt 8 Mal verwendet wird. <br /> <br /> Es ist zu beachten, dass pro Contao Datacontainer nur ein Eingabefeld für Auszeichnungen verwendet wird, da die Auszeichnungen immer nur für den gesamten Datacontainer vergeben werden und nicht für das zugrund liegende Eingabefeld.<br /> === Hinweise für Entwickler von eigenen Erweiterungen ===<br /> <br /> Nutzer, die Auszeichnungen nur Verwenden wollen und diese nicht in eigene Erweiterungen integrieren wollen, können den folgenden Absatz einfach [[#Verwenden_von_Auszeichnungen_im_Contao-Frontend|überspringen]].<br /> <br /> ==== Hinzufügen von Auszeichnungsfeldern in Contao Datacontainer ====<br /> <br /> Um ein Auszeichnungs-Eingabefeld in einen Contao Datacontainer einzufügen, werden die folgenden Schritte benötigt:<br /> <br /> # Um das Eingabefeld anzuzeigen, muss für den Datacontainer ein entsprechendes Datenbankfeld existieren. Da die Auszeichnungen nicht in diesem Datenbankfeld gespeichert werden, sondern in der speziell vom tags-Modul bereitgestellten Datenbanktabelle ''tl_tag'', reicht es, ein möglichst kleines Datenbankfeld zu erzeugen.<br /> # Das Eingabefeld muss in das DCA Konfigurationsarray eingefügt werden<br /> <br /> Ein neues Datenbankfeld erstellen Sie in der ''config/database.sql''-Datei des gewünschten Moduls. Ein Beispiel ist z.B.<br /> <br /> &lt;source lang=&quot;sql&quot;&gt;<br /> CREATE TABLE `tl_literature` (<br /> `tags` char(1) NOT NULL default ''<br /> ) ENGINE=MyISAM DEFAULT CHARSET=utf8;<br /> &lt;/source&gt;<br /> <br /> Um das Feld mit diesem Namen in das DCA-Konfigurationsarray zu integrieren, muss es in eine der Paletten des Konfigurationsarrays eingefügt werden und eine Felddefinition erstellt werden, also z.B.<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> '' Palettes<br /> 'palettes' =&gt; array(<br /> 'default' =&gt; 'title,author,description,tags,content'<br /> ),<br /> '' Fields<br /> 'fields' =&gt; array(<br /> 'tags' =&gt; array(<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['MSC']['tags'],<br /> 'inputType' =&gt; 'tag'<br /> )<br /> ),<br /> &lt;/source&gt;<br /> <br /> Mit ''$GLOBALS['TL_LANG']['MSC']['tags']'' stellt das tags-Modul bereits einen Standardbezeichner für ein Auszeichnungsfeld zur Verfügung. Man kann diesen natürlich jederzeit gegen eigene Spracheinträge austauschen.<br /> <br /> Beim Speichern eines Datacontainers werden während der Validierung der Daten die Auszeichnungen identifiziert und in der Datenbanktabelle ''tl_tag'' gespeichert. Abgelegt wird die ID des aktuellen Datacontainers (Tabellenfeld ''id''), der Tabellenname des Datacontainers (Tabellenfeld ''from_table'') und die Auszeichnung (Tabellenfeld ''tag'').<br /> <br /> ==== Optionen für das Evaluation-Array des Feldes ====<br /> <br /> {| border=&quot;1&quot; cellpadding=&quot;10&quot; cellspacing=&quot;0&quot; <br /> ! Schlüssel <br /> ! Wert <br /> ! Beschreibung<br /> |- style=&quot;vertical-align: top;&quot;<br /> | table || Quelltabelle ''string'' || Name der Quelltabelle, aus der die Auszeichnungen gebildet werden sollen. Der Standard ist der Name des aktuellen DCA Datencontainers. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | isTag || true/false ''boolean'' || Gibt an, ob der Inhalt des Feldes als Tag gespeichert werden soll oder nicht. Der Standard ist ''true''. Wenn der Inhalt des Feldes nicht als Tag gespeichert werden soll, wird der Feldinhalt ganz normal als kommagetrennte Zeichenkette in der Datenbank abgelegt. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | maxtags || Anzahl ''integer'' || Gibt die maximale Anzahl der Auszeichnungen an, die in der Tag Cloud zum Auswählen der Auszeichnungen angegeben werden. Wenn die Anzahl der verfügbaren Auszeichnungen größer ist, als maxtags, werden die Auszeichnungen mit den wenigsten Vorkommnissen nicht mehr angezeigt. <br /> |}<br /> <br /> === Verwenden von Auszeichnungen im Contao-Frontend ===<br /> Für die Verwendung im Contao-Frontend ist das Modul ''Tag Cloud'' vorgesehen. Das Modul erstellt eine HTML-Liste der für einen oder mehrere Datacontainer verwendeten Auszeichnungen. Um die Liste als Tag Cloud darzustellen, müssen die zugehörigen CSS-Selektoren mit Stilen versehen werden. Zwei Beispieldateien ''[[tags_oxygen.css]]'' und ''[[tags_orange.css]]'' finden sich im ''tl_files/tags''-Verzeichnis des Installationspakets der tags-Erweiterung. Es empfiehlt sich an, sich an diesen Stilen zu orientieren, da es bei der Verwendung der '''Top 10 Auszeichnungen''' darauf ankommt, welche Elemente der Tag Cloud durch die CSS-Stile sichtbar gemacht werden und welche nicht.<br /> <br /> [[Datei:tagcloud_settings_1.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen deaktiviert]]<br /> <br /> Im Eingabefeld '''Maximale Anzahl von Auszeichnungen''' kann man eine maximale Anzahl der anzuzeigenden Auszeichnungen für die Tag Cloud festlegen. Ein Wert von 0 oder kein Wert zeigt immer alle verfügbaren Auszeichnungen an. Bei einem Wert kleiner als die maximale Anzahl der verfügbaren Auszeichnungen werden nur die häufigsten Auszeichnungen gemäß der Vorgabe im Eingabefeld angezeigt. Es ist zu beachten, dass es dadurch möglich ist, dass nicht alle Auszeichnungen angezeigt werden. Man sollte für die Benutzer einen Hinweis vorhalten, der auf diesen Umstand aufmerksam macht.<br /> <br /> Im Eingabefeld '''Anzahl der Auszeichnungsgrößen''' kann man die Anzahl der verfügbaren CSS Selektoren für die Tag Cloud festlegen. Der Standardwert 4 erzeugt vier unterschiedliche Gruppen von Auszeichnungen mit den Selektoren size1, size2, size3 und size4, man kann also maximal 4 unterschiedliche Größen von Auszeichnungen im Frontend ausgeben. Es ist darauf zu achten, dass man immer für alle möglichen CSS Selektoren ein CSS-Element vorhält.<br /> <br /> Das Kontrollkästchen '''Auszeichnungs-Klassennamen verwenden''' fügt einen zusätzlichen CSS Klassennamen für jede Auszeichnung hinzu, der aus dem Namen der jweiligen Auszeichnung besteht. Damit können einzelne Auszeichnungen individuell per CSS angepasst werden. Leerzeichen in den Auszeichnungsnamen werden für die CSS-Klassennamen in Unterstriche umgewandelt.<br /> <br /> Mit dem Auswahlfeld '''Tag Cloud Template''' kann man das Template bestimmen, das für die Generierung der Tag Cloud im Frontend verwendet werden soll. Standardmäßig ist dies das Template ''mod_tagcloud''. Man kann sich aber auch eigene Templates erstellen und hier verwenden. Diese müssen dann lediglich mit der Zeichenkette mod_tagcloud beginnen, also z.B. mod_tagcloud_spezial etc.<br /> <br /> Das Kontrollkästchen '''Zugehörige Auszeichnungen''' zeigt im Frontend bei Auswahl mindestens einer Auszeichnung eine Liste weitere Auszeichnungen an, die im Zusammenhang mit der ausgewählten Auszeichnung vergeben wurden. Durch einen Klick auf eine dieser zugehörigen Auszeichnungen kann die Suche nach ausgezeichneten Objekten weiter eingeschränkt werden. Natürlich funktioniert die Anzeige der zugehörigen Auszeichnungen nur dann, wenn sich das Tag Cloud Modul auf einer Seite befindet, die sich in der Weiterleitung der Tag Cloud Hyperlinks befindet, da die Tag Cloud sonst keinerlei Kenntnis von bereits ausgewählten Auszeichnungen haben kann.<br /> <br /> Das Kontrollkästchen '''Top 10 Auszeichnungen''' erzeugt über der Tag Cloud eine weitere Tag Cloud, welche die 10 häufigsten Auszeichnungen beinhaltet, in der Reihenfolge des häufigsten Auftretens. Gleichzeitig ist dieses Kontrollkästchen ein Selektor, der bei Aktivierung zwei weitere Kontrollkästchen erzeugt:<br /> <br /> * '''Top 10 Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, sind die Top 10 Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> * '''Alle Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, ist die Tag Cloud mit allen Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> <br /> [[Datei:tagcloud_settings_1a.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen aktiviert]]<br /> <br /> Man wählt unter '''Weiterleitung zu Seite''' eine interne Contao-Seite aus, damit die Auszeichnungen der Tag Cloud mit Hyperlinks versehen werden. Die gewählte Seite wird dann immer mit dem URL-Parameter ''tag=TAGNAME'' aufgerufen, also z.B. ''http://www.meineseite.de/weiterleitung.html?tag=typolight''.<br /> <br /> <br /> [[Datei:tagcloud_settings_2.png|center|frame|Tabellenspezifische Eingabefelder des Tag Cloud Moduls im Backend]]<br /> <br /> Bei '''Einschränkung auf Tabelle(n)''' wählt man normalerweise immer nur den Datacontainer aus, für den die Tags gespeichert wurden.<br /> <br /> Die Felder '''Quell-Tabelle für Auszeichnungen''' und '''Tabellenfeld für Auszeichnungen''' werden mit den Standardeinträgen ''tl_tag'' und ''tag'' vorbelegt und sollten nur dann geändert werden, wenn man die Tags aus einer eigenen Tabelle beisteuern will.<br /> <br /> Mit den Feldern '''CSS-Id/Klasse''' kann man zusätzliche CSS-ID's oder Klassen vergeben, die dann im umschließenden DIV-Container der Tag Cloud eingebettet werden. Dadurch hat man die Möglichkeit individuelle Stile für die Tag Clouds einzusetzen.<br /> <br /> Im Frontend sieht die Tag Cloud dann z.B. folgendermaßen aus:<br /> <br /> [[Datei:tagcloud_frontend.png|center|frame|Ausgabe der Tag Cloud im Frontend]]<br /> <br /> bzw. mit aktivierten Top 10 Auszeichnungen:<br /> <br /> [[Datei:tags_topten.png|center|frame|Tag Cloud mit Top 10 Auszeichnungen]]<br /> <br /> bwz. mit aktivierten Top 10 und zugehörigen Auszeichnungen:<br /> <br /> [[Datei:tags_related.png|center|frame|Tag Cloud mit Top 10 und zugehörigen Auszeichnungen]]<br /> <br /> Werden zwei Tag Clouds (Top 10 + Alle) oder die zugehörigen Auszeichnungen angezeigt, bindet Contao ein JavaScript ein, das die jeweiligen Tag Clouds bei Mausklick auf den Titel einklappt bzw. ausklappt. Ist kein JavaScript aktiviert, so werden die dreieckigen Klappsymbole nicht angezeigt. Für einen optimale Zusammenarbeit mit der JavaScript-Erweiterung sollte man die installierten CSS-Dateien tags_oxygen.css oder tags_orange.css in die Seite einbinden.<br /> <br /> Die folgenden Contao-Elemente können mit Tags versehen werden:<br /> <br /> * Nachrichtenbeiträge<br /> * Artikel<br /> * Inhaltselemente<br /> * Kalender/Events<br /> * FAQ (ab Contao 2.11)<br /> * Dateien (ab Contao 3.1)<br /> <br /> ==== Weiterleitung zu Seiten über eine Tag Cloud ====<br /> <br /> Damit eine sinnvolle Weiterleitung aus einer Tag Cloud vorgenommen werden kann, muss die Seite, zu der weitergeleitet wird, den tag-Parameter in der URL interpretieren können. Hierin liegt die Hauptarbeit, wenn die Tag-Unterstützung für bestehende Contao-Datacontainer vorgenommen werden soll.<br /> <br /> Die folgenden Contao-Module reagieren auf einen Aufruf aus einer Tag Cloud heraus und zeigen nur die Elemente an, die mit der ausgewählten Auszeichnung versehen wurden:<br /> <br /> * Modul '''Nachrichtenarchiv''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Nachrichtenliste''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Globale Artikelliste''': Es werden Links auf alle Artikel angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Eventliste''': Es werden alle Events der ausgewählten Kalender im ausgewählten Zeitraum angezeigt, die mit der gesuchten Auszeichnung versehen sind.<br /> * Modul '''Auszeichnungsobjekte''': Es werden Inhaltselemente (Seiten, Artikel, Inhaltselemente) in einer Liste angezeigt, die mit einer bestimmten Auszeichnung versehen sind.<br /> <br /> ==== Ausgabe von Auszeichnungslisten zu Nachrichtenbeiträgen ====<br /> <br /> Bei der Ausgabe von Nachrichtenbeiträgen gibt es die Möglichkeit, unterhalb des Nachrichtenbeitrags die zum Beitrag zugehörigen Auszeichnungen anzeigen zu lassen. Zu diesem Zweck kann die Ausgabe der Auszeichnungen in den Frontend-Modulen zur Nachrichtenanzeige, '''Nachrichtenleser''', '''Nachrichtenliste''' und '''Nachrichtenarchiv''', aktiviert werden.<br /> <br /> [[Datei:tags_tag_settings.png|center|frame|Aktivierung einer Auszeichnungsliste im Modul des Contao Backends]]<br /> <br /> Mit der Option '''Auszeichnungen ignorieren''' werden von der Liste alle zur Filterung verwendeten Auszeichnungen verworfen.<br /> <br /> Wenn man die Option '''Nachrichten-Auszeichnungen anzeigen''' auswählt, erscheint zusätzlich ein Auswahl-Feld für eine Weiterleitungsseite, die aufgerufen wird, wenn aus eine der Auszeichnungen geklickt wird. Hier wählt man die Seite aus, auf die man auch aus der Tag Cloud heraus weiterleitet oder aber natürlich jede beliebige andere Seite, wenn man eine spezielle Behandlung der zu einer Nachrichten angeklickten Auszeichnungen wünscht.<br /> <br /> Um, wie bei den Tag Clouds die Namen der individuellen CSS-Klassen der jeweiligen Auszeichnungen anzuzeigen, wurde die Option &quot;Auszeichnungs-Klassennamen verwenden&quot; eingeführt. Diese verwendet die individuelle CSS-Klasse in allen Auszeichnungen, die unterhalb eines Nachrichtenbeitrags angezeigt werden.<br /> <br /> Damit eine Ausgabe der Auszeichnungen im Frontend auch wirklich ausgeführt wird, muss man außerdem die '''Nachrichtenvorlage''' des Moduls anpassen. Speziell für diesen Zweck wurde mit der tags-Erweiterung das Template ''news_full_tags'' erstellt, das den entsprechenden HTML-Code zur Ausgabe der Auszeichnungen unterhalb eines Nachrichtenbeitrags bereitstellt. Wenn man ein anderes Template für die Ausgabe verwenden will und die Ausgabe der Auszeichnungen zu einem Nachrichtenbeitrag wünscht, sollte man den im Template news_full_tags hinzugekommenen Quellcode kopieren und in das gewünschte Template einfügen:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> &lt;?php if ($this-&gt;showTags): ?&gt;<br /> <br /> &lt;?php if (count($this-&gt;taglist)): ?&gt;<br /> &lt;ul class=&quot;tag-chain&quot;&gt;<br /> &lt;?php $counter = 0; foreach ($this-&gt;taglist as $tag): ?&gt;<br /> &lt;li class=&quot;tag-chain-item&lt;?php if ($counter == 0) echo ' first'; ?&gt;<br /> &lt;?php if ($counter == count($this-&gt;taglist)-1) echo ' last'; ?&gt;<br /> &lt;?php if ($this-&gt;showTagClass) echo ' ' . $tag['class']; ?&gt;&quot;&gt;&lt;?php echo $tag['url']; ?&gt;&lt;/li&gt;<br /> &lt;?php $counter++; endforeach; ?&gt;<br /> &lt;/ul&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;/source&gt;<br /> <br /> Für die Ausgabe der Auszeichnungen enthalten die in der Erweiterung mitgelieferten CSS-Dateien tags_orange.css und tags_oxygen.css weitere CSS-Selektoren, die für eine grundlegende Formatierung der Auszeichnungslisten sorgen.<br /> Ein Nachrichtenbeitrag mit den dazugehörigen Auszeichnungen könnte dann z.B. folgendermaßen aussehen:<br /> <br /> [[Datei:auszeichnungsliste.png|center|frame|Darstellung einer Nachricht mit zugehörigen Auszeichnungen]]<br /> <br /> === Inhaltselemente ===<br /> Die tags-Erweiterung erweitert des Contao Inhaltselement '''Überschrift''' und fügt in den Experten-Einstellungen einen zusätzlichen Parameter '''Nur bei Auszeichnungen anzeigen''' ein. Wird dieses Feld ausgewählt, dann zeigt Contao die Überschrift nur dann an, wenn auf der betreffenden Seite Auszeichnungen verwendet werden, d.h. wenn von einer Tag Cloud über eine Auszeichnung auf die Seite verzweigt wird. Zu erkennen ist die am Paramter '''tag''' in der URL der Seite.<br /> <br /> [[Datei:heading_tags_only.png|center|frame|Auswahl 'Nur bei Auszeichnungen anzeigen' im Überschrift Inhaltselement]]<br /> <br /> Dieses Feld kann in Kombination mit dem Insert Tag &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt; z.B. dazu eingesetzt werden, eine für ausgewählte Tags passende Überschrift anzuzeigen, z.B. '''Auswahl der Teilnehmer &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''' =&gt; '''Auswahl der Teilnehmer (Kongress+Oktober+Hamburg)'''<br /> === Insert Tags ===<br /> <br /> tags führt die folgenden Insert Tags für Contao ein:<br /> <br /> * '''&lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der aktuell verwendeten Auszeichnungen, z.B. '''(Contao+Erweiterung+tags)'''<br /> * '''&lt;nowiki&gt;{{tags_news::news_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Nachrichtenbeitrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_news::1::3}}&lt;/nowiki&gt; die Auszeichnungen des Nachrichtenbeitrags mit der ID 1 an. Es werden maximal 3 Tags ausgegeben.<br /> * '''&lt;nowiki&gt;{{tags_event::event_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Kalendereintrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_event::1}}&lt;/nowiki&gt; die Auszeichnungen des Kalendereintrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article::article_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_article::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article_url::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen als URL auf den zugehörigen Artikel, z.B. zeigt &lt;nowiki&gt;{{tags_article_url::1::0::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an und verlinkt jede Auszeichnung mit der Seite des Artikels. Die gefundenen Tags werden nach Relevanz sortiert.<br /> * '''&lt;nowiki&gt;{{tags_content::content_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für ein Inhaltselement vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_content::1}}&lt;/nowiki&gt; die Auszeichnungen des Inhaltselements mit der ID 1 an.<br /> * '''&lt;nowiki&gt;{{tags_faq::faq_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen FAQ-Eintrag vergebenen Auszeichnungen als URL auf die aktuelle Seite, z.B. zeigt &lt;nowiki&gt;{{tags_faq::1}}&lt;/nowiki&gt; die Auszeichnungen des FAQ-Eintrags mit der ID 1 an.<br /> * '''&lt;nowiki&gt;{{tags_files::file_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für eine Datei vergebenen Auszeichnungen als URL auf die aktuelle Seite, z.B. zeigt &lt;nowiki&gt;{{tags_file::1::3::1::userfiles}}&lt;/nowiki&gt; die Auszeichnungen der Datei mit der ID 1 an. Es werden maximal 3 Tags, sortiert nach Relevanz ausgegeben. Die Tags verlinken auf eine Seite mit dem Alias ''userfiles''.<br /> <br /> die Paramter '''max_tags''', '''relevance''' und '''target''' sind optional und können weggelassen werden:<br /> <br /> * '''max_tags''' gibt eine obere Grenze für die Anzahl der Ergebnis-Tags an. Wird nichts angegeben, verwendet die Erweiterung intern 0, d.h. alle gefundenen Ergebnisse werden angegeben<br /> * '''relevance''' gibt die Relevanz des Ergebnisses an. Ist dieser Wert 0 (Standard), werden die Ergebnis-Tags alphabetisch sortiert, ist der Wert 1, werden die Ergebnis-Tags nach Häufigkeit sortiert, die am häufigsten verwendeten Tags werden dabei zuerst angegeben<br /> * '''target''' gibt eine andere Zielseite als die aktuelle Seite an. Hierbei handelt es sich entweder um die ID einer Contao-Seite, oder den Seiten-Alias. Als Standard verwendet die Erweiterung 0, d.h. es wird auf die aktuelle Seite weitergeleitet, auf der sich auch der Insert-Tag befindet<br /> <br /> === Ausgabe in Feeds ===<br /> Mit Version 1.7.2 ist auch die Ausgabe von tags zu Events (Kalendereinträgen) in Kalender-Feeds möglich, mit Version 1.7.3 die Ausgabe von tags zu Nachrichtenbeiträgen in News-Feeds. Standardmäßig werden diese Auszeichnungen als HTML-Liste nach der Beschreibung des Events bzw. des Nachrichtenbeitrags ausgegeben. Falls eine Ausgabe nicht erwünscht ist, so muss die folgende globale Variable updatesicher mit einem negativen Booleschen Wert überschrieben werden:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> $GLOBALS['tags']['showInFeeds'] = false;<br /> &lt;/source&gt;<br /> <br /> Diese Zeile fügt man dann am besten z.B. in die Datei '''&lt;nowiki&gt;system/config/localconfig.php&lt;/nowiki&gt;''' ein.<br /> Die Darstellung der Auszeichnungen im Newsfeed kann über das Template tags_feed beeinflusst werden.<br /> <br /> === Zusätzliche Contao-Module ===<br /> Die tags-Erweiterung führt die folgenden neuen Contao-Module ein:<br /> <br /> ==== Globale Artikelliste ====<br /> Mit der globalen Artikelliste kann man eine Liste aller verfügbaren Artikel einer Contao-Installation ausgeben lassen. In dieser Form ist das Modul natürlich nur bedingt sinnvoll. Wenn man die Ausgabe der Artikel einschränken möchte, wählt man besser das Core-Modul Artikelliste, das eine Artikelliste einer bestimmten Seite ausgeben kann. Die globale Artikelliste sollte hauptsächlich dazu verwendet werden, um aus einer Tag Cloud heraus aufgerufen zu werden. In diesem Fall wird eine Liste aller Artikel ausgegeben, die mit der ausgewählten Auszeichnung versehen wurden.<br /> <br /> ==== Verwendete Auszeichnungen ====<br /> Dieses Modul zeigt die auf einer Seite aktuell verwendeten Auszeichnungen an. Durch Anklicken der Auszeichnungen lässt sich nach eben diesen Filtern. Alle Auszeichnungen können zurückgesetzt werden. Einzelne Auszeichnungen können durch Anklicken aus der Auswahl entfernt werden.<br /> <br /> ==== Einstellungen für Nachrichtenmodule ====<br /> Für die Nachrichtenmodule '''Nachrichtenliste''', '''Nachrichtenarchiv''' und '''Nachrichtenleser''' gibt es eine Einstellung, die verhindert, dass diese Module auf Tags reagieren ('''Auszeichnungen ignorieren'''). Falls z.B. eine Nachrichtenliste der letzten Nachrichten ausgegeben wird, so würde sich die Ausgabe ändern, wenn die Seite über eine Tag Cloud aufgerufen wird. Um dies zu verhindern, kann diese Option ausgewählt werden.<br /> <br /> [[Datei:tags_ignore.png|center|frame|Ignorieren von Auszeichnungen in den Nachrichtenmodulen]]<br /> ==== Auszeichnungsobjekte ====<br /> Mit dem Frontend-Modul Auszeichnungsobjekte kann eine Liste eines bestimmten Inhalts-Objekttyps angezeigt werden. Als '''Objekttyp''' stehen die drei Inhaltstypen ''Seiten'', ''Artikel'' oder ''Inhaltselemente'' zur Verfügung. Der Objekttyp ist das Element, das in der Liste verlinkt wird, wenn eine Auszeichnung existiert. Bei einem ausgewählten Objekttyp ''Seiten'' werden also Links auf Contao-Seiten angezeigt, bei einem Objekttyp Artikel werden Links auf Contao Artikel angezeigt etc.<br /> <br /> Die '''Einschränkung auf Datenquelle''' legt fest, welche Auszeichnungen in der Liste verarbeitet werden sollen. Wird hier z.B. tl_article gewählt, werden nur Artikelauszeichnungen berücksichtigt. Wird tl_content ausgewählt, werden nur Auszeichnungen von Inhaltselementen berücksichtigt.<br /> <br /> Über '''Seiten''' muss man die Seite auswählen, die zur Erstellung der Objektliste verwendet werden soll. Wenn die Seite Unterseiten besitzt, so werden diese ebenfalls für die Generierung der Objektliste verwendet. Das heißt, es werden nur Auszeichnungen berücksichtigt, die für Inhalts-Objekte vergeben wurden, die sich auf der ausgewählten Seite oder deren Unterseiten befinden.<br /> <br /> '''Beispiel:'''<br /> * Objekttyp: Seiten<br /> * Einschränkung auf Datenquelle: tl_article<br /> * Seiten: Startpunkt der aktuellen Website<br /> <br /> Für ausgewählte Auszeichnungen wird eine Liste von Links auf Seiten angezeigt, bei deren Artikel die Auszeichnungen vergeben wurden. Berücksichtigt werden alle Seiten der aktuellen Website.<br /> <br /> <br /> [[Datei:auszeichnungsobjekte.png|center|frame|Einstellungen des Frontendmoduls Auszeichnungsobjekte]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 23:25, 24. Nov. 2011 (CET)</div>

Hschottm https://de.contaowiki.org/Tags 2014-02-23T08:11:31Z

<p>Hschottm: /* Insert Tags */</p> <hr /> <div>[[Kategorie:tags]]<br /> <br /> Auszeichnungen zum Kategorisieren von Elementen.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/tags<br /> | ExtVersion=3.2.0<br /> | Version=3.2.0 - 3.2.3<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/tags.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> | Comment=Versionen ältere Contao-Versionen verfügbar<br /> }}<br /> <br /> <br /> == Modul tags (Auszeichnungen) ==<br /> <br /> tags ist ein Contao-Modul zum Erstellen und Anzeigen von Auszeichnungen innerhalb von Contao. Mit Hilfe des Moduls lassen sich für Entwickler mit geringem Aufwand Auszeichnungen für beliebige Contao Datacontainer (Tabellen) hinzufügen. Es ist zu beachten, dass zum vollständigen Funktionieren der Erweiterung die Mootools Unterstützung im Contao Seitenlayout aktiviert sein muss.<br /> Das Modul stellt ein Eingabefeld-Widget zur Verfügung, das für den aktuellen Datacontainer, in dem es eingesetzt wird, die Auszeichnungen in der Datenbank ablegen und auslesen kann. Die Auszeichnungen werden dabei als kommagetrennte Liste von den Autoren eingegeben oder können, falls JavaScript aktiviert ist, per Mausklick hinzugefügt oder entfernt werden (dies gilt allerdings nur für bereits bestehende Auszeichnungen).<br /> <br /> [[Datei:tags_backend.png|center|frame|Eingabefeld für Auszeichnungen im Backend]]<br /> <br /> In der vorliegenden Abbildung sieht man, dass das ''title''-Attribut der URL einer Auszeichnung die Anzahl der Verwendung derselben anzeigt, d.h. neben dem Namen der Auszeichnung wird die Anzahl der Verwendungen in Klammern hinter den Namen ausgegeben. ''Mathematik (8)'' bedeutet also z.B., dass die Auszeichnung Mathematik insgesamt 8 Mal verwendet wird. <br /> <br /> Es ist zu beachten, dass pro Contao Datacontainer nur ein Eingabefeld für Auszeichnungen verwendet wird, da die Auszeichnungen immer nur für den gesamten Datacontainer vergeben werden und nicht für das zugrund liegende Eingabefeld.<br /> === Hinweise für Entwickler von eigenen Erweiterungen ===<br /> <br /> Nutzer, die Auszeichnungen nur Verwenden wollen und diese nicht in eigene Erweiterungen integrieren wollen, können den folgenden Absatz einfach [[#Verwenden_von_Auszeichnungen_im_Contao-Frontend|überspringen]].<br /> <br /> ==== Hinzufügen von Auszeichnungsfeldern in Contao Datacontainer ====<br /> <br /> Um ein Auszeichnungs-Eingabefeld in einen Contao Datacontainer einzufügen, werden die folgenden Schritte benötigt:<br /> <br /> # Um das Eingabefeld anzuzeigen, muss für den Datacontainer ein entsprechendes Datenbankfeld existieren. Da die Auszeichnungen nicht in diesem Datenbankfeld gespeichert werden, sondern in der speziell vom tags-Modul bereitgestellten Datenbanktabelle ''tl_tag'', reicht es, ein möglichst kleines Datenbankfeld zu erzeugen.<br /> # Das Eingabefeld muss in das DCA Konfigurationsarray eingefügt werden<br /> <br /> Ein neues Datenbankfeld erstellen Sie in der ''config/database.sql''-Datei des gewünschten Moduls. Ein Beispiel ist z.B.<br /> <br /> &lt;source lang=&quot;sql&quot;&gt;<br /> CREATE TABLE `tl_literature` (<br /> `tags` char(1) NOT NULL default ''<br /> ) ENGINE=MyISAM DEFAULT CHARSET=utf8;<br /> &lt;/source&gt;<br /> <br /> Um das Feld mit diesem Namen in das DCA-Konfigurationsarray zu integrieren, muss es in eine der Paletten des Konfigurationsarrays eingefügt werden und eine Felddefinition erstellt werden, also z.B.<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> '' Palettes<br /> 'palettes' =&gt; array(<br /> 'default' =&gt; 'title,author,description,tags,content'<br /> ),<br /> '' Fields<br /> 'fields' =&gt; array(<br /> 'tags' =&gt; array(<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['MSC']['tags'],<br /> 'inputType' =&gt; 'tag'<br /> )<br /> ),<br /> &lt;/source&gt;<br /> <br /> Mit ''$GLOBALS['TL_LANG']['MSC']['tags']'' stellt das tags-Modul bereits einen Standardbezeichner für ein Auszeichnungsfeld zur Verfügung. Man kann diesen natürlich jederzeit gegen eigene Spracheinträge austauschen.<br /> <br /> Beim Speichern eines Datacontainers werden während der Validierung der Daten die Auszeichnungen identifiziert und in der Datenbanktabelle ''tl_tag'' gespeichert. Abgelegt wird die ID des aktuellen Datacontainers (Tabellenfeld ''id''), der Tabellenname des Datacontainers (Tabellenfeld ''from_table'') und die Auszeichnung (Tabellenfeld ''tag'').<br /> <br /> ==== Optionen für das Evaluation-Array des Feldes ====<br /> <br /> {| border=&quot;1&quot; cellpadding=&quot;10&quot; cellspacing=&quot;0&quot; <br /> ! Schlüssel <br /> ! Wert <br /> ! Beschreibung<br /> |- style=&quot;vertical-align: top;&quot;<br /> | table || Quelltabelle ''string'' || Name der Quelltabelle, aus der die Auszeichnungen gebildet werden sollen. Der Standard ist der Name des aktuellen DCA Datencontainers. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | isTag || true/false ''boolean'' || Gibt an, ob der Inhalt des Feldes als Tag gespeichert werden soll oder nicht. Der Standard ist ''true''. Wenn der Inhalt des Feldes nicht als Tag gespeichert werden soll, wird der Feldinhalt ganz normal als kommagetrennte Zeichenkette in der Datenbank abgelegt. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | maxtags || Anzahl ''integer'' || Gibt die maximale Anzahl der Auszeichnungen an, die in der Tag Cloud zum Auswählen der Auszeichnungen angegeben werden. Wenn die Anzahl der verfügbaren Auszeichnungen größer ist, als maxtags, werden die Auszeichnungen mit den wenigsten Vorkommnissen nicht mehr angezeigt. <br /> |}<br /> <br /> === Verwenden von Auszeichnungen im Contao-Frontend ===<br /> Für die Verwendung im Contao-Frontend ist das Modul ''Tag Cloud'' vorgesehen. Das Modul erstellt eine HTML-Liste der für einen oder mehrere Datacontainer verwendeten Auszeichnungen. Um die Liste als Tag Cloud darzustellen, müssen die zugehörigen CSS-Selektoren mit Stilen versehen werden. Zwei Beispieldateien ''[[tags_oxygen.css]]'' und ''[[tags_orange.css]]'' finden sich im ''tl_files/tags''-Verzeichnis des Installationspakets der tags-Erweiterung. Es empfiehlt sich an, sich an diesen Stilen zu orientieren, da es bei der Verwendung der '''Top 10 Auszeichnungen''' darauf ankommt, welche Elemente der Tag Cloud durch die CSS-Stile sichtbar gemacht werden und welche nicht.<br /> <br /> [[Datei:tagcloud_settings_1.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen deaktiviert]]<br /> <br /> Im Eingabefeld '''Maximale Anzahl von Auszeichnungen''' kann man eine maximale Anzahl der anzuzeigenden Auszeichnungen für die Tag Cloud festlegen. Ein Wert von 0 oder kein Wert zeigt immer alle verfügbaren Auszeichnungen an. Bei einem Wert kleiner als die maximale Anzahl der verfügbaren Auszeichnungen werden nur die häufigsten Auszeichnungen gemäß der Vorgabe im Eingabefeld angezeigt. Es ist zu beachten, dass es dadurch möglich ist, dass nicht alle Auszeichnungen angezeigt werden. Man sollte für die Benutzer einen Hinweis vorhalten, der auf diesen Umstand aufmerksam macht.<br /> <br /> Im Eingabefeld '''Anzahl der Auszeichnungsgrößen''' kann man die Anzahl der verfügbaren CSS Selektoren für die Tag Cloud festlegen. Der Standardwert 4 erzeugt vier unterschiedliche Gruppen von Auszeichnungen mit den Selektoren size1, size2, size3 und size4, man kann also maximal 4 unterschiedliche Größen von Auszeichnungen im Frontend ausgeben. Es ist darauf zu achten, dass man immer für alle möglichen CSS Selektoren ein CSS-Element vorhält.<br /> <br /> Das Kontrollkästchen '''Auszeichnungs-Klassennamen verwenden''' fügt einen zusätzlichen CSS Klassennamen für jede Auszeichnung hinzu, der aus dem Namen der jweiligen Auszeichnung besteht. Damit können einzelne Auszeichnungen individuell per CSS angepasst werden. Leerzeichen in den Auszeichnungsnamen werden für die CSS-Klassennamen in Unterstriche umgewandelt.<br /> <br /> Mit dem Auswahlfeld '''Tag Cloud Template''' kann man das Template bestimmen, das für die Generierung der Tag Cloud im Frontend verwendet werden soll. Standardmäßig ist dies das Template ''mod_tagcloud''. Man kann sich aber auch eigene Templates erstellen und hier verwenden. Diese müssen dann lediglich mit der Zeichenkette mod_tagcloud beginnen, also z.B. mod_tagcloud_spezial etc.<br /> <br /> Das Kontrollkästchen '''Zugehörige Auszeichnungen''' zeigt im Frontend bei Auswahl mindestens einer Auszeichnung eine Liste weitere Auszeichnungen an, die im Zusammenhang mit der ausgewählten Auszeichnung vergeben wurden. Durch einen Klick auf eine dieser zugehörigen Auszeichnungen kann die Suche nach ausgezeichneten Objekten weiter eingeschränkt werden. Natürlich funktioniert die Anzeige der zugehörigen Auszeichnungen nur dann, wenn sich das Tag Cloud Modul auf einer Seite befindet, die sich in der Weiterleitung der Tag Cloud Hyperlinks befindet, da die Tag Cloud sonst keinerlei Kenntnis von bereits ausgewählten Auszeichnungen haben kann.<br /> <br /> Das Kontrollkästchen '''Top 10 Auszeichnungen''' erzeugt über der Tag Cloud eine weitere Tag Cloud, welche die 10 häufigsten Auszeichnungen beinhaltet, in der Reihenfolge des häufigsten Auftretens. Gleichzeitig ist dieses Kontrollkästchen ein Selektor, der bei Aktivierung zwei weitere Kontrollkästchen erzeugt:<br /> <br /> * '''Top 10 Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, sind die Top 10 Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> * '''Alle Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, ist die Tag Cloud mit allen Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> <br /> [[Datei:tagcloud_settings_1a.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen aktiviert]]<br /> <br /> Man wählt unter '''Weiterleitung zu Seite''' eine interne Contao-Seite aus, damit die Auszeichnungen der Tag Cloud mit Hyperlinks versehen werden. Die gewählte Seite wird dann immer mit dem URL-Parameter ''tag=TAGNAME'' aufgerufen, also z.B. ''http://www.meineseite.de/weiterleitung.html?tag=typolight''.<br /> <br /> <br /> [[Datei:tagcloud_settings_2.png|center|frame|Tabellenspezifische Eingabefelder des Tag Cloud Moduls im Backend]]<br /> <br /> Bei '''Einschränkung auf Tabelle(n)''' wählt man normalerweise immer nur den Datacontainer aus, für den die Tags gespeichert wurden.<br /> <br /> Die Felder '''Quell-Tabelle für Auszeichnungen''' und '''Tabellenfeld für Auszeichnungen''' werden mit den Standardeinträgen ''tl_tag'' und ''tag'' vorbelegt und sollten nur dann geändert werden, wenn man die Tags aus einer eigenen Tabelle beisteuern will.<br /> <br /> Mit den Feldern '''CSS-Id/Klasse''' kann man zusätzliche CSS-ID's oder Klassen vergeben, die dann im umschließenden DIV-Container der Tag Cloud eingebettet werden. Dadurch hat man die Möglichkeit individuelle Stile für die Tag Clouds einzusetzen.<br /> <br /> Im Frontend sieht die Tag Cloud dann z.B. folgendermaßen aus:<br /> <br /> [[Datei:tagcloud_frontend.png|center|frame|Ausgabe der Tag Cloud im Frontend]]<br /> <br /> bzw. mit aktivierten Top 10 Auszeichnungen:<br /> <br /> [[Datei:tags_topten.png|center|frame|Tag Cloud mit Top 10 Auszeichnungen]]<br /> <br /> bwz. mit aktivierten Top 10 und zugehörigen Auszeichnungen:<br /> <br /> [[Datei:tags_related.png|center|frame|Tag Cloud mit Top 10 und zugehörigen Auszeichnungen]]<br /> <br /> Werden zwei Tag Clouds (Top 10 + Alle) oder die zugehörigen Auszeichnungen angezeigt, bindet Contao ein JavaScript ein, das die jeweiligen Tag Clouds bei Mausklick auf den Titel einklappt bzw. ausklappt. Ist kein JavaScript aktiviert, so werden die dreieckigen Klappsymbole nicht angezeigt. Für einen optimale Zusammenarbeit mit der JavaScript-Erweiterung sollte man die installierten CSS-Dateien tags_oxygen.css oder tags_orange.css in die Seite einbinden.<br /> <br /> Die folgenden Contao-Elemente können mit Tags versehen werden:<br /> <br /> * Nachrichtenbeiträge<br /> * Artikel<br /> * Inhaltselemente<br /> * Kalender/Events<br /> * FAQ (ab Contao 2.11)<br /> * Dateien (ab Contao 3.1)<br /> <br /> ==== Weiterleitung zu Seiten über eine Tag Cloud ====<br /> <br /> Damit eine sinnvolle Weiterleitung aus einer Tag Cloud vorgenommen werden kann, muss die Seite, zu der weitergeleitet wird, den tag-Parameter in der URL interpretieren können. Hierin liegt die Hauptarbeit, wenn die Tag-Unterstützung für bestehende Contao-Datacontainer vorgenommen werden soll.<br /> <br /> Die folgenden Contao-Module reagieren auf einen Aufruf aus einer Tag Cloud heraus und zeigen nur die Elemente an, die mit der ausgewählten Auszeichnung versehen wurden:<br /> <br /> * Modul '''Nachrichtenarchiv''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Nachrichtenliste''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Globale Artikelliste''': Es werden Links auf alle Artikel angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Eventliste''': Es werden alle Events der ausgewählten Kalender im ausgewählten Zeitraum angezeigt, die mit der gesuchten Auszeichnung versehen sind.<br /> * Modul '''Auszeichnungsobjekte''': Es werden Inhaltselemente (Seiten, Artikel, Inhaltselemente) in einer Liste angezeigt, die mit einer bestimmten Auszeichnung versehen sind.<br /> <br /> ==== Ausgabe von Auszeichnungslisten zu Nachrichtenbeiträgen ====<br /> <br /> Bei der Ausgabe von Nachrichtenbeiträgen gibt es die Möglichkeit, unterhalb des Nachrichtenbeitrags die zum Beitrag zugehörigen Auszeichnungen anzeigen zu lassen. Zu diesem Zweck kann die Ausgabe der Auszeichnungen in den Frontend-Modulen zur Nachrichtenanzeige, '''Nachrichtenleser''', '''Nachrichtenliste''' und '''Nachrichtenarchiv''', aktiviert werden.<br /> <br /> [[Datei:tags_tag_settings.png|center|frame|Aktivierung einer Auszeichnungsliste im Modul des Contao Backends]]<br /> <br /> Mit der Option '''Auszeichnungen ignorieren''' werden von der Liste alle zur Filterung verwendeten Auszeichnungen verworfen.<br /> <br /> Wenn man die Option '''Nachrichten-Auszeichnungen anzeigen''' auswählt, erscheint zusätzlich ein Auswahl-Feld für eine Weiterleitungsseite, die aufgerufen wird, wenn aus eine der Auszeichnungen geklickt wird. Hier wählt man die Seite aus, auf die man auch aus der Tag Cloud heraus weiterleitet oder aber natürlich jede beliebige andere Seite, wenn man eine spezielle Behandlung der zu einer Nachrichten angeklickten Auszeichnungen wünscht.<br /> <br /> Um, wie bei den Tag Clouds die Namen der individuellen CSS-Klassen der jeweiligen Auszeichnungen anzuzeigen, wurde die Option &quot;Auszeichnungs-Klassennamen verwenden&quot; eingeführt. Diese verwendet die individuelle CSS-Klasse in allen Auszeichnungen, die unterhalb eines Nachrichtenbeitrags angezeigt werden.<br /> <br /> Damit eine Ausgabe der Auszeichnungen im Frontend auch wirklich ausgeführt wird, muss man außerdem die '''Nachrichtenvorlage''' des Moduls anpassen. Speziell für diesen Zweck wurde mit der tags-Erweiterung das Template ''news_full_tags'' erstellt, das den entsprechenden HTML-Code zur Ausgabe der Auszeichnungen unterhalb eines Nachrichtenbeitrags bereitstellt. Wenn man ein anderes Template für die Ausgabe verwenden will und die Ausgabe der Auszeichnungen zu einem Nachrichtenbeitrag wünscht, sollte man den im Template news_full_tags hinzugekommenen Quellcode kopieren und in das gewünschte Template einfügen:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> &lt;?php if ($this-&gt;showTags): ?&gt;<br /> <br /> &lt;?php if (count($this-&gt;taglist)): ?&gt;<br /> &lt;ul class=&quot;tag-chain&quot;&gt;<br /> &lt;?php $counter = 0; foreach ($this-&gt;taglist as $tag): ?&gt;<br /> &lt;li class=&quot;tag-chain-item&lt;?php if ($counter == 0) echo ' first'; ?&gt;<br /> &lt;?php if ($counter == count($this-&gt;taglist)-1) echo ' last'; ?&gt;<br /> &lt;?php if ($this-&gt;showTagClass) echo ' ' . $tag['class']; ?&gt;&quot;&gt;&lt;?php echo $tag['url']; ?&gt;&lt;/li&gt;<br /> &lt;?php $counter++; endforeach; ?&gt;<br /> &lt;/ul&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;/source&gt;<br /> <br /> Für die Ausgabe der Auszeichnungen enthalten die in der Erweiterung mitgelieferten CSS-Dateien tags_orange.css und tags_oxygen.css weitere CSS-Selektoren, die für eine grundlegende Formatierung der Auszeichnungslisten sorgen.<br /> Ein Nachrichtenbeitrag mit den dazugehörigen Auszeichnungen könnte dann z.B. folgendermaßen aussehen:<br /> <br /> [[Datei:auszeichnungsliste.png|center|frame|Darstellung einer Nachricht mit zugehörigen Auszeichnungen]]<br /> <br /> === Inhaltselemente ===<br /> Die tags-Erweiterung erweitert des Contao Inhaltselement '''Überschrift''' und fügt in den Experten-Einstellungen einen zusätzlichen Parameter '''Nur bei Auszeichnungen anzeigen''' ein. Wird dieses Feld ausgewählt, dann zeigt Contao die Überschrift nur dann an, wenn auf der betreffenden Seite Auszeichnungen verwendet werden, d.h. wenn von einer Tag Cloud über eine Auszeichnung auf die Seite verzweigt wird. Zu erkennen ist die am Paramter '''tag''' in der URL der Seite.<br /> <br /> [[Datei:heading_tags_only.png|center|frame|Auswahl 'Nur bei Auszeichnungen anzeigen' im Überschrift Inhaltselement]]<br /> <br /> Dieses Feld kann in Kombination mit dem Insert Tag &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt; z.B. dazu eingesetzt werden, eine für ausgewählte Tags passende Überschrift anzuzeigen, z.B. '''Auswahl der Teilnehmer &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''' =&gt; '''Auswahl der Teilnehmer (Kongress+Oktober+Hamburg)'''<br /> === Insert Tags ===<br /> <br /> tags führt die folgenden Insert Tags für Contao ein:<br /> <br /> * '''&lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der aktuell verwendeten Auszeichnungen, z.B. '''(Contao+Erweiterung+tags)'''<br /> * '''&lt;nowiki&gt;{{tags_news::news_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Nachrichtenbeitrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_news::1}}&lt;/nowiki&gt; die Auszeichnungen des Nachrichtenbeitrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_event::event_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Kalendereintrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_event::1}}&lt;/nowiki&gt; die Auszeichnungen des Kalendereintrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article::article_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_article::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article_url::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen als URL auf den zugehörigen Artikel, z.B. zeigt &lt;nowiki&gt;{{tags_article_url::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an und verlinkt jede Auszeichnung mit der Seite des Artikels. <br /> * '''&lt;nowiki&gt;{{tags_content::content_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für ein Inhaltselement vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_content::1}}&lt;/nowiki&gt; die Auszeichnungen des Inhaltselements mit der ID 1 an.<br /> * '''&lt;nowiki&gt;{{tags_faq::faq_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen FAQ-Eintrag vergebenen Auszeichnungen als URL auf die aktuelle Seite, z.B. zeigt &lt;nowiki&gt;{{tags_faq::1}}&lt;/nowiki&gt; die Auszeichnungen des FAQ-Eintrags mit der ID 1 an.<br /> * '''&lt;nowiki&gt;{{tags_files::file_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für eine Datei vergebenen Auszeichnungen als URL auf die aktuelle Seite, z.B. zeigt &lt;nowiki&gt;{{tags_file::1}}&lt;/nowiki&gt; die Auszeichnungen der Datei mit der ID 1 an.<br /> <br /> die Paramter '''max_tags''', '''relevance''' und '''target''' sind optional und können weggelassen werden:<br /> <br /> * '''max_tags''' gibt eine obere Grenze für die Anzahl der Ergebnis-Tags an. Wird nichts angegeben, verwendet die Erweiterung intern 0, d.h. alle gefundenen Ergebnisse werden angegeben<br /> * '''relevance''' gibt die Relevanz des Ergebnisses an. Ist dieser Wert 0 (Standard), werden die Ergebnis-Tags alphabetisch sortiert, ist der Wert 1, werden die Ergebnis-Tags nach Häufigkeit sortiert, die am häufigsten verwendeten Tags werden dabei zuerst angegeben<br /> * '''target''' gibt eine andere Zielseite als die aktuelle Seite an. Hierbei handelt es sich entweder um die ID einer Contao-Seite, oder den Seiten-Alias. Als Standard verwendet die Erweiterung 0, d.h. es wird auf die aktuelle Seite weitergeleitet, auf der sich auch der Insert-Tag befindet<br /> <br /> === Ausgabe in Feeds ===<br /> Mit Version 1.7.2 ist auch die Ausgabe von tags zu Events (Kalendereinträgen) in Kalender-Feeds möglich, mit Version 1.7.3 die Ausgabe von tags zu Nachrichtenbeiträgen in News-Feeds. Standardmäßig werden diese Auszeichnungen als HTML-Liste nach der Beschreibung des Events bzw. des Nachrichtenbeitrags ausgegeben. Falls eine Ausgabe nicht erwünscht ist, so muss die folgende globale Variable updatesicher mit einem negativen Booleschen Wert überschrieben werden:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> $GLOBALS['tags']['showInFeeds'] = false;<br /> &lt;/source&gt;<br /> <br /> Diese Zeile fügt man dann am besten z.B. in die Datei '''&lt;nowiki&gt;system/config/localconfig.php&lt;/nowiki&gt;''' ein.<br /> Die Darstellung der Auszeichnungen im Newsfeed kann über das Template tags_feed beeinflusst werden.<br /> <br /> === Zusätzliche Contao-Module ===<br /> Die tags-Erweiterung führt die folgenden neuen Contao-Module ein:<br /> <br /> ==== Globale Artikelliste ====<br /> Mit der globalen Artikelliste kann man eine Liste aller verfügbaren Artikel einer Contao-Installation ausgeben lassen. In dieser Form ist das Modul natürlich nur bedingt sinnvoll. Wenn man die Ausgabe der Artikel einschränken möchte, wählt man besser das Core-Modul Artikelliste, das eine Artikelliste einer bestimmten Seite ausgeben kann. Die globale Artikelliste sollte hauptsächlich dazu verwendet werden, um aus einer Tag Cloud heraus aufgerufen zu werden. In diesem Fall wird eine Liste aller Artikel ausgegeben, die mit der ausgewählten Auszeichnung versehen wurden.<br /> <br /> ==== Verwendete Auszeichnungen ====<br /> Dieses Modul zeigt die auf einer Seite aktuell verwendeten Auszeichnungen an. Durch Anklicken der Auszeichnungen lässt sich nach eben diesen Filtern. Alle Auszeichnungen können zurückgesetzt werden. Einzelne Auszeichnungen können durch Anklicken aus der Auswahl entfernt werden.<br /> <br /> ==== Einstellungen für Nachrichtenmodule ====<br /> Für die Nachrichtenmodule '''Nachrichtenliste''', '''Nachrichtenarchiv''' und '''Nachrichtenleser''' gibt es eine Einstellung, die verhindert, dass diese Module auf Tags reagieren ('''Auszeichnungen ignorieren'''). Falls z.B. eine Nachrichtenliste der letzten Nachrichten ausgegeben wird, so würde sich die Ausgabe ändern, wenn die Seite über eine Tag Cloud aufgerufen wird. Um dies zu verhindern, kann diese Option ausgewählt werden.<br /> <br /> [[Datei:tags_ignore.png|center|frame|Ignorieren von Auszeichnungen in den Nachrichtenmodulen]]<br /> ==== Auszeichnungsobjekte ====<br /> Mit dem Frontend-Modul Auszeichnungsobjekte kann eine Liste eines bestimmten Inhalts-Objekttyps angezeigt werden. Als '''Objekttyp''' stehen die drei Inhaltstypen ''Seiten'', ''Artikel'' oder ''Inhaltselemente'' zur Verfügung. Der Objekttyp ist das Element, das in der Liste verlinkt wird, wenn eine Auszeichnung existiert. Bei einem ausgewählten Objekttyp ''Seiten'' werden also Links auf Contao-Seiten angezeigt, bei einem Objekttyp Artikel werden Links auf Contao Artikel angezeigt etc.<br /> <br /> Die '''Einschränkung auf Datenquelle''' legt fest, welche Auszeichnungen in der Liste verarbeitet werden sollen. Wird hier z.B. tl_article gewählt, werden nur Artikelauszeichnungen berücksichtigt. Wird tl_content ausgewählt, werden nur Auszeichnungen von Inhaltselementen berücksichtigt.<br /> <br /> Über '''Seiten''' muss man die Seite auswählen, die zur Erstellung der Objektliste verwendet werden soll. Wenn die Seite Unterseiten besitzt, so werden diese ebenfalls für die Generierung der Objektliste verwendet. Das heißt, es werden nur Auszeichnungen berücksichtigt, die für Inhalts-Objekte vergeben wurden, die sich auf der ausgewählten Seite oder deren Unterseiten befinden.<br /> <br /> '''Beispiel:'''<br /> * Objekttyp: Seiten<br /> * Einschränkung auf Datenquelle: tl_article<br /> * Seiten: Startpunkt der aktuellen Website<br /> <br /> Für ausgewählte Auszeichnungen wird eine Liste von Links auf Seiten angezeigt, bei deren Artikel die Auszeichnungen vergeben wurden. Berücksichtigt werden alle Seiten der aktuellen Website.<br /> <br /> <br /> [[Datei:auszeichnungsobjekte.png|center|frame|Einstellungen des Frontendmoduls Auszeichnungsobjekte]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 23:25, 24. Nov. 2011 (CET)</div>

Hschottm https://de.contaowiki.org/Tags 2014-02-23T08:11:17Z

<p>Hschottm: Added parameters and additional description</p> <hr /> <div>[[Kategorie:tags]]<br /> <br /> Auszeichnungen zum Kategorisieren von Elementen.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/tags<br /> | ExtVersion=3.2.0<br /> | Version=3.2.0 - 3.2.3<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/tags.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> | Comment=Versionen ältere Contao-Versionen verfügbar<br /> }}<br /> <br /> <br /> == Modul tags (Auszeichnungen) ==<br /> <br /> tags ist ein Contao-Modul zum Erstellen und Anzeigen von Auszeichnungen innerhalb von Contao. Mit Hilfe des Moduls lassen sich für Entwickler mit geringem Aufwand Auszeichnungen für beliebige Contao Datacontainer (Tabellen) hinzufügen. Es ist zu beachten, dass zum vollständigen Funktionieren der Erweiterung die Mootools Unterstützung im Contao Seitenlayout aktiviert sein muss.<br /> Das Modul stellt ein Eingabefeld-Widget zur Verfügung, das für den aktuellen Datacontainer, in dem es eingesetzt wird, die Auszeichnungen in der Datenbank ablegen und auslesen kann. Die Auszeichnungen werden dabei als kommagetrennte Liste von den Autoren eingegeben oder können, falls JavaScript aktiviert ist, per Mausklick hinzugefügt oder entfernt werden (dies gilt allerdings nur für bereits bestehende Auszeichnungen).<br /> <br /> [[Datei:tags_backend.png|center|frame|Eingabefeld für Auszeichnungen im Backend]]<br /> <br /> In der vorliegenden Abbildung sieht man, dass das ''title''-Attribut der URL einer Auszeichnung die Anzahl der Verwendung derselben anzeigt, d.h. neben dem Namen der Auszeichnung wird die Anzahl der Verwendungen in Klammern hinter den Namen ausgegeben. ''Mathematik (8)'' bedeutet also z.B., dass die Auszeichnung Mathematik insgesamt 8 Mal verwendet wird. <br /> <br /> Es ist zu beachten, dass pro Contao Datacontainer nur ein Eingabefeld für Auszeichnungen verwendet wird, da die Auszeichnungen immer nur für den gesamten Datacontainer vergeben werden und nicht für das zugrund liegende Eingabefeld.<br /> === Hinweise für Entwickler von eigenen Erweiterungen ===<br /> <br /> Nutzer, die Auszeichnungen nur Verwenden wollen und diese nicht in eigene Erweiterungen integrieren wollen, können den folgenden Absatz einfach [[#Verwenden_von_Auszeichnungen_im_Contao-Frontend|überspringen]].<br /> <br /> ==== Hinzufügen von Auszeichnungsfeldern in Contao Datacontainer ====<br /> <br /> Um ein Auszeichnungs-Eingabefeld in einen Contao Datacontainer einzufügen, werden die folgenden Schritte benötigt:<br /> <br /> # Um das Eingabefeld anzuzeigen, muss für den Datacontainer ein entsprechendes Datenbankfeld existieren. Da die Auszeichnungen nicht in diesem Datenbankfeld gespeichert werden, sondern in der speziell vom tags-Modul bereitgestellten Datenbanktabelle ''tl_tag'', reicht es, ein möglichst kleines Datenbankfeld zu erzeugen.<br /> # Das Eingabefeld muss in das DCA Konfigurationsarray eingefügt werden<br /> <br /> Ein neues Datenbankfeld erstellen Sie in der ''config/database.sql''-Datei des gewünschten Moduls. Ein Beispiel ist z.B.<br /> <br /> &lt;source lang=&quot;sql&quot;&gt;<br /> CREATE TABLE `tl_literature` (<br /> `tags` char(1) NOT NULL default ''<br /> ) ENGINE=MyISAM DEFAULT CHARSET=utf8;<br /> &lt;/source&gt;<br /> <br /> Um das Feld mit diesem Namen in das DCA-Konfigurationsarray zu integrieren, muss es in eine der Paletten des Konfigurationsarrays eingefügt werden und eine Felddefinition erstellt werden, also z.B.<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> '' Palettes<br /> 'palettes' =&gt; array(<br /> 'default' =&gt; 'title,author,description,tags,content'<br /> ),<br /> '' Fields<br /> 'fields' =&gt; array(<br /> 'tags' =&gt; array(<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['MSC']['tags'],<br /> 'inputType' =&gt; 'tag'<br /> )<br /> ),<br /> &lt;/source&gt;<br /> <br /> Mit ''$GLOBALS['TL_LANG']['MSC']['tags']'' stellt das tags-Modul bereits einen Standardbezeichner für ein Auszeichnungsfeld zur Verfügung. Man kann diesen natürlich jederzeit gegen eigene Spracheinträge austauschen.<br /> <br /> Beim Speichern eines Datacontainers werden während der Validierung der Daten die Auszeichnungen identifiziert und in der Datenbanktabelle ''tl_tag'' gespeichert. Abgelegt wird die ID des aktuellen Datacontainers (Tabellenfeld ''id''), der Tabellenname des Datacontainers (Tabellenfeld ''from_table'') und die Auszeichnung (Tabellenfeld ''tag'').<br /> <br /> ==== Optionen für das Evaluation-Array des Feldes ====<br /> <br /> {| border=&quot;1&quot; cellpadding=&quot;10&quot; cellspacing=&quot;0&quot; <br /> ! Schlüssel <br /> ! Wert <br /> ! Beschreibung<br /> |- style=&quot;vertical-align: top;&quot;<br /> | table || Quelltabelle ''string'' || Name der Quelltabelle, aus der die Auszeichnungen gebildet werden sollen. Der Standard ist der Name des aktuellen DCA Datencontainers. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | isTag || true/false ''boolean'' || Gibt an, ob der Inhalt des Feldes als Tag gespeichert werden soll oder nicht. Der Standard ist ''true''. Wenn der Inhalt des Feldes nicht als Tag gespeichert werden soll, wird der Feldinhalt ganz normal als kommagetrennte Zeichenkette in der Datenbank abgelegt. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | maxtags || Anzahl ''integer'' || Gibt die maximale Anzahl der Auszeichnungen an, die in der Tag Cloud zum Auswählen der Auszeichnungen angegeben werden. Wenn die Anzahl der verfügbaren Auszeichnungen größer ist, als maxtags, werden die Auszeichnungen mit den wenigsten Vorkommnissen nicht mehr angezeigt. <br /> |}<br /> <br /> === Verwenden von Auszeichnungen im Contao-Frontend ===<br /> Für die Verwendung im Contao-Frontend ist das Modul ''Tag Cloud'' vorgesehen. Das Modul erstellt eine HTML-Liste der für einen oder mehrere Datacontainer verwendeten Auszeichnungen. Um die Liste als Tag Cloud darzustellen, müssen die zugehörigen CSS-Selektoren mit Stilen versehen werden. Zwei Beispieldateien ''[[tags_oxygen.css]]'' und ''[[tags_orange.css]]'' finden sich im ''tl_files/tags''-Verzeichnis des Installationspakets der tags-Erweiterung. Es empfiehlt sich an, sich an diesen Stilen zu orientieren, da es bei der Verwendung der '''Top 10 Auszeichnungen''' darauf ankommt, welche Elemente der Tag Cloud durch die CSS-Stile sichtbar gemacht werden und welche nicht.<br /> <br /> [[Datei:tagcloud_settings_1.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen deaktiviert]]<br /> <br /> Im Eingabefeld '''Maximale Anzahl von Auszeichnungen''' kann man eine maximale Anzahl der anzuzeigenden Auszeichnungen für die Tag Cloud festlegen. Ein Wert von 0 oder kein Wert zeigt immer alle verfügbaren Auszeichnungen an. Bei einem Wert kleiner als die maximale Anzahl der verfügbaren Auszeichnungen werden nur die häufigsten Auszeichnungen gemäß der Vorgabe im Eingabefeld angezeigt. Es ist zu beachten, dass es dadurch möglich ist, dass nicht alle Auszeichnungen angezeigt werden. Man sollte für die Benutzer einen Hinweis vorhalten, der auf diesen Umstand aufmerksam macht.<br /> <br /> Im Eingabefeld '''Anzahl der Auszeichnungsgrößen''' kann man die Anzahl der verfügbaren CSS Selektoren für die Tag Cloud festlegen. Der Standardwert 4 erzeugt vier unterschiedliche Gruppen von Auszeichnungen mit den Selektoren size1, size2, size3 und size4, man kann also maximal 4 unterschiedliche Größen von Auszeichnungen im Frontend ausgeben. Es ist darauf zu achten, dass man immer für alle möglichen CSS Selektoren ein CSS-Element vorhält.<br /> <br /> Das Kontrollkästchen '''Auszeichnungs-Klassennamen verwenden''' fügt einen zusätzlichen CSS Klassennamen für jede Auszeichnung hinzu, der aus dem Namen der jweiligen Auszeichnung besteht. Damit können einzelne Auszeichnungen individuell per CSS angepasst werden. Leerzeichen in den Auszeichnungsnamen werden für die CSS-Klassennamen in Unterstriche umgewandelt.<br /> <br /> Mit dem Auswahlfeld '''Tag Cloud Template''' kann man das Template bestimmen, das für die Generierung der Tag Cloud im Frontend verwendet werden soll. Standardmäßig ist dies das Template ''mod_tagcloud''. Man kann sich aber auch eigene Templates erstellen und hier verwenden. Diese müssen dann lediglich mit der Zeichenkette mod_tagcloud beginnen, also z.B. mod_tagcloud_spezial etc.<br /> <br /> Das Kontrollkästchen '''Zugehörige Auszeichnungen''' zeigt im Frontend bei Auswahl mindestens einer Auszeichnung eine Liste weitere Auszeichnungen an, die im Zusammenhang mit der ausgewählten Auszeichnung vergeben wurden. Durch einen Klick auf eine dieser zugehörigen Auszeichnungen kann die Suche nach ausgezeichneten Objekten weiter eingeschränkt werden. Natürlich funktioniert die Anzeige der zugehörigen Auszeichnungen nur dann, wenn sich das Tag Cloud Modul auf einer Seite befindet, die sich in der Weiterleitung der Tag Cloud Hyperlinks befindet, da die Tag Cloud sonst keinerlei Kenntnis von bereits ausgewählten Auszeichnungen haben kann.<br /> <br /> Das Kontrollkästchen '''Top 10 Auszeichnungen''' erzeugt über der Tag Cloud eine weitere Tag Cloud, welche die 10 häufigsten Auszeichnungen beinhaltet, in der Reihenfolge des häufigsten Auftretens. Gleichzeitig ist dieses Kontrollkästchen ein Selektor, der bei Aktivierung zwei weitere Kontrollkästchen erzeugt:<br /> <br /> * '''Top 10 Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, sind die Top 10 Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> * '''Alle Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, ist die Tag Cloud mit allen Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> <br /> [[Datei:tagcloud_settings_1a.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen aktiviert]]<br /> <br /> Man wählt unter '''Weiterleitung zu Seite''' eine interne Contao-Seite aus, damit die Auszeichnungen der Tag Cloud mit Hyperlinks versehen werden. Die gewählte Seite wird dann immer mit dem URL-Parameter ''tag=TAGNAME'' aufgerufen, also z.B. ''http://www.meineseite.de/weiterleitung.html?tag=typolight''.<br /> <br /> <br /> [[Datei:tagcloud_settings_2.png|center|frame|Tabellenspezifische Eingabefelder des Tag Cloud Moduls im Backend]]<br /> <br /> Bei '''Einschränkung auf Tabelle(n)''' wählt man normalerweise immer nur den Datacontainer aus, für den die Tags gespeichert wurden.<br /> <br /> Die Felder '''Quell-Tabelle für Auszeichnungen''' und '''Tabellenfeld für Auszeichnungen''' werden mit den Standardeinträgen ''tl_tag'' und ''tag'' vorbelegt und sollten nur dann geändert werden, wenn man die Tags aus einer eigenen Tabelle beisteuern will.<br /> <br /> Mit den Feldern '''CSS-Id/Klasse''' kann man zusätzliche CSS-ID's oder Klassen vergeben, die dann im umschließenden DIV-Container der Tag Cloud eingebettet werden. Dadurch hat man die Möglichkeit individuelle Stile für die Tag Clouds einzusetzen.<br /> <br /> Im Frontend sieht die Tag Cloud dann z.B. folgendermaßen aus:<br /> <br /> [[Datei:tagcloud_frontend.png|center|frame|Ausgabe der Tag Cloud im Frontend]]<br /> <br /> bzw. mit aktivierten Top 10 Auszeichnungen:<br /> <br /> [[Datei:tags_topten.png|center|frame|Tag Cloud mit Top 10 Auszeichnungen]]<br /> <br /> bwz. mit aktivierten Top 10 und zugehörigen Auszeichnungen:<br /> <br /> [[Datei:tags_related.png|center|frame|Tag Cloud mit Top 10 und zugehörigen Auszeichnungen]]<br /> <br /> Werden zwei Tag Clouds (Top 10 + Alle) oder die zugehörigen Auszeichnungen angezeigt, bindet Contao ein JavaScript ein, das die jeweiligen Tag Clouds bei Mausklick auf den Titel einklappt bzw. ausklappt. Ist kein JavaScript aktiviert, so werden die dreieckigen Klappsymbole nicht angezeigt. Für einen optimale Zusammenarbeit mit der JavaScript-Erweiterung sollte man die installierten CSS-Dateien tags_oxygen.css oder tags_orange.css in die Seite einbinden.<br /> <br /> Die folgenden Contao-Elemente können mit Tags versehen werden:<br /> <br /> * Nachrichtenbeiträge<br /> * Artikel<br /> * Inhaltselemente<br /> * Kalender/Events<br /> * FAQ (ab Contao 2.11)<br /> * Dateien (ab Contao 3.1)<br /> <br /> ==== Weiterleitung zu Seiten über eine Tag Cloud ====<br /> <br /> Damit eine sinnvolle Weiterleitung aus einer Tag Cloud vorgenommen werden kann, muss die Seite, zu der weitergeleitet wird, den tag-Parameter in der URL interpretieren können. Hierin liegt die Hauptarbeit, wenn die Tag-Unterstützung für bestehende Contao-Datacontainer vorgenommen werden soll.<br /> <br /> Die folgenden Contao-Module reagieren auf einen Aufruf aus einer Tag Cloud heraus und zeigen nur die Elemente an, die mit der ausgewählten Auszeichnung versehen wurden:<br /> <br /> * Modul '''Nachrichtenarchiv''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Nachrichtenliste''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Globale Artikelliste''': Es werden Links auf alle Artikel angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Eventliste''': Es werden alle Events der ausgewählten Kalender im ausgewählten Zeitraum angezeigt, die mit der gesuchten Auszeichnung versehen sind.<br /> * Modul '''Auszeichnungsobjekte''': Es werden Inhaltselemente (Seiten, Artikel, Inhaltselemente) in einer Liste angezeigt, die mit einer bestimmten Auszeichnung versehen sind.<br /> <br /> ==== Ausgabe von Auszeichnungslisten zu Nachrichtenbeiträgen ====<br /> <br /> Bei der Ausgabe von Nachrichtenbeiträgen gibt es die Möglichkeit, unterhalb des Nachrichtenbeitrags die zum Beitrag zugehörigen Auszeichnungen anzeigen zu lassen. Zu diesem Zweck kann die Ausgabe der Auszeichnungen in den Frontend-Modulen zur Nachrichtenanzeige, '''Nachrichtenleser''', '''Nachrichtenliste''' und '''Nachrichtenarchiv''', aktiviert werden.<br /> <br /> [[Datei:tags_tag_settings.png|center|frame|Aktivierung einer Auszeichnungsliste im Modul des Contao Backends]]<br /> <br /> Mit der Option '''Auszeichnungen ignorieren''' werden von der Liste alle zur Filterung verwendeten Auszeichnungen verworfen.<br /> <br /> Wenn man die Option '''Nachrichten-Auszeichnungen anzeigen''' auswählt, erscheint zusätzlich ein Auswahl-Feld für eine Weiterleitungsseite, die aufgerufen wird, wenn aus eine der Auszeichnungen geklickt wird. Hier wählt man die Seite aus, auf die man auch aus der Tag Cloud heraus weiterleitet oder aber natürlich jede beliebige andere Seite, wenn man eine spezielle Behandlung der zu einer Nachrichten angeklickten Auszeichnungen wünscht.<br /> <br /> Um, wie bei den Tag Clouds die Namen der individuellen CSS-Klassen der jeweiligen Auszeichnungen anzuzeigen, wurde die Option &quot;Auszeichnungs-Klassennamen verwenden&quot; eingeführt. Diese verwendet die individuelle CSS-Klasse in allen Auszeichnungen, die unterhalb eines Nachrichtenbeitrags angezeigt werden.<br /> <br /> Damit eine Ausgabe der Auszeichnungen im Frontend auch wirklich ausgeführt wird, muss man außerdem die '''Nachrichtenvorlage''' des Moduls anpassen. Speziell für diesen Zweck wurde mit der tags-Erweiterung das Template ''news_full_tags'' erstellt, das den entsprechenden HTML-Code zur Ausgabe der Auszeichnungen unterhalb eines Nachrichtenbeitrags bereitstellt. Wenn man ein anderes Template für die Ausgabe verwenden will und die Ausgabe der Auszeichnungen zu einem Nachrichtenbeitrag wünscht, sollte man den im Template news_full_tags hinzugekommenen Quellcode kopieren und in das gewünschte Template einfügen:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> &lt;?php if ($this-&gt;showTags): ?&gt;<br /> <br /> &lt;?php if (count($this-&gt;taglist)): ?&gt;<br /> &lt;ul class=&quot;tag-chain&quot;&gt;<br /> &lt;?php $counter = 0; foreach ($this-&gt;taglist as $tag): ?&gt;<br /> &lt;li class=&quot;tag-chain-item&lt;?php if ($counter == 0) echo ' first'; ?&gt;<br /> &lt;?php if ($counter == count($this-&gt;taglist)-1) echo ' last'; ?&gt;<br /> &lt;?php if ($this-&gt;showTagClass) echo ' ' . $tag['class']; ?&gt;&quot;&gt;&lt;?php echo $tag['url']; ?&gt;&lt;/li&gt;<br /> &lt;?php $counter++; endforeach; ?&gt;<br /> &lt;/ul&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;/source&gt;<br /> <br /> Für die Ausgabe der Auszeichnungen enthalten die in der Erweiterung mitgelieferten CSS-Dateien tags_orange.css und tags_oxygen.css weitere CSS-Selektoren, die für eine grundlegende Formatierung der Auszeichnungslisten sorgen.<br /> Ein Nachrichtenbeitrag mit den dazugehörigen Auszeichnungen könnte dann z.B. folgendermaßen aussehen:<br /> <br /> [[Datei:auszeichnungsliste.png|center|frame|Darstellung einer Nachricht mit zugehörigen Auszeichnungen]]<br /> <br /> === Inhaltselemente ===<br /> Die tags-Erweiterung erweitert des Contao Inhaltselement '''Überschrift''' und fügt in den Experten-Einstellungen einen zusätzlichen Parameter '''Nur bei Auszeichnungen anzeigen''' ein. Wird dieses Feld ausgewählt, dann zeigt Contao die Überschrift nur dann an, wenn auf der betreffenden Seite Auszeichnungen verwendet werden, d.h. wenn von einer Tag Cloud über eine Auszeichnung auf die Seite verzweigt wird. Zu erkennen ist die am Paramter '''tag''' in der URL der Seite.<br /> <br /> [[Datei:heading_tags_only.png|center|frame|Auswahl 'Nur bei Auszeichnungen anzeigen' im Überschrift Inhaltselement]]<br /> <br /> Dieses Feld kann in Kombination mit dem Insert Tag &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt; z.B. dazu eingesetzt werden, eine für ausgewählte Tags passende Überschrift anzuzeigen, z.B. '''Auswahl der Teilnehmer &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''' =&gt; '''Auswahl der Teilnehmer (Kongress+Oktober+Hamburg)'''<br /> === Insert Tags ===<br /> <br /> tags führt die folgenden Insert Tags für Contao ein:<br /> <br /> * '''&lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der aktuell verwendeten Auszeichnungen, z.B. '''(Contao+Erweiterung+tags)'''<br /> * '''&lt;nowiki&gt;{{tags_news::news_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Nachrichtenbeitrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_news::1}}&lt;/nowiki&gt; die Auszeichnungen des Nachrichtenbeitrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_event::event_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Kalendereintrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_event::1}}&lt;/nowiki&gt; die Auszeichnungen des Kalendereintrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article::article_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_article::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article_url::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen als URL auf den zugehörigen Artikel, z.B. zeigt &lt;nowiki&gt;{{tags_article_url::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an und verlinkt jede Auszeichnung mit der Seite des Artikels. <br /> * '''&lt;nowiki&gt;{{tags_content::content_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für ein Inhaltselement vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_content::1}}&lt;/nowiki&gt; die Auszeichnungen des Inhaltselements mit der ID 1 an.<br /> * '''&lt;nowiki&gt;{{tags_faq::faq_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen FAQ-Eintrag vergebenen Auszeichnungen als URL auf die aktuelle Seite, z.B. zeigt &lt;nowiki&gt;{{tags_faq::1}}&lt;/nowiki&gt; die Auszeichnungen des FAQ-Eintrags mit der ID 1 an.<br /> * '''&lt;nowiki&gt;{{tags_files::file_id::max_tags::relevance::target}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für eine Datei vergebenen Auszeichnungen als URL auf die aktuelle Seite, z.B. zeigt &lt;nowiki&gt;{{tags_file::1}}&lt;/nowiki&gt; die Auszeichnungen der Datei mit der ID 1 an.<br /> <br /> die Paramter '''max_tags''', '''relevance''' und '''target''' sind optional und können weggelassen werden:<br /> <br /> * '''max_tags''' gibt eine obere Grenze für die Anzahl der Ergebnis-Tags an. Wird nichts angegeben, verwendet die Erweiterung intern 0, d.h. alle gefundenen Ergebnisse werden angegeben<br /> * '''relevance''' gibt die Relevanz des Ergebnisses an. Ist dieser Wert 0 (Standard), werden die Ergebnis-Tags alphabetisch sortiert, ist der Wert 1, werden die Ergebnis-Tags nach Häufigkeit sortiert, die am häufigsten verwendeten Tags werden dabei zuerst angegeben<br /> * '''target''' gibt eine andere Zielseite als die aktuelle Seite an. Hierbei handelt es sich entweder um die ID einer Contao-Seite, oder den Seiten-Alias. Als Standard verwendet die Erweiterung 0, d.h. es wird auf die aktuelle Seite weitergeleitet, auf der sich auch der Insert-Tag befindet.<br /> <br /> === Ausgabe in Feeds ===<br /> Mit Version 1.7.2 ist auch die Ausgabe von tags zu Events (Kalendereinträgen) in Kalender-Feeds möglich, mit Version 1.7.3 die Ausgabe von tags zu Nachrichtenbeiträgen in News-Feeds. Standardmäßig werden diese Auszeichnungen als HTML-Liste nach der Beschreibung des Events bzw. des Nachrichtenbeitrags ausgegeben. Falls eine Ausgabe nicht erwünscht ist, so muss die folgende globale Variable updatesicher mit einem negativen Booleschen Wert überschrieben werden:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> $GLOBALS['tags']['showInFeeds'] = false;<br /> &lt;/source&gt;<br /> <br /> Diese Zeile fügt man dann am besten z.B. in die Datei '''&lt;nowiki&gt;system/config/localconfig.php&lt;/nowiki&gt;''' ein.<br /> Die Darstellung der Auszeichnungen im Newsfeed kann über das Template tags_feed beeinflusst werden.<br /> <br /> === Zusätzliche Contao-Module ===<br /> Die tags-Erweiterung führt die folgenden neuen Contao-Module ein:<br /> <br /> ==== Globale Artikelliste ====<br /> Mit der globalen Artikelliste kann man eine Liste aller verfügbaren Artikel einer Contao-Installation ausgeben lassen. In dieser Form ist das Modul natürlich nur bedingt sinnvoll. Wenn man die Ausgabe der Artikel einschränken möchte, wählt man besser das Core-Modul Artikelliste, das eine Artikelliste einer bestimmten Seite ausgeben kann. Die globale Artikelliste sollte hauptsächlich dazu verwendet werden, um aus einer Tag Cloud heraus aufgerufen zu werden. In diesem Fall wird eine Liste aller Artikel ausgegeben, die mit der ausgewählten Auszeichnung versehen wurden.<br /> <br /> ==== Verwendete Auszeichnungen ====<br /> Dieses Modul zeigt die auf einer Seite aktuell verwendeten Auszeichnungen an. Durch Anklicken der Auszeichnungen lässt sich nach eben diesen Filtern. Alle Auszeichnungen können zurückgesetzt werden. Einzelne Auszeichnungen können durch Anklicken aus der Auswahl entfernt werden.<br /> <br /> ==== Einstellungen für Nachrichtenmodule ====<br /> Für die Nachrichtenmodule '''Nachrichtenliste''', '''Nachrichtenarchiv''' und '''Nachrichtenleser''' gibt es eine Einstellung, die verhindert, dass diese Module auf Tags reagieren ('''Auszeichnungen ignorieren'''). Falls z.B. eine Nachrichtenliste der letzten Nachrichten ausgegeben wird, so würde sich die Ausgabe ändern, wenn die Seite über eine Tag Cloud aufgerufen wird. Um dies zu verhindern, kann diese Option ausgewählt werden.<br /> <br /> [[Datei:tags_ignore.png|center|frame|Ignorieren von Auszeichnungen in den Nachrichtenmodulen]]<br /> ==== Auszeichnungsobjekte ====<br /> Mit dem Frontend-Modul Auszeichnungsobjekte kann eine Liste eines bestimmten Inhalts-Objekttyps angezeigt werden. Als '''Objekttyp''' stehen die drei Inhaltstypen ''Seiten'', ''Artikel'' oder ''Inhaltselemente'' zur Verfügung. Der Objekttyp ist das Element, das in der Liste verlinkt wird, wenn eine Auszeichnung existiert. Bei einem ausgewählten Objekttyp ''Seiten'' werden also Links auf Contao-Seiten angezeigt, bei einem Objekttyp Artikel werden Links auf Contao Artikel angezeigt etc.<br /> <br /> Die '''Einschränkung auf Datenquelle''' legt fest, welche Auszeichnungen in der Liste verarbeitet werden sollen. Wird hier z.B. tl_article gewählt, werden nur Artikelauszeichnungen berücksichtigt. Wird tl_content ausgewählt, werden nur Auszeichnungen von Inhaltselementen berücksichtigt.<br /> <br /> Über '''Seiten''' muss man die Seite auswählen, die zur Erstellung der Objektliste verwendet werden soll. Wenn die Seite Unterseiten besitzt, so werden diese ebenfalls für die Generierung der Objektliste verwendet. Das heißt, es werden nur Auszeichnungen berücksichtigt, die für Inhalts-Objekte vergeben wurden, die sich auf der ausgewählten Seite oder deren Unterseiten befinden.<br /> <br /> '''Beispiel:'''<br /> * Objekttyp: Seiten<br /> * Einschränkung auf Datenquelle: tl_article<br /> * Seiten: Startpunkt der aktuellen Website<br /> <br /> Für ausgewählte Auszeichnungen wird eine Liste von Links auf Seiten angezeigt, bei deren Artikel die Auszeichnungen vergeben wurden. Berücksichtigt werden alle Seiten der aktuellen Website.<br /> <br /> <br /> [[Datei:auszeichnungsobjekte.png|center|frame|Einstellungen des Frontendmoduls Auszeichnungsobjekte]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 23:25, 24. Nov. 2011 (CET)</div>

Hschottm https://de.contaowiki.org/Tags 2014-01-13T09:21:08Z

<p>Hschottm: /* Insert Tags */</p> <hr /> <div>[[Kategorie:tags]]<br /> <br /> Auszeichnungen zum Kategorisieren von Elementen.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/tags<br /> | ExtVersion=3.2.0<br /> | Version=3.2.0 - 3.2.3<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/tags.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> | Comment=Versionen ältere Contao-Versionen verfügbar<br /> }}<br /> <br /> <br /> == Modul tags (Auszeichnungen) ==<br /> <br /> tags ist ein Contao-Modul zum Erstellen und Anzeigen von Auszeichnungen innerhalb von Contao. Mit Hilfe des Moduls lassen sich für Entwickler mit geringem Aufwand Auszeichnungen für beliebige Contao Datacontainer (Tabellen) hinzufügen. Es ist zu beachten, dass zum vollständigen Funktionieren der Erweiterung die Mootools Unterstützung im Contao Seitenlayout aktiviert sein muss.<br /> Das Modul stellt ein Eingabefeld-Widget zur Verfügung, das für den aktuellen Datacontainer, in dem es eingesetzt wird, die Auszeichnungen in der Datenbank ablegen und auslesen kann. Die Auszeichnungen werden dabei als kommagetrennte Liste von den Autoren eingegeben oder können, falls JavaScript aktiviert ist, per Mausklick hinzugefügt oder entfernt werden (dies gilt allerdings nur für bereits bestehende Auszeichnungen).<br /> <br /> [[Datei:tags_backend.png|center|frame|Eingabefeld für Auszeichnungen im Backend]]<br /> <br /> In der vorliegenden Abbildung sieht man, dass das ''title''-Attribut der URL einer Auszeichnung die Anzahl der Verwendung derselben anzeigt, d.h. neben dem Namen der Auszeichnung wird die Anzahl der Verwendungen in Klammern hinter den Namen ausgegeben. ''Mathematik (8)'' bedeutet also z.B., dass die Auszeichnung Mathematik insgesamt 8 Mal verwendet wird. <br /> <br /> Es ist zu beachten, dass pro Contao Datacontainer nur ein Eingabefeld für Auszeichnungen verwendet wird, da die Auszeichnungen immer nur für den gesamten Datacontainer vergeben werden und nicht für das zugrund liegende Eingabefeld.<br /> === Hinweise für Entwickler von eigenen Erweiterungen ===<br /> <br /> Nutzer, die Auszeichnungen nur Verwenden wollen und diese nicht in eigene Erweiterungen integrieren wollen, können den folgenden Absatz einfach [[#Verwenden_von_Auszeichnungen_im_Contao-Frontend|überspringen]].<br /> <br /> ==== Hinzufügen von Auszeichnungsfeldern in Contao Datacontainer ====<br /> <br /> Um ein Auszeichnungs-Eingabefeld in einen Contao Datacontainer einzufügen, werden die folgenden Schritte benötigt:<br /> <br /> # Um das Eingabefeld anzuzeigen, muss für den Datacontainer ein entsprechendes Datenbankfeld existieren. Da die Auszeichnungen nicht in diesem Datenbankfeld gespeichert werden, sondern in der speziell vom tags-Modul bereitgestellten Datenbanktabelle ''tl_tag'', reicht es, ein möglichst kleines Datenbankfeld zu erzeugen.<br /> # Das Eingabefeld muss in das DCA Konfigurationsarray eingefügt werden<br /> <br /> Ein neues Datenbankfeld erstellen Sie in der ''config/database.sql''-Datei des gewünschten Moduls. Ein Beispiel ist z.B.<br /> <br /> &lt;source lang=&quot;sql&quot;&gt;<br /> CREATE TABLE `tl_literature` (<br /> `tags` char(1) NOT NULL default ''<br /> ) ENGINE=MyISAM DEFAULT CHARSET=utf8;<br /> &lt;/source&gt;<br /> <br /> Um das Feld mit diesem Namen in das DCA-Konfigurationsarray zu integrieren, muss es in eine der Paletten des Konfigurationsarrays eingefügt werden und eine Felddefinition erstellt werden, also z.B.<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> '' Palettes<br /> 'palettes' =&gt; array(<br /> 'default' =&gt; 'title,author,description,tags,content'<br /> ),<br /> '' Fields<br /> 'fields' =&gt; array(<br /> 'tags' =&gt; array(<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['MSC']['tags'],<br /> 'inputType' =&gt; 'tag'<br /> )<br /> ),<br /> &lt;/source&gt;<br /> <br /> Mit ''$GLOBALS['TL_LANG']['MSC']['tags']'' stellt das tags-Modul bereits einen Standardbezeichner für ein Auszeichnungsfeld zur Verfügung. Man kann diesen natürlich jederzeit gegen eigene Spracheinträge austauschen.<br /> <br /> Beim Speichern eines Datacontainers werden während der Validierung der Daten die Auszeichnungen identifiziert und in der Datenbanktabelle ''tl_tag'' gespeichert. Abgelegt wird die ID des aktuellen Datacontainers (Tabellenfeld ''id''), der Tabellenname des Datacontainers (Tabellenfeld ''from_table'') und die Auszeichnung (Tabellenfeld ''tag'').<br /> <br /> ==== Optionen für das Evaluation-Array des Feldes ====<br /> <br /> {| border=&quot;1&quot; cellpadding=&quot;10&quot; cellspacing=&quot;0&quot; <br /> ! Schlüssel <br /> ! Wert <br /> ! Beschreibung<br /> |- style=&quot;vertical-align: top;&quot;<br /> | table || Quelltabelle ''string'' || Name der Quelltabelle, aus der die Auszeichnungen gebildet werden sollen. Der Standard ist der Name des aktuellen DCA Datencontainers. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | isTag || true/false ''boolean'' || Gibt an, ob der Inhalt des Feldes als Tag gespeichert werden soll oder nicht. Der Standard ist ''true''. Wenn der Inhalt des Feldes nicht als Tag gespeichert werden soll, wird der Feldinhalt ganz normal als kommagetrennte Zeichenkette in der Datenbank abgelegt. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | maxtags || Anzahl ''integer'' || Gibt die maximale Anzahl der Auszeichnungen an, die in der Tag Cloud zum Auswählen der Auszeichnungen angegeben werden. Wenn die Anzahl der verfügbaren Auszeichnungen größer ist, als maxtags, werden die Auszeichnungen mit den wenigsten Vorkommnissen nicht mehr angezeigt. <br /> |}<br /> <br /> === Verwenden von Auszeichnungen im Contao-Frontend ===<br /> Für die Verwendung im Contao-Frontend ist das Modul ''Tag Cloud'' vorgesehen. Das Modul erstellt eine HTML-Liste der für einen oder mehrere Datacontainer verwendeten Auszeichnungen. Um die Liste als Tag Cloud darzustellen, müssen die zugehörigen CSS-Selektoren mit Stilen versehen werden. Zwei Beispieldateien ''[[tags_oxygen.css]]'' und ''[[tags_orange.css]]'' finden sich im ''tl_files/tags''-Verzeichnis des Installationspakets der tags-Erweiterung. Es empfiehlt sich an, sich an diesen Stilen zu orientieren, da es bei der Verwendung der '''Top 10 Auszeichnungen''' darauf ankommt, welche Elemente der Tag Cloud durch die CSS-Stile sichtbar gemacht werden und welche nicht.<br /> <br /> [[Datei:tagcloud_settings_1.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen deaktiviert]]<br /> <br /> Im Eingabefeld '''Maximale Anzahl von Auszeichnungen''' kann man eine maximale Anzahl der anzuzeigenden Auszeichnungen für die Tag Cloud festlegen. Ein Wert von 0 oder kein Wert zeigt immer alle verfügbaren Auszeichnungen an. Bei einem Wert kleiner als die maximale Anzahl der verfügbaren Auszeichnungen werden nur die häufigsten Auszeichnungen gemäß der Vorgabe im Eingabefeld angezeigt. Es ist zu beachten, dass es dadurch möglich ist, dass nicht alle Auszeichnungen angezeigt werden. Man sollte für die Benutzer einen Hinweis vorhalten, der auf diesen Umstand aufmerksam macht.<br /> <br /> Im Eingabefeld '''Anzahl der Auszeichnungsgrößen''' kann man die Anzahl der verfügbaren CSS Selektoren für die Tag Cloud festlegen. Der Standardwert 4 erzeugt vier unterschiedliche Gruppen von Auszeichnungen mit den Selektoren size1, size2, size3 und size4, man kann also maximal 4 unterschiedliche Größen von Auszeichnungen im Frontend ausgeben. Es ist darauf zu achten, dass man immer für alle möglichen CSS Selektoren ein CSS-Element vorhält.<br /> <br /> Das Kontrollkästchen '''Auszeichnungs-Klassennamen verwenden''' fügt einen zusätzlichen CSS Klassennamen für jede Auszeichnung hinzu, der aus dem Namen der jweiligen Auszeichnung besteht. Damit können einzelne Auszeichnungen individuell per CSS angepasst werden. Leerzeichen in den Auszeichnungsnamen werden für die CSS-Klassennamen in Unterstriche umgewandelt.<br /> <br /> Mit dem Auswahlfeld '''Tag Cloud Template''' kann man das Template bestimmen, das für die Generierung der Tag Cloud im Frontend verwendet werden soll. Standardmäßig ist dies das Template ''mod_tagcloud''. Man kann sich aber auch eigene Templates erstellen und hier verwenden. Diese müssen dann lediglich mit der Zeichenkette mod_tagcloud beginnen, also z.B. mod_tagcloud_spezial etc.<br /> <br /> Das Kontrollkästchen '''Zugehörige Auszeichnungen''' zeigt im Frontend bei Auswahl mindestens einer Auszeichnung eine Liste weitere Auszeichnungen an, die im Zusammenhang mit der ausgewählten Auszeichnung vergeben wurden. Durch einen Klick auf eine dieser zugehörigen Auszeichnungen kann die Suche nach ausgezeichneten Objekten weiter eingeschränkt werden. Natürlich funktioniert die Anzeige der zugehörigen Auszeichnungen nur dann, wenn sich das Tag Cloud Modul auf einer Seite befindet, die sich in der Weiterleitung der Tag Cloud Hyperlinks befindet, da die Tag Cloud sonst keinerlei Kenntnis von bereits ausgewählten Auszeichnungen haben kann.<br /> <br /> Das Kontrollkästchen '''Top 10 Auszeichnungen''' erzeugt über der Tag Cloud eine weitere Tag Cloud, welche die 10 häufigsten Auszeichnungen beinhaltet, in der Reihenfolge des häufigsten Auftretens. Gleichzeitig ist dieses Kontrollkästchen ein Selektor, der bei Aktivierung zwei weitere Kontrollkästchen erzeugt:<br /> <br /> * '''Top 10 Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, sind die Top 10 Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> * '''Alle Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, ist die Tag Cloud mit allen Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> <br /> [[Datei:tagcloud_settings_1a.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen aktiviert]]<br /> <br /> Man wählt unter '''Weiterleitung zu Seite''' eine interne Contao-Seite aus, damit die Auszeichnungen der Tag Cloud mit Hyperlinks versehen werden. Die gewählte Seite wird dann immer mit dem URL-Parameter ''tag=TAGNAME'' aufgerufen, also z.B. ''http://www.meineseite.de/weiterleitung.html?tag=typolight''.<br /> <br /> <br /> [[Datei:tagcloud_settings_2.png|center|frame|Tabellenspezifische Eingabefelder des Tag Cloud Moduls im Backend]]<br /> <br /> Bei '''Einschränkung auf Tabelle(n)''' wählt man normalerweise immer nur den Datacontainer aus, für den die Tags gespeichert wurden.<br /> <br /> Die Felder '''Quell-Tabelle für Auszeichnungen''' und '''Tabellenfeld für Auszeichnungen''' werden mit den Standardeinträgen ''tl_tag'' und ''tag'' vorbelegt und sollten nur dann geändert werden, wenn man die Tags aus einer eigenen Tabelle beisteuern will.<br /> <br /> Mit den Feldern '''CSS-Id/Klasse''' kann man zusätzliche CSS-ID's oder Klassen vergeben, die dann im umschließenden DIV-Container der Tag Cloud eingebettet werden. Dadurch hat man die Möglichkeit individuelle Stile für die Tag Clouds einzusetzen.<br /> <br /> Im Frontend sieht die Tag Cloud dann z.B. folgendermaßen aus:<br /> <br /> [[Datei:tagcloud_frontend.png|center|frame|Ausgabe der Tag Cloud im Frontend]]<br /> <br /> bzw. mit aktivierten Top 10 Auszeichnungen:<br /> <br /> [[Datei:tags_topten.png|center|frame|Tag Cloud mit Top 10 Auszeichnungen]]<br /> <br /> bwz. mit aktivierten Top 10 und zugehörigen Auszeichnungen:<br /> <br /> [[Datei:tags_related.png|center|frame|Tag Cloud mit Top 10 und zugehörigen Auszeichnungen]]<br /> <br /> Werden zwei Tag Clouds (Top 10 + Alle) oder die zugehörigen Auszeichnungen angezeigt, bindet Contao ein JavaScript ein, das die jeweiligen Tag Clouds bei Mausklick auf den Titel einklappt bzw. ausklappt. Ist kein JavaScript aktiviert, so werden die dreieckigen Klappsymbole nicht angezeigt. Für einen optimale Zusammenarbeit mit der JavaScript-Erweiterung sollte man die installierten CSS-Dateien tags_oxygen.css oder tags_orange.css in die Seite einbinden.<br /> <br /> Die folgenden Contao-Elemente können mit Tags versehen werden:<br /> <br /> * Nachrichtenbeiträge<br /> * Artikel<br /> * Inhaltselemente<br /> * Kalender/Events<br /> * FAQ (ab Contao 2.11)<br /> * Dateien (ab Contao 3.1)<br /> <br /> ==== Weiterleitung zu Seiten über eine Tag Cloud ====<br /> <br /> Damit eine sinnvolle Weiterleitung aus einer Tag Cloud vorgenommen werden kann, muss die Seite, zu der weitergeleitet wird, den tag-Parameter in der URL interpretieren können. Hierin liegt die Hauptarbeit, wenn die Tag-Unterstützung für bestehende Contao-Datacontainer vorgenommen werden soll.<br /> <br /> Die folgenden Contao-Module reagieren auf einen Aufruf aus einer Tag Cloud heraus und zeigen nur die Elemente an, die mit der ausgewählten Auszeichnung versehen wurden:<br /> <br /> * Modul '''Nachrichtenarchiv''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Nachrichtenliste''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Globale Artikelliste''': Es werden Links auf alle Artikel angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Eventliste''': Es werden alle Events der ausgewählten Kalender im ausgewählten Zeitraum angezeigt, die mit der gesuchten Auszeichnung versehen sind.<br /> * Modul '''Auszeichnungsobjekte''': Es werden Inhaltselemente (Seiten, Artikel, Inhaltselemente) in einer Liste angezeigt, die mit einer bestimmten Auszeichnung versehen sind.<br /> <br /> ==== Ausgabe von Auszeichnungslisten zu Nachrichtenbeiträgen ====<br /> <br /> Bei der Ausgabe von Nachrichtenbeiträgen gibt es die Möglichkeit, unterhalb des Nachrichtenbeitrags die zum Beitrag zugehörigen Auszeichnungen anzeigen zu lassen. Zu diesem Zweck kann die Ausgabe der Auszeichnungen in den Frontend-Modulen zur Nachrichtenanzeige, '''Nachrichtenleser''', '''Nachrichtenliste''' und '''Nachrichtenarchiv''', aktiviert werden.<br /> <br /> [[Datei:tags_tag_settings.png|center|frame|Aktivierung einer Auszeichnungsliste im Modul des Contao Backends]]<br /> <br /> Mit der Option '''Auszeichnungen ignorieren''' werden von der Liste alle zur Filterung verwendeten Auszeichnungen verworfen.<br /> <br /> Wenn man die Option '''Nachrichten-Auszeichnungen anzeigen''' auswählt, erscheint zusätzlich ein Auswahl-Feld für eine Weiterleitungsseite, die aufgerufen wird, wenn aus eine der Auszeichnungen geklickt wird. Hier wählt man die Seite aus, auf die man auch aus der Tag Cloud heraus weiterleitet oder aber natürlich jede beliebige andere Seite, wenn man eine spezielle Behandlung der zu einer Nachrichten angeklickten Auszeichnungen wünscht.<br /> <br /> Um, wie bei den Tag Clouds die Namen der individuellen CSS-Klassen der jeweiligen Auszeichnungen anzuzeigen, wurde die Option &quot;Auszeichnungs-Klassennamen verwenden&quot; eingeführt. Diese verwendet die individuelle CSS-Klasse in allen Auszeichnungen, die unterhalb eines Nachrichtenbeitrags angezeigt werden.<br /> <br /> Damit eine Ausgabe der Auszeichnungen im Frontend auch wirklich ausgeführt wird, muss man außerdem die '''Nachrichtenvorlage''' des Moduls anpassen. Speziell für diesen Zweck wurde mit der tags-Erweiterung das Template ''news_full_tags'' erstellt, das den entsprechenden HTML-Code zur Ausgabe der Auszeichnungen unterhalb eines Nachrichtenbeitrags bereitstellt. Wenn man ein anderes Template für die Ausgabe verwenden will und die Ausgabe der Auszeichnungen zu einem Nachrichtenbeitrag wünscht, sollte man den im Template news_full_tags hinzugekommenen Quellcode kopieren und in das gewünschte Template einfügen:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> &lt;?php if ($this-&gt;showTags): ?&gt;<br /> <br /> &lt;?php if (count($this-&gt;taglist)): ?&gt;<br /> &lt;ul class=&quot;tag-chain&quot;&gt;<br /> &lt;?php $counter = 0; foreach ($this-&gt;taglist as $tag): ?&gt;<br /> &lt;li class=&quot;tag-chain-item&lt;?php if ($counter == 0) echo ' first'; ?&gt;<br /> &lt;?php if ($counter == count($this-&gt;taglist)-1) echo ' last'; ?&gt;<br /> &lt;?php if ($this-&gt;showTagClass) echo ' ' . $tag['class']; ?&gt;&quot;&gt;&lt;?php echo $tag['url']; ?&gt;&lt;/li&gt;<br /> &lt;?php $counter++; endforeach; ?&gt;<br /> &lt;/ul&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;/source&gt;<br /> <br /> Für die Ausgabe der Auszeichnungen enthalten die in der Erweiterung mitgelieferten CSS-Dateien tags_orange.css und tags_oxygen.css weitere CSS-Selektoren, die für eine grundlegende Formatierung der Auszeichnungslisten sorgen.<br /> Ein Nachrichtenbeitrag mit den dazugehörigen Auszeichnungen könnte dann z.B. folgendermaßen aussehen:<br /> <br /> [[Datei:auszeichnungsliste.png|center|frame|Darstellung einer Nachricht mit zugehörigen Auszeichnungen]]<br /> <br /> === Inhaltselemente ===<br /> Die tags-Erweiterung erweitert des Contao Inhaltselement '''Überschrift''' und fügt in den Experten-Einstellungen einen zusätzlichen Parameter '''Nur bei Auszeichnungen anzeigen''' ein. Wird dieses Feld ausgewählt, dann zeigt Contao die Überschrift nur dann an, wenn auf der betreffenden Seite Auszeichnungen verwendet werden, d.h. wenn von einer Tag Cloud über eine Auszeichnung auf die Seite verzweigt wird. Zu erkennen ist die am Paramter '''tag''' in der URL der Seite.<br /> <br /> [[Datei:heading_tags_only.png|center|frame|Auswahl 'Nur bei Auszeichnungen anzeigen' im Überschrift Inhaltselement]]<br /> <br /> Dieses Feld kann in Kombination mit dem Insert Tag &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt; z.B. dazu eingesetzt werden, eine für ausgewählte Tags passende Überschrift anzuzeigen, z.B. '''Auswahl der Teilnehmer &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''' =&gt; '''Auswahl der Teilnehmer (Kongress+Oktober+Hamburg)'''<br /> === Insert Tags ===<br /> <br /> tags führt die folgenden Insert Tags für Contao ein:<br /> <br /> * '''&lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der aktuell verwendeten Auszeichnungen, z.B. '''(Contao+Erweiterung+tags)'''<br /> * '''&lt;nowiki&gt;{{tags_news::news_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Nachrichtenbeitrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_news::1}}&lt;/nowiki&gt; die Auszeichnungen des Nachrichtenbeitrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_event::event_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Kalendereintrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_event::1}}&lt;/nowiki&gt; die Auszeichnungen des Kalendereintrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_article::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article_url::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen als URL auf den zugehörigen Artikel, z.B. zeigt &lt;nowiki&gt;{{tags_article_url::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an und verlinkt jede Auszeichnung mit der Seite des Artikels. <br /> * '''&lt;nowiki&gt;{{tags_content::content_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für ein Inhaltselement vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_content::1}}&lt;/nowiki&gt; die Auszeichnungen des Inhaltselements mit der ID 1 an.<br /> * '''&lt;nowiki&gt;{{tags_faq::faq_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen FAQ-Eintrag vergebenen Auszeichnungen als URL auf die aktuelle Seite, z.B. zeigt &lt;nowiki&gt;{{tags_faq::1}}&lt;/nowiki&gt; die Auszeichnungen des FAQ-Eintrags mit der ID 1 an.<br /> * '''&lt;nowiki&gt;{{tags_file::file_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für eine Datei vergebenen Auszeichnungen als URL auf die aktuelle Seite, z.B. zeigt &lt;nowiki&gt;{{tags_file::1}}&lt;/nowiki&gt; die Auszeichnungen der Datei mit der ID 1 an.<br /> <br /> === Ausgabe in Feeds ===<br /> Mit Version 1.7.2 ist auch die Ausgabe von tags zu Events (Kalendereinträgen) in Kalender-Feeds möglich, mit Version 1.7.3 die Ausgabe von tags zu Nachrichtenbeiträgen in News-Feeds. Standardmäßig werden diese Auszeichnungen als HTML-Liste nach der Beschreibung des Events bzw. des Nachrichtenbeitrags ausgegeben. Falls eine Ausgabe nicht erwünscht ist, so muss die folgende globale Variable updatesicher mit einem negativen Booleschen Wert überschrieben werden:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> $GLOBALS['tags']['showInFeeds'] = false;<br /> &lt;/source&gt;<br /> <br /> Diese Zeile fügt man dann am besten z.B. in die Datei '''&lt;nowiki&gt;system/config/localconfig.php&lt;/nowiki&gt;''' ein.<br /> Die Darstellung der Auszeichnungen im Newsfeed kann über das Template tags_feed beeinflusst werden.<br /> <br /> === Zusätzliche Contao-Module ===<br /> Die tags-Erweiterung führt die folgenden neuen Contao-Module ein:<br /> <br /> ==== Globale Artikelliste ====<br /> Mit der globalen Artikelliste kann man eine Liste aller verfügbaren Artikel einer Contao-Installation ausgeben lassen. In dieser Form ist das Modul natürlich nur bedingt sinnvoll. Wenn man die Ausgabe der Artikel einschränken möchte, wählt man besser das Core-Modul Artikelliste, das eine Artikelliste einer bestimmten Seite ausgeben kann. Die globale Artikelliste sollte hauptsächlich dazu verwendet werden, um aus einer Tag Cloud heraus aufgerufen zu werden. In diesem Fall wird eine Liste aller Artikel ausgegeben, die mit der ausgewählten Auszeichnung versehen wurden.<br /> <br /> ==== Verwendete Auszeichnungen ====<br /> Dieses Modul zeigt die auf einer Seite aktuell verwendeten Auszeichnungen an. Durch Anklicken der Auszeichnungen lässt sich nach eben diesen Filtern. Alle Auszeichnungen können zurückgesetzt werden. Einzelne Auszeichnungen können durch Anklicken aus der Auswahl entfernt werden.<br /> <br /> ==== Einstellungen für Nachrichtenmodule ====<br /> Für die Nachrichtenmodule '''Nachrichtenliste''', '''Nachrichtenarchiv''' und '''Nachrichtenleser''' gibt es eine Einstellung, die verhindert, dass diese Module auf Tags reagieren ('''Auszeichnungen ignorieren'''). Falls z.B. eine Nachrichtenliste der letzten Nachrichten ausgegeben wird, so würde sich die Ausgabe ändern, wenn die Seite über eine Tag Cloud aufgerufen wird. Um dies zu verhindern, kann diese Option ausgewählt werden.<br /> <br /> [[Datei:tags_ignore.png|center|frame|Ignorieren von Auszeichnungen in den Nachrichtenmodulen]]<br /> ==== Auszeichnungsobjekte ====<br /> Mit dem Frontend-Modul Auszeichnungsobjekte kann eine Liste eines bestimmten Inhalts-Objekttyps angezeigt werden. Als '''Objekttyp''' stehen die drei Inhaltstypen ''Seiten'', ''Artikel'' oder ''Inhaltselemente'' zur Verfügung. Der Objekttyp ist das Element, das in der Liste verlinkt wird, wenn eine Auszeichnung existiert. Bei einem ausgewählten Objekttyp ''Seiten'' werden also Links auf Contao-Seiten angezeigt, bei einem Objekttyp Artikel werden Links auf Contao Artikel angezeigt etc.<br /> <br /> Die '''Einschränkung auf Datenquelle''' legt fest, welche Auszeichnungen in der Liste verarbeitet werden sollen. Wird hier z.B. tl_article gewählt, werden nur Artikelauszeichnungen berücksichtigt. Wird tl_content ausgewählt, werden nur Auszeichnungen von Inhaltselementen berücksichtigt.<br /> <br /> Über '''Seiten''' muss man die Seite auswählen, die zur Erstellung der Objektliste verwendet werden soll. Wenn die Seite Unterseiten besitzt, so werden diese ebenfalls für die Generierung der Objektliste verwendet. Das heißt, es werden nur Auszeichnungen berücksichtigt, die für Inhalts-Objekte vergeben wurden, die sich auf der ausgewählten Seite oder deren Unterseiten befinden.<br /> <br /> '''Beispiel:'''<br /> * Objekttyp: Seiten<br /> * Einschränkung auf Datenquelle: tl_article<br /> * Seiten: Startpunkt der aktuellen Website<br /> <br /> Für ausgewählte Auszeichnungen wird eine Liste von Links auf Seiten angezeigt, bei deren Artikel die Auszeichnungen vergeben wurden. Berücksichtigt werden alle Seiten der aktuellen Website.<br /> <br /> <br /> [[Datei:auszeichnungsobjekte.png|center|frame|Einstellungen des Frontendmoduls Auszeichnungsobjekte]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 23:25, 24. Nov. 2011 (CET)</div>

Hschottm https://de.contaowiki.org/Tags 2014-01-13T08:47:58Z

<p>Hschottm: /* Insert Tags */</p> <hr /> <div>[[Kategorie:tags]]<br /> <br /> Auszeichnungen zum Kategorisieren von Elementen.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/tags<br /> | ExtVersion=3.2.0<br /> | Version=3.2.0 - 3.2.3<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/tags.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> | Comment=Versionen ältere Contao-Versionen verfügbar<br /> }}<br /> <br /> <br /> == Modul tags (Auszeichnungen) ==<br /> <br /> tags ist ein Contao-Modul zum Erstellen und Anzeigen von Auszeichnungen innerhalb von Contao. Mit Hilfe des Moduls lassen sich für Entwickler mit geringem Aufwand Auszeichnungen für beliebige Contao Datacontainer (Tabellen) hinzufügen. Es ist zu beachten, dass zum vollständigen Funktionieren der Erweiterung die Mootools Unterstützung im Contao Seitenlayout aktiviert sein muss.<br /> Das Modul stellt ein Eingabefeld-Widget zur Verfügung, das für den aktuellen Datacontainer, in dem es eingesetzt wird, die Auszeichnungen in der Datenbank ablegen und auslesen kann. Die Auszeichnungen werden dabei als kommagetrennte Liste von den Autoren eingegeben oder können, falls JavaScript aktiviert ist, per Mausklick hinzugefügt oder entfernt werden (dies gilt allerdings nur für bereits bestehende Auszeichnungen).<br /> <br /> [[Datei:tags_backend.png|center|frame|Eingabefeld für Auszeichnungen im Backend]]<br /> <br /> In der vorliegenden Abbildung sieht man, dass das ''title''-Attribut der URL einer Auszeichnung die Anzahl der Verwendung derselben anzeigt, d.h. neben dem Namen der Auszeichnung wird die Anzahl der Verwendungen in Klammern hinter den Namen ausgegeben. ''Mathematik (8)'' bedeutet also z.B., dass die Auszeichnung Mathematik insgesamt 8 Mal verwendet wird. <br /> <br /> Es ist zu beachten, dass pro Contao Datacontainer nur ein Eingabefeld für Auszeichnungen verwendet wird, da die Auszeichnungen immer nur für den gesamten Datacontainer vergeben werden und nicht für das zugrund liegende Eingabefeld.<br /> === Hinweise für Entwickler von eigenen Erweiterungen ===<br /> <br /> Nutzer, die Auszeichnungen nur Verwenden wollen und diese nicht in eigene Erweiterungen integrieren wollen, können den folgenden Absatz einfach [[#Verwenden_von_Auszeichnungen_im_Contao-Frontend|überspringen]].<br /> <br /> ==== Hinzufügen von Auszeichnungsfeldern in Contao Datacontainer ====<br /> <br /> Um ein Auszeichnungs-Eingabefeld in einen Contao Datacontainer einzufügen, werden die folgenden Schritte benötigt:<br /> <br /> # Um das Eingabefeld anzuzeigen, muss für den Datacontainer ein entsprechendes Datenbankfeld existieren. Da die Auszeichnungen nicht in diesem Datenbankfeld gespeichert werden, sondern in der speziell vom tags-Modul bereitgestellten Datenbanktabelle ''tl_tag'', reicht es, ein möglichst kleines Datenbankfeld zu erzeugen.<br /> # Das Eingabefeld muss in das DCA Konfigurationsarray eingefügt werden<br /> <br /> Ein neues Datenbankfeld erstellen Sie in der ''config/database.sql''-Datei des gewünschten Moduls. Ein Beispiel ist z.B.<br /> <br /> &lt;source lang=&quot;sql&quot;&gt;<br /> CREATE TABLE `tl_literature` (<br /> `tags` char(1) NOT NULL default ''<br /> ) ENGINE=MyISAM DEFAULT CHARSET=utf8;<br /> &lt;/source&gt;<br /> <br /> Um das Feld mit diesem Namen in das DCA-Konfigurationsarray zu integrieren, muss es in eine der Paletten des Konfigurationsarrays eingefügt werden und eine Felddefinition erstellt werden, also z.B.<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> '' Palettes<br /> 'palettes' =&gt; array(<br /> 'default' =&gt; 'title,author,description,tags,content'<br /> ),<br /> '' Fields<br /> 'fields' =&gt; array(<br /> 'tags' =&gt; array(<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['MSC']['tags'],<br /> 'inputType' =&gt; 'tag'<br /> )<br /> ),<br /> &lt;/source&gt;<br /> <br /> Mit ''$GLOBALS['TL_LANG']['MSC']['tags']'' stellt das tags-Modul bereits einen Standardbezeichner für ein Auszeichnungsfeld zur Verfügung. Man kann diesen natürlich jederzeit gegen eigene Spracheinträge austauschen.<br /> <br /> Beim Speichern eines Datacontainers werden während der Validierung der Daten die Auszeichnungen identifiziert und in der Datenbanktabelle ''tl_tag'' gespeichert. Abgelegt wird die ID des aktuellen Datacontainers (Tabellenfeld ''id''), der Tabellenname des Datacontainers (Tabellenfeld ''from_table'') und die Auszeichnung (Tabellenfeld ''tag'').<br /> <br /> ==== Optionen für das Evaluation-Array des Feldes ====<br /> <br /> {| border=&quot;1&quot; cellpadding=&quot;10&quot; cellspacing=&quot;0&quot; <br /> ! Schlüssel <br /> ! Wert <br /> ! Beschreibung<br /> |- style=&quot;vertical-align: top;&quot;<br /> | table || Quelltabelle ''string'' || Name der Quelltabelle, aus der die Auszeichnungen gebildet werden sollen. Der Standard ist der Name des aktuellen DCA Datencontainers. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | isTag || true/false ''boolean'' || Gibt an, ob der Inhalt des Feldes als Tag gespeichert werden soll oder nicht. Der Standard ist ''true''. Wenn der Inhalt des Feldes nicht als Tag gespeichert werden soll, wird der Feldinhalt ganz normal als kommagetrennte Zeichenkette in der Datenbank abgelegt. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | maxtags || Anzahl ''integer'' || Gibt die maximale Anzahl der Auszeichnungen an, die in der Tag Cloud zum Auswählen der Auszeichnungen angegeben werden. Wenn die Anzahl der verfügbaren Auszeichnungen größer ist, als maxtags, werden die Auszeichnungen mit den wenigsten Vorkommnissen nicht mehr angezeigt. <br /> |}<br /> <br /> === Verwenden von Auszeichnungen im Contao-Frontend ===<br /> Für die Verwendung im Contao-Frontend ist das Modul ''Tag Cloud'' vorgesehen. Das Modul erstellt eine HTML-Liste der für einen oder mehrere Datacontainer verwendeten Auszeichnungen. Um die Liste als Tag Cloud darzustellen, müssen die zugehörigen CSS-Selektoren mit Stilen versehen werden. Zwei Beispieldateien ''[[tags_oxygen.css]]'' und ''[[tags_orange.css]]'' finden sich im ''tl_files/tags''-Verzeichnis des Installationspakets der tags-Erweiterung. Es empfiehlt sich an, sich an diesen Stilen zu orientieren, da es bei der Verwendung der '''Top 10 Auszeichnungen''' darauf ankommt, welche Elemente der Tag Cloud durch die CSS-Stile sichtbar gemacht werden und welche nicht.<br /> <br /> [[Datei:tagcloud_settings_1.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen deaktiviert]]<br /> <br /> Im Eingabefeld '''Maximale Anzahl von Auszeichnungen''' kann man eine maximale Anzahl der anzuzeigenden Auszeichnungen für die Tag Cloud festlegen. Ein Wert von 0 oder kein Wert zeigt immer alle verfügbaren Auszeichnungen an. Bei einem Wert kleiner als die maximale Anzahl der verfügbaren Auszeichnungen werden nur die häufigsten Auszeichnungen gemäß der Vorgabe im Eingabefeld angezeigt. Es ist zu beachten, dass es dadurch möglich ist, dass nicht alle Auszeichnungen angezeigt werden. Man sollte für die Benutzer einen Hinweis vorhalten, der auf diesen Umstand aufmerksam macht.<br /> <br /> Im Eingabefeld '''Anzahl der Auszeichnungsgrößen''' kann man die Anzahl der verfügbaren CSS Selektoren für die Tag Cloud festlegen. Der Standardwert 4 erzeugt vier unterschiedliche Gruppen von Auszeichnungen mit den Selektoren size1, size2, size3 und size4, man kann also maximal 4 unterschiedliche Größen von Auszeichnungen im Frontend ausgeben. Es ist darauf zu achten, dass man immer für alle möglichen CSS Selektoren ein CSS-Element vorhält.<br /> <br /> Das Kontrollkästchen '''Auszeichnungs-Klassennamen verwenden''' fügt einen zusätzlichen CSS Klassennamen für jede Auszeichnung hinzu, der aus dem Namen der jweiligen Auszeichnung besteht. Damit können einzelne Auszeichnungen individuell per CSS angepasst werden. Leerzeichen in den Auszeichnungsnamen werden für die CSS-Klassennamen in Unterstriche umgewandelt.<br /> <br /> Mit dem Auswahlfeld '''Tag Cloud Template''' kann man das Template bestimmen, das für die Generierung der Tag Cloud im Frontend verwendet werden soll. Standardmäßig ist dies das Template ''mod_tagcloud''. Man kann sich aber auch eigene Templates erstellen und hier verwenden. Diese müssen dann lediglich mit der Zeichenkette mod_tagcloud beginnen, also z.B. mod_tagcloud_spezial etc.<br /> <br /> Das Kontrollkästchen '''Zugehörige Auszeichnungen''' zeigt im Frontend bei Auswahl mindestens einer Auszeichnung eine Liste weitere Auszeichnungen an, die im Zusammenhang mit der ausgewählten Auszeichnung vergeben wurden. Durch einen Klick auf eine dieser zugehörigen Auszeichnungen kann die Suche nach ausgezeichneten Objekten weiter eingeschränkt werden. Natürlich funktioniert die Anzeige der zugehörigen Auszeichnungen nur dann, wenn sich das Tag Cloud Modul auf einer Seite befindet, die sich in der Weiterleitung der Tag Cloud Hyperlinks befindet, da die Tag Cloud sonst keinerlei Kenntnis von bereits ausgewählten Auszeichnungen haben kann.<br /> <br /> Das Kontrollkästchen '''Top 10 Auszeichnungen''' erzeugt über der Tag Cloud eine weitere Tag Cloud, welche die 10 häufigsten Auszeichnungen beinhaltet, in der Reihenfolge des häufigsten Auftretens. Gleichzeitig ist dieses Kontrollkästchen ein Selektor, der bei Aktivierung zwei weitere Kontrollkästchen erzeugt:<br /> <br /> * '''Top 10 Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, sind die Top 10 Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> * '''Alle Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, ist die Tag Cloud mit allen Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> <br /> [[Datei:tagcloud_settings_1a.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen aktiviert]]<br /> <br /> Man wählt unter '''Weiterleitung zu Seite''' eine interne Contao-Seite aus, damit die Auszeichnungen der Tag Cloud mit Hyperlinks versehen werden. Die gewählte Seite wird dann immer mit dem URL-Parameter ''tag=TAGNAME'' aufgerufen, also z.B. ''http://www.meineseite.de/weiterleitung.html?tag=typolight''.<br /> <br /> <br /> [[Datei:tagcloud_settings_2.png|center|frame|Tabellenspezifische Eingabefelder des Tag Cloud Moduls im Backend]]<br /> <br /> Bei '''Einschränkung auf Tabelle(n)''' wählt man normalerweise immer nur den Datacontainer aus, für den die Tags gespeichert wurden.<br /> <br /> Die Felder '''Quell-Tabelle für Auszeichnungen''' und '''Tabellenfeld für Auszeichnungen''' werden mit den Standardeinträgen ''tl_tag'' und ''tag'' vorbelegt und sollten nur dann geändert werden, wenn man die Tags aus einer eigenen Tabelle beisteuern will.<br /> <br /> Mit den Feldern '''CSS-Id/Klasse''' kann man zusätzliche CSS-ID's oder Klassen vergeben, die dann im umschließenden DIV-Container der Tag Cloud eingebettet werden. Dadurch hat man die Möglichkeit individuelle Stile für die Tag Clouds einzusetzen.<br /> <br /> Im Frontend sieht die Tag Cloud dann z.B. folgendermaßen aus:<br /> <br /> [[Datei:tagcloud_frontend.png|center|frame|Ausgabe der Tag Cloud im Frontend]]<br /> <br /> bzw. mit aktivierten Top 10 Auszeichnungen:<br /> <br /> [[Datei:tags_topten.png|center|frame|Tag Cloud mit Top 10 Auszeichnungen]]<br /> <br /> bwz. mit aktivierten Top 10 und zugehörigen Auszeichnungen:<br /> <br /> [[Datei:tags_related.png|center|frame|Tag Cloud mit Top 10 und zugehörigen Auszeichnungen]]<br /> <br /> Werden zwei Tag Clouds (Top 10 + Alle) oder die zugehörigen Auszeichnungen angezeigt, bindet Contao ein JavaScript ein, das die jeweiligen Tag Clouds bei Mausklick auf den Titel einklappt bzw. ausklappt. Ist kein JavaScript aktiviert, so werden die dreieckigen Klappsymbole nicht angezeigt. Für einen optimale Zusammenarbeit mit der JavaScript-Erweiterung sollte man die installierten CSS-Dateien tags_oxygen.css oder tags_orange.css in die Seite einbinden.<br /> <br /> Die folgenden Contao-Elemente können mit Tags versehen werden:<br /> <br /> * Nachrichtenbeiträge<br /> * Artikel<br /> * Inhaltselemente<br /> * Kalender/Events<br /> * FAQ (ab Contao 2.11)<br /> * Dateien (ab Contao 3.1)<br /> <br /> ==== Weiterleitung zu Seiten über eine Tag Cloud ====<br /> <br /> Damit eine sinnvolle Weiterleitung aus einer Tag Cloud vorgenommen werden kann, muss die Seite, zu der weitergeleitet wird, den tag-Parameter in der URL interpretieren können. Hierin liegt die Hauptarbeit, wenn die Tag-Unterstützung für bestehende Contao-Datacontainer vorgenommen werden soll.<br /> <br /> Die folgenden Contao-Module reagieren auf einen Aufruf aus einer Tag Cloud heraus und zeigen nur die Elemente an, die mit der ausgewählten Auszeichnung versehen wurden:<br /> <br /> * Modul '''Nachrichtenarchiv''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Nachrichtenliste''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Globale Artikelliste''': Es werden Links auf alle Artikel angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Eventliste''': Es werden alle Events der ausgewählten Kalender im ausgewählten Zeitraum angezeigt, die mit der gesuchten Auszeichnung versehen sind.<br /> * Modul '''Auszeichnungsobjekte''': Es werden Inhaltselemente (Seiten, Artikel, Inhaltselemente) in einer Liste angezeigt, die mit einer bestimmten Auszeichnung versehen sind.<br /> <br /> ==== Ausgabe von Auszeichnungslisten zu Nachrichtenbeiträgen ====<br /> <br /> Bei der Ausgabe von Nachrichtenbeiträgen gibt es die Möglichkeit, unterhalb des Nachrichtenbeitrags die zum Beitrag zugehörigen Auszeichnungen anzeigen zu lassen. Zu diesem Zweck kann die Ausgabe der Auszeichnungen in den Frontend-Modulen zur Nachrichtenanzeige, '''Nachrichtenleser''', '''Nachrichtenliste''' und '''Nachrichtenarchiv''', aktiviert werden.<br /> <br /> [[Datei:tags_tag_settings.png|center|frame|Aktivierung einer Auszeichnungsliste im Modul des Contao Backends]]<br /> <br /> Mit der Option '''Auszeichnungen ignorieren''' werden von der Liste alle zur Filterung verwendeten Auszeichnungen verworfen.<br /> <br /> Wenn man die Option '''Nachrichten-Auszeichnungen anzeigen''' auswählt, erscheint zusätzlich ein Auswahl-Feld für eine Weiterleitungsseite, die aufgerufen wird, wenn aus eine der Auszeichnungen geklickt wird. Hier wählt man die Seite aus, auf die man auch aus der Tag Cloud heraus weiterleitet oder aber natürlich jede beliebige andere Seite, wenn man eine spezielle Behandlung der zu einer Nachrichten angeklickten Auszeichnungen wünscht.<br /> <br /> Um, wie bei den Tag Clouds die Namen der individuellen CSS-Klassen der jeweiligen Auszeichnungen anzuzeigen, wurde die Option &quot;Auszeichnungs-Klassennamen verwenden&quot; eingeführt. Diese verwendet die individuelle CSS-Klasse in allen Auszeichnungen, die unterhalb eines Nachrichtenbeitrags angezeigt werden.<br /> <br /> Damit eine Ausgabe der Auszeichnungen im Frontend auch wirklich ausgeführt wird, muss man außerdem die '''Nachrichtenvorlage''' des Moduls anpassen. Speziell für diesen Zweck wurde mit der tags-Erweiterung das Template ''news_full_tags'' erstellt, das den entsprechenden HTML-Code zur Ausgabe der Auszeichnungen unterhalb eines Nachrichtenbeitrags bereitstellt. Wenn man ein anderes Template für die Ausgabe verwenden will und die Ausgabe der Auszeichnungen zu einem Nachrichtenbeitrag wünscht, sollte man den im Template news_full_tags hinzugekommenen Quellcode kopieren und in das gewünschte Template einfügen:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> &lt;?php if ($this-&gt;showTags): ?&gt;<br /> <br /> &lt;?php if (count($this-&gt;taglist)): ?&gt;<br /> &lt;ul class=&quot;tag-chain&quot;&gt;<br /> &lt;?php $counter = 0; foreach ($this-&gt;taglist as $tag): ?&gt;<br /> &lt;li class=&quot;tag-chain-item&lt;?php if ($counter == 0) echo ' first'; ?&gt;<br /> &lt;?php if ($counter == count($this-&gt;taglist)-1) echo ' last'; ?&gt;<br /> &lt;?php if ($this-&gt;showTagClass) echo ' ' . $tag['class']; ?&gt;&quot;&gt;&lt;?php echo $tag['url']; ?&gt;&lt;/li&gt;<br /> &lt;?php $counter++; endforeach; ?&gt;<br /> &lt;/ul&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;/source&gt;<br /> <br /> Für die Ausgabe der Auszeichnungen enthalten die in der Erweiterung mitgelieferten CSS-Dateien tags_orange.css und tags_oxygen.css weitere CSS-Selektoren, die für eine grundlegende Formatierung der Auszeichnungslisten sorgen.<br /> Ein Nachrichtenbeitrag mit den dazugehörigen Auszeichnungen könnte dann z.B. folgendermaßen aussehen:<br /> <br /> [[Datei:auszeichnungsliste.png|center|frame|Darstellung einer Nachricht mit zugehörigen Auszeichnungen]]<br /> <br /> === Inhaltselemente ===<br /> Die tags-Erweiterung erweitert des Contao Inhaltselement '''Überschrift''' und fügt in den Experten-Einstellungen einen zusätzlichen Parameter '''Nur bei Auszeichnungen anzeigen''' ein. Wird dieses Feld ausgewählt, dann zeigt Contao die Überschrift nur dann an, wenn auf der betreffenden Seite Auszeichnungen verwendet werden, d.h. wenn von einer Tag Cloud über eine Auszeichnung auf die Seite verzweigt wird. Zu erkennen ist die am Paramter '''tag''' in der URL der Seite.<br /> <br /> [[Datei:heading_tags_only.png|center|frame|Auswahl 'Nur bei Auszeichnungen anzeigen' im Überschrift Inhaltselement]]<br /> <br /> Dieses Feld kann in Kombination mit dem Insert Tag &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt; z.B. dazu eingesetzt werden, eine für ausgewählte Tags passende Überschrift anzuzeigen, z.B. '''Auswahl der Teilnehmer &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''' =&gt; '''Auswahl der Teilnehmer (Kongress+Oktober+Hamburg)'''<br /> === Insert Tags ===<br /> <br /> tags führt die folgenden Insert Tags für Contao ein:<br /> <br /> * '''&lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der aktuell verwendeten Auszeichnungen, z.B. '''(Contao+Erweiterung+tags)'''<br /> * '''&lt;nowiki&gt;{{tags_news::news_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Nachrichtenbeitrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_news::1}}&lt;/nowiki&gt; die Auszeichnungen des Nachrichtenbeitrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_event::event_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Kalendereintrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_event::1}}&lt;/nowiki&gt; die Auszeichnungen des Kalendereintrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_article::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article_url::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen als URL auf den zugehörigen Artikel, z.B. zeigt &lt;nowiki&gt;{{tags_article_url::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an und verlinkt jede Auszeichnung mit der Seite des Artikels. <br /> * '''&lt;nowiki&gt;{{tags_content::content_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für ein Inhaltselement vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_content::1}}&lt;/nowiki&gt; die Auszeichnungen des Inhaltselements mit der ID 1 an.<br /> * '''&lt;nowiki&gt;{{tags_faq::faq_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen FAQ-Eintrag vergebenen Auszeichnungen als URL auf die aktuelle Seite, z.B. zeigt &lt;nowiki&gt;{{tags_faq::1}}&lt;/nowiki&gt; die Auszeichnungen des FAQ-Eintrags mit der ID 1 an.<br /> <br /> === Ausgabe in Feeds ===<br /> Mit Version 1.7.2 ist auch die Ausgabe von tags zu Events (Kalendereinträgen) in Kalender-Feeds möglich, mit Version 1.7.3 die Ausgabe von tags zu Nachrichtenbeiträgen in News-Feeds. Standardmäßig werden diese Auszeichnungen als HTML-Liste nach der Beschreibung des Events bzw. des Nachrichtenbeitrags ausgegeben. Falls eine Ausgabe nicht erwünscht ist, so muss die folgende globale Variable updatesicher mit einem negativen Booleschen Wert überschrieben werden:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> $GLOBALS['tags']['showInFeeds'] = false;<br /> &lt;/source&gt;<br /> <br /> Diese Zeile fügt man dann am besten z.B. in die Datei '''&lt;nowiki&gt;system/config/localconfig.php&lt;/nowiki&gt;''' ein.<br /> Die Darstellung der Auszeichnungen im Newsfeed kann über das Template tags_feed beeinflusst werden.<br /> <br /> === Zusätzliche Contao-Module ===<br /> Die tags-Erweiterung führt die folgenden neuen Contao-Module ein:<br /> <br /> ==== Globale Artikelliste ====<br /> Mit der globalen Artikelliste kann man eine Liste aller verfügbaren Artikel einer Contao-Installation ausgeben lassen. In dieser Form ist das Modul natürlich nur bedingt sinnvoll. Wenn man die Ausgabe der Artikel einschränken möchte, wählt man besser das Core-Modul Artikelliste, das eine Artikelliste einer bestimmten Seite ausgeben kann. Die globale Artikelliste sollte hauptsächlich dazu verwendet werden, um aus einer Tag Cloud heraus aufgerufen zu werden. In diesem Fall wird eine Liste aller Artikel ausgegeben, die mit der ausgewählten Auszeichnung versehen wurden.<br /> <br /> ==== Verwendete Auszeichnungen ====<br /> Dieses Modul zeigt die auf einer Seite aktuell verwendeten Auszeichnungen an. Durch Anklicken der Auszeichnungen lässt sich nach eben diesen Filtern. Alle Auszeichnungen können zurückgesetzt werden. Einzelne Auszeichnungen können durch Anklicken aus der Auswahl entfernt werden.<br /> <br /> ==== Einstellungen für Nachrichtenmodule ====<br /> Für die Nachrichtenmodule '''Nachrichtenliste''', '''Nachrichtenarchiv''' und '''Nachrichtenleser''' gibt es eine Einstellung, die verhindert, dass diese Module auf Tags reagieren ('''Auszeichnungen ignorieren'''). Falls z.B. eine Nachrichtenliste der letzten Nachrichten ausgegeben wird, so würde sich die Ausgabe ändern, wenn die Seite über eine Tag Cloud aufgerufen wird. Um dies zu verhindern, kann diese Option ausgewählt werden.<br /> <br /> [[Datei:tags_ignore.png|center|frame|Ignorieren von Auszeichnungen in den Nachrichtenmodulen]]<br /> ==== Auszeichnungsobjekte ====<br /> Mit dem Frontend-Modul Auszeichnungsobjekte kann eine Liste eines bestimmten Inhalts-Objekttyps angezeigt werden. Als '''Objekttyp''' stehen die drei Inhaltstypen ''Seiten'', ''Artikel'' oder ''Inhaltselemente'' zur Verfügung. Der Objekttyp ist das Element, das in der Liste verlinkt wird, wenn eine Auszeichnung existiert. Bei einem ausgewählten Objekttyp ''Seiten'' werden also Links auf Contao-Seiten angezeigt, bei einem Objekttyp Artikel werden Links auf Contao Artikel angezeigt etc.<br /> <br /> Die '''Einschränkung auf Datenquelle''' legt fest, welche Auszeichnungen in der Liste verarbeitet werden sollen. Wird hier z.B. tl_article gewählt, werden nur Artikelauszeichnungen berücksichtigt. Wird tl_content ausgewählt, werden nur Auszeichnungen von Inhaltselementen berücksichtigt.<br /> <br /> Über '''Seiten''' muss man die Seite auswählen, die zur Erstellung der Objektliste verwendet werden soll. Wenn die Seite Unterseiten besitzt, so werden diese ebenfalls für die Generierung der Objektliste verwendet. Das heißt, es werden nur Auszeichnungen berücksichtigt, die für Inhalts-Objekte vergeben wurden, die sich auf der ausgewählten Seite oder deren Unterseiten befinden.<br /> <br /> '''Beispiel:'''<br /> * Objekttyp: Seiten<br /> * Einschränkung auf Datenquelle: tl_article<br /> * Seiten: Startpunkt der aktuellen Website<br /> <br /> Für ausgewählte Auszeichnungen wird eine Liste von Links auf Seiten angezeigt, bei deren Artikel die Auszeichnungen vergeben wurden. Berücksichtigt werden alle Seiten der aktuellen Website.<br /> <br /> <br /> [[Datei:auszeichnungsobjekte.png|center|frame|Einstellungen des Frontendmoduls Auszeichnungsobjekte]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 23:25, 24. Nov. 2011 (CET)</div>

Hschottm https://de.contaowiki.org/Tags 2014-01-13T08:46:51Z

<p>Hschottm: /* Insert Tags */</p> <hr /> <div>[[Kategorie:tags]]<br /> <br /> Auszeichnungen zum Kategorisieren von Elementen.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/tags<br /> | ExtVersion=3.2.0<br /> | Version=3.2.0 - 3.2.3<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/tags.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> | Comment=Versionen ältere Contao-Versionen verfügbar<br /> }}<br /> <br /> <br /> == Modul tags (Auszeichnungen) ==<br /> <br /> tags ist ein Contao-Modul zum Erstellen und Anzeigen von Auszeichnungen innerhalb von Contao. Mit Hilfe des Moduls lassen sich für Entwickler mit geringem Aufwand Auszeichnungen für beliebige Contao Datacontainer (Tabellen) hinzufügen. Es ist zu beachten, dass zum vollständigen Funktionieren der Erweiterung die Mootools Unterstützung im Contao Seitenlayout aktiviert sein muss.<br /> Das Modul stellt ein Eingabefeld-Widget zur Verfügung, das für den aktuellen Datacontainer, in dem es eingesetzt wird, die Auszeichnungen in der Datenbank ablegen und auslesen kann. Die Auszeichnungen werden dabei als kommagetrennte Liste von den Autoren eingegeben oder können, falls JavaScript aktiviert ist, per Mausklick hinzugefügt oder entfernt werden (dies gilt allerdings nur für bereits bestehende Auszeichnungen).<br /> <br /> [[Datei:tags_backend.png|center|frame|Eingabefeld für Auszeichnungen im Backend]]<br /> <br /> In der vorliegenden Abbildung sieht man, dass das ''title''-Attribut der URL einer Auszeichnung die Anzahl der Verwendung derselben anzeigt, d.h. neben dem Namen der Auszeichnung wird die Anzahl der Verwendungen in Klammern hinter den Namen ausgegeben. ''Mathematik (8)'' bedeutet also z.B., dass die Auszeichnung Mathematik insgesamt 8 Mal verwendet wird. <br /> <br /> Es ist zu beachten, dass pro Contao Datacontainer nur ein Eingabefeld für Auszeichnungen verwendet wird, da die Auszeichnungen immer nur für den gesamten Datacontainer vergeben werden und nicht für das zugrund liegende Eingabefeld.<br /> === Hinweise für Entwickler von eigenen Erweiterungen ===<br /> <br /> Nutzer, die Auszeichnungen nur Verwenden wollen und diese nicht in eigene Erweiterungen integrieren wollen, können den folgenden Absatz einfach [[#Verwenden_von_Auszeichnungen_im_Contao-Frontend|überspringen]].<br /> <br /> ==== Hinzufügen von Auszeichnungsfeldern in Contao Datacontainer ====<br /> <br /> Um ein Auszeichnungs-Eingabefeld in einen Contao Datacontainer einzufügen, werden die folgenden Schritte benötigt:<br /> <br /> # Um das Eingabefeld anzuzeigen, muss für den Datacontainer ein entsprechendes Datenbankfeld existieren. Da die Auszeichnungen nicht in diesem Datenbankfeld gespeichert werden, sondern in der speziell vom tags-Modul bereitgestellten Datenbanktabelle ''tl_tag'', reicht es, ein möglichst kleines Datenbankfeld zu erzeugen.<br /> # Das Eingabefeld muss in das DCA Konfigurationsarray eingefügt werden<br /> <br /> Ein neues Datenbankfeld erstellen Sie in der ''config/database.sql''-Datei des gewünschten Moduls. Ein Beispiel ist z.B.<br /> <br /> &lt;source lang=&quot;sql&quot;&gt;<br /> CREATE TABLE `tl_literature` (<br /> `tags` char(1) NOT NULL default ''<br /> ) ENGINE=MyISAM DEFAULT CHARSET=utf8;<br /> &lt;/source&gt;<br /> <br /> Um das Feld mit diesem Namen in das DCA-Konfigurationsarray zu integrieren, muss es in eine der Paletten des Konfigurationsarrays eingefügt werden und eine Felddefinition erstellt werden, also z.B.<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> '' Palettes<br /> 'palettes' =&gt; array(<br /> 'default' =&gt; 'title,author,description,tags,content'<br /> ),<br /> '' Fields<br /> 'fields' =&gt; array(<br /> 'tags' =&gt; array(<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['MSC']['tags'],<br /> 'inputType' =&gt; 'tag'<br /> )<br /> ),<br /> &lt;/source&gt;<br /> <br /> Mit ''$GLOBALS['TL_LANG']['MSC']['tags']'' stellt das tags-Modul bereits einen Standardbezeichner für ein Auszeichnungsfeld zur Verfügung. Man kann diesen natürlich jederzeit gegen eigene Spracheinträge austauschen.<br /> <br /> Beim Speichern eines Datacontainers werden während der Validierung der Daten die Auszeichnungen identifiziert und in der Datenbanktabelle ''tl_tag'' gespeichert. Abgelegt wird die ID des aktuellen Datacontainers (Tabellenfeld ''id''), der Tabellenname des Datacontainers (Tabellenfeld ''from_table'') und die Auszeichnung (Tabellenfeld ''tag'').<br /> <br /> ==== Optionen für das Evaluation-Array des Feldes ====<br /> <br /> {| border=&quot;1&quot; cellpadding=&quot;10&quot; cellspacing=&quot;0&quot; <br /> ! Schlüssel <br /> ! Wert <br /> ! Beschreibung<br /> |- style=&quot;vertical-align: top;&quot;<br /> | table || Quelltabelle ''string'' || Name der Quelltabelle, aus der die Auszeichnungen gebildet werden sollen. Der Standard ist der Name des aktuellen DCA Datencontainers. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | isTag || true/false ''boolean'' || Gibt an, ob der Inhalt des Feldes als Tag gespeichert werden soll oder nicht. Der Standard ist ''true''. Wenn der Inhalt des Feldes nicht als Tag gespeichert werden soll, wird der Feldinhalt ganz normal als kommagetrennte Zeichenkette in der Datenbank abgelegt. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | maxtags || Anzahl ''integer'' || Gibt die maximale Anzahl der Auszeichnungen an, die in der Tag Cloud zum Auswählen der Auszeichnungen angegeben werden. Wenn die Anzahl der verfügbaren Auszeichnungen größer ist, als maxtags, werden die Auszeichnungen mit den wenigsten Vorkommnissen nicht mehr angezeigt. <br /> |}<br /> <br /> === Verwenden von Auszeichnungen im Contao-Frontend ===<br /> Für die Verwendung im Contao-Frontend ist das Modul ''Tag Cloud'' vorgesehen. Das Modul erstellt eine HTML-Liste der für einen oder mehrere Datacontainer verwendeten Auszeichnungen. Um die Liste als Tag Cloud darzustellen, müssen die zugehörigen CSS-Selektoren mit Stilen versehen werden. Zwei Beispieldateien ''[[tags_oxygen.css]]'' und ''[[tags_orange.css]]'' finden sich im ''tl_files/tags''-Verzeichnis des Installationspakets der tags-Erweiterung. Es empfiehlt sich an, sich an diesen Stilen zu orientieren, da es bei der Verwendung der '''Top 10 Auszeichnungen''' darauf ankommt, welche Elemente der Tag Cloud durch die CSS-Stile sichtbar gemacht werden und welche nicht.<br /> <br /> [[Datei:tagcloud_settings_1.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen deaktiviert]]<br /> <br /> Im Eingabefeld '''Maximale Anzahl von Auszeichnungen''' kann man eine maximale Anzahl der anzuzeigenden Auszeichnungen für die Tag Cloud festlegen. Ein Wert von 0 oder kein Wert zeigt immer alle verfügbaren Auszeichnungen an. Bei einem Wert kleiner als die maximale Anzahl der verfügbaren Auszeichnungen werden nur die häufigsten Auszeichnungen gemäß der Vorgabe im Eingabefeld angezeigt. Es ist zu beachten, dass es dadurch möglich ist, dass nicht alle Auszeichnungen angezeigt werden. Man sollte für die Benutzer einen Hinweis vorhalten, der auf diesen Umstand aufmerksam macht.<br /> <br /> Im Eingabefeld '''Anzahl der Auszeichnungsgrößen''' kann man die Anzahl der verfügbaren CSS Selektoren für die Tag Cloud festlegen. Der Standardwert 4 erzeugt vier unterschiedliche Gruppen von Auszeichnungen mit den Selektoren size1, size2, size3 und size4, man kann also maximal 4 unterschiedliche Größen von Auszeichnungen im Frontend ausgeben. Es ist darauf zu achten, dass man immer für alle möglichen CSS Selektoren ein CSS-Element vorhält.<br /> <br /> Das Kontrollkästchen '''Auszeichnungs-Klassennamen verwenden''' fügt einen zusätzlichen CSS Klassennamen für jede Auszeichnung hinzu, der aus dem Namen der jweiligen Auszeichnung besteht. Damit können einzelne Auszeichnungen individuell per CSS angepasst werden. Leerzeichen in den Auszeichnungsnamen werden für die CSS-Klassennamen in Unterstriche umgewandelt.<br /> <br /> Mit dem Auswahlfeld '''Tag Cloud Template''' kann man das Template bestimmen, das für die Generierung der Tag Cloud im Frontend verwendet werden soll. Standardmäßig ist dies das Template ''mod_tagcloud''. Man kann sich aber auch eigene Templates erstellen und hier verwenden. Diese müssen dann lediglich mit der Zeichenkette mod_tagcloud beginnen, also z.B. mod_tagcloud_spezial etc.<br /> <br /> Das Kontrollkästchen '''Zugehörige Auszeichnungen''' zeigt im Frontend bei Auswahl mindestens einer Auszeichnung eine Liste weitere Auszeichnungen an, die im Zusammenhang mit der ausgewählten Auszeichnung vergeben wurden. Durch einen Klick auf eine dieser zugehörigen Auszeichnungen kann die Suche nach ausgezeichneten Objekten weiter eingeschränkt werden. Natürlich funktioniert die Anzeige der zugehörigen Auszeichnungen nur dann, wenn sich das Tag Cloud Modul auf einer Seite befindet, die sich in der Weiterleitung der Tag Cloud Hyperlinks befindet, da die Tag Cloud sonst keinerlei Kenntnis von bereits ausgewählten Auszeichnungen haben kann.<br /> <br /> Das Kontrollkästchen '''Top 10 Auszeichnungen''' erzeugt über der Tag Cloud eine weitere Tag Cloud, welche die 10 häufigsten Auszeichnungen beinhaltet, in der Reihenfolge des häufigsten Auftretens. Gleichzeitig ist dieses Kontrollkästchen ein Selektor, der bei Aktivierung zwei weitere Kontrollkästchen erzeugt:<br /> <br /> * '''Top 10 Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, sind die Top 10 Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> * '''Alle Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, ist die Tag Cloud mit allen Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> <br /> [[Datei:tagcloud_settings_1a.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen aktiviert]]<br /> <br /> Man wählt unter '''Weiterleitung zu Seite''' eine interne Contao-Seite aus, damit die Auszeichnungen der Tag Cloud mit Hyperlinks versehen werden. Die gewählte Seite wird dann immer mit dem URL-Parameter ''tag=TAGNAME'' aufgerufen, also z.B. ''http://www.meineseite.de/weiterleitung.html?tag=typolight''.<br /> <br /> <br /> [[Datei:tagcloud_settings_2.png|center|frame|Tabellenspezifische Eingabefelder des Tag Cloud Moduls im Backend]]<br /> <br /> Bei '''Einschränkung auf Tabelle(n)''' wählt man normalerweise immer nur den Datacontainer aus, für den die Tags gespeichert wurden.<br /> <br /> Die Felder '''Quell-Tabelle für Auszeichnungen''' und '''Tabellenfeld für Auszeichnungen''' werden mit den Standardeinträgen ''tl_tag'' und ''tag'' vorbelegt und sollten nur dann geändert werden, wenn man die Tags aus einer eigenen Tabelle beisteuern will.<br /> <br /> Mit den Feldern '''CSS-Id/Klasse''' kann man zusätzliche CSS-ID's oder Klassen vergeben, die dann im umschließenden DIV-Container der Tag Cloud eingebettet werden. Dadurch hat man die Möglichkeit individuelle Stile für die Tag Clouds einzusetzen.<br /> <br /> Im Frontend sieht die Tag Cloud dann z.B. folgendermaßen aus:<br /> <br /> [[Datei:tagcloud_frontend.png|center|frame|Ausgabe der Tag Cloud im Frontend]]<br /> <br /> bzw. mit aktivierten Top 10 Auszeichnungen:<br /> <br /> [[Datei:tags_topten.png|center|frame|Tag Cloud mit Top 10 Auszeichnungen]]<br /> <br /> bwz. mit aktivierten Top 10 und zugehörigen Auszeichnungen:<br /> <br /> [[Datei:tags_related.png|center|frame|Tag Cloud mit Top 10 und zugehörigen Auszeichnungen]]<br /> <br /> Werden zwei Tag Clouds (Top 10 + Alle) oder die zugehörigen Auszeichnungen angezeigt, bindet Contao ein JavaScript ein, das die jeweiligen Tag Clouds bei Mausklick auf den Titel einklappt bzw. ausklappt. Ist kein JavaScript aktiviert, so werden die dreieckigen Klappsymbole nicht angezeigt. Für einen optimale Zusammenarbeit mit der JavaScript-Erweiterung sollte man die installierten CSS-Dateien tags_oxygen.css oder tags_orange.css in die Seite einbinden.<br /> <br /> Die folgenden Contao-Elemente können mit Tags versehen werden:<br /> <br /> * Nachrichtenbeiträge<br /> * Artikel<br /> * Inhaltselemente<br /> * Kalender/Events<br /> * FAQ (ab Contao 2.11)<br /> * Dateien (ab Contao 3.1)<br /> <br /> ==== Weiterleitung zu Seiten über eine Tag Cloud ====<br /> <br /> Damit eine sinnvolle Weiterleitung aus einer Tag Cloud vorgenommen werden kann, muss die Seite, zu der weitergeleitet wird, den tag-Parameter in der URL interpretieren können. Hierin liegt die Hauptarbeit, wenn die Tag-Unterstützung für bestehende Contao-Datacontainer vorgenommen werden soll.<br /> <br /> Die folgenden Contao-Module reagieren auf einen Aufruf aus einer Tag Cloud heraus und zeigen nur die Elemente an, die mit der ausgewählten Auszeichnung versehen wurden:<br /> <br /> * Modul '''Nachrichtenarchiv''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Nachrichtenliste''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Globale Artikelliste''': Es werden Links auf alle Artikel angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Eventliste''': Es werden alle Events der ausgewählten Kalender im ausgewählten Zeitraum angezeigt, die mit der gesuchten Auszeichnung versehen sind.<br /> * Modul '''Auszeichnungsobjekte''': Es werden Inhaltselemente (Seiten, Artikel, Inhaltselemente) in einer Liste angezeigt, die mit einer bestimmten Auszeichnung versehen sind.<br /> <br /> ==== Ausgabe von Auszeichnungslisten zu Nachrichtenbeiträgen ====<br /> <br /> Bei der Ausgabe von Nachrichtenbeiträgen gibt es die Möglichkeit, unterhalb des Nachrichtenbeitrags die zum Beitrag zugehörigen Auszeichnungen anzeigen zu lassen. Zu diesem Zweck kann die Ausgabe der Auszeichnungen in den Frontend-Modulen zur Nachrichtenanzeige, '''Nachrichtenleser''', '''Nachrichtenliste''' und '''Nachrichtenarchiv''', aktiviert werden.<br /> <br /> [[Datei:tags_tag_settings.png|center|frame|Aktivierung einer Auszeichnungsliste im Modul des Contao Backends]]<br /> <br /> Mit der Option '''Auszeichnungen ignorieren''' werden von der Liste alle zur Filterung verwendeten Auszeichnungen verworfen.<br /> <br /> Wenn man die Option '''Nachrichten-Auszeichnungen anzeigen''' auswählt, erscheint zusätzlich ein Auswahl-Feld für eine Weiterleitungsseite, die aufgerufen wird, wenn aus eine der Auszeichnungen geklickt wird. Hier wählt man die Seite aus, auf die man auch aus der Tag Cloud heraus weiterleitet oder aber natürlich jede beliebige andere Seite, wenn man eine spezielle Behandlung der zu einer Nachrichten angeklickten Auszeichnungen wünscht.<br /> <br /> Um, wie bei den Tag Clouds die Namen der individuellen CSS-Klassen der jeweiligen Auszeichnungen anzuzeigen, wurde die Option &quot;Auszeichnungs-Klassennamen verwenden&quot; eingeführt. Diese verwendet die individuelle CSS-Klasse in allen Auszeichnungen, die unterhalb eines Nachrichtenbeitrags angezeigt werden.<br /> <br /> Damit eine Ausgabe der Auszeichnungen im Frontend auch wirklich ausgeführt wird, muss man außerdem die '''Nachrichtenvorlage''' des Moduls anpassen. Speziell für diesen Zweck wurde mit der tags-Erweiterung das Template ''news_full_tags'' erstellt, das den entsprechenden HTML-Code zur Ausgabe der Auszeichnungen unterhalb eines Nachrichtenbeitrags bereitstellt. Wenn man ein anderes Template für die Ausgabe verwenden will und die Ausgabe der Auszeichnungen zu einem Nachrichtenbeitrag wünscht, sollte man den im Template news_full_tags hinzugekommenen Quellcode kopieren und in das gewünschte Template einfügen:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> &lt;?php if ($this-&gt;showTags): ?&gt;<br /> <br /> &lt;?php if (count($this-&gt;taglist)): ?&gt;<br /> &lt;ul class=&quot;tag-chain&quot;&gt;<br /> &lt;?php $counter = 0; foreach ($this-&gt;taglist as $tag): ?&gt;<br /> &lt;li class=&quot;tag-chain-item&lt;?php if ($counter == 0) echo ' first'; ?&gt;<br /> &lt;?php if ($counter == count($this-&gt;taglist)-1) echo ' last'; ?&gt;<br /> &lt;?php if ($this-&gt;showTagClass) echo ' ' . $tag['class']; ?&gt;&quot;&gt;&lt;?php echo $tag['url']; ?&gt;&lt;/li&gt;<br /> &lt;?php $counter++; endforeach; ?&gt;<br /> &lt;/ul&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;/source&gt;<br /> <br /> Für die Ausgabe der Auszeichnungen enthalten die in der Erweiterung mitgelieferten CSS-Dateien tags_orange.css und tags_oxygen.css weitere CSS-Selektoren, die für eine grundlegende Formatierung der Auszeichnungslisten sorgen.<br /> Ein Nachrichtenbeitrag mit den dazugehörigen Auszeichnungen könnte dann z.B. folgendermaßen aussehen:<br /> <br /> [[Datei:auszeichnungsliste.png|center|frame|Darstellung einer Nachricht mit zugehörigen Auszeichnungen]]<br /> <br /> === Inhaltselemente ===<br /> Die tags-Erweiterung erweitert des Contao Inhaltselement '''Überschrift''' und fügt in den Experten-Einstellungen einen zusätzlichen Parameter '''Nur bei Auszeichnungen anzeigen''' ein. Wird dieses Feld ausgewählt, dann zeigt Contao die Überschrift nur dann an, wenn auf der betreffenden Seite Auszeichnungen verwendet werden, d.h. wenn von einer Tag Cloud über eine Auszeichnung auf die Seite verzweigt wird. Zu erkennen ist die am Paramter '''tag''' in der URL der Seite.<br /> <br /> [[Datei:heading_tags_only.png|center|frame|Auswahl 'Nur bei Auszeichnungen anzeigen' im Überschrift Inhaltselement]]<br /> <br /> Dieses Feld kann in Kombination mit dem Insert Tag &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt; z.B. dazu eingesetzt werden, eine für ausgewählte Tags passende Überschrift anzuzeigen, z.B. '''Auswahl der Teilnehmer &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''' =&gt; '''Auswahl der Teilnehmer (Kongress+Oktober+Hamburg)'''<br /> === Insert Tags ===<br /> <br /> tags führt die folgenden Insert Tags für Contao ein:<br /> <br /> * '''&lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der aktuell verwendeten Auszeichnungen, z.B. '''(Contao+Erweiterung+tags)'''<br /> * '''&lt;nowiki&gt;{{tags_news::news_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Nachrichtenbeitrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_news::1}}&lt;/nowiki&gt; die Auszeichnungen des Nachrichtenbeitrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_event::event_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Kalendereintrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_event::1}}&lt;/nowiki&gt; die Auszeichnungen des Kalendereintrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_article::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article_url::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen als URL auf den zugehörigen Artikel, z.B. zeigt &lt;nowiki&gt;{{tags_article_url::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an und verlinkt jede Auszeichnung mit der Seite des Artikels. <br /> * '''&lt;nowiki&gt;{{tags_content::content_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für ein Inhaltselement vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_content::1}}&lt;/nowiki&gt; die Auszeichnungen des Inhaltselements mit der ID 1 an.<br /> * '''&lt;nowiki&gt;{{tags_faq::faq_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen FAQ-Eintrag vergebenen Auszeichnungen als URL auf die aktuelle Seite, z.B. zeigt &lt;nowiki&gt;{{tags_afaq::1}}&lt;/nowiki&gt; die Auszeichnungen des FAQ-Eintrags mit der ID 1 an.<br /> <br /> === Ausgabe in Feeds ===<br /> Mit Version 1.7.2 ist auch die Ausgabe von tags zu Events (Kalendereinträgen) in Kalender-Feeds möglich, mit Version 1.7.3 die Ausgabe von tags zu Nachrichtenbeiträgen in News-Feeds. Standardmäßig werden diese Auszeichnungen als HTML-Liste nach der Beschreibung des Events bzw. des Nachrichtenbeitrags ausgegeben. Falls eine Ausgabe nicht erwünscht ist, so muss die folgende globale Variable updatesicher mit einem negativen Booleschen Wert überschrieben werden:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> $GLOBALS['tags']['showInFeeds'] = false;<br /> &lt;/source&gt;<br /> <br /> Diese Zeile fügt man dann am besten z.B. in die Datei '''&lt;nowiki&gt;system/config/localconfig.php&lt;/nowiki&gt;''' ein.<br /> Die Darstellung der Auszeichnungen im Newsfeed kann über das Template tags_feed beeinflusst werden.<br /> <br /> === Zusätzliche Contao-Module ===<br /> Die tags-Erweiterung führt die folgenden neuen Contao-Module ein:<br /> <br /> ==== Globale Artikelliste ====<br /> Mit der globalen Artikelliste kann man eine Liste aller verfügbaren Artikel einer Contao-Installation ausgeben lassen. In dieser Form ist das Modul natürlich nur bedingt sinnvoll. Wenn man die Ausgabe der Artikel einschränken möchte, wählt man besser das Core-Modul Artikelliste, das eine Artikelliste einer bestimmten Seite ausgeben kann. Die globale Artikelliste sollte hauptsächlich dazu verwendet werden, um aus einer Tag Cloud heraus aufgerufen zu werden. In diesem Fall wird eine Liste aller Artikel ausgegeben, die mit der ausgewählten Auszeichnung versehen wurden.<br /> <br /> ==== Verwendete Auszeichnungen ====<br /> Dieses Modul zeigt die auf einer Seite aktuell verwendeten Auszeichnungen an. Durch Anklicken der Auszeichnungen lässt sich nach eben diesen Filtern. Alle Auszeichnungen können zurückgesetzt werden. Einzelne Auszeichnungen können durch Anklicken aus der Auswahl entfernt werden.<br /> <br /> ==== Einstellungen für Nachrichtenmodule ====<br /> Für die Nachrichtenmodule '''Nachrichtenliste''', '''Nachrichtenarchiv''' und '''Nachrichtenleser''' gibt es eine Einstellung, die verhindert, dass diese Module auf Tags reagieren ('''Auszeichnungen ignorieren'''). Falls z.B. eine Nachrichtenliste der letzten Nachrichten ausgegeben wird, so würde sich die Ausgabe ändern, wenn die Seite über eine Tag Cloud aufgerufen wird. Um dies zu verhindern, kann diese Option ausgewählt werden.<br /> <br /> [[Datei:tags_ignore.png|center|frame|Ignorieren von Auszeichnungen in den Nachrichtenmodulen]]<br /> ==== Auszeichnungsobjekte ====<br /> Mit dem Frontend-Modul Auszeichnungsobjekte kann eine Liste eines bestimmten Inhalts-Objekttyps angezeigt werden. Als '''Objekttyp''' stehen die drei Inhaltstypen ''Seiten'', ''Artikel'' oder ''Inhaltselemente'' zur Verfügung. Der Objekttyp ist das Element, das in der Liste verlinkt wird, wenn eine Auszeichnung existiert. Bei einem ausgewählten Objekttyp ''Seiten'' werden also Links auf Contao-Seiten angezeigt, bei einem Objekttyp Artikel werden Links auf Contao Artikel angezeigt etc.<br /> <br /> Die '''Einschränkung auf Datenquelle''' legt fest, welche Auszeichnungen in der Liste verarbeitet werden sollen. Wird hier z.B. tl_article gewählt, werden nur Artikelauszeichnungen berücksichtigt. Wird tl_content ausgewählt, werden nur Auszeichnungen von Inhaltselementen berücksichtigt.<br /> <br /> Über '''Seiten''' muss man die Seite auswählen, die zur Erstellung der Objektliste verwendet werden soll. Wenn die Seite Unterseiten besitzt, so werden diese ebenfalls für die Generierung der Objektliste verwendet. Das heißt, es werden nur Auszeichnungen berücksichtigt, die für Inhalts-Objekte vergeben wurden, die sich auf der ausgewählten Seite oder deren Unterseiten befinden.<br /> <br /> '''Beispiel:'''<br /> * Objekttyp: Seiten<br /> * Einschränkung auf Datenquelle: tl_article<br /> * Seiten: Startpunkt der aktuellen Website<br /> <br /> Für ausgewählte Auszeichnungen wird eine Liste von Links auf Seiten angezeigt, bei deren Artikel die Auszeichnungen vergeben wurden. Berücksichtigt werden alle Seiten der aktuellen Website.<br /> <br /> <br /> [[Datei:auszeichnungsobjekte.png|center|frame|Einstellungen des Frontendmoduls Auszeichnungsobjekte]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 23:25, 24. Nov. 2011 (CET)</div>

Hschottm https://de.contaowiki.org/Tags 2014-01-13T08:13:33Z

<p>Hschottm: /* Verwenden von Auszeichnungen im Contao-Frontend */</p> <hr /> <div>[[Kategorie:tags]]<br /> <br /> Auszeichnungen zum Kategorisieren von Elementen.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/tags<br /> | ExtVersion=3.2.0<br /> | Version=3.2.0 - 3.2.3<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/tags.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> | Comment=Versionen ältere Contao-Versionen verfügbar<br /> }}<br /> <br /> <br /> == Modul tags (Auszeichnungen) ==<br /> <br /> tags ist ein Contao-Modul zum Erstellen und Anzeigen von Auszeichnungen innerhalb von Contao. Mit Hilfe des Moduls lassen sich für Entwickler mit geringem Aufwand Auszeichnungen für beliebige Contao Datacontainer (Tabellen) hinzufügen. Es ist zu beachten, dass zum vollständigen Funktionieren der Erweiterung die Mootools Unterstützung im Contao Seitenlayout aktiviert sein muss.<br /> Das Modul stellt ein Eingabefeld-Widget zur Verfügung, das für den aktuellen Datacontainer, in dem es eingesetzt wird, die Auszeichnungen in der Datenbank ablegen und auslesen kann. Die Auszeichnungen werden dabei als kommagetrennte Liste von den Autoren eingegeben oder können, falls JavaScript aktiviert ist, per Mausklick hinzugefügt oder entfernt werden (dies gilt allerdings nur für bereits bestehende Auszeichnungen).<br /> <br /> [[Datei:tags_backend.png|center|frame|Eingabefeld für Auszeichnungen im Backend]]<br /> <br /> In der vorliegenden Abbildung sieht man, dass das ''title''-Attribut der URL einer Auszeichnung die Anzahl der Verwendung derselben anzeigt, d.h. neben dem Namen der Auszeichnung wird die Anzahl der Verwendungen in Klammern hinter den Namen ausgegeben. ''Mathematik (8)'' bedeutet also z.B., dass die Auszeichnung Mathematik insgesamt 8 Mal verwendet wird. <br /> <br /> Es ist zu beachten, dass pro Contao Datacontainer nur ein Eingabefeld für Auszeichnungen verwendet wird, da die Auszeichnungen immer nur für den gesamten Datacontainer vergeben werden und nicht für das zugrund liegende Eingabefeld.<br /> === Hinweise für Entwickler von eigenen Erweiterungen ===<br /> <br /> Nutzer, die Auszeichnungen nur Verwenden wollen und diese nicht in eigene Erweiterungen integrieren wollen, können den folgenden Absatz einfach [[#Verwenden_von_Auszeichnungen_im_Contao-Frontend|überspringen]].<br /> <br /> ==== Hinzufügen von Auszeichnungsfeldern in Contao Datacontainer ====<br /> <br /> Um ein Auszeichnungs-Eingabefeld in einen Contao Datacontainer einzufügen, werden die folgenden Schritte benötigt:<br /> <br /> # Um das Eingabefeld anzuzeigen, muss für den Datacontainer ein entsprechendes Datenbankfeld existieren. Da die Auszeichnungen nicht in diesem Datenbankfeld gespeichert werden, sondern in der speziell vom tags-Modul bereitgestellten Datenbanktabelle ''tl_tag'', reicht es, ein möglichst kleines Datenbankfeld zu erzeugen.<br /> # Das Eingabefeld muss in das DCA Konfigurationsarray eingefügt werden<br /> <br /> Ein neues Datenbankfeld erstellen Sie in der ''config/database.sql''-Datei des gewünschten Moduls. Ein Beispiel ist z.B.<br /> <br /> &lt;source lang=&quot;sql&quot;&gt;<br /> CREATE TABLE `tl_literature` (<br /> `tags` char(1) NOT NULL default ''<br /> ) ENGINE=MyISAM DEFAULT CHARSET=utf8;<br /> &lt;/source&gt;<br /> <br /> Um das Feld mit diesem Namen in das DCA-Konfigurationsarray zu integrieren, muss es in eine der Paletten des Konfigurationsarrays eingefügt werden und eine Felddefinition erstellt werden, also z.B.<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> '' Palettes<br /> 'palettes' =&gt; array(<br /> 'default' =&gt; 'title,author,description,tags,content'<br /> ),<br /> '' Fields<br /> 'fields' =&gt; array(<br /> 'tags' =&gt; array(<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['MSC']['tags'],<br /> 'inputType' =&gt; 'tag'<br /> )<br /> ),<br /> &lt;/source&gt;<br /> <br /> Mit ''$GLOBALS['TL_LANG']['MSC']['tags']'' stellt das tags-Modul bereits einen Standardbezeichner für ein Auszeichnungsfeld zur Verfügung. Man kann diesen natürlich jederzeit gegen eigene Spracheinträge austauschen.<br /> <br /> Beim Speichern eines Datacontainers werden während der Validierung der Daten die Auszeichnungen identifiziert und in der Datenbanktabelle ''tl_tag'' gespeichert. Abgelegt wird die ID des aktuellen Datacontainers (Tabellenfeld ''id''), der Tabellenname des Datacontainers (Tabellenfeld ''from_table'') und die Auszeichnung (Tabellenfeld ''tag'').<br /> <br /> ==== Optionen für das Evaluation-Array des Feldes ====<br /> <br /> {| border=&quot;1&quot; cellpadding=&quot;10&quot; cellspacing=&quot;0&quot; <br /> ! Schlüssel <br /> ! Wert <br /> ! Beschreibung<br /> |- style=&quot;vertical-align: top;&quot;<br /> | table || Quelltabelle ''string'' || Name der Quelltabelle, aus der die Auszeichnungen gebildet werden sollen. Der Standard ist der Name des aktuellen DCA Datencontainers. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | isTag || true/false ''boolean'' || Gibt an, ob der Inhalt des Feldes als Tag gespeichert werden soll oder nicht. Der Standard ist ''true''. Wenn der Inhalt des Feldes nicht als Tag gespeichert werden soll, wird der Feldinhalt ganz normal als kommagetrennte Zeichenkette in der Datenbank abgelegt. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | maxtags || Anzahl ''integer'' || Gibt die maximale Anzahl der Auszeichnungen an, die in der Tag Cloud zum Auswählen der Auszeichnungen angegeben werden. Wenn die Anzahl der verfügbaren Auszeichnungen größer ist, als maxtags, werden die Auszeichnungen mit den wenigsten Vorkommnissen nicht mehr angezeigt. <br /> |}<br /> <br /> === Verwenden von Auszeichnungen im Contao-Frontend ===<br /> Für die Verwendung im Contao-Frontend ist das Modul ''Tag Cloud'' vorgesehen. Das Modul erstellt eine HTML-Liste der für einen oder mehrere Datacontainer verwendeten Auszeichnungen. Um die Liste als Tag Cloud darzustellen, müssen die zugehörigen CSS-Selektoren mit Stilen versehen werden. Zwei Beispieldateien ''[[tags_oxygen.css]]'' und ''[[tags_orange.css]]'' finden sich im ''tl_files/tags''-Verzeichnis des Installationspakets der tags-Erweiterung. Es empfiehlt sich an, sich an diesen Stilen zu orientieren, da es bei der Verwendung der '''Top 10 Auszeichnungen''' darauf ankommt, welche Elemente der Tag Cloud durch die CSS-Stile sichtbar gemacht werden und welche nicht.<br /> <br /> [[Datei:tagcloud_settings_1.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen deaktiviert]]<br /> <br /> Im Eingabefeld '''Maximale Anzahl von Auszeichnungen''' kann man eine maximale Anzahl der anzuzeigenden Auszeichnungen für die Tag Cloud festlegen. Ein Wert von 0 oder kein Wert zeigt immer alle verfügbaren Auszeichnungen an. Bei einem Wert kleiner als die maximale Anzahl der verfügbaren Auszeichnungen werden nur die häufigsten Auszeichnungen gemäß der Vorgabe im Eingabefeld angezeigt. Es ist zu beachten, dass es dadurch möglich ist, dass nicht alle Auszeichnungen angezeigt werden. Man sollte für die Benutzer einen Hinweis vorhalten, der auf diesen Umstand aufmerksam macht.<br /> <br /> Im Eingabefeld '''Anzahl der Auszeichnungsgrößen''' kann man die Anzahl der verfügbaren CSS Selektoren für die Tag Cloud festlegen. Der Standardwert 4 erzeugt vier unterschiedliche Gruppen von Auszeichnungen mit den Selektoren size1, size2, size3 und size4, man kann also maximal 4 unterschiedliche Größen von Auszeichnungen im Frontend ausgeben. Es ist darauf zu achten, dass man immer für alle möglichen CSS Selektoren ein CSS-Element vorhält.<br /> <br /> Das Kontrollkästchen '''Auszeichnungs-Klassennamen verwenden''' fügt einen zusätzlichen CSS Klassennamen für jede Auszeichnung hinzu, der aus dem Namen der jweiligen Auszeichnung besteht. Damit können einzelne Auszeichnungen individuell per CSS angepasst werden. Leerzeichen in den Auszeichnungsnamen werden für die CSS-Klassennamen in Unterstriche umgewandelt.<br /> <br /> Mit dem Auswahlfeld '''Tag Cloud Template''' kann man das Template bestimmen, das für die Generierung der Tag Cloud im Frontend verwendet werden soll. Standardmäßig ist dies das Template ''mod_tagcloud''. Man kann sich aber auch eigene Templates erstellen und hier verwenden. Diese müssen dann lediglich mit der Zeichenkette mod_tagcloud beginnen, also z.B. mod_tagcloud_spezial etc.<br /> <br /> Das Kontrollkästchen '''Zugehörige Auszeichnungen''' zeigt im Frontend bei Auswahl mindestens einer Auszeichnung eine Liste weitere Auszeichnungen an, die im Zusammenhang mit der ausgewählten Auszeichnung vergeben wurden. Durch einen Klick auf eine dieser zugehörigen Auszeichnungen kann die Suche nach ausgezeichneten Objekten weiter eingeschränkt werden. Natürlich funktioniert die Anzeige der zugehörigen Auszeichnungen nur dann, wenn sich das Tag Cloud Modul auf einer Seite befindet, die sich in der Weiterleitung der Tag Cloud Hyperlinks befindet, da die Tag Cloud sonst keinerlei Kenntnis von bereits ausgewählten Auszeichnungen haben kann.<br /> <br /> Das Kontrollkästchen '''Top 10 Auszeichnungen''' erzeugt über der Tag Cloud eine weitere Tag Cloud, welche die 10 häufigsten Auszeichnungen beinhaltet, in der Reihenfolge des häufigsten Auftretens. Gleichzeitig ist dieses Kontrollkästchen ein Selektor, der bei Aktivierung zwei weitere Kontrollkästchen erzeugt:<br /> <br /> * '''Top 10 Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, sind die Top 10 Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> * '''Alle Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, ist die Tag Cloud mit allen Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> <br /> [[Datei:tagcloud_settings_1a.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen aktiviert]]<br /> <br /> Man wählt unter '''Weiterleitung zu Seite''' eine interne Contao-Seite aus, damit die Auszeichnungen der Tag Cloud mit Hyperlinks versehen werden. Die gewählte Seite wird dann immer mit dem URL-Parameter ''tag=TAGNAME'' aufgerufen, also z.B. ''http://www.meineseite.de/weiterleitung.html?tag=typolight''.<br /> <br /> <br /> [[Datei:tagcloud_settings_2.png|center|frame|Tabellenspezifische Eingabefelder des Tag Cloud Moduls im Backend]]<br /> <br /> Bei '''Einschränkung auf Tabelle(n)''' wählt man normalerweise immer nur den Datacontainer aus, für den die Tags gespeichert wurden.<br /> <br /> Die Felder '''Quell-Tabelle für Auszeichnungen''' und '''Tabellenfeld für Auszeichnungen''' werden mit den Standardeinträgen ''tl_tag'' und ''tag'' vorbelegt und sollten nur dann geändert werden, wenn man die Tags aus einer eigenen Tabelle beisteuern will.<br /> <br /> Mit den Feldern '''CSS-Id/Klasse''' kann man zusätzliche CSS-ID's oder Klassen vergeben, die dann im umschließenden DIV-Container der Tag Cloud eingebettet werden. Dadurch hat man die Möglichkeit individuelle Stile für die Tag Clouds einzusetzen.<br /> <br /> Im Frontend sieht die Tag Cloud dann z.B. folgendermaßen aus:<br /> <br /> [[Datei:tagcloud_frontend.png|center|frame|Ausgabe der Tag Cloud im Frontend]]<br /> <br /> bzw. mit aktivierten Top 10 Auszeichnungen:<br /> <br /> [[Datei:tags_topten.png|center|frame|Tag Cloud mit Top 10 Auszeichnungen]]<br /> <br /> bwz. mit aktivierten Top 10 und zugehörigen Auszeichnungen:<br /> <br /> [[Datei:tags_related.png|center|frame|Tag Cloud mit Top 10 und zugehörigen Auszeichnungen]]<br /> <br /> Werden zwei Tag Clouds (Top 10 + Alle) oder die zugehörigen Auszeichnungen angezeigt, bindet Contao ein JavaScript ein, das die jeweiligen Tag Clouds bei Mausklick auf den Titel einklappt bzw. ausklappt. Ist kein JavaScript aktiviert, so werden die dreieckigen Klappsymbole nicht angezeigt. Für einen optimale Zusammenarbeit mit der JavaScript-Erweiterung sollte man die installierten CSS-Dateien tags_oxygen.css oder tags_orange.css in die Seite einbinden.<br /> <br /> Die folgenden Contao-Elemente können mit Tags versehen werden:<br /> <br /> * Nachrichtenbeiträge<br /> * Artikel<br /> * Inhaltselemente<br /> * Kalender/Events<br /> * FAQ (ab Contao 2.11)<br /> * Dateien (ab Contao 3.1)<br /> <br /> ==== Weiterleitung zu Seiten über eine Tag Cloud ====<br /> <br /> Damit eine sinnvolle Weiterleitung aus einer Tag Cloud vorgenommen werden kann, muss die Seite, zu der weitergeleitet wird, den tag-Parameter in der URL interpretieren können. Hierin liegt die Hauptarbeit, wenn die Tag-Unterstützung für bestehende Contao-Datacontainer vorgenommen werden soll.<br /> <br /> Die folgenden Contao-Module reagieren auf einen Aufruf aus einer Tag Cloud heraus und zeigen nur die Elemente an, die mit der ausgewählten Auszeichnung versehen wurden:<br /> <br /> * Modul '''Nachrichtenarchiv''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Nachrichtenliste''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Globale Artikelliste''': Es werden Links auf alle Artikel angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Eventliste''': Es werden alle Events der ausgewählten Kalender im ausgewählten Zeitraum angezeigt, die mit der gesuchten Auszeichnung versehen sind.<br /> * Modul '''Auszeichnungsobjekte''': Es werden Inhaltselemente (Seiten, Artikel, Inhaltselemente) in einer Liste angezeigt, die mit einer bestimmten Auszeichnung versehen sind.<br /> <br /> ==== Ausgabe von Auszeichnungslisten zu Nachrichtenbeiträgen ====<br /> <br /> Bei der Ausgabe von Nachrichtenbeiträgen gibt es die Möglichkeit, unterhalb des Nachrichtenbeitrags die zum Beitrag zugehörigen Auszeichnungen anzeigen zu lassen. Zu diesem Zweck kann die Ausgabe der Auszeichnungen in den Frontend-Modulen zur Nachrichtenanzeige, '''Nachrichtenleser''', '''Nachrichtenliste''' und '''Nachrichtenarchiv''', aktiviert werden.<br /> <br /> [[Datei:tags_tag_settings.png|center|frame|Aktivierung einer Auszeichnungsliste im Modul des Contao Backends]]<br /> <br /> Mit der Option '''Auszeichnungen ignorieren''' werden von der Liste alle zur Filterung verwendeten Auszeichnungen verworfen.<br /> <br /> Wenn man die Option '''Nachrichten-Auszeichnungen anzeigen''' auswählt, erscheint zusätzlich ein Auswahl-Feld für eine Weiterleitungsseite, die aufgerufen wird, wenn aus eine der Auszeichnungen geklickt wird. Hier wählt man die Seite aus, auf die man auch aus der Tag Cloud heraus weiterleitet oder aber natürlich jede beliebige andere Seite, wenn man eine spezielle Behandlung der zu einer Nachrichten angeklickten Auszeichnungen wünscht.<br /> <br /> Um, wie bei den Tag Clouds die Namen der individuellen CSS-Klassen der jeweiligen Auszeichnungen anzuzeigen, wurde die Option &quot;Auszeichnungs-Klassennamen verwenden&quot; eingeführt. Diese verwendet die individuelle CSS-Klasse in allen Auszeichnungen, die unterhalb eines Nachrichtenbeitrags angezeigt werden.<br /> <br /> Damit eine Ausgabe der Auszeichnungen im Frontend auch wirklich ausgeführt wird, muss man außerdem die '''Nachrichtenvorlage''' des Moduls anpassen. Speziell für diesen Zweck wurde mit der tags-Erweiterung das Template ''news_full_tags'' erstellt, das den entsprechenden HTML-Code zur Ausgabe der Auszeichnungen unterhalb eines Nachrichtenbeitrags bereitstellt. Wenn man ein anderes Template für die Ausgabe verwenden will und die Ausgabe der Auszeichnungen zu einem Nachrichtenbeitrag wünscht, sollte man den im Template news_full_tags hinzugekommenen Quellcode kopieren und in das gewünschte Template einfügen:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> &lt;?php if ($this-&gt;showTags): ?&gt;<br /> <br /> &lt;?php if (count($this-&gt;taglist)): ?&gt;<br /> &lt;ul class=&quot;tag-chain&quot;&gt;<br /> &lt;?php $counter = 0; foreach ($this-&gt;taglist as $tag): ?&gt;<br /> &lt;li class=&quot;tag-chain-item&lt;?php if ($counter == 0) echo ' first'; ?&gt;<br /> &lt;?php if ($counter == count($this-&gt;taglist)-1) echo ' last'; ?&gt;<br /> &lt;?php if ($this-&gt;showTagClass) echo ' ' . $tag['class']; ?&gt;&quot;&gt;&lt;?php echo $tag['url']; ?&gt;&lt;/li&gt;<br /> &lt;?php $counter++; endforeach; ?&gt;<br /> &lt;/ul&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;/source&gt;<br /> <br /> Für die Ausgabe der Auszeichnungen enthalten die in der Erweiterung mitgelieferten CSS-Dateien tags_orange.css und tags_oxygen.css weitere CSS-Selektoren, die für eine grundlegende Formatierung der Auszeichnungslisten sorgen.<br /> Ein Nachrichtenbeitrag mit den dazugehörigen Auszeichnungen könnte dann z.B. folgendermaßen aussehen:<br /> <br /> [[Datei:auszeichnungsliste.png|center|frame|Darstellung einer Nachricht mit zugehörigen Auszeichnungen]]<br /> <br /> === Inhaltselemente ===<br /> Die tags-Erweiterung erweitert des Contao Inhaltselement '''Überschrift''' und fügt in den Experten-Einstellungen einen zusätzlichen Parameter '''Nur bei Auszeichnungen anzeigen''' ein. Wird dieses Feld ausgewählt, dann zeigt Contao die Überschrift nur dann an, wenn auf der betreffenden Seite Auszeichnungen verwendet werden, d.h. wenn von einer Tag Cloud über eine Auszeichnung auf die Seite verzweigt wird. Zu erkennen ist die am Paramter '''tag''' in der URL der Seite.<br /> <br /> [[Datei:heading_tags_only.png|center|frame|Auswahl 'Nur bei Auszeichnungen anzeigen' im Überschrift Inhaltselement]]<br /> <br /> Dieses Feld kann in Kombination mit dem Insert Tag &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt; z.B. dazu eingesetzt werden, eine für ausgewählte Tags passende Überschrift anzuzeigen, z.B. '''Auswahl der Teilnehmer &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''' =&gt; '''Auswahl der Teilnehmer (Kongress+Oktober+Hamburg)'''<br /> === Insert Tags ===<br /> <br /> tags führt die folgenden Insert Tags für Contao ein:<br /> <br /> * '''&lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der aktuell verwendeten Auszeichnungen, z.B. '''(Contao+Erweiterung+tags)'''<br /> * '''&lt;nowiki&gt;{{tags_news::news_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Nachrichtenbeitrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_news::1}}&lt;/nowiki&gt; die Auszeichnungen des Nachrichtenbeitrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_event::event_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Kalendereintrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_event::1}}&lt;/nowiki&gt; die Auszeichnungen des Kalendereintrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_article::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article_url::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen als URL auf den zugehörigen Artikel, z.B. zeigt &lt;nowiki&gt;{{tags_article_url::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an und verlinkt jede Auszeichnung mit der Seite des Artikels. <br /> * '''&lt;nowiki&gt;{{tags_content::content_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für ein Inhaltselement vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_content::1}}&lt;/nowiki&gt; die Auszeichnungen des Inhaltselements mit der ID 1 an.<br /> <br /> === Ausgabe in Feeds ===<br /> Mit Version 1.7.2 ist auch die Ausgabe von tags zu Events (Kalendereinträgen) in Kalender-Feeds möglich, mit Version 1.7.3 die Ausgabe von tags zu Nachrichtenbeiträgen in News-Feeds. Standardmäßig werden diese Auszeichnungen als HTML-Liste nach der Beschreibung des Events bzw. des Nachrichtenbeitrags ausgegeben. Falls eine Ausgabe nicht erwünscht ist, so muss die folgende globale Variable updatesicher mit einem negativen Booleschen Wert überschrieben werden:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> $GLOBALS['tags']['showInFeeds'] = false;<br /> &lt;/source&gt;<br /> <br /> Diese Zeile fügt man dann am besten z.B. in die Datei '''&lt;nowiki&gt;system/config/localconfig.php&lt;/nowiki&gt;''' ein.<br /> Die Darstellung der Auszeichnungen im Newsfeed kann über das Template tags_feed beeinflusst werden.<br /> <br /> === Zusätzliche TPYOlight-Module ===<br /> Die tags-Erweiterung führt die folgenden neuen Contao-Module ein:<br /> <br /> ==== Globale Artikelliste ====<br /> Mit der globalen Artikelliste kann man eine Liste aller verfügbaren Artikel einer Contao-Installation ausgeben lassen. In dieser Form ist das Modul natürlich nur bedingt sinnvoll. Wenn man die Ausgabe der Artikel einschränken möchte, wählt man besser das Core-Modul Artikelliste, das eine Artikelliste einer bestimmten Seite ausgeben kann. Die globale Artikelliste sollte hauptsächlich dazu verwendet werden, um aus einer Tag Cloud heraus aufgerufen zu werden. In diesem Fall wird eine Liste aller Artikel ausgegeben, die mit der ausgewählten Auszeichnung versehen wurden.<br /> <br /> ==== Verwendete Auszeichnungen ====<br /> Dieses Modul zeigt die auf einer Seite aktuell verwendeten Auszeichnungen an. Durch Anklicken der Auszeichnungen lässt sich nach eben diesen Filtern. Alle Auszeichnungen können zurückgesetzt werden. Einzelne Auszeichnungen können durch Anklicken aus der Auswahl entfernt werden.<br /> <br /> ==== Einstellungen für Nachrichtenmodule ====<br /> Für die Nachrichtenmodule '''Nachrichtenliste''', '''Nachrichtenarchiv''' und '''Nachrichtenleser''' gibt es eine Einstellung, die verhindert, dass diese Module auf Tags reagieren ('''Auszeichnungen ignorieren'''). Falls z.B. eine Nachrichtenliste der letzten Nachrichten ausgegeben wird, so würde sich die Ausgabe ändern, wenn die Seite über eine Tag Cloud aufgerufen wird. Um dies zu verhindern, kann diese Option ausgewählt werden.<br /> <br /> [[Datei:tags_ignore.png|center|frame|Ignorieren von Auszeichnungen in den Nachrichtenmodulen]]<br /> ==== Auszeichnungsobjekte ====<br /> Mit dem Frontend-Modul Auszeichnungsobjekte kann eine Liste eines bestimmten Inhalts-Objekttyps angezeigt werden. Als '''Objekttyp''' stehen die drei Inhaltstypen ''Seiten'', ''Artikel'' oder ''Inhaltselemente'' zur Verfügung. Der Objekttyp ist das Element, das in der Liste verlinkt wird, wenn eine Auszeichnung existiert. Bei einem ausgewählten Objekttyp ''Seiten'' werden also Links auf Contao-Seiten angezeigt, bei einem Objekttyp Artikel werden Links auf Contao Artikel angezeigt etc.<br /> <br /> Die '''Einschränkung auf Datenquelle''' legt fest, welche Auszeichnungen in der Liste verarbeitet werden sollen. Wird hier z.B. tl_article gewählt, werden nur Artikelauszeichnungen berücksichtigt. Wird tl_content ausgewählt, werden nur Auszeichnungen von Inhaltselementen berücksichtigt.<br /> <br /> Über '''Seiten''' muss man die Seite auswählen, die zur Erstellung der Objektliste verwendet werden soll. Wenn die Seite Unterseiten besitzt, so werden diese ebenfalls für die Generierung der Objektliste verwendet. Das heißt, es werden nur Auszeichnungen berücksichtigt, die für Inhalts-Objekte vergeben wurden, die sich auf der ausgewählten Seite oder deren Unterseiten befinden.<br /> <br /> '''Beispiel:'''<br /> * Objekttyp: Seiten<br /> * Einschränkung auf Datenquelle: tl_article<br /> * Seiten: Startpunkt der aktuellen Website<br /> <br /> Für ausgewählte Auszeichnungen wird eine Liste von Links auf Seiten angezeigt, bei deren Artikel die Auszeichnungen vergeben wurden. Berücksichtigt werden alle Seiten der aktuellen Website.<br /> <br /> <br /> [[Datei:auszeichnungsobjekte.png|center|frame|Einstellungen des Frontendmoduls Auszeichnungsobjekte]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 23:25, 24. Nov. 2011 (CET)</div>

Hschottm https://de.contaowiki.org/Tags 2014-01-13T08:11:12Z

<p>Hschottm: </p> <hr /> <div>[[Kategorie:tags]]<br /> <br /> Auszeichnungen zum Kategorisieren von Elementen.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/tags<br /> | ExtVersion=3.2.0<br /> | Version=3.2.0 - 3.2.3<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/tags.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> | Comment=Versionen ältere Contao-Versionen verfügbar<br /> }}<br /> <br /> <br /> == Modul tags (Auszeichnungen) ==<br /> <br /> tags ist ein Contao-Modul zum Erstellen und Anzeigen von Auszeichnungen innerhalb von Contao. Mit Hilfe des Moduls lassen sich für Entwickler mit geringem Aufwand Auszeichnungen für beliebige Contao Datacontainer (Tabellen) hinzufügen. Es ist zu beachten, dass zum vollständigen Funktionieren der Erweiterung die Mootools Unterstützung im Contao Seitenlayout aktiviert sein muss.<br /> Das Modul stellt ein Eingabefeld-Widget zur Verfügung, das für den aktuellen Datacontainer, in dem es eingesetzt wird, die Auszeichnungen in der Datenbank ablegen und auslesen kann. Die Auszeichnungen werden dabei als kommagetrennte Liste von den Autoren eingegeben oder können, falls JavaScript aktiviert ist, per Mausklick hinzugefügt oder entfernt werden (dies gilt allerdings nur für bereits bestehende Auszeichnungen).<br /> <br /> [[Datei:tags_backend.png|center|frame|Eingabefeld für Auszeichnungen im Backend]]<br /> <br /> In der vorliegenden Abbildung sieht man, dass das ''title''-Attribut der URL einer Auszeichnung die Anzahl der Verwendung derselben anzeigt, d.h. neben dem Namen der Auszeichnung wird die Anzahl der Verwendungen in Klammern hinter den Namen ausgegeben. ''Mathematik (8)'' bedeutet also z.B., dass die Auszeichnung Mathematik insgesamt 8 Mal verwendet wird. <br /> <br /> Es ist zu beachten, dass pro Contao Datacontainer nur ein Eingabefeld für Auszeichnungen verwendet wird, da die Auszeichnungen immer nur für den gesamten Datacontainer vergeben werden und nicht für das zugrund liegende Eingabefeld.<br /> === Hinweise für Entwickler von eigenen Erweiterungen ===<br /> <br /> Nutzer, die Auszeichnungen nur Verwenden wollen und diese nicht in eigene Erweiterungen integrieren wollen, können den folgenden Absatz einfach [[#Verwenden_von_Auszeichnungen_im_Contao-Frontend|überspringen]].<br /> <br /> ==== Hinzufügen von Auszeichnungsfeldern in Contao Datacontainer ====<br /> <br /> Um ein Auszeichnungs-Eingabefeld in einen Contao Datacontainer einzufügen, werden die folgenden Schritte benötigt:<br /> <br /> # Um das Eingabefeld anzuzeigen, muss für den Datacontainer ein entsprechendes Datenbankfeld existieren. Da die Auszeichnungen nicht in diesem Datenbankfeld gespeichert werden, sondern in der speziell vom tags-Modul bereitgestellten Datenbanktabelle ''tl_tag'', reicht es, ein möglichst kleines Datenbankfeld zu erzeugen.<br /> # Das Eingabefeld muss in das DCA Konfigurationsarray eingefügt werden<br /> <br /> Ein neues Datenbankfeld erstellen Sie in der ''config/database.sql''-Datei des gewünschten Moduls. Ein Beispiel ist z.B.<br /> <br /> &lt;source lang=&quot;sql&quot;&gt;<br /> CREATE TABLE `tl_literature` (<br /> `tags` char(1) NOT NULL default ''<br /> ) ENGINE=MyISAM DEFAULT CHARSET=utf8;<br /> &lt;/source&gt;<br /> <br /> Um das Feld mit diesem Namen in das DCA-Konfigurationsarray zu integrieren, muss es in eine der Paletten des Konfigurationsarrays eingefügt werden und eine Felddefinition erstellt werden, also z.B.<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> '' Palettes<br /> 'palettes' =&gt; array(<br /> 'default' =&gt; 'title,author,description,tags,content'<br /> ),<br /> '' Fields<br /> 'fields' =&gt; array(<br /> 'tags' =&gt; array(<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['MSC']['tags'],<br /> 'inputType' =&gt; 'tag'<br /> )<br /> ),<br /> &lt;/source&gt;<br /> <br /> Mit ''$GLOBALS['TL_LANG']['MSC']['tags']'' stellt das tags-Modul bereits einen Standardbezeichner für ein Auszeichnungsfeld zur Verfügung. Man kann diesen natürlich jederzeit gegen eigene Spracheinträge austauschen.<br /> <br /> Beim Speichern eines Datacontainers werden während der Validierung der Daten die Auszeichnungen identifiziert und in der Datenbanktabelle ''tl_tag'' gespeichert. Abgelegt wird die ID des aktuellen Datacontainers (Tabellenfeld ''id''), der Tabellenname des Datacontainers (Tabellenfeld ''from_table'') und die Auszeichnung (Tabellenfeld ''tag'').<br /> <br /> ==== Optionen für das Evaluation-Array des Feldes ====<br /> <br /> {| border=&quot;1&quot; cellpadding=&quot;10&quot; cellspacing=&quot;0&quot; <br /> ! Schlüssel <br /> ! Wert <br /> ! Beschreibung<br /> |- style=&quot;vertical-align: top;&quot;<br /> | table || Quelltabelle ''string'' || Name der Quelltabelle, aus der die Auszeichnungen gebildet werden sollen. Der Standard ist der Name des aktuellen DCA Datencontainers. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | isTag || true/false ''boolean'' || Gibt an, ob der Inhalt des Feldes als Tag gespeichert werden soll oder nicht. Der Standard ist ''true''. Wenn der Inhalt des Feldes nicht als Tag gespeichert werden soll, wird der Feldinhalt ganz normal als kommagetrennte Zeichenkette in der Datenbank abgelegt. <br /> |- style=&quot;vertical-align: top;&quot;<br /> | maxtags || Anzahl ''integer'' || Gibt die maximale Anzahl der Auszeichnungen an, die in der Tag Cloud zum Auswählen der Auszeichnungen angegeben werden. Wenn die Anzahl der verfügbaren Auszeichnungen größer ist, als maxtags, werden die Auszeichnungen mit den wenigsten Vorkommnissen nicht mehr angezeigt. <br /> |}<br /> <br /> === Verwenden von Auszeichnungen im Contao-Frontend ===<br /> Für die Verwendung im Contao-Frontend ist das Modul ''Tag Cloud'' vorgesehen. Das Modul erstellt eine HTML-Liste der für einen oder mehrere Datacontainer verwendeten Auszeichnungen. Um die Liste als Tag Cloud darzustellen, müssen die zugehörigen CSS-Selektoren mit Stilen versehen werden. Zwei Beispieldateien ''[[tags_oxygen.css]]'' und ''[[tags_orange.css]]'' finden sich im ''tl_files/tags''-Verzeichnis des Installationspakets der tags-Erweiterung. Es empfiehlt sich an, sich an diesen Stilen zu orientieren, da es bei der Verwendung der '''Top 10 Auszeichnungen''' darauf ankommt, welche Elemente der Tag Cloud durch die CSS-Stile sichtbar gemacht werden und welche nicht.<br /> <br /> [[Datei:tagcloud_settings_1.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen deaktiviert]]<br /> <br /> Im Eingabefeld '''Maximale Anzahl von Auszeichnungen''' kann man eine maximale Anzahl der anzuzeigenden Auszeichnungen für die Tag Cloud festlegen. Ein Wert von 0 oder kein Wert zeigt immer alle verfügbaren Auszeichnungen an. Bei einem Wert kleiner als die maximale Anzahl der verfügbaren Auszeichnungen werden nur die häufigsten Auszeichnungen gemäß der Vorgabe im Eingabefeld angezeigt. Es ist zu beachten, dass es dadurch möglich ist, dass nicht alle Auszeichnungen angezeigt werden. Man sollte für die Benutzer einen Hinweis vorhalten, der auf diesen Umstand aufmerksam macht.<br /> <br /> Im Eingabefeld '''Anzahl der Auszeichnungsgrößen''' kann man die Anzahl der verfügbaren CSS Selektoren für die Tag Cloud festlegen. Der Standardwert 4 erzeugt vier unterschiedliche Gruppen von Auszeichnungen mit den Selektoren size1, size2, size3 und size4, man kann also maximal 4 unterschiedliche Größen von Auszeichnungen im Frontend ausgeben. Es ist darauf zu achten, dass man immer für alle möglichen CSS Selektoren ein CSS-Element vorhält.<br /> <br /> Das Kontrollkästchen '''Auszeichnungs-Klassennamen verwenden''' fügt einen zusätzlichen CSS Klassennamen für jede Auszeichnung hinzu, der aus dem Namen der jweiligen Auszeichnung besteht. Damit können einzelne Auszeichnungen individuell per CSS angepasst werden. Leerzeichen in den Auszeichnungsnamen werden für die CSS-Klassennamen in Unterstriche umgewandelt.<br /> <br /> Mit dem Auswahlfeld '''Tag Cloud Template''' kann man das Template bestimmen, das für die Generierung der Tag Cloud im Frontend verwendet werden soll. Standardmäßig ist dies das Template ''mod_tagcloud''. Man kann sich aber auch eigene Templates erstellen und hier verwenden. Diese müssen dann lediglich mit der Zeichenkette mod_tagcloud beginnen, also z.B. mod_tagcloud_spezial etc.<br /> <br /> Das Kontrollkästchen '''Zugehörige Auszeichnungen''' zeigt im Frontend bei Auswahl mindestens einer Auszeichnung eine Liste weitere Auszeichnungen an, die im Zusammenhang mit der ausgewählten Auszeichnung vergeben wurden. Durch einen Klick auf eine dieser zugehörigen Auszeichnungen kann die Suche nach ausgezeichneten Objekten weiter eingeschränkt werden. Natürlich funktioniert die Anzeige der zugehörigen Auszeichnungen nur dann, wenn sich das Tag Cloud Modul auf einer Seite befindet, die sich in der Weiterleitung der Tag Cloud Hyperlinks befindet, da die Tag Cloud sonst keinerlei Kenntnis von bereits ausgewählten Auszeichnungen haben kann.<br /> <br /> Das Kontrollkästchen '''Top 10 Auszeichnungen''' erzeugt über der Tag Cloud eine weitere Tag Cloud, welche die 10 häufigsten Auszeichnungen beinhaltet, in der Reihenfolge des häufigsten Auftretens. Gleichzeitig ist dieses Kontrollkästchen ein Selektor, der bei Aktivierung zwei weitere Kontrollkästchen erzeugt:<br /> <br /> * '''Top 10 Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, sind die Top 10 Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> * '''Alle Auszeichnungen sind aufgeklappt''': Wenn dieses Kontrollkästchen aktiviert ist, ist die Tag Cloud mit allen Auszeichnungen beim Öffnen der Seite aufgeklappt, d.h. die Liste der Auszeichnungen ist sichtbar.<br /> <br /> [[Datei:tagcloud_settings_1a.png|center|frame|Anzeigeeinstellungen des Tag Cloud Moduls im Backend, Top 10 Auszeichnungen aktiviert]]<br /> <br /> Man wählt unter '''Weiterleitung zu Seite''' eine interne Contao-Seite aus, damit die Auszeichnungen der Tag Cloud mit Hyperlinks versehen werden. Die gewählte Seite wird dann immer mit dem URL-Parameter ''tag=TAGNAME'' aufgerufen, also z.B. ''http://www.meineseite.de/weiterleitung.html?tag=typolight''.<br /> <br /> <br /> [[Datei:tagcloud_settings_2.png|center|frame|Tabellenspezifische Eingabefelder des Tag Cloud Moduls im Backend]]<br /> <br /> Bei '''Einschränkung auf Tabelle(n)''' wählt man normalerweise immer nur den Datacontainer aus, für den die Tags gespeichert wurden.<br /> <br /> Die Felder '''Quell-Tabelle für Auszeichnungen''' und '''Tabellenfeld für Auszeichnungen''' werden mit den Standardeinträgen ''tl_tag'' und ''tag'' vorbelegt und sollten nur dann geändert werden, wenn man die Tags aus einer eigenen Tabelle beisteuern will.<br /> <br /> Mit den Feldern '''CSS-Id/Klasse''' kann man zusätzliche CSS-ID's oder Klassen vergeben, die dann im umschließenden DIV-Container der Tag Cloud eingebettet werden. Dadurch hat man die Möglichkeit individuelle Stile für die Tag Clouds einzusetzen.<br /> <br /> Im Frontend sieht die Tag Cloud dann z.B. folgendermaßen aus:<br /> <br /> [[Datei:tagcloud_frontend.png|center|frame|Ausgabe der Tag Cloud im Frontend]]<br /> <br /> bzw. mit aktivierten Top 10 Auszeichnungen:<br /> <br /> [[Datei:tags_topten.png|center|frame|Tag Cloud mit Top 10 Auszeichnungen]]<br /> <br /> bwz. mit aktivierten Top 10 und zugehörigen Auszeichnungen:<br /> <br /> [[Datei:tags_related.png|center|frame|Tag Cloud mit Top 10 und zugehörigen Auszeichnungen]]<br /> <br /> Werden zwei Tag Clouds (Top 10 + Alle) oder die zugehörigen Auszeichnungen angezeigt, bindet Contao ein JavaScript ein, das die jeweiligen Tag Clouds bei Mausklick auf den Titel einklappt bzw. ausklappt. Ist kein JavaScript aktiviert, so werden die dreieckigen Klappsymbole nicht angezeigt. Für einen optimale Zusammenarbeit mit der JavaScript-Erweiterung sollte man die installierten CSS-Dateien tags_oxygen.css oder tags_orange.css in die Seite einbinden.<br /> <br /> Die folgenden Contao-Elemente können mit Tags versehen werden:<br /> <br /> * Nachrichtenbeiträge<br /> * Artikel<br /> * Inhaltselemente<br /> * Kalender/Events<br /> <br /> ==== Weiterleitung zu Seiten über eine Tag Cloud ====<br /> <br /> Damit eine sinnvolle Weiterleitung aus einer Tag Cloud vorgenommen werden kann, muss die Seite, zu der weitergeleitet wird, den tag-Parameter in der URL interpretieren können. Hierin liegt die Hauptarbeit, wenn die Tag-Unterstützung für bestehende Contao-Datacontainer vorgenommen werden soll.<br /> <br /> Die folgenden Contao-Module reagieren auf einen Aufruf aus einer Tag Cloud heraus und zeigen nur die Elemente an, die mit der ausgewählten Auszeichnung versehen wurden:<br /> <br /> * Modul '''Nachrichtenarchiv''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Nachrichtenliste''': Es werden alle Nachrichten angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Globale Artikelliste''': Es werden Links auf alle Artikel angezeigt, die mit der Auszeichnung versehen sind.<br /> * Modul '''Eventliste''': Es werden alle Events der ausgewählten Kalender im ausgewählten Zeitraum angezeigt, die mit der gesuchten Auszeichnung versehen sind.<br /> * Modul '''Auszeichnungsobjekte''': Es werden Inhaltselemente (Seiten, Artikel, Inhaltselemente) in einer Liste angezeigt, die mit einer bestimmten Auszeichnung versehen sind.<br /> <br /> ==== Ausgabe von Auszeichnungslisten zu Nachrichtenbeiträgen ====<br /> <br /> Bei der Ausgabe von Nachrichtenbeiträgen gibt es die Möglichkeit, unterhalb des Nachrichtenbeitrags die zum Beitrag zugehörigen Auszeichnungen anzeigen zu lassen. Zu diesem Zweck kann die Ausgabe der Auszeichnungen in den Frontend-Modulen zur Nachrichtenanzeige, '''Nachrichtenleser''', '''Nachrichtenliste''' und '''Nachrichtenarchiv''', aktiviert werden.<br /> <br /> [[Datei:tags_tag_settings.png|center|frame|Aktivierung einer Auszeichnungsliste im Modul des Contao Backends]]<br /> <br /> Mit der Option '''Auszeichnungen ignorieren''' werden von der Liste alle zur Filterung verwendeten Auszeichnungen verworfen.<br /> <br /> Wenn man die Option '''Nachrichten-Auszeichnungen anzeigen''' auswählt, erscheint zusätzlich ein Auswahl-Feld für eine Weiterleitungsseite, die aufgerufen wird, wenn aus eine der Auszeichnungen geklickt wird. Hier wählt man die Seite aus, auf die man auch aus der Tag Cloud heraus weiterleitet oder aber natürlich jede beliebige andere Seite, wenn man eine spezielle Behandlung der zu einer Nachrichten angeklickten Auszeichnungen wünscht.<br /> <br /> Um, wie bei den Tag Clouds die Namen der individuellen CSS-Klassen der jeweiligen Auszeichnungen anzuzeigen, wurde die Option &quot;Auszeichnungs-Klassennamen verwenden&quot; eingeführt. Diese verwendet die individuelle CSS-Klasse in allen Auszeichnungen, die unterhalb eines Nachrichtenbeitrags angezeigt werden.<br /> <br /> Damit eine Ausgabe der Auszeichnungen im Frontend auch wirklich ausgeführt wird, muss man außerdem die '''Nachrichtenvorlage''' des Moduls anpassen. Speziell für diesen Zweck wurde mit der tags-Erweiterung das Template ''news_full_tags'' erstellt, das den entsprechenden HTML-Code zur Ausgabe der Auszeichnungen unterhalb eines Nachrichtenbeitrags bereitstellt. Wenn man ein anderes Template für die Ausgabe verwenden will und die Ausgabe der Auszeichnungen zu einem Nachrichtenbeitrag wünscht, sollte man den im Template news_full_tags hinzugekommenen Quellcode kopieren und in das gewünschte Template einfügen:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> &lt;?php if ($this-&gt;showTags): ?&gt;<br /> <br /> &lt;?php if (count($this-&gt;taglist)): ?&gt;<br /> &lt;ul class=&quot;tag-chain&quot;&gt;<br /> &lt;?php $counter = 0; foreach ($this-&gt;taglist as $tag): ?&gt;<br /> &lt;li class=&quot;tag-chain-item&lt;?php if ($counter == 0) echo ' first'; ?&gt;<br /> &lt;?php if ($counter == count($this-&gt;taglist)-1) echo ' last'; ?&gt;<br /> &lt;?php if ($this-&gt;showTagClass) echo ' ' . $tag['class']; ?&gt;&quot;&gt;&lt;?php echo $tag['url']; ?&gt;&lt;/li&gt;<br /> &lt;?php $counter++; endforeach; ?&gt;<br /> &lt;/ul&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;?php endif; ?&gt;<br /> &lt;/source&gt;<br /> <br /> Für die Ausgabe der Auszeichnungen enthalten die in der Erweiterung mitgelieferten CSS-Dateien tags_orange.css und tags_oxygen.css weitere CSS-Selektoren, die für eine grundlegende Formatierung der Auszeichnungslisten sorgen.<br /> Ein Nachrichtenbeitrag mit den dazugehörigen Auszeichnungen könnte dann z.B. folgendermaßen aussehen:<br /> <br /> [[Datei:auszeichnungsliste.png|center|frame|Darstellung einer Nachricht mit zugehörigen Auszeichnungen]]<br /> <br /> === Inhaltselemente ===<br /> Die tags-Erweiterung erweitert des Contao Inhaltselement '''Überschrift''' und fügt in den Experten-Einstellungen einen zusätzlichen Parameter '''Nur bei Auszeichnungen anzeigen''' ein. Wird dieses Feld ausgewählt, dann zeigt Contao die Überschrift nur dann an, wenn auf der betreffenden Seite Auszeichnungen verwendet werden, d.h. wenn von einer Tag Cloud über eine Auszeichnung auf die Seite verzweigt wird. Zu erkennen ist die am Paramter '''tag''' in der URL der Seite.<br /> <br /> [[Datei:heading_tags_only.png|center|frame|Auswahl 'Nur bei Auszeichnungen anzeigen' im Überschrift Inhaltselement]]<br /> <br /> Dieses Feld kann in Kombination mit dem Insert Tag &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt; z.B. dazu eingesetzt werden, eine für ausgewählte Tags passende Überschrift anzuzeigen, z.B. '''Auswahl der Teilnehmer &lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''' =&gt; '''Auswahl der Teilnehmer (Kongress+Oktober+Hamburg)'''<br /> === Insert Tags ===<br /> <br /> tags führt die folgenden Insert Tags für Contao ein:<br /> <br /> * '''&lt;nowiki&gt;{{tags_used}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der aktuell verwendeten Auszeichnungen, z.B. '''(Contao+Erweiterung+tags)'''<br /> * '''&lt;nowiki&gt;{{tags_news::news_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Nachrichtenbeitrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_news::1}}&lt;/nowiki&gt; die Auszeichnungen des Nachrichtenbeitrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_event::event_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Kalendereintrag vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_event::1}}&lt;/nowiki&gt; die Auszeichnungen des Kalendereintrags mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_article::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an. <br /> * '''&lt;nowiki&gt;{{tags_article_url::article_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für einen Artikel vergebenen Auszeichnungen als URL auf den zugehörigen Artikel, z.B. zeigt &lt;nowiki&gt;{{tags_article_url::1}}&lt;/nowiki&gt; die Auszeichnungen des Artikels mit der ID 1 an und verlinkt jede Auszeichnung mit der Seite des Artikels. <br /> * '''&lt;nowiki&gt;{{tags_content::content_id}}&lt;/nowiki&gt;''': Wird ersetzt durch eine Liste der für ein Inhaltselement vergebenen Auszeichnungen, z.B. zeigt &lt;nowiki&gt;{{tags_content::1}}&lt;/nowiki&gt; die Auszeichnungen des Inhaltselements mit der ID 1 an.<br /> <br /> === Ausgabe in Feeds ===<br /> Mit Version 1.7.2 ist auch die Ausgabe von tags zu Events (Kalendereinträgen) in Kalender-Feeds möglich, mit Version 1.7.3 die Ausgabe von tags zu Nachrichtenbeiträgen in News-Feeds. Standardmäßig werden diese Auszeichnungen als HTML-Liste nach der Beschreibung des Events bzw. des Nachrichtenbeitrags ausgegeben. Falls eine Ausgabe nicht erwünscht ist, so muss die folgende globale Variable updatesicher mit einem negativen Booleschen Wert überschrieben werden:<br /> <br /> &lt;source lang=&quot;php&quot;&gt;<br /> $GLOBALS['tags']['showInFeeds'] = false;<br /> &lt;/source&gt;<br /> <br /> Diese Zeile fügt man dann am besten z.B. in die Datei '''&lt;nowiki&gt;system/config/localconfig.php&lt;/nowiki&gt;''' ein.<br /> Die Darstellung der Auszeichnungen im Newsfeed kann über das Template tags_feed beeinflusst werden.<br /> <br /> === Zusätzliche TPYOlight-Module ===<br /> Die tags-Erweiterung führt die folgenden neuen Contao-Module ein:<br /> <br /> ==== Globale Artikelliste ====<br /> Mit der globalen Artikelliste kann man eine Liste aller verfügbaren Artikel einer Contao-Installation ausgeben lassen. In dieser Form ist das Modul natürlich nur bedingt sinnvoll. Wenn man die Ausgabe der Artikel einschränken möchte, wählt man besser das Core-Modul Artikelliste, das eine Artikelliste einer bestimmten Seite ausgeben kann. Die globale Artikelliste sollte hauptsächlich dazu verwendet werden, um aus einer Tag Cloud heraus aufgerufen zu werden. In diesem Fall wird eine Liste aller Artikel ausgegeben, die mit der ausgewählten Auszeichnung versehen wurden.<br /> <br /> ==== Verwendete Auszeichnungen ====<br /> Dieses Modul zeigt die auf einer Seite aktuell verwendeten Auszeichnungen an. Durch Anklicken der Auszeichnungen lässt sich nach eben diesen Filtern. Alle Auszeichnungen können zurückgesetzt werden. Einzelne Auszeichnungen können durch Anklicken aus der Auswahl entfernt werden.<br /> <br /> ==== Einstellungen für Nachrichtenmodule ====<br /> Für die Nachrichtenmodule '''Nachrichtenliste''', '''Nachrichtenarchiv''' und '''Nachrichtenleser''' gibt es eine Einstellung, die verhindert, dass diese Module auf Tags reagieren ('''Auszeichnungen ignorieren'''). Falls z.B. eine Nachrichtenliste der letzten Nachrichten ausgegeben wird, so würde sich die Ausgabe ändern, wenn die Seite über eine Tag Cloud aufgerufen wird. Um dies zu verhindern, kann diese Option ausgewählt werden.<br /> <br /> [[Datei:tags_ignore.png|center|frame|Ignorieren von Auszeichnungen in den Nachrichtenmodulen]]<br /> ==== Auszeichnungsobjekte ====<br /> Mit dem Frontend-Modul Auszeichnungsobjekte kann eine Liste eines bestimmten Inhalts-Objekttyps angezeigt werden. Als '''Objekttyp''' stehen die drei Inhaltstypen ''Seiten'', ''Artikel'' oder ''Inhaltselemente'' zur Verfügung. Der Objekttyp ist das Element, das in der Liste verlinkt wird, wenn eine Auszeichnung existiert. Bei einem ausgewählten Objekttyp ''Seiten'' werden also Links auf Contao-Seiten angezeigt, bei einem Objekttyp Artikel werden Links auf Contao Artikel angezeigt etc.<br /> <br /> Die '''Einschränkung auf Datenquelle''' legt fest, welche Auszeichnungen in der Liste verarbeitet werden sollen. Wird hier z.B. tl_article gewählt, werden nur Artikelauszeichnungen berücksichtigt. Wird tl_content ausgewählt, werden nur Auszeichnungen von Inhaltselementen berücksichtigt.<br /> <br /> Über '''Seiten''' muss man die Seite auswählen, die zur Erstellung der Objektliste verwendet werden soll. Wenn die Seite Unterseiten besitzt, so werden diese ebenfalls für die Generierung der Objektliste verwendet. Das heißt, es werden nur Auszeichnungen berücksichtigt, die für Inhalts-Objekte vergeben wurden, die sich auf der ausgewählten Seite oder deren Unterseiten befinden.<br /> <br /> '''Beispiel:'''<br /> * Objekttyp: Seiten<br /> * Einschränkung auf Datenquelle: tl_article<br /> * Seiten: Startpunkt der aktuellen Website<br /> <br /> Für ausgewählte Auszeichnungen wird eine Liste von Links auf Seiten angezeigt, bei deren Artikel die Auszeichnungen vergeben wurden. Berücksichtigt werden alle Seiten der aktuellen Website.<br /> <br /> <br /> [[Datei:auszeichnungsobjekte.png|center|frame|Einstellungen des Frontendmoduls Auszeichnungsobjekte]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 23:25, 24. Nov. 2011 (CET)</div>

Hschottm https://de.contaowiki.org/Datei:Hschottm.jpg 2013-04-18T09:40:13Z

<p>Hschottm: hat eine neue Version von „Datei:Hschottm.jpg“ hochgeladen</p> <hr /> <div>Helmut Schottmüller</div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:29:16Z

<p>Hschottm: /* BibTeX-Import */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> * '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> * '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|Identifikation für Literaturverweise|center|frame]]<br /> <br /> * '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> * '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> '''Ein Bild hinzufügen''': Fügen Sie ein Bild, z.B. mit dem Buchcover, oder dem Cover der Zeitschrift hinzu.<br /> <br /> [[Datei:literature_image.png|Bild-Einstellungen|center|frame]]<br /> <br /> <br /> '''Downloads hinzufügen''': Fügen Sie Downloads, z.B. die PDF-Version des Literaturverweises hinzu.<br /> <br /> [[Datei:literature_downloads.png|Download-Einstellungen|center|frame]]<br /> <br /> '''Inhaltsangabe''': Geben Sie eine Inhaltsangabe oder kurze Zusammenfassung des Literaturverweises an.<br /> <br /> [[Datei:literature_summary.png|Inhaltsangabe|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> === Frontend-Modul Literatursuche ===<br /> Mit dem Frontend-Modul Literatursuche kann man eine Literaturliste im Contao-Frontend nach einem Suchbegriff filtern. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literatursuche an.<br /> <br /> Die folgenden Felder kann man für eine Literatursuche bearbeiten:<br /> <br /> * '''Weiterleitungsseite''': Sollte auf die Seite verweisen, auf der das Modul 'Literaturliste' eingebunden ist. Falls sich beide Module auf der gleichen Seite befinden, muss keine Weiterleitungsseite angegeben werden.<br /> <br /> [[Datei:literature_search.png|Einstellungen für das Literatursuche-Modul|center|frame]]<br /> <br /> Im Frontend präsentiert sich die Literatursuche dann mit einem einfachen Suchfeld und der Möglichkeit, nach einem bestimmten Feld der Literatureinträge zu suchen. Um einen bestehenden Suchfilter zu löschen, einfach den Suchbegriff entfernen und die Suche nochmals ausführen.<br /> Angeboten wird die Suche nach Titel, Autoren, Titel der Zeitschrift, Ort, Verlag und Erscheinungsdatum. Die Suche wird nicht kontextsentitiv durchgeführt und es wird auch nach Teilbegriffen gesucht. 'furt' findet also z.B. 'Frankfurt', 'Furtwängler', etc.<br /> <br /> [[Datei:literature_search_frontend.png|Ausgabe der Literatursuche im Frontend|center|frame]]<br /> <br /> === BibTeX-Import ===<br /> <br /> Innerhalb von Kategorien ist Literature in der Lage, BibTeX-Dateien zu importieren. Über die Schaltfläche 'Importieren' innerhalb einer Literaturkategorie wird ein Assistent gestartet, der BibTeX-Dateien aus dem Contao-Dateiverzeichnis auswählen und importieren kann.<br /> <br /> [[Datei:literature_bibtex.png|BibTeX-Import in einer Literaturkategorie des Backends|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 11:12, 18. Apr. 2013 (CEST)</div>

Hschottm https://de.contaowiki.org/Datei:Literature_bibtex.png 2013-04-18T09:28:22Z

<p>Hschottm: </p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:28:06Z

<p>Hschottm: /* BibTeX-Import */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> * '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> * '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|Identifikation für Literaturverweise|center|frame]]<br /> <br /> * '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> * '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> '''Ein Bild hinzufügen''': Fügen Sie ein Bild, z.B. mit dem Buchcover, oder dem Cover der Zeitschrift hinzu.<br /> <br /> [[Datei:literature_image.png|Bild-Einstellungen|center|frame]]<br /> <br /> <br /> '''Downloads hinzufügen''': Fügen Sie Downloads, z.B. die PDF-Version des Literaturverweises hinzu.<br /> <br /> [[Datei:literature_downloads.png|Download-Einstellungen|center|frame]]<br /> <br /> '''Inhaltsangabe''': Geben Sie eine Inhaltsangabe oder kurze Zusammenfassung des Literaturverweises an.<br /> <br /> [[Datei:literature_summary.png|Inhaltsangabe|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> === Frontend-Modul Literatursuche ===<br /> Mit dem Frontend-Modul Literatursuche kann man eine Literaturliste im Contao-Frontend nach einem Suchbegriff filtern. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literatursuche an.<br /> <br /> Die folgenden Felder kann man für eine Literatursuche bearbeiten:<br /> <br /> * '''Weiterleitungsseite''': Sollte auf die Seite verweisen, auf der das Modul 'Literaturliste' eingebunden ist. Falls sich beide Module auf der gleichen Seite befinden, muss keine Weiterleitungsseite angegeben werden.<br /> <br /> [[Datei:literature_search.png|Einstellungen für das Literatursuche-Modul|center|frame]]<br /> <br /> Im Frontend präsentiert sich die Literatursuche dann mit einem einfachen Suchfeld und der Möglichkeit, nach einem bestimmten Feld der Literatureinträge zu suchen. Um einen bestehenden Suchfilter zu löschen, einfach den Suchbegriff entfernen und die Suche nochmals ausführen.<br /> Angeboten wird die Suche nach Titel, Autoren, Titel der Zeitschrift, Ort, Verlag und Erscheinungsdatum. Die Suche wird nicht kontextsentitiv durchgeführt und es wird auch nach Teilbegriffen gesucht. 'furt' findet also z.B. 'Frankfurt', 'Furtwängler', etc.<br /> <br /> [[Datei:literature_search_frontend.png|Ausgabe der Literatursuche im Frontend|center|frame]]<br /> <br /> === BibTeX-Import ===<br /> <br /> Innerhalb von Kategorien ist Literature in der Lage, BibTeX-Dateien zu importieren. Über die Schaltfläche 'Importieren' innerhalb einer Literaturkategorie wird ein Assistent gestartet, der BibTeX-Dateien aus dem Contao-Dateiverzeichnis auswählen und importieren kann.<br /> <br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 11:12, 18. Apr. 2013 (CEST)</div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:25:11Z

<p>Hschottm: /* Frontend-Modul Literatursuche */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> * '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> * '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|Identifikation für Literaturverweise|center|frame]]<br /> <br /> * '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> * '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> '''Ein Bild hinzufügen''': Fügen Sie ein Bild, z.B. mit dem Buchcover, oder dem Cover der Zeitschrift hinzu.<br /> <br /> [[Datei:literature_image.png|Bild-Einstellungen|center|frame]]<br /> <br /> <br /> '''Downloads hinzufügen''': Fügen Sie Downloads, z.B. die PDF-Version des Literaturverweises hinzu.<br /> <br /> [[Datei:literature_downloads.png|Download-Einstellungen|center|frame]]<br /> <br /> '''Inhaltsangabe''': Geben Sie eine Inhaltsangabe oder kurze Zusammenfassung des Literaturverweises an.<br /> <br /> [[Datei:literature_summary.png|Inhaltsangabe|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> === Frontend-Modul Literatursuche ===<br /> Mit dem Frontend-Modul Literatursuche kann man eine Literaturliste im Contao-Frontend nach einem Suchbegriff filtern. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literatursuche an.<br /> <br /> Die folgenden Felder kann man für eine Literatursuche bearbeiten:<br /> <br /> * '''Weiterleitungsseite''': Sollte auf die Seite verweisen, auf der das Modul 'Literaturliste' eingebunden ist. Falls sich beide Module auf der gleichen Seite befinden, muss keine Weiterleitungsseite angegeben werden.<br /> <br /> [[Datei:literature_search.png|Einstellungen für das Literatursuche-Modul|center|frame]]<br /> <br /> Im Frontend präsentiert sich die Literatursuche dann mit einem einfachen Suchfeld und der Möglichkeit, nach einem bestimmten Feld der Literatureinträge zu suchen. Um einen bestehenden Suchfilter zu löschen, einfach den Suchbegriff entfernen und die Suche nochmals ausführen.<br /> Angeboten wird die Suche nach Titel, Autoren, Titel der Zeitschrift, Ort, Verlag und Erscheinungsdatum. Die Suche wird nicht kontextsentitiv durchgeführt und es wird auch nach Teilbegriffen gesucht. 'furt' findet also z.B. 'Frankfurt', 'Furtwängler', etc.<br /> <br /> [[Datei:literature_search_frontend.png|Ausgabe der Literatursuche im Frontend|center|frame]]<br /> <br /> === BibTeX-Import ===<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 11:12, 18. Apr. 2013 (CEST)</div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:23:31Z

<p>Hschottm: /* Frontend-Modul Literatursuche */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> * '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> * '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|Identifikation für Literaturverweise|center|frame]]<br /> <br /> * '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> * '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> '''Ein Bild hinzufügen''': Fügen Sie ein Bild, z.B. mit dem Buchcover, oder dem Cover der Zeitschrift hinzu.<br /> <br /> [[Datei:literature_image.png|Bild-Einstellungen|center|frame]]<br /> <br /> <br /> '''Downloads hinzufügen''': Fügen Sie Downloads, z.B. die PDF-Version des Literaturverweises hinzu.<br /> <br /> [[Datei:literature_downloads.png|Download-Einstellungen|center|frame]]<br /> <br /> '''Inhaltsangabe''': Geben Sie eine Inhaltsangabe oder kurze Zusammenfassung des Literaturverweises an.<br /> <br /> [[Datei:literature_summary.png|Inhaltsangabe|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> === Frontend-Modul Literatursuche ===<br /> Mit dem Frontend-Modul Literatursuche kann man eine Literaturliste im Contao-Frontend nach einem Suchbegriff filtern. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literatursuche an.<br /> <br /> Die folgenden Felder kann man für eine Literatursuche bearbeiten:<br /> <br /> * '''Weiterleitungsseite''': Sollte auf die Seite verweisen, auf der das Modul 'Literaturliste' eingebunden ist. Falls sich beide Module auf der gleichen Seite befinden, muss keine Weiterleitungsseite angegeben werden.<br /> <br /> [[Datei:literature_search.png|Einstellungen für das Literatursuche-Modul|center|frame]]<br /> <br /> Im Frontend präsentiert sich die Literatursuche dann mit einem einfachen Suchfeld und der Möglichkeit, nach einem bestimmten Feld der Literatureinträge zu suchen. Um einen bestehenden Suchfilter zu löschen, einfach den Suchbegriff entfernen und die Suche nochmals ausführen.<br /> Angeboten wird die Suche nach Titel, Autoren, Titel der Zeitschrift, Ort, Verlag und Erscheinungsdatum. Die Suche wird nicht kontextsentitiv durchgeführt und es wird auch nach Teilbegriffen gesucht. 'furt' findet also z.B. 'Frankfurt', 'Furtwängler', etc.<br /> <br /> [[Datei:literature_search_frontend.png|Ausgabe der Literatursuche im Frontend|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 11:12, 18. Apr. 2013 (CEST)</div>

Hschottm https://de.contaowiki.org/Datei:Literature_search_frontend.png 2013-04-18T09:20:53Z

<p>Hschottm: </p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:18:06Z

<p>Hschottm: /* Frontend-Modul Literatursuche */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> * '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> * '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|Identifikation für Literaturverweise|center|frame]]<br /> <br /> * '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> * '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> '''Ein Bild hinzufügen''': Fügen Sie ein Bild, z.B. mit dem Buchcover, oder dem Cover der Zeitschrift hinzu.<br /> <br /> [[Datei:literature_image.png|Bild-Einstellungen|center|frame]]<br /> <br /> <br /> '''Downloads hinzufügen''': Fügen Sie Downloads, z.B. die PDF-Version des Literaturverweises hinzu.<br /> <br /> [[Datei:literature_downloads.png|Download-Einstellungen|center|frame]]<br /> <br /> '''Inhaltsangabe''': Geben Sie eine Inhaltsangabe oder kurze Zusammenfassung des Literaturverweises an.<br /> <br /> [[Datei:literature_summary.png|Inhaltsangabe|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> === Frontend-Modul Literatursuche ===<br /> Mit dem Frontend-Modul Literatursuche kann man eine Literaturliste im Contao-Frontend nach einem Suchbegriff filtern. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literatursuche an.<br /> <br /> Die folgenden Felder kann man für eine Literatursuche bearbeiten:<br /> <br /> * '''Weiterleitungsseite''': Sollte auf die Seite verweisen, auf der das Modul 'Literaturliste' eingebunden ist. Falls sich beide Module auf der gleichen Seite befinden, muss keine Weiterleitungsseite angegeben werden.<br /> <br /> [[Datei:literature_search.png|Einstellungen für das Literatursuche-Modul|center|frame]]<br /> <br /> Im Frontend präsentiert sich die Literatursuche dann mit einem einfachen Suchfeld und der Möglichkeit, nach einem bestimmten Feld der Literatureinträge zu suchen. Um einen bestehenden Suchfilter zu löschen, einfach den Suchbegriff entfernen und die Suche nochmals ausführen.<br /> <br /> [[Datei:literature_search_frontend.png|Ausgabe der Literatursuche im Frontend|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 11:12, 18. Apr. 2013 (CEST)</div>

Hschottm https://de.contaowiki.org/Datei:Literature_search.png 2013-04-18T09:15:03Z

<p>Hschottm: </p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:13:47Z

<p>Hschottm: /* Frontend-Modul Literaturliste */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> * '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> * '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|Identifikation für Literaturverweise|center|frame]]<br /> <br /> * '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> * '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> '''Ein Bild hinzufügen''': Fügen Sie ein Bild, z.B. mit dem Buchcover, oder dem Cover der Zeitschrift hinzu.<br /> <br /> [[Datei:literature_image.png|Bild-Einstellungen|center|frame]]<br /> <br /> <br /> '''Downloads hinzufügen''': Fügen Sie Downloads, z.B. die PDF-Version des Literaturverweises hinzu.<br /> <br /> [[Datei:literature_downloads.png|Download-Einstellungen|center|frame]]<br /> <br /> '''Inhaltsangabe''': Geben Sie eine Inhaltsangabe oder kurze Zusammenfassung des Literaturverweises an.<br /> <br /> [[Datei:literature_summary.png|Inhaltsangabe|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> === Frontend-Modul Literatursuche ===<br /> Mit dem Frontend-Modul Literatursuche kann man eine Literaturliste im Contao-Frontend nach einem Suchbegriff filtern. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literatursuche an.<br /> <br /> Die folgenden Felder kann man für eine Literatursuche bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 11:12, 18. Apr. 2013 (CEST)</div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:12:24Z

<p>Hschottm: </p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> * '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> * '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|Identifikation für Literaturverweise|center|frame]]<br /> <br /> * '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> * '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> '''Ein Bild hinzufügen''': Fügen Sie ein Bild, z.B. mit dem Buchcover, oder dem Cover der Zeitschrift hinzu.<br /> <br /> [[Datei:literature_image.png|Bild-Einstellungen|center|frame]]<br /> <br /> <br /> '''Downloads hinzufügen''': Fügen Sie Downloads, z.B. die PDF-Version des Literaturverweises hinzu.<br /> <br /> [[Datei:literature_downloads.png|Download-Einstellungen|center|frame]]<br /> <br /> '''Inhaltsangabe''': Geben Sie eine Inhaltsangabe oder kurze Zusammenfassung des Literaturverweises an.<br /> <br /> [[Datei:literature_summary.png|Inhaltsangabe|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 11:12, 18. Apr. 2013 (CEST)</div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:10:23Z

<p>Hschottm: /* Gemeinsame Felder für alle Literaturtypen */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> * '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> * '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|Identifikation für Literaturverweise|center|frame]]<br /> <br /> * '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> * '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> '''Ein Bild hinzufügen''': Fügen Sie ein Bild, z.B. mit dem Buchcover, oder dem Cover der Zeitschrift hinzu.<br /> <br /> [[Datei:literature_image.png|Bild-Einstellungen|center|frame]]<br /> <br /> <br /> '''Downloads hinzufügen''': Fügen Sie Downloads, z.B. die PDF-Version des Literaturverweises hinzu.<br /> <br /> [[Datei:literature_downloads.png|Download-Einstellungen|center|frame]]<br /> <br /> '''Inhaltsangabe''': Geben Sie eine Inhaltsangabe oder kurze Zusammenfassung des Literaturverweises an.<br /> <br /> [[Datei:literature_summary.png|Inhaltsangabe|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:07, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Datei:Literature_summary.png 2013-04-18T09:09:25Z

<p>Hschottm: </p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:08:29Z

<p>Hschottm: /* Gemeinsame Felder für alle Literaturtypen */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> * '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> * '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|Identifikation für Literaturverweise|center|frame]]<br /> <br /> * '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> * '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> '''Ein Bild hinzufügen''': Fügen Sie ein Bild, z.B. mit dem Buchcover, oder dem Cover der Zeitschrift hinzu.<br /> <br /> [[Datei:literature_image.png|Bild-Einstellungen|center|frame]]<br /> <br /> <br /> '''Downloads hinzufügen''': Fügen Sie Downloads, z.B. die PDF-Version des Literaturverweises hinzu.<br /> <br /> [[Datei:literature_downloads.png|Download-Einstellungen|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:07, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Datei:Literature_downloads.png 2013-04-18T09:06:08Z

<p>Hschottm: </p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Datei:Literature_image.png 2013-04-18T09:05:44Z

<p>Hschottm: </p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:04:55Z

<p>Hschottm: /* Gemeinsame Felder für alle Literaturtypen */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> * '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> * '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|Identifikation für Literaturverweise|center|frame]]<br /> <br /> * '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> * '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:07, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:04:13Z

<p>Hschottm: /* Gemeinsame Felder für alle Literaturtypen */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> * '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> * '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|ISBN-Eingabe für Literaturverweise|center|frame]]<br /> <br /> * '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> * '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:07, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Datei:Literature_url.png 2013-04-18T09:03:54Z

<p>Hschottm: hat eine neue Version von „Datei:Literature url.png“ hochgeladen</p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:03:02Z

<p>Hschottm: /* Gemeinsame Felder für alle Literaturtypen */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> * '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> * '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|ISBN-Eingabe für Literaturverweise|center|frame]]<br /> <br /> '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:07, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T09:02:38Z

<p>Hschottm: /* Gemeinsame Felder für alle Literaturtypen */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> '''ISSN''': Man gibt eine ISSN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISSN-Nummer auf Korrektheit.<br /> <br /> [[Datei:literature_isbn.png|ISBN-Eingabe für Literaturverweise|center|frame]]<br /> <br /> '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:07, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Datei:Literature_isbn.png 2013-04-18T09:01:52Z

<p>Hschottm: hat eine neue Version von „Datei:Literature isbn.png“ hochgeladen</p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Datei:Literature_tags.png 2013-04-18T09:00:23Z

<p>Hschottm: hat eine neue Version von „Datei:Literature tags.png“ hochgeladen</p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Datei:Literature_nonperiodic_part.png 2013-04-18T08:58:57Z

<p>Hschottm: hat eine neue Version von „Datei:Literature nonperiodic part.png“ hochgeladen</p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Datei:Literature_nonperiodic.png 2013-04-18T08:57:56Z

<p>Hschottm: </p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T08:57:41Z

<p>Hschottm: /* Nicht-periodisch erscheinende Werke */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> <br /> [[Datei:literature_isbn.png|ISBN-Eingabe für Literaturverweise|center|frame]]<br /> <br /> '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:07, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Datei:Literature_periodic.png 2013-04-18T08:55:40Z

<p>Hschottm: hat eine neue Version von „Datei:Literature periodic.png“ hochgeladen</p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T08:37:35Z

<p>Hschottm: </p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | TrackerLink=https://github.com/hschottm/literature/issues<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_periodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> <br /> [[Datei:literature_isbn.png|ISBN-Eingabe für Literaturverweise|center|frame]]<br /> <br /> '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:07, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T08:34:56Z

<p>Hschottm: </p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=https://github.com/hschottm/literature<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_periodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> <br /> [[Datei:literature_isbn.png|ISBN-Eingabe für Literaturverweise|center|frame]]<br /> <br /> '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:07, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Literature 2013-04-18T08:34:27Z

<p>Hschottm: </p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erfassen von Literaturverweisen und Listenausgabe der Literaturverweise.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=http://www.aurealis.de<br /> | ExtVersion=1.4.1<br /> | Version=2.10.0 - 2.11.11<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/literature.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == literature (Literaturverwaltung) ==<br /> Die '''literature'''-Erweiterung dient zum Erfassen von Literaturverweisen im Contao-Backend. Es können beliebige Kategorien angelegt werden, in denen periodisch erscheinende Zeitschriften etc., nicht-periodisch erscheinende Werke oder Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) angelegt werden können. Um nicht auf eine bestimmte Kategorie festgelegt zu sein, gibt es die Möglichkeit, jeden Literaturverweis mit beliebigen Auszeichnungen (Tags) zu versehen und damit ausgiebiger zu Kategorisieren.<br /> <br /> Die so angelegten Literatureinträge können dann im Frontend als Listen ausgegeben werden.<br /> <br /> === Backend-Modul Literaturverwaltung ===<br /> <br /> Nach der Installation der Erweiterung findet man im Contao-Backend ein neues Backend-Modul '''Literaturverwaltung''', das sich in der Kategorie '''Inhalte''' befindet.<br /> <br /> [[Datei:literature_backend_modul.png|Backend-Modul Literaturverwaltung im Contao-Backend|center|frame]]<br /> <br /> Innerhalb der Literaturverwaltung können dann beliebige Kategorien angelegt werden, die die Literaturverweise aufnehmen.<br /> <br /> [[Datei:literature_categories.png|Kategorien innerhalb der Literaturverwaltung|center|frame]]<br /> <br /> Eine Kategorie besteht lediglich aus einem Namen und einer optionalen Beschreibung. Um einen Literaturverweis anzulegen, wechselt man in eine Kategorie und wählt ''Neuer Literaturverweis'' aus. Abhängig vom ausgewählten Literaturtyp stehen dann die jeweiligen Eingabefelder für diesen Literaturtyp zur Verfügung.<br /> <br /> [[Datei:literature_types.png|Auswahl der Literaturtypen beim Anlegen eines Literaturverweises|center|frame]]<br /> <br /> ==== Periodisch erscheinende Zeitschriften etc. ====<br /> <br /> Mit den '''Autoren'''-Eingabefeldern kann man die Namen der Autoren und Autorinnen erfassen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne das die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Autoren über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Autoren verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> <br /> [[Datei:literature_authors.png|Autorenfelder eines Literatureintrags|center|frame]]<br /> <br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Artikels oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Titel der Zeitschrift''': Man gibt den Namen der Fachzeitschrift ein<br /> * '''Band''': Man gibt die Bandangabe der Fachzeitschrift ein<br /> * '''Heftnummer''': Man gibt die Heftnummer der Fachzeitschrift ein<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Artikels in der Fachzeitschrift an. Die Abkürzung S. für Seite oder Seiten sollte nur bei Zeitungen angegeben werden, bei Fachzeitschriften aber entfallen<br /> <br /> [[Datei:literature_periodic.png|Datenfelder periodisch erscheinender Zeitschriften etc.|center|frame]]<br /> <br /> ==== Nicht-periodisch erscheinende Werke ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_periodic.png|Datenfelder nicht-periodisch erscheinender Werke|center|frame]]<br /> <br /> ==== Teile eines nicht-periodisch erscheinenden Werkes (z.B. Buchkapitel) ====<br /> <br /> * '''Autoren''': Siehe '''Periodisch erscheinende Zeitschriften'''<br /> * '''Erscheinungsdatum''': Man gibt das Erscheinungsdatum (in der Regel das Erscheinungsjahr) des Werkes ein<br /> * '''Titel''': Man gibt den Titel des Kapitels oder Artikels ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben, wie z.B. die Auflage<br /> * '''Herausgeber''': Hier erfasst man die Namen der Herausgeber und Herausgeberinnen. Bei aktiviertem JavaScript kann man Felder hinzufügen oder verschieben, ohne dass die aktuelle Seite neu geladen wird. Man hat die Möglichkeit, die Reihenfolge der Herausgeber über die Pfeiltasten neben den Eingabefeldern festzulegen. Ob man die Vornamen der Herausgeber verwendet, abkürzt oder voll ausschreibt bleibt jedem selbst überlassen.<br /> * '''Titel des Werkes''': Man gibt den Titel des Buches oder Werkes ein<br /> * '''Zusatzinformationen''': Hier kann man Zusatzinformationen, die nicht Bestandteil des Titels sind eingeben<br /> * '''Übers./Medien''': Man gibt eine Übersetzung des Titels oder elektronische Medien, wie z.B. CD-ROM an<br /> * '''Seitenangabe''': Man gibt die Seitenangabe des Kapitels im Buch an<br /> * '''Ort''': Man gibt den Erscheinungsort des Werkes an<br /> * '''Verlag''': Man gibt den Verleger des Werkes an<br /> <br /> [[Datei:literature_nonperiodic_part.png|Datenfelder für Teile eines nicht-periodisch erscheinenden Werkes|center|frame]]<br /> <br /> ==== Gemeinsame Felder für alle Literaturtypen ====<br /> <br /> Bei Auszeichnungen kann man eine kommagetrennte Liste von beliebigen Auszeichnungen für den Literatureintrag vergeben. Damit hat man die Möglichkeit, mehr als eine Kategorisierung für einen Eintrag zu vergeben. Wenn man JavaScript aktiviert hat, kann man bestehende Auszeichnungen durch Mausklick auf eine Auszeichnung in das Textfeld hinzufügen oder, falls die Auszeichnung bereits existiert, daraus entfernen.<br /> <br /> [[Datei:literature_tags.png|Auszeichnungen für Literaturverweise|center|frame]]<br /> <br /> '''ISBN''': Man gibt eine ISBN-Nummer für den Literaturverweis ein. Das Eingabefeld überprüft die angegebene ISBN-Nummer auf Korrektheit, unabhängig davon ob es sich um eine ISBN-10 oder eine ISBN-13 handelt.<br /> <br /> [[Datei:literature_isbn.png|ISBN-Eingabe für Literaturverweise|center|frame]]<br /> <br /> '''Verfügbar unter''': Man gibt eine URL ein, unter der der Literaturverweis verfügbar ist.<br /> '''Datum des Zugriffs''': Man gibt das Datum des letzten Zugriffs auf die URL an.<br /> <br /> [[Datei:literature_url.png|Eingabefelder für elektronische Medien|center|frame]]<br /> <br /> === Frontend-Modul Literaturliste ===<br /> Mit dem Frontend-Modul Literaturliste kann man eine Literaturliste im Contao-Frontend ausgeben. Dazu legt man im Backend unter Layout &gt; Module ein neues Modul vom Typ Literaturliste an.<br /> <br /> Die folgenden Felder kann man für eine Literaturliste bearbeiten:<br /> <br /> * '''Listentitel''': Der Titel der Literaturliste, der in der Kopfzeile der Tabellenausgabe angezeigt wird<br /> * '''Kategorien''': Man wählt alle Kategorien aus, die als Quellen für die Literaturliste dienen sollen<br /> * '''Datensätze pro Seite''': Man gibt die maximale Anzahl von Datensätzen an, die pro Seite angezeigt werden sollen. Bei 0 werden alle Datensätze angezeigt. Bei Werten größer als 0 wird bei bei einer Überschreitung der Anzahl ein Paginator-Objekt eingeblendet.<br /> * '''Auszeichnungen''': Wenn man die Ausgabe der Literaturliste auf bestimmte Auszeichnungen eingrenzen will, so gibt man diese als kommagetrennte Liste in diesem Eingabefeld an<br /> * '''Ausgabestil''': Man wählt ein Template für den Ausgabestil der Literaturverweise aus. Als Standard wird der mitgelieferte Ausgabestil ''litref_standard'' verwendet. Man definiert eigene Ausgabestile, indem man templates mit dem Präfix ''litref_'' erstellt.<br /> <br /> <br /> [[Datei:literature_frontendmodule.png|Einstellungen für das Literaturliste-Modul|center|frame]]<br /> <br /> Wenn man das Kontrollkästchen '''Sortierung festlegen''' auswählt, kann man die Sortierung und die Sortierreihenfolge für die Literaturliste festlegen. Als Sortieroptionen stehen das Erscheinungsdatum und der Titel des Literaturverweises zur Verfügung, als Sortierreihenfolge kann man aufsteigende und absteigende Reihenfolge auswählen. Als Standard wird eine aufsteigende Sortierung nach Erscheinungsdatum verwendet.<br /> <br /> [[Datei:literature_sort.png|Sortieroptionen für Literaturlisten|center|frame]]<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:07, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Calendar_ical 2012-02-16T11:06:26Z

<p>Hschottm: /* Import von CSV-Kalenderdateien in Contao-Kalender */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erzeugt iCal-Dateien von Contao-Kalendern oder importiert iCal-Dateien in den Contao-Kalender.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=http://www.aurealis.de<br /> | ExtVersion=1.4.0<br /> | Version=2.10.0 - 2.10.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == calendar_ical (iCal-Dateien erzeugen und importieren) ==<br /> <br /> Die Erweiterung besteht aus drei Komponenten:<br /> <br /> * Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.<br /> * Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.<br /> * Einem Abonnement, mit dem man einzelne Kalender für Kalenderprogramme zur Verfügung stellen kann.<br /> <br /> === Export von Contao-Kalendern als iCal-Dateien ===<br /> <br /> Mit dem Inhaltselement '''iCal''' können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> [[Datei:ical_ce.png|Parameter des iCal-Inhaltselements|center|frame]]<br /> <br /> Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber man verwendet die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.<br /> === Import von Kalenderdateien in Contao-Kalender ===<br /> <br /> Wenn man sich im Contao Backend in einem Kalender befindet (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhält man im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel '''Kalender importieren''':<br /> <br /> [[Datei:ical_import.png|Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender|center|frame]]<br /> <br /> Wenn man auf diesen Verweis klickt, erhält man die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics oder eine Kommagetrennte Liste mit der Dateiendung .csv aus der Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass man die iCal- oder CSV-Datei vorher bereits in die Dateiverwaltung hochgeladen hat. Für den Import muss man neben der Auswahl der Import-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der Import-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.<br /> <br /> ===== Import von iCal-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für iCal-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]<br /> <br /> Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:<br /> <br /> Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.<br /> <br /> [[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]<br /> <br /> Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich &quot;falschen&quot; Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.<br /> <br /> [[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]<br /> <br /> Da Contao in seinen Kalendern nicht über eine separate Ortsangabe verfügt, werden Termine, die einen Ort enthalten so importiert, dass der eingetragene Ort mit der Kennung '''Ort:''' in die Beschreibung des Termins übernommen wird.<br /> <br /> ===== Import von CSV-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für CSV-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_csv.png|Auswahl einer CSV-Datei und des Import-Zeitraums beim Import einer CSV-Datei|center|frame]]<br /> <br /> Für den Aufbau der CSV-Datei gibt es einige Voraussetzungen, die erfüllt sein müssen, um Kalender im Textformat in Contao zu importieren:<br /> <br /> * die Felder der CSV-Datei sollten mit einem Komma oder einem Semikolon getrennt werden<br /> * es muss eine erste Zeile mit den Spaltenbezeichnern existieren, damit diese den entsprechenden Datenbankfeldern zugeordnet werden können<br /> <br /> Startet man den Kalender-Import, so analysiert Contao die Importdatei und bietet die folgenden Optionen an:<br /> <br /> [[Datei:ical_import_csv_options.png|Optionen beim Import einer CSV-Datei|center|frame]]<br /> <br /> * In der Sektion Felder kann/muss jeder Spalte aus der CSV-Datei (links) ein Datenbankfeld aus einem Contao-Kalendereintrag (rechts) zugewiesen werden. Als Mindestanforderung sollte ein Startdatum, ein Titel und eine Beschreibung des Termins zugewiesen werden.<br /> * Im Feld Datumsformat muss ein Ausdruck zum Ermitteln des verwendeten Datumsformates angegeben werden, damit Contao beim Import des Start- oder Enddatums das Datum auch wirklich erkennt. [http://www.php.net/manual/de/function.strftime.php Gültige Formatangaben] sind alle Angaben, die auch in der [http://www.php.net/manual/de/function.strftime.php PHP-Funktion strftime] verwendet werden können.<br /> * Im Feld Zeitformat muss ein Ausdruck zum Ermitteln der verwendeten Uhrzeit für Start- oder Endzeiten angegeben werden, damit Contao beim Import die Start- oder Endzeiten auch wirklich erkennt. [http://www.php.net/manual/de/function.strftime.php Gültige Formatangaben] sind alle Angaben, die auch in der [http://www.php.net/manual/de/function.strftime.php PHP-Funktion strftime] verwendet werden können.<br /> * Es kann sein, dass die Felder Datumsformat und Zeitformat nicht für den Import angeboten werden. Dies kann leider auftreten, wenn die Contao-Installation auf einem Windows-Rechner betrieben wird. In diesem Fall MUSS das Datumsformat in der CSV-Datei JJJJ-MM-TT, JJJJ-MM-TT HH:mm oder JJJJ-MM-TT HH:mm:ss und das Zeitformat HH:mm betragen, anderenfalls wird das Datum nicht korrekt erkannt.<br /> * Im Drop-Down-Feld Zeichencodierung kann die Zeichencodierung der CSV-Datei festgelegt werden. Möglich sind momentan jedoch nur UTF-8 oder ISO-8859-1 (Windows).<br /> <br /> In der Daten-Vorschau zeigt Contao die ersten fünf Zeilen der Importdatei und die Kopfzeile mit den Spaltentiteln an, damit überprüft werden kann, ob die Erkennung der Spalten und die Verwendung der Zeichencodierung funktionieren. Diese Anzeige kann durch verändern der Zeichencodierung und Anklicken der '''Überprüfen'''-Schaltfläche jederzeit aktualisiert werden.<br /> <br /> Sind alle Felder zugeordnet und die korrekten Zeichencodierungen ausgewählt, so können die Daten durch Anklicken der Schaltfläche '''Weiter''' importiert werden.<br /> <br /> === Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme ===<br /> <br /> Einzelne Kalender kann man gezielt als Abonnements für externe Kalenderprogramme anbieten. Dazu geht man in die Bearbeitung der Events und bearbeitet einen existierenden Kalender:<br /> <br /> [[Datei:ical_be_edit.png|iCal Abonnement Einstellungen eines Kalenders|center|frame]]<br /> <br /> Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis der Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL kann man dann beliebig in den Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.<br /> <br /> Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:21, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Calendar_ical 2012-02-16T11:02:33Z

<p>Hschottm: /* Import von CSV-Kalenderdateien in Contao-Kalender */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erzeugt iCal-Dateien von Contao-Kalendern oder importiert iCal-Dateien in den Contao-Kalender.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=http://www.aurealis.de<br /> | ExtVersion=1.4.0<br /> | Version=2.10.0 - 2.10.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == calendar_ical (iCal-Dateien erzeugen und importieren) ==<br /> <br /> Die Erweiterung besteht aus drei Komponenten:<br /> <br /> * Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.<br /> * Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.<br /> * Einem Abonnement, mit dem man einzelne Kalender für Kalenderprogramme zur Verfügung stellen kann.<br /> <br /> === Export von Contao-Kalendern als iCal-Dateien ===<br /> <br /> Mit dem Inhaltselement '''iCal''' können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> [[Datei:ical_ce.png|Parameter des iCal-Inhaltselements|center|frame]]<br /> <br /> Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber man verwendet die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.<br /> === Import von Kalenderdateien in Contao-Kalender ===<br /> <br /> Wenn man sich im Contao Backend in einem Kalender befindet (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhält man im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel '''Kalender importieren''':<br /> <br /> [[Datei:ical_import.png|Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender|center|frame]]<br /> <br /> Wenn man auf diesen Verweis klickt, erhält man die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics oder eine Kommagetrennte Liste mit der Dateiendung .csv aus der Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass man die iCal- oder CSV-Datei vorher bereits in die Dateiverwaltung hochgeladen hat. Für den Import muss man neben der Auswahl der Import-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der Import-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.<br /> <br /> ===== Import von iCal-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für iCal-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]<br /> <br /> Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:<br /> <br /> Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.<br /> <br /> [[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]<br /> <br /> Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich &quot;falschen&quot; Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.<br /> <br /> [[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]<br /> <br /> Da Contao in seinen Kalendern nicht über eine separate Ortsangabe verfügt, werden Termine, die einen Ort enthalten so importiert, dass der eingetragene Ort mit der Kennung '''Ort:''' in die Beschreibung des Termins übernommen wird.<br /> <br /> ===== Import von CSV-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für CSV-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_csv.png|Auswahl einer CSV-Datei und des Import-Zeitraums beim Import einer CSV-Datei|center|frame]]<br /> <br /> Für den Aufbau der CSV-Datei gibt es einige Voraussetzungen, die erfüllt sein müssen, um Kalender im Textformat in Contao zu importieren:<br /> <br /> * die Felder der CSV-Datei sollten mit einem Komma oder einem Semikolon getrennt werden<br /> * es muss eine erste Zeile mit den Spaltenbezeichnern existieren, damit diese den entsprechenden Datenbankfeldern zugeordnet werden können<br /> <br /> Startet man den Kalender-Import, so analysiert Contao die Importdatei und bietet die folgenden Optionen an:<br /> <br /> [[Datei:ical_import_csv_options.png|Optionen beim Import einer CSV-Datei|center|frame]]<br /> <br /> * In der Sektion Felder kann/muss jeder Spalte aus der CSV-Datei (links) ein Datenbankfeld aus einem Contao-Kalendereintrag (rechts) zugewiesen werden. Als Mindestanforderung sollte ein Startdatum, ein Titel und eine Beschreibung des Termins zugewiesen werden.<br /> * Im Feld Datumsformat muss ein Ausdruck zum Ermitteln des verwendeten Datumsformates angegeben werden, damit Contao beim Import des Start- oder Enddatums das Datum auch wirklich erkennt. [http://www.php.net/manual/de/function.strftime.php Gültige Formatangaben] sind alle Angaben, die auch in der [http://www.php.net/manual/de/function.strftime.php PHP-Funktion strftime] verwendet werden können.<br /> * Im Feld Zeitformat muss ein Ausdruck zum Ermitteln der verwendeten Uhrzeit für Start- oder Endzeiten angegeben werden, damit Contao beim Import die Start- oder Endzeiten auch wirklich erkennt. [http://www.php.net/manual/de/function.strftime.php Gültige Formatangaben] sind alle Angaben, die auch in der [http://www.php.net/manual/de/function.strftime.php PHP-Funktion strftime] verwendet werden können.<br /> * Es kann sein, dass die Felder Datumsformat und Zeitformat nicht für den Import angeboten werden. Dies kann leider auftreten, wenn die Contao-Installation auf einem Windows-Rechner betrieben wird. In diesem Fall MUSS das Datumsformat in der CSV-Datei JJJJ-MM-TT, JJJJ-MM-TT HH:mm oder JJJJ-MM-TT HH:mm:ss und das Zeitformat HH:mm betragen, anderenfalls wird das Datum nicht korrekt erkannt.<br /> * Im Drop-Down-Feld Zeichencodierung kann die Zeichencodierung der CSV-Datei festgelegt werden. Möglich sind momentan jedoch nur UTF-8 oder ISO-8859-1 (Windows).<br /> <br /> === Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme ===<br /> <br /> Einzelne Kalender kann man gezielt als Abonnements für externe Kalenderprogramme anbieten. Dazu geht man in die Bearbeitung der Events und bearbeitet einen existierenden Kalender:<br /> <br /> [[Datei:ical_be_edit.png|iCal Abonnement Einstellungen eines Kalenders|center|frame]]<br /> <br /> Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis der Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL kann man dann beliebig in den Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.<br /> <br /> Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:21, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Calendar_ical 2012-02-16T11:02:07Z

<p>Hschottm: /* Import von CSV-Kalenderdateien in Contao-Kalender */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erzeugt iCal-Dateien von Contao-Kalendern oder importiert iCal-Dateien in den Contao-Kalender.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=http://www.aurealis.de<br /> | ExtVersion=1.4.0<br /> | Version=2.10.0 - 2.10.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == calendar_ical (iCal-Dateien erzeugen und importieren) ==<br /> <br /> Die Erweiterung besteht aus drei Komponenten:<br /> <br /> * Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.<br /> * Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.<br /> * Einem Abonnement, mit dem man einzelne Kalender für Kalenderprogramme zur Verfügung stellen kann.<br /> <br /> === Export von Contao-Kalendern als iCal-Dateien ===<br /> <br /> Mit dem Inhaltselement '''iCal''' können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> [[Datei:ical_ce.png|Parameter des iCal-Inhaltselements|center|frame]]<br /> <br /> Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber man verwendet die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.<br /> === Import von Kalenderdateien in Contao-Kalender ===<br /> <br /> Wenn man sich im Contao Backend in einem Kalender befindet (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhält man im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel '''Kalender importieren''':<br /> <br /> [[Datei:ical_import.png|Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender|center|frame]]<br /> <br /> Wenn man auf diesen Verweis klickt, erhält man die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics oder eine Kommagetrennte Liste mit der Dateiendung .csv aus der Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass man die iCal- oder CSV-Datei vorher bereits in die Dateiverwaltung hochgeladen hat. Für den Import muss man neben der Auswahl der Import-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der Import-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.<br /> <br /> ===== Import von iCal-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für iCal-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]<br /> <br /> Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:<br /> <br /> Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.<br /> <br /> [[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]<br /> <br /> Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich &quot;falschen&quot; Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.<br /> <br /> [[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]<br /> <br /> Da Contao in seinen Kalendern nicht über eine separate Ortsangabe verfügt, werden Termine, die einen Ort enthalten so importiert, dass der eingetragene Ort mit der Kennung '''Ort:''' in die Beschreibung des Termins übernommen wird.<br /> <br /> ===== Import von CSV-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für CSV-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_csv.png|Auswahl einer CSV-Datei und des Import-Zeitraums beim Import einer CSV-Datei|center|frame]]<br /> <br /> Für den Aufbau der CSV-Datei gibt es einige Voraussetzungen, die erfüllt sein müssen, um Kalender im Textformat in Contao zu importieren:<br /> <br /> * die Felder der CSV-Datei sollten mit einem Komma oder einem Semikolon getrennt werden<br /> * es muss eine erste Zeile mit den Spaltenbezeichnern existieren, damit diese den entsprechenden Datenbankfeldern zugeordnet werden können<br /> <br /> Startet man den Kalender-Import, so analysiert Contao die Importdatei und bietet die folgenden Optionen an:<br /> <br /> [[Datei:ical_import_csv_optionen.png|Optionen beim Import einer CSV-Datei|center|frame]]<br /> <br /> * In der Sektion Felder kann/muss jeder Spalte aus der CSV-Datei (links) ein Datenbankfeld aus einem Contao-Kalendereintrag (rechts) zugewiesen werden. Als Mindestanforderung sollte ein Startdatum, ein Titel und eine Beschreibung des Termins zugewiesen werden.<br /> * Im Feld Datumsformat muss ein Ausdruck zum Ermitteln des verwendeten Datumsformates angegeben werden, damit Contao beim Import des Start- oder Enddatums das Datum auch wirklich erkennt. [http://www.php.net/manual/de/function.strftime.php Gültige Formatangaben] sind alle Angaben, die auch in der [http://www.php.net/manual/de/function.strftime.php PHP-Funktion strftime] verwendet werden können.<br /> * Im Feld Zeitformat muss ein Ausdruck zum Ermitteln der verwendeten Uhrzeit für Start- oder Endzeiten angegeben werden, damit Contao beim Import die Start- oder Endzeiten auch wirklich erkennt. [http://www.php.net/manual/de/function.strftime.php Gültige Formatangaben] sind alle Angaben, die auch in der [http://www.php.net/manual/de/function.strftime.php PHP-Funktion strftime] verwendet werden können.<br /> * Es kann sein, dass die Felder Datumsformat und Zeitformat nicht für den Import angeboten werden. Dies kann leider auftreten, wenn die Contao-Installation auf einem Windows-Rechner betrieben wird. In diesem Fall MUSS das Datumsformat in der CSV-Datei JJJJ-MM-TT, JJJJ-MM-TT HH:mm oder JJJJ-MM-TT HH:mm:ss und das Zeitformat HH:mm betragen, anderenfalls wird das Datum nicht korrekt erkannt.<br /> * Im Drop-Down-Feld Zeichencodierung kann die Zeichencodierung der CSV-Datei festgelegt werden. Möglich sind momentan jedoch nur UTF-8 oder ISO-8859-1 (Windows).<br /> <br /> === Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme ===<br /> <br /> Einzelne Kalender kann man gezielt als Abonnements für externe Kalenderprogramme anbieten. Dazu geht man in die Bearbeitung der Events und bearbeitet einen existierenden Kalender:<br /> <br /> [[Datei:ical_be_edit.png|iCal Abonnement Einstellungen eines Kalenders|center|frame]]<br /> <br /> Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis der Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL kann man dann beliebig in den Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.<br /> <br /> Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:21, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Calendar_ical 2012-02-16T11:01:18Z

<p>Hschottm: /* Import von CSV-Kalenderdateien in Contao-Kalender */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erzeugt iCal-Dateien von Contao-Kalendern oder importiert iCal-Dateien in den Contao-Kalender.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=http://www.aurealis.de<br /> | ExtVersion=1.4.0<br /> | Version=2.10.0 - 2.10.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == calendar_ical (iCal-Dateien erzeugen und importieren) ==<br /> <br /> Die Erweiterung besteht aus drei Komponenten:<br /> <br /> * Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.<br /> * Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.<br /> * Einem Abonnement, mit dem man einzelne Kalender für Kalenderprogramme zur Verfügung stellen kann.<br /> <br /> === Export von Contao-Kalendern als iCal-Dateien ===<br /> <br /> Mit dem Inhaltselement '''iCal''' können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> [[Datei:ical_ce.png|Parameter des iCal-Inhaltselements|center|frame]]<br /> <br /> Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber man verwendet die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.<br /> === Import von Kalenderdateien in Contao-Kalender ===<br /> <br /> Wenn man sich im Contao Backend in einem Kalender befindet (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhält man im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel '''Kalender importieren''':<br /> <br /> [[Datei:ical_import.png|Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender|center|frame]]<br /> <br /> Wenn man auf diesen Verweis klickt, erhält man die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics oder eine Kommagetrennte Liste mit der Dateiendung .csv aus der Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass man die iCal- oder CSV-Datei vorher bereits in die Dateiverwaltung hochgeladen hat. Für den Import muss man neben der Auswahl der Import-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der Import-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.<br /> <br /> ===== Import von iCal-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für iCal-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]<br /> <br /> Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:<br /> <br /> Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.<br /> <br /> [[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]<br /> <br /> Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich &quot;falschen&quot; Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.<br /> <br /> [[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]<br /> <br /> Da Contao in seinen Kalendern nicht über eine separate Ortsangabe verfügt, werden Termine, die einen Ort enthalten so importiert, dass der eingetragene Ort mit der Kennung '''Ort:''' in die Beschreibung des Termins übernommen wird.<br /> <br /> ===== Import von CSV-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für CSV-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_csv.png|Auswahl einer CSV-Datei und des Import-Zeitraums beim Import einer CSV-Datei|center|frame]]<br /> <br /> Für den Aufbau der CSV-Datei gibt es einige Voraussetzungen, die erfüllt sein müssen, um Kalender im Textformat in Contao zu importieren:<br /> <br /> * die Felder der CSV-Datei sollten mit einem Komma oder einem Semikolon getrennt werden<br /> * es muss eine erste Zeile mit den Spaltenbezeichnern existieren, damit diese den entsprechenden Datenbankfeldern zugeordnet werden können<br /> <br /> Startet man den Kalender-Import, so analysiert Contao die Importdatei und bietet die folgenden Optionen an:<br /> <br /> * In der Sektion Felder kann/muss jeder Spalte aus der CSV-Datei (links) ein Datenbankfeld aus einem Contao-Kalendereintrag (rechts) zugewiesen werden. Als Mindestanforderung sollte ein Startdatum, ein Titel und eine Beschreibung des Termins zugewiesen werden.<br /> * Im Feld Datumsformat muss ein Ausdruck zum Ermitteln des verwendeten Datumsformates angegeben werden, damit Contao beim Import des Start- oder Enddatums das Datum auch wirklich erkennt. [http://www.php.net/manual/de/function.strftime.php Gültige Formatangaben] sind alle Angaben, die auch in der [http://www.php.net/manual/de/function.strftime.php PHP-Funktion strftime] verwendet werden können.<br /> * Im Feld Zeitformat muss ein Ausdruck zum Ermitteln der verwendeten Uhrzeit für Start- oder Endzeiten angegeben werden, damit Contao beim Import die Start- oder Endzeiten auch wirklich erkennt. [http://www.php.net/manual/de/function.strftime.php Gültige Formatangaben] sind alle Angaben, die auch in der [http://www.php.net/manual/de/function.strftime.php PHP-Funktion strftime] verwendet werden können.<br /> * Es kann sein, dass die Felder Datumsformat und Zeitformat nicht für den Import angeboten werden. Dies kann leider auftreten, wenn die Contao-Installation auf einem Windows-Rechner betrieben wird. In diesem Fall MUSS das Datumsformat in der CSV-Datei JJJJ-MM-TT, JJJJ-MM-TT HH:mm oder JJJJ-MM-TT HH:mm:ss und das Zeitformat HH:mm betragen, anderenfalls wird das Datum nicht korrekt erkannt.<br /> * Im Drop-Down-Feld Zeichencodierung kann die Zeichencodierung der CSV-Datei festgelegt werden. Möglich sind momentan jedoch nur UTF-8 oder ISO-8859-1 (Windows).<br /> <br /> === Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme ===<br /> <br /> Einzelne Kalender kann man gezielt als Abonnements für externe Kalenderprogramme anbieten. Dazu geht man in die Bearbeitung der Events und bearbeitet einen existierenden Kalender:<br /> <br /> [[Datei:ical_be_edit.png|iCal Abonnement Einstellungen eines Kalenders|center|frame]]<br /> <br /> Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis der Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL kann man dann beliebig in den Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.<br /> <br /> Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:21, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Calendar_ical 2012-02-16T11:00:31Z

<p>Hschottm: /* Import von CSV-Kalenderdateien in Contao-Kalender */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erzeugt iCal-Dateien von Contao-Kalendern oder importiert iCal-Dateien in den Contao-Kalender.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=http://www.aurealis.de<br /> | ExtVersion=1.4.0<br /> | Version=2.10.0 - 2.10.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == calendar_ical (iCal-Dateien erzeugen und importieren) ==<br /> <br /> Die Erweiterung besteht aus drei Komponenten:<br /> <br /> * Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.<br /> * Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.<br /> * Einem Abonnement, mit dem man einzelne Kalender für Kalenderprogramme zur Verfügung stellen kann.<br /> <br /> === Export von Contao-Kalendern als iCal-Dateien ===<br /> <br /> Mit dem Inhaltselement '''iCal''' können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> [[Datei:ical_ce.png|Parameter des iCal-Inhaltselements|center|frame]]<br /> <br /> Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber man verwendet die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.<br /> === Import von Kalenderdateien in Contao-Kalender ===<br /> <br /> Wenn man sich im Contao Backend in einem Kalender befindet (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhält man im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel '''Kalender importieren''':<br /> <br /> [[Datei:ical_import.png|Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender|center|frame]]<br /> <br /> Wenn man auf diesen Verweis klickt, erhält man die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics oder eine Kommagetrennte Liste mit der Dateiendung .csv aus der Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass man die iCal- oder CSV-Datei vorher bereits in die Dateiverwaltung hochgeladen hat. Für den Import muss man neben der Auswahl der Import-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der Import-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.<br /> <br /> ===== Import von iCal-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für iCal-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]<br /> <br /> Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:<br /> <br /> Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.<br /> <br /> [[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]<br /> <br /> Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich &quot;falschen&quot; Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.<br /> <br /> [[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]<br /> <br /> Da Contao in seinen Kalendern nicht über eine separate Ortsangabe verfügt, werden Termine, die einen Ort enthalten so importiert, dass der eingetragene Ort mit der Kennung '''Ort:''' in die Beschreibung des Termins übernommen wird.<br /> <br /> ===== Import von CSV-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für CSV-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_csv.png|Auswahl einer CSV-Datei und des Import-Zeitraums beim Import einer CSV-Datei|center|frame]]<br /> <br /> Für den Aufbau der CSV-Datei gibt es einige Voraussetzungen, die erfüllt sein müssen, um Kalender im Textformat in Contao zu importieren:<br /> <br /> * die Felder der CSV-Datei sollten mit einem Komma oder einem Semikolon getrennt werden<br /> * es muss eine erste Zeile mit den Spaltenbezeichnern existieren, damit diese den entsprechenden Datenbankfeldern zugeordnet werden können<br /> <br /> Startet man den Kalender-Import, so analysiert Contao die Importdatei und bietet die folgenden Optionen an:<br /> <br /> * In der Sektion Felder kann/muss jeder Spalte aus der CSV-Datei (links) ein Datenbankfeld aus einem Contao-Kalendereintrag (rechts) zugewiesen werden. Als Mindestanforderung sollte ein Startdatum, ein Titel und eine Beschreibung des Termins zugewiesen werden.<br /> * Im Feld Datumsformat muss ein Ausdruck zum Ermitteln des verwendeten Datumsformates angegeben werden, damit Contao beim Import des Start- oder Enddatums das Datum auch wirklich erkennt. [http://www.php.net/manual/de/function.strftime.php Gültige Formatangaben] sind alle Angaben, die auch in der [http://www.php.net/manual/de/function.strftime.php PHP-Funktion strftime] verwendet werden können.<br /> * Im Feld Zeitformat muss ein Ausdruck zum Ermitteln der verwendeten Uhrzeit für Start- oder Endzeiten angegeben werden, damit Contao beim Import die Start- oder Endzeiten auch wirklich erkennt. [http://www.php.net/manual/de/function.strftime.php Gültige Formatangaben] sind alle Angaben, die auch in der [http://www.php.net/manual/de/function.strftime.php PHP-Funktion strftime] verwendet werden können.<br /> * Es kann sein, dass die Felder Datumsformat und Zeitformat nicht für den Import angeboten werden. Dies kann leider auftreten, wenn die Contao-Installation auf einem Windows-Rechner betrieben wird. In diesem Fall MUSS das Datumsformat in der CSV-Datei JJJJ-MM-TT, JJJJ-MM-TT HH:mm oder JJJJ-MM-TT HH:mm:ss und das Zeitformat HH:mm betragen, anderenfalls wird das Datum nicht korrekt erkannt.<br /> * Im Drop-Down-Feld Zeichencodierung kann die Zeichencodierung der CSV-Datei festgelegt werden. Möglich sind momentan jedoch nur UTF-8 oder ISO-8859-1 (Windows).<br /> <br /> === Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme ===<br /> <br /> Einzelne Kalender kann man gezielt als Abonnements für externe Kalenderprogramme anbieten. Dazu geht man in die Bearbeitung der Events und bearbeitet einen existierenden Kalender:<br /> <br /> [[Datei:ical_be_edit.png|iCal Abonnement Einstellungen eines Kalenders|center|frame]]<br /> <br /> Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis der Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL kann man dann beliebig in den Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.<br /> <br /> Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:21, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Datei:Ical_import_csv_options.png 2012-02-16T10:45:14Z

<p>Hschottm: </p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Calendar_ical 2012-02-16T10:43:26Z

<p>Hschottm: /* Import von CSV-Kalenderdateien in Contao-Kalender */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erzeugt iCal-Dateien von Contao-Kalendern oder importiert iCal-Dateien in den Contao-Kalender.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=http://www.aurealis.de<br /> | ExtVersion=1.4.0<br /> | Version=2.10.0 - 2.10.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == calendar_ical (iCal-Dateien erzeugen und importieren) ==<br /> <br /> Die Erweiterung besteht aus drei Komponenten:<br /> <br /> * Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.<br /> * Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.<br /> * Einem Abonnement, mit dem man einzelne Kalender für Kalenderprogramme zur Verfügung stellen kann.<br /> <br /> === Export von Contao-Kalendern als iCal-Dateien ===<br /> <br /> Mit dem Inhaltselement '''iCal''' können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> [[Datei:ical_ce.png|Parameter des iCal-Inhaltselements|center|frame]]<br /> <br /> Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber man verwendet die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.<br /> === Import von Kalenderdateien in Contao-Kalender ===<br /> <br /> Wenn man sich im Contao Backend in einem Kalender befindet (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhält man im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel '''Kalender importieren''':<br /> <br /> [[Datei:ical_import.png|Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender|center|frame]]<br /> <br /> Wenn man auf diesen Verweis klickt, erhält man die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics oder eine Kommagetrennte Liste mit der Dateiendung .csv aus der Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass man die iCal- oder CSV-Datei vorher bereits in die Dateiverwaltung hochgeladen hat. Für den Import muss man neben der Auswahl der Import-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der Import-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.<br /> <br /> ===== Import von iCal-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für iCal-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]<br /> <br /> Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:<br /> <br /> Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.<br /> <br /> [[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]<br /> <br /> Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich &quot;falschen&quot; Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.<br /> <br /> [[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]<br /> <br /> Da Contao in seinen Kalendern nicht über eine separate Ortsangabe verfügt, werden Termine, die einen Ort enthalten so importiert, dass der eingetragene Ort mit der Kennung '''Ort:''' in die Beschreibung des Termins übernommen wird.<br /> <br /> ===== Import von CSV-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für CSV-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_csv.png|Auswahl einer CSV-Datei und des Import-Zeitraums beim Import einer CSV-Datei|center|frame]]<br /> <br /> Für den Aufbau der CSV-Datei gibt es einige Voraussetzungen, die erfüllt sein müssen, um Kalender im Textformat in Contao zu importieren:<br /> <br /> * die Felder der CSV-Datei sollten mit einem Komma oder einem Semikolon getrennt werden<br /> * es muss eine erste Zeile mit den Spaltenbezeichnern existieren, damit diese den entsprechenden Datenbankfeldern zugeordnet werden können<br /> <br /> === Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme ===<br /> <br /> Einzelne Kalender kann man gezielt als Abonnements für externe Kalenderprogramme anbieten. Dazu geht man in die Bearbeitung der Events und bearbeitet einen existierenden Kalender:<br /> <br /> [[Datei:ical_be_edit.png|iCal Abonnement Einstellungen eines Kalenders|center|frame]]<br /> <br /> Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis der Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL kann man dann beliebig in den Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.<br /> <br /> Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:21, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Datei:Ical_import_csv.png 2012-02-16T10:40:17Z

<p>Hschottm: </p> <hr /> <div></div>

Hschottm https://de.contaowiki.org/Calendar_ical 2012-02-16T10:38:45Z

<p>Hschottm: /* Import von iCal-Kalenderdateien in Contao-Kalender */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erzeugt iCal-Dateien von Contao-Kalendern oder importiert iCal-Dateien in den Contao-Kalender.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=http://www.aurealis.de<br /> | ExtVersion=1.4.0<br /> | Version=2.10.0 - 2.10.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == calendar_ical (iCal-Dateien erzeugen und importieren) ==<br /> <br /> Die Erweiterung besteht aus drei Komponenten:<br /> <br /> * Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.<br /> * Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.<br /> * Einem Abonnement, mit dem man einzelne Kalender für Kalenderprogramme zur Verfügung stellen kann.<br /> <br /> === Export von Contao-Kalendern als iCal-Dateien ===<br /> <br /> Mit dem Inhaltselement '''iCal''' können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> [[Datei:ical_ce.png|Parameter des iCal-Inhaltselements|center|frame]]<br /> <br /> Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber man verwendet die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.<br /> === Import von Kalenderdateien in Contao-Kalender ===<br /> <br /> Wenn man sich im Contao Backend in einem Kalender befindet (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhält man im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel '''Kalender importieren''':<br /> <br /> [[Datei:ical_import.png|Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender|center|frame]]<br /> <br /> Wenn man auf diesen Verweis klickt, erhält man die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics oder eine Kommagetrennte Liste mit der Dateiendung .csv aus der Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass man die iCal- oder CSV-Datei vorher bereits in die Dateiverwaltung hochgeladen hat. Für den Import muss man neben der Auswahl der Import-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der Import-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.<br /> <br /> ===== Import von iCal-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für iCal-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]<br /> <br /> Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:<br /> <br /> Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.<br /> <br /> [[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]<br /> <br /> Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich &quot;falschen&quot; Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.<br /> <br /> [[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]<br /> <br /> Da Contao in seinen Kalendern nicht über eine separate Ortsangabe verfügt, werden Termine, die einen Ort enthalten so importiert, dass der eingetragene Ort mit der Kennung '''Ort:''' in die Beschreibung des Termins übernommen wird.<br /> <br /> ===== Import von CSV-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für CSV-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]<br /> <br /> Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:<br /> <br /> Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.<br /> <br /> [[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]<br /> <br /> Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich &quot;falschen&quot; Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.<br /> <br /> [[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]<br /> <br /> Da Contao in seinen Kalendern nicht über eine separate Ortsangabe verfügt, werden Termine, die einen Ort enthalten so importiert, dass der eingetragene Ort mit der Kennung '''Ort:''' in die Beschreibung des Termins übernommen wird.<br /> <br /> === Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme ===<br /> <br /> Einzelne Kalender kann man gezielt als Abonnements für externe Kalenderprogramme anbieten. Dazu geht man in die Bearbeitung der Events und bearbeitet einen existierenden Kalender:<br /> <br /> [[Datei:ical_be_edit.png|iCal Abonnement Einstellungen eines Kalenders|center|frame]]<br /> <br /> Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis der Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL kann man dann beliebig in den Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.<br /> <br /> Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:21, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Calendar_ical 2012-02-16T10:38:07Z

<p>Hschottm: /* Import von iCal-Kalenderdateien in Contao-Kalender */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erzeugt iCal-Dateien von Contao-Kalendern oder importiert iCal-Dateien in den Contao-Kalender.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=http://www.aurealis.de<br /> | ExtVersion=1.4.0<br /> | Version=2.10.0 - 2.10.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == calendar_ical (iCal-Dateien erzeugen und importieren) ==<br /> <br /> Die Erweiterung besteht aus drei Komponenten:<br /> <br /> * Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.<br /> * Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.<br /> * Einem Abonnement, mit dem man einzelne Kalender für Kalenderprogramme zur Verfügung stellen kann.<br /> <br /> === Export von Contao-Kalendern als iCal-Dateien ===<br /> <br /> Mit dem Inhaltselement '''iCal''' können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> [[Datei:ical_ce.png|Parameter des iCal-Inhaltselements|center|frame]]<br /> <br /> Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber man verwendet die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.<br /> === Import von Kalenderdateien in Contao-Kalender ===<br /> <br /> Wenn man sich im Contao Backend in einem Kalender befindet (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhält man im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel '''Kalender importieren''':<br /> <br /> [[Datei:ical_import.png|Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender|center|frame]]<br /> <br /> Wenn man auf diesen Verweis klickt, erhält man die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics oder eine Kommagetrennte Liste mit der Dateiendung .csv aus der Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass man die iCal- oder CSV-Datei vorher bereits in die Dateiverwaltung hochgeladen hat. Für den Import muss man neben der Auswahl der Import-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der Import-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.<br /> <br /> ===== Import von iCal-Kalenderdateien in Contao-Kalender =====<br /> <br /> Für iCal-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]<br /> <br /> Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:<br /> <br /> Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.<br /> <br /> [[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]<br /> <br /> Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich &quot;falschen&quot; Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.<br /> <br /> [[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]<br /> <br /> Da Contao in seinen Kalendern nicht über eine separate Ortsangabe verfügt, werden Termine, die einen Ort enthalten so importiert, dass der eingetragene Ort mit der Kennung '''Ort:''' in die Beschreibung des Termins übernommen wird.<br /> <br /> === Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme ===<br /> <br /> Einzelne Kalender kann man gezielt als Abonnements für externe Kalenderprogramme anbieten. Dazu geht man in die Bearbeitung der Events und bearbeitet einen existierenden Kalender:<br /> <br /> [[Datei:ical_be_edit.png|iCal Abonnement Einstellungen eines Kalenders|center|frame]]<br /> <br /> Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis der Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL kann man dann beliebig in den Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.<br /> <br /> Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:21, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Calendar_ical 2012-02-16T10:37:12Z

<p>Hschottm: /* Import von iCal-Kalenderdateien in Contao-Kalender */</p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erzeugt iCal-Dateien von Contao-Kalendern oder importiert iCal-Dateien in den Contao-Kalender.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=http://www.aurealis.de<br /> | ExtVersion=1.4.0<br /> | Version=2.10.0 - 2.10.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == calendar_ical (iCal-Dateien erzeugen und importieren) ==<br /> <br /> Die Erweiterung besteht aus drei Komponenten:<br /> <br /> * Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.<br /> * Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.<br /> * Einem Abonnement, mit dem man einzelne Kalender für Kalenderprogramme zur Verfügung stellen kann.<br /> <br /> === Export von Contao-Kalendern als iCal-Dateien ===<br /> <br /> Mit dem Inhaltselement '''iCal''' können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> [[Datei:ical_ce.png|Parameter des iCal-Inhaltselements|center|frame]]<br /> <br /> Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber man verwendet die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.<br /> === Import von Kalenderdateien in Contao-Kalender ===<br /> <br /> Wenn man sich im Contao Backend in einem Kalender befindet (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhält man im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel '''Kalender importieren''':<br /> <br /> [[Datei:ical_import.png|Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender|center|frame]]<br /> <br /> Wenn man auf diesen Verweis klickt, erhält man die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics oder eine Kommagetrennte Liste mit der Dateiendung .csv aus der Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass man die iCal- oder CSV-Datei vorher bereits in die Dateiverwaltung hochgeladen hat. Für den Import muss man neben der Auswahl der Import-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der Import-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.<br /> <br /> ==== Import von iCal-Kalenderdateien in Contao-Kalender ====<br /> <br /> Für iCal-Dateien sieht der Importvorgang folgendermaßen aus:<br /> <br /> [[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]<br /> <br /> Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:<br /> <br /> Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.<br /> <br /> [[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]<br /> <br /> Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich &quot;falschen&quot; Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.<br /> <br /> [[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]<br /> <br /> Da Contao in seinen Kalendern nicht über eine separate Ortsangabe verfügt, werden Termine, die einen Ort enthalten so importiert, dass der eingetragene Ort mit der Kennung '''Ort:''' in die Beschreibung des Termins übernommen wird.<br /> <br /> === Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme ===<br /> <br /> Einzelne Kalender kann man gezielt als Abonnements für externe Kalenderprogramme anbieten. Dazu geht man in die Bearbeitung der Events und bearbeitet einen existierenden Kalender:<br /> <br /> [[Datei:ical_be_edit.png|iCal Abonnement Einstellungen eines Kalenders|center|frame]]<br /> <br /> Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis der Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL kann man dann beliebig in den Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.<br /> <br /> Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:21, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/Calendar_ical 2012-02-16T10:33:55Z

<p>Hschottm: </p> <hr /> <div>[[Kategorie:Extensions]]<br /> <br /> Erzeugt iCal-Dateien von Contao-Kalendern oder importiert iCal-Dateien in den Contao-Kalender.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=http://www.aurealis.de<br /> | ExtVersion=1.4.0<br /> | Version=2.10.0 - 2.10.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == calendar_ical (iCal-Dateien erzeugen und importieren) ==<br /> <br /> Die Erweiterung besteht aus drei Komponenten:<br /> <br /> * Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.<br /> * Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.<br /> * Einem Abonnement, mit dem man einzelne Kalender für Kalenderprogramme zur Verfügung stellen kann.<br /> <br /> === Export von Contao-Kalendern als iCal-Dateien ===<br /> <br /> Mit dem Inhaltselement '''iCal''' können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> [[Datei:ical_ce.png|Parameter des iCal-Inhaltselements|center|frame]]<br /> <br /> Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber man verwendet die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.<br /> === Import von iCal-Kalenderdateien in Contao-Kalender ===<br /> <br /> Wenn man sich im Contao Backend in einem Kalender befindet (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhält man im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel '''Kalender importieren''':<br /> <br /> [[Datei:ical_import.png|Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender|center|frame]]<br /> <br /> Wenn man auf diesen Verweis klickt, erhält man die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics aus der Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass man die iCal-Datei vorher bereits in Ihre Dateiverwaltung hochgeladen hat. Für den Import muss man neben der Auswahl der iCal-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der iCal-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.<br /> <br /> [[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]<br /> <br /> Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:<br /> <br /> Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.<br /> <br /> [[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]<br /> <br /> Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich &quot;falschen&quot; Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.<br /> <br /> [[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]<br /> <br /> Da Contao in seinen Kalendern nicht über eine separate Ortsangabe verfügt, werden Termine, die einen Ort enthalten so importiert, dass der eingetragene Ort mit der Kennung '''Ort:''' in die Beschreibung des Termins übernommen wird.<br /> === Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme ===<br /> <br /> Einzelne Kalender kann man gezielt als Abonnements für externe Kalenderprogramme anbieten. Dazu geht man in die Bearbeitung der Events und bearbeitet einen existierenden Kalender:<br /> <br /> [[Datei:ical_be_edit.png|iCal Abonnement Einstellungen eines Kalenders|center|frame]]<br /> <br /> Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis der Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL kann man dann beliebig in den Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.<br /> <br /> Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird.<br /> Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 13:21, 11. Sep. 2010 (CEST)</div>

Hschottm https://de.contaowiki.org/MultiTextWizard 2012-01-01T18:25:59Z

<p>Hschottm: </p> <hr /> <div>[[Kategorie:Extensions]]<br /> [[en:MultiTextWizard]]<br /> <br /> Auszeichnungen zum Kategorisieren von Elementen.<br /> <br /> {{ExtInfo<br /> | Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])<br /> | DevSite=http://www.aurealis.de<br /> | ExtVersion=1.1.3<br /> | Version=2.10.0 - 2.10.3<br /> | TLVersion=2.7.0 - 2.8.4<br /> | ERLink=http://www.contao.org/erweiterungsliste/view/MultiTextWizard.de.html<br /> | DonateLink=http://aurealis.de/spenden.html<br /> }}<br /> <br /> == MultiTextWizard (Mehrere Textfelder pro Zeile) ==<br /> MultiTextWizard ist ein Contao Widget zur Eingabe von mehreren Textfeldern pro Zeile innerhalb eines Backend-Formulars. Die Anzahl der Textfelder pro Zeile und ein optionales Array mit den Spaltenüberschriften können als Parameter für dieses Widget verwendet werden.<br /> <br /> [[Datei:multitextwizard.png|center|frame|Ausgabe einer MultitextWizard-Eingabe mit zwei Spalten im Contao Backend]]<br /> <br /> === Einbinden von MultiTextWizard in Backend-Formulare ab Version 1.1.0 (empfohlen) ===<br /> <br /> Die Einbindung von MultiTextWizard ist denkbar einfach. Über einen einzigen eval-Parameter kann die Multitext-Matrix mit Überschriften und Überprüfungen eingegeben werden.<br /> <br /> &lt;source type=&quot;php&quot;&gt;<br /> 'fields' =&gt; array<br /> (<br /> 'authors' =&gt; array<br /> (<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['tl_literature']['authors'],<br /> 'inputType' =&gt; 'multitextWizard',<br /> 'eval' =&gt; array<br /> (<br /> 'style'=&gt;'width:100%;',<br /> 'columns' =&gt; array<br /> (<br /> array<br /> (<br /> 'name' =&gt; 'firstname', // optional<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['tl_literature']['firstname'],<br /> 'mandatory' =&gt; false, // optional<br /> 'width' =&gt; '150px' // optional, z.B. '150px' oder '20%'<br /> ),<br /> array<br /> (<br /> 'name' =&gt; 'lastname', // optional<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['tl_literature']['lastname'],<br /> 'mandatory' =&gt; true, // optional<br /> 'rgxp' =&gt; 'alpha', // optional<br /> )<br /> array<br /> (<br /> 'name' =&gt; 'position', // optional<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['tl_literature']['position'],<br /> 'mandatory' =&gt; true, // optional<br /> 'rgxp' =&gt; 'digit', // optional<br /> 'style' =&gt; 'text-align: right;', // optional<br /> 'unique' =&gt; true // optional<br /> )<br /> )<br /> )<br /> ),<br /> &lt;/source&gt;<br /> <br /> Pro Spalte können in einem Array die folgenden Werte zugewiesen werden:<br /> <br /> <br /> {| border=&quot;1&quot; cellpadding=&quot;10&quot; cellspacing=&quot;0&quot; <br /> ! '''Schlüssel''' <br /> ! '''Wert'''<br /> ! '''Beschreibung'''<br /> ! '''Optional'''<br /> |- style=&quot;vertical-align: top;&quot;<br /> | name || ''string'' || Spaltenbezeichner (wird bislang nicht weiter verwendet) || JA<br /> |- style=&quot;vertical-align: top;&quot;<br /> | label || ''string'' || Spaltenüberschrift. Wird über der ersten Zeile einer Spalte angezeigt. || NEIN<br /> |- style=&quot;vertical-align: top;&quot;<br /> | mandatory || true/false ''boolean' || Gibt an, ob es sich bei den Spaltenwerten um Pflichtfelder handelt. || JA<br /> |- style=&quot;vertical-align: top;&quot;<br /> | width || ''string'' || Gibt eine Breite für die Spalte als CSS-Einheit an, z.B. 150px || JA<br /> |- style=&quot;vertical-align: top;&quot;<br /> | style || ''string'' || Gibt einen CSS-Stil für die Spalte an, z.B. text-align: right; || JA<br /> |- style=&quot;vertical-align: top;&quot;<br /> | rgxp || ''string'' || Gibt einen Contao eval-Ausdruck für eine Validierung des Feldes an, z.B. digit für Zahlenfelder. || JA<br /> |- style=&quot;vertical-align: top;&quot;<br /> | unique || true/false ''boolean'' || Gibt an, ob Werte in der Spalte doppelt vorkommen dürfen (false) oder nicht (true). Der Standard ist ''false''. || JA<br /> |- style=&quot;vertical-align: top;&quot;<br /> |}<br /> <br /> Eine Definition im ''columns'' Array überschreibt die globalen Einstellungen des DCA-Containers, sofern die verwendeten Eigenschaften im DCA-Container vorhanden sind.&lt;br /&gt;<br /> Bei der Definition von Breiten für die Spalten ist darauf zu achten, dass man vernünftige Werte einträgt. Die Spalte mit den Schaltflächen hat eine feste Breite von 110 Bildpunkten. Die restliche verfügbare Breite beträgt etwa 560 Bildpunkte.<br /> <br /> Durch die individuelle Vergabe von Pflichtfeldern und Prüfungen für einzelne Spalten fallen jetzt auch die Fehlermeldungen für ein MultiTextWizard Element detaillierter aus. Einerseits werden bei Pflichtspalten die einzelnen Spalten in der Spaltenüberschrift gekennzeichnet, außerdem wird unter jedem fehlerhaften Eingabefeld eine entsprechende Fehlermeldung angezeigt:<br /> <br /> [[Datei:multitextwizard_error.png|center|frame|Fehlermeldungen eines MultiTextWizard Elements]]<br /> <br /> === Einbinden von MultiTextWizard in Backend-Formulare vor Version 1.1.0 ===<br /> <br /> Die Einbindung von MultiTextWizard ist denkbar einfach. Die Anzahl der verfügbaren Spalten lässt sich über den Parameter columns angeben. Optional kann über den Parameter labels ein Array mit columns Elementen angegeben werden, dessen Inhalte dann als Spaltenüberschriften interpretiert und ausgegeben werden.<br /> <br /> Das folgende Beispiel illustriert die Einbindung von MultiTextWizard innerhalb eines field-Arrays in einem Contao Datacontainer:<br /> <br /> &lt;source type=&quot;php&quot;&gt;<br /> 'fields' =&gt; array<br /> (<br /> 'authors' =&gt; array<br /> (<br /> 'label' =&gt; &amp;$GLOBALS['TL_LANG']['tl_literature']['authors'],<br /> 'inputType' =&gt; 'multitextWizard',<br /> 'eval' =&gt; array<br /> (<br /> 'mandatory' =&gt; false, <br /> 'doNotSaveEmpty'=&gt;true, <br /> 'style'=&gt;'width:142px;', <br /> 'columns' =&gt; 2, <br /> 'labels' =&gt; array<br /> (<br /> &amp;$GLOBALS['TL_LANG']['tl_literature']['firstname'], <br /> &amp;$GLOBALS['TL_LANG']['tl_literature']['lastname']<br /> )<br /> )<br /> ),<br /> &lt;/source&gt;<br /> <br /> --[[Benutzer:Hschottm|Hschottm]] 09:59, 1. Sep. 2010 (CEST)</div>

Hschottm