Използване на aaa.bapha.be

Обща информация

Bapha.be предоставя данни за събития на интернет страница за дадено селище и в стандартен, машинно-четим формат (iCalendar). Програмите, разботещи с този формат, могат да бъдат настроени да изтеглят периодично информацията за събитията и да я показват актуална, без потребителите да посещават интернет страницата. Различните програми разбират форма̀та до различна степен и показват каквото са разбрали. При натискане на 🔗︎ при всяко събитие се изтегля събитието в iCalendar формат и обикновено се отваря с подходящата програма.

Предоставянето на информация в машинно-четим формат позволява тя да се препубликува от различни издания, без информацията за всяко събитие да се въвежда отново. Вж. Какво е CalDAV и синхронизиране с vdirsyncer.

Сайтът може да съхранява IP адреси на посетителите за предотвратяване на злоупотреби.

Внедряване в Android

Ако се използва Google календар, както е описано, не е нужно да се инсталират допълнителни програми, но тогава отделните календари се показват като един.

Чрез програмата DAVx⁵, която може да се изтегли от Google Play Store или F-Droid, Android синхронизира своите календари с aaa.bapha.be. Има и други подходящи програми.

В DAVx⁵ версия 3.3.4 или по-нови направете регистрация като изберете „оранжевия +“ и след това „Вход за напреднали потребители“: (основен адрес) aaa.bapha.be, без потребителско име, без сертификат. В по-стари версии на DAVx⁵ изберете „оранжевия +“ и след това направете регистрация с електронна поща за потребител anonymous@aaa.bapha.be с произволна парола.

Когато на сървъра се създадат нови календари, на DAVx⁵ трябва да се укаже изрично да опресни списъка с календари. Събитията се показват в календарните програми използвани на Android, след като на тези програми се посочи допълнително от кои календари да черпят събития. Календарите на Android не показват приложения (картинки) и интернет адреси към събития.

Внедряване в Apple

Внедряването работи при всички устройства на Apple. За OS X отворете програмата Календар и след това Настройки → Регистрации. За iOS изберете Настройки → Регистрация.

От там добавете нов календар тип (друг→) CalDAV. За потребителско име въведете anonymous@aaa.bapha.be с произволна парола и за сървър aaa.bapha.be .

Внедряване в Gnome Evolution

Evolution е програма за работа с календари и електронна поща под Linux. Избете Файл → Нов → Collection Account → Advanced Options. За сървър въведете aaa.bapha.be, не въвеждайте потребителско име. „Look up“ → Следващ → Следващ → Finish. Погледнете в менюто Изглед → Прозорец → Календар (Ctrl+3).

Внедряване в Google календара

Посетете calendar.google.com. В ляво горе изберете хамбургер-знака ☰, след това „Други календари“ → +→ „От URL адрес“. За адрес въведете или https://aaa.bapha.be/a.ics (събития от миналото и бъдещето) или https://aaa.bapha.be/f.ics (само бъдещи събития).

Google календарът не показва картинките и URL адреса към събитията.

След като свързаните Android устройства се усетят, че е добавен нов източник на данни, в тях може да бъде настроено да показват допълнителния календар.

Внедряване в Live/Hotmail/Outlook.com календара

Посетете calendar.live.com и изберете от ляво „+ Добавяне на календар“ → „Абониране от уеб“. За адрес въведете или https://aaa.bapha.be/a.ics (събития от миналото и бъдещето) или https://aaa.bapha.be/f.ics (само бъдещи събития).

Внедряване в Micrsoft Outlook

Инсталирайте приставката CalDAVSynchronizer. Добавете нов профил. За потребилско име използвайте anonymous@aaa.bapha.be с произволна парола, за посока на синхронизиране изберете Сървър → Outlook, с WebDAV синхронизиране, само календари.

Внедряване в Mozilla Thunderbird

Thunderbird е програма за работа с календари и електронна поща под Windows, Linux и Mac OS. От менюто „Инструменти“ → „Добавки“ инсталирайте добавките TbSync и DAV-4-TbSync/Provider for CalDAV and CardDAV, за да добавите към Thunderbird възможност да открива календари при зададено потребителско име или име на сървър.

След това от най-долу дясно изберете „TbSync” или алтернативно изберете от менюто (за версия 68) Инструменти → Настройки на добавките → Настройка на синхронизациите (TbSync) или (за версия 78) Редактиране → Настройка на синхронизациите (TbSync). От прозореца долу изберете „Действия с регистрацията“ → Добавяне на регистрация → CalDAV и CardDAV → „Ръчно настройване“. За CalDAV сървър въведете https://aaa.bapha.be/dav/calendars , задайте име на регистрацията и пропуснете потребителското име и CardDAV сървър. „Напред“ → „Завършване“. Маркирайте „Включване на регистрацията и синхронизиране“. Изберете календарите и след това „Синхронизирай сега“. Затворете прозореца. При избиране на меню „Събития и задачи“ → Календар се показват календарите и събитията.

