Hlídač novinek ZŠ Londýnská

Hlídá web londynska.cz (ZŠ Londýnská, Praha) a pošle vám e-mail, když škola zveřejní něco nového. Nemusíte tak web každý den kontrolovat sami. Stačí zadat e-mail a ročníky svých dětí.

Co hlídač sleduje

• Nejnovější zprávy — novinky vybraného ročníku, nebo celé školy (když žádný ročník nevyberete)
• Velmi důležité zprávy — důležitá oznámení, týkají se vždy celé školy (lze vypnout, ale doporučujeme nechat zapnuté)
• Akce na tento den — volitelně; akce se mění každý den, takže e-mail pak chodí prakticky denně (proto je tato volba ve výchozím stavu vypnutá)

Jak si nastavit upozornění (krok za krokem)

Nastavení zabere asi 10 minut a nevyžaduje žádné technické znalosti. Kroky 1–4 rozjedou hlídače, krok 5 (plánovač) zajistí, že pak pracuje sám.

1. Založte si účet na Apify

Hlídač běží na platformě Apify. Registrace je zdarma (stačí e-mail nebo účet Google) a bezplatný tarif na tento hlídač bohatě stačí — nemusíte zadávat platební kartu.

Důležité: registrujte se e-mailem, na který chcete dostávat upozornění. Na bezplatném tarifu totiž Apify posílá e-maily jen na adresu vašeho účtu — je to ochrana proti spamu, ne chyba hlídače. Adresu někoho dalšího (partnera, prarodičů) tedy na free tarifu zadat nelze.

Už účet na Apify máte? Přihlaste se a použijte e-mail toho účtu. Když chcete upozornění na jinou adresu, máte dvě možnosti: založit si nový účet na požadovaný e-mail, nebo si v e-mailu nastavit přeposílání z účtové adresy na tu, kterou chcete.

2. Otevřete hlídače a vyplňte dvě pole

Otevřete hlídače na Apify:

→ apify.com/gearshift-data/londynska-novinky

Klikněte na Try for free (nebo Start, pokud už jste přihlášení). Hlídač se otevře v Apify Console. Na záložce Input vyplňte:

• E-mail pro upozornění — zadejte adresu, se kterou jste se registrovali na Apify. (Na bezplatném tarifu je to jediná adresa, kam lze doručovat; s placeným tarifem sem lze zadat libovolné adresy, max 20, oddělené čárkou.)

• Ročníky — vyberte ročník, do kterého chodí vaše dítě. Máte ve škole víc dětí? Vyberte v seznamu klidně několik ročníků najednou (např. 3. a 7.) — hlídač pak sleduje zprávy pro všechny vybrané ročníky a pošle je v jednom e-mailu, kde má každý ročník vlastní nadpis („Nejnovější zprávy — 3. ročník“). Víc e-mailů ani víc hlídačů nastavovat nemusíte.

  (Chodí-li dvě děti do stejného ročníku, stačí ten ročník vybrat jednou.)

  Nic dalšího není potřeba.

3. Vyzkoušejte testovací e-mail

Zapněte přepínač Poslat testovací e-mail a klikněte na Start. Do pár minut vám přijde e-mail s náhledem několika položek z každé sledované sekce — ověříte si, že vše funguje a jak budou upozornění vypadat. Potom přepínač zase vypněte.

Pokud e-mail nepřišel, zkontrolujte složku Spam/Hromadné a překlepy v adrese.

4. Spusťte první „ostré“ spuštění

Klikněte na Start ještě jednou (s vypnutým testovacím e-mailem). První spuštění si jen zapamatuje, co na webu už je, a žádný e-mail neposílá — jinak by vám hned přišlo všechno staré. Od dalšího spuštění už chodí jen skutečné novinky.

5. Nastavte automatické spouštění (plánovač)

Zatím jste hlídače spouštěli ručně. Aby pracoval sám, nastavte mu plánovač (anglicky Schedule) — ten ho spouští v zadaných časech za vás. Nastavuje se jednou a zabere asi 3 minuty.

Pozor na dvě věci, kvůli kterým plánovač lidem nejčastěji nefunguje:

• Nový plánovač je po vytvoření vypnutý. Musíte ho zapnout (krok 6 níže).
• Plánovač má vlastní kopii nastavení. Nepřebírá to, co jste vyplnili na záložce Input, takže e-mail a ročníky je potřeba zadat i tady (krok 4 níže).

