Dokumentation contentXXL CMS Version 5.3

Visuelles Beispiel

Veranstaltung

 

 
 

Allgemein

Verwaltung und Anzeige von Terminen für Veranstaltungen jeder Art, Veranstaltern, Veranstaltungsorten, zahlreichen Zusatzinformationen und Kalenderfunktion. Synonyme Bezeichnung: Events.

 

Beschreibung

Egal, ob es um Veranstaltungen, Messen, Meetings oder Liefertermine geht: Die Bereitstellung von Termininformationen ist eine wichtige Aufgabe im Internet. Werden diese Informationen nur als unstrukturierter Text präsentiert, verliert der Besucher schnell die Übersicht. Die Zuordnung solcher Informationen zu Zeiträumen (Woche, Monat, Jahr), Personen und Orten sowie entsprechende Filterfunktionen sind wichtige Leistungsmerkmale. Gerade beim Datum ist die in der jeweiligen Sprache und Kultur übliche Formatierung wichtig, da es sonst leicht zu Missverständnissen kommt.

 
 

Spezielle Einstellungen

Folgende speziellen Einstellungen können getroffen werden:

Templates Einzelansicht

  • Detailansicht: Wählen Sie hier das gewünschte Template für die Detail- oder Einzelansicht der Veranstaltung aus.
  • Druckvorschau: Wählen Sie hier das gewünschte Template für die Druckansicht der Veranstaltung aus.
  • Option "Kein Blättern in der Einzelansicht": Wird in der Einzelansicht der Veranstaltung keine Blätterfunktion (Paging, nächste Veranstaltung) benötigt, kann diese Option aktiviert werden. Dies verbessert die Performance und verringert die Systemlast, da dann nur noch die aktuelle Veranstaltung bereitgestellt werden muss. Diese Option ist (aus Gründen der Abwärtskompatibilität) standardmäßig nicht ausgewählt.
  • Dates Item-Template: Template zur Darstellung der einzelnen Termine einer Veranstaltung in der Einzelansicht.
  • Dates Item Alt-Template: Alternierendes Template zur Darstellung der einzelnen Termine einer Veranstaltung in der Einzelansicht.
  • Option "Nur künftige Termine anzeigen": Durch Aktivierung werden nur diejenigen Termine angezeigt, die in der Zukunft liegen.
  • Inline-Edit: Wählen Sie hier das gewünschte Template für das Erscheinungsbild des Inline-Editors in diesem Modul aus.

Templates Listenansicht

  • Anzahl Vorschau groß: Anzahl der Verannstaltungen, die mit dem Template für „Vorschau groß“ in der Listenansicht angezeigt werden sollen.
  • Anzahl Spalten groß: Anzahl der Spalten, die mit dem Template für „Vorschau groß“ in der Listenansicht angezeigt werden sollen.
  • Vorschau groß: Wählen Sie hier das gewünschte Template für die Vorschau-/Listenansicht groß aus. Der Wechsel zwischen einem Template für Vorschau groß und Vorschau klein ermöglicht die Priorisierung von Informationen durch einen Template-Wechsel nach einer bestimmten Anzahl von Veranstaltungen, beispielsweise in eine kleinere Darstellung.
  • Vorschau groß alternierend: Wählen Sie hier das gewünschte Template für die Vorschau-/Listenansicht groß alternierend aus. Der Wechsel zwischen einem Template für Vorschau groß und Vorschau groß alternierend ermöglicht einen Template-Wechsel bei jeder Zeile, um beispielsweise die Lesbarkeit zu erhöhen.
  • Anzahl Vorschau klein: Anzahl der Veranstaltungen, die mit dem Template für „Vorschau klein“ in der Listenansicht angezeigt werden sollen.
  • Anzahl Spalten klein: Anzahl der Spalten, die mit dem Template für „Vorschau klein“ in der Listenansicht angezeigt werden sollen.
  • Vorschau klein: Wählen Sie hier das gewünschte Template für die Vorschau-/Listenansicht klein aus. Der Wechsel zwischen einem Template für Vorschau groß und Vorschau klein ermöglicht die Priorisierung von Informationen durch einen Template-Wechsel nach einer bestimmten Anzahl von Veranstaltungen, beispielsweise in eine kleinere Darstellung.
  • Vorschau klein alternierend: Wählen Sie hier das gewünschte Template für die Vorschau-/Listenansicht klein alternierend aus. Der Wechsel zwischen einem Template für Vorschau klein und Vorschau klein alternierend ermöglicht einen Template-Wechsel bei jeder Zeile, um beispielsweise die Lesbarkeit zu erhöhen.

