--=REKLAMA=--
Moduł Aktualne terminy umożliwia zdefiniowanie własnego tekstu informacji o bieżących wydarzeniach [Custom Format String], a tym samym precyzyjne wskazanie, które z dostępnych w bazie danych pól mają być wyświetlane w module oraz sposobów ich formatowania.
Elementy informacji można oznakować kodem HTML. Administrator może - zgodnie ze swymi zamierzeniami określać styl wyświetlania, stosując znaczniki <div> lub <span> Znaczniki <div> albo <span> mogą się odwoływać do klas stylów określonych w arkuszu css.
We własnym kodzie można zastosować jeden z dwóch warunków:
Warunek | Opis |
---|---|
a | czas rozpoczęcia i zakończenia jest nieokreślony |
!a | czas rozpoczęcia i zakończenia jest określony |
[warunek: ciąg],
np.:
${eventDate}[!a: - ${endDate(%I:%M%p)}]
${title}
Zastosowanie jednego z warunkow spowoduje, że informacja o wydarzeniu będzie wyświetlana jedynie wówczas, gdy będzie spełniony warunek.
We własnym ciągu informacji można użyć następujących zmiennych:
Zmienne ${startDate}, ${eventDate} i ${endDate} są umieszczone umyślnie, aby umożliwić użytkownikowi wybór sposobu wyświetlania daty i czasu z wykorzystaniem specyfikacji funkcji php date() lub strftime(). Jeżeli wykorzystana jest funkcja PHP strftime() nazwy miesięcy i dni tygodnia oraz inne fragmenty zależne od języka są formatowane zgodnie z bieżacymi ustawieniami regionalnymi serwera.
${startDate('D, M jS, Y, @g:ia')}
To ustawienie wyświetli datę i czas zdarzenia następująco:
Fri, Oct 23rd, 2003, @7:30pm
Uwaga: Domyślny własny format informacji [customFormatStr] = '${eventDate}<br />${title}', ustawiony w wersji 1.4. wyświetla datę zdarzenia lub szczegóły daty w przypadku wydarzeń cyklicznych. Nieokreślenie żadnego formatu daty dla $startDate (czasu rozpoczęcia), $eventDate (daty zdarzenia) albo $endDate (daty zakończenia) spowoduje wyświetlanie informacji o zdarzeniu w formacie określonym wg tego domyślnego ustawienia.
${startDate('M jS, g:ia -')}${endDate(' g:ia')}
${category}: ${title}
To ustawienie własnego formatu informacji [customFormatStr] wyświetli datę i czas zdarzenia w postaci: 'Oct 23rd, 7:30pm - 8:30pm', a w następnej linii - kategorię i nazwę zdarzenia.
<span class='mod_events_latest_date'>${startDate('%x, %X - ')}${endDate('%X')}</span> <br /><span class='mod_events_latest_content'>${category}: ${title}</span>
To ustawienie można zastosować, gdy włączona jest opcja Wydarzenia łączami oraz wyłączone formatowanie daty i formatowanie pola tytułu. Data i czas zostaną wyświetlone zgodnie z ustawieniami regionalnymi, z użyciem odpowiedniego języka - angielskiego, polskiego czy innego, zależnie od ustawień serwera zgodnie z funkcją PHP strftime(). Styl wyświetlania daty określi klasa np. mod_events_latest_date, jak w przykładzie, czy inna, własna, styl wyświetlania kategorii i nazwy zdarzenia klasa mod_events_latest_content. Definiując własny format informacji, trzeba zwrócić uwagę na ilość miejsca, jakim dysponujemy w kalendarzu. Jeśli tekst "zachodzi na siebie", trzeba zmniejszyć rozmiar czcionek, poszerzyć obszar dla modułu w szablonie lub zastosować inne rozwiązanie.
<div style='cursor: default;' onMouseOver="this.style.border='thin dotted red';" onMouseOut="this.style.border='none';" onclick="parent.location = ${eventDetailLink};"> ${startDate}
${title}</div>
To ustawienie można zastosować, gdy opcja Wydarzenia łączami jest wyłączona. To dość prosty przykład użycia stylu css wewnątrz, aby wykorzystania ruch myszki, ale dobrze demonstruje możliwości parametru customFormatStr. To ustawienie wyświetli standardowo datę i tytuł zdarzenia, ale kiedy ustawisz kursor myszki nad jakąkolwiek częścią informacji o zdarzeniu, zdarzenie zostanie otoczone czerwoną linią z kropek. Kliknięcie przyciskiem myszki spowoduje wyświetlenie szczegółowych informacji o zdarzeniu w oknie przeglądarki w obszarze strony.