Krok za krokem

1. Na stránce Actora klikněte vpravo nahoře na ⋯ (tři tečky) → Schedule Actor. Apify tím vytvoří nový plánovač a hlídače do něj hned vloží. (Druhá cesta: v levém menu Schedules → Create new. Pak ale hlídače musíte přidat sami — v kartě Actors and tasks klikněte na Add → Actor a vyberte tohoto hlídače.)

2. Pojmenujte plánovač — klikněte na jeho název nahoře a napište třeba hlidac-londynska. Název může mít 3–63 znaků, bez mezer a diakritiky.

3. Nastavte časy v kartě Schedule setup:

   • Timezone (časové pásmo) přepněte na Europe/Prague. Jinak by se časy počítaly v UTC a hlídač by v zimě běžel o hodinu a v létě o dvě hodiny dřív, než čekáte.
   • Cron expression je pole, do kterého se čas zapisuje pěti hodnotami oddělenými mezerou (např. 0 7,16 * * 1-5). Nemusíte tomu rozumět — najděte si níže v tabulce řádek, který vám vyhovuje, zkopírujte hodnotu z prostředního sloupce a vložte ji do pole Cron expression. Co v poli původně je, smažte.

   Nejčastěji doporučujeme 2× denně ve školní dny (0 7,16 * * 1-5) — ráno před školou a odpoledne po ní, a o víkendu vás hlídač neotravuje. Častější kontrola než pár × denně nemá smysl: škola novinky nepřidává po minutách.

   Jak často	Co vepsat do pole Cron expression	Kdy poběží
   2× denně, jen školní dny (doporučeno)	0 7,16 * * 1-5	7:00 a 16:00, pondělí–pátek
   2× denně, každý den	0 7,16 * * *	7:00 a 16:00, včetně víkendu
   1× denně ráno, jen školní dny	0 7 * * 1-5	7:00, pondělí–pátek
   1× denně ráno, každý den	0 7 * * *	7:00, každý den
   1× denně odpoledne	0 16 * * *	16:00, každý den
   3× denně, jen školní dny	0 7,12,17 * * 1-5	7:00, 12:00 a 17:00, pondělí–pátek
   Ráno v 6:30 (jiná minuta)	30 6 * * 1-5	6:30, pondělí–pátek
   Každou hodinu (víc, než je potřeba)	0 * * * *	v každou celou hodinu, i v noci
   Jen v pondělí ráno	0 7 * * 1	7:00 každé pondělí
   Jen v pátek odpoledne	0 15 * * 5	15:00 každý pátek
   1× týdně v nedělní podvečer	0 18 * * 0	18:00 každou neděli

   Pod polem Apify vypisuje, kdy poběží nejbližší spuštění (Next run) — vždy si tam zkontrolujte, že vypsaný čas odpovídá tomu, co jste chtěli. Je to nejrychlejší způsob, jak poznat překlep v zápisu.

4. Zadejte nastavení hlídače — v kartě Actors and tasks rozklikněte u hlídače Input (nebo Options) a vyplňte stejný e-mail a ročníky jako v kroku 2 tohoto návodu. Bez toho by plánovač spustil hlídače s prázdným nastavením a e-mail by nikam nedošel.

   Ověřte přitom, že Poslat testovací e-mail je vypnuté — jinak by vám dvakrát denně chodil testovací náhled místo skutečných novinek.

5. Uložte — tlačítko Save vpravo nahoře.

6. Zapněte plánovač přepínačem Enabled (nahoře na stránce plánovače). Dokud je vypnutý, nic se nespouští. Tohle je nejčastější důvod, proč e-maily nechodí.

Jak se cron čte (nepovinné)

Tuhle část si můžete přeskočit — tabulka výše stačí. Hodí se, když si chcete čas nastavit po svém.

Pět hodnot znamená po řadě: minuta, hodina, den v měsíci, měsíc, den v týdnu. Hvězdička * znamená „na tomhle mi nezáleží / vždy“.

0 7,16 * * 1-5
│ │    │ │ └── den v týdnu: 1-5 = pondělí až pátek
│ │    │ └──── měsíc: * = každý měsíc
│ │    └────── den v měsíci: * = každý den
│ └─────────── hodina: 7 a 16 (tedy 7:00 a 16:00)
└───────────── minuta: 0 (v celou)

