Modul neue Termine Hilfe

Fenster Schliessen | Drucken

Dieses - optionale - Modul zeigt die neuesten (und wenn so konfiguriert) auch vergangene Termine an.
Das Modul ist nicht Bestandteil der Komponente und muss extra von der
JEvents Projektseite downgeloaded und installiert, sowie Veröffentlicht werden!

Ausgabeformat:

Die Ausgabe des Moduls erfolgt mittels einer HTML-Tabelle mit n Reihen mit 1 Kolumne, wobei der Wert n die Anzahl der angezeigten Termine angibt.
Die maximale Anzeige wird mittels eines der folgenden Parameter definiert (Vorgabe ist 5)

CSS Stil:

Jeder Termin begintn mit einem Beginndatum in der ersten Zelle, gefolgt von dem Termintitel in der 2. Zeile.
Beide - das Datum sowie der Titel - haben eine eigene CSS-Klasse.

Der erste angezeigte Termin hat ebenso seine eigene CSS-Klasse (mod_events_latest_first). Alle nachfolgenden Termine verwenden die CSS-Klasse (mod_events_latest). Die Termine werden durch eine horizontale Linie getrennt.

Hinweis: Alle CSS-Klassen sind in der generellen Komponenten-CSS-Datei enthalten und können innerhalb dieser Konfiguration geändert werden Tab CSS

Modul Parameter:

Das Modul wird durch zahlreiche Parameter unterstützt welche hauptsächlich das Aussehen der Termine bestimmen.

Parameterdefinitionen:

Parameter | Beschreibung
Maximal x Termine | Anzahl der maximal gleichzeitig anzuzeigenden Termine (1 - 150, Vorgabe ist 5)

Anzeigemodus

- 0 (Vorgabe) - Anzeige der nächsten Termine der aktuellen Woche PLUS folgende Woche bis maximal anzuzeigende Termine
- 1 Ähnlich der Einstellung 0, ausser dass auch Termine der Vorwoche angezeigt werden, wenn die Anzahl der nachfolgenden Termine kleiner als der Maximalwert aller anzuzeigenden Termine ist
- 2 Anzeige der Termine welche am nächsten der Anzahl Tage Vor-Nachher liegen
- 3 Ähnlich dem Modus 2, ausgenommen wenn die maximale Anzahl der anzuzeigenden Termine innerhalb des Bereichs liegen, werden auch die bereits vergangenen Termin angezeigt (Relativ zum heutigen Tag)
- 4 Anzeige der am nächsten liegenden Termine bis zum Maximalwert des aktuellen Monats - relativ zum heutigen Tag

Tage Vor-Nachher | Anzahl der anzuzeigenden Tage - relativ zum heutigen Tag (Vorgabe ist 7 Tage) Hinweis: nur gültig für Modus 1 oder 3
Wiederholungstermin nur einmal anzeigen | Erstreckt sich ein Termin über mehrere Tage oder ist es es Wiederholungstermin, kann hier angegeben werden, ob er mehrmals oder nur einmal angezeigt werden soll
Termine als Link anzeigen | Sollen die Termine als Link ausgeführt werden - ein Klick darauf öffnet dann die Detailansicht
Jahr anzeigen | Soll im Termin auch das Jahr angezeigt werden
CSS für Datumsfeld ausschalten | Soll die definierte CSS-Klasse mod_events_latest_date für das Datumsfeld verwendet werden
CSS für Titel ausschalten | Soll der Termintitle mit der vorhandenen CSS-Klasse mod_events_latest_content angezeigt werden

Individuelle Formatierung