Blättern in der Vorschau

  • Kopfbereich: Wählen Sie hier das gewünschte Template für den Kopfbereich der Vorschau-/Listendarstellung. Dort können beispielsweise Blätterfunktionen dargestellt werden.
  • Fußbereich: Wählen Sie hier das gewünschte Template für den Fußbereich der Vorschau-/Listendarstellung. Dort können beispielsweise Blätterfunktionen dargestellt werden.
  • Kein Ergebnis: Wählen Sie hier das gewünschte Template für den Fall einer leeren Liste. Dort kann beispielsweise ein entsprechender Hinweis dargestellt werden.

Einstellungen Listenansicht

  • Nur einen Datumseintrag pro Event zeigen: Ist diese Option gesetzt, wird pro Event nur ein Datumseintrag angezeigt, auch wenn mehrere Termine vorhanden sind.
  • Aktiviere Vorgabedatum: Ist diese Option gesetzt, wird ein Vorgabedatum zur Anzeige der aktuellen Veranstaltungen verwendet.
  • Vorgabedatum: Geben Sie hier ein Vorgabedatum zur Anzeige der aktuellen Veranstaltungen an oder aktivieren Sie das Optionsfeld „Heute“ um das jeweils aktuelle Datum als Vorgabedatum zu verwenden. Ist die Option "Aktiviere Vorgabedatum" nicht aktiv, wird dieses Feld ignoriert.
  • Zeitraum vor Vorgabedatum: Geben Sie hier die Anzahl von Tagen an, in der Veranstaltungen vor dem Vorgabedatum angezeigt werden sollen. Ist beispielsweise ein Wert von 30 eingetragen, werden Termine in einem Zeitraum von bis zu 30 Tagen vor dem Vorgabedatum angezeigt. Ist die Option "Aktiviere Vorgabedatum" nicht aktiv, wird dieses Feld ignoriert.
  • Zeitraum nach Vorgabedatum: Geben Sie hier die Anzahl von Tagen an, in der Veranstaltungen nach dem Vorgabedatum angezeigt werden sollen. Ist beispielsweise ein Wert von 30 eingetragen, werden Termine in einem Zeitraum von bis zu 30 Tagen nach dem Vorgabedatum angezeigt. Ist die Option "Aktiviere Vorgabedatum" nicht aktiv, wird dieses Feld ignoriert.

Erweiterte Einstellungen

  • Rotationsmodus: Ist dieser Modus gesetzt, werden ein oder mehrere (entsprechend der Anzahl Vorschau groß) zufällig ausgewählte Listenelemente dargestellt. Diese Funktionalität bedingt einen abgeschalteten Seiten-Cache für die jeweilige Seite.

Hinweis: Wir empfehlen statt dem Server-seitigen Rotationsmodus im Template per Javascript eine Client-seitige Liste aufzubauen. Dann kann das Caching erhalten bleiben.

  • Teasermodus: Ist dieser Modus gesetzt, wird die Einzelansicht des Objektes auf einer anderen Seite in einem anderen Modul (entsprechend der Ziel-ModulID) und auf einer anderen Seite (entsprechend der Ziel-SeitenID) geöffnet. Dieses Objekt muss dort ebenfalls veröffentlicht sein.
  • Ziel-ModulID / Ziel-SeitenID: Durch die Angabe von Ziel-ModulID und Ziel-SeitenID kann ein Öffnen für das angegebene Modul und die angegebene Seite erzwungen werden. Ansonsten wird eine beliebige weitere Veröffentlichung verwendet.
  • Feature-Modus: Ist dieser Modus gesetzt, wird die erste Veranstaltung in der Liste in Einzelansicht geöffnet. Andere Objekte in dem Modul sowie andere Module auf der Seite können in diesem Modus nicht mehr dargestellt werden.

 

