Programu-jalizi kamili ni ya Grav CMS. Inasoma Faili za Kalenda ya ICS na inaonyesha Matukio katika Wijeti ya Kalenda ya kila mwezi kwenye Ukurasa wako (pamoja na Picha Maalum za Mwezi (ikiwa inapatikana kwenye folda ya ukurasa wa kalenda):

Ufungaji
Kuweka programu-jalizi ya Fullcalendar kunaweza kufanywa kwa njia moja wapo. Njia ya usakinishaji ya GPM (Meneja wa Kifurushi cha Grav) hukuwezesha kusanikisha programu-jalizi haraka na kwa urahisi na amri rahisi ya wastaafu, wakati njia ya mwongozo hukuwezesha kufanya hivyo kupitia faili ya zip.

Usakinishaji wa GPM (Unapendelea)
Njia rahisi ya kusanikisha programu-jalizi hii ni kupitia Meneja wa Kifurushi cha Grav (GPM) kupitia terminal ya mfumo wako (pia inaitwa laini ya amri). Kutoka kwa mzizi wa aina yako ya usakinishaji wa Grav:

bin / gpm funga kalenda kamili
Hii itaweka programu-jalizi kamili kwenye saraka yako ya / mtumiaji / programu-jalizi ndani ya Grav. Faili zake zinaweza kupatikana chini ya / yako / tovuti / grav / mtumiaji / programu-jalizi / kalenda kamili.

Ufungaji wa Mwongozo
Ili kusanikisha programu-jalizi hii, pakua tu toleo la zip la hazina hii na uifungue chini ya / yako / tovuti / grav / mtumiaji / programu-jalizi. Kisha, badilisha folda hiyo kuwa kalenda kamili. Unaweza kupata faili hizi kwenye GitHub au kupitia GetGrav.org.

Sasa unapaswa kuwa na faili zote za programu-jalizi chini

/ yako / tovuti / grav / mtumiaji / plugins / fullcalendar
KUMBUKA: Programu-jalizi hii ni sehemu ya msimu wa Grav ambayo inahitaji Grav na Kosa na Matatizo Plugins kufanya kazi.

Programu-jalizi ya Usimamizi
Ikiwa unatumia programu-jalizi ya msimamizi, unaweza kusanikisha moja kwa moja kupitia programu-jalizi ya msimamizi kwa kuvinjari kichupo cha Programu-jalizi na kubonyeza kitufe cha Ongeza.

Usanidi
Kabla ya kusanidi programu-jalizi hii, unapaswa kunakili mtumiaji / plugins / fullcalendar / fullcalendar.yaml kwa mtumiaji / config / plugins / fullcalendar.yaml na uhariri tu nakala hiyo.
Kumbuka kuwa ukitumia programu-jalizi ya msimamizi, faili iliyo na usanidi wako, iliyoitwa fullcalendar.yaml itahifadhiwa katika mtumiaji / usanidi / programu-jalizi / folda mara tu usanidi ukihifadhiwa kwenye msimamizi.
Pia kuna UI rahisi katika backend ya admin ambayo hutoa upendeleo wa kimsingi.

Hapa kuna usanidi wa msingi na ufafanuzi wa chaguzi zinazopatikana:

kuwezeshwa: kweli
rangi: "# 3a87ad" # angalia Kumbuka juu ya rangi maalum kwenye Changelog, hakikisha utumie nukuu moja au mbili karibu na orodha!
showlegend: # ya uwongo imewekwa kuwa kweli kuonyesha Majina ya faili ya kalenda kama Legend chini ya gridi ya taifa
Nambari za wiki: uwongo # imewekwa kuwa kweli kuonyesha Nambari za Wiki
cors_api_url: # Thamani chaguomsingi sasa haina kitu kwani proksi wa zamani uliotumika hapo awali, https://cors-anywhere.herokuapp.com/, haitafanya kazi tena
addJquery: uwongo # Ongeza mali ya JQuery ikiwa Mandhari yako hayatafanya hivi
Matumizi
Mara tu ikiwa imewekwa na kuwezeshwa, unaweza kutumia programu-jalizi hii kuchanganua faili za Kalenda za ICS (hizi lazima zipatikane kwa mtumiaji / data / kalenda na uweke kama kigezo katika njia fupi ya Plugin, bila Njia!) Na onyesha Matukio kutoka kwa Kalenda hizo. mahali popote kwenye Tovuti yako kwa kutumia njia fupi:

katika ukurasa unaofaa (angalia nukuu mbili "zinazozunguka jina la faili - nukuu moja 'hazitafanya kazi!)
Unaweza pia kutoa URL kamili kwa Faili za ICS, kwa hali hiyo wakala wa CORS atatumika kuzipata.
Kama nyongeza, unaweza kuonyesha Picha ya mwezi wa sasa juu ya wijeti ya kalenda.
Weka tu Picha 12 zilizoitwa 'January.jpg', 'February.jpg', ..., 'December.jpg' kwenye Folda ya Ukurasa wako ambapo Kalenda itawekwa. (Kumbuka kuwa majina ya Faili ya Picha lazima yalingane na majina ya Mwezi kulingana na mpangilio wa eneo lako, kwa hivyo, kwa eneo: de, tumia 'Januar.jpg' ...).
Kutoka kwa Toleo la 0.2.6, inawezekana pia kuacha tu Faili za kalenda kwenye folda yako ya ukurasa, zitachukuliwa na kutumiwa kama zile zilizo kwenye / mtumiaji / data / kalenda.
Ikiwa utatumia faili za kalenda tu kwenye folda ya ukurasa, hakikisha kuingiza njia ya mkato tupu:

katika yaliyomo kwenye ukurasa wako, vinginevyo hayatafanya kazi!
Pia kumbuka, kwamba kutoka v 0.2.8, Programu-jalizi itafanya kazi tu ikiwa utatumia templeti ya calendar.html.twig kutoka kwa programu-jalizi (au nakala iliyobadilishwa kwenye Folda yako ya Mada) kwa ukurasa wa kalenda - hii inaweza kufanywa kwa mikono au kwa backend ya admin kwa kuchagua 'Kalenda' katika kushuka kwa templeti ya ukurasa.
Kwa kuongezea, inapaswa kuzingatiwa kuwa Programu-jalizi hii hutegemea nyuki ya jQuery iliyobeba na Mandhari (Mada nyingi hufanya hivi) - ikiwa utatumia Mandhari ambayo haifanyi hivi, sasa kuna (kutoka v 0.2.10) Chaguo la usanidi kutatua Tatizo hili: weka tu addJquery kuwa kweli.

Matumizi ya hali ya juu
Kama nyongeza ya kesi ya kawaida ya matumizi, kuna njia nzuri ya kusasisha faili zako za .ics kutoka kwa Kalenda za mbali ikiwa hizo zitashikiliwa kwenye Seva ya CalDav (kwa mfano Owncloud, Nextcloud ...):
Katika kesi hii, unaweza kutumia tu caldav2ics kupitia kazi ya cron au Mpangilio wa Grav kusasisha otomatiki Faili zako za ics zilizoonyeshwa na Programu-jalizi ya Kalenda, ili yaliyomo kwenye Kalenda ya mbali, kawaida huhifadhiwa katika Programu tofauti za Kalenda (kama Google Kalenda au Umeme) kiatomati imeenezwa kwa Wavuti yako.

Vivyo hivyo ni kweli ikiwa utaweka grav-plugin-caldav2ics ambayo imejumuishwa kikamilifu katika Grav na ina Admin Backend nzuri kwa usanidi rahisi.

Masuala ya CORS:
Kuanzia Mwanzo 2021, niligundua, kwamba Wakala wa nje wa CORS (herokuapp, tazama hapo juu) haitafanya kazi tena kwa matumizi ya umma, angalia Thread hii ya msaada. Kwa hivyo niliamua kutekeleza Wakala wa ndani wa CORS, ambayo inapatikana kutoka kwa v 0.2.8. Kwa visa vingi vya utumiaji, URL tupu ya Cors API katika mipangilio inapaswa kuwa sawa, ikiwa tu Ufungaji wako wa Grav hauko kwenye mzizi wa wavuti, utahitaji kubadilisha hii.
Kidokezo: URL iliyotathminiwa kiatomati (iliyoundwa wakati Cors API URL haina tupu - kwa hivyo, wakati wa kusasisha, hakikisha kufuta URL ya zamani ya herokuapp ikiwa iko) kawaida ni http: //yourdomain/user/plugins/fullcalendar/proxy.php/ ambayo itafanya kazi ikiwa Ufungaji wa Grav uko kwenye wavuti, ikiwa sivyo, kwa mfano Grav imewekwa kwenye Subdirectory grav, utahitaji http: //yourdomain/grav/user/plugins/fullcalendar/proxy.php/.

Mikopo
Programu-jalizi hii imejengwa kwenye fullcalendar.io, jakubroztocil / rrule na jsical - Javascript parser ya rfc5545

Kufanya
Tekeleza kanuni za EXDATE / EXRULE
Kuboresha kulijumuisha Fullcalendar.io hadi Toleo la 5 (kwa sasa: Toleo la 4)