Povezivanje s mrežnom stranicom župe

Župa koja ima vlastitu mrežnu stranicu može na njoj prikazivati raspored misa izravno iz Matice. Raspored se ne prepisuje ručno: mijenjate ga u Matici kao i dosad, a na stranici se osvježi sam.

Postoje tri načina; svi koriste iste podatke i svi se uključuju na istom mjestu.

Način	Za koga	Kako izgleda
Widget (dva retka koda)	bilo koja stranica — WordPress, Wix, Jimdo, ručno izrađena	popis misa ugrađen u stranicu
WordPress dodatak	stranice na WordPressu	blok ili kratki kod; bolje za tražilice
Pretplata na kalendar (iCal)	Google/Apple/Outlook kalendar	mise se pojave u kalendaru

Preduvjet: imate ulogu Administrator ili Župnik. Za samu ugradnju na stranicu treba vam i osoba koja tu stranicu održava.

Koraci

1. Na Admin izborniku otvorite Postavke sustava → Vidljivost javnih modula i pomaknite se do odjeljka Povezivanje s mrežnom stranicom. Na početku je sve isključeno — Matica ne objavljuje ništa prema van dok to ne zatražite.

   

2. Uključite Sadržaj za mrežnu stranicu. To je glavni prekidač; dok je isključen, ostali prekidači u odjeljku miruju i ništa se ne objavljuje.

3. Uključite Raspored misa. Time postaju dostupni dan, datum, vrijeme i crkva svake mise s javnog rasporeda.

4. Po želji uključite Uključi nakane. Zadano je isključeno jer nakana redovito navodi ime žive ili pokojne osobe. Ovo je odvojena odluka od one za vlastiti javni raspored u Matici (odjeljak Javni raspored misa iznad): vašu mrežnu stranicu može pročitati i kopirati bilo tko, pa Matica traži da to potvrdite posebno.

5. Čim uključite prekidače, ispod njih pojave se tri adrese i gotov isječak koda. Uz svaku je ikona za kopiranje.

   

6. Isječak koda (ili adrese) proslijedite osobi koja održava vašu mrežnu stranicu. Ona ga zalijepi na stranicu na kojoj se raspored treba pojaviti — vidjeti Za osobu koja održava stranicu.

Uspješno ako

Na mrežnoj stranici župe pojavi se popis misa grupiran po crkvama, a izmjena rasporeda u Matici vidljiva je ondje najkasnije za pet minuta.

Što koja adresa znači

Adresa	Sadrži
Podaci o župi (JSON)	naziv župe, vremensku zonu, uredovno vrijeme, kontakt ureda i popis crkava s adresama
Raspored misa (JSON)	mise: datum, vrijeme, crkva, vrsta slavlja (i nakana, ako ste je uključili)
Raspored misa kao pretplata na kalendar (iCal)	isti raspored u obliku koji razumiju Google, Apple i Outlook kalendar

Adrese su javne i ne traže prijavu — to je i smisao: tuđa stranica nema korisnički račun u Matici.

Kako izgleda na stranici

Popis je grupiran po crkvama, a unutar crkve po danima; u retku stoji dan, datum i vrijeme. Župa s jednom crkvom ne dobiva naslove crkava. Widget preuzima pismo i boje stranice na koju je zalijepljen, pa se uklopi u postojeći izgled.

Za osobu koja održava stranicu

Widget (bilo koja stranica)

Dva retka na mjesto gdje se raspored treba pojaviti:

<script src="https://vasa-zupa.matica.app/embed/matica-widgets.js" defer></script>
<matica-masses days="7"></matica-masses>

Adresu iz isječka ne treba mijenjati — već pokazuje na vašu župu.

Postavke se pišu kao atributi:

Atribut	Zadano	Značenje
days	7	koliko dana unaprijed (1–92)
limit	50	najviše stavki (1–500)
church	sve crkve	prikaži samo jednu crkvu (identifikator iz adrese „Podaci o župi”)
lang	jezik župe	jezik naziva, npr. de
heading	—	naslov iznad popisa
show-type	isključeno	"true" dodaje vrstu slavlja („Nedjeljna misa”) i oznake
show-intentions	uključeno	"false" skriva nakane koje Matica šalje
attribution	uključeno	"false" miče poveznicu na cijeli raspored