Abb.: Spezielle Einstellungen des Moduls Veranstaltungen

 
 

Templates Einzelansicht:

[set:order:DateFrom]
[editbutton]
<p><img src='[imageurl]'/><p>
<h2>[Title]</h2>
<h3 [mvif:headline:neq:]>[headline]</h3>
 <SPAN>[date:DateFrom:d. MMMM yyyy]</SPAN><SPAN [mvif:HasTimeFrom:eq:True]>, [localize:de_time]: <%# FormatDate(DataItem("TimeFrom"), "hh:mm") %></SPAN>
    <SPAN  [mvif:HasDateTo:eq:True]> - [date:DateTo:d. MMMM yyyy]</SPAN>
     <SPAN [mvif:HasTimeTo:eq:True]>
     <SPAN [mvif:HasDateTo:eq:False]> - </SPAN> <%# FormatDate(DataItem("TimeTo"), "HH:MM") %> </SPAN>
<p>[Description]</p>
<p><a href="javascript:history.back()" class="btn btn-default"><span class="glyphicon glyphicon-chevron-left">&nbsp;[localize:back]</span></a></p>

 

<DIV>[date:DateFrom:D] <SPAN [mvif:HasDateTo:neq:False]>[pfl:1:bis][pfl:2:till] [date:DateTo:D]<SPAN [mvif:HasTimeFrom:neq:False]>,</SPAN></SPAN><SPAN [mvif:HasTimeFrom:neq:False]> [date:TimeFrom:t] [pfl:1:Uhr][pfl:2:h] </SPAN><SPAN [mvif:HasTimeTo:neq:False]>[pfl:1:bis][pfl:2:till] [date:TimeTo:t] [pfl:1:Uhr][pfl:2:h] </SPAN></DIV>
<DIV class="clear_space border_left[ci:theme] title_pos">
<H1 class=color[ci:theme]>[Title]</H1>[editbutton]</DIV>
<DIV class=object_content_space>
<DIV>[description] </DIV><STRONG>[pfl:1:weitere Termine][pfl:2:further events]:</STRONG>[eventdatelist]</DIV>

Das Template stellt mit dem Platzhalter [eventdatelist] die zu dieser Veranstaltung gehörige Terminliste dar.

 

Template Listenansicht:

[set:order:DateFrom]
<div class="media">
  <img class="media-object pull-left" src='ResourceImage.aspx?raid=[PreviewImage]' alt='[previewimage_alt]'>
  <div class="media-body">[editbutton]
    <h4 class="media-heading">[Title]</h4>
    <h5 class="media-heading">[Headline]</h5>
    <SPAN>[date:DateFrom:d. MMMM yyyy]</SPAN><SPAN [mvif:HasTimeFrom:eq:True]>, [localize:de_time]: <%# FormatDate(DataItem("TimeFrom"), "hh:mm") %></SPAN>
    <SPAN  [mvif:HasDateTo:eq:True]> - [date:DateTo:d. MMMM yyyy]</SPAN>
     <SPAN [mvif:HasTimeTo:eq:True]>
     <SPAN runat="server" [mvif:HasDateTo:eq:False]> - </SPAN> <%# FormatDate(DataItem("TimeTo"), "HH:MM") %> </SPAN>
    <p class="margin-top10">[Preview]</p>
      <p><a href='[morelink]' class="btn btn-default" role="button"><span class="glyphicon glyphicon-eye-open">&nbsp; Mehr Informationen</span></a></p>
  </div>
</div>

 

Template Dates Item:

[date:DateFrom:D] <SPAN [mvifdatediff:d:datefrom:dateto:neq:0]>[pfl:1:bis][pfl:2:till] [date:DateTo:D]</SPAN>

Template zur Darstellung einer Terminliste. Gerendert wird es mit dem Platzhalter [eventdatelist] in einem Detailansichtstemplate.

 
 

Platzhalter: Date Item

Platzhaltername

Typ

Platzhalterbeschreibung

[DateFrom]

date

