Dokumentace Booking and Reservations

Tato komponenta je plně kompatibilní a testována s poslední verzí systému Joomla!, verze 1.5 a 1.6, Apache2, PHP5 a MySQL5. Správně pracuje s PHP4 a s nižší verzí není zaručeno. Komponenta nepracuje s Joomla! 1.0.  Pokud má Vaše Joomla! vlastní vývoj v jádře, pak správné fungování této komponenty není zaručeno.

Booking používá knihovny Javascriptu - Mootools. V Joomla! 1.5 je požadována verze Mootools 1.12 a v Joomla! 1.6 je požadována verze Mootools 1.3. S různými verzemi Mootools není zaručena správná funkcionalita komponenty. Nelze používat JQuery s Mootools dohromady. Mezi těmito knihovnami je kolize.

Javascript a také CSS (Cascading Style Sheets) jsou obvykle kešovány webovými prohlížeči. Při vývoji této komponenty jsou prováděny změny a když provedete aktualizaci komponenty, Váš prohlížeč může stále používat starší verzi JS a CSS a komponenta nebude pracovat správně. V takovém případě musíte vymazat vyrovnávací paměť prohlížeče nebo použít klávesovou zkratku CTRL+F5.

Uživatel Joomla! databáze musí být schopen vytvářet tabulky a nastavení sloupců tabulky. Booking vytváří nové databáze tabulek pro šablony objektů.

Testováno na Opera 11.10, Mozilla Firefox 3.6.17, Internet explorer 8 a 7. Netestováno na Internet explorer 6 a nižších verzích.

Všechny části komponenty jsou plně přístupné z Joomla backendu. Ovládací panel umožňuje otevřít všechny části komponenty. Každá hlavní část je podrobněji popsána v následujících podkapitolách.

Základní šablona, ve které si nastavíte atributy, podle toho, jaký objekt budete vytváře. Můžou to být základní atributy jako je jméno nebo popis, ale také vlastnosti, které jsou  charakteristické pro daný typ objektu (rozměry hřiště, počet hráčů, ...) Typy atributů jsou standardní, jak je znáte z webových formulářů (Text box, Text area, Select box, Radio button a Check box). Kromě jména a typu můžete ještě atributu přidat stylovou ikonku a zvolit, zda podle něj jde vyhledávat a filtrovat. Poslední věc, kterou můžete šabloně nastavit je, jaký druh kalendáře se bude zákazníkům zobrazovat a který z nich je výchozí.

Nastavení šablon je k dispozici v administraci komponenty na záložce šablony.

Obrázek 2.2. Seznam šablon v administraci

Pro šablony jsou k dispozici základní nástroje nový/upravit/kopírovat/smazat. Tyto nástroje jsou k dispozici v hlavním panelu nástrojů. Kliknutím na nový/editovat nebo na název šablony otevřete editaci stránky. Zde nastavíte název šablony, kalendáře a vlastnosti.

Kalendář je dialog, pomocí kterého si Vaši zákazníci budou určovat čas rezervace. Existují 3 základní typy, které se liší jak zobrazovaným časovým intervalem, tak i grafickou podobou. Denní kalendář vypisuje možné rezervační časy pro každý den zvlášť a jako všechny kalendáře zobrazuje již obsazené termíny. Týdenní  kalendář je vzhledem i funkcionalitou velmi podobný  předchozímu. Zobrazuje však všechny dny od dnešního do konce týdne. Poslední, měsíční kalendář, zobrazuje všechny dny v měsíci po týdnech. Na rozdíl od předchozích dvou však zobrazuje jen celodenní rezervace, nikoliv hodinové.  Pro každý kalendář nastavíte "je k dispozici" nebo není. Pro jeden z nich nastavíte, který je výchozí. Výchozí kalendář je zobrazen, když zákazník otevře stránku objektu poprvé. Kalendáře jsou zvoleny podle charakteru objektu. Pokud vytváříte objekty jako je hotelový pokoj nebo automobil, které jsou rezervovány na celý den, potřebujete pouze měsíční kalendář. Pro objekty jako jsou tenisové kurty nebo sportovní haly, které jsou rezervovány na určitě hodiny, můžete použít denní nebo týdenní kalendář.