= string
Hier kann eine individuelle Formatierung zur Terminanzeige eingegeben werden (Format ist string). Es kann sowohl eines der u.a. Möglichkeiten verwendet werden, als auch zusätzlich weitere HTML.Tags. Weiters kann jedes Feld in der Form ${event_field} verwendet werden.
Wenn gewünscht können auch CSS-Formatierungsangaben verwendet werden ( <div> oder <span>). Ebenso können neue CSS-Klassen in der CSS-Datei definiert werden und diese dann hier verwendet werden.
= [cond: string ] Hier kann eine individuelle Formatierung zur Terminanzeige eingegeben werden die nur angezeigt wird, wenn die Bedingung "cond" true ist.
Verfügbare Bedingungen:
a Termin ist ganztägig(ohne Zeitangaben)
!a Termin ist nicht ganztägig(ohne Zeitangaben)
Mögliche Felder sind: ${startDate}, ${eventDate}, ${endDate}, ${title}, ${category}, ${contact}, ${content}, ${addressInfo}, ${extraInfo}, ${createdByAlias}, ${createdByUserName}, ${createdByUserEmail}, ${createdByUserEmailLink}, ${eventDetailLink}, ${color}
Die Felder ${startDate}, ${eventDate} und ${endDate} sind spezielle Formatierungsfelder, welche weiters individuell angepasst werden können.
Zur einsatz kommen hier die PHP-Eigenen Funktionen [ date() und strftime() ] - mehr darzu unter PHP date-funktion und PHP strftime-funktion
Hinweis: wird in der Formatierung ein %s verwendet, wird automatisch das strftime-Format angewendet (lokale Einstellungen werden unterstützt)!

Beispiel

Die Verwendung von: ${startDate('D, M jS, Y, @g:ia')} ergibt: Fri, Aug 1st, 2006, @7:30pm
Hinweis: als Vorgabe wird '${eventDate}[!a: - ${endDate(%I:%M%p)}]<br />${title}' verwendet, damit sieht die Terminanzeige so aus: Datum des Termins (oder wenn Mehrtägiger oder Wiederkehrender dann den heutigen Teil). Die Start- und Endezeit wird nur angezeigt, wenn es kein ganztägiger Termin ist(Bedingung !a).

Datumsformatierungen:

Im nachfolgenden eine Kurzreferenz (genauere Beschreibung siehe die Links zu php.net oben). Hinweis: es kann entweder nur das date() oder das strftime() Format verwendet werden - ein mixen der Beiden ist nicht möglich!

php date() Parameter:

a | am (ante meridiem) und pm (post meridiem) Kleingeschrieben (US-Format)
A | AM (ante meridiem) und PM (post meridiem) Grossgeschrieben (US-Format)
B | Swatch Internet Zeit ( 000 bis 999 )
d | Tag, 2 Stellen mit führender Null (01 bis 31)
D | Textform der Tage in Kurzform - 3 Buchstaben (Mon - Son)
F | Textform der Monate - ausgeschrieben ( Jannuar bis Dezember)
g | Stunden im 12-Stundenformat (1 bis 12) ohne führende Null
G | Stunden im 24-Stundenformat (01 bis 24) mit führender Null
h | Stunden im 12-Stundenformat (01 bis 12) mit führender Null
H | Stunden im 24-Stundenformat (01 bis 23) mit führender Null
i | Minuten mit führender Null ( 00 bis 56)
I | (Grosses i) Berücksichtigt eventuelle Sommer-/Winterzeit (1 ja, 0 nein)
j | Tag ohne führender Null (1 bis 31)
l | (Kleines L) Tage voll ausgeschrieben (Sonntag bis Samstag)
L | Anzeige ob Schaltjahr oder nicht (1 ja, 0 nein)
m | Monat als Zahl führender Null (01 bis 12)
M | Monate im 3-Zeichenformat (Jan bis Dez)
n | Monate als Zahl, ohne führender Null (1 bis 12)
O | Differenz zur Greenwich time (GMT) in Stunden. Beispiel: +0200
r | RFC 822 Konforme Datumsformatierung. Beispiel: Thu, 21 Dec 2000 16:01:07 +0200
s | Sekunden mit führender Null (00 bis 59)
S | Erweiterung bei Anzeige als anglikanisches Datum (st, nd, rd oder th). In Kombination mit dem Parameter j
t | Anzahl der Monatstage (28 bis 31)
T | Zeitzone - Beipiele: EST, MDT, usw.
U | Sekunden seit Beginn der UNIX-Zeitrechnung( 1. Jannuar 1970 00:00:00 GMT)
w | Wochentag als Zahl ( 0 - für Sonntag bis 6 - für Samstag)
W | ISO-8601 Wochennummer, Woche startet mit Montag. Beispiel: 42 (42. woche des angezeigten Jahres)
Y | Jahreszahl mit 4 Stellen (z.B. 2006)
y | Jahreszahl mit 2 Stellen (z.B. 06 für 2006)
z | Nummer des Tages im laufenden Jagr( 0 bis 366)
Z | Zeitzonenunterscheid in Sekunden (nach Greenwich). Westlich daon negatibe Werte, östlich davon positive Werte (-43200 bis 43200)