Užitečné zápisy:

• Více časů oddělte čárkou: 0 7,16 * * * = 7:00 a 16:00
• Rozsah zapište pomlčkou: 0 7 * * 1-5 = pondělí–pátek
• Konkrétní minuta je první číslo: 30 6 * * * = 6:30
• Dny v týdnu se číslují: 1 = pondělí, 2 = úterý, 3 = středa, 4 = čtvrtek, 5 = pátek, 6 = sobota, 0 = neděle
• Vybrané dny taky čárkou: 0 7 * * 1,3,5 = pondělí, středa, pátek

Používejte celé hodiny nebo půlhodiny — nic častějšího než jednou za hodinu není potřeba, škola nepřidává novinky po minutách.

Jak si ověřit, že to funguje

Na stránce plánovače uvidíte Next run (kdy poběží příště) a po prvním automatickém spuštění i Last run. Když nastal čas prvního spuštění, otevřete v levém menu Runs — měl by tam být nový běh se zeleným stavem Succeeded.

E-mail dorazí jen tehdy, když škola opravdu něco nového zveřejnila. Zelený běh bez e-mailu tedy není chyba — znamená, že nic nového nebylo.

Když plánovač neběží

Co vidíte	Co s tím
Žádný běh se nespustil	Plánovač je vypnutý — zapněte přepínač Enabled
Běhy se spouští v jiný čas	Špatné časové pásmo — přepněte Timezone na Europe/Prague
Běh je zelený, ale e-mail nechodí	Buď nebylo nic nového (v pořádku), nebo v plánovači chybí e-mail (krok 4). Zkontrolujte i složku Spam
Běh skončil červeně (Failed)	Otevřete běh a podívejte se do Log. Pokud hlásí, že se nepodařilo načíst položky, škola změnila web — dejte vědět správci
Chodí testovací e-maily	V nastavení plánovače vypněte Poslat testovací e-mail (krok 4)

Pozdější změny

Plánovač najdete kdykoli v levém menu pod Schedules. Můžete v něm změnit časy, upravit e-mail nebo ročníky (např. na začátku školního roku, když děti postoupí do dalšího ročníku, nebo když nejstarší školu dokončí), nebo ho na dobu dovolených přepínačem Enabled vypnout a potom zase zapnout.

Hotovo! Od teď vám přijde e-mail vždy, když škola zveřejní něco nového. Když nic nového není, žádný e-mail nechodí.

Nastavení (přehled polí)

Pole	Výchozí hodnota	Význam
E-mail pro upozornění	— (prázdné)	Free tarif: adresa vašeho Apify účtu. Placený tarif: libovolné adresy, max 20, oddělené čárkou. Prázdné pole = nové položky se jen ukládají do datasetu
Ročníky	žádný	Ročníky (1–9), jejichž zprávy sledovat — vyberte jich klidně víc, když máte ve škole víc dětí. Žádný = zprávy celé školy
Posílat „Velmi důležité zprávy“	zapnuto	Důležitá oznámení celé školy. Doporučujeme nechat zapnuté
Posílat i denní přehled akcí	vypnuto	Hlídat i „Akce na tento den“. E-mail pak chodí prakticky denně
Poslat testovací e-mail	vypnuto	Pošle náhled několika položek z každé sekce a nic neovlivní. Po testu vypněte

Kolik to stojí?

Nic. Hlídač stáhne jen jednu až několik stránek a běží pár sekund, takže se bezpečně vejde do bezplatného tarifu Apify (5 USD kreditu měsíčně) i při spouštění několikrát denně.

Časté dotazy

Přijde mi e-mail, i když nic nového není? Ne. E-mail chodí jen tehdy, když se na webu objeví něco, co hlídač ještě nehlásil. (Výjimka: zapnutý denní přehled akcí — akce jsou každý den „nové“.)

Můžu posílat upozornění na jinou adresu, než mám u Apify? Na bezplatném tarifu ne — e-maily chodí jen na adresu vašeho Apify účtu (ochrana proti spamu). S placeným tarifem lze zadat až 20 libovolných adres oddělených čárkou.