Properties jsou atributy, které náleží k dané šabloně. Toho využijete tehdy, pokud máte několik objektů stejného typu (např. tenisové kurty). Tyto objekty mají stejné atributy, liší se však jejich hodnoty. Např.: hotel bude mít množství pokojů, u kterých budete uvádět stejné atributy (číslo, patro, kam má výhled, počet lůžek,...). Když budete následně vytvářet objekty jednotlivých pokojů, využijete této šablony a jednoduše jen vyplníte potřebné údaje. Takovýchto šablon můžete mít kolik jen chcete, proto není problém mít jiný pro pokoj a jiný pro apartmá. U každého pak uvádět jiné informace.

Obrázek 2.3 Editace stránky šablony

Vlastnosti šablony nastavíte kliknutím na nástroj new (pro novou vlastnost) nebo kliknutím na nástroj  config (pro existující vlastnost). Během vytváření musíte nejprve nastavit typ vlastnosti.

Obrázek 2.4. Ukázka výběru typu vlastnosti

Pro každou "property" je k dispozici následující nastavení. Pokud používáte tlačítka select box/radio pro více vlastností, musíte nastavit alespoň 2 volby. Každá volba musí být na jednom řádku. Vlastnost musí mít název. Můžete také vybrat ikonu "searchhable/filterable mark."

Obrázek 2.5. Dialog editování vlastnosti šablony

Objektem může být takřka všechno. Jedná se o předmět Vašeho podnikání. Může jím být cokoli, co chcete zákazníkům umožňit rezervovat. Ať už to jsou vstupenky, hotelový pokoj nebo automobil. Objekty mohou tvořit stromovou strukturu, kterou si můžete navolit dle vlastního přání. Samozřejmostí je také galerie a popisný text, který můžete rovněž obohatit o obrázky, grafy a další prvky. Lze zde nastavit hodnoty Vašich atributů, jež jste vytvořili v dané šabloně. Dále pak typy rezervací a ceny. Pro více informací čtěte níže.

Nastavení objektů je k dispozici v administraci komponenty na záložce objekty.

Obrázek 2.6. Filtrovaný seznam objektů v administraci

Stromová struktura objektů je důležitá, pokud chcete řadit objekty do kategorií podle jejich charakteru. "Parents objects" nejsou rezervovatelné. Jsou definovány pro vytváření kategorií objektů. Rezervovatelné jsou pouze poslední "childs" .

Obrázek 2.7. Editace stránky objektu v administraci

Jednoduchý příklad nastavení pro automobil

Rezervace tohoto automobilu je k dispozici od 16.12.2010 (viz. možnost publikovat až) na dobu neurčitou (option publish down is empty). Kapacita je nastavena jako 1. To znamená, že automobil je pro každý rezervovatelný interval k dispozici pouze pro jednoho zákazníka. Automobil je permanentně zveřejněn (see option published) a zobrazuje se všem návštěvníkům stránky (access are public). V hierarchii objektů je automobil přidán do katergoie
Automobily.

Objekt musí mít název. Alias se používá pro vytváření SEF URL adres a vy ho nemůžete vyplnit. Pokud necháte pole prázdné, alias bude během ukládání objektu vygenerován automaticky. Pokud je objekt zveřejněn, neměli byste provádět změny, protože SEF url je už indexován Googlem. Pole meta keywords a meta description slouží také pro SEO a měli byste je proto také vyplnit.

Objekt musí mít jednu šablonu. Jste schopni editovat šablonu ze stránky editace objektu. Všechny změny, které uděláte pomocí editace objektu se zobrazí také v ostatních objektech a šablonách. Pro objekt můžete nastavit standardní vlastnosti Joomla! jako je "publish up/down", přístup uživatele a objednávání položek.

