Kalendarz w witrynie – wyświetlanie zdarzeń Google Calendar na własnej stronie WWW

Pracując jako projektant stron WWW, miałem kiedyś okazję uczestniczyć w tworzeniu bazującego na PHP portalu społecznościowego, przeznaczonego dla fanatyków motoryzacji. Nie było to pierwsze sieciowe okno na świat tej grupy autozapaleńców. Kilka lat wcześniej, nabywszy podstawowe umiejętności konieczne dla projektowania stron WWW, postanowili oni stworzyć witrynę na własną rękę. Jednymi z bardziej istotnych informacji zamieszczanych na ich stronie były przy tym anonse dotyczące zbliżających się wydarzeń i spotkań. Z początku dodawanie ich do zawartości strony nie stanowiło problemu. W miarę jednak rozrastania się sieciowej społeczności, a także tworzenia kolejnych podstron i odnośników, cały projekt zaczął pogrążać się w chaosie. Wprowadzanie i kasowanie danych przerosło możliwości twórców witryny i w efekcie na stronach coraz częściej można było znaleźć od dawna już nieaktualne informacje. A sami fani motoryzacji, zamiast poświęcać się swojemu hobby, większość czasu spędzali przed ekranami komputerów. Skontaktowali się więc ze mną, licząc na to, że będę mógł im pomóc w stworzeniu witryny z prawdziwego zdarzenia – łatwej w obsłudze zarówno dla użytkowników, jak i dla samych właścicieli.

Sama struktura witryny nie była dla projektanta dużym wyzwaniem – moim klientom chodziło o stworzenie forum, gdzie wszyscy zainteresowani mogliby wymieniać informacje dotyczące motoryzacji, oraz stron zawierających aktualności na temat zbliżających się wydarzeń: zjazdów, wycieczek czy wystaw. Nauczeni doświadczeniem nie chcieli się zajmować zarządzaniem wieloma anonsami, umieszczonymi w różnych miejscach w strukturze witryny. Chodziło im właśnie o stworzenie jednego, centralnego kalendarza imprez, do którego zawartości można by było uzyskać dostęp z każdego miejsca na stronie. Stało się dla mnie oczywiste, że najprostszym rozwiązaniem problemu będzie pomoc Google Calendar.

Interfejs programowania dla Google Calendar

Aplikacja Google'a jest doskonałym rozwiązaniem dla społeczności, które chcą się dzielić informacjami na temat zaplanowanych wydarzeń. Umieszczenie danych w jednym miejscu, do którego dostęp może mieć każdy użytkownik, znacząco usprawnia proces komunikacji i planowania. Problem zdezaktualizowanych informacji, umieszczonych na wielu powiązanych ze sobą stronach, przestaje mieć znaczenie.

Projektując więc witrynę klubu motoryzacyjnego w oparciu o CMS Drupal, poradziłem moim klientom, by do zarządzania komunikatami dotyczącymi zbliżających się wydarzeń wykorzystali zalety Google Calendar. Z początku wszystko szło świetnie – elastyczny interfejs Drupala pozwalał im łatwo aktualizować informacje w panelu, który specjalnie do tego celu zaprojektowałem. W miarę upływu czasu, przy coraz większej popularności klubu, rosły jednak także ilości danych, które należało przetworzyć. Aktualizowanie panelu z przyjemności stało się przykrym i nużącym obowiązkiem.

Na szczęście udostępniany przez Google'a interfejs programowania, przeznaczony także dla aplikacji Calendar, pozwolił nam szybko uporać się z narastającym problemem. Google Calendar API zawiera bowiem implementację zarówno źródeł RSS, jak i Atom – przy wykorzystaniu Atom Publishing Protocol (APP), protokołu umożliwiającego pobieranie i aktualizację różnego typu danych. Dostępne są także inne interfejsy programowania dla technologii Microsoft .NET, języków Java, Python i PHP, które pozwalają dodatkowo rozszerzyć funkcjonalność API Google. Po przeprowadzeniu krótkiego rozeznania byłem więc już pewien, że będę w stanie wzbogacić projektowaną witrynę o zawsze aktualny panel wydarzeń, który potrzebne dane pobierał będzie bezpośrednio z aplikacji Google Calendar.

Kanały informacyjne i Calendar

Interfejs programowania Google pozwala nam korzystać z kanałów informacyjnych Atom, dostarczających informacje i dokumenty pochodzące z wielu aplikacji sieciowych oferowanych przez firmę z Mountain View. Dotyczy to oczywiście także narzędzia Google Calendar – najważniejsze dane umieszczone w kalendarzu mogą być oferowane w formie publicznych lub autoryzowanych źródeł. Kanały autoryzowane dają nam ponadto możliwość aktualizacji informacji – dodawania i usuwania zdarzeń oraz tworzenia i subskrypcji poszczególnych kalendarzy. Dzięki API Google Calendar uzyskamy zatem zdalny dostęp do prawie wszystkich tych funkcjonalności, z których zwykle korzystamy za pomocą interfejsu aplikacji. Dotyczy to przy tym nie tylko kalendarzy stworzonych przez użytkownika, ale także przez niego subskrybowanych oraz importowanych w trybie „tylko-do-odczytu”. Wszystkie te kalendarze pozwalają na wyróżnienie publicznych i prywatnych kanałów informacyjnych, zawierających dane przeznaczone dla tych dwóch grup odbiorców. W niniejszym artykule, ze względu na nurtujący nas problem, zajmiemy się oczywiście głównie kanałami informacji publicznych.

Tworzymy publiczny kanał informacyjny

Aby utworzyć publiczny kanał informacyjny dla każdego, wybranego kalendarza w aplikacji Google Calendar, musimy oczywiście rozpocząć od utworzenia konta Google'a – jeśli do tej pory w naszej internetowej karierze udało nam się tego uniknąć. Następnie wybieramy nowy, dopiero utworzony kalendarz i klikamy małą strzałkę, umieszczoną tuż obok jego nagłówka, w panelu nawigacyjnym po lewej stronie. Spośród kilku pozycji interesuje nas najbardziej opcja Ustawienia kalendarza (Calendar Settings):

Pierwszy krok – wybieramy z menu Ustawienia kalendarza.

W panelu ustawień możemy zmienić różne parametry kalendarza, takie jak jego nazwa czy domyślna strefa czasowa. Naszą uwagę powinien jednak zwrócić przede wszystkim odnośnik Zmiana ustawień udostępniania (Change sharing settings). Po jego kliknięciu będziemy mogli określić krąg osób, które uzyskają dostęp do danych zawartych w naszym kalendarzu. Do wyboru pozostawiono nam dwie opcje – udostępnienie informacji publicznie lub też określonej grupie osób (kalendarz współdzielony).

Zmieniamy opcje kalendarza – publiczny lub współdzielony.

W naszej sytuacji wybór jest oczywisty. Aktywujemy opcję Udostępnij ten kalendarz publicznie (Share all information on this calendar with everyone). Po kilkukrotnym potwierdzeniu, że naprawdę wiemy, co robimy, zakończymy naszą przygodę z ustawieniami kalendarza, klikając Zapisz (Save), i będziemy mogli wrócić do znacznie przyjemniejszego dodawania kolejnych interesujących zdarzeń, czekających nas w najbliższej przyszłości.