Datum des Terminbeginns.

[DateTo]

date

Datum des Terminendes.

[HasDateTo]

string

Gibt an, ob der Termin ein Enddatum hat.

[HasTimeTo]

string

Gibt an, ob der Termin eine Enduhrzeit hat.

[HasTimeFrom]

string

Gibt an, ob der Termin eine Beginnuhrzeit hat.

[TimeFrom]

date

Uhrzeit des Terminbeginns.

[TimeTo]

date

Uhrzeit des Terminendes.

 

Platzhalter: Detailansicht

Platzhaltername

Typ

Platzhalterbeschreibung

[Author]

string

Autor, der dieses Event angelegt hat.

[CreatedDate]

date

Erstellungsdatum des Events.

[DateFrom]

date

Datum des Terminbeginns.

[DateTo]

date

Datum des Terminendes.

[Description]

string

Textdaten (WYSIWYG).

[Editbutton]

string

Schaltfläche, um das Event im Objekt-Edit-Manager zu bearbeiten.

[Eventdatelist]

control

Stellt das ausgewählte Dates Item-Template dar.

[HasDates]

string

Gibt an, ob das Event mehrere Termine hat.

[HasDateTo]

string

Gibt an, ob der Termin ein Enddatum hat.

[HasTimeFrom]

string

Gibt an, ob der Termin eine Beginnuhrzeit hat.

[HasTimeTo]

string

Gibt an, ob der Termin eine Enduhrzeit hat.

[Headline]

string

Überschrift.

[ImagUrl]

string

URL des Vorschaubilds.

[Keywords]

string

SEO-Keywords.

[Memo]

string

Zusätzliches Memo-Feld für das Event.

[NextItemUrl]

string

Url zum nächsten Event in der Liste (Blättern in der Einzelansicht muss aktiviert sein).

[Preview]

string

Vorschautext.

[PreviewImage]

integer

RAID (RessourceAssignID) des Vorschaubilds.

[PreviewImage_alt]

string

Textinformation zum Vorschaubild (Tooltip).

[PreviousItemUrl]

string

Url zum vorherigen Event in der Liste (Blättern in der Einzelansicht muss aktiviert sein).

[PrintLink]

string

Url zur Druckansicht.

[TimeFrom]

date

Uhrzeit des Terminbeginns.

[TimeTo]

date

Uhrzeit des Terminendes.

[Title]

string

Bezeichnung des Events.

[Type]

string

Typ-Schlüssel des Objektyps, der unter SEO ausgewählt wurde.

Anmerkung:
Ihnen stehen hier zusätzlich die Felder [usersetting1] - [usersetting10] (string-Werte), [userint1]-[userint5] (integer-Werte), [userdate1] and [userdate2] (datetime-Werte), [userfloat1]-[userfloat5] (double-Werte), [userimage1]-[userimage5] (integer-Werte, RAIDs), [userimage1_alt]-[userimage5_alt] (string-Werte) zur Verfügung.

Auf die Kontaktdaten zu den einzelnen Terminen können Sie zugreifen, indem Sie die Kontaktplatzhalter (siehe Kontakt-Modul) mit einem speziellen Präfix verwenden:

loc_ = Veranstaltungsort
res_ = Verantwortliche Person
org_ = Organisierende Person

Ein Beispiel für den Nachnamen einer verantwortlichen Person wäre [res_lastname].

Bitte beachten Sie, dass es nicht möglich ist, nach den Kontaktdaten zu gruppieren oder zu sortieren.
 

 

 

Platzhalter: Kopf-/Fußbereich

Platzhaltername

Typ

Platzhalterbeschreibung

[CurrentPageNumber]

integer

Aktuelle Seitennummber – Paging.

[FirstPage]

string

Url zur ersten Seite - Paging.

[IsListView]

string

Gibt an, ob sich das Modul in der Listenansicht befindet.

[LastPage]

string

Url zur letzten Seite – Paging

[ModulePreview]

string

Vorschautext des Moduls.

[ModulePreviewImage]

integer

Vorschaubild des Moduls (RAID).

[ModulePreviewImage_alt]

string

Textinformation zum Vorschaubild (Tooltip).