Proč mi po prvním spuštění nepřišel e-mail? To je záměr — první spuštění si jen zapamatuje aktuální obsah webu jako výchozí stav. E-maily chodí až od dalších spuštění. Chcete-li si e-mail vyzkoušet hned, použijte přepínač Poslat testovací e-mail.

Mám ve škole dvě (nebo víc) dětí v různých ročnících. Jak to nastavit? Jedním hlídačem. V poli Ročníky vyberte všechny ročníky, které vás zajímají (např. 3. a 7.). Přijde vám jeden e-mail, ve kterém má každý ročník vlastní nadpis („Nejnovější zprávy — 3. ročník“, „Nejnovější zprávy — 7. ročník“) — uvidíte tedy hned, co se týká kterého dítěte. Zakládat druhý hlídač nebo druhý účet není potřeba. Důležitá oznámení a akce se týkají celé školy, takže se v e-mailu neopakují.

Sledují se důležité zprávy i při výběru ročníku? Ano. „Velmi důležité zprávy“ (a případné akce) se týkají celé školy a na výběru ročníku nezávisí; výběr ročníku ovlivňuje jen sekci „Nejnovější zprávy“.

Nastavil jsem plánovač, ale nic se nespouští. Nejčastěji je plánovač jen vypnutý — nové plánovače jsou po vytvoření vypnuté. Otevřete Schedules, klikněte na svůj plánovač a zapněte přepínač Enabled.

Plánovač běží, ale e-maily nechodí. Zkontrolujte, že máte e-mail a ročníky vyplněné i v plánovači (karta Actors and tasks → Input). Plánovač nepřebírá nastavení ze záložky Input na stránce Actora, má vlastní kopii. Když je zelený běh a e-mail nechodí, druhá možnost je, že prostě nic nového nebylo — to je v pořádku.

Hlídač běží v jiný čas, než jsem nastavil. V plánovači je špatné časové pásmo. Přepněte Timezone na Europe/Prague — jinak Apify počítá časy v UTC, což je v zimě o hodinu a v létě o dvě hodiny dřív.

Můžu plánovač na dobu dovolených vypnout? Ano. V Schedules u něj přepněte Enabled na vypnuto a po dovolené zase zapněte. Nastavení se nikam neztratí. Po zapnutí pošle první běh i novinky, které vyšly během pauzy.

Spuštění skončilo chybou „Ze sledovaných sekcí se nepodařilo načíst žádné položky“. Škola pravděpodobně změnila podobu webu a hlídač potřebuje aktualizaci. Dejte vědět správci.

Výstup (pro zvídavé)

Kromě e-mailu si hlídač každou nalezenou položku ukládá i do tabulky u daného spuštění (v Console záložka Storage → Dataset). Najdete tam sekci, titulek, odkaz, datum, autora, ročníky, odkaz na přílohu a úryvek textu. Tabulku lze stáhnout jako Excel, CSV nebo JSON — třeba když si chcete novinky archivovat. Pro běžné používání ji nepotřebujete.

Pro vývojáře

apify run    # lokální test (vstup v storage/key_value_stores/default/INPUT.json)
apify push   # nasazení na Apify

Hlídač stahuje stránky obyčejným HTTP požadavkem (CheerioCrawler, bez prohlížeče) — u vybraných ročníků jednu stránku na ročník (?rocnik=N). Sekce „Velmi důležité zprávy“ a „Akce na tento den“ jsou na všech ročníkových stránkách stejné, proto se deduplikují; zprávy nesou seznam ročníků, ke kterým patří.

Actor běží s limited permissions. Už ohlášené položky si pamatuje pojmenované key-value úložiště londynska-novinky-state, které si vytvoří první běh Actora — limited režim dovoluje používat úložiště vytvořená vlastními běhy, ale ne sahat na cizí úložiště na účtu uživatele (proto název nesmí kolidovat s existujícím store). Z téhož důvodu nejde zjistit e-mail účtu uživatele (users/me vrací 403), takže adresu musí vyplnit uživatel. Pole ale není povinné — bez něj běh jen uloží nové položky do datasetu a skončí úspěšně, aby Actor šel spustit i s výchozím vstupem. Adresa webu a limit pamatovaných položek jsou záměrně napevno v src/main.js, aby vstupní formulář zůstal co nejjednodušší. E-maily odesílá Actor apify/send-mail (sám běží s limited permissions, volat ho lze). Při změně struktury webu spuštění selže — upravte selektory v src/main.js.