Izgled se podešava CSS varijablama (--matica-font, --matica-color, --matica-accent, --matica-border, --matica-radius, --matica-gap) ili preko ::part() za pojedine dijelove (time, title, day-name, church-name, intention, badge, footer, link, source). Širina i visina postavljaju se običnim CSS-om na sam element; visina se ne mora zadavati jer widget raste sa sadržajem. Potpuni popis je u datoteci docs/EmbeddableWidgets.md u repozitoriju aplikacije.

WordPress

Ako je stranica na WordPressu, bolji je dodatak Matica Mass Schedule: raspored se tada ispisuje na poslužitelju, pa ga tražilice indeksiraju i vidljiv je i bez JavaScripta.

1. Instalirajte dodatak (Dodaci → Dodaj novi → Pošalji dodatak) i aktivirajte ga.

2. Postavke → Matica Mass Schedule → upišite adresu svoje Matice (npr. https://vasa-zupa.matica.app). Zaslon odmah javlja je li uspio pročitati raspored.

3. Na stranicu dodajte blok Raspored misa (Matica) ili kratki kod:

   [matica_mass_schedule days="7" heading="Raspored misa"]

Blok ima iste mogućnosti kao widget (broj dana, jezik, prikaz vrste slavlja, nakane, poveznica na cijeli raspored).

Pretplata na kalendar (iCal)

Adresu koja završava na .ics zalijepite u Google Calendar → Drugi kalendari → Pretplati se putem URL-a (ili u Apple/Outlook kalendar). Pretplata obuhvaća protekla dva tjedna i sljedeća četiri mjeseca i sama se osvježava.

Što se nikad ne objavljuje

Prema mrežnoj stranici nikad ne idu:

• predslavitelj (tko misu slavi),
• bilješke uz misu (pisane za župni ured),
• bilo koji podatak o registriranim korisnicima ili članovima župe.

Jedina iznimka koju možete uključiti jest nakana, i to izričitim prekidačem iz 4. koraka. Ako ga ne uključite, nakane ostaju samo u Matici.

Napomena

Uključen sadržaj može pročitati bilo tko na internetu i mogu ga indeksirati tražilice. To je namjera — isto vrijedi za raspored koji objavite na oglasnoj ploči — ali je razlog zašto je sve u ovom odjeljku na početku isključeno.

Osvježavanje i predmemorija

• Promjena rasporeda u Matici vidi se na stranici unutar pet minuta (Matica čuva odgovor pet minuta), a kod posjetitelja koji je stranicu već otvorio još do pet minuta dulje dok mu preglednik ne osvježi svoju kopiju.
• WordPress dodatak dodatno čuva raspored 10 minuta (podesivo na njegovom zaslonu postavki).
• Ako vam treba odmah, osvježite stranicu nakon pet minuta; ranije nema učinka.

Isključivanje

Isključite Sadržaj za mrežnu stranicu i Matica prestaje odgovarati na sve tri adrese istog trena — widget na stranici tada ne prikazuje ništa (ne prikazuje poruku o pogrešci). Kopije koje su posjetitelji već preuzeli nestaju kad im istekne predmemorija preglednika, najkasnije za pet minuta.

Pojedinačno isključivanje Rasporeda misa ostavlja podatke o župi dostupnima, a isključivanje Uključi nakane miče samo nakane.

Rješavanje problema

Znak	Uzrok i rješenje
Na stranici se ne prikazuje ništa	Prekidači su isključeni ili je isječak zalijepljen na krivo mjesto. Provjerite 2. i 3. korak; u WordPressu zaslon postavki dodatka javlja točan razlog.
Piše „ova župa još ne objavljuje raspored” (WordPress)	Glavni prekidač ili Raspored misa nisu uključeni.
Popis je prazan, a mise postoje	Za razdoblje koje ste tražili nema misa (days), ili su te vrste slavlja označene kao skrivene s javnog rasporeda (npr. krštenja izvan mise).
Nakana se ne prikazuje	Uključi nakane nije uključeno, ili misa nema upisanu nakanu.
Nazivi slavlja u krivom jeziku	Matica koristi traženi jezik, a ako prijevoda za neku vrstu slavlja nema, vlastiti jezik župe. Prijevode dopunite u Vrste misa.
Promjena se ne vidi	Pričekajte pet minuta (vidjeti „Osvježavanje i predmemorija”).

Povezane upute

• Vidljivost modula — isti zaslon, ostali prekidači.
• Javni raspored misa — što župljani vide u samoj Matici.
• Vrste misa — nazivi slavlja, prijevodi i skrivanje s javnog rasporeda.