[NextPage]

string

Url zur nächsten Seite – Paging.

[PreviousPage]

string

Url zur vorherigen Seite – Paging.

[PrintLink]

string

Url zur Druckansicht.

[ReturnToListLink]

string

Url zurück zur Listenansicht.

[ReturnToOriginalListLink]

string

  
Url zurück zur Listenansicht (bei Paging der Einzelansicht).

[ShownFrom]

integer

Index des ersten Elements, das auf der aktuellen Seite angezeigt wird.

[ShownTo]

integer

Index des letzten Elements, das auf der aktuellen Seite angezeigt wird.

[TellAFrendLink]

string

 Url zum Empfehlungs-Modul (Tell-a-Friend).

[TotalItemsCount]

integer

Anzahl aller Elemente – Paging.

[TotalPageCount]

integer

Anzahl aller Seiten – Paging.

 

Platzhalter: Listenansicht

Platzhaltername

Typ

Platzhalterbeschreibung

[Author]

string

Autor, der dieses Event angelegt hat.

[CreatedDate]

date

Erstellungsdatum des Events.

[DateFrom]

date

Datum des Terminbeginns.

[DateTo]

date

Datum des Terminendes.

[Description]

string

Textdaten (WYSIWYG).

[EditButton]

string

Schaltfläche, um das Event im Objekt-Edit-Manager zu bearbeiten.

[HasDateTo]

string

Gibt an, ob der Termin ein Enddatum hat.

[HasTimeFrom]

string

Gibt an, ob der Termin eine Beginnuhrzeit hat.

[HasTimeTo]

string

Gibt an, ob der Termin eine Enduhrzeit hat.

[Headline]

string

Überschrift.

[imageurl]

string

URL des Vorschaubilds.

[keywords]

string

SEO-Keywords.

[Memo]

string

Zusätzliches Memo-Feld für das Event.

[Morelink]

string

Url zur Detailansicht.

[Preview]

string

Vorschautext.

[Previewimage]

integer

RAID (RessourceAssignID) des Vorschaubilds.

[Previewimage_alt]

string

Textinformation zum Vorschaubild (Tooltip).

[TimeFrom]

date

Uhrzeit des Terminbeginns.

[TimeTo]

date

Uhrzeit des Terminendes.

[Title]

string

Bezeichnung des Events.

[Type]

string

Typ-Schlüssel des Objektyps, der unter SEO ausgewählt wurde.

 

Anmerkung:
Ihnen stehen hier zusätzlich die Felder [usersetting1] - [usersetting10] (string-Werte), [userint1]-[userint5] (integer-Werte), [userdate1] and [userdate2] (datetime-Werte), [userfloat1]-[userfloat5] (double-Werte), [userimage1]-[userimage5] (integer-Werte, RAIDs), [userimage1_alt]-[userimage5_alt] (string-Werte) zur Verfügung.

Beispiel der Darstellung von [DateFrom] und [DateTo] ohne Uhrzeit:
[date:DateFrom:dd.MM.yyyy]

Auf die Kontaktdaten zu den einzelnen Terminen können Sie zugreifen, indem Sie die Kontaktplatzhalter (siehe Kontakt-Modul) mit einem speziellen Präfix verwenden:

loc_ = Veranstaltungsort
res_ = Verantwortliche Person
org_ = Organisierende Person

Ein Beispiel für den Nachnamen einer verantwortlichen Person wäre: [res_lastname]

Bitte beachten Sie, dass es nicht möglich ist, nach den Kontaktdaten zu gruppieren oder zu sortieren.

Bei Verknüpften Events und der Eventsuche ist nur das Datum des nächsten Event vom aktuellen Tag an verfügbar (zusammen mit den Kontaktdaten). Wenn es kein solches Datum gibt, wird der [DateFrom]-Platzhalter mit dem Wert 01.01.1900 belegt.

 

