Visual PHP Developer Guide

Transkript

1 Visual PHP Developer Guide Verze jádra:

2 Visual PHP Developer Guide Děkujeme Vám, že jste si zakoupili náš produkt Visual PHP. Pevně věříme, že s ním budete spokojeni natolik, že si pozdější tvorbu prezentací bez něj už nedokážete představit. Dostává se Vám do rukou naprosto unikátní software, který nenaleznete nikde na světě v takovéto ucelené podobě. Jedná se o spojení částí všeho potřebného ke tvorbě internetových prezentací. Je to výsledek mnohaleté práce, kdy postupným nabalováním funkcí vycházejících z vlastních potřeb jsme se dostali do této fáze, kterou máte právě k dispozici. Tato fáze ovšem není konečná... máme v hlavách plno dalších možných vylepšení, které budeme postupně zveřejňovat a vy jakožto plátci licence, máte jedinečné právo přístupu k update produktu. Dnes nedokážeme říci, jak velký obsah bude Visual PHP nabízet, protože ty možnosti jsou nekonečné, víme ovšem, že se budeme snažit maximálně přiblížit potřebám trhu a všem trendům, které bedlivě sledujeme. Tato uživatelská příručka je věnována jak začínajícím Developerům, tak profesionálům a všem těm, kteří se právě rozhodli pracovat v našem produktu Visual PHP. V této verzi příručky se dočtete vše potřebné od prvních kroků tvorby Vaší internetové prezentace a základním seznámením s naším produktem, až po součásti, které naplno využívají náš produkt Visual PHP. Budou zde zjednodušeně vysvětleno vše důležité a je to takový první krok nováčků k tomu, stát se profesionálním developerem se vším všudy. Na konci této příručky je opět velmi zjednodušeně popsán příklad tvorby jednoduché prezentace, kde je vysvětleno krok po kroku, jak vlastně prezentaci vytvořit. Podle tohoto vzoru se naučíte základu. Dále už potom zvládnete sami pracovat a vytvářet Vaše prezentace, které budou naprosto podle Vaší fantazie. Vytvořeno : červenec 2009 E-VISION International s.r.o. Příkop 843/ , Brno Speciální poděkování : info@e-vision.cz web: Obchodní oddělení : Petr Kočí j ednatel společnosti Chtěl bych touto cestou poděkovat mé přítelkyni Michalce, která byla po celou dobu přípravy mou velkou oporou, která s obrovskou trpělivostí musela přečkat nespočetně hodin mé práce na tomto proj ektu. Která díky tomu zažila spoustu odříkání a ani přes všechny těžkosti, které j sem j í tímto připravoval, mě nepřestala zahrnovat láskou a pochopením. Moc ti za to vše děkuj i a slibuj i, že ti vše vynahradím. tel: petr.koci@e-vision.cz Technické oddělení : Bc. Tomáš Kočí j ednatel společnosti tel.: tomas.koci@e-vision.cz Master Developer Dále chceme poděkovat všem těm, kteří nám zasílaj í svoj e připomínky a náměty na vylepšení Vašeho produktu, protože vše co děláme, děláme pro Vás. Team E-VISION International

3 Obsah 3 Obsah : Předmluva Kapitola : I Instalace USB klíče Instalace... ovladačů 10 2 Změna... hesla USB klíče 10 3 Instalace... certifikátů 11 Kapitola : II Instalace Visual PHP 18 1 Instalace... nového projektu na server 18 Instalační skript Spuštění instalace Aktualizace... jádra 32 3 Přenesení... projektu na jiný server 48 Vygenerování... instalačního souboru 48 Instalace projektu... na jiný server 49 4 Odemknutí... instalátoru pro další použití 67 5 Ruční... přenesení projektu na jiný server 68 6 Instalace... velkých SQL souborů 71 7 Rekurzivní... změna práv (chmod) souborů 79 Kapitola : III Administrace 89 1 Přihlášení... pomocí USB klíče 89 2 Přihlášení... pomocí jména a hesla 90 3 Popis... okna administrace 90 Kapitola : IV Základy tvorby prezentací 93 1 Vytvoření... global layoutu 93 2 Vložení... obsahu z databáze 95 3 Vkládání... dalších layoutů 96 Kapitola : V Nastavení prezentace 101 Kapitola : VI Styly Parametry... stylů Zpracování... stylů Přepínání... stylů 106 Kapitola : VII Layouty Parametry... layoutů Zpracování... layoutů 109 3

4 4 Visual PHP Developer Guide 3 Vložení... vnitřního layoutu (Include Layout) 109 Kapitola : VIII Dynamický obsah Vložení... layoutu Obsah... tabulky databáze (Table Content) Procházení... stránek (Browse Pages) Informace... o čísle stránky (Page of Pages) Výběr... počtu položek na stránce (Items per Page) Filtrace... záznamů Navigace Menu Kapitola : IX Šablony Parametry... šabon Zpracování... šablon Podmínky... v šablonách 130 Kapitola : X Tabulky Přehled... tabulek Parametry... tabulek Master-Detail... Tabulky Multi-Detail... tabulky Tree... tabulky Property... tabulky 141 Kapitola : XI Pole tabulek Přehled... polí tabulky Parametry... polí tabulek Virtuální... pole 146 Kapitola : XII Komponenty COMPONENT HIDDEN READONLY UUID AUTOINCREMENT TEXT TEXTAREA CHECKBOX CHECKGROUP COMBOBOX

5 Obsah 5 11 DATETIME AUTOCALC BROWSERS CODE COLOR COMPONENTPROPERTIES DETAILTABLE DISPLAYTYPE EDITGRID EDITLIST FILE GOOGLEMAP HISTORY HTMLAREA LANGUAGE IMAGE LOOKUP LOOKUPCHECKGROUP LOOKUPTREE PAGECONTROL PERMISSIONS PROGRESS PROPERTIES REMOTECOMPONENT REMOTECOMPONENTGROUP RSSPROPERTIES TABLES TABSHEET URL USERS USERGROUPS ADMINUSERS ADMINUSERGROUPS Kapitola : XIII Menu v administraci Parametry... položek menu v administraci 184 Kapitola : XIV Skripty Parametry... skriptů Spouštění... skriptů 186 5

6 6 Visual PHP Developer Guide Kapitola : XV Časové skripty Parametry... časových skriptů Ruční... aktivace časového skriptu 189 Kapitola : XVI Skripty na pozadí 191 Kapitola : XVII Vkládání komponent třetích stran Vkládání... JavaScript komponent 193 Kapitola : XVIII Sdílené objekty Ukládání... objektů 195 Kapitola : XIX Automatické parametry 197 Kapitola : XX Frontend dokumenty 199 Kapitola : XXI Databázová připojení 201 Kapitola : XXII Jazyky Automatická... detekce jazyka Přepínání... jazyků 203 Kapitola : XXIII Překlady 205 Kapitola : XXIV Správce procesů 207 Kapitola : XXV Terminál 209 Kapitola : XXVI SEO SEO... mapování Zamezení... duplicitního obsahu Hromadné... generování SEO mapování SEO... prohlížeč 213 Kapitola : XXVII Firewall 215 Kapitola : XXVIII Obrázky Template... Image Změna... velikosti Vodoznak Kapitola : XXIX Ladění (debug) Layouty

7 Obsah Kapitola : XXX Moduly E-shop Tabulky Frontend dokumenty Skripty Nastavení Katalog zboží Košík Registrace Přihlášení Odhlášení Výrobci Objednávky Způsoby doručení Způsoby platby Export XML pro... w w w.zbozi.cz Fotogalerie Tabulky Šablony Zobrazení Změna velikosti... obrázků 250 Hromadný import... obrázků Související... dokumenty Počasí Komponenta... Weather 252 Virtuální tabulky Šablony Kapitola : XXXI Tvorba vlastních modulů Vlastní... tabulky databáze Vlastní... pole tabulky 257 Kapitola : XXXII Fulltextové vyhledávání 260 Kapitola : XXXIII Objekty Mail Kapitola : XXXIV Funkce getmicrotime getmemoryusage iswindows isdebugip str_dump getfunctioncall dumpfunctioncall dump

8 8 Visual PHP Developer Guide 9 showmessage deleteobject createobject getobject objectexists getmod replaceaccentchars runinbackground encrypt decrypt formatnumber issqldateformat execcommand isrfc822dateformat _rmdir fileexists createuuid url_exists settimeout setmemorylimit file_append_contents isuuid array_to_php php_to_array strposr strposc Kapitola : XXXV Návody a často kladené dotazy Bannery... v závislosti na hlavním menu Fotogalerie... zobrazená s FrogJS 275 Rejstřík 0

9 Instalace USB klíče Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola I

10 10 1 Visual PHP Developer Guide Instalace USB klíče Pro práci v produktu Visual PHP je nutné vlastnit USB klíč. Tento klíč obdržíte při zakoupení produktu. V následujících krocích Vás provedeme instalací ovladačů a certifikátů tak, abyste mohli začít pracovat s produktem Visual PHP. 1.1 Instalace ovladačů Pro správnou funkci je potřeba nainstalovat ovladače PKI Klienta. Ovladače rozšíří možnosti prohlížečů FireFox a Internet Explorer pro práci s tímto etokenem. Pokud používáte operační systém starší než Windows Vista a používáte prohlížeč Internet Explorer, je nutné ještě nainstalovat pomocné knihovny pro tento prohlížeč. Příslušné ovladače si můžete stáhnout z následující adresy: Změna hesla USB klíče Klíč je dodáván s předdefinovaným heslem Toto heslo doporučujeme co nejdříve změnit. V pravém dolním rohu se po instalaci ovladačů USB klíče zobrazí ikonka tlačítkem myši a vyberte z nabídky Change etoken Password.. Klikněte na ni pravým Zobrazí se okno, do kterého zadejte staré heslo a 2x stejně heslo nové. Pro dokončení klikněte na tlačítko OK.

11 Instalace USB klíče Instalace certifikátů Pro oba podporované prohlížeče (Mozilla Firefox a Internet Explorer) je odlišný způsob instalace certifikátů. Mozilla Firefox Pokud pracujete s prohlížečem Mozilla Firefox, stačí při prvním přihlášení potvrdit uložení certifikátu do důvěryhodných. Při prvním přihlášení se zobrazí následující dialogové okno: Označte volbu Přijmout tento certifikát natrvalo a stiskněte tlačítko OK. Internet Explorer Pro prohlížeč Microsoft Internet Explorer je instalace složitější. Zadejte do prohlížeče adresu visual-php.com/certificates/ca/certificate.crt pro stažení certifikátu. Zobrazí se následující dialogové okno:

12 12 Visual PHP Developer Guide Klikněte na tlačítko Otevřít. Pro operační systémy Windows Vista se zobrazí další dialogové okno (pro starší operační systémy je tento krok vynechán): Klikněte na tlačítko Povolit. Prohlížeč stáhne certifikát a nabídne toto dialogové okno:

13 Instalace USB klíče 13 Stiskněte tlačítko Nainstalovat certifikát... V následující dialogovém okně se spustí průvodce, ve kterém pokračujte stisknutím tlačítka Další >.

14 14 Visual PHP Developer Guide Zobrazí se toto dialogové okno:

15 Instalace USB klíče 15 Označte volbu Všechny certifikáty umístit v následujícím úložišti, klikněte na tlačítko Procházet... a vyberte Důvěryhodné kořenové certifikační úřady. Pokračujte tlačítkem Další > a import potvrďte tlačítkem Dokončit. Před dokončením se Vás průvodce zeptá na potvrzení následujícího dialogu:

16 16 Visual PHP Developer Guide Potvrďte dialog tlačítkem Ano. Certifikát je nyní považován za důvěryhodný a lze se autorizovat pomocí USB klíče.

17 Instalace Visual PHP Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola II

