iCalendar ir prenumeratos

TimelyChurch gali tiek publikuoti jūsų bažnyčios kalendorių išoriniam pasauliui (kad jūsų svetainės lankytojai ir nariai galėtų prenumeruoti jį savo asmeninėje kalendoriaus programoje), tiek importuoti kitus kalendorius (kad įvykiai iš konfesijos, partnerio ar bendruomenės kalendoriaus atsirastų TimelyChurch sistemoje).

Šis straipsnis apima tris glaudžiai susijusias, bet atskiras funkcijas:

1. Viešo kalendoriaus įterpimas -- „iframe" valdiklis, kurį įdedate į savo bažnyčios svetainę.
2. Išsiunčiami iCal srautai -- Gyvi .ics URL adresai, kuriuos gali prenumeruoti Apple Calendar, Google Calendar ir Outlook.
3. Įeinančios kalendoriaus prenumeratos -- Renginių traukimas iš išorinių .ics URL adresų į TimelyChurch pagal tvarkaraštį.

Patarimas: Vienkartiniams .ics eksportams vienam renginiui, vienai serijai ar datos intervalui, žr. skyrių iCalendar eksportas ir importas. Ten esantis eksportas yra statinė momentinė kopija. Šio straipsnio prenumeratos srautai lieka gyvi ir atsinaujina, keičiantis renginiams.

1. Viešo kalendoriaus įterpimas

Viešas kalendorius yra atskiras valdiklis, kurį galite įterpti į savo bažnyčios svetainę naudodami „iframe". Lankytojai gali naršyti visus jūsų viešus renginius be paskyros.

Įterpimo URL

https://your-app-domain.com/c/{churchSlug}/calendar

Užklausos parametrai

Įterpimas priima šiuos neprivalomus užklausos parametrus, kad pritaikytumėte, ką mato lankytojai:

Įterpimo kodo pavyzdys

<iframe
  src="https://your-app-domain.com/c/grace-community/calendar?types=worship,event&view=month"
  width="100%"
  height="700"
  frameborder="0"
  title="Grace Community Calendar">
</iframe>

Ką mato lankytojai

Įterpime rodomi tik renginiai, pažymėti ir kaip Vieši, ir kaip Aktyvūs, filtruoti pagal parametrą types ir šiuo metu peržiūrimą datos intervalą. Spustelėjus renginį, atsidaro jo vieša informacijos puslapis.

2. Išsiunčiami iCal srautai (prenumerata iš išorės)

Jūsų bažnyčios kalendorius pateikiamas kaip gyvas iCalendar srautas dviem URL adresais:

Abu srautai apima renginius nuo prieš mėnesį iki metų į priekį, apsiribojant tik viešais, aktyviais renginiais.

Prenumerata „Apple Calendar" (macOS / iOS)

1. Nukopijuokite savo bažnyčios prenumeratos URL: https://your-app-domain.com/c/grace-community/calendar.ics
2. Mac: Atidarykite Calendar, tada pasirinkite File > New Calendar Subscription.... Įklijuokite URL ir spustelėkite Subscribe.
3. iOS: Atidarykite Settings > Calendar > Accounts > Add Account > Other > Add Subscribed Calendar. Įklijuokite URL ir bakstelėkite Next.
4. Nustatykite automatinio atnaujinimo intervalą (Apple rekomenduoja kas 1 valandą arba kasdien).

Prenumerata „Google Calendar"

1. Naršyklėje atidarykite Google Calendar.
2. Kairėje šoninėje juostoje po Other calendars spustelėkite piktogramą + ir pasirinkite From URL.
3. Įklijuokite prenumeratos URL: https://your-app-domain.com/c/grace-community/calendar.ics
4. Spustelėkite Add calendar.

Pastaba: Google Calendar atnaujina išorines .ics prenumeratas tik kas kelias valandas. Nesitikėkite, kad TimelyChurch pakeitimai iškart pasirodys Google sistemoje.

Šiam veiksmui naudokite kompiuterį. Google Calendar programėlė sistemose Android ir iPhone apskritai negali pridėti kalendoriaus pagal URL -- ši parinktis yra tik naršyklėje. Pridėkite prenumeratą kartą kompiuteryje, ir ji automatiškai pasirodys telefono programėlėje tame pačiame Google paskyroje. Tai dažniausia priežastis, kodėl kažkas mano, kad prenumerata neveikia: jie paliečia nuorodą telefone, Google nieko nedaro, ir jie galiausiai atsisiunčia vienkartinį failą.

