--=REKLAMA=--

JEvents/Własny format informacji w module Aktualne terminy

Z Joomla!WikiPL

< Moduł: Terminy - Legenda

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.

Dostępne warunki

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

Składnia

[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.

Dostępne pola

We własnym ciągu informacji można użyć następujących zmiennych:

  • ${startDate} - data rozpoczęcia,
  • ${eventDate} - termin zdarzenia,
  • ${endDate} - data zakończenia,
  • ${title} - nazwa zdarzenia,
  • ${category} - kategoria,
  • ${contact} - kontakt,
  • ${content} - opis zdarzenia,
  • ${addressInfo} - miejsce zdarzenia,
  • ${extraInfo} - dodatkowe informacje,
  • ${createdByAlias} - nazwa autora informacji,
  • ${createdByUserName} - nazwa autora - użytkownika,
  • ${createdByUserEmail} - adres email autora,
  • ${createdByUserEmailLink} - adres email autora w postaci odnośnika,
  • ${eventDetailLink} - odnośnik do szczegółów,
  • ${color} - kolor tła, czcionki

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.

Przykład 1.

${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.

Przykład 2.

${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.

Przykład 3.

<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.

Przykład 4.

<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.


Moduł: Terminy - Legenda >

Dziękujemy za wkład

» Stefan Wajda [zwiastun],