18 18 2 Visual PHP Developer Guide Instalace Visual PHP Instalátor Visual PHP vznikl z potřeby přenosu velkých objemů dat (ať již souborů, nebo databází). Stávající FTP protokol, případně webová rozhraní pro import SQL dat, jsou u velkého množství souborů a dat pro databázi pomalá, padá FTP spojení, případně není umožněné importovat velké SQL soubory vůbec (např. z důvodu malého limitu pro upload SQL souboru). V následujících kapitolách si ukážeme, co vše lze s instalátorem provádět a jak Vám usnadní čas a práci zejména u velkých projektů obsahujících několik 100 MB až GB dat. 2.1 Instalace nového projektu na server Produkt Visual PHP lze instalovat na server i přímo do Vašeho počítače (za předpokladu, že máte v počítači webový server, PHP 5 a databázi mysql). Instalace je velice jednoduchá a rychlá. Stačí zadat potřebné hodnoty a instalátor provede vše za Vás Instalační skript Pro snadnou instalaci je k dispozici instalační skript, se kterým provedete instalaci během několika minut. Není nutné rychlé připojení k internetu, skript si všechny potřebné soubory stáhne sám z internetu přímo na serveru. Přihlašte se na stránkách pomocí USB klíče a stáhněte si instalační skript install. php. Nahrejte ho pomocí FTP nebo jiného podporovaného připojení na server. Přístupové údaje k serveru získáte od svého poskytovatele hostingu, nebo si je vytvořte v případě, že server, na který instalujete, patří Vám Spuštění instalace Do pole pro zadání adresy v prohlížeči zadejte vaši doménu a install.php uvedeným za touto doménou (např. Otevře se Vám uvítací stránka. Krok 1 - Vítejte Vyberte jazykovou mutaci a pokračujte tlačítkem Spustit instalaci.

19 Instalace Visual PHP 19 Krok 2 - Kontrola systému Instalátor zkontroluje, zda server splňuje minimální požadavky pro instalaci produktu Visual PHP. Pokud jsou zjištěny závažné nedostatky, zobrazí se červeně. V případě, že existuje novější verze instalátoru, zobrazí se v prvním řádku tabulky odkaz pro stažení nejnovější verze instalátoru. Pokud jsou všechny požadavky splňeny, klikněte na tlačítko Pokračovat.

20 20 Visual PHP Developer Guide Krok 3 - Autorizace Aby bylo zabezpečeno, že instalaci provádí oprávněná osoba, je nutné se přihlásit pomocí USB klíče (případně pomocí trial certifikátu). Pokud máte nainstalované všechny ovladače a certifikáty, přejdete do dalšího kroku instalace.

21 Instalace Visual PHP 21 Krok 4 - Získávání informací Vyberte volbu nainstalovat prázdnou prezentaci a zvolte si jeden ze způsobů instalace souborů. Instalace pomocí FTP připojení (doporučené pro servery UNIX/Linux): Pokud běží server pod operačním systémem UNIX/Linux a máte k dispozici FTP přístup, vyberte tuto možnost. Zadejte tedy přístupové údaje a cestu k adresáři, kde bude uložena prezentace. Tuto cestu můžete automaticky zjistit stisknutím tlačítka Najít... Pokud se automatické zjištění nepodaří, připojte se pomocí FTP klienta, zjistěte cestu a zadejte ji ručně. Typická cesta je / pokud je prezentace přímo v hlavním adresáři. Další typické cesty jsou /www/ a /www_root/. Pozn.: důvodem tohoto způsobu instalace je to, že při klasickém kopírování souborů je vlastníkem nově vytvořených souborů UID webserveru, ale při nahrávání přes FTP je vlastníkem UID FTP. Tím je možné soubory ručně modifikovat, mazat, atd. Instalace pomocí SFTP připojení: Tato varianta je stejná jako předchozí, s tím rozdílem, že se připojí přes zabezpečené FTP. Přímé extrahování souborů na server (doporučené pro servery Windows): Tato varianta je k dispozici, pokud nelze použít předchozí možnosti instalace. Doporučená je pro operační systémy Windows, protože tam nejsou omezení přístupu jako u UNIXových serverů. Lze ji použít i pro UNIX/Linux servery, ale po instalaci je nutné přes konzoli změnit vlastníka souborů.

22 22 Visual PHP Developer Guide Krok 5 - Verze instalace Zde si vyberete instalační soubor. Pokud je nabídka prázdná, můžete si instalační soubor stáhnout ze serveru a přes FTP nahrát do stejného adresáře, kde je uložený install.php, nebo můžete využít možnost automatického stáhnutí přímo na server pomocí tlačítka Stáhnout instalaci z visual-php.com. Automatické stahování Vám ušetří spoustu času, protože to není závislé na rychlosti Vašeho připojení k internetu, ale komunikace probíhá přímo mezi servery. Tímto dosáhnete rychlosti v několika MB za sekundu.

23 Instalace Visual PHP 23

24 24 Visual PHP Developer Guide Krok 5 a - stažení instalace Vyberte si verzi instalace, kterou má instalátor automaticky stáhnout a klikněte na tlačítko Pokračovat. Pokud potřebujete stáhnout starší verzi, zaškrtněte volbu Zobrazit starší verze. Instalátor začne stahovat soubor a průběh zobrazí na ukazateli.

25 Instalace Visual PHP Po dokončení stahování klikněte na tlačítko Pokračovat a vyberte požadovanou verzi k instalaci. 25

26 26 Visual PHP Developer Guide Krok 5b - Výběr instalačního souboru Klikněte na tlačítko Pokračovat. Instalátor zobrazí průběh instalace souborů na server.

27 Instalace Visual PHP Po dokončení klikněte na tlačítko Pokračovat Krok 7 - Instalace databáze 27

28 28 Visual PHP Developer Guide Nyní je třeba zadat přístupové údaje k databázi. Je možné oddělit databázi jádra Visual PHP od databáze samotné prezentace. Pro oddělenou instalaci jádra do samostatné databáze zrušte volbu Stejné jako pro prezentaci a vyplňte přístupové údaje pro jinou databázi. Klikněte na tlačítko Pokračovat. Instalátor se připojí k databázi a nainstaluje do ní potřebné tabulky.

29 Instalace Visual PHP 29 Krok 8 - Zápis konfiguračních souborů Pro další ulehčení práce instalátor sám uloží informace o připojení k databázi a FTP do konfiguračních souborů Visual PHP

30 30 Visual PHP Developer Guide Krok 9 - Správa uživatelů Pro správu prezentace je nutný alespoň jeden účet skupiny Vývojáři. Vyplňte přihlašovací jméno a heslo, které bude sloužit k přístupu k prezentaci pod omezeným administrátorským účtem pro případ absence USB klíče. Pro tento účet bude automaticky aktivován vstup pod USB klíčem. Dále je možné zadat další administrátory a vývojáře. Všichni ostatní vývojáři si musí aktivovat přístup přes USB klíč po přihlášení do administrace pomocí přihlašovacího jména a hesla. Aktivace se provádí ve správci licencí (nabídka Nástroje -> Správce licencí v administraci prezentace).

31 Instalace Visual PHP Po kliknutí na tlačítko Pokračovat dojte k uložení přístupů zadaných uživatelů. Krok 10 - Dokončení 31

32 32 Visual PHP Developer Guide Instalace se zdárně podařila. Můžete přejít do administrace prezentace a začít s tvorbou. 2.2 Aktualizace jádra K aktualizaci jádra slouží stejný instalační skript install.php. Do pole pro zadání adresy v prohlížeči zadejte vaši doménu a install.php uvedeným za touto doménou (např. Otevře se Vám uvítací stránka. Krok 1 - Vítejte Pokračujte tlačítkem Spustit instalaci.

33 Instalace Visual PHP 33 Krok 2 - Kontrola systému Instalátor zkontroluje, zda server splňuje minimální požadavky pro instalaci produktu Visual PHP. Pokud jsou zjištěny nedostatky, zobrazí se červeně. Pokud jsou všechny požadavky splňeny, klikněte na tlačítko Pokračovat.

34 34 Visual PHP Developer Guide Krok 3 - Autorizace Aby bylo zabezpečeno, že instalaci provádí oprávněná osoba, je nutné se přihlásit pomocí USB klíče. Pokud máte nainstalované všechny ovladače a certifikáty, přejdete do dalšího kroku instalace.

35 Instalace Visual PHP 35 Krok 4 - Získávání informací Vyberte volbu aktualizovat jádro u této prezentace a zvolte stejný způsob instalace souborů, jaký byl použit pro instalaci prázdné prezentace. Veškeré přístupové údaje jsou načteny z konfigurace aktuálního produktu..

36 36 Visual PHP Developer Guide Krok 5 - Verze instalace Zde si vyberete instalační soubor. Nabídka může obsahovat předchozí stáhnuté instalační soubory. Novější instalační soubory můžete stáhnout ze serveru a přes FTP nahrát do stejného adresáře, kde je uložený install.php, nebo můžete využít možnost automatického stáhnutí přímo na server pomocí tlačítka Stáhnout instalaci z visual-php.com. Automatické stahování Vám ušetří spoustu času, protože to není závislé na rychlosti Vašeho připojení k internetu, ale komunikace probíhá přímo mezi servery. Tímto dosáhnete rychlosti v několika MB za sekundu

37 Instalace Visual PHP 37 Krok 5 a - stažení instalace Vyberte si verzi instalace, kterou má instalátor automaticky stáhnout a klikněte na tlačítko Pokračovat. Instalátor začne stahovat soubor a průběh zobrazí na ukazateli.

38 38 Visual PHP Developer Guide Po dokončení stahování klikněte na tlačítko pokračovat a vyberte požadovanou verzi k instalaci.

39 Instalace Visual PHP Krok 5b - Výběr instalačního souboru Vyberte požadovanou verzi instalačního souboru a klikněte na tlačítko Pokračovat. 39

40 40 Visual PHP Developer Guide Po dokončení klikněte na tlačítko Pokračovat Krok 7 - Instalace databáze

41 Instalace Visual PHP 41 Instalátor opět zjistí automaticky přístupové údaje k databázi jádra prezentace. Doporučujeme před aktualizací provést zálohu databáze zaškrtnutím volby zálohovat databázi pro případ, kdy byste se potřebovali vrátit k původní verzi databáze prezentace. Pokračujte tlačítkem Pokračovat. Krok 7a - Záloha databáze Pokud jste zvolili zálohu databáze, začne instalátor zálohovat databázi ve formě SQL dump výpisu do souboru uloženého ve stejném adresáři, jako je install.php. Soubor má název backup. nazev_databaze_prezentace.datum.sql. V případě potíží lze tento SQL soubor použít k obnově původní databáze.

42 42 Visual PHP Developer Guide Po dokončení zálohy databáze klikněte na tlačítko Pokračovat. Krok 7b - Potvrzení přepsání tabulek jádra Instalátor zobrazí původní tabulky jádra, které mají být přepsány.

43 Instalace Visual PHP 43 Pokud jsou zobrazeny pouze tabulky s prefixem _, je vše v pořádku a můžete pokračovat tlačítkem Pokračovat.

44 44 Visual PHP Developer Guide Instalátor přepíše tabulky ze starého jádra tabulkami nového jádra. Tabulky s obsahem prezentace zůstanou nedotčeny - přepisují se pouze tabulky s prefixem _, tedy tabulky samotného jádra Visual PHP. Po dokončení instalace klikněte na tlačítko Pokračovat. Krok 8 - Zápis konfiguračních souborů Pro další ulehčení práce instalátor sám uloží informace o připojení k databázi a FTP do konfiguračních souborů jádra Visual PHP

45 Instalace Visual PHP 45 Pro aktualizaci samotné prezentace je potřeba změnit cestu k novému jádru v konfiguračních souborech prezentace. Pro tuto akci klikněte na tlačítko Aktualizovat prezentaci na novou verzi jádra.

46 46 Visual PHP Developer Guide Po aktualizaci konfiguračních souborů klikněte na tlačítko Pokračovat. Krok 9 - Správa uživatelů V aktualizaci jádra je tento krok vynechán. Uživatelé byli vytvořeni při instalaci prázdné prezentace, případně v administraci. Krok 10 - Dokončení

47 Instalace Visual PHP 47 Aktualizace se zdárně podařila a můžete přejít do administrace prezentace a pokračovat v tvorbě. Na serveru zůstávají starší verze jádra a je možnost je odstranit zaškrtnutím nalezených verzí a stisknutím tlačítka Odstranit. Tento způsob čištění je opět rychlejší, než mazání pomocí FTP klienta. Krok 10a - Odstranění starších verzí jádra

48 48 Visual PHP Developer Guide Po dokončení odstranění můžete instalátor ukončit. 2.3 Přenesení projektu na jiný server Přenášení projektů mezi servery je stejně jednoduché a rychlé, jako instalace prázdné prezentace. Visual PHP vygeneruje instalační soubor, ve kterém je uložena databáze i soubory prezentace a postará se při instalaci o nastavení uživatelských práv souborů Vygenerování instalačního souboru Pro vygenerování souboru pro instalaci prezentace přejděte do nabídky Prezentace -> Vygenerovat instalaci projektu. Omezení obsahu instalačního souboru Zobrazí se seznam tabulek v databázi a seznam souborů. Pomocí těchto předvoleb můžete vyjmout některé tabulky databáze (např. statistiky, koš, atd.) a případně i soubory nebo celé adresáře z výsledného instalačního souboru, který bude vygenerován. Tím lze docílit menší velikosti instalačního souboru.

49 Instalace Visual PHP 49 Pro zahájení generování instalačního souboru klikněte na tlačítko Generovat. Stav generování instalačního souboru Ukazatel postupně zobrazuje procentuelně stav generování. Po dokončení můžete kliknutím na odkaz stáhnout výsledný.install soubor k sobě do počítače a poté jej nahrát na server například pomocí FTP Instalace projektu na jiný server K instalaci vygenerovaného projektu slouží opět stejný instalační skript install.php. Nahrejte tento soubor pomocí FTP na server. Do pole pro zadání adresy v prohlížeči zadejte vaši doménu a install.php uvedeným za touto doménou (např. Otevře se Vám uvítací stránka.

50 50 Visual PHP Developer Guide Krok 1 - Vítejte Pokračujte tlačítkem Spustit instalaci. Krok 2 - Kontrola systému Instalátor zkontroluje, zda server splňuje minimální požadavky pro instalaci produktu Visual PHP. Pokud jsou zjištěny nedostatky, zobrazí se červeně. Pokud jsou všechny požadavky splňeny, klikněte na tlačítko Pokračovat.

51 Instalace Visual PHP 51 Krok 3 - Autorizace Aby bylo zabezpečeno, že instalaci provádí oprávněná osoba, je nutné se přihlásit pomocí USB klíče. Pokud máte nainstalované všechny ovladače a certifikáty, přejdete do dalšího kroku instalace.

52 52 Visual PHP Developer Guide Krok 4 - Získávání informací Vyberte volbu přenést prezentaci na tento server (pomocí vygenerovaného.install souboru) a způsob instalace souborů (podobně jako při instalaci nového projektu).

53 Instalace Visual PHP 53 Krok 5 - Verze instalace Zde si vyberete instalační soubor. Nejprve je potřeba nainstalovat jádro Visual PHP. Je nutné použít verzi jádra stejnou nebo vyšší, než v jaké verzi byla instalovaná prezentace vytvořena. Novější instalační soubory můžete stáhnout ze serveru a přes FTP nahrát do stejného adresáře, kde je uložený install.php, nebo můžete využít možnost automatického stáhnutí přímo na server pomocí tlačítka Stáhnout instalaci z visual-php.com. Automatické stahování Vám ušetří spoustu času, protože to není závislé na rychlosti Vašeho připojení k internetu, ale komunikace probíhá přímo mezi servery. Tímto dosáhnete rychlosti v několika MB za sekundu

54 54 Visual PHP Developer Guide Krok 5 a - stažení instalace Vyberte si verzi instalace, kterou má instalátor automaticky stáhnout a klikněte na tlačítko Pokračovat. Instalátor začne stahovat soubor a průběh zobrazí na ukazateli.

55 Instalace Visual PHP Po dokončení stahování klikněte na tlačítko pokračovat a vyberte požadovanou verzi k instalaci. 55

56 56 Visual PHP Developer Guide Krok 5b - Výběr instalačního souboru Vyberte požadovanou verzi instalačního souboru a klikněte na tlačítko Pokračovat.

60 60 Visual PHP Developer Guide Krok 9 - Správa uživatelů V aktualizaci jádra je tento krok vynechán. Uživatelé byli vytvořeni při instalaci prázdné prezentace, případně v administraci. Krok 10 - Dokončení instalace jádra

61 Instalace Visual PHP Instalace jádra je dokončena, nyní lze již začít instalovat samotný projekt. Klikněte na tlačítko Pokračovat v instalaci prezentace. 61

62 62 Visual PHP Developer Guide Krok 11 - Výběr instalačního souboru prezentace Vyberte požadovanou verzi instalačního souboru a klikněte na tlačítko Pokračovat.

66 66 Visual PHP Developer Guide Krok 14 - Správa uživatelů V aktualizaci jádra je tento krok vynechán. Uživatelé byli vytvořeni při instalaci prázdné prezentace, případně v administraci. Krok 15 - Dokončení instalace jádra

67 Instalace Visual PHP 67 Instalace projektu je dokončena. 2.4 Odemknutí instalátoru pro další použití Instalátor se automaticky zamkne po dokončení instalace, aby zabránil neoprávněné instalaci a s tím spojeným poškozením dat. Zamknutí je provedeno vytvořením souboru install.lock ve stejném adresáři, kde se nachází soubor install.php. Pro odemknutí instalátoru odstraňte soubor install.lock pomocí FTP, nebo jiným způsobem a klikněte na tlačítko Obnovit.

68 Visual PHP Developer Guide Ruční přenesení projektu na jiný server V některých případech může nastat situace, že nelze použít instalátor pro přesun projektu mezi servery. Následující návod Vás navede krok za krokem, jakým způsobem lze tuto operaci provést. Je nutno podotknout, že ruční přesun se může v závislosti na rychlosti internerového připojení, případně dle množství dat na serveru, protáhnout na desítky minut až několik hodin. Doporučujeme použivat takový FTP program, který sám dokáže navázat spojení a pokračovat ve stahování (nebo nahrávání) v případě ztráty spojení. Odpadne Vám práce s hledáním, které soubory jsou již stažené (nahrané) a které nikoli. Dále doporučujeme, aby program uměl rekurzivní nastavení práv zápisu (chmod) adresářů a podadresářů a jejich souborů. Pokud vlastníte svůj vlastní server, doporučujeme nahrávat soubory a databáze přímo z tohoto serveru na cílový server (komunikace mezi těmito servery je výrazně rychlejší). Krok 1 - Stažení souborů Připojte se pomocí FTP k serveru. Přejděte do hlavního adresáře, ve kterém je uložena prezentace (typicky /, /www/, /www_root/, atd...). Označte všechny soubory a stáhněte si je na lokální disk. Není potřeba stahovat soubory z adresáře /cache/ (systém si je automaticky vytvoří při prvním spuštění prezentace na novém serveru). Krok 2 - Stažení databáze V administraci přejděte do nabídky Nástroje -> MySQL Administrator, nebo se připojte k

69 Instalace Visual PHP 69 phpmyadmin, ke kterému jste dostali přístup od svého poskytovatele webhostingu. V levém panelu vyberte databázi, která obsahuje data Vaší prezentace. V hlavním okně klikněte na Export Klikněte na Vybrat vše, zaškrtněte volbu Přidat DROP TABLE / DROP VIEW a zaškrtněte volbu Do souboru. Klikněte na tlačítko Proveď a stáhněte si vygenerovaný SQL soubor. Krok 3 - Nahrátí souborů Připojte se k FTP serveru, na který chcete přenést prezentaci a nahrejte na něj soubory a adresáře ve stejné struktuře, v jaké jste je stáhli z původního serveru. Věnujte pozornost, zda nedochází při nahrávání ke změně velkých a malých písmen (Linux servery narozdíl od Windows rozlišují soubory s malými a velkými písmeny jako samostatné soubory). Krok 4 - Nahrátí databáze Připojte k phpmyadmin na novém serveru (opět byste mělo dostat přístup od nového poskytovatele webhostingu). V levém panelu vyberte databázi, která má obsahovat data Vaší prezentace. V hlavním okně klikněte na Import.

70 70 Visual PHP Developer Guide Klikněte na tlačítko Procházet..., vyberete dříve vygenerovaný SQL soubor z lokálního disku a klikněte na tlačítko Proveď. Poznámka: Na některých serverech může být omezení maximální velikosti SQL souboru k importu. V tomto případě můžete použít rozšířené funkce instalátoru install.php k instalaci velkých SQL souborů (viz kapitola Instalace velkých SQL souborů). Krok 5 - Změna práv zápisu (chmod) Je potřeba ručně nastavit práva zápisu (chmod 777) těmto souborům, složkám, jejich podsložkám a souborům v nich obsažených /cache/ /config/version.ini /install/ /repository/ Pokud používáte v projektu jiné vlastní adresáře, které vyžadují práva zápisu, je potřeba nastavit tyto práva i těmto adresářům. Poznámka: V adresáři /repository/ je typicky velké množství adresářů a souborů. Pokud Váš FTP program neumí rekurzivní nastavení práv zápisu, je možné použít rozšířené funkce instalátoru install.php, které umožňují tyto změny pohodlně provést (v případě, že server umožňuje připojení PHP skriptů na své vlastní FTP). Krok 6 - Nastavení konfiguračního souboru Posledním krokem je nastavení konfiguračního souboru. Tento soubor config.ini.php naleznete v adresáři /config/. Soubor musí obsahovat tyto nastavení:

71 Instalace Visual PHP 71 <? // MySQL Presentation Settings $mysqlhost = "localhost"; $mysqldatabase = "my_database"; $mysqluser = "mylogin"; $mysqlpassword = "mypassword"; // MySQL Core Settings $coremysql = $coremysqlhost = $coremysqldatabase = $coremysqluser = $coremysqlpassword = $coremysqltableprefix = true; "localhost"; "my_database"; "mylogin"; "mypassword"; "_"; // Core Settings $corepath = $coreurl = "/var/www/domain.com/www/visual-php-core/enterprise "/visual-php-core/enterprise /"; // FTP Settings $ftphost = $ftplogin = $ftppassword = $ftppath = "localhost"; "mylogin"; "mypassword"; "/path_to_root/";?> V případě, že je jádro uložené ve stejné databázi jako prezentace, vyplňte SQL údaje pro prezentaci i jádro shodně (musí být obě vyplněny). Plnou cestu k adresáři jádra zjistíte tak, že si vytvoříte a nahrajete na server soubor phpinfo.php obsahující kód <? phpinfo();?>, který si v prohlížeči zavoláte ( Tento soubor vygeneruje informace o serveru. Vyhledejte frázi SCRIPT_FILENAME, která zobrazuje plnou cestu k souboru phpinfo.php. Plnou cestu k adresáři jádra získáte tak, že název souboru phpinfo.php nahradíte cestou /visual-phpcore/verze_jadra/ (tedy např. z /var/www/visual-php.com/demo/phpinfo.php získáte /var/www/ visual-php.com/demo/visual-php-core/enterprise / ) V případě, že je na serveru zapnutý SAFE_MODE, je nutné zadat i FTP přístupové údaje, aby systém mohl sám vytvářet adresáře. 2.6 Instalace velkých SQL souborů K instalaci vygenerovaného projektu slouží opět stejný instalační skript install.php. Nahrejte tento soubor pomocí FTP na server. Do pole pro zadání adresy v prohlížeči zadejte vaši doménu a install.php uvedeným za touto doménou (např. Otevře se Vám uvítací stránka.

72 72 Visual PHP Developer Guide Krok 1 - Vítejte Pokračujte tlačítkem Spustit instalaci. Krok 2 - Kontrola systému Instalátor zkontroluje, zda server splňuje minimální požadavky pro instalaci produktu Visual PHP. Pokud jsou zjištěny nedostatky, zobrazí se červeně. Pokud jsou všechny požadavky splňeny, klikněte na tlačítko Pokračovat.

74 74 Visual PHP Developer Guide Krok 4 - Získávání informací Vyberte volbu Import SQL souboru.

75 Instalace Visual PHP 75 Krok 5 - Instalační soubor Vyberte požadovaný SQL soubor a klikněte na tlačítko Pokračovat. V případě, že nevidíte soubor v nabídce, je potřeba tento soubor přenést pomocí FTP do stejného adresáře, ve kterém je soubor install. php.

76 76 Visual PHP Developer Guide Krok 6 - Instalace databáze

77 Instalace Visual PHP 77 Nyní je třeba zadat přístupové údaje k databázi. Klikněte na tlačítko Pokračovat. Instalátor se připojí k databázi a nainstaluje do ní potřebné tabulky.

78 78 Visual PHP Developer Guide Krok 10 - Dokončení instalace

79 Instalace Visual PHP 79 Instalace SQL souboru je dokončena. 2.7 Rekurzivní změna práv (chmod) souborů Instalátor se sám stará o změnu práv zápisu v adresáři /repository/ u všech souborů a podsložkách rekurzivně. V případě, že přenášíte projekt, který obsahuje jiný adresář než /repository/, kterému potřebujete nastavit práva přístupu a Váš FTP klient neumožňuje rekurzivní nastavení přístupových práv, je vhodná právě tato utilita. Tuto utilitu lze samozřejmě použít i samostatně, bez nutnosti instalovat projekt vytvořený pod Visual PHP. Krok 1 - Vítejte Pokračujte tlačítkem Spustit instalaci.

80 80 Visual PHP Developer Guide Krok 2 - Kontrola systému Instalátor zkontroluje, zda server splňuje minimální požadavky pro instalaci produktu Visual PHP. Pokud jsou zjištěny nedostatky, zobrazí se červeně. Pokud jsou všechny požadavky splňeny, klikněte na tlačítko Pokračovat.

82 82 Visual PHP Developer Guide Krok 4 - Získávání informací Vyberte volbu Rekurzivní CHMOD adresářů a způsob instalace souborů (podobně jako při instalaci nového projektu).

83 Instalace Visual PHP 83 Krok 5 - Výběr adresáře pro operaci CHMOD Z nabídky vyberte adresář, kterému budete chtít změnit přístupová práva. Přístupová práva budou rovněž změněna všech souborů, podadresářům a jejich souborům rekurzivně.

84 84 Visual PHP Developer Guide Dále vyberte práva, která chcete nastavit. V největším počtu případů je potřeba nastavit právo zápisu, tedy se doporučuje ponechat hodnotu 777. Hodnotu můžete nastavit přímo zadáním čísla v osmičkové číselné soustavě, případně zaškrtnutím požadovaných polí (způsoby zadávání hodnot jsou vzájemně provázány, zadání čísla tedy zaškrtne odpovídající pole, naopak zaškrtnutí polí vygeneruje odpovídající číslo).

85 Instalace Visual PHP Kliknutím na tlačítko Pokračovat zahájíte operaci rekurzivního CHMOD. 85

86 86 Visual PHP Developer Guide Krok 10 - Dokončení instalace

87 Instalace Visual PHP Změna práv adresářů a souborů je dokončena. 87

88 Administrace Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola III

89 Administrace 3 89 Administrace Do administrace projektu se dostanete zadáním URL adresy projektu a adresáře /admin/ (např. ). Zobrazí se následující okno: 3.1 Přihlášení pomocí USB klíče Pro úpravu a implementaci prezentace pomocí developerského účtu je nutné přihlásit se pomocí USB klíče. Pro přihlášení klikněte na ikonku klíče, která se nachází napravo od polí pro zadání jména a hesla. Zadejte heslo pro odblokování klíče. Pokud jste se již přihlašoval, heslo není nutné zadat. V prohlížeči Mozilla Firefox je potřeba vybrat z kterého úložiště má systém číst, proto vyberte etoken.

90 Visual PHP Developer Guide Přihlášení pomocí jména a hesla Ostatní uživatelé se přihlašují pomocí přihlašovacího jména a hesla. I developer má možnost přihlásit se pomocí těchto přihlašovacích údajů za těchto situací: Nemá k dispozici USB klíč a potřebuje provést admnistrativní úpravu (při přihlášení bez klíče má developer pouze práva administrátora) Má k dospozici USB klíč a potřebuje provést aktivaci tohoto klíče pro prezentaci. 3.3 Popis okna administrace Po úspěšném přihlášení se zobrazí administrace Vašeho projektu. Okno je rozděleno na následující sekce: 1. Název projektu 2. Informace o přihlášeném uživateli 3. Menu dostupné pro administraci obsahu koncovým zákazníkem 4. Menu dostupné pro implementaci prezentace developerem 5. Informace o přihlášených uživatelích, odhlášení a otevření nového okna (záložky) s administrací

91 Administrace 6. Název sekce, kde se nacházíte 7. Akce, které je možné v dané sekci nebo nad daným záznamem provést 8. Filtrace a jiné funkce 9. Hlavní obsah 10.Příkazová řádka pro urychlení některých akcí 11.Verze jádra produktu 91

92 Základy tvorby prezentací Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola IV

93 Základy tvorby prezentací 4 93 Základy tvorby prezentací V produktu Visual PHP se tvoří prezentace poněkud odlišným způsobem, než jak jste byli doposud zvyklí. Prvním krokem tvorby prezentace je vytvoření layoutu s názvem global. Tento layout obsahuje vzhled prezentace, do kterého se umísťují další dynamické prvky na Vámi určená místa. Layouty lze do sebe vzájemně vnořovat za použítí podmínek. Samozřejmostí je i tvorba CSS stylů pro čistší XHTML kód. Layout s názvem global definujete obsah uvnitř XHTML elementů <body> </body>. Více informací se dočtete v následujících kapitolách. 4.1 Vytvoření global layoutu Přejděte do nabídky Prezentace -> Layouty. V seznamu najděte layout s názvem global a klikněte na Změnit výchozí. Zobrazí se Vám výchozí global layout, který si přizpůsobíte požadavkům Vaší prezentace. Výchozí layout vypadá následovně: Stačí obsah tohoto layoutu nahradit Váším vlastním layoutem. Lze toho pohodlně dosáhnout vizuálně pomocí funkcí XHTML editoru, ale zůstává Vám možnost i psát zdrojový kód ručně. XHTML editor obsahuje například funkce pro vkládání divů, tabulek, odstavců, nadpisů, obrázků, odkazů a mnoho dalších funkcí. Prezentace se ve Visual PHP tvoří poněkud odlišným způsobem a to tak, že si připravíte základní prázdný design, do kterého budete poté postupně vkládat dynamické prvky na odpovídající místa. Tvorba prezentací ve Visual PHP nevyžaduje profesionální znalosti XHTML, CSS a PHP, takže i amatér si může vytvořit svou vlastní prezentaci. Ve Visual PHP lze ale především tvořit složité profesionální prezentace, kde už jsou nutné tyto znalosti z oboru tvorby internetových prezentací. Typický global layout může vypadat například následovně:

94 94 Visual PHP Developer Guide Docílíte toho postupným vkládáním divů (nebo i po staru pomocí tabulek) a obrázků. Na ukázkovém layoutu jsou vidět prázdná místa připravená pro vkládání dynamického obsahu. Při tvorbě layoutu doporučujeme ukládat obrázky do složky /layout/. Ve složce /layout/all/ jsou k dispozici často používané obrázky, jako například transparentní gif nebo šipky pro rozbalovací menu. Samozřejmostí je i možnost úpravy CSS stylů pro danou prezentaci o které se dočtete více v dalších kapitolách. V tomto ukázkovém designu je prostor pro záhlaví, menu, levý panel, obsahový hlavní panel, pravý panel a zápatí. Do jednotlivých panelů (a vlastně i do libovolného místa prezentace) můžete vkládat dynamický obsah, což Vám umožňuje neomezené možnosti tvorby. Slouží k tomu komponenta Table Content. Tato komponenta se stará o to, že načte z tabulky databáze data a tyto data zobrazí pomocí šablony na místo, kde je komponenta vložena. Podobně fungují i další komponenty, jako například komponenta pro menu, stránkování, výběr počtu položek na stránce, zobrazení aktuálního čísla stránky, navigace, filtrace atd.

95 Základy tvorby prezentací Vložení obsahu z databáze Pro ukázku můžeme chtít například zobrazit v prvním panelu seznam posledních tří aktualit. Stačí na dané místo umístit komponentu může vypadat následovně: Table Content a tuto komponentu nakonfigurovat. Konfigurace Zadali jsme název tabulky news, ze které chceme číst data, omezili jsme výstup na 3 záznamy a záznamy jsme seřadili podle pole date sestupně. Komponenta Table Content při zobrazení prezentace načte data z databáze (pomocí SQL dotazu SELECT * FROM news ORDER BY date DESC LIMIT 3) a tyto data zobrazí s pomocí šablony. O šablonách se dozvíte více informací v samostatné kapitole. Výsledný panel v global layoutu bude vypadat takto:

96 96 Visual PHP Developer Guide Jak je vidět, na místo komponenty bude vložený dynamický obsah podle její konfigurace. Takto lze vkládat do prezentace obsah z dalších tabulek databáze a samozřejmostí je, že tento obsah si bude moci Váš zákazník sám měnit. Jelikož je ale název tabulky databáze nastaven přímo, lze toto řešení aplikovat pouze na ten typ obsahu, který bude zobrazen na stránce stále na stejném místě, to znamená, že se nebude měnit podle toho, ve které sekci se návštěvník prezentace nachází. 4.3 Vkládání dalších layoutů V typických prezentacích jsou v každých sekcích panely, záhlaví i zápatí neměnné, pouze prostřední obsahový panel se mění v závislosti na tom, ve které sekci se uživatel nachází. Pro zobrazení informací v hlavním obsahovém panelu je potřeba vložit komponentu Include Layout, která se postará o vložení dalšího layoutu. Konfigurace komponenty Include Layout vypadá následovně. U jakýchkoli vlastností můžeme vložit hodnotu PHP proměnné pomocí direktivy {php: }. Tímto získáme dynamickou možnost vložit layout s názvem té tabulky, ve které sekci se právě nacházíme. Pokud zadáte v prohlížeči například URL bude mít tato proměnná hodnotu $tablename = "news"; (na úvodní stránce má proměnná hodnotu index, atd...). Direktiva {php: $tablename} se v tomto případě vyhodnotí jako news a komponeta Include Layout se pokusí vložit layout s názvem news. Abyste nemuseli tvořit spoustu stejných layoutů, funguje komponenta Include Layout tak, že pokud nenalezne odpovídající layout s tímto názvem, bude hledat layout s názvem

97 Základy tvorby prezentací 97 default. Po vložení této komponenty vypadá část global layoutu takto: Ve většině případů je nutné rozlišit, zda se jedná o přehled záznamů (například výpis aktualit), nebo jde o zobrazení konkrétního záznamu. K zobrazení těchto dvou typů zobrazení slouží ostatní layouty. Každý layout má svůj název (typicky podle názvu tabulky databáze nebo jejich společný layout s názvem default), typ zobrazení (přehled nebo plné zobrazení) a další možnosti nastavení. Právě to, že nezadáváme Table Content v hlavním panelu napevno, nám umožní měnit strukturu obsahového hlavního panelu v závislosti na akcích provedených návštěvníkem prezentace. Přehled (vtlist): Typicky je čtení z databáze omezeno pouze na několik položek, jsou zobrazeny čísla stránek a možnost výběru čísla stránky nebo počtu zobrazených položek na stránce. Plné (vtfull): Zde se čte již konkrétní záznam z tabulky databáze. Ovládací prvky z přehledu (jako například stránkování) zde již nejsou potřeba. Komponenta Include Layout tedy hledá nejen podle názvu, ale rozlišuje i typy zobrazení. Typ zobrazení pozná Visual PHP automaticky tak, že pokud je předán v URL parametr id nebo tid, jde o plné zobrazení. V opačném případě jde o přehled. URL zobrazí layout s nastavením Přehled (vtlist) a URL zobrazí layout s nastavením Plné (vtfull). Pokud si představíme konkrétní situaci, tak při zadání URL bude vyhodnocení komponenty Include Layout vypadat následovně:

98 98 Visual PHP Developer Guide Tedy komponenta Include Layout hledá layout s názvem news a typem zobrazení Přehled (vtlist). Ten nenalezla, tak vložila layout s názvem default a typem zobrazení Přehled (vtlist). Po vložení layoutu pokračuje tím, že začne vyhodnocovat ostatní komponenty, které jsou v tomto layoutu obsažené. Jak je vidět, jsou v tomto layoutu vložené komponenty pro zobrazení čísla stránky, výběru počtu položek na stránce, výběru stránky a zobrazení samotného obsahu pomocí komponenty Table Content. Podobně funguje i zadání URL kde bude vyhodnocení komponenty Include Layout vypadat následovně:

99 Základy tvorby prezentací 99 Opět hledá layout s názvem news, který neexistuje, vloží tedy layout s názvem default a typem zobrazení Plné (vtfull). Zde je vidět, že již nejsou přítomny další jiné komponenty kromě komponenty Table Content.

100 Nastavení prezentace Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola V

101 Nastavení prezentace Nastavení prezentace Všechny základní nastavení jsou přístupné přes nabídku Nástroje -> Nastavení. Jednotlivá nastavení jsou strukturovaná v záložkách. K dispozici jsou následující možnosti: Název prezentace Tento titulek se zobrazí v názvu okna prohlížeče na každé stránce. Vyhledávače kladou na titulek velký důraz. Za titulkem se automaticky objeví titulky konkrétních sekcí. Klíčová slova (pro vyhledávače) Tyto slova používají některé vyhledávače ke stanovení obsahu stránek. V dnešní době už vyhledávače tyto informace ignorují (např. Google nebo Seznam). Tyto klíčová slova ze zobrazí na každé stránce této prezentace. Klíčová slova oddělujte čárkou, bez mezer. Popis prezentace Je používán některými vyhledávači ke stanovení stručného popisu obsahu stránek. V dnešní době už vyhledávače tyto informace ignorují (např. Google nebo Seznam). Autor Nastaví autora stránky v meta tagu zdrojové stránky Copyright Nastaví copyright v meta tagu zdrojové stránky Jazyk Nastaví jazyk ve kterém bude zobrazována administrace. Automatická detekce jazyka Pokusí se detekovat jazyk prohlížeče a zobrazí tento jazyk jako výchozí y pro zasílání upozornění Na tyto y budou zasílány upozornění (např. při přidání příspěvku do diskuze) SMTP (server) Vyplňte název SMTP serveru, který používáte k odesílání ů. Toto nastavení je potřeba v případě, že na serveru není nakonfigurována funkce mail(). Tato nastavení můžete zjistit z Vašeho ového programu. SMTP (přihlašovací jméno) Přihlašovací jméno, které používáte k odesílání ů.

102 102 Visual PHP Developer Guide SMTP (heslo) Heslo, které používáte k odesílání ů. SMTP ( odesílatele) U některých SMTP serverů je nutné zadat skutečný . y s cizím nebo smyšleným odesílatelem některé SMTP servery odmítají odeslat. Zobrazení chyb a varování Pro větší bezpečnost proti útokům je vhodné skrýt chybové hlášky. Zobrazení se doporučuje pouze po dobu implementace prezentace. Cron (časované spouštění skriptů) Slouží pro spouštění skriptů v časovém intervalu. Cache objektů Vyrovnávací paměť pro rychlejší načítání objektů Rozšířené funkce pro datum Umožňuje zpracování datumu před rokem 1970 a po roce Licenční klíč pro Google Maps Pro použití komponenty Google Map je nutné vlastnit licenční klíč. Tento klíč můžete jednoduše získat na stránkách IP adresy vývojářů Zadejte IP adresy, ze kterých přistupují vývojáři této prezentace. Pro tyto IP adresy se budou vypisovat speciální dump() výpisy. Počet záznamů na stránce Definuje počet záznamů v zobrazení přehledu. Vyšší počet potřebuje více paměti. Šířka HTML editoru Nastaví výchozí šířku obsahu editoru. Nastavte šířku panelu obsahu. Tato vlastnost pomáhá přehlednější úpravě dokumentů, aktualit a podobně. SEO odkazy (pomocí mod_rewrite) Pokud má server podporu modulu mod_rewrite pro Apache, budou generovány odkazy formou adresářů namísto předávání parametrů za.php souborem. Texty pro SEO odkazy jsou generovány z názvů záznamů jednotlivých sekcí.

103 Nastavení prezentace 103 Hlavní doména Pokud směruje více domén na stejnou prezentaci a jednu z těchto domén chcete upřednostnit pro vyhledávače, zadejte název této domény. Přístupy z ostatních domén budou přesměrovány pomocí hlavičky 'HTTP/ Moved Permanently' na zadanou doménu. Domény 3. řádu Tyto domény nebudou směrovány na hlavní doménu. Zadejte, pokud má prezentace samostatné layouty pro více domén třetího řádu pracujícími pod stejnou databází společně s hlavní doménou. Registrace zákazníků Nastavení nutnosti registrace zákazníků před objednávkou Plátce DPH Zobrazení DPH v objednávkách. Dodací adresa Možnost zadat dodací adresu

104 Styly Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola VI

105 Styly Styly Každá moderní prezentace používá kaskádové styly (Cascading Style Sheets). CSS umožňuje definovat vlastnosti určitých elementů např. barvy textu, pozadí, zarovnání, velikost písma a mnoho dalších vlastností, které nelze nahradit ničím v html. Visual PHP samozřejmě použití CSS podporuje. Pro zobrazení a úpravu stylů přejděte do nabídky Prezentace -> Styly. Zobrazí se Vám přehled výchozích stylů pro různé situace. Visual PHP ve výchozím stavu používá styl s názvem default. Pro úpravu stylu pro Vaši prezentaci klikněte na Změnit výchozí u stylu default. K dispozici je velké množství parametrů, které lze u stylu nastavit a navíc i propracovaný editor se zvýrazněním syntaxe. Každá prezentace má jeden hlavní styl. Stylů můžeme mít i více a díky tomu docílíme například možnost přepínání různých vzhledů prezentace, pracující nad stejnou databází. Více o přepínání stylů se dočtete v jiné kapitole. Každý styl je uložen automaticky do souboru ve složce /repository/styles/. Tyto soubory neupravujte, protože budou přepsány po každé změně. 6.1 Parametry stylů U stylů je možné nastavit tyto parametry: Identifikátor (tid) Textový název stylu. Výchozí styl má název default. Pro přepínání stylů vytvořte styl s vlastním názvem. DTD Typ standardu Document Type Definition. Podmínka Zde je možné specifikovat podmínku, za jaké bude tento styl použit. Podmínkou je PHP kód (např. $mojepromenna == "mojehodnota"). Systém zkontroluje všechny styly s daným identifikátorem tid, které mají definovanou podmínku a pokud není podmínka splněna u žádného z nich, použije styl bez podmínky. Prohlížeče Ve specifických případech, kdy nechcete nebo nemůžete použít tzv. CSS hacků pro určitý prohlížeč lze nastavit pro daný styl skupinu prohlížečů. Systém použije ten styl, ve kterém je prohlížeč definován. Pokud nenalezne, použije styl bez definice prohlížečů. Ikona (favicon) Pro zobrazení ikonky v adresním řádku prohlížeče a v záložkách CSS Definice CSS stylů pomocí editoru se zvýrazněním syntaxe. 6.2 Zpracování stylů Visual PHP ve výchozím stavu používá styl s identifikátorem default. Hledá všechny styly, které splňují nastavené podmínky a odpovídají nastaveným prohlížečům. V systému jsou i výchozí styly pro y a tisk. Všechny tyto styly můžete libovolně upravovat a přidávat své vlastní.

106 Visual PHP Developer Guide Přepínání stylů Ve Visual PHP si můžete vytvořit neomezené množství stylů, které můžete přepínat. Přepínání pomocí předávání parametru Pokud chcete zobrazit stránku s jiným stylem, než je výchozí styl default, stačí vytvořit odkaz, který bude předávat parametr s názvem style a hodnotou identifikátoru tid daného stylu. Parametr style je automaticky předáván dalším podstránkám. Systém tedy automaticky upraví všechny generované odkazy tak, aby vždy obsahovaly tento parametr. Typickým použitím může být zobrazení obsahu pro tisk, stačí tedy vytvořit odkaz tak, aby obsahoval parametr style=print. Přepínání pomocí událostí Pokud nechcete nebo nemůžete použít předchozí způsob, lze nastavit styly pomocí události oninit(). Přejděte do nabídky Prezentace -> Události a založte novou událost s názvem oninit. Tato událost je spouštěna po každém načtení stránky. Do kódu přidejte nastavení proměnné $style tak, jako by byla předávána pomocí parametru v URL adrese. $style = "mujstyl"; Pomocí tohoto způsobu můžete nastavit zobrazování různých stylů podle datumu (letní, zimní vzhled), podle domény či libovolných jiných kritérií. Společný styl global V případě použití více stylů je vhodné uložit společné deklarace do samostatného stylu s identifikátorem global. Tento styl (pokud existuje) je použit pokaždé před zpracováním všech ostatních stylů. Není tedy nutné neustále dokola zapisovat stejné CSS společné všem ostatním.

107 Layouty Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola VII

108 108 7 Visual PHP Developer Guide Layouty Layouty tvoří základní stavební prvek prezentací. Definují jak bude prezentace vypadat a jak se bude chovat při zobrazení jednotlivých sekcí. Díky unikátnímu systému vizuální tvorby layoutů nejste nijak omezování při implementaci libovolného designu. Do layoutů lze umístit libovolné dynamické prvky na libovolné místo. Layouty lze do sebe vnořovat, nastavovat zobrazení pomocí podmínek, typů prohlížečů, stylů a jiných parametrů, takže máte absolutní volnost pro tvorbu. Pro zobrazení a úpravu stylů přejděte do nabídky Prezentace -> Layouty. 7.1 Parametry layoutů U layoutů lze nastavit následující možnosti Jméno Název layoutu (kromě speciálních případů jsou layouty pojmenovány podle názvu tabulky, která se má zobrazit) Způsob zobrazení Definuje, v jakém zobrazení bude layout použit. Existují 2 typy zobrazení: Plné (vtfull) - zobrazení konkrétního záznamu tabulky databáze Přehled (vtlist) - zobrazení několika záznamů tabulky databáze s možností výběru konkrétního včetně možnosti stránkování, filtrace a jiných funkcí Všechny (vtall) - zobrazení společné jak pro přehled tak pro plný záznam Jazyk U vícejazyčných prezentací můžete mít vlastní layout pro libovolný jazyk Styl Layout lze přiřadit ke stylu. Bude použit pouze pokud je styl nastaven (pomocí parametru style, nebo proměnné $style) Podmínka Zde je možné specifikovat podmínku, za jaké bude tento layout použit. Podmínkou je PHP kód (např. $mojepromenna == "mojehodnota"). Systém zkontroluje všechny layouty s daným jménem, které mají definovanou podmínku a pokud není podmínka splněna u žádného z nich, použije layout bez podmínky. Prohlížeče Layout lze nastavit i pro konkrétní typ prohlížeče. Systém použije ten layout, ve kterém je prohlížeč definován. Pokud nenalezne, použije layout bez definice prohlížečů. Typickým použitím prohlížečů u layoutů je možnost zobrazit obsah bez zbytečné grafiky pro prohlížeče v mobilních zařízeních. HTML Vizuální editor pro samotnou implementaci HTML kódu layoutu.

109 Layouty Zpracování layoutů Visual PHP ve výchozím stavu načítá layout s názvem global. Do toho layoutu se implementuje celkový vzhled prezentace. Zobrazení obsahu se provádí vkládáním příslušných dynamických komponent. Globální layout může vypadat například následovně: Je vidět, že základní nastavení designu je implementováno vizuálně pomocí HTML editoru a obsah, který má možnost upravovat koncový zákazník je zobrazen pomocí různých komponent, které představují ikonky. 7.3 Vložení vnitřního layoutu (Include Layout) Layouty lze vzájemně vnořovat. Pro umístění jiného layoutu vložte v HTML editoru na požadované místo komponentu Include Layout. Pomocí Property Editoru nastavte název layoutu, který se má vložit. Systém poté hledá layout s tímto názvem. Pokud jej nenalezne, použije layout s názvem default.

110 110 Visual PHP Developer Guide Abychom dosáhli zobrazení různého obsahu podle sekce, ve které se návštěvník nachází, je potřeba místo jména layoutu použít speciální direktivu {php: $tablename}. Systém před vložením layoutu provede vyhodnocení této proměnné a dosadí název tabulky databáze, ve které se návštěvník nachází. Pokud ho odkážeme na soubor news.php, bude mít tato proměnná hodnotu news a dojde vložení layoutu s názvem news. Obdobně to funguje pro všechny ostatní tabulky databáze. Obecně platí, že pro zobrazení určité sekce používáme odkaz na soubor, jehož název tvoří název tabulky a přípona.php. Pokud potřebujeme na stejném místě globálního layoutu zobrazit zcela jiné informace pro různé situace, je možné vytvořit 2 layouty se stejným názvem, tyto layouty poté odlišit podmínkou a do global layoutu vložit komponentu Include Layout s nastaveným názvem takovým, jaký mají ony 2 nové layouty. Typickým příkladem je zobrazení přihlašovacího formuláře pro nepřihlášené a dalších informací pro přihlášené. Jinou možností více layoutů je zobrazení panelů uprostřed (přilepených přímo k levému a pravému panelu) na úvodní stránce a dalšího obsahu s odsazením (padding) na jiných stránkách. Vnořené layouty mohou obsahovat další dynamické komponenty, případně další vnoření jiných layoutů.

111 Dynamický obsah Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola VIII

112 112 Visual PHP Developer Guide 8 Dynamický obsah 8.1 Vložení layoutu Komponenta Include Layout slouží ke vložení jiného layoutu s daným názvem. Komponenta má k dispozici tyto nastavení: Name Název layoutu, který se má vložit. Pro automatické vložení layoutu podle sekce, ve které se návštěvník nachází, zadejte {php: $tablename}. Required Pokud neexistuje layout se zadaným názvem, bude použit layout s názvem default. Parse Order V některých případech je potřeba vložit layout až po provedení všech akcí, definovaných v jiných komponentách nebo vlastních obslužných PHP kódech. Typicky mužeme mít 2 layouty pro zobrazení informací přihlášenému uživateli a přihlašovací formulář pro nepřihlášeného uživatele. Pokud obsluhujeme přihlášení v nějakém skriptu, který je např. vnořený do jiného layoutu a komponenta Include Layout tento layout se nachází až za touto komponentou, bylo by přihlášení realizováno až po zobrazení tohoto layoutu a tedy podmínka, zda je uživatel přihlášen by byla vždy nesplněna. Proto je možné nastavit u komponenty Include Layout pořadí zpracování. pofirst - komponenta bude zpracována jako první polast - komponenta bude zpracována jako poslední 8.2 Obsah tabulky databáze (Table Content) Unikátní systém vizuálních šablon produktu Visual PHP umožňuje zobrazit obsah databázových tabulek s použitím libovolného grafického designu. Systém vloží obsah tabulky na místo dynamické komponenty Table Content. U této komponenty lze nastavit velké množství vlastností od SQL fitrací až po zobrazení ve více sloupcích. Pro základní zobrazení obsahu podle sekce ve které se návštěvník nachází jsou tyto komponenty vloženy do výchozích layoutů s názvy příslušných tabulek databáze. Komponenta má k dispozici tyto nastavení: Table Name Název tabulky databáze, ze které se má vložit obsah. Pro automatické vložení názvu podle sekce, ve které se návštěvník nachází, zadejte {php: $tablename}. Pro takovéto typy dochází k zobrazení titulku stránky a další navigace, protože je tato tabulka databáze považována za hlavní. Main Content Pokud použijete přímý název tabulky databáze a nastavíte na hodnotu true, znamená to, že v titulku stránky se zobrazí informace tak, jako by šlo o hlavní tabulku podle sekce, ve které se nacházíte.

113 Dynamický obsah 113 id Zadejte, pokud potřebujete zobrazit konkrétní záznam podle id. Typicky je zobrazení určitého dokumentu na místě některého levého nebo pravého panelu. Administrátor si poté může v dokumentu upravovat obsah, aniž by zasahoval do layoutu. tid Zadejte, pokud potřebujete zobrazit konkrétní záznam podle tid. Je to přehlednější způsob vkladání obsahu, protože je jednoduší si zapamatovat např. textový identifikátor footer, než klasický UUID identifikátor. parent Používá se pro zobrazení více záznamů detail tabulky (ve vztahu master-detail mají pole parent u detail tabulky hodnotu pole id master tabulky) mid Slouží pro zobrazení kontrétního záznamu, navázaného na konkrétní položku menu iscategory Slouží pro zobrazení přehledu záznamů, navázaného na konkrétní položku menu specifikované v mid Items Per Page Nastavuje maximální počet záznamů zobrazených na stránce Column Count Definuje počet sloupců, ve kterých se budou záznamy zobrazovat Column Order Nastaví způsob, jak budou záznamy ve více sloupcích řazeny. K dispozici je řazení pod sebe (po sloupcích - vhodné u řazení podle abecedy) nebo vedle sebe (po řádcích). Column Spacing Odsazení jednotlivých záznamů v pixelech View Type Zde lze přímo nastavit o jaké zobrazení půjde (tedy jakou šablony použije systém pro zobrazení záznamů)

114 114 Visual PHP Developer Guide Filter SQL fitrace záznamů Order By SQL seřazení záznamů Group By SQL seskupení záznamů Begin Ignoruje daný počet záznamů na začátku specifikovaný v Items Per Page a zobrazí záznamy začínající tímto pořadovým číslem. Indexování začíná od nuly. Limit Používá se v kombinaci s Begin a nastavuje počet záznamů (podobně jako Items per Page). Fields Seznam polí, které se mají číst z databáze. Pokud není zadáno, čtou se všechny. Additional Fields Definuje další pole, které se přiřadí ke čteným záznamům. (např. LENGTH(name) AS name_length) Random Order Záznamy jsou vybírány náhodně. Typicky v kombinaci Items Per Page s hodnotou 1 zobrazí např. jeden náhodný obrázek. Ignored parameters Parametry s URL adresy ovlivňují načítání záznamů z databáze pro hlavní tabulky - tj ty s {php: $tablename} případně s nastaveným Main Content. Pokud potřebujete eliminovat ovlivnění zobrazení záznamů parametry z URL adresy, zadejte názvy těchto parametrů. Active Povolí nebo zakáže zpracování této komponenty. Toho můžete využít k dočasnému vypnutí, aniž byste museli komponentu odstranit. Animation Zobrazí záznamy jako animaci. Dispozici jsou 2 efekty fade - aktivní záznam po určitém intervalu vybledne a místo něj se zobrazí následující scroll - následující záznam po určitém intervalu vytlačí zobrazený záznam směrem nahoru

115 Dynamický obsah 115 Animation Timeout Interval v sekundách mezi výměnou obsahu animace Template Název vlastní šablony. Typicky chceme zobrazit např. kratší informace a jiný design pro novinky v panelu oproti zobrazení v hlavním panelu obsahu. Margin Top Odsazení záznamu v pixelech Margin Bottom Odsazení záznamu v pixelech Margin Left Odsazení záznamu v pixelech Margin Right Odsazení záznamu v pixelech Height Pro přehled lze nastavit výšku u vygenerované tabulky Condition Komponenta zobrazí obsah pouze při splnění PHP podmínky Ukázka nastavení komponenty Table Content, která vloží obsah prvních 3 záznamů tabulky news seřazených podle datumu sestupně:

116 116 Visual PHP Developer Guide Komponentou Table Content nastavujete, co se má na daném místě zobrazit. Jak se to má zobrazit definujete následně v šablonách. O šablonách se dočtete více v samostatné kapitole. Pokud jde o Table Content pro hlavní tabulku - tedy s nastavením {php: $tablename}, jsou automaticky použity parametry z ostatních komponent (např. page, itemsperpage, filtrace atd...) 8.3 Procházení stránek (Browse Pages) Aby mohli návštěvníci pohodlně procházet jednotlivé skupiny záznamů, je k dispozici komponenta pro stránkování. Na místo v layoutu vložte komponentu Browse Pages. Tato komponenta automaticky předává parametr page, která je použita pro stránkování dané tabulky (např. news.php?page=1). K dispozici jsou tyto nastavení: Table Name Název tabulky. Abyste dosáhli správného přiřazení, použijte stejné nastavení jako u Table Content. Zadejte tedy přímý název tabulky nebo {php: $tablename}, tedy naprosto shodně s kompoentou Table Content. Limit Maximální počet zobrazených čísel stránek

117 Dynamický obsah 117 Separator Oddělovač jednotlivých odkazů (výchozí je mezera) Display Caption Zobrazí popisek Stránky: v daném jazyce Display First Zobrazí odkaz pro přechod na první stránku Display Prior Zobrazí odkaz pro přechod na předchozí stránku Display Next Zobrazí odkaz pro přechod na následující stránku Display Last Zobrazí odkaz pro přechod na poslední stránku Class Definuje název CSS třídy pro použití v odkazu 8.4 Informace o čísle stránky (Page of Pages) Tato komponenta zobrazí informaci, ve které stránce se momentálně návštěvník nachází. Na místo v layoutu vložte komponentu Page of Pages. K dispozici jsou tyto nastavení: Table Name Název tabulky. Abyste dosáhli správného přiřazení, použijte stejné nastavení jako u Table Content. Zadejte tedy přímý název tabulky nebo {php: $tablename}, tedy naprosto shodně s kompoentou Table Content Class Definuje název CSS třídy pro použití v odkazu 8.5 Výběr počtu položek na stránce (Items per Page) Počet zobrazených záznamů na stránce můžete předdefinovat, lze ale umožnit i návštěvníkovi pohodlně vybrat z nabídky. Na místo v layoutu vložte komponentu Items per Page.

118 118 Visual PHP Developer Guide K dispozici jsou tyto nastavení: Table Name Název tabulky. Abyste dosáhli správného přiřazení, použijte stejné nastavení jako u Table Content. Zadejte tedy přímý název tabulky nebo {php: $tablename}, tedy naprosto shodně s kompoentou Table Content Values Definuje možné hodnoty výběru. Class Definuje název CSS třídy pro použití v odkazu 8.6 Filtrace záznamů Obsah tabulek lze filtrovat podle libovolného pole a podle libovolného kritéria. Slouží k tomu komponenta Filter Item. Ve výchozím stavu zobrazuje tato komponenta nabídku ve formě rozbalovací nabídky s výběrem možných hodnot. K dispozici jsou tyto nastavení: Table Name Název tabulky. Abyste dosáhli správného přiřazení, použijte stejné nastavení jako u Table Content. Zadejte tedy přímý název tabulky nebo {php: $tablename}, tedy naprosto shodně s kompoentou Table Content. Field Name Název pole tabulky, které chcete filtrovat. Component Type Slouží pro změnu výchozího typu komponenty. Component Parameters Další parametry komponenty.

119 Dynamický obsah 119 All Existing Values Pokud zadáte, budou zobrazeny všechny možné hodnoty, které může pole tabulky databáze obsahovat. Jinak se zobrazí pouze ty hodnoty, které byly zadány. Fulltext Filtrace probíhá fulltextově Operator Výchozí operátor je =. Pokud filtrujete pole s čísly, můžete zadat např. >, >=, <, <= Parent Fields Slouží pro nastavení filtrování polí, které jsou vzájemně provázané do struktury. Width Šířka komponenty Class Definuje název CSS třídy pro HTML prvek vytvořený komponentou onchange JavaScript kód, který se zavolá při výběru hodnoty návštěvníkem (např odeslání formuláře) 8.7 Navigace Navigace slouží k zobrazení toho, kde se návštěvník momentálně nachází. U sekcí se stromovou strukturou jsou zobrazeny i podsekce. Pro vložení navigace vložte komponentu K dispozici jsou tyto nastavení: Navigation.

120 120 Visual PHP Developer Guide Table Name Název tabulky. Abyste dosáhli správného přiřazení, použijte {php: $tablename}. Use Menu Captions Specifikuje, zda se mají použít názvy z menu, nebo názvy z konkrétního záznamu tabulky Display Home Zapíná a vypíná zobrazení odkazu pro návrat na úvodní stránku Display Path Zapíná a vypíná zobrazení cesty Display Title Zapíná a výpíná zobrazení titulku aktuálního záznamu v hlavní tabulce Class Definuje název CSS třídy pro použití v odkazu 8.8 Menu Pro zobrazení nabídky je k dispozici vizuální komponenta Menu. Tato komponenta poskytuje velké množství nastavení chování i vzhledu a stará se o zobrazení stromové struktury z tabulky databáze menu a stará se automaticky o tvorbu správných odkazů. K dispozici jsou tyto nastavení: Globální nastavení

121 Dynamický obsah 121 Table Name Název tabulky pro potřeby zobrazení menu z vlastní tabulky databáze. Type Určuje typ zobrazení menu. horizontal - horizontální menu, jehož hlavní položky se zobrazují vedle sebe a podpoložky se rozbalují směrem dolů vertical - vertikální menu, jehož hlavní položky se zobrazují pod sebe a podpoložky se rozbalují směrem doprava tid určuje textový identifikátor položky menu, ze které se mají zobrazovat data. Tohoto lze využít v tom případě, že potřebujete mít více menu ze stejného zdroje. Jako hlavní položky jsou zobrazeny podpoložky záznamu menu, který má tento textový identifikátor. Width Definuje šířku celého menu Height Definuje výšku celého menu Transparency Definuje průhlednost rozbalovacích nabídek. Při hodnotě 100 bude nabídka neprůhledná. Expand Top Level Po kliknutí na jednu z hlavních položek nabídky se ve vertikálním menu jeho podnabídka zobrazí pod touto položkou. true - rozbalí se po kliknutí na určitou hlavní položku, ostatní položky zůstanou zabalené always - rozbalí se všechny hlavní položky menu Menu Object Name Zde lze nastavit název vlastního objektu, který obsahuje stromovou strukturu pro menu Nastavení pro hlavní položky menu Text align Nastavuje zarovnání textu v položce Text case Nastavuje, zda se zobrazí text tak, jak byl zadán, nebo budou písmena konvertována na malá nebo velká Multiline Povolí nebo zakáže zobrazení textu na více řádků

122 122 Visual PHP Developer Guide Vertical Align Nastavuje vertikální zarovnání textu v položce Width Definuje šířku samotné položky menu Height Definuje výšku samotné položky menu Background Color Definuje barvu pozadí položky Background Color (over) Definuje barvu pozadí položky po najetí myší Background Color (active) Definuje barvu pozadí položky, pokud se nacházíme v sekci, na kterou tato položka odkazuje Background Image Definuje obrázek na pozadí položky Background Image (over) Definuje obrázek na pozadí položky po najetí myší Background Image (active) Definuje obrázek na pozadí položky, pokud se nacházíme v sekci, na kterou tato položka odkazuje Text Style Nastavuje styl písma Text Weight Nastavuje šířku písma Text Size Nastavuje velikost písma Text Font Family Nastavuje font, kterým bude písmo vykresleno Text Line Height Nastavuje výšku řádku u víceřádkových položek

123 Dynamický obsah Text Color Definuje barvu písma Text Color (over) Definuje barvu písma po najetí myší Text Color (active) Definuje barvu písma, pokud se nacházíme v sekci, na kterou tato položka odkazuje Padding Definuje vnitřní odsazení položky menu Spacing Definuje vnější odsazení položky menu Inner Padding (Left, Right, Top, Bottom) Definuje vnitřní odsazení textu od pozadí položky Arrow Image Definuje obrázek s šipkou, která se zobrazí u položek, které mají podmenu Arrow Image (over) Definuje obrázek s šipkou, která se zobrazí po najetí myší u položek, které mají podmenu Arrow Padding (Left, Right, Top, Bottom) Definuje odsazení šipky Border Color Definuje barvu rámečku položky menu Border Color (over) Definuje barvu rámečku položky menu po najetí myší Border Width Definuje šířku rámečku Separator Image Definuje obrázek oddělovače, který se zobrazí mezi jednotlivými položkami Separator Image Width Definuje šířku oddělovače 123

124 124 Visual PHP Developer Guide Separator Image Height Definuje výšku oddělovače Nastavení pro podmenu Width Šířka podmenu Height Výška podmenu Background Color Barva pozadí podmenu Border Color Barva rámečku podmenu Border Width Šířka rámečku podmenu Position X (relative) Specifikuje posunutí podmenu horizontálně. Kladné hodnoty posunou směrem doprava, záporné směrem doleva Position Y (relative) Specifikuje posunutí podmenu vertikálně. Kladné hodnoty posunou směrem dolů, záporné směrem nahoru Show Pause (ms) Nastavuje časovou prodlevu pro rozbalení podmenu Hide Pause (ms) Nastavuje časovou prodlevu pro skrytí podmenu Expand Type Určuje, jakým způsobem půjde podmenu rozbalit on mouse over - podmenu se zobrazí po najetí myší nad nadřazenou položku on mouse click - podmenu se zobrazí až po kliknutí myší na nadřazenou položku Nastavení pro položky podmenu

125 Dynamický obsah 125 Tyto nastavení jsou shodná s nastavením pro hlavní položky menu Flash Položky menu může tvořit i flashová animace. Přípravě položek menu ve flashi se budeme věnovat v samostatné kapitole. All Levels Definuje flash pro všechny úrovně stromu menu Level (1, 2, 3, 4, 5) Definuje flash pro konkrétní úroveň stromu menu Správa obsahu menu v administraci Pro úpravu položek menu je potřeba přidat do Admin Menu položku, která bude odkazovat na správu databázové tabulky menu. Přejděte do nabídky Prezentace -> Admin Menu a přidejte nový záznam s názvem menu. Po uložení se v menu administrace zobrazí nová položka s názvem Menu. Po kliknutí na tuto položku můžete spravovat obsah menu, který se zobrazí pomocí této komponenty Menu.

126 Šablony Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola IX

127 Šablony Šablony Vizuální šablony poskytují neomezené možnosti při implementaci prezentace. Každý výstup z komponenty Table Content je zpracováván pomocí šablony. Jednotlivé záznamy, který mají být zobrazeny jsou zpracovány šablonou a poté poskládány za sebe, pod sebe nebo do sloupců. Šablony lze rozdělit do dvou skupin: šablony pro přehled záznamů (vtlist) šablony pro zobrazení plného záznamu (vtfull) Pokud je předán v URL parametr id u hlavního obsahu, nebo přímo zadán v komponentě Table Content, dojde k načtení pouze jednoho záznamu s tímto id a použije se vtfull zobrazení. Jinak se načte více záznamů a zobrazí se jeden po druhém pomocí šablony typu vtlist Ukázka zpracování šablony V ukázce jsou zobrazeny 4 záznamy pomocí šablony. Jak je vidět, postupně je za pole tabulky databáze doplňován jejich obsah. V tabulce jsou pro text definovány 2 pole - description pro krátký popis a text pro celý text. V přehledu chceme zobrazit pouze krátký text až po kliknutí na odkaz zobrazit text celý. Šablona pro přehled

128 128 Visual PHP Developer Guide Výsledek zpracování šablony pro přehled Šablona pro plné zobrazení Výsledek zpracování šablony pro plné zobrazení

129 Šablony 129 Odkazy pro plné zobrazení se definují tak, že přímo do odkazu se vloží samotné pole - tedy odkazujeme na news.php?id=[id]. Po zpracování šablony dojde k nahrazení [id] reálnou hodnotou tohoto pole v záznamu databáze. 9.1 Parametry šabon U šablon lze nastavit následující možnosti Jméno Název šablony (typicky jsou pojmenovány podle názvu tabulky, ke které patří). Pokud potřebujete zobrazit vlastní šablonu, zadejte jí svůj název a v komponentě Table Content zadejte do Template název této šablony. Způsob zobrazení Definuje, v jakém zobrazení bude layout použit. Existují 2 typy zobrazení: Plné (vtfull) - zobrazení konkrétního záznamu tabulky databáze Přehled (vtlist) - zobrazení několika záznamů tabulky databáze s možností výběru konkrétního včetně možnosti stránkování, filtrace a jiných funkcí Jazyk U vícejazyčných prezentací můžete mít vlastní šablonu pro libovolný jazyk Styl Šablonu lze přiřadit ke stylu. Bude použita pouze pokud je styl nastaven Podmínka Zde je možné specifikovat podmínku, za jaké bude tuto šablonu použit. Podmínkou je PHP kód (např. $mojepromenna == "mojehodnota"). Systém zkontroluje všechny šablony s daným jménem, které mají definovanou podmínku a pokud není podmínka splněna u žádného z nich, použije šablonu bez podmínky. Prázdný Speciální šablona pro zobrazení v případě, že nebyl nalezen žádný záznam pro tabulku databáze. Typicky je v takovéto šabloně zobrazen text, který oznamuje, že žádné záznamy nebyly nalezeny. Prohlížeče Layout lze nastavit i pro konkrétní typ prohlížeče. Systém použije tu šablonu, ve kterém je prohlížeč definován. Pokud nenalezne, použije šablonu bez definice prohlížečů. Typickým použitím prohlížečů u šablony je možnost zobrazit obsah bez zbytečné grafiky pro prohlížeče v mobilních zařízeních. HTML Vizuální editor pro samotnou implementaci HTML kódu šablony.

130 Visual PHP Developer Guide Zpracování šablon Pro každý záznam, který se má zobrazit pomocí komponenty Table Content je zpracována nastavená šablona. V šabloně se definuje jak design, tak i obsah, který se má zobrazit. Díky VPCL komponentám lze zobrazovat obsah uložený v databázi v různých podobách. Pro vložení obsahu pole tabulky databáze uzavřete název tohoto pole do hranatých závorek (např. [name] pro zobrazení hodnoty pole name). Každá komponenta ma navíc i další pomocné funkce pro zobrazení (např. komponenta DATETIME má funkce pro zobrazení datumu - getdate(), času - gettime(), atd...) Pokud neznáte názvy všech polí, podívejte se pomocí nabídky Prezentace -> Tabulky a vyberte Pole tabulky u příslušné tabulky databáze. Zde zjistíte jak názvy polí tak i přiřazené VPCL komponenty. Pokud potřebuje mít výstup ve formě tabulky, lze vytvořit v šabloně tabulku se záhlavím a zápatím. Pro první záznam bude použito záhlaví a první řádek tabulky, pro poslední záznam bude použit řádek tabulky a zápatí. 9.3 Podmínky v šablonách Podmíněného zobrazování lze ve Visual PHP docílit několika způsoby. Condition ve vlastnotech šablony Pomocí nastavení condition můžeme specifikovat, která šablona se má pro daný záznam použít. V poli condition můžeme použít proměnnou $recordvalues, která obsahuje hodnoty tak, jak jsou uloženy v databázi. Například můžeme vytvořit 2 šablony vtlist pro tabulku news tak, že pokud uživatel vyplní pole description, bude zobrazeno, a pokud ne, tak bude zobrazeno pole text. Pro první šablonu, která má zobrazit description, nastavíme podmínku $recordvalues["description"]!= "". Pro druhou šablonu už podmínku nebudeme nastavovat, protože bude použita právě v tom případě, kdy předchozí podmínka není splněna. Při zpracovávání jednotlivých záznamů bude použita jedna nebo druhá šablona. Podmínky v šabloně Pro případy, kdy se nechceme vytvářet více šablon lze použít podmínky uvnitř HTML šablony. Zde již využíváme samotných komponent. Pro příklad, kdy chceme zobrazit pole description nebo text, lze použít této podmínky: {#if [description.hasvalue()]}[description]{#else}[text]{#endif} Systém vyhodnotí podmínku zadanou v {#if} a pokud je splněna, použije hodnotu definovanou za ní. Jinak

131 Šablony 131 použije hodnotu za {#else} Podmínky v XHTML šablony Pokud potřebujete zobrazovat nebo nezobrazovat celý blok (např. element <div>) je možné nastavit celému bloku podmínku. Jednoduše to lze provést označením celého bloku a kliknutím na tlačítko Condition. Po zadání podmínky se celý blok orámuje zeleným rámečkem pro přehlednost. Podmínky lze udělat i ručně v editaci XHTML kódu. Slouží k tomu speciální atribut condition. <div condition="[description.hasvalue()]">[descrioption]</div> <div condition="[text.hasvalue()]">[text]</div> Podmínky ve vloženém PHP kódu Pro složité podmínky je vhodné použít PHP kód. Na potřebné místo jej stačí vložit pomocí tlačítka PHP kód. Do něj lze již vložit vlastní kód pro zpracování podmínek. if ([description.hasvalue()]) return("[description]"); else return("[text]"); Ve všech podmínkách jsou nejprve zpracovány komponenty, a až poté je vyhodnocován kód pro podmínku. Proto je nutné uzavřít textové hodnoty do uvozovek - viz. return("[description]")

132 Tabulky Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola X

133 Tabulky Tabulky Ve Visual PHP jsou klasické databázové tabulky zapouzdřeny do samostaných objektů. Tyto objekty obsahují rozšíření oproti základním tabulkám v databázi. Lze u nich nastavit způsoby chování, automatické filtrace, zobrazení titulků a v neposlední řadě i vzájemné vztahy jako například masterdetail. Každá tabulka obsahuje samozřejmě pole a i tyto pole jsou představovány jako objekty, které jsou rozšířené oproti základním polím databází. O polích se dozvíte více informací v samostatné kapitole Přehled tabulek Pro přehled výchozích tabulek přejděte do nabídky Prezentace -> Tabulky. Zobrazí se Vám seznam tabulek ve stromové struktuře. Tato struktura zobrazuje vztahy mezi tabulkami (master-detail, extended,...). Každá tabulka má k sobě vytvořený.php soubor podle názvu této tabulky. Chcete-li zobrazit například obsah tabulky news, stačí zadat do prohlížeče URL php Parametry tabulek U tabulek lze nastavit následující možnosti Základní Název tabulky Název databázové tabulky Název tabulky (SQL) Skutečný název tabulky v databázi. Pokud nebude zadán, použije se název tabulky. Této možnosti můžete využít například k tomu, abyste nemuseli předělávat layouty a šablony, pokud potřebujete napojit jinou tabulku pod stejným názvem. Titulek (textový název) Název tabulky, který se zobrazí koncovému zákazníkovi. Pro vícejazyčné překlady použijte Prezentace > Jazyky -> Překlady Databázové připojení Vyberte, pokud chcete napojit tabulku z externí databáze. Databázová připojení lze nastavit v Prezentace -> Databázová připojení Typ Zde je možné nastavit typ tabulky standardní tabulka - klasická databázová tabulka s poli

134 134 Visual PHP Developer Guide výčtová tabulka - tabulka, která má pouze 2 pole (name, value). Po načtení záznamů dojde k přiřazení názvů a hodnot podobně jako u standarní tabulky. Množství takovýchto virtuálních polí je ale neomezené tabulka v paměti RAM - tato tabulka nečte z databáze, ale lze ji naplnit daty a tyto poté zobrazit pomocí komponenty Table Content Externí tabulka Zaškrtněte tuto volbu, pokud chcete z tabulky číst, ale chcete zabránit jakékoli modifikaci její struktury. Typicky jde o tabulky, které jsou načítány pomocí databázového připojení z externích zdrojů. Jakékoli modifikace polí nad touto tabulkou nebudou ovlivňovat strukturu samotné tabulky v databázi. Soubor Každá tabulka má k sobě přiřazen.php soubor s názvem shodným s názvem tabulky. Zadejte, pokud chcete použít jiný název souboru Vyhledávání Nastaví, zda bude tabulka zahrnuta do fulltextového vyhledávání Typ zachování historie U tabulek je možné nastavit, aby zachovávaly historii změn. To jakým způsobem budou změny uloženy nastavíte výběrem jedné z možností bez historie - historie se neukládá zachovat id v záznamu - původní odkazy budou směrovat vždy na aktuální záznam. Nejnovější verze záznamu má vždy stejné id a původní záznamy dostanou nové id. zachovat id v historii - původní odkazy budou směrovat vždy na původní záznamy před modifikací. Nejnovější verze záznamu má vždy nové id a původním záznamům id zůstanou. Pokud nastavíte typ historie, je potřeba tabulku rozšířit o nové pole s názvem history, SQL typem TEXT a komponentou HISTORY. Do tohoto pole jsou ukládány informace o historii záznamu. RSS Z každé tabulky je možné vygenerovat RSS soubor. Stačí pouze nastavit, ze kterých polí se má tento RSS soubor generovat. Common: File Name - název souboru, kam bude RSS generováno Limit - maximální počet generovaných záznamů Filter - SQL filtrace záznamů Order By - SQL řazení záznamů Channel (required): Title - název RSS kanálu Link - odkaz RSS kanálu Description - popis RSS kanálu Channel (optional): Copyright - autorské informace Managing Editor - Jméno redaktora Webmaster - Jméno webmastera

135 Tabulky 135 Items: Title - název pole pro titulek Description - název pole pro popis Date - název pole pro datum Author - název pole pro autora, nebo vlastní text Comments - název pole pro komentáře, nebo vlastní text Relace Master tabulka Název databázové tabulky, která je nadřazená této tabulce (typicky jde o tabulku, se kterou se chceme provázat pomocí master-detail) Pole obsahující název master tabulky Název pole, ve kterém je uložen název master tabulky (toho lze využít u multidetail tabulky, která je detail tabulkou několika master tabulek) Master pole Název pole v master tabulce, jehož hodnota bude uložena do detail pole v detail tabulce (typicky jde o pole id) Detail pole Název pole v této tabulce, které odkazuje na záznam v master tabulce (typicky jde o pole parent) Klíčové pole (strom) Název pole, jehož hodnota bude uložena do Pole pro nadřazený záznam. Tohoto je využito při tvorbě tabulek, které se chovají jako strom. (typicky jde o pole id) Pole pro nadřazený záznam (strom) Název pole, které odkazuje na nadřazený záznam v hiearchii stromu (typicky jde o pole id) Více informací o vztazích master-detail, multidetail a tree naleznete v samostatných kapitolách. SQL Filtrace (www) Nastavení SQL filtrace, která bude použita jako výchozí v prezentaci Filtrace (admin) Nastavení SQL filtrace, která bude použita jako výchozí v administraci Řazení (Order By) Nastavení SQL řazení, která bude použito jako výchozí v prezentaci i administraci

136 136 Visual PHP Developer Guide Povolit vkládání Nastavení, zda bude umožněno vkládat nové záznamy Povolit úpravy Nastavení, zda bude umožněno upravovat záznamy Povolit odstranění Nastavení, zda bude umožněno odstranění záznamů Zobrazení Titulek pro přehled (vtlist) Zde můžete specifikovat, jaký titulek se zobrazí v <title> za názvem prezentace v přehledu. Titulek pro plné zobrazení (vtfull) Zde můžete specifikovat, jaký titulek se zobrazí v <title> za názvem prezentace v plném zobrazení. Aby se zobrazily i informace z databáze, lze použít {php: $recordvalues["field name"]} Pole zobrazená v přehledu (administrace) Pouze tyto pole se zobrazí v přehledu záznamů v administraci Pole zobrazená v editaci (administrace) Pouze tyto pole se zobrazí v editaci záznamu v administraci Pole pro filtraci (administrace) Podle těchto polí bude umožněna filtrace v levém panelu v přehledu záznamů v administraci Pole pro filtraci podle počátečních písmen (administrace) Tyto pole bude možné filtrovat podle počátečního písmene v levém panelu v přehledu záznamů v administraci Skrytá pole (administrace) Tyto pole budou v administraci skrytá Reporty Umožní univerzální filtraci záznamů a tím tvorbu libovolných reportů Náhled Zobrazí odkaz pro náhled záznamu

137 Tabulky 137 Popis Popis tabulky SEO SEO mapování odkazů Nastavení, zda bude pro tuto tabulku generováno mapování odkazů pro SEO Pole pro text odkazu Specifikuje pole, ze kterého se vytvoří text SEO odkazu Pole pro popis stránky Specifikuje pole, ze kterého se bude generovat popis stránky pro tag <description> Pole pro klíčová slova stránky Specifikuje pole, ze kterého se budou generovat klíčová slova pro tag <keywords> Více informací o SEO optimalizaci ve Visual PHP se dočtete v samostatné kapitole. Události Aby bylo možné prezentaci ve Visual PHP přizpůsobit vlastním potřebám, je možné vkládat vlastní zdrojový kód, který bude vykonán při určitých událostech prováděných s tabulkou. oninsert tato událost se volá při vložení nového záznamu do tabulky onupdate tato událost se volá při úpravě záznamu v tabulce ondelete tato událost se volá při odstranění záznamu z tabulky ondisplay tato událost se volá při zobrazení záznamu onfilter touto událostí můžete vrátit SQL filtraci onchange tato událost se volá při změně záznamu (vložení, úpravě nebo odstranění)

138 138 Visual PHP Developer Guide oncustomchange touto událostí můžete sami obsloužit vkládání, úpravu nebo odstranění ongetactions tato událost přidá do prvního sloupce v přehledu administrace další odkazy ongetcontent pokud vyplníte tuto událost, nebude výstup z komponenty Table Content generován automaticky, ale použije se výstup skriptu v této události 10.3 Master-Detail Tabulky Relace Master-Detail je běžně používaná relace vyjadřující vztah 1:N mezi dvěma tabulkami. Detail tabulka obsahuje pole, které odkazuje na identifikátor záznamu z master tabulky. Jak je vidět na ukázce, je detail tabulka rozšířena o pole parent, do kterého je ukládán identifikátor z master tabulky. Pole parent tedy představuje vazbu, podle které můžeme poznat, které záznamy z detail tabulky patří k určitému záznamu v master tabulce. Pro představu je tohoto vztahu použito například u anket, kde v master tabulce votes jsou ankety a v detail tabulce vote_items jsou jednotlivé odpovědi v anketě, navázané na konkrétní záznam v master tabulce votes. Detail tabulku vytvoříte jednoduše tak, že nastavíte tabulce následující parametry v záložce relace: Master tabulka - název tabulky, pro kterou bude tato tabulka detail tabulkou Master pole - název pole v master tabulce, jehož hodnota bude sloužit pro master-detail vazbu (typicky jde o identifikátor id v master tabulce) Detail pole - název pole v detail tabulce, do kterého se bude ukládat hodnota z master pole. Toto pole představuje vazbu, pomocí které poznáme, které záznamy patří k nadřazenému záznamu z master tabulky V přehledu tabulek (Prezentace -> Tabulky) se detail tabulky zobrazí ve stromové struktuře. Jsou tedy už na první pohled vidět vzájemné vztahy mezi tabulkami. Visual PHP umožňuje pohodlně spravovat detail záznamy pomocí komponenty DETAILTABLE. Tato

139 Tabulky 139 komponenta se přiřadí k virtuálnímu poli v master tabulce a zobrazí všechny záznamy z detail tabulky s možností pohodného vkládání, editace a odstraňovanání záznamů. Dále je automaticky v administraci vytvořen odkaz na přehled záznamů detail tabulky, který se zobrazí v prvním sloupci pod akcemi u jednotlivých záznamů Multi-Detail tabulky Relace Multi-Detail je rozšířením relace Master-Detail s tím rozdílem, že detail tabulka je navázána na libovolný počet master tabulek. Tato relace přináší obrovskou výhodu v tom, že pokud má mít více tabulek své detail tabulky se stejnou strukturou dat, není nutné tyto detail tabulky vytvářet pro každou master tabulku zvlášť. Jak je vidět na ukázce, je detail tabulka rozšířena nejen o pole parent, do kterého je ukládán identifikátor z master tabulky, ale i o pole tablename, do kterého je ukládán název master tabulky. Pole parent tedy představuje vazbu, podle které můžeme poznat, které záznamy z detail tabulky patří k určitému záznamu v master tabulce a pole tablename určuje, o kterou master tabulku jde. Pro představu je tohoto vztahu použito například u diskuzí, kde lze diskuze přiřadit k libovolné tabulce, tedy libovolná sekce může obsahovat svou diskuzi. Multi-Detail tabulku vytvoříte jednoduše tak, že nastavíte tabulce následující parametry v záložce relace: Pole obsahující název master tabulky - název pole v detail tabulce, které bude obsahovat název master tabulky Master pole - název pole v master tabulce, jehož hodnota bude sloužit pro master-detail vazbu

140 140 Visual PHP Developer Guide (typicky jde o identifikátor id v master tabulce) Detail pole - název pole v detail tabulce, do kterého se bude ukládat hodnota z master pole. Toto pole představuje vazbu, pomocí které poznáme, které záznamy patří k nadřazenému záznamu z master tabulky V přehledu tabulek (Prezentace -> Tabulky) se multi-detail tabulky nezobrazují ve stromové struktuře. Není totiž možné jednoznačně identifikovat, ke které tabulce má detail tabulka relaci. To je známo až z konkrétních hodnot v záznamu této tabulky. Visual PHP umožňuje pohodlně spravovat detail záznamy pomocí komponenty DETAILTABLE. Tato komponenta se přiřadí k virtuálnímu poli v master tabulce a zobrazí všechny záznamy z detail tabulky s možností pohodného vkládání, editace a odstraňovanání záznamů. Dále je automaticky v administraci vytvořen odkaz na přehled záznamů detail tabulky, který se zobrazí v prvním sloupci pod akcemi u jednotlivých záznamů Tree tabulky Zobrazení a ukládání dat ve stromové struktuře bývá obvykle problémem z toho důvodu, že je nutné uložit hiarchicky řazená data do tabulky databáze, která ukládá data v "plochém" formátu. Ve Visual PHP lze jednoduše vytvářet i tabulky se stromovou strukturou. Jak je vidět na ukázce, je tabulka rozšířena o pole parent, ve kterém je uložen identifikátor nadřazeného záznamu (tedy odkazuje na nadřazený záznam) a pomocné pole parentlist a childlist, ve kterých je uložen seznam nadřazených a podřízených položek v hiearchii. Záznamy 1 a 5 nemají hodnotu v poli parent, tedy jsou na vrcholu hiearchie. Záznamy 2 a 3 mají hodnotu 1 v poli parent, tedy jsou podřízené záznamu 1. Záznam 4 má hodnotu 3 v poli parent, tedy je podřízený záznamu 3. Podobně je to i u ostatních záznamů. Pokud se podíváme na záznam 4, je vidět, že má v poli parentlist hodnotu 3 1, tedy seznam všech nadřazených záznamů až k vrcholu hiearchie. Pokud se podíváme na záznam 1, je vidět, že má v poli childlist hodnotu 2 3 4, tedy seznam všech podřízených záznamů. Pole childlist se využívá například ke zjištění, zda má záznam nějaké podzáznamy bez toho, aby bylo nutné číst další záznamy z databáze. Pole parentlist lze využít při různých filtracích. Tree tabulku vytvoříte jednoduše tak, že nastavíte tabulce následující parametry v záložce relace: Klíčové pole (strom) - název pole v tabulce, jehož hodnota se bude ukládat do pole pro nadřazený záznam (typicky jde o pole id) Pole pro nadřazený záznam (strom) - název pole, do kterého se bude ukládat hodnota z klíčového

141 Tabulky 141 pole. Toto pole představuje vazbu, pomocí které poznáme, ke kterému záznamu je záznam podřízený Pro představu je tohoto vztahu použito například u menu nebo admin menu, které mají hiarchickou strukturu Property tabulky Tyto tabulky slouží k uložení velkého množství záznamů typu název=hodnota. Po načtení dat do tabulky se vytvoří jediný záznam s poli nazvanými tak, jako jsou názvy v jednotlivých záznamech. Hodnoty těchto polí jsou vyplněny hodnotami v těchto záznamech. Jak je vidět na ukázce, obsahuje tabulka pole name pro název pole a pole value pro hodnotu pole. Po načtení se vytvoří záznam který převede hodnoty polí name a value v jednotlivých záznamech na jediný záznam simulující skutečné pole v tabulce. Property tabulku vytvoříte jednoduše tak, že nastavíte tabulce následující parametry v záložce základní: Typ - výčtová tabulka Pole name a value budou vytvořeny automaticky. Dále je potřeba vytvořit virtuální pole pro tuto tabulku.

142 Pole tabulek Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XI

143 Pole tabulek Pole tabulek Pole tvoří nedílnou součást databázových tabulek. Pole jsou ve Visual PHP opět tvořeny jako objekty, které tyto pole rozšiřují o další vlastnosti. Největší přínos tvoří komponenty, přiřazené k těmto polím. Díky těmto komponentám lze rozšířit základní datové typy SQL databáze o vizuální prvky, které Vám usnadní vlastní tvorbu administračního rozhraní pro Vašeho koncového zákazníka Přehled polí tabulky Přehled polí tabulky zobrazíte tak, že přejdete do nabídky Prezentace -> Tabulky a u konkrétní tabulky kliknete v prvním sloupci na Pole tabulky Parametry polí tabulek U polí lze nastavit následující možnosti Základní Tabulka Název tabulky, do které pole patří Název pole Název tohoto pole Název pole (SQL) Název pole v databázi. Pokud například napojujete tabulku z externí databáze, která má identifikátor nazvaný jinak, než id, vyplňte skutečný název pole. Titulek (textový název) Reprezentuje textový název pole. Tento název se zobrazí místo skutečného názvu pole v přehledu i v úpravě záznamu v administraci. Nadřazené pole Specifikuje nadřazené pole ve stromové struktuře. Typicky jde například o záložku SQL typ Databázový typ pole SQL typ (parametry) Parametry databázového typu pole (např. délka řetězce, výčet hodnot,...) Nenulová SQL hodnota Specifikuje, že pole nesmí mít nulovou hodnotu NULL.

144 144 Visual PHP Developer Guide Typ komponenty Přiřazuje k poli komponentu, která se stará o zobrazení v administraci, zpracování dat nad databázovým SQL typem, filtraci a zobrazení v prezentaci Parametry komponenty Nastavuje parametry přiřazené komponenty. Tyto parametry se liší v závislosti na použité komponentě. Výchozí hodnota Specifikuje, jakou hodnotu bude mít pole v momentě vytvoření nového záznamu. Můžete použít přímo hodnotu, nebo i libovolný PHP skript uzavřený v {php: } nebo SQL skript uzavřený v {sql :}. Typicky pro komponentu DATETIME lze vložit výchozá hodnotu {sql: NOW()} pro vložení aktuálního datumu a času. Automatická hodnota Při každém uložení záznamu bude původní hodnota ignorována a pole bude mít vždy tuto zadanou hodnotu. Opět platí, že lze použít uvnitř PHP i SQL skripty Typ exportu Nastavuje, jakým způsobem bude toto pole exportováno při použítí funkce exportu. Ostatní Popis Přiřadí krátkou nápovědu v úpravě záznamu v administraci. Povinné pole Tato pole jsou povinná a je nutné je v administraci vyplnit. Pouze ke čtení Tato pole není možné změnit Viditelný Tímto lze v administraci skrýt toto pole Oddělovač Nad polem se zobrazí čára, která vizuálně oddělí toto pole v administraci Indexovat Přidá do tabulky databáze indexaci tohoto pole (CREATE INDEX)

145 Pole tabulek 145 Fulltextová indexace Přidá do tabulky databáze fulltextovou indexaci tohoto pole (CREATE FULLTEXT INDEX) Unikátní Toto pole musí mít unikátní hodnotu v rámci celé tabulky databáze Uživatelské skupiny Toto pole se zobrazí v administraci pouze vybraným uživatelským skupinám Události Ke každému poli je přiřazena komponenta. Každá tato komponenta má své vlastní metody pro práci s daty a zobrazování. Pokud potřebujete rozšířit kódy komponent podle vlastních potřeb, je možné je změnit v následujících událostech: ongetdbvalue Vrací hodnotu, která se uloží do databáze. Typicky například komponenta EDITLIST odesílá z administračního formuláře hodnotu typu pole. Toto pole je nutné do databáze uložit jako řetězec. ongetvalue Vrací hodnotu, která je uložená v databázi. Toho lze využít v šablonách [field.getvalue()] ongetcode Vrací HTML kód, který se zobrazí při administraci tohoto pole. V této události jej můžete přepsat, nebo i rozšířit například o další tlačítka a podobně. ongetdisplayvalue Vrací hodnotu, která se zobrazí při zobrazení tohoto pole v prezentaci, nebo v přehledu administrace. Toho lze využít v šablonách [field] nebo [field.getdisplayvalue()] ongetdisplaytext Vrací hodnotu podobně jako událost ongetdisplayvalue, ale pouze jako text. Například u komponenty IMAGE vrací ongetdisplayvalue tag <img>, ale ongetdisplaytext vrátí pouze název obrázku. ongetexportvalue Vrací hodnotu, která bude použita při exportu tohoto pole. Pokud není zadána, použije se ongetvalue, nebo ongetdisplayvalue oncheckvalue Zde můžete provést vlastní kontrolu správnosti zadaných dat do tohoto pole. Typicky například kontrola, zda je správně zadaný do textového pole. Pokud vrací tato událost řetězec nenulové délky, zobrazí se tento řetězec jako chyba. V opačném případě je toto pole bráno jako validní.

146 146 Visual PHP Developer Guide ongetajaxvalue Této události lze využít při volání JavaScriptových funkcí. ongetfootervalue TODO 11.3 Virtuální pole Tyto pole neexistují fyzicky v tabulce databáze. Jedná se například o pomocné pole pro komponenty PAGECONTROL a TABSHEET, pro pole sloužící ke správě obsahu detail tabulky nebo pole, které zobrazují různé součty, průměry a jiné informace, které nejdou číst přímo z databáze. Virtuální pole se vytváří tak, že se u pole nezadá SQL typ a SQL parametry. Pouze se vybere typ komponenty, která bude nad tímto polem pracovat.

147 Komponenty Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XII

148 Visual PHP Developer Guide Komponenty Každé pole má svou komponentu. Tato komponenta se stará o administraci, filtraci a zobrazování hodnot v prezentaci COMPONENT Tato komponenta představuje základní třídu pro všechny ostatní komponenty a obsahuje základní funkcionalitu. Všechny ostatní komponenty jsou odvozené z této komponenty. Této komponenty lze využít pro tvorbu vlastních komponent. Metody Následující metody jsou společné všem ostatním komponentám, protože jsou odvozené od této komponenty string getvalue(array $recordvalues) vrátí hodnotu tak, jak je uložená v databázi string getdbvalue(array $beforerecordvalues, array $afterrecordvalues) vrátí hodnotu, která bude uložena do databáze string getdisplayvalue(array $recordvalues) vrátí hodnotu pro zobrazení obsahu string getcode(array $recordvalues) vrátí HTML pro úpravu obsahu bool hasvalue(array $recordvalues) vrátí, zda existuje hodnota Metody pro šablony Následující metody lze použít v šablonách pro získání výstupu. Šablonové metody volají metody komponent s tím rozdílem, že je automaticky doplňován první parametr $recordvalues. [fieldname] nebo [fieldname.getdisplayvalue()] vrátí hodnotu pro zobrazení obsahu [fieldname.getvalue()] vrátí hodnotu tak, jak je uložená v databázi [fieldname.hasvalue()] vrátí, zda existuje hodnota

149 Komponenty HIDDEN Tato komponenta uchovává obsah pole ale nezobrazuje se v administraci Doporučený datový typ libovolný Parametry bez parametrů 12.3 READONLY Tato komponenta uchovává hodnotu pole, není ji však možné v administraci měnit. Zobrazí se pouze jako text. Doporučený datový typ libovolný Parametry bez parametrů 12.4 UUID Tato komponenta se stará o vytvoření jedinečného identifikátoru UUID. Tento identifikátor je unikátní na celém světě a nikdy nedojde k vygenerování stejného kódu kýmkoli na světě. Tato komponenta je standardně připojena k poli id. Doporučený datový typ CHAR(36) Hodnota uložená v databázi value

150 150 Visual PHP Developer Guide Parametry bez parametrů 12.5 AUTOINCREMENT Tato komponenta se stará o vytvoření jedinečného číselného identifikátoru. Tento identifikátor je unikátní v rámci jedné tabulky. Tato komponenta je standardně připojena k poli id. Toto pole využívejte pro napojení tabulek z externích zdrojů. Pro tabulky tvořené ve Visual PHP doporučujeme použít UUID identifikátorů a komponenty UUID. Doporučený datový typ INT Hodnota uložená v databázi value Parametry bez parametrů 12.6 T EXT Jde o běžnou komponentu pro zadávání textu nebo čísel na jednom řádku. Tuto textovou komponentu lze rozšířit i o další prvky pomocí parametrů Doporučený datový typ libovolný nebo VARCHAR(255) pro vícejazyčné pole Hodnota uložená v databázi value {#lang(cs): value1} {#lang(en): value2} {#lang(de): value3}... Parametry Text Before Zobrazí text před textovým polem. Tento text je zobrazen i v prezentaci před hodnotou

151 Komponenty 151 Text After Zobrazí text za textovým polem. Tento text je zobrazen i v prezentaci za hodnotou Multilanguage Slouží pro zadávání různých hodnot ve více jazycích. V prezentaci se zobrazí pouze hodnota pro daný jazyk Size Určuje velikost textového pole pomocí atributu size Width Určuje šířku textového pole pomocí CSS onchange Specifikuje JavaScriptový kód volaný při změně hodnoty textového pole Metody string getendellipsis(array $recordvalues, $length=50, $ellipsis="...") vrátí pouze určitý počet slov od začátku. Počet slov se nastaví parametrem $length a ukončení řetězce parametrem $ellipsis string getcharendellipsis(array $recordvalues, $length=50, $ellipsis="...") vrátí pouze určitý počet znaků od začátku. Počet znaků se nastaví parametrem $length a ukončení řetězce parametrem $ellipsis Metody pro šablony Následující metody lze použít v šablonách pro získání výstupu. Šablonové metody volají metody komponent s tím rozdílem, že je automaticky doplňován první parametr $recordvalues. [fieldname.getendellipsis($length=50, $ellipsis="...")] vrátí pouze určitý počet slov od začátku. Počet slov se nastaví parametrem $length a ukončení řetězce parametrem $ellipsis [fieldname.getcharendellipsis($length=50, $ellipsis="...")] vrátí pouze určitý počet znaků od začátku. Počet znaků se nastaví parametrem $length a ukončení řetězce parametrem $ellipsis 12.7 TEXTAREA Jde o běžnou komponentu pro zadávání víceřádkového textu. Tuto textovou komponentu lze rozšířit i o další prvky pomocí parametrů

152 152 Visual PHP Developer Guide Doporučený datový typ TEXT Hodnota uložená v databázi value {#lang(cs): value1} {#lang(en): value2} {#lang(de): value3}... Parametry Replace Line Break to <br /> Nahradí nový řádek za tag <br />, aby bylo možné řádkování i v zobrazení v prezentaci. Multilanguage Slouží pro zadávání různých hodnot ve více jazycích. V prezentaci se zobrazí pouze hodnota pro daný jazyk Cols Určuje velikost textového pole pomocí atributu cols Rows Určuje velikost textového pole pomocí atributu rows Width

153 Komponenty 153 Určuje šířku textového pole pomocí CSS Height Určuje výšku textového pole pomocí CSS onchange Specifikuje JavaScriptový kód volaný při změně hodnoty textového pole Metody string getendellipsis(array $recordvalues, $length=50, $ellipsis="...") vrátí pouze určitý počet slov od začátku. Počet slov se nastaví parametrem $length a ukončení řetězce parametrem $ellipsis string getcharendellipsis(array $recordvalues, $length=50, $ellipsis="...") vrátí pouze určitý počet znaků od začátku. Počet znaků se nastaví parametrem $length a ukončení řetězce parametrem $ellipsis Metody pro šablony Následující metody lze použít v šablonách pro získání výstupu. Šablonové metody volají metody komponent s tím rozdílem, že je automaticky doplňován první parametr $recordvalues. [fieldname.getendellipsis($length=50, $ellipsis="...")] vrátí pouze určitý počet slov od začátku. Počet slov se nastaví parametrem $length a ukončení řetězce parametrem $ellipsis [fieldname.getcharendellipsis($length=50, $ellipsis="...")] vrátí pouze určitý počet znaků od začátku. Počet znaků se nastaví parametrem $length a ukončení řetězce parametrem $ellipsis 12.8 CHECKBOX Jde o komponentu pro dvoustavovou logiku zaškrtnuto/nezaškrtnuto formou zaškrtávacího políčka. Tuto textovou komponentu lze rozšířit i o další prvky pomocí parametrů Doporučený datový typ ENUM Hodnota uložená v databázi value Parametry Values Hodnoty, které budou uloženy do databáze v pořadí zaškrtnuto nezaškrtnuto

154 154 Visual PHP Developer Guide Texts Textové popisky pro hodnoty v pořadí zaškrtnuto nezaškrtnuto onchange Specifikuje JavaScriptový kód volaný při změně hodnoty 12.9 CHECKGROUP Jde o komponentu umožňující výběr z více možností formou zaškrtávacích políček. Tuto textovou komponentu lze rozšířit i o další prvky pomocí parametrů Doporučený datový typ VARCHAR(255) Hodnota uložená v databázi value1 value2 value3... Parametry Values Hodnoty, které budou uloženy do databáze v případě zaškrtnutí Texts Textové popisky pro hodnoty ve stejném pořadí, jak byly zadány hodnoty. Pokud tyto popisky nezadáte, budou doplněny automaticky přeložením hodnot Display Separator Oddělovač popisku, který se zobrazí v prezentaci Column Count Počet sloupců, ve kterých se zobrazí zaškrtávací pole Column Order Pořadí, ve kterém se zobrazí zaškrtávací pole ve více sloupcích bottom right - zobrazení probíhá po sloupcích (vhodné například pro abecední seřazení) right bottom - zobrazení probíhá po řádcích Translate Specifikuje, zda mají být popisky přeloženy do aktuálního jazyka Width

155 Komponenty Určuje šířku celé oblasti pomocí CSS onchange Specifikuje JavaScriptový kód volaný při změně hodnoty Metody array getvalueasarray(array $recordvalues) vrátí hodnoty v poli array getdisplayvalueasarray(array $recordvalues) vrátí popisky hodnot v poli COMBOBOX Jde o komponentu pro výběr jedné z několika hodnot formou rozbalovací nabídky. Doporučený datový typ ENUM nebo VARCHAR Hodnota uložená v databázi value value1 value2 value3... Parametry Values Výčet hodnot ve formátu hodnota1 hodnota2 hodnota3... Texts Textové popisky pro hodnoty ve stejném pořadí jako jsou zadány hodnoty ve values Multiselect Specifikuje, zda je možné vybrat více hodnot zároveň Translate Specifikuje, zda budou texty automaticky přeloženy do aktuálního jazyka Unselected Value Hodnota, která se uloží, pokud nevybere uživatel žádnou volbu Unselected Text Popisek pro hodnotu unselected value 155

156 156 Visual PHP Developer Guide Editable Umožňuje zadat i vlastní hodnotu Add existing values Zobrazí v seznamu výběru hodnoty, které jsou již uložené v databázi Arrange alphabetically Seřadí popisky hodnot podle abecedy Size Určuje velikost rozbalovací nabídky pomocí atributu size Width Určuje šířku rozbalovací nabídky pomocí CSS onchange Specifikuje JavaScriptový kód volaný při změně hodnoty DATETIME Jde o komponentu pro zadávání datumu a času. Tato komponenta se automaticky stará o formát datumu podle aktuálního jazyka. V administraci je k dispozici i nabídka formou kalendáře. Doporučený datový typ DATE, TIME, DATETIME Hodnota uložená v databázi value Parametry Size Určuje velikost textového pole pomocí atributu size

157 Komponenty 157 Width Určuje šířku textového pole pomocí CSS onchange Specifikuje JavaScriptový kód volaný při změně hodnoty textového pole Metody string getdate(array $recordvalues, bool $astext=true, bool $dayofweek=false) vrátí pouze datum. Parametr $astext určuje, zda bude měsíc vrácen textově, nebo číselně. Parametr $dayofweek nastavuje, zda bude zobrazen i den v týdnu string getday(array $recordvalues, bool $leadingzero=false) vrátí číslo dne. Parametr $leadingzero specifikuje, zda má být dvouciferný a obsahovat na začátku nulu. string getmonth(array $recordvalues, bool $leadingzero=false) vrátí číslo měsíce. Parametr $leadingzero specifikuje, zda má být dvouciferný a obsahovat na začátku nulu. string getyear(array $recordvalues, bool $shortformat=false) vrátí rok. Parametr $shortformat specifikuje, zda má být formát roku RR nebo RRRR. string gettime(array $recordvalues, bool $seconds=true) vrátí čas. Parametr $seconds specifikuje, zda má čas obsahovat sekundy. string getdatetime(array $recordvalues, bool $astext=true, bool $dayofweek=false, bool $seconds=true) vrátí datum a čas. Parametr $astext určuje, zda bude měsíc vrácen textově, nebo číselně. Parametr $dayofweek nastavuje, zda bude zobrazen i den v týdnu. Parametr $seconds specifikuje, zda má čas obsahovat sekundy. string getdayofweek(array $recordvalues, bool $short=false) vrátí den v týdnu. Parametr $short specifikuje, zda bude vrácen den v týdnu celý, nebo jeho zkrácená podoba (monday, mo) float getunixtime(array $recordvalues) vrátí datum a čas v UNIX formátu string getvaluefromformat(string $value, string $format) vrátí datum a čas podle formátu. Formát je totožný s formátem používaným funkcí date(). Metody pro šablony Následující metody lze použít v šablonách pro získání výstupu. Šablonové metody volají metody komponent s tím rozdílem, že je automaticky doplňován první parametr $recordvalues. [fieldname.getdate(bool $astext=true, bool $dayofweek=false)] vrátí pouze datum. Parametr $astext určuje, zda bude měsíc vrácen textově, nebo číselně. Parametr $dayofweek nastavuje, zda bude zobrazen i den v týdnu

158 158 Visual PHP Developer Guide [fieldname.getday(bool $leadingzero=false)] vrátí číslo dne. Parametr $leadingzero specifikuje, zda má být dvouciferný a obsahovat na začátku nulu. [fieldname.getmonth(bool $leadingzero=false)] vrátí číslo měsíce. Parametr $leadingzero specifikuje, zda má být dvouciferný a obsahovat na začátku nulu. [fieldname.getyear(bool $shortformat=false)] vrátí rok. Parametr $shortformat specifikuje, zda má být formát roku RR nebo RRRR. [fieldname.gettime(bool $seconds=true)] vrátí čas. Parametr $seconds specifikuje, zda má čas obsahovat sekundy. [fieldname.getdatetime(bool $astext=true, bool $dayofweek=false, bool $seconds=true)] vrátí datum a čas. Parametr $astext určuje, zda bude měsíc vrácen textově, nebo číselně. Parametr $dayofweek nastavuje, zda bude zobrazen i den v týdnu. Parametr $seconds specifikuje, zda má čas obsahovat sekundy. [fieldname.getdayofweek(bool $short=false)] vrátí den v týdnu. Parametr $short specifikuje, zda bude vrácen den v týdnu celý, nebo jeho zkrácená podoba (monday, mo) [fieldname.getunixtime()] vrátí datum a čas v UNIX formátu AUTOCALC Tato komponenta umožňuje automatické výpočty hodnot, které jsou prováděny pomocí AJAX. K dispozici je tlačítko, které provádí výpočet. Doporučený datový typ libovolný Hodnota uložená v databázi value Parametry Text Before Zobrazí text před textovým polem. Tento text je zobrazen i v prezentaci před hodnotou Text After Zobrazí text za textovým polem. Tento text je zobrazen i v prezentaci za hodnotou Button Text Specifikuje popisek tlačítka, kterým je volán výpočet hodnoty

159 Komponenty 159 Fields Specifikuje názvy polí, nad kterými bude prováděn výpočet (hodnoty těchto polí budou předány pro volání přes AJAX) On Change Fields Hodnota bude automaticky přepočtena v případě, že dojde ke změně hodnoty u těchto polí Size Určuje velikost textového pole pomocí atributu size Width Určuje šířku textového pole pomocí CSS onchange Specifikuje JavaScriptový kód volaný při změně hodnoty textového pole BROWSERS Tato komponenta umožní výběr z typů prohlížečů. Doporučený datový typ VARCHAR(255), TEXT Hodnota uložená v databázi value1 value2 value3... Parametry Display Separator Oddělovač popisku, který se zobrazí v prezentaci Column Count Počet sloupců, ve kterých se zobrazí zaškrtávací pole Column Order Pořadí, ve kterém se zobrazí zaškrtávací pole ve více sloupcích bottom right - zobrazení probíhá po sloupcích (vhodné například pro abecední seřazení) right bottom - zobrazení probíhá po řádcích

160 160 Visual PHP Developer Guide Translate Specifikuje, zda mají být popisky přeloženy do aktuálního jazyka Width Určuje šířku celé oblasti pomocí CSS onchange Specifikuje JavaScriptový kód volaný při změně hodnoty Metody array getvalueasarray(array $recordvalues) vrátí hodnoty v poli array getdisplayvalueasarray(array $recordvalues) vrátí popisky hodnot v poli CODE Tato komponenta umožňuje pohodlnou editaci zdrojového kódu Doporučený datový typ TEXT Hodnota uložená v databázi value Parametry Type Druh jazyka, použítého pro zvýraznění syntaxe zdrojového kódu Width Určuje šířku celé oblasti pomocí CSS Height

161 Komponenty 161 Určuje výšku celé oblasti pomocí CSS Fields Specifikuje pole, které budou přidány do této komponenty formou záložek COLOR Tato komponenta umožňuje výběr barvy přímým zadání ve formátu #RRGGBB nebo výběrem barvy z nabídky Doporučený datový typ CHAR(7) Hodnota uložená v databázi value COMPONENTPROPERTIES Rezervovaná komponenta umožňující úpravu parametrů komponent pomocí Property Editor.

162 162 Visual PHP Developer Guide DETAILTABLE Tato komponenta umožňuje pohodlnou správu záznamů v detail tabulce. Automaticky převezme všechny komponenty z této detail tabulky a umožní přidávání, editaci i odstranění jednotlivých záznamů s použitím komponent polí této detail tabulky. Doporučený datový typ virtuální pole Hodnota uložená v databázi žádná Parametry Table Název detail tabulky Width Určuje šířku celé oblasti pomocí CSS Height

163 Komponenty Určuje výšku celé oblasti pomocí CSS DISPLAYTYPE Komponenta usnadňuje nastavení typu zobrazení pro speciální pole displaytype. Doporučený datový typ ENUM, VARCHAR(255) Hodnota uložená v databázi value Parametry Type Možnosti hodnot pro toto pole. simple - jednoduchá změna hiearchy - hiearchická struktura změn pro publikační činnost, kdy jsou k dispozici uživatelé s různými právy. Values hodnoty, které se uloží do databáze Texts Textové popisky hodnot Editor Status Value Hodnota pro stav v editaci Editor Status Text Popiska hodnoty pro stav v editaci Editor User Group Uživatelská skupina editorů Corrector Status Value Hodnota pro stav čeká na korekturu Corrector Status Text Popiska hodnoty pro stav čeká na korekturu 163

164 164 Visual PHP Developer Guide Corrector User Group Uživatelská skupina korektorů Publisher Status Value Hodnota pro stav čeká na publikaci Publisher Status Text Popisek hodnoty pro stav čeká na publikaci Publisher User Group Uživatelská skupina vydavatelů Additional Values Další možné hodnoty Additional Texts Popisky pro další možné hodnoty EDITGRID Tato komponenta umožňuje zadávat data formou tabulky tak, jako by to byla skutečná tabulka v databázi. Data jsou ale uložena pouze do jednoho pole EDITLIST Tato komponenta umožňuje zadat seznam vlastních hodnot. Doporučený datový typ VARCHAR(255), TEXT Hodnota uložená v databázi value1 value2 value3...

165 Komponenty 165 Parametry Component Typ komponenty, která bude použita pro zadávání hodnot Component Parameters Parametry komponenty pro zadávání hodnot. Jednotlivé parametry jsou odděleny čárkou Width Šířka celé komponenty pomocí CSS Height Výška celé komponenty pomocí CSS Metody array getvalueasarray(array $recordvalues) vrátí zadané hodnoty FILE Tato komponenta je vhodná pro ukládání souborů na server. Automaticky se stará o vytvoření patřičných složek a lze nastavit, aby se automaticky starala i o pojmenování souboru, aby nedocházelo ke kolizím názvů. Doporučený datový typ VARCHAR(255), BLOB Hodnota uložená v databázi value Parametry Storage Definuje způsob, jak budou soubor uložen stfile - uloží se do souborového systému serveru (v poli je uložena informace o souboru) stdatabase - uloží se do pole v databázi (pole musí mít typ BLOB) Directory Složka (relativní k složce /repository/), do které se uloží soubor File Name Field Název pole, podle kterého se bude soubor jmenovat (přípona souboru zůstane zachována podle typu souboru) File Name Prefix Text před názvem souboru File Name Postfix

166 166 Visual PHP Developer Guide Text za názvem souboru Digit Count Počet číslic, pokud je pole typ číslo Default File Name Výchozí název souboru Default File Ext Výchozí přípona souboru File Name Field Jméno pole podle kterého se bude soubor jmenovat File Name Field Storage Způsob přiřazení názvu souboru read from field - pouze čte z pole read and write - čte a zapíše i do názvu souboru File Ext Field Jméno pole podle kterého se bude mít soubor příponu File Ext Field Storage Způsob přiřazení přípony souboru read from field - pouze čte z pole read and write - čte a zapíše i do přípony souboru Counter Field Pole, do kterého se zapisuje počet stáhnutí Repository Directory Složka, která nahradí standardní /repository/. Vhodné pro napojení dat z jiných prezentací běžících na stejném serveru Upload Progress Způsob nahrátí na server. Metody string getcontent(array $recordvalues) vrátí obsah souboru string getpath(array $recordvalues) vrátí cestu k souboru string geturl(array $recordvalues) vrátí URL adresu souboru Metody pro šablony Následující metody lze použít v šablonách pro získání výstupu. Šablonové metody volají metody

167 Komponenty 167 komponent s tím rozdílem, že je automaticky doplňován první parametr $recordvalues. [fieldname.geturl()] vrátí URL adresu souboru [fieldname.getdownloadurl()] vrátí URL adresu s možností stažení souboru pod jiným názvem, než je fyzicky uložený, s možností ukládat počet stažení a zápisu do statistik (pokud je nastaveno v parametrech komponenty) [fieldname.geticon()] vrátí obrázek s ikonou typu souboru [fieldname.geticonurl()] vrátí URL obrázku s ikonou typu souboru GOOGLEMAP Komponenta, která umožňuje zadávat GPS souřadnice pomocí mapy od společnosti Google. Ke správné funkčnosti je potřeba mít správný licenční klíč, který je vázaný na název domény. Tento klíč můžete bez registrace získat na stránce Doporučený datový typ DOUBLE (pro pole latitude a longitude) Hodnota uložená v databázi value

168 168 Visual PHP Developer Guide Parametry Latitude Zeměpisná šířka Longitude Zeměpisná délka Zoom Zvětšení mapy Map Type Typ mapy map - klasická mapa sattelite - satelitní snímky hybrid - oba typy společně Map Type Visible Specifikuje, zda bude vidět ovladač pro změnu typu mapy Map Control Velikost ovládacích prvků small - malé large - velké Overview Visible Specifikuje, zda bude vidět zmenšenina mapy Scale Visible Specifikuje, zda bude vidět možnost přiblížení Latitude Field Pole pro uložení zeměpisné šířky Longitude Field Pole pro uložení zeměpisné délky Width Šířka mapy Height Výška mapy Confirm Question Specifikuje otázku pro potvrzení zadání nových souřadnic Icon Ikona ukazující aktuální pozici

169 Komponenty HISTORY Tato komponenta zobrazuje historii provedenou nad záznamem. Pole pro historii musí mít název history. Doporučený datový typ TEXT Hodnota uložená v databázi value HTMLAREA Masivní komponenta umožňující vizuální editaci HTML kódu přívětivá pro koncového zákazníka. Doporučený datový typ TEXT, LONGTEXT Hodnota uložená v databázi value Parametry Toolbars Specifikuje skupiny tlačítek zobrazených v panelu editoru - TODO

170 170 Visual PHP Developer Guide <br /> on [ENTER] Nastaví, zda se po stisknutí enter vloží tag <br /> nebo odstavec <p> Width Šířka celého editoru Height Výška celého editoru Editor Width Šířka editovatelné oblasti Metody string getendellipsis(array $recordvalues, $length=50, $ellipsis="...") vrátí pouze určitý počet slov od začátku. Počet slov se nastaví parametrem $length a ukončení řetězce parametrem $ellipsis. Výsledný text je ořezaný o HTML tagy string getcharendellipsis(array $recordvalues, $length=50, $ellipsis="...") vrátí pouze určitý počet znaků od začátku. Počet znaků se nastaví parametrem $length a ukončení řetězce parametrem $ellipsis. Výsledný text je ořezaný o HTML tagy Metody pro šablony Následující metody lze použít v šablonách pro získání výstupu. Šablonové metody volají metody komponent s tím rozdílem, že je automaticky doplňován první parametr $recordvalues. [fieldname.getendellipsis($length=50, $ellipsis="...")] vrátí pouze určitý počet slov od začátku. Počet slov se nastaví parametrem $length a ukončení řetězce parametrem $ellipsis. Výsledný text je ořezaný o HTML tagy [fieldname.getcharendellipsis($length=50, $ellipsis="...")] vrátí pouze určitý počet znaků od začátku. Počet znaků se nastaví parametrem $length a ukončení řetězce parametrem $ellipsis. Výsledný text je ořezaný o HTML tagy LANGUAGE Tato komponenta umožní výběr z jazyků, dostupných v prezentaci Doporučený datový typ VARCHAR(255)

171 Komponenty 171 Hodnota uložená v databázi value IMAGE Tato komponenta je vhodná pro ukládání obrázků na server. Automaticky se stará o vytvoření patřičných složek a lze nastavit, aby se automaticky starala i o pojmenování souboru, aby nedocházelo ke kolizím názvů. Navíc umožňuje automatickou změnu velikosti, uživatelské výřezy a další grafické efekty Doporučený datový typ VARCHAR(255) Hodnota uložená v databázi value Parametry Directory Složka (relativní k složce /repository/), do které se uloží soubor File Name Field Název pole, podle kterého se bude soubor jmenovat File Name Prefix Text před názvem souboru File Name Postfix Text za názvem souboru Digit Count Počet číslic, pokud je pole typ číslo Output Type Typ obrázku, na který bude nahraný obrázek vždy převeden Resize Width Šířka, na kterou bude obrázek zmenšený, pokud přesáhne tuto velikost. Na serveru bude uložený pouze tento zmenšený obrázek. Pro zobrazení na www se doporučuje tento údaj nezadávat a použít v šabloně komponentu Template Image, která se sama postará o zmenšení obrázku s tím, že na serveru zůstane

172 172 Visual PHP Developer Guide původní zdrojový obrázek. Resize Height Výška, na kterou bude obrázek zmenšený, pokud přesáhne tuto velikost. Na serveru bude uložený pouze tento zmenšený obrázek. Pro zobrazení na www se doporučuje tento údaj nezadávat a použít v šabloně komponentu Template Image, která se sama postará o zmenšení obrázku s tím, že na serveru zůstane původní zdrojový obrázek. Stretch Specifikuje, zda se má být obrázek změněn přesně na zadanou velikost (nezachová poměr šířky a výšky) Crop Specifikuje, zda má být obrázek automaticky ořezán na zadanou velikost Crop Padding Specifikuje odsazení pro operaci crop Rotate Specifikuje otočení obrázku Background Color Nastavuje barvu pozadí obrázku (pro operaci otočení) Transparent Color Nastavuje, která barva bude transparentní Watermark Image Specifikuje obrázek, který bude přidán jako vodoznak Watermark Opacity Definuje průhlednost obrázku pro vodoznak. K dispozici jsou hodnoty od 0 do 100. Hodnota 100 vloží vodoznak tak, jak je. Hodnota 50 vloží vodoznak s 50% průhledností. Při hodnotě 0 nebude vodoznak vidět vůbec. U obrázků ve formátu PNG lze použít transparentnost definovanou přímo v tomto obrázku za použití hodnoty 100. U jiných hodnot dojde k zprůhlednění podobně jako u jiných formátů. Watermark Position Specifikuje umístění obrázku vodoznaku ve zdrojovém obrázku Watermark Scale Specifikuje zvětšení obrázku vodoznaku ve zdrojovém obrázku Watermark Background Color Specifikuje barvu pozadí vodoznaku (tato barva představuje transparentnost) Grayscale Nastavuje, zda má být obrázek převeden na stupnici šedých barev Grayscale Color Nastaví barvu, kterou bude šedý obrázek obarven Grayscale Color Opacity Nastaví průhlednost šedé barvy

173 Komponenty 173 Default Image Výchozí obrázek, pokud není obrázek k dispozici White Balance Aktivuje vyvážení bílé Colorize Color Specifikuje barvu, kterou bude obrázek obarven pomocí efektu colorize Colorize Color Opacity Specifikuje množství barvy, kterou bude obrázek obarven Gamma Correction Nastavuje automatickou korekci kontrastu a jasu Blur Specifikuje efekt rozostření gaussian - gausovské rozostření selective - selektivní rozostření Repository Directory Složka, která nahradí standardní /repository/. Vhodné pro napojení dat z jiných prezentací běžících na stejném serveru Extern Repository Directory Cesta k obrázku uloženém na jiné doméně (vhodné, pokud importujeme cizí databázi, kde jsou názvy souborů uložené v poli tabulky). Extern Repository URL URL k obrázku uloženém na jiné doméně (vhodné, pokud importujeme cizí databázi, kde jsou názvy souborů uložené v poli tabulky). Editor Nastavuje použití editoru obrázků. Editor Width Šířka editoru v administraci Editor Height Výška editoru v administraci Crop Width Šířka oblasti pro výřez Crop Height Výška oblasti pro výřez Crop Constrain Proportions Specifikuje, zda se má vždy zachovat poměr stran při změně velikosti oblasti pro výřez Crop Minimum Size Specifikuje, zda je možné zmenšit výřez na menší oblast, než je nastavena v parametrech Crop Width a

174 174 Visual PHP Developer Guide Crop Height Source Image Field Pole typu IMAGE, do kterého se převede zdrojový obrázek. Metody string getpath(array $recordvalues) vrátí cestu k souboru obrázku string geturl(array $recordvalues) vrátí URL adresu obrázku int getwidth(array $recordvalues) vrátí šířku obrázku int getheight(array $recordvalues) vrátí výšku obrázku Metody pro šablony Následující metody lze použít v šablonách pro získání výstupu. Šablonové metody volají metody komponent s tím rozdílem, že je automaticky doplňován první parametr $recordvalues. [fieldname.geturl()] vrátí URL adresu obrázku [fieldname.getwidth()] vrátí šířku obrázku [fieldname.getheight()] vrátí výšku obrázku Více informací, jak probíhá změna velikosti obrázků se dozvíte v sekci Obrázky LOOKUP Komponenta, která nabízí formou rozbalovací nabídky výběr z několika hodnot. Tyto hodnoty se nezadávají přímo, ale jsou načítány z tabulky databáze. Doporučený datový typ dle datového typu tabulky

175 Komponenty 175 Hodnota uložená v databázi value value1 value2 value3... Parametry Table Název tabulky, ze které se budou číst data Value Field Název pole v tabulce, ze kterého se budou číst hodnoty Text Field Název pole v tabulce, ze kterého se budou číst popisky hodnot Table Field Název pole, které představuje název tabulky (nahrazuje parametr Table) Parent Fields Nadřazená pole (lze využít pro propojení více komponent LOOKUP z několika různých tabulek, které jsou vzájemně ve vztahu master-detail. Filter (SQL) Filtrace tabulky Order By (SQL) Řazení záznamů tabulky Display Link in Admin Zobrazí v přehledu administrace odkaz na záznam tabulky Values Možnost přidat další hodnoty Texts Možnost přidat další popisky hodnot Multiselect Umožní výběr více hodnot Multiselect Specifikuje, zda je možné vybrat více hodnot zároveň Translate Specifikuje, zda budou texty automaticky přeloženy do aktuálního jazyka Unselected Value Hodnota, která se uloží, pokud nevybere uživatel žádnou volbu Unselected Text Popisek pro hodnotu unselected value Editable

176 176 Visual PHP Developer Guide Umožňuje zadat i vlastní hodnotu Add existing values Zobrazí v seznamu výběru hodnoty, které jsou již uložené v databázi Arrange alphabetically Seřadí popisky hodnot podle abecedy Size Určuje velikost rozbalovací nabídky pomocí atributu size Width Určuje šířku rozbalovací nabídky pomocí CSS onchange Specifikuje JavaScriptový kód volaný při změně hodnoty LOOKUPCHECKGROUP Jde o komponentu umožňující výběr z více možností formou zaškrtávacích políček. Tyto hodnoty se nezadávají přímo, ale jsou načítány z tabulky databáze. Doporučený datový typ dle datového typu tabulky Hodnota uložená v databázi value1 value2 value3... Parametry Table Název tabulky, ze které se budou číst data Value Field Název pole v tabulce, ze kterého se budou číst hodnoty Text Field Název pole v tabulce, ze kterého se budou číst popisky hodnot Table Field Název pole, které představuje název tabulky (nahrazuje parametr Table) Parent Fields Nadřazená pole (lze využít pro propojení více komponent LOOKUP z několika různých tabulek, které jsou vzájemně ve vztahu master-detail.

177 Komponenty 177 Filter (SQL) Filtrace tabulky Order By (SQL) Řazení záznamů tabulky Display Link in Admin Zobrazí v přehledu administrace odkaz na záznam tabulky Values Možnost přidat další hodnoty Texts Možnost přidat další popisky hodnot Display Separator Oddělovač popisku, který se zobrazí v prezentaci Column Count Počet sloupců, ve kterých se zobrazí zaškrtávací pole Column Order Pořadí, ve kterém se zobrazí zaškrtávací pole ve více sloupcích bottom right - zobrazení probíhá po sloupcích (vhodné například pro abecední seřazení) right bottom - zobrazení probíhá po řádcích Translate Specifikuje, zda mají být popisky přeloženy do aktuálního jazyka Width Určuje šířku celé oblasti pomocí CSS onchange Specifikuje JavaScriptový kód volaný při změně hodnoty Metody array getvalueasarray(array $recordvalues) vrátí hodnoty v poli array getdisplayvalueasarray(array $recordvalues) vrátí popisky hodnot v poli LOOKUPTREE Tato komponenta umožňuje výběr hodnot formou stromové struktury. Jednotlivé hodnoty a popisky jsou načítány z tabulky.

178 178 Visual PHP Developer Guide Doporučený datový typ dle datového typu tabulky Hodnota uložená v databázi value value1 value2 value3... Parametry Table Název tabulky, ze které se budou číst data Value Field Název pole v tabulce, ze kterého se budou číst hodnoty Text Field Název pole v tabulce, ze kterého se budou číst popisky hodnot Table Field Název pole, které představuje název tabulky (nahrazuje parametr Table) Parent Fields Nadřazená pole (lze využít pro propojení více komponent LOOKUP z několika různých tabulek, které jsou vzájemně ve vztahu master-detail. Filter (SQL) Filtrace tabulky Order By (SQL) Řazení záznamů tabulky Multiselect Specifikuje, zda je možné vybrat více hodnot zároveň Translate Specifikuje, zda budou texty automaticky přeloženy do aktuálního jazyka

179 Komponenty 179 Width Určuje šířku celé oblasti pomocí CSS Height Určuje výšku celé oblasti pomocí CSS PAGECONTROL Tato komponenta zobrazí všechny své podřízené komponenty v jednom samostatném panelu Doporučený datový typ virtuální Parametry Width Šířka panelu pomocí CSS PERMISSIONS Tato komponenta je rezervována PROGRESS Tato komponenta zobrazuje procenta formou grafického ukazatele. Doporučený datový typ SMALLINT Hodnota uložená v databázi value PROPERTIES Rezervovaná komponenta umožňující úpravu parametrů pomocí Property Editor REMOTECOMPONENT Jde o univerzální komponentu, která zobrazuje ostatní komponenty v reálném čase pomocí technologie AJAX. Doporučený datový typ virtuální

180 180 Visual PHP Developer Guide REMOTECOMPONENTGROUP Jde o univerzální komponentu, která zobrazuje skupinu ostatních komponent v reálném čase pomocí technologie AJAX. Doporučený datový typ virtuální RSSPROPERTIES Rezervovaná komponenta sloužící k úpravě parametrů pro RSS export TABLES Tato komponenta umožní výběr z tabulek formou rozbalovací nabídky TABSHEET Tato komponenta zobrazí všechny své podřízené komponenty v záložce. Doporučený datový typ virtuální Parametry Default Nastavuje, zda bude záložka aktivní po otevření stránky

181 Komponenty URL Tato komponenta umožní zadat URL. K dispozici jsou i tlačítka pro výběr souboru na serveru nebo stránky z prezentace. Doporučený datový typ VARCHAR(255) Hodnota uložená v databázi value USERS Tato komponenta umožňuje výběr z uživatelů prezentace USERGROUPS Tato komponenta umožňuje výběr z uživatelských skupiny prezentace ADMINUSERS Tato komponenta umožňuje výběr z uživatelů administrace

182 182 Visual PHP Developer Guide ADMINUSERGROUPS Tato komponenta umožní výběr z uživatelských skupin administrace. Doporučený datový typ VARCHAR(255), TEXT Hodnota uložená v databázi value1 value2 value3... Parametry Display Separator Oddělovač popisku, který se zobrazí v prezentaci Column Count Počet sloupců, ve kterých se zobrazí zaškrtávací pole Column Order Pořadí, ve kterém se zobrazí zaškrtávací pole ve více sloupcích bottom right - zobrazení probíhá po sloupcích (vhodné například pro abecední seřazení) right bottom - zobrazení probíhá po řádcích Translate Specifikuje, zda mají být popisky přeloženy do aktuálního jazyka Width Určuje šířku celé oblasti pomocí CSS onchange Specifikuje JavaScriptový kód volaný při změně hodnoty Metody array getvalueasarray(array $recordvalues) vrátí hodnoty v poli array getdisplayvalueasarray(array $recordvalues) vrátí popisky hodnot v poli

183 Menu v administraci Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XIII

184 Visual PHP Developer Guide Menu v administraci Ve výchozím stavu je menu v administraci vyplněno pouze položkou Domů a Nástroje. Při implementaci nové prezentace se postupně přidávají jednotlivé sekce, které si Váš zákazník vyžádal. Přidal lze výchozí tabulky i Vaše vlastní. Pro úpravu menu v administraci přejděte do nabídky Prezentace -> Admin Menu 13.1 Parametry položek menu v administraci Pro jednotlivé položky menu lze zadat následující parametry: Název Představuje název tabulky, nebo vlastní název, pokud má tato položka fungovat jako podmenu. Nadřazená položka Nastavení položky, která je nadřazená ve stromové hiearchii Text Popisek menu. Pokud není zadán, je použit automatický překlad položky název Odkaz Přímý odkaz Cílové okno Nastavuje, ve kterém okně se odkaz zobrazí Viditelný Zobrazí nebo skryje tuto položku Uživatelské skupiny Uživatelé z těchto uživatelských skupin budou mít tuto položku přístupnou Ikona Specifikuje ikonu Začít skupinu (oddělovač před) Zobrazí oddělovač Ukončit skupinu (oddělovač za) Zobrazí oddělovač Odsazení (před)

185 Skripty Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XIV

186 Visual PHP Developer Guide Skripty Ve Visual PHP lze samozřejmě implementovat i vlastní PHP skripty, pokud nejsou integrované funkce dostatečně vyhovující. Skripty mají tu výhodu, že jsou vkládány na místa, kam si určíte. K dispozici jsou rovněž výchozí skripty k některým modulům, které můžete libovolně upravovat. Pro zobrazení skriptů přejděte do nabídky Prezentace -> Skripty 14.1 Parametry skriptů U jednotlivých skriptů lze nastavit tyto parametry: Typ skriptu Specifikuje, v kterém programovacím jazyku je skript napsán Identifikátor (tid) Textový identifikátor skriptu Jméno Název skriptu Způsob zobrazení Podobně jako u šablon lze mít skripty pro různá zobrazení Podmínka Podobně jako u šablon lze mít skripty rozlišené podmínkou Uživatelské skupiny Specifikuje, kterým uživatelským skupinám se skript zobrazí Code Vlastní zdrojový kód skriptu 14.2 Spouštění skriptů Skripty se chovají stejně jako zobrazení ostatních tabulek pomocí Table Content. Pro spuštění skriptu stačí zavolat URL scripts.php?tid=textovy_identifikator Takto spuštěný skript se zobrazí na místě hlavního panelu prezentace Další možností spuštění skriptu je v layoutu pomocí Table Content. Stačí nastavit tyto parametry: Table - scripts tid - TEXTOVY_IDENTIFIKATOR

187 Časové skripty Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XV

188 Visual PHP Developer Guide Časové skripty Pro spouštění skriptů v určitých časových intervalech slouží časové skripty. U těchto skriptů nastavíte, kdy se mají spouštět a zadáte jejich zdrojový kód. Ne na každém hostingu lze nastavit vlastní cron pro periodické spuštění PHP skriptů. Proto přichází Visual PHP se simulací tohoto spouštění, které se aktivuje přístupem návštěvníka na prezentaci. Přehled časových skriptů zobrazíte v nabídce Prezentace -> Časové skripty 15.1 Parametry časových skriptů Pro časové skripty jsou k dispozici následující parametry Identifikátor (tid) Textový identifikátor skriptu Aktivní Skript lze dočasně deaktivovat, aniž by bylo nutné jej mazat Minuty Specifikuje čas, kdy bude skript spuštěn Hodiny Specifikuje čas, kdy bude skript spuštěn Dny Specifikuje čas, kdy bude skript spuštěn Měsíce Specifikuje čas, kdy bude skript spuštěn Dny v týdnu Specifikuje čas, kdy bude skript spuštěn Spustit všechny čekající Pokud máte málo návštěvníků a skript je potřeba spouštět v nastaveném intervalu, budou spuštěny skripty, které dosud na aktivaci čekaly. Jeden skript tedy může být spuštěn vícekrát. Posledně spuštěno Zobrazuje poslední datum a čas spuštění skriptu Příští spuštění Zobrazuje plánovaný čas příštího spuštění Code Samotný zdrojový kód skriptu

189 Časové skripty 15.2 Ruční aktivace časového skriptu Časové skripty lze ručně aktivovat pro potřeby testování. Stačí zadat URL: cron.php?tid=textovy_identifikator 189

190 Skripty na pozadí Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XVI

191 Skripty na pozadí Skripty na pozadí V některých případech je potřeba spouštět skripty na pozadí. Tyto skripty mohou běžet i několik desítek minut a proto není vhodné je inicializovat zadáním z URL, protože by tato akce blokovala prohlížeč do doby, kdy bude skript ukončen. Správná funkčnost těchto skriptů může být zajištěna pouze dostatečným nastavením max_execution_time a memory_limit. Proto je vhodné mít pro dlouhotrvající skripty vlastní server, nebo webhosting umožňující vyšší nastavení těchto parametrů v php.ini Tyto skripty zobrazíte z nabídky Prezentace -> Skripty na pozadí.

192 Vkládání komponent třetích stran Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XVII

193 Vkládání komponent třetích stran Vkládání komponent třetích stran Visual PHP se snaží maximálně ulehčit práci pomocí nativních komponent. Může nastat situace, kdy je potřeba použít vlastní řešení, nebo hotové řešení třetích stran. Pro tyto účely je k dospozici několik možností Vkládání JavaScript komponent Pro vložení JavaScriptových efektů a komponent je ve většině případů potřeba vložit do HTML sekce <head> nový tag odkazující na zdrojový.js soubor, případně další.js nebo.css soubory. Co je potřeba vložit do HTML kódu stránky se dočtete v v manuálu přiloženém k těmto komponentám. Uložení zdrojových skriptů na server Zdrojové kódy můžete uložit na libovolné místo na serveru. Můžete využít jeden z výchozích adresářů, případně si vytvořit adresář vlastní. Vkládání pomocí události oninit Pokud potřebujete vložit JavaScript pro každou stránku prezentace, vytvořte novou událost oninit a do této události pomocí funkce addheadhtml() vložte kód Vkládání pouze když je potřeba Příklady:

194 Sdílené objekty Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XVIII

195 Sdílené objekty Sdílené objekty V programovacím jazyku PHP chybí možnost ukládání objektů a jejich sdílení mezi jednotlivými PHP skripty. Visual PHP implementuje tuto chybějící vlastnost pomocí sdílených objektů, které jsou inicializovány při každém spuštění prezentace. Pro ukládání sdílených objektů slouží objekt Persistent. Objekt má následující metody: mixed getobject(mixed $objectname) vrátí uložený objekt pod zadaným názvem void setobject(string $objectname, mixed $objectvalue, bool $global=false) uloží objekt pod zadaným názvem. Pokud je nastaven parametr $global, bude objekt vytvořen automaticky jako globální při inicializaci prezentace Pro zobrazení sdílených objektů a možnost jejich odstranění přejděte do nabídky Prezentace -> Sdílené objekty 18.1 Ukládání objektů Objekty načtete pomocí metody getobject() a uložíte pomocí metody setobject() objektu Persistent Ukázka načtení a uložení proměnné: $Persistent = getobject("persistent"); $mycounter = $Persistent->getObject("myCounter"); $mycounter++; $Persistent->setObject("myCounter", $mycounter); U globálních sdílených objektů stačí pouze objekt uložit: $mycounter++; getobject("persistent")->setobject("mycounter", $mycounter, true);

196 Automatické parametry Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XIX

197 Automatické parametry Automatické parametry Pro situace, kdy je potřeba předávat parametr pomocí odkazů pro všechny stránky pod danou prezentací, jsou pro výrazné ulehčení práce k dispozici automatické parametry. Místo toho, abyste museli upravovat všechny odkazy v prezentaci, stačí zadat název parametru, který má být automaticky předáván a tento parametr předat v prvním odkazu. Nastavení parametru pro automatické předávání Pro zadání automatického parametru přejděte do nabídky Prezentace -> Automatické parametry. Pro přidání parametru vytvořte nový a zadejte jeho název. Zahájení předávání parametru Aby byl parametr automaticky předán, je potřeba vytvořit odkaz, kde bude tento parametr obsažen: index.php?myparameter=true Všechny odkazy budou poté rozšířeny o název a hodnotu tohoto parametru: documents.php?test=true&mid=4e b-8b11-6ce63e83d6a8 V případě, že je jsou zapnuté SEO odkazy, bude automatický parametr převeden do formátu /name. value/ /test.true/name_of_seo_link/ Zrušení předávání parametru Aby nebyl parametr dále předáván, je potřeba vytvořit odkaz, kde bude mít tento parametr prázdnou hodnotu. index.php?myparameter= nebo v případě SEO odkazů /test./ SEO odkazy Jakmile přidáte automatický parametr a používáte SEO odkazy, můžete doplnit SEO mapování o mapování pro tento parametr. Toto je vhodné v případě, že hodnota automatického parametru je neměnná. V opačném případě systém vytvoří SEO odkaz s parametrem jako složku /nazev.hodnota/ a přiřadí ke stávajícím SEO parametrům.

198 Frontend dokumenty Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XX

199 Frontend dokumenty Frontend dokumenty Pro případy, kdy je potřeba vizuálně zpracovat dokumenty, které ale nechceme zpřístupnit svému koncovému zákazníkovi k úpravám, jsou k dispozici frontend dokumenty. Tyto dokumenty jsou podobné klasickým dokumentům. Lze je zobrazit pomocí komponenty Table Content, nebo i ve skriptech pomocí metody getcontent() tabulky frontend_documents.

200 Databázová připojení Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XXI

201 Databázová připojení Databázová připojení Tabulky lze připojit na externí databáze pomocí databázového připojení. U tabulky je nutné toto připojení zadat v parametru databázové připojení. Typické použití je při sdílení dat mezi prezentacemi.

202 Jazyky Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XXII

203 Jazyky Jazyky Ve Visual PHP lze snadno vytvářet multijazyčné prezentace. Stačí pouze přidat požadovaný jazyk a systém si vše ostatní hlídá sám. Díky kódování UTF-8 lze zobrazit stránky v libovolné znakové sadě. Po přidání jazyka se automaticky rozšíří i multijazyčné komponenty a tím umožní zadat obsah v několika jazykových mutacích. Přehled jazyků naleznete v nabídce Prezentace -> Jazyky -> Jazyky prezentace 22.1 Automatická detekce jazyka Aby se návštěvníkovi zobrazila prezentace v jazyku, který podporuje jeho prohlížeč, je potřeba zapnout volbu Automatická detekce jazyka v nabídce Nástroje -> Nastavení. Pokud systém nenalezne jazyk, který podporuje návštěvníkův prohlížeč, použije výchozí jazyk zadaný v nabídce Prezentace -> Jazyky -> Jazyky prezentace Přepínání jazyků Jazyk je uložen v proměnné $language. Lze tedy přepnou jazyk pouhým předáním parametru Pro tyto účely tedy stačí vytvořit odkaz (může být textový nebo i obrázek s vlajkou). K dispozici je i možnost odkázat se na stejnou stránku ale pod jinou jazykovou mutací. K tomuto účelu slouží speciální funkce setlanguage(). Do odkazu tedy stačí na místo pevné URL vložit tento kód, který bude převeden automaticky na patřičný správný odkaz. Tato funkce zachovává SEO odkazy pro různé jazyky. Nedochází tedy k duplicitám v URL. Doporučujeme používat právě tuto variantu. <a href="{php: setlanguage('cs')}">česky</a>

204 Překlady Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XXIII

205 Překlady Překlady Abychom nemuseli vytvářet layouty a šablony v několika jazycích, lze doplnit prezentaci o vlastní překlady. Pro překlady přejděte do nabídky Prezentace -> Jazyky -> Překlady. Vytvořte nový záznam, vyberte jazyk a na samostatné řádky postupně zadávejte jednotlivé překlady ve formátu text=přeložený text. Poté stačí kdekoli v prezentaci vložit _T(text pro překlad) a podle jazyka bude tento text automaticky přeložen. _T("my text") Pro překlady ve vlastních skriptech lze použít funkci translate(). echo translate("my text");

206 Správce procesů Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XXIV

207 Správce procesů Správce procesů Správce procesů zobrazuje stav procesů spuštěných na pozadí. Lze kontrolovat stav a aktuální průběh všech procesů společně.

208 Terminál Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XXV

209 Terminál Terminál Terminál umožňuje spouštět příkazy přímo na serveru podobně, jako byste byli připojení přes konzoli. Možnost spouštět příkazy přímo na serveru bývá na většině serverů zakázána. Typicky toho můžete využít na svém vlastním serveru. Terminál spustíte z nabídky Nástroje -> Terminál.

210 SEO Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XXVI

211 SEO SEO Search Engine Optimization (SEO) je dnes nedílnou součástí jakékoli prezentace. Jde o optimalizaci stránek pro vyhledávače tak, aby se stránka ve vyhledávači zobrazovala na vyšších pozicích a tím přilákala více návštěvníků SEO mapování SEO je ale především pro neprofesionály tvrdým oříškem. Visual PHP poskytuje v tomto směru vynikající nástroj SEO mapování. SEO mapování funguje na principu nahrazování parametrů v odkazu jejich textovými ekvivalenty. Toto mapování je generováno automaticky, ale lze zadat i vlastní parametry ke konverzi. Pro zobrazení mapování přejděte do nabídky Nástroje -> SEO -> SEO mapování. K dispozici jsou následující parametry: Odkaz část klasického odkazu, který má být nahrazen SEO odkaz text, kterým bude nahrazena část odkazu Tabulka název tabulky, která bude čtena, pokud bude použit tento SEO odkaz Identifikátor (externí) identifikátor záznamu tabulky, ke kterému tento odkaz patří Generovaný Specifikuje, zda byl odkaz generován automaticky, nebo zadán ručně Jazyk Specifikuje jazyk, pro který platí tento SEO odkaz Ukázka SEO mapování Fungování SEO mapování si ukážeme na následujícím příkladě. V SEO mapování máme nastaveny tyto hodnoty: Odkaz: id=052a7fc5-48aa-102b-bd5d-d3b f SEO odkaz: muj-dokument Tabulka: documents Identifikátor (externí): 052a7fc5-48aa-102b-bd5d-d3b f Generovaný: ano Jazyk: česky Věškeré odkazy v prezentaci odkazující na tento dokument

212 212 Visual PHP Developer Guide budou převedeny na SEO odkaz Visual PHP provede před zpracováním stránky zpětnou konverzi SEO odkazu a nastaví z něj příslušné parametry $id = $tablename = 052a7fc5-48aa-102b-bd5d-d3b f documents Konverze odkazů na SEO odkazy pomocí SEO mapování je provedena pouze v tom případě, že pro všechny parametry odkazu je k dispozici jejich textový ekvivalent. SEO odkazy mohou být složeny z několika mapování současně. Pouze v případě, kdy lze všechny parametry převést na SEO odkaz bude SEO odkaz vytvořen. Pro příklad si ukážeme převod odkazu u vícejazyčných prezentací. bude převedeno na tento SEO odkaz Pro převod bylo k dispozici následující SEO mapování Odkaz: language=cs mid=5b37e792-0f58-102b-83ea-533b3040b1b6 SEO Odkaz cs /muj-dokument/ Tabulka documents Visual PHP navíc umožňuje i multijazyčné mapování. Pokud pozná, že odkaz směřuje na dokument s jiným jazykem, bude převeden pomocí mapování s tímto nastaveným jazykem. Jednou z dalších předností je podpora znakových sad, které nejsou psány latinkou. Lze tedy vytvářet SEO odkazy i pro ruské, arabské, čínské i jiné znakové sady Zamezení duplicitního obsahu Jako duplicitní obsah vnímají vyhledávače takové stránky, kde na stejnou prezentaci odkazuje více domén. Vyhledávače proto tyto další domény ignorují a zaindexují pouze jednu z nich. Abychom mohli vyhledávačům nařídit, kterou doménu mají indexovat, je potřeba zadat hlavní doménu (Prezentace -> Nastavení -> SEO). Všechny ostatní domény směřující na prezentaci budou přesměrovány právě na tuto doménu pomocí HTTP hlavičky 301. Mohou ale nastat případy, kdy máte pod stejnou prezentací implementovány stránky pro různé domény třetího řádu. Aby nedošlo k automatickému přeměrování těchto domén na hlavní doménu, zadejte jejich názvy do pole domény 3. řádu (Prezentace -> Nastavení -> SEO).

213 SEO Hromadné generování SEO mapování Pokud zapnete SEO optimalizaci až v momentě naplnění daty, nebude SEO mapování k dispozici. Proto je možné toto mapování hromadně vygenerovat pro všechny záznamy všech tabulek přístupných k administraci. Pro hromadné generování přejděte do nabídky Nástroje -> SEO -> Generátor SEO mapování. Vyberte tabulky, ze kterých chcete generovat SEO mapování a stiskněte tlačítko Generovat. Pokud není možné některé SEO mapování vygenerovat, zobrazí se varování ke konkrétním záznamům SEO prohlížeč Pro správnou SEO analýzu je potřeba vědět, jak vidí roboti vyhledávačů Vaše stránky. Pro tyto účely je k dispozici SEO prohlížeč. Pro zobrazení prohlížeče přejděte do nabídky Nástroje -> SEO -> SEO prohlížeč. Prohlížeč Vám zobrazí stránku bez obrázků a kaskádových stylů. Zvýrazňuje nadpisy a umožňuje kliknutím na odkazy procházet další podstránky.

214 Firewall Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XXVII

215 Firew all Firewall Díky integrovanému firewallu lze zamezit spam-botům odesílání spamu do formulářů, případně lze zamezit pokusům o útok. Omezit lze pomocí části URL nebo IP adresy. Omezení pomocí IP adresy je nutné zadávat obezřetně, jelikož jsou často využívány nepřímé metody útoku, kdy jsou na cizí stránky pouze vloženy odkazy s URL napadající Váš server, ale spouštěny jsou roboty (např. Google). Proto by bylo nevhodné zablokovat tomuto robotu vstup na stránky.

216 Obrázky Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XXVIII

217 Obrázky Obrázky 28.1 Template Image Komponenta Template Image umožňuje za chodu upravovat a zobrazovat obrázky. Díky tomu můžete mít z jednoho zdrojového obrázku neomezené množství různých velikostí tohoto obrázku. K dispozici je i možnost přidat vodoznak z gif nebo png zdroje. Navíc lze nastavit i další efekty jako zobrazení většího obrázku po najetí myší, nebo zobrazení celého obrázku po kliknutí na obrázek. Komponentu Template Image můžete využít pouze v šablonách pro pole s přiřazenou komponentou IMAGE. K dispozici jsou následující nastavení: Základní Field Name Název pole, ze kterého se má zobrazit obrázek Width Šířka obrázku. Lze zadat číslo, nebo parametr vynechat a šířka bude dopočítána. Více o změnách velikostí se dočtete v kapitole Změna velikosti. Height Výška obrázku. Lze zadat číslo, nebo parametr vynechat a šířka bude dopočítána. Více o změnách velikostí se dočtete v kapitole Změna velikosti. Resize Method Způsob, jakým bude obrázek transformován. scale - změna velikosti se zachováním poměru stran stretch - změna velikosti bez zachování poměru stran crop - výřez se zachováním poměru stran Rotate Počet stupňů ve směru hodinových ručiček, o kolik bude obrázek otočen. Background Color Barva pozadí obrázku, která se použije pro vyplnění prázdných míst po otočení. Watermark Image Obrázek, který bude použit jako vodoznak. Je možné nahrát transparentní GIF, nebo alphatransparentní PNG. Watermark Opacity Definuje průhlednost obrázku pro vodoznak. K dispozici jsou hodnoty od 0 do 100. Hodnota 100 vloží vodoznak tak, jak je. Hodnota 50 vloží vodoznak s 50% průhledností. Při hodnotě 0 nebude vodoznak vidět vůbec. U obrázků ve formátu PNG lze použít transparentnost definovanou přímo v tomto obrázku za použití hodnoty 100. U jiných hodnot dojde k zprůhlednění podobně jako u jiných formátů. Watermark Position Nastavuje pozici, kde bude vodoznak zobrazen.

218 218 Visual PHP Developer Guide Watermark Scale Nastavuje změnšení vodoznaku v poměru ke zdrojovému obrázku. Hodnota 50 přidá vodoznak o poloviční šířce a výšce, než je obrázek, kam se má vodoznak vložit. Empty Image Default Image Výchozí obrázek, který se zobrazí v případě, že pole zadané ve Field Name neobsahuje obrázek Maintain Size Specifikuje, zda se má zachovat šířka a výška původního obrázku Mouse Over Field Name Název pole, ze kterého se bude zobrazovat obrázek po najetí myší. Width Šířka obrázku. Lze zadat číslo, nebo parametr vynechat a šířka bude dopočítána. Více o změnách velikostí se dočtete v kapitole Změna velikosti. Height Výška obrázku. Lze zadat číslo, nebo parametr vynechat a šířka bude dopočítána. Více o změnách velikostí se dočtete v kapitole Změna velikosti. Resize Method Způsob, jakým bude obrázek transformován. scale - změna velikosti se zachováním poměru stran stretch - změna velikosti bez zachování poměru stran crop - výřez se zachováním poměru stran Template Název šablony, která bude použita místo obrázku. V této šabloně lze zobrazit více informací s libovolným vzhledem. Align Zarovnání obrázku po najetí myší vůči původnímu obrázku alcentervertical- zarovná na střed svisle alcenterhorizontal - zarovná na střed vodorovně alcenterboth - zarovná na střed v obou směrech Container Style Definuje CSS inline styl elementu obklopujícího obrázek po najetí myši. Watermark Image Obrázek, který bude použit jako vodoznak. Je možné nahrát transparentní GIF, nebo alphatransparentní PNG. Watermark Opacity Definuje průhlednost obrázku pro vodoznak. K dispozici jsou hodnoty od 0 do 100. Hodnota 100 vloží vodoznak tak, jak je. Hodnota 50 vloží vodoznak s 50% průhledností. Při hodnotě 0 nebude vodoznak vidět vůbec. Průhlednost lze nastavit pouze u GIF obrázků. U obrázků ve formátu PNG je potřeba vložit vodoznak s průhledností definovanou přímo v samotném obrázku.

219 Obrázky 219 Watermark Position Nastavuje pozici, kde bude vodoznak zobrazen. Watermark Scale Nastavuje změnšení vodoznaku v poměru ke zdrojovému obrázku. Hodnota 50 přidá vodoznak o poloviční šířce a výšce, než je obrázek, kam se má vodoznak vložit. Mouse Click URL Adresa, na kterou bude uživatel přesměrován po kliknutí Field Name Název pole, ze kterého se bude zobrazovat obrázek po kliknutí Width Šířka obrázku. Lze zadat číslo, nebo parametr vynechat a šířka bude dopočítána. Více o změnách velikostí se dočtete v kapitole Změna velikosti. Height Výška obrázku. Lze zadat číslo, nebo parametr vynechat a šířka bude dopočítána. Více o změnách velikostí se dočtete v kapitole Změna velikosti. Resize Method Způsob, jakým bude obrázek transformován. scale - změna velikosti se zachováním poměru stran stretch - změna velikosti bez zachování poměru stran crop - výřez se zachováním poměru stran Effect Typ efektu, který bude použit po kliknutí myší Open URL - otevře zadanou URL Open in new window - otevře obrázek v novém okně Display Over Presentation - zobrazí obrázek ve vrstvě nad prezentací pomocí javascriptového prohlížeče Title Field Name Název pole, ve kterém je uložen název obrázku. Tento popis se zobrazí v javascriptovém prohlížeči Description Field Name Název pole, ve kterém je uložen popis obrázku. Tento popis se zobrazí v javascriptovém prohlížeči Download Protection Nastaví ochranu proti stahování obrázku z prohlížeče. Upozornění! Tato ochrana nezabrání zjištění URL adresy ze zdrojového kódu. Watermark Image Obrázek, který bude použit jako vodoznak. Je možné nahrát transparentní GIF, nebo alphatransparentní PNG. Watermark Opacity Definuje průhlednost obrázku pro vodoznak. K dispozici jsou hodnoty od 0 do 100. Hodnota 100 vloží

220 220 Visual PHP Developer Guide vodoznak tak, jak je. Hodnota 50 vloží vodoznak s 50% průhledností. Při hodnotě 0 nebude vodoznak vidět vůbec. Průhlednost lze nastavit pouze u GIF obrázků. U obrázků ve formátu PNG je potřeba vložit vodoznak s průhledností definovanou přímo v samotném obrázku. Watermark Position Nastavuje pozici, kde bude vodoznak zobrazen. Watermark Scale Nastavuje změnšení vodoznaku v poměru ke zdrojovému obrázku. Hodnota 50 přidá vodoznak o poloviční šířce a výšce, než je obrázek, kam se má vodoznak vložit. CSS class třída CSS, definovaná ve Stylech style inline styl pro obrázek JavaScript Events onmouseover Javascriptový kód, který bude vykonán při najetí myší nad obrázek onmouseout Javascriptový kód, který bude vykonán při najetí myší mimo obrázek onclick Javascriptový kód, který bude vykonán při kliknutí na obrázek Kvalita generovaných obrázků Kvalitu můžete ovlivnit globálně pomocí nastavení kvality v nabídce Nástroje -> Nastavení -> Systém a změnou hodnoty ve vlastnosti Kvalita obrázku Změna velikosti K dispozici jsou různé možnosti změny velikosti obrázků. Změna velikosti se zachováním poměru stran (scale) Pokud nastavíte šířku i výšku oblasti a metodu scale, bude obrázek změněn tak, aby nepřesáhl vytýčenou oblast.

221 Obrázky 221 Pokud nastavíte pouze šířku a metodu scale, bude obrázek změněn tak, aby nepřesáhl tuto šířku. Výška obrázku bude dopočítána tak, aby byl zachován poměr stran. Pokud nastavíte pouze výšku a metodu scale, bude obrázek změněn tak, aby nepřesáhl tuto výšku. Šířka obrázku bude dopočítána tak, aby byl zachován poměr stran. Změna velikosti bez zachování poměru stran (stretch) Pokud nastavíte šířku i výšku a metodu stretch, bude obrázek změněn tak, aby vyplnil celou tuto oblast.

222 222 Visual PHP Developer Guide Obrázek bude deformován, protože není zachován poměr stran. Výřez se zachováním poměru stran (crop) Pokud nastavíte šířku i výšku a metodu crop, bude obrázek změněn tak, aby nepřesáhl jedním rozměrem šířku (pokud je typu portrait) nebo výšku (pokud je typu landscape) a bude oříznut na rozměry zadané oblasti Vodoznak K obrázkům lze přidat vodoznak. Tento vodoznak musí být v samostatném obrázku ve formátu průhledného GIFu, nebo alphatransparentního PNG. Vodoznak ve formátu GIF Stačí vytvořit průhledný obrázek ve formátu GIF. Průhlednost, s jakou bude tento obrázek přidán do

223 Obrázky 223 původního obrázku se nastavuje v parametru Watermark Opacity. Vodoznak ve formátu PNG Tento formát umožňuje sám o sobě stupně průhlednosti. Je potřeba vytvořit obrázek ve formátu PNG s požadovanou průhledností. Parametr Watermark Opacity nemá u tohoto typu obrázku zádný vliv. Výhodou vodoznaků v PNG je jemnější vyhlazení přechodů mezi vodoznakem a původním obrázkem. Vodoznak přes celý obrázek Ve výchozím stavu se vodoznak zobrazí přes celý obrázek. V případě, že obrázek s vodoznakem je větší nebo menší, než původní obrázek, bude velikost vodoznaku automaticky přizpůsobena. Průhlednost vodoznaku Tuto průhlednost můžete u GIF vodoznaků nastavit pomocí parametru Watermark Opacity.

224 224 Visual PHP Developer Guide Vodoznak na konkrétní pozici Pokud potřebujete umístit vodoznak do rohu obrázku, lze nastavit pozici vodoznaku pomocí parametru Watermark Position.

225 Obrázky Velikost vodoznaku Jelikož nemusí být velikost výsledného obrázku předem známa, lze měnit procentuálně velikost vkládaného vodoznaku. Toto nastavení lze provést parametrem Watermark Scale. 225

226 Ladění (debug) Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XXIX

227 Ladění (debug) Ladění (debug) V případech, kdy si nejste jisti, které hodnoty Visual PHP zpracovává, které hodnoty načítá z databáze nebo které šablony a layouty vkládá, je k dispozici možnost zobrazit tyto hodnoty. Pro zobrazení těchto informací je potřeba aktivovat Debug konzoli. V prezentaci zadejte do URL další parametr debug a nastavte mu hodnotu true. nebo v případě SEO odkazů Na konci prezentace se zobrazí okno, ve kterém můžete zobrazit požadovaná data Layouty Pro zobrazení informací o layoutech zaškrtněte volbu Layouts. Na daná místa v prezentaci se zobrazí zvýrazněné layouty s dalšími informacemi o názvu, zobrazení atd.

228 Moduly Visual PHP Užívejte si volnosti administrace Vaší internetové prezentace Kapitola XXX

229 Moduly Moduly Pro rychlou tvorbu je k dispozici velké množství výchozích modulů připravených pro okamžité použití. Tyto moduly jsou plně konfigurovatelné a slouží především k tomu, abyste nemuseli běžné moduly implementovat sami E-shop Visual PHP obsahuje přednastavený základní e-shop. Základem e-shopu jsou výchozí tabulky, frontend dokumenty a skripty. Jelikož každý projekt má své specifické požadavky, lze tyto tabulky a další prvky libovolně modifikovat a rozšířovat Tabulky Pro pohodlnou implementaci e-shopu do Vaší prezentace jsou k dispozici tyto tabulky: Katalog zboží (m_shop_catalogue) Katalog zboží je hlavní tabulka e-shopu, která obsahuje jednotlivé položky e-shopu. Modul je postaven tak, aby tuto tabulku bylo možno duplikovat a rozšířit o další pole, aby bylo možné v různých tabulkách hledat podle specifických kritérií. V objednávkách je poté rozlišeno, ze které tabulky zboží pochází. Tabulka obsahuje tyto pole: Název pole Typ komponenty tabsheetcommon TABSHEET id UUID Identifikátor date DATETIME Datum vytvoření displaytype COMBOBOX Zobrazení image IMAGE Obrázek IMAGE Náhled mid LOOKUPTREE Kategorie zboží (je navázáno na menu) number TEXT Číslo zboží name TEXT Název zboží producer LOOKUP Výrobce description TEXTAREA Popis zboží commonprice TEXT Běžná cena ownprice TEXT Naše cena discount TEXT Sleva price AUTOCALC Cena tax COMBOBOX DPH taxprice AUTOCALC Cena s DPH author USERS Autor záznamu properties LOOKUPCHECKGROUP Vlastnosti zboží thumbnail

230 230 Visual PHP Developer Guide groups LOOKUPCHECKGROUP tabsheetadditional additional Skupiny zboží TABSHEET HTMLAREA Plný popis zboží Pro zobrazení zboží vytvořte položku menu, která se bude odkazovat na sekci Katalog zboží a má nastaveno, že jde o kategorii. Z menu se poté samy vytvoří odkazy na m_shop_catalogue.php. Položky lze samozřejmě zobrazit i přímo pomocí Table Content v layoutech například v postraních panelech. Výrobci (m_shop_producers) Tabulka Výrobci obsahuje informace o producentech daného zboží. U každého výrobce lze vložit i obrázek (např. logo) Tabulka obsahuje tyto pole: Název pole Typ komponenty id UUID Identifikátor name TEXT Název výrobce image IMAGE Obrázek thumbnail IMAGE Náhled V šabloně m_shop_catalogue můžete zobrazit výrobce takto: [producer::name] Vlastnosti zboží (m_shop_properties) Tabulka Vlastnosti zboží obsahuje informace o vlastnostech daného zboží. Typický příklad je např. dostupná velikost triček (M, L, XL, XXL) nebo příchutě (jahodová, malinová,...). Zákazník si může při objednávce vybrat jednu z těchto vlastností zboží. Tabulka obsahuje tyto pole: Název pole Typ komponenty id UUID Identifikátor name TEXT Název Pro zobrazení výběru vlastnosti je v šabloně m_shop_catalogue připraven vnořený PHP skript. Tento skript zobrazí rozbalovací nabídku pro výběr. Tento skript můžete odstranit, pokud nechcete tuto volbu používat

231 Moduly 231 if ($recordvalues["properties"]!= "") { $lookupvalues = explode(" ", $recordvalues["properties"]); $lookupfilter = array(); foreach($lookupvalues as $lookupvalue) { $lookupfilter[] = "id='".$lookupvalue."'"; } $Component = getcomponent("lookup", "m_shop_itemspec"); $Component->setParams("lookupTable=m_shop_properties,lookupField=name,lookupAlias=name,looku return($component->getcode()); } else return(""); Skupiny zboží (m_shop_groups) Tabulka Skupiny zboží obsahuje informace o tom, do které skupiny zboží patří. Typický příklad je např. skupina slevy, novinky nebo pro muže, pro ženy, atd. Zákazníkovi lze nastavit filtry, pomocí kterých si z daných kategorií vyfiltruje zboží ještě i podle těchto kritérií. Tabulka obsahuje tyto pole: Název pole Typ komponenty id UUID Identifikátor name TEXT Název Zákazníci (m_shop_customers) Do tabulky Zákazníci se ukládají informace o registrovaných zákaznících. Každý zákazník se musí před nákupem zaregistrovat, nebo lze povolit i nákup bez registrace. Pro zobrazení registračního formuláře pro zákazníka vytvořte odkaz na m_shop_signup.php. Tento soubor se odkazuje na výchozí skript m_shop_signup (Prezentace -> Skripty), který si můžete libovolně modifikovat. Pro přihlášení zákazníka vytvořte formulář s poli authlogin pro uživatelské jméno a authpassword pro heslo kdekoli v layoutu. Tabulka obsahuje tyto pole: Název pole Typ komponenty id UUID Identifikátor active COMBOBOX Aktivní (umožněno přihlášení) login TEXT Přihlašovací jméno password PASSWORD Heslo (zakódované v MD5) usergroups USERGROUPS Uživatelské skupiny name TEXT Celé jméno (fakturační adresa) ffirstname TEXT Křestní jméno (fakturační adresa) ftitle TEXT Titul (fakturační adresa) fsurname TEXT Příjmení (fakturační adresa)

232 232 Visual PHP Developer Guide fsex TEXT Pohlaví (fakturační adresa) fagerange TEXT Věk (fakturační adresa) fstreet TEXT Ulice (fakturační adresa) fcity TEXT Město (fakturační adresa) fpostalcode TEXT PSČ (fakturační adresa) fcountry LOOKUP Stát (fakturační adresa) fcompanyname TEXT Společnost (fakturační adresa) fic TEXT IČ (fakturační adresa) fdic TEXT DIČ (fakturační adresa) ftaxpayer CHECKBOX Plátce DPH (fakturační adresa) f TEXT (fakturační adresa) fphone TEXT Telefon (fakturační adresa) ffax TEXT Fax (fakturační adresa) dtitle TEXT Titul (dodací adresa) dfirstname TEXT Křestní jméno (dodací adresa) dsurname TEXT Příjmení (dodací adresa) dcompanyname TEXT Společnost (dodací adresa) dstreet TEXT Ulice (dodací adresa) dcity TEXT Město (dodací adresa) dpostalcode TEXT PSČ (dodací adresa) dcountry LOOKUP Stát (dodací adresa) d TEXT (dodací adresa) dphone TEXT Telefon (dodací adresa) dfax TEXT Fax (dodací adresa) signup CHECKBOX Přihlášení k odběru ů author USERS Autor pricegroup LOOKUP Slevová skupina icq TEXT ICQ skype TEXT Skype referertext TEXT Kdo doporučil fmobile TEXT Mobil (fakturační adresa) datecreated DATETIME Datum a čas vytvoření dateloggedin DATETIME Datum a čas posledního přihlášení Příklady Pro zobrazení odkazů pro registraci a přihlášení nebo informací, které se zobrazí po přihlášení, vložte do layoutu Include na layout s názvem m_shop_customer_actions. Tento layout obsahuje výchozí kód, který se mění v závislosti na tom, zda je uživatel přihlášen nebo ne.

233 Moduly 233 {#if $authsuccess['ugcustomers']} Přihlášen: {php: getobject('user')->name} změnit údaje objed {#if!$authsuccess['ugcustomers']}registrace přihlášení{#endif} Pokud chcete vytvořit přihlašovací formulář např. v pravém panelu, vytvořte si layout s libovolným názvem a obsahem <form> <input type="text" name="authlogin" /> <input type="password" name="authpassword" /> <input type="button" value="přihlásit" /> </form> Poté vytvořte layout se stejným názvem a s podmínkou $authsuccess["ugcustomers"] a do něj vložte kód, který se Přihlášen: {php: getobject('user')->name} změnit údaje objednávky odhlásit Na požadované místo layoutu vložte Include Layout s názvem layoutu, který jste vytvořili Objednávky (m_shop_orders) Do tabulky Objednávky se ukládají objednávky zákazníků. Tato tabulka obsahuje detail tabulku m_shop_order_items, ve které jsou uložené jednotlivé položky, které byly zákazníkem objednány. O objednávky se stará skript m_shop_purchase, který lze libovolně modifikovat dle přání zákazníka. Tabulka obsahuje tyto pole: Název pole Typ komponenty tabsheetcommon TABSHEET id UUID Identifikátor date DATETIME Datum vytvoření customer LOOKUP Reference na zákazníka transporttype LOOKUP Typ dopravy paymenttype LOOKUP Typ platby note TEXTAREA Poznámka orderstate COMBOBOX Stav objednávky author USERS Autor number TEXT Číslo objednávky pricetotal TEXT Cena celkem taxpricetotal TEXT Cena celkem s DPH tabsheetcustomer TABSHEET name TEXT Celé jméno ftitle TEXT Titul (fakturační adresa) fsurname TEXT Příjmení (fakturační adresa) fstreet TEXT Ulice (fakturační adresa) fcity TEXT Město (fakturační adresa)

234 234 Visual PHP Developer Guide fpostalcode TEXT PSČ (fakturační adresa) fcountry TEXT Stát (fakturační adresa) fcompanyname TEXT Název společnosti (fakturační adresa) fic TEXT IČ (fakturační adresa) fdic TEXT DIČ (fakturační adresa) ftaxpayer CHECKBOX Plátce DPH (fakturační adresa) f TEXT (fakturační adresa) fphone TEXT Telefon (fakturační adresa) ffax TEXT Fax (fakturační adresa) ffirstname TEXT Křestní jméno (fakturační adresa) dtitle TEXT Titul (dodací adresa) dfirstname TEXT Křestní jméno (dodací adresa) dsurname TEXT Příjmení (dodací adresa) dcompanyname TEXT Název společnosti (dodací adresa) dstreet TEXT Ulice (dodací adresa) dcity TEXT Město (dodací adresa) dpostalcode TEXT PSČ (dodací adresa) dcountry TEXT Stát (dodací adresa) d TEXT (dodací adresa) dphone TEXT Telefon (dodací adresa) dfax TEXT Fax (dodací adresa) tabsheetprices TABSHEET prices DETAILTABLE Položky objednaného zboží Zobrazení objednávek v administraci Do Prezentace -> Admin Menu přidejte položku s názvem m_shop_orders Do tabulky Objednávky (položky) (m_shop_order_items) se ukládají jednotlivé položky objednávek zákazníků. Tato tabulka je detail tabulkou tabulky m_shop_orders. Způsob platby (m_shop_paymenttypes) Tabulka Způsob platby umožňuje zákazníkům vybrat si, jakým způsobem zaplatí za zboží (např. bankovním převodem, hotovost, atd..) Tento způsob si určí během objednávky. Tabulka obsahuje tyto pole: Název pole Typ komponenty id UUID Identifikátor name TEXT Název postalprice TEXT Poštovné

235 Moduly packagingprice TEXT Balné taxpricetotalfrom TEXT Cena od taxpricetotalto TEXT Cena do visible CHECKBOX Viditelný author USERS Autor 235 Způsob doručení (m_shop_transporttypes) Tabulka Způsob doručení umožňuje zákazníkům vybrat si, jakým způsobem mu bude zboží doručeno (např. osobní odběr, pošta,...) Tento způsob si určí během objednávky. Tabulka obsahuje tyto pole: Název pole Typ komponenty id UUID Identifikátor name TEXT Název postalprice TEXT Poštovné packagingprice TEXT Balné taxpricetotalfrom TEXT Cena od taxpricetotalto TEXT Cena do visible CHECKBOX Viditelný author USERS Autor Slevové skupiny (m_shop_price_groups) Tabulka Slevové skupiny umožňuje přesunovat zákazníky do různých skupin, ve kterých získávají slevy. Typicky získávají slevy po dosažení určité celkové ceny za všechny své objednávky Tabulka má následující pole Název pole Typ komponenty id UUID Identifikátor name TEXT Název discount TEXT Sleva % orderpricetotal TEXT Celková cena za objednávky default CHECKBOX Výchozí sleva Frontend dokumenty Formuláře a další dokumenty pro e-shop jsou uloženy ve frontend dokumentech. Registrace m_shop_signup Text po registraci m_shop_signup_success

236 236 Visual PHP Developer Guide Přihlášení m_shop_login Nákupní košík m_shop_items_step1 Objednávka m_shop_items_step2 Kontrola objednávky m_shop_items_step3 Dokončení objednávky m_shop_items_step4 m_shop_items_mail Skripty Skripty pro obsluhu e-shopu jsou uloženy ve Skriptech Registrace m_shop_signup Objednávka m_shop_purchase Nastavení Výchozí e-shop umožňuje prodej zboží pro plátce (i neplátce) DPH s možností (nebo nutností) registrace. Pro změnu těchto nastavení přejděte do nabídky Nástroje -> Nastavení do záložky Obchod. Registrace zákazníků vyžadováno - pro objednání zboží je nutná registrace zákazníků umožněno - zboží lze objednat jednorázově i bez registrace Plátce DPH Specifikuje, zda je prodávající plátcem DPH. V závislosti na těchto nastaveních budou použity rozdílné šablony v nákupním košíku Dodací adresa Specifikuje, zda je možné zadat jinou dodací adresu než fakturační Název firmy Název, který bude zobrazen v objednávkách firmy Na tento budou zasílány objednávky Ulice, Město, PSČ, Stát, IČ, DIČ Další informace o firmě Katalog zboží Zboží určené k prodeji přes e-shop je uloženo v tabulce m_shop_catalogue. Administrace katalogu Pro zpřístupnění administrace katalogu zboží přidejte novou položku do Admin Menu (Prezentace -> Admin Menu) s názvem m_shop_catalogue. Po přidání se nahoře v menu v administraci objeví nová položka s názvem Katalog. Po kliknutí na tuto položku je možné spravovat zboží pro e-shop.

237 Moduly 237 Zobrazení katalogu v prezentaci pomocí odkazu Pro zobrazení přehledu zboží stačí vytvořit textový nebo obrázkový odkaz na m_shop_catalogue.php ( můžete jej vytvořit přímo v global layoutu, nebo kdekoli jinde). Tento odkaz zobrazí všechny záznamy katalogu zboží. Zobrazení katalogu v prezentaci pomocí menu Ve většině případů se bude používat odkaz na katalog zboží s pomocí komponenty Menu, která se zobrazuje v prezentaci (typicky se vkládá do global layoutu). Jak vložit komponentu Menu do prezentace a jak spravovat jeho obsah se dozvíte v kapitole Menu. K dispozici jsou 2 různé způsoby zobrazení zboží: Společné zobrazení Pro zobrazení všech záznamů katalogu vytvořte v menu pro prezentaci novou položku (tzn. v administraci vyberte z nabídky položku s názvem Menu a klikněte na Nový záznam), zadejte jí libovolný název, nastavte sekci odkazu na Katalog a ze způsobu zobrazení vyberte Přehled všech záznamů (bez rozlišení navázání na položky menu). Tato položka menu bude odkazovat na m_shop_catalogue.php. Tip: Pokud nevidíte ve výběru sekce odkazu hodnotu Katalog, j e nutné přidat m_shop_catalogue do Admin Menu. Zobrazení podle kategorií Pokud je potřeba členit zboží do kategorií, lze použít přiřazení zboží k jednotlivým položkám menu prezentace. Pro tento případ vytvořte více položek menu v administraci menu (tzn. v administraci vyberte z nabídky položku s názvem Menu a klikněte na Nový záznam). Jednotlivým položkám zadejte libovolný název, nastavte sekci odkazu na Katalog a ze způsobu zobrazení vyberte Přehled záznamů (navázaných na tuto položku menu). Tyto položky menu budou odkazovat na m_shop_catalogue. php?mid=_identifikátor_položky_menu&iscategory=true. Každý záznam katalogu zboží je poté nutné přiřadit konkrétní položce menu. Tip: Pokud nevidíte ve výběru sekce odkazu hodnotu Katalog, j e nutné přidat m_shop_catalogue do Admin Menu. Úprava vzhledu v šablonách K dispozici jsou 4 různé šablony, vždy v páru pro zobrazení přehledu a plného zobrazení. m_shop_catalogue (vtlist) Šablona pro zobrazení v přehledu pro neplátce DPH. m_shop_catalogue (vtfull) Šablona pro zobrazení konkrétního záznamu pro neplátce DPH. m_shop_catalogue_tax (vtlist) Šablona pro zobrazení v přehledu pro plátce DPH. m_shop_catalogue_tax (vtfull) Šablona pro zobrazení konkrétního záznamu pro plátce DPH.

238 238 Visual PHP Developer Guide Nastavení v layoutech To, zda se použije šablona pro plátce nebo neplátce DPH, je nadefinováno v Table Content pomocí parametru Template. Tato komponenta se nachází v layoutu m_shop_catalogue. Pro rozlišení názvu šablony je použito následující direktivy, která využívá nastavení z objektu Settings: Template: m_shop_catalogue{php: $Settings->shopTax=="true"? "_tax" : ""} Díky této direktivě se použije šablona s nebo bez _tax na konci. Rozlišení zda jde o šablonu pro přehled nebo plné zobrazení se provádí automaticky Košík Pro zobrazení obsahu košíku stačí vytvořit odkaz na m_shop.php. Tento soubor ve skutečnosti spouští skript m_shop_purchase, který naleznete v nabídce Prezentace -> Skripty. Tento skript si můžete samozřejmě libovolně modifikovat podle potřeb Vašeho zákazníka. Vložení do košíku Pro přidání záznamu do košíku je potřeba volat soubor m_shop.php s určitými parametry. Formulář naleznete v šablonách m_shop_catalogue. Skript vyžaduje následující parametry: m_shop_actiontype - typ akce nad záznamy v košíku (pro vložení hodnota additem) m_shop_tablename - název tabulky, ze které se má vložit záznam do košíku m_shop_id - identifikátor záznamu, který se má vložit do košíku Po volání tohoto skriptu se zobrazí košík s přidaným záznamem. Výchozí šablony obsahují formulář a tlačítko pro přidání záznamu do košíku. Tento formulář můžete použít jako vzor při úpravách šablon. Kroky objednávky Pro každý krok objednávky existuje výchozí frontend dokument, který je zobrazován. Tyto frontend dokumenty můžete přizpůsobit svým požadavkům. Krok 1 - nákupní košík Pro zobrazení obsahu košíku je používán frontend dokument m_shop_items_step1 pro neplátce DPH nebo m_shop_items_step1_tax pro plátce DPH.

239 Moduly 239 V tomto frontend dokumentu je zobrazení obsahu košíku realizováno pomocí komponenty Table Content, která čte a zobrazuje data z tabulky m_shop_order_items. Šablony, které tato komponenta používá, lze samozřejmě opět libovolně upravit. Použity jsou šablony s názvem m_shop_items_step1 pro neplátce DPH nebo m_shop_items_step1_tax pro plátce DPH. Tyto šablony obsahují formulářové prvky a další podpůrné skripty pro počítání celkové ceny. Pro správnou funkčnost nákupního košíku je nutné tyto skripty při úpravách zachovat. Krok 2 - údaje o objednavateli Po kliknutí na tlačítko Objednat se zobrazí druhý krok, který je nadefinován ve frontend dokumentu m_shop_items_step2 pro neplátce DPH nebo m_shop_items_step2_tax pro plátce DPH. Opět můžete libovolně upravovat obsah tohoto dokumentu.

240 240 Visual PHP Developer Guide

241 Moduly 241 V tomto frontend dokumentu je zobrazení obsahu košíku realizováno pomocí komponenty Table Content, která čte a zobrazuje data z tabulky m_shop_order_items. Šablony, které tato komponenta používá, lze samozřejmě opět libovolně upravit. Použity jsou šablony s názvem m_shop_items_step23 pro neplátce DPH nebo m_shop_items_step23_tax pro plátce DPH sdílené s krokem 3. Tyto šablony obsahují další podpůrné skripty pro počítání celkové ceny. Pro správnou funkčnost nákupního košíku je nutné tyto skripty při úpravách zachovat. Krok 3 - kontrola údajů Po kliknutí na tlačítko Objednat se zobrazí třetí krok, který je nadefinován ve frontend dokumentu m_shop_items_step3 pro neplátce DPH nebo m_shop_items_step3_tax pro plátce DPH. Opět můžete libovolně upravovat obsah tohoto dokumentu.

242 242 Visual PHP Developer Guide

243 Moduly 243 V tomto frontend dokumentu je zobrazení obsahu košíku realizováno pomocí komponenty Table Content, která čte a zobrazuje data z tabulky m_shop_order_items. Šablony, které tato komponenta používá, lze samozřejmě opět libovolně upravit. Použity jsou šablony s názvem m_shop_items_step23 pro neplátce DPH nebo m_shop_items_step23_tax pro plátce DPH sdílené s krokem 2. Tyto šablony obsahují další podpůrné skripty pro počítání celkové ceny. Pro správnou funkčnost nákupního košíku je nutné tyto skripty při úpravách zachovat. Krok 4 - kontrola údajů Po kliknutí na tlačítko Objednat se uloží objednávka do databáze, rozešlou se y a zobrazí se poděkování za objednávku, které je nadefinováno ve frontend dokumentu m_shop_items_step4. Opět můžete libovolně upravovat obsah tohoto dokumentu Registrace Pro registraci zázkazníků je potřeba volat soubor m_shop_signup.php. Tento soubor ve skutečnosti spouští skript m_shop_signup, který naleznete v nabídce Prezentace -> Skripty. Tento skript si můžete samozřejmě libovolně modifikovat podle potřeb Vašeho zákazníka. Úprava registračního formuláře Skript m_shop_signup načítá a zobrazuje frontend dokument m_shop_signup, který obsahuje formulář pro zadávání údajů. Po odeslání tohoto formuláře je opět volán skript m_shop_signup, který zpracuje vložená data. Důvodem, proč je tento formulář ve frontend dokumentech a ne v klasických dokumentech je ten, aby zákazník neměl možnost měnit strukturu tohoto formuláře, protože nemá znalosti programátora Přihlášení Formulář pro přihlášení zákazníků se zobrazuje automaticky, při vkládání zboží do košíku. Většinou je ale potřeba mít přihlašovací formulář i jinde v panelech a po přihlášení uživatele zobrazit další informace o obsahu košíku. Registrovaní uživatelé jsou uloženi v tabulce m_shop_customers. Tato tabulka rozšiřuje tabulku users, takže je možné přihlašovat se pomocí parametrů authlogin a authpassword. Layout pro přihlášení Na místo global layoutu, kde chcete mít přihlašovací formulář střídaný s informacemi o uživateli vložte komponentu Include Layout. Zadejte jí název například login a global layout uložte. Část global layoutu by mohla vypadat následovně:

244 244 Visual PHP Developer Guide Nyní je potřeba vytvořit 2 samostatné layouty s tímto názvem rozlišených podmínkou: Vytvořte layout s názvem login a do něj vložte formulář. Nastavte mu metodu POST a do něj umístěte formulářové prvky: textové pole s názvem authlogin pole pro heslo s názvem authpassword tlačítko pro odeslání formuláře a další textové popisky dle designu prezentace Layout by mohl vypadat následovně: Dále je potřeba vytvořit druhý layout se stejným názvem login, který bude zobrazen po úspěšném přihlášení: Do tohoto layoutu lze zadat například informace o přihlášeném uživateli a odkaz pro odhlášení. Důležité je rozlišit tyto 2 layouty, aby systém věděl, který z nich vložit na místo komponenty Include Layout. Proto tomuto layoutu nastavíme podmínku $User->loggedIn. Pokud nebude splněna, vloží se předchozí layout, tedy layout bez nastavené podmínky. Layout může vypadat následovně Ve výsledku se za komponentu Include Layout vloží jeden z těchto layoutů v závislosti na podmínce. Takto mohou vypadat výsledné panely před a po přihlášení:

245 Moduly Odhlášení Odhlášení uživatele provedete vytvořením odkazu a předáním parametru authlogout=true. index.php?authlogout=true Výrobci Pro administraci výrobců zboží přidejte do Admin Menu položku s názvem m_shop_producers. Jednotlivé výrobce poté vybíráte v záznamu katalogu zboží. Zobrazení výrobce Název výrobce zboží můžete zobrazit v šabloně pomocí následujícího kódu [producer] Pokud chcete zobrazit více informací o výrobci, stačí vytvořit odkaz na tabulku m_shop_producers a předat identifikátor parametrem id. Tento identifikátor získáte v šabloně m_shop_catalogue z pole producer pomocí metody getvalue() komponenty LOOKUP, která je přiřazená tomuto poli: m_shop_producers.php?id=[producer.getvalue()] Objednávky Pro správu objednávek v administraci přidejte položku Admin Menu s názvem m_shop_orders. Jednotlivé objednávky a informace o objednavateli a objednaném zboží se zobrazí v přehledu po kliknutí na tuto položku admin menu.

Zobrazit více