Понякога се връщайте към прозореца „ТВ Sync Управление на регистрацията“ и избирайте върху регистрацията „Синхронизиране на регистрацията“, за да разбере Thunderbird за нови календари добавени на сървъра.

Внедряване във vdirsyncer

vdirsyncer може да синхронизира чрез CalDAV данните от сървъра на Linux компютър. За да я използвате създайте файл bapha_config съдържащ
[general]
status_path = "status"

[storage local]
type = "filesystem"
path="bapha"
fileext = ".ics"
implicit=["create", "delete"]

[pair p]
a = "remote"
b = "local"
collections = ["from a"]
metadata = ["color", "displayname", "order"]
conflict_resolution = "a wins"

[storage remote]
type = "caldav"
url = "https://aaa.bapha.be/dav/calendars/user/aaa@bapha.be/"
read_only = true
и изпълнете vdirsyncer -c bapha_config discover --no-list && vdirsyncer -c bapha_config metasync --max-workers=1 && vdirsyncer -c bapha_config sync --force-delete.

Програмата не показва какво има във файловете. Подходяща е за организациии, които искат да изтеглят и пре-публикуват автоматично въведените вече събития.

Внедряване в Windows

За да се покажат CalDAV данните във вградения в Windows календар трябва да се мине по заобиколен път. Отворете „Настройки“ → „Акаунти“ → „Имейл и акаунти“ → „+ Добавяне на акаунт“ → „iCloud“. За имейл адрес въведете anonymous@aaa.bapha.be и произволна парола → „Готово“. След като е „готово“ изберете „Управление“. Ако Windows е променил потребителското име, въведете отново anonymous@aaa.bapha.be. От промяна на настройките изберете „Опции за синхронизиране“. Изключете Емайл и Контакти, оставете Календари. Изберете „Разширени настройки за пощенска кутия/Настройка на сървър за контакти и календара (CalDAV)“. За сървър на календара въведете https://aaa.bapha.be/. „Готово“ → „Запиши“. След малко в програмата „Календар“ ще се покажат отделните календари и събитията.

Внедряване в Yahoo календара

Посетете calendar.yahoo.com и изберете „Действия ⌄“ → „Следване на други календари“. За iCal адрес въведете или https://aaa.bapha.be/a.ics (събития от миналото и бъдещето) или https://aaa.bapha.be/f.ics (само бъдещи събития).

Yahoo календарът не показва картинките към събитията.

Добавяне на нови събития

Добавянето на нови събития се извършва от поддържащите календара администратори. Те определят как да им се предоставя информация за нови, променени, отменени събития: по телефон, с посещение, свободен текст или iCalendar файл по електронна поща. Най-лесният начин да се изпрати iCalendar файл е да се създаде събитие в програма за календари и там да се добави като „участник“ електронният адрес на администратора на календара. Така събитието се изпраща автоматично по електронна поща в iCalendar формат, след като се съхрани. Bapha.be не предоставя интернет страница за вкарване на събития от потребители.

Към събитията може да се приложат и картинки до 200кб. Картинките се показват на https://aaa.bapha.be и https://aaa.bapha.be/t без са им се променя размерът.

Сървърът опреснява данните на всеки час: въведени или променени събития не се показват веднага на aaa.bapha.be.

Многоезичност

Събитията съдържат произволен текст, вкл. Unicode картинки (емоджи). Ако в едно събитие текстът е написан на няколко езика, тогава е вероятно само текстът в началото на събитието да бъде прочетен. За да се публикува събитие на няколко езика, може да се създаде отделен календар по всички чуждоезични въпроси, по отделен календар за всеки широко използван език. Препоръчително е да се въведе за всеки език отделно събитие.

Какво е CalDAV

За съхраняване на информация за мероприятия по начин, работещ с различни програми, е създаден формат наречен iCalendar. В него за всяко събитие може да се запише: обобщение, описание, начало, край, интернет страница, формула за повторение (като всяка втора сряда), място, категории, (отменен) статус, цвят, да се прикачи файл (картинка). iCalendar форматът не предвижда да се въвежда информация едновременно на различни езици или да се използва HTML.

За разпространяване на данните, съхранени в iCalendar формат, може да се използва протокола CalDAV. В него се създават различни календари и всеки календар съдържа събития. Свойства на всеки календар са: име, описание, цвят, URL адрес, какви обекти може да съдържа. Обектите могат да бъдат „Събития“, „Бележки“, „Задачи“. Сайтът за потребители aaa.bapha.be показва само събитията. И календарите и всяко събитие могат да имат собствен цвят. Програмите за показване на събития могат да използват цвета на събитието, вместо цвета на календара.

