Správa Venue Finderu

Jak to celé drží pohromadě

Venue Finder nejsou jedny dveře, ale troje. Když víte, které jsou které, většina otázek v této příručce se zodpoví sama.

Kde co v administraci najdete

V levém menu je sekce Venue Management. Obsahuje vše, co s Venue Finderem souvisí, v tomto pořadí:

• Categories, kategorie a podkategorie míst
• Locations, lokality
• Venues, samotná místa
• Rooms, sály jednotlivých míst
• Venue Variants, kombinace sálů a jejich kapacity
• Amenity Groups a Amenity Types, skupiny a typy vybavení

Mimo tuto sekci pracujete ještě se dvěma věcmi: Pages (stránky, kde se nastavuje adresa) a Templates (šablony, kde se nastavuje, co Venue Finder nabízí za filtry).

1Adresa stránky

Adresa Venue Finderu se skládá ze dvou částí, které musí souhlasit. Jedna je v administraci, druhá ve WordPressu. Když změníte jen jednu, návštěvník uvidí prázdný rám nebo chybovou stránku.

Část první: slug v administraci

1. Otevřete Pages a najděte stránku Venue Finderu.
2. V poli Slug (adresa) je dnes planning-tool. Toto je ta část adresy, kterou měníte.
3. Uložte. Stránka od té chvíle běží na nové adrese, například /nova-adresa místo /planning-tool.

Celá adresa aplikace pak vypadá takto:

Část druhá: WordPress

Ve WordPressu je šablona stránky, která Venue Finder vkládá do webu. Uvnitř má napsanou stejnou adresu ještě jednou, v řádku $defaultPath. Ta se musí změnit také.

Adresa detailu místa

Každé místo má vlastní adresu, která se odvodí z jeho názvu, když místo vznikne. Z „Obecního domu“ se stane obecni-dum. Detail se pak návštěvníkovi otevře v nové záložce na adrese webu, která končí tímto názvem.

2Správa míst

Místa se do Venue Finderu nezakládají ručně. Přicházejí z CRM. Vaše práce je nová místa zkontrolovat a pustit na web, hlídat ta, u kterých se něco změnilo, a doplnit to, co CRM neumí.

Čtyři stavy, které rozhodují o viditelnosti

Každé místo má pole Sync Status vpravo v postranním sloupci. Rozhoduje o tom, jestli se místo ve vyhledávání ukáže.

Jak pustit nové místo na web

1. Otevřete Venues a seřaďte nebo vyfiltrujte si místa se stavem New (Draft).
2. Projděte záložky Details, Contact, Address, Capacity, Features a Media.
3. Zkontrolujte kategorii, podkategorii a lokalitu v pravém sloupci. Podle nich se místo zařadí do filtrů.
4. Přepněte jazyk na češtinu a ověřte, že český název, popis a fotky dávají smysl.
5. Nastavte Sync Status na Ready a uložte.

Co synchronizace přepíše

Tohle je nejčastější zdroj překvapení. Pokud opravíte text, který přišel z CRM, další synchronizace ho vrátí zpátky. Opravy patří do CRM, ne sem.

Sály a varianty

Sály (Rooms) jsou jednotlivé místnosti. Varianty (Venue Variants) jsou jejich kombinace, například celý sál nebo tři oddělené části. Vyhledávání pracuje s variantami, ne s jednotlivými sály, protože podle nich pozná, jestli se do místa vejde několik akcí najednou.

• Když se změní sál, varianty se přepočítají samy.
• Když se sál smaže, smažou se i varianty, které ho obsahovaly.
• Když kapacity nesedí, otevřete místo a použijte tlačítko Regenerate Variants v pravém sloupci. Vytvoří varianty ze sálů znovu.
• Když varianta nemá vybrané žádné sály, počítá kapacitu z údajů u místa.

Ruční spuštění synchronizace

Synchronizace se dá spustit dvěma způsoby.

Pořadí ve výsledcích

Nahoře jsou vždy členové Convention Bureau, pod nimi ostatní. Uvnitř každé skupiny se řadí podle abecedy podle názvu, bez ohledu na diakritiku. Pořadí se ručně měnit nedá.

3Filtry a co se zobrazí

To, co návštěvník ve Venue Finderu vidí za záložky a filtry, není nastavené v kódu. Sedí to v jedné šabloně a můžete to měnit.

Kde se to nastavuje

1. Otevřete Templates a vyberte šablonu Venue Finderu.
2. Uvnitř je seznam Category configs. Každý řádek je jedna záložka nahoře ve vyhledávači.
3. Pořadí řádků určuje pořadí záložek. První řádek je ta, která se návštěvníkovi otevře jako první.