php strftime() Formate:

Hinweis: alle folgenden Einstellungen sind abhängig von den richtigen Servereinstellungen! Sollte die eine oder/und Andere Einstellung nicht das gewünschte ergebnis anzeigen, dann bitte mit dme Provider in Verbindung setzen und den (eventuell) höflich darauf hinweisen dass er die lokalen Servereinstellungen überprüfen sollte!
%a | Abgekürzter Wochentag
%A | Voll ausgeschriebener Wochentag
%b | Abgekürzter Monatsname
%B | Voll ausgeschriebener Monatsname
%c | Bevorzugte Anzeige von Datum und Uhrzeit
%C | Nummer des Jahrhunderts (Jahr dividiert durch 100, umgewandelt zu einem Integer, 00 bis 99)
%d | Tag als Dezimalzahl (01 bis 31)
%D | Das Gleiche wie %m/%d/%y
%e | Aktueller Tag des Monats als Dezimalzahl ohne führende Null, stattdessen mit Leerzeichen ( ' 1' bis '31')
%g | Wie %G, aber ohne Jahrhundert
%G | Jahrezahl mit 4 Stellen (z.B. 2006) in Übereinstimmung zur ISO-Wochennummer (siehe auch %V) Dieser Parameter verwendet im Prinzp dieselbe Ausgabe wie %V, ausgenommen wenn die ISO_Woche zum Vorjahr oder nächsten Jahr gehört, wird das jahr angezeigt
%h | Wie %b
%H | Stunde als Dezimlazahl im 24-Stundenformat (00 bis 23)
%I | Stunde als Dezimalzahl im 12-Stundenformat (01 to 12)
%j | Tag als Dezimalzahl mit führenden Nullen (001 bis 366)
%m | Monat als Dezimalzahl mit führender Null (01 bis 12)
%M | Minute asl Dezimalzahl mit führender Null (00 bis 59)
%n | Neue Linie (als Trennzeichen)
%p | entweder 'am' oder 'pm' (abhängig von der Zeitanzeige) oder die jeweilige Anzeige zur lokalen Einstellung
%r | Zeit als a.m. oder p.m. (nur Anglikanisch)
%R | Zeit im 24-Stundenformat (00 bis 24)
%S | Sekunde als Dezimalzahl (00 bis 59)
%t | Abstand als Tab
%T | Lokale Zeit (wie %H:%M:%S)
%u | Wochentag als Dezimalzahl (1 bis 7 - Montag ist 1!)
%U | Wochennummer des aktuellen jahres als Dezimalzahlm beginnend mit Sonntag als dem ersten Tag der ersten Woche
%V | Die Wochennummer als ISO 8601:1988 des aktuellen jahres (01 bis 53), wobei als erste Woche diejenige ist, welche mindestens 4 Tage des aktuellen Jahres hat (Die Verwendung von %G oder %g für das Jahr erzeugt im Prinzip das Gleiche, ist aber abhängig vor angegebenen Datumsdarstellung)
%W | Wochennummer des aktuellen jahres als Dezimalzahl, beginnend mit Montag als dem ersten Tag der ersten Woche
%w | Tag der Woche als Dezimalzahl, beginnend mit Sonntag als 0
%x | Anzeige des lokalen Datums ohne Uhrzeit
%X | Anzeige der lokalen Uhrzeit ohne Datum
%y | Jahr als Dezimalzahl mit 2 Stellen (00 bis 99)
%Y | Jahr alas 4-stellige Dezimalzahl (z.B. 2006)
%Z | Zeitzone
%% | Wird als `%' angezeigt

Weitere einsetzbare Veriablen:

- ${createdByUserEmail} - Emailadresse des Veranstalters
- ${createdByUserEmailLink} - Emailadresse als Link zum Veranstalter
  Beispiel für eine Emailadresse als Link anzuzeigen: <a href=${createdByUserEmailLink}>Anfrage</a>
- ${eventDetailLink} - Link zur Termindetailseite.
  Hinweis: Diese anzeige ist etwas unterschiedlich zur Anzeige eines Veranstalterlinks. Beispiel siehe weiter unten
- ${color} - Die Farbe welche für die kategorie angegeben wurde. Kann als Inline-CSS innherhalb des ${customFormatStr} verwendet werden um die Ausgabe der Hintergrundfarbe sowie der Schriftfarbe zu verändern

Weiter Beispiele zum Einsatz von '${customFormatStr}':

Beispiel 1

displayLinks=1
mode=0
customFormatStr='<div style='background-color:${color};'>${startDate('m/d/y')}, ${title}</div>'
Ergibt eine Anzeige: einfaches Datum ( Monat/Tag/Jahr - je zweistellig ), gefolgt von einem Hyperlink zum Termintitel, gleicher Hintergrund wie im backend festgelegt.
Bei dieser Art von Anzeige muss man vorsichtig sein, da keine Textfarbe definiert ist und es daher - abhängig vom Templatedesign - zu schlechteren Leseergebnissen kommen könnte

Beispiel 2

displayLinks=1
disableDateStyle=1
disableContentStyle=1
mode=2
days=14
customFormatStr='<span class='mod_events_latest_date'>${startDate('%x, %X - ')}${endDate('%X')}</span><br /><span class='mod_events_latest_content'>${category}: ${title}</span>'
Dieses Beispiel zeigt das Datum und die Uhrzeit in einer 'bevrozugten' Darstellung (abhängig von den lokalen Servereinstellungen. Benutzt wird die Sprache lt. Einstellungen (ebenso Serverabhängig!).
Achtung auf die Parameter 'disableDateStyle' und 'disableContentStyle' welche das automatische Formatieren der ${startDate}, ${endDate}, oder ${title} unterbindet da verschiedene Benutzerfelder mit eingeschlossenem text verwendet werden.
Es ist immer besser spezifische CSS-Klassen zu verwenden mit einem HTML-Element <span> um unerwünschte Textformatierungen zu vermeiden.
Ebenso wird in diesem Beispiel der Text an der rechten Modulseite umgebrochen falls nicht genug Platz sein sollte. In diesem Fall kann entweder die Schriftgrösse reduziert, die Modulbreite angepasst werden oder eine Kombination davon oder andere Methoden.

Beispiel 3

displayLinks=0
customFormatStr='<div style='cursor: default;' onMouseOver="this.style.border='thin dotted red';" onMouseOut="this.style.border='none';" onclick="parent.location = ${eventDetailLink};">${startDate}<br />${title}</div>'
Dieses Beispiel zeigt eine sehr erweiterte Möglichkeit der Darstellung an. Es werden sowohl Inline-CSS-Styles als auch Mouse-Events eingesetzt, demonstriert aber die extreme Flexibilität der Komponente und des Moduls.
Befindet sisch hier der Cursor über dem Termin wird ein roter Rand angezeigt, Klicken auf den Termin öffnet diesen im Hauptbereich des CMS da als Hyperlink ausgeführt.

Fenster Schliessen
Drucken
Aktuellste Version hier

Doc.Revision: 1.0 - 2006.08.01