Например на https://bapha.be единият календар има име „Български“, описание „Натиснете върху цветните кръгчета, за да скриете календари.“, зелен цвят, адрес https://bapha.be/dav/calendars/user/k@bapha.be/bg/ и може да съдържа обекти от тип „Събития“ и „Бележки“. Някои свойства на календарите от https://aaa.bapha.be могат да се видят на https://bapha.be/dav/calendars/user/aaa@bapha.be след въвеждане на потр. име aaa@bapha.be и парола abc.

Програмите, които разбират CalDAV, периодично разпитват сървърите и изтеглят само промените от последното синхронизиране. Някои програми автоматично опресняват списъка с календари от сървърите, други трябва ръчно да се подканят.

Какво е WebCAL

По-опростен механизъм за разпространение на събития е създаването на голям файл, съдържащ много събития. Bapha.be предлага два такива файла: https://aaa.bapha.be/f.ics (съдържащ събитията от бъдещето) и https://aaa.bapha.be/a.ics със събитията от миналото и бъдещето.

При натискане на webcal://aaa.bapha.be/f.ics или webcal://aaa.bapha.be/a.ics някои програми направо се записват за календара и обновявават самоинициативно информацията в бъдеще.

Bapha.be предлага използване на най-доброто от съществуващи стандарти за разпространение на информация за събития. С времето стандартите се разширяват да покриват нови потребности. Процесът по разширяване на стандарт отнема много писане и много време.

Предимство на WebCAL сравнено с CalDAV е, че записването за получаване на промени може да стане с едно натискане и интеграцията работи с повече програми. Недостатъкът е, че при промяна се прехвърля един голям файл с всички събития, вместо само промените от предишното синхронизиране.

За администратори

Насоки

Колко и какви календари да бъдат създадени е въпрос на личен вкус. Примерни календари могат да бъдат „Спорт“, „За децата“, “Кино“, „Курсове“, “Профилактика“, „⚐ DE|EN|FR|РУ“ (English|Deutsch|française|Русский -Календар за чужденци), „Култура“, „Некултурен календар“, „Изложби и музеи“, „Образование“, „Клубове по интереси“, „Други“, „Незначителни”.

Чрез сайта гостите и жителите се информират какво могат да посетят в даден ден. При изложби е разумно да се въведе едно събитие от много дни: начало и край на изложбата. Въвеждане на еднотипни събития за всеки работен ден (от 10ч до 17ч) с еднакво описание води до претрупване. При рамкови събития, състоящи се от под-събития (н.пр. кино фестивал с много прожекции) е разумно да се въведе всяко под-събитие с описание като отделно събитие. Така може да се получи информация за всичко случващо се, без да трябва да се отваря допълнителен сайт за рамковото събитие. Когато рамковото събитие е далеч във времето с още мъглява програма е резонно то да се въведе с начало и край.

Включването на събития с непълна информация, като пропускане на такси за участие, прилагане на картинки изписващи „безплатно“, когато има такси, или предлагане на безплатни неща само ако се дадат пари, са подвеждащи съобщения, които дългосрочно водят до намалено доверие в източника на информация.

Отказани събития могат да бъдат изтрити, но могат и да останат в календара със статус „отменено“. При времево преместване на събитие може на старото събитие да се променят параметрите и то така да бъде преместено. А може и да се направи ново събитие: старото събитие си остава със статус „отменено“ и заглавие „Преместено: …“, като в описанието му се съдържа препратка към новото събитие.

Съобщенията за събития са реклама. Рекламата е както за организатора, така и за селището. Какви са изискванията нещо да бъде публикувано като събитие, всеки администратор определя сам. Нaпример тематични вечери в бар може да не се публикуват, както и съобщения съдържащи думата „само“ или превъзходна форма.

Параметърът към събитията „Статус: вероятно ще се случи“ следва да се използва рядко. Използване на параметрите „Статус: потвърдено“, Приоритет, Клас, Напомняния, които ще изкачат при потребителите, не се препоръчват.

Приемане на информация за събития

Най-лесно е потребителите (организаторите) сами да създават събитието в iCalendar формат и да го изпратят на администратора като „покана“. Администраторът приема поканата, като я съхранява в календар и с това се приключва. За да създадат и изпратят iCalendar файла потребителите разписват събитията в използваната от тях програма за календари и добавят електронния адрес на администратора като участник.

Този най-лесен вариант си има особености. За да работи е нужно или програмата за календарите и програмата за електронна поща да се сработят или да се използва една и съща програма за четене на електронна поща и за управления на събитията. Такива програми са Gnome Evolution, Microsoft Outlook, Mozilla Thunderbird. След като събитието влезе в календара, всички получаващи данни за календара в машинни формати ще видят твореца на събитието като организатор и администратора като участник. Участникът няма право да прави промени по събитията, вкл. да променя текст. Когато организаторът промени събитието и така изпрати нова покана, а участникът я приеме, старото събитие ще бъде заменено с новото.

Този процес се използва често вътрешно в организации. Bapha.be предлага този процес да се прилага отвъд границите на едно юридичеко лице.