Prenumerata „Microsoft Outlook" (kompiuteryje ar internete)

1. Outlook internete: Spustelėkite Add calendar > Subscribe from web. Įklijuokite prenumeratos URL ir spustelėkite Import.
2. Outlook kompiuterio programa: Pasirinkite Add Calendar > From Internet, įklijuokite URL ir spustelėkite OK.

Filtravimas pagal renginio tipą -- tik įterpimui

1 skyriuje aprašytas parametras types taikomas įterpimo puslapiui. Jis nefiltruoja .ics srautų: prenumerata visada apima kiekvieną viešą, aktyvų renginį lange. Jei jums reikia filtruoto srauto, praneškite apie tai palaikymo užklausoje, o ne pridėkite ?types= prie prenumeratos URL, nes tai tyliai ignoruojama.

Pagalba kam nors prenumeruoti

Prenumeruoti gali bet kas. TimelyChurch paskyra ar prisijungimas nereikalingas -- srautas yra viešas, ir asmeniui, kuriam jį siunčiate, nereikia būti nariu, prisijungti ar ką nors kurti.

Jei kažkas sako „jis tik atsisiuntė renginius, jis neatsinaujina", beveik visada priežastis viena iš šių:

Kelias, kuris visada veikia, kiekviename įrenginyje ir kiekvienoje programoje: nukopijuokite prenumeratos URL prenumeratos lango apačioje ir įklijuokite jį į kalendoriaus programos lauką Add calendar / From URL / Subscribe.

Pakeitimai, kuriuos atliekate TimelyChurch sistemoje, pasiekia prenumeratorius pagal jų pačių programos atnaujinimo tvarkaraštį, ne akimirksniu. Ypač Google gali užtrukti kelias valandas. Tai Google elgsena, o ne vėlavimas iš mūsų pusės.

3. Įeinančios kalendoriaus prenumeratos (traukimas į TimelyChurch)

Taip pat galite prenumeruoti išorinį kalendoriaus srautą TimelyChurch sistemai. Tai naudinga, kai:

• Konfesijos institucija publikuoja bendrą renginių kalendorių.
• Partnerystės bažnyčia nori pasidalinti su jumis savo kalendoriumi.
• Norite, kad šalia jūsų paties atsirastų bendruomenės/pilietinių renginių kalendorius.

Išoriniai renginiai importuojami į TimelyChurch ir rodomi jūsų administratoriaus kalendoriuje. Jie taip pat gali būti automatiškai publikuojami jūsų viešame kalendoriuje.

Kur tvarkyti prenumeratas

Administratoriaus srityje pereikite į Nustatymai > Kalendoriaus prenumeratos.

Prenumeratos pridėjimas

Spustelėkite Pridėti prenumeratą ir užpildykite:

Kai išsaugote, TimelyChurch patikrina, ar URL pasiekiamas ir turi galiojančius iCalendar duomenis, tada iškart paleidžia pirmąją sinchronizaciją.

Kaip veikia sinchronizacija

• Kiekviena prenumerata turi sinchronizavimo intervalą, kuris nustato, kaip dažnai TimelyChurch iš naujo gauna srautą.
• Sinchronizacijos metu renginiai iš išorinio srauto suderinami pagal UID. Nauji renginiai sukuriami, esami renginiai atnaujinami, o renginiai, kurie dingsta iš šaltinio, ištrinami.
• Importuoti renginiai pažymimi prenumerata, todėl visada galite atskirti, kurie yra vietiniai, o kurie -- išoriniai.
• Spustelėkite Sinchronizuoti dabar bet kurioje prenumeratoje, kad priverstumėte iškart atnaujinti.

Prenumeratos šalinimas

Kai ištrinate prenumeratą, pasirenkate, kas nutiks jos importuotiems renginiams:

• Palikti importuotus renginius -- Atskirti renginius nuo prenumeratos, kad jie taptų įprastais vietiniais renginiais.
• Ištrinti importuotus renginius -- Pašalinti visus renginius, kilusius iš šios prenumeratos.

Saugumo pastabos

• Kalendoriaus prenumeratas gali tvarkyti tik naudotojai, turintys leidimą Kalendoriaus funkcijai.
• Išorinio srauto URL adresai patikrinami prieš juos pridedant, todėl šia funkcija negalima piktnaudžiauti norint pasiekti savavališkus URL adresus.

Tinkamo įrankio pasirinkimas