Das Basisdaten-Formular

  • Titel: Tragen Sie hier die Bezeichnung der Veranstaltung ein (dieser Eintrag wird auch intern zur Identifikation des Objekts verwendet).
  • Autor: Hier erscheint der Ersteller der Veranstaltung als Autor.
  • Vorschau: Tragen Sie hier gegebenfalls einen Vorschautext für die Veranstaltung ein (sofern vom Template unterstützt).
  • Kopfzeile: Tragen Sie hier gegebenfalls die Kopfzeile der Veranstaltung ein (sofern vom Template unterstützt).
  • Vorschaubild: Auswahl / Ändern / Entfernen eines Bildes aus dem Ressourcen-Manager.

Termine

Hier können zu den einzelnen Veranstaltungen die jeweiligen Termine angelegt, bearbeitet und gegbenenfalls gelöscht werden.

Abb.: Das Veranstaltungs-Objekt enthält neben den üblichen Registern den Bereich  Termine zur Verwaltung der Zeitangaben.

 

Termin hinzufügen

Ein Klick auf den Button öffnet ein Fenster mit folgenden Feldern:
  • Ansprechpartner: Mit einem Klick auf das Icon "Objekt auswählen" öffnet sich der Objektbrowser und die für den Termin zuständige Person (die als Kontaktobjekt angelegt sein muss) kann ausgewählt werden. Über den Editbutton kann der entsprechende Kontakt direkt bearbeitet werden.
  • Veranstaltungsort: Mit einem Klick auf das Icon "Objekt auswählen" öffnet sich der Objektbrowser und der Veranstaltungsort des Termins (der als Kontaktobjekt angelegt sein muss) kann ausgewählt werden. Über den Editbutton kann der entsprechende Kontakt direkt bearbeitet werden.
  • Datum Beginn: Geben Sie hier Tag, Monat und Jahr ein, an dem der Termin beginnt.
  • Datum Ende: Wenn Sie die Option "hat einen Endtermin" aktivieren, können Sie hier Tag, Monat und Jahr des Terminendes hinterlegen.
  • Uhrzeit Beginn: Wenn Sie die Option "hat eine Startuhrzeit" aktivieren, können Sie hier Stunde und Minute des Terminbeginns hinterlegen.
  • Uhrzeit Beginn: Wenn Sie die Option "hat eine Enduhrzeit" aktivieren, können Sie hier Stunde und Minute des Terminendes hinterlegen.
  • Memo: Hier können Sie weitere Textinformation zum Termin ablegen.

Mehrere Termine hinzufügen

Ein Klick auf den Button öffnet dieses Fenser:

 

Abb.: Dialog zum Anlegen einer Terminserie für eine Veranstaltung


Wählen Sie wie oben beschrieben Ansprechpartner sowie Veranstaltungsort aus und geben dann "Datum von" und "Datum bis" ein (falls zutreffend, auch die Uhrzeit). Alternativ zum Endtermin besteht die Möglichkeit, eine bestimmte Zahl von Veranstaltungen festzulegen. Mithilfe von Regeln können spezielle Werktage, Wochen, Monate oder Tage ein- oder ausgeschlossen werden. Auch hier kann unter "Memo" weitere Textinformation zum Termin abgelegt werden. Weiterhin besteht die Option, Einzeltermine zu einem Termin zusammenzufassen. Der Vorschau-Button ermöglicht Ihnen, das Ergebnis der aktuellen Einstellungen vor dem Speichern zu überprüfen.

Wenn das Ergebnis übernommen werden soll, klicken Sie auf "Speichern".
 

 

 

Verknüpfte Veranstaltungen

Das Veranstaltungs-Modul ist auch als Variante für verknüpfte Veranstaltungen verfügbar. Entsprechend Betriebsmodus und Templates werden hier dynamisch bestimmte Veranstaltungen in Listenform angezeigt. Es sind die gleichen Einstellungen verfügbar wie für Artikel.

 

 

RSS-Feeds

Veranstaltungen können als RSS-Feeds abonniert werden. Folgende Webservices stehen zur Verfügung (die angegeben Werte sind beispielhaft):

~/contentXXL/Services/Eventsexport/rss.asmx/GetRSSEventsByTabId?TabId=1
alle Veranstaltungen auf der angegebenen Seite

~/contentXXL/Services/Eventsexport/rss.asmx/GetRSSEvents
alle Veranstaltungen des Portals