WebToDate/Příručka vývojáře/WebToDate moduly - Historie editací

Jardac: Nahrazení textu „[[Category:WebToDate 4.1“ textem „[[Category:WebToDate“

2009-10-13T12:42:34Z

Nahrazení textu „[[Category:WebToDate 4.1“ textem „[[Category:WebToDate“

← Starší verze		Verze z 13. 10. 2009, 14:42
Řádek 1:		Řádek 1:
	[[Category:WebToDate ~~4.1~~ Příručka vývojáře]]		[[Category:WebToDate Příručka vývojáře]]
	[[Category:Příručka vývojáře]]		[[Category:Příručka vývojáře]]
	== Co jsou moduly ==		== Co jsou moduly ==

Jardac: Stránka WebToDate 4.1/Příručka vývojáře/WebToDate moduly přemístěna na stránku WebToDate/Příručka vývojáře/WebToDate moduly

2009-10-13T12:39:03Z

Stránka WebToDate 4.1/Příručka vývojáře/WebToDate moduly přemístěna na stránku WebToDate/Příručka vývojáře/WebToDate moduly

← Starší verze	Verze z 13. 10. 2009, 14:39
(Žádný rozdíl)

Bajkvl: /* */

2009-09-23T12:55:50Z

← Starší verze		Verze z 23. 9. 2009, 14:55
Řádek 876:		Řádek 876:

	'''Druhá záložka <tt>$tab2</tt> z příkladu formuláře.'''		'''Druhá záložka <tt>$tab2</tt> z příkladu formuláře.'''

	~~==== ====~~

	==== Výpis záznamů ====		==== Výpis záznamů ====

Bajkvl: /* Podpora vícejazyčných webů */

2009-09-23T12:47:39Z

Podpora vícejazyčných webů

← Starší verze		Verze z 23. 9. 2009, 14:47
Řádek 1 102:		Řádek 1 102:
	Aby se volba jazyka mohla přenášet i do skriptů, které se volají z dané stránky, je třeba definovat příslušná klíčová slova pro URL stránek s jiným druhem zobrazení dat. Například odkaz na detail jedné akce v Kalendáři akcí je třeba ve stylu pro příslušný seznam definovat takto:		Aby se volba jazyka mohla přenášet i do skriptů, které se volají z dané stránky, je třeba definovat příslušná klíčová slova pro URL stránek s jiným druhem zobrazení dat. Například odkaz na detail jedné akce v Kalendáři akcí je třeba ve stylu pro příslušný seznam definovat takto:

	<~~code~~>		:<tt><nowiki><a href="<!--WTD_DIARY(DIARYURL)-->"><!--WTD_DIARY(NAME)--></a></nowiki></tt>
	<nowiki><a href="<!--WTD_DIARY(DIARYURL)-->"><!--WTD_DIARY(NAME)--></a></nowiki>
	</~~code~~>

	Definice		Definice

	<~~code~~>		:<tt><nowiki><a href="/scripts/modules/diary/action.php?id=<!--WTD_DIARY(ID)-->"><!--WTD_DIARY(NAME)--></a></nowiki></tt>
	<nowiki><a href="/scripts/modules/diary/action.php?id=<!--WTD_DIARY(ID)-->"><!--WTD_DIARY(NAME)--></a></nowiki>
	</~~code~~>

	je sice funkční, ale pouze pro jeden jazyk. Pokud se zobrazuje stránka default.php?lid=2, je třeba, aby se za klíčové slovo DIARYURL dosadilo například		je sice funkční, ale pouze pro jeden jazyk. Pokud se zobrazuje stránka default.php?lid=2, je třeba, aby se za klíčové slovo DIARYURL dosadilo například

	<~~code~~>		:<tt><nowiki>/scripts/modules/diary/action.php?lid=2&id=26</nowiki></tt>
	<nowiki>/scripts/modules/diary/action.php?lid=2&id=26</nowiki>
	</~~code~~>

	== Registrace a personalizace ==		== Registrace a personalizace ==

Bajkvl: /* Ošetření chybových stavů ve skriptech */

2009-09-23T12:30:20Z

Ošetření chybových stavů ve skriptech

← Starší verze		Verze z 23. 9. 2009, 14:30
Řádek 1 063:		Řádek 1 063:

	Hlášení typu pokynů k ošetření chyb apod. se vkládají do předlohy ve formátu		Hlášení typu pokynů k ošetření chyb apod. se vkládají do předlohy ve formátu


	:<tt><nowiki><!--WTD_IF(příznak,hláška)--></nowiki></tt>		:<tt><nowiki><!--WTD_IF(příznak,hláška)--></nowiki></tt>



	tedy například		tedy například

Bajkvl: /* Ošetření chybových stavů ve skriptech */

2009-09-23T12:30:10Z

Ošetření chybových stavů ve skriptech

← Starší verze		Verze z 23. 9. 2009, 14:30
Řádek 1 064:		Řádek 1 064:
	Hlášení typu pokynů k ošetření chyb apod. se vkládají do předlohy ve formátu		Hlášení typu pokynů k ošetření chyb apod. se vkládají do předlohy ve formátu

	<~~code~~>
	<nowiki><!--WTD_IF(příznak,hláška)--></~~nowiki>~~		:<tt><nowiki><!--WTD_IF(příznak,hláška)--></nowiki></tt>
	<nowiki></~~nowiki~~>
	~~</code>~~

	tedy například		tedy například

	<~~code~~>		:<tt><nowiki><!--WTD_IF(WRONGDATETO,"Chybný formát datumu v poli Datum do.")--></nowiki></tt>
	<nowiki><!--WTD_IF(WRONGDATETO,"Chybný formát datumu v poli Datum do.")--></nowiki>
	</~~code~~>

	Příslušný veřejný skript musí zajistit, že tento kód se "odkomentuje" v případě, že dojde k příslušné události, nebo kompletně odstraní v případě, že k této události nedojde. Tyto hlášky opět mohou být i součástí fragmentu s formulářem, který se vygeneruje jakožto předloha.		Příslušný veřejný skript musí zajistit, že tento kód se "odkomentuje" v případě, že dojde k příslušné události, nebo kompletně odstraní v případě, že k této události nedojde. Tyto hlášky opět mohou být i součástí fragmentu s formulářem, který se vygeneruje jakožto předloha.

Bajkvl: /* Knihovny pro vytváření modulů */

2009-09-23T12:16:26Z

Knihovny pro vytváření modulů

Ukázat změny

Bajkvl: /* Povinné soubory veřejné části modulu */

2009-09-23T11:51:26Z

Povinné soubory veřejné části modulu

← Starší verze		Verze z 23. 9. 2009, 13:51
Řádek 942:		Řádek 942:
	=== Povinné soubory veřejné části modulu ===		=== Povinné soubory veřejné části modulu ===

	Obecné konstanty jsou uloženy v souboru ''/includes/constants.php'', veřejné konstanty modulu pak ve ''/scripts/modules/nazev_modulu/_constants.php''. Funkce pro přístup k některým (především novějším) konstantám z ''config/global.php'' jsou uloženy v souboru ''/includes/ConstantsAccess.php''. Tyto funkce existují z toho důvodu, že uživatel nemusí mít vždy nainstalovanou nejnovější verzi konfiguračního souboru, funkce tedy ověřují existenci konstanty a případně vracejí ve funkci pevně nastavenou výchozí hodnotu.~~�Např~~.:		Obecné konstanty jsou uloženy v souboru ''/includes/constants.php'', veřejné konstanty modulu pak ve ''/scripts/modules/nazev_modulu/_constants.php''. Funkce pro přístup k některým (především novějším) konstantám z ''config/global.php'' jsou uloženy v souboru ''/includes/ConstantsAccess.php''. Tyto funkce existují z toho důvodu, že uživatel nemusí mít vždy nainstalovanou nejnovější verzi konfiguračního souboru, funkce tedy ověřují existenci konstanty a případně vracejí ve funkci pevně nastavenou výchozí hodnotu.
			Např.:

	<code>		<code>
Řádek 954:		Řádek 955:
	</code>		</code>

	Lokalizované texty jsou definovány v samostatném souboru zvlášť pro část administrační (jsou využívány v kódech v adresáři /application/) a zvlášť pro veřejnou (jsou využívány v kódech v adresáři /scripts/). Tyto soubory jsou uloženy jako "/rdata/resources/modules/''nazev_modulu''/ (application \| scripts ) /_localization_inc.php".~~�Přístup~~ k těmto konstantám v samotném kódu je řešen pomocí funkce ''loc('nazev_konstanty'''),'' která vrací obsah konstanty. Ta jednak ošetřuje, zda požadovaná konstanta vůbec existuje (pokud ne, nic nezobrazí), jednak převádí vracený text do správné znakové sady podle parametrů nastavených v konfiguračním souboru.		Lokalizované texty jsou definovány v samostatném souboru zvlášť pro část administrační (jsou využívány v kódech v adresáři /application/) a zvlášť pro veřejnou (jsou využívány v kódech v adresáři /scripts/). Tyto soubory jsou uloženy jako "/rdata/resources/modules/''nazev_modulu''/ (application \| scripts ) /_localization_inc.php". Přístup k těmto konstantám v samotném kódu je řešen pomocí funkce ''loc('nazev_konstanty'''),'' která vrací obsah konstanty. Ta jednak ošetřuje, zda požadovaná konstanta vůbec existuje (pokud ne, nic nezobrazí), jednak převádí vracený text do správné znakové sady podle parametrů nastavených v konfiguračním souboru.

	=== Knihovny pro vytváření modulů ===		=== Knihovny pro vytváření modulů ===

Bajkvl: /* Výpis záznamů */

2009-09-23T11:50:25Z

Výpis záznamů

← Starší verze		Verze z 23. 9. 2009, 13:50
Řádek 886:		Řádek 886:

	Vytvoříme objekt tabulky s výpisem		Vytvoříme objekt tabulky s výpisem
			<tt>
	$objTable = new''' HtmlTable'''('''loc'''(''''h_categ_asp_006''''));'''		:$objTable = new''' HtmlTable'''('''loc'''(''''h_categ_asp_006''''));'''
			</tt>
	Nastavíme odkaz na editaci a přidání.		Nastavíme odkaz na editaci a přidání.
			<tt>
			:'''$objTable->'''setEditLink'''(''''edit_c.php?ev=edit&id=%s'''');'''

	~~'''$objTable->'''setEditLink'''(''''edit_c.php?ev=edit&id=%s'''');'''~~		:'''$objTable->'''setAddLink'''(''''edit_c.php?ev=new'''');'''
			</tt>
	'''$objTable->'''setAddLink'''(''''edit_c.php?ev=new'''');'''

	Zažádáme o vytvoření sloupce.		Zažádáme o vytvoření sloupce.
			<tt>
	'''$objTable->'''addColumnSimple'''('''loc'''(''''h_categ_asp_005''''));'''		:'''$objTable->'''addColumnSimple'''('''loc'''(''''h_categ_asp_005''''));'''
			</tt>
	Načteme seznam záznamů z databáze.		Načteme seznam záznamů z databáze.
			<tt>
			:'''$query =''' 'select ID, NAZEV from NEWSKATEG order by NAZEV'''';'''

	~~'''$query =''' 'select ID, NAZEV from NEWSKATEG order by NAZEV'''';'''~~		:'''$qId = $db->'''query'''( $query );'''
			</tt>
	'''$qId = $db->'''query'''( $query );'''

	Projdeme výsledek a naplníme datové pole. Tvar pole předávaného metodě addDataRow() musí být takový, že první sloupec je ID záznamu, které se používá pro odkaz do editačního rámce.		Projdeme výsledek a naplníme datové pole. Tvar pole předávaného metodě addDataRow() musí být takový, že první sloupec je ID záznamu, které se používá pro odkaz do editačního rámce.
			<tt>
			:'''while( $rs = $db->'''fetch_row'''( $qId ))'''

	~~'''while( $rs = $db->'''fetch_row'''( $qId ))'''~~		:'''{'''
			:$objTable->'''addDataRow'''( $rs );'''
	'''{'''
	$objTable->'''addDataRow'''( $rs );~~'''~~

	~~'''}~~'''

			:'''}'''
			</tt>
	Nastavíme, na stránku dat chceme zobrazit.		Nastavíme, na stránku dat chceme zobrazit.
			<tt>
	'''$objTable->'''setPageSelected'''( $f_pg);'''		:'''$objTable->'''setPageSelected'''( $f_pg);'''
			</tt>
	Nastavíme hlášení, které komponenta zobrazí v případě, že nebyla předána žádná data.		Nastavíme hlášení, které komponenta zobrazí v případě, že nebyla předána žádná data.
			<tt>
	'''$objTable->'''setNoResultMsg'''(''' loc'''(''''h_categ_asp_007'''') );'''		:'''$objTable->'''setNoResultMsg'''(''' loc'''(''''h_categ_asp_007'''') );'''
			</tt>
	Vypíšeme výsledný HTML kód.		Vypíšeme výsledný HTML kód.
			<tt>
	'''print $objTable->'''getHtml'''();'''		:'''print $objTable->'''getHtml'''();'''
			</tt>
	[[Image:priruckavyvojare-webtodatemoduly-img013.png\|center]]		[[Image:priruckavyvojare-webtodatemoduly-img013.png\|center]]

Bajkvl: /* Praktický příklad - Formulář pro editaci záznamu */

2009-09-23T11:42:31Z

Praktický příklad - Formulář pro editaci záznamu

Ukázat změny