Každý řádek má tato pole:

Co má návštěvník k dispozici

Když návštěvník potřebuje víc než osm sálů najednou, tlačítko pro přidání dalšího zmizí a nabídne se mu kontakt. Výsledky se načítají po dvanácti.

Jak vyhledávání uvažuje

Návštěvník může chtít víc sálů zároveň, například jeden pro 300 lidí a dva pro 60. Vyhledávání pak hledá místa, která mají dost variant na pokrytí všech požadavků najednou, a hlídá, aby se stejný sál nepoužil dvakrát. Místo, které má jediný velký sál, se při dvou souběžných požadavcích nenabídne, i když má kapacity dost.

Odkaz na konkrétní výběr

Filtry se propisují do adresy v prohlížeči. Když si tedy naklikáte například hotely v centru pro 200 lidí, stačí adresu z prohlížeče zkopírovat a poslat dál. Komu ji otevřete, uvidí stejný výběr. Adresa vypadá ošklivě, ale funguje.

4Kategorie, vybavení, ikony

Kategorie a lokality

Kategorie mají dvě úrovně. Hlavní kategorie nemá vyplněné pole Parent Category, podkategorie ho má vyplněné odkazem na svou hlavní kategorii. Ve vyhledávači se hlavní kategorie ukazují jako záložky nahoře, podkategorie jako zaškrtávátka vlevo.

Kategorie i lokality přicházejí z CRM. Zakládat je ručně nemá smysl. Co u nich upravit můžete, jsou přeložené názvy a popisy, protože ty se ukládají zvlášť pro každý jazyk.

Vybavení má tři patra

Jak nastavit ikonu

1. Otevřete Amenity Types a vyberte typ vybavení.
2. V poli Icon zvolte zdroj. Nejjednodušší je Iconify, kde ikonu najdete podle názvu, například parking. Další možnosti jsou obrázek z knihovny médií nebo vlastní SVG.
3. Doplňte Description, pokud chcete pod názvem krátké vysvětlení. Popis se překládá do obou jazyků.
4. Uložte.

Ikony, které měnit nejdou

Na detailu místa je pruh s velkými čísly: zasedací místnosti, pokoje, udržitelný partner, připravenost na hybridní akce a hygienická opatření. Těchto pět ikon je natvrdo v kódu aplikace a bez zásahu vývojáře je nezměníte. Nehledejte pro ně políčko v administraci, žádné není.

Pro správce webu

Tato část je pro člověka, který spravuje WordPress nebo kód. Běžný správce obsahu ji nepotřebuje.

Jak je Venue Finder zapojený

Venue Finder je samostatná aplikace na doméně venue-finder-prod.eu-apps.questpie.com. WordPress ji vkládá do stránky v rámu. Obě strany si spolu povídají přes postMessage: aplikace hlásí nahoru svou výšku, změnu filtrů, kliknutí na místo a odchod na externí odkaz, WordPress na to reaguje.

Dvě šablony ve WordPressu

Celé propojení mezi WordPressem a Venue Finderem obstarávají dvě šablony stránek. Jsou to obyčejné PHP soubory v šabloně webu a zároveň jsou verzované v repozitáři projektu ve složce src/venue-finder/.

Nahoře v obou souborech se nastavují tři hodnoty:

• $domain, adresa aplikace. Při přechodu na staging se mění tady.
• $defaultPath, dnes /planning-tool. Musí odpovídat slugu stránky v administraci Venue Finderu.
• $supportedLocales, dnes ['cs']. Podle toho se pozná, že se má do adresy aplikace přidat jazyková předpona.

Synchronizace a její hlídání

• CRM Sync v sekci Seeders se spouští ručně. Bere volitelný seznam míst a seznam e mailů pro zprávu o výsledku.
• Stuck Seeder Cleanup hlídá zaseknuté běhy. Co běží déle než dvacet minut, označí jako selhané, aby šlo spustit nový běh.
• Pořadí uvnitř synchronizace je pevné: nejdřív kategorie, pak vybavení, pak místa. Anglické záznamy se zpracují dřív než české.
• Místa, která v CRM zmizela, se označí jako Ready to Delete. Nemažou se sama.

Co jde změnit jen v kódu

• Pět ikon u čísel na detailu místa.
• Skrytí typů vybavení Conference Rooms a Hotel Rooms.
• Maximum osmi souběžných požadavků na sály a rozsahy posuvníků.
• Nadpis a podnadpis nad vyhledávačem, které jsou v překladových souborech aplikace.
• Přesměrování po změně slugu.

Když něco nesedí