Nyní se dostáváme k nejdůležitější části. A to je velmi flexibilní systém rezervací, pomocí kterého si každý vytvoří harmonogram jaký potřebuje. Pomocí Reservation types si zvolíte, jakým způsobem si zákazník může rezervovat určitý objekt. Hlavním parametrem je, jestli se jedná o denní nebo hodinovou rezervaci. Denní znamená, že si zákazník daný objekt musí rezervovat minimálně na celý den, hodinová pak umožňuje kratší časové intervaly. Capacity unit definuje, po kolika kusech (místech) z celkové kapacity si lze objekt rezervovat. Následující dva parametry se vztahují pouze k hourly reservation types. Je to time unit, neboli časový interval rezervace. Udává, že zákazník si může objekt rezervovat například po 30-ti minutách. Gap time je pak prodleva mezi jednotlivými rezervacemi, které slouží napří. k úklidu.

Nejdůležitější vlastností rezervace je bezesporu její cena. Pro její definování msíte zadat následující parametry. Samotnou cenu, deposit, který bude následně vrácen zákazníkovi, reservation type, který jsme si zvolili v předchozí záložce a data od kdy do kdy je daná cena platná. Pro reservation type hourly můžete zadat ještě další parametry. Samozřejmostí jsou časy, mezi kterými lze objekt rezervovat.  Mezi těmi časy se následně vypočítávají samotné rezervační jednotky, a to podle time unit a gap time. Také můžete omezit, ve kterých dnech v týdnu je tato cena aktuální. Můžete vytvořit celou řadu takovýchto rezervačních jednotek s různými reservation types. Výběr data je umožněn prostřednictvím kalendářového dialogu a hodinu můžete nastavit na ciferníku.

Pokud máte více než jeden typ rezervace a každý typ má různé délky, můžete použít volbu minimální interval. S jedním typem rezervace se tato volba nepoužívá.

V následujícím příkladě máme myčku aut, kde si zákazník může rezervovat mycí proceduru na 30 nebo 60 minut.  Potřebujeme tedy zobrazit v kalendáři 30ti minutové boxy. Proto musíme nastavit minimální délku intervalu na 30 minut. Pokud chce zákazník 30ti minutovou proceduru, vybere si jeden box. Pokud chce zákazník 60 minut, v kalendáři jsou zvýrazněny dva sousední boxy pro jedno kliknutí. Vzhledem k tomu, že má myčka celkovou kapacitu 10, můžeme nastavit zobrazení kapacity. Nyní jsou v týdenním kalendáři zobrazeny další volné kapacity. Podívejte na příklady níže.

Doplňky jsou další rezervovatelné vlastnosti objektu. Např.: provozujete squashové centrum a zákazníci můžou požadovat kromě rezervace kurtu také rezervaci squashové rakety. Viz. příklady níže.

Doplňky mají dvě formy. Doplněk "Option yes/no" je realizován na frontendu pomocí pole "checkbox" a má cenu (option "One price") nebo je zdarma (option "Free"). Doplněk "Select from list" má více hodnot a je realizován pomocí rozbalovacího seznamu. Každá hodnota má vlastní cenu (option "More prices") nebo všechny hodnoty mají jednu cenu (option "One price") nebo doplněk je zdarma (option "Free"). Pro doplněk "Select from list" musíte nastavit "Use empty option". To znamená, že zákazník nemusí vybírat hodnotu a přidávat doplněk (in drop down list is option without value). Vlastnost "Use empty option" není k dispozici pro doplněk "Option yes/no". Doplněné ceny jsou automaticky přidány v plné výši ceny rezervace.

Pro užívání této komponenty je důležité mít frontend. Frontend administrátoři spravují rezervaci z frontendu (ne z backendu). Správci jsou vybráni z existujících uživatelů Joomla!. Tito uživatelé nemůžou být použity v účtech zákazníků. Na následujícím obrázku je nastavení backendu. K dispozici je filtrovaný seznam existujících uživatelů. Ve sloupci "Is admin" můžete vidět poznámku, jestli je uživatel is/isn't administrator nebo je zákazník (cannot be administrator). Přiřadit uživatele jako správce můžete provést pomocí nástrojů z hlavního panelu nástrojů.

Obrázek 2.24. Nastavení administrátorů v administraci

Zákazníci jsou návštěvníci stránky, kteří můžou provést rezervaci v komponentě Booking. Můžete dovolit návštěvníkům stránky provést rezervaci bez registrace nebo s registrací a Joomla uživatelský účet pro přihlášení. Pokud návštěvník nemá Joomla uživatelský účet, komponenta  mu nabídne provést novou registraci s novým Joomla uživatelským účtem. Pro přihlášeného uživatele nabízí komponenta stát se zákazníkem.

Pole, která musí zákazník během registrace nebo rezervace objektu vyplnit, můžete nastavit v komponentě v "global configuration" (bookmark Registration/reservation fields). Pole můžete vypnout (option hide) nebo povolit (option show). Pole, která jsou povolena, můžou být povinná nebo volitelná.

Účty zákazníků jsou přístupné z backendu. Zákazníkovi může být blokován jeho Joomla uživatelský účet. V backendu můžete zákazníky editovat nebo mazat.

Pokud jste zveřejnili objekty, zákazníci si je můžou rezervovat a provádět rezervace. Jedna rezervace má jeden rezervovatelný objekt (volitelně s doplňky), vypočtené ceny,osobní údaje zákazníka a časový rozsah. Podle nastavení objektu jsou v kalendáři zobrazeny a barevně zvýrazněny intervaly, které jsou k dispozici. Zákazníci si vyberou intervaly a doplňky objektu, které jsou k dispozici. Po kliknutí na tlačítko "Book it" musí zákazník vyplnit jeho osobní údaje a uložit rezervaci.

Rezervace mají 2 statusy. Status active/cancel a status unpaid/deposit reveived/fully paid. Komponenta Booking nerealizuje platbu rezervace. Informace o stavu paid/unpaid je přidána ručně administrátorem z frontendu nebo backendu. Pokud je stav rezervace aktivní, je její interval pro všechny další zákazníky zablokován, bez ohledu na to, zda došlo k platbě či nikoli. Interval je volný pouze tehdy, kdy je rezervace zrušena. Zákazník může zrušit rezervaci, pokud její interval neuplynul.

Na seznamu rezervací v backendu vidíte statusy ve dvou sloupcích s ikonami. Po kliknutí na ikonu se stav změní na další hodnotu. Frontend používá podobnou tabulku prohlížení jako je v backendu se stejnými nástroji.

Komponenta může posílát e-maily administrátorům a zákazníkům. Nastavení posílání e-mailů je k  dispozici v "global configuration". Zde můžete vypnout tuto službu nebo nastavit odesílání e-mailů jen administrátorům, nebo jen zákazníkům nebo oběma. Pro nastavení posílání e-mailů používá tato komponenta nastavení Joomla! configuration. V konfiguraci komponenty můžete nastavit e-mail odesílatele, jméno odesílatele, předmět pro zákazníky nebo administrátory, HTML formát nebo prostý text a tělo e-mailu. Další nastavení jako je mailer (php mail/smtp/sendmail), uživatelské jméno, heslo, bezpečnost atd. jsou nastaveny v Joomla! global configuration. V těle zprávy můžete použít transkripční značky, které jsou nahrazeny rezervací nebo registračními údaji. Jsou to údaje jméno zákazníka, datum rezervace, název objektu, atd...

Obrázek 2.38. Použití přepisovací značky v těle e-mailu.