Po řadě připomínek je v současnosti doplněk přepracován a má nový název ShowFolio. Doplněk je ke stažení http://tng.lythgoes.net/wiki/index.php/Showfolio_Modv podobě opravného módu. Instalace je standardní, ve složce mods bude kromě vlastního modu (s možnostmi nastavení) vytvořena podsložka Showfolio.
Nejprve k názvosloví. Nadále budu používat pro metodu autorův termín ShowFolio a pro jednotlivé výtvory český překlad Magazín. Po instalaci tohoto opravného módu už lze začít s tvorbou jednotlivých Magazínů podle dále popsaných pravidel a poznámek.
Co jsou vlastně Magazíny
Magazíny mohou připomínat Publikační centrum v Legacy. Umožňují spojit různé výstupy do jediného balíku a opatřit krásnými deskami a/nebo obsahem.
• v rámci jednoho Magazínu lze shromáždit na jednotlivých listech (stránkách) rozličné formáty: PHP, HTML, HTM, JPG, GIF, PNG a odkazy na PDF
• každý list v Magazínu je představován samostatným souborem, uloženým ve složce pro konkrétní Magazín (viz dále)
• jednotlivé soubory nemusí být samostatně nahrány jako médium, protože jako médium vystupuje v rámci TNG celý Magazín (každý jako jedinečné médium) - to je zásadní rozdíl třeba od Alba v TNG
• Magazínů můžeme, podle dále uvedených pravidel, vytvořit kolik potřebujeme a každý z nich může obsahovat tolik stránek, kolik se nám hodí
• Magazíny podobného zaměření můžeme shlukovat do skupin, a zajistit, aby se vytvořená skupina zobrazovala v rozbalovacím menu Media pod přiděleným názvem
• Po výběru některé skupiny v rozbalovacím menu Media se objeví přehled všech jednotlivých Magazínů, které náleží do vybrané skupiny (anebo jen jediný, je-li to jednočlenná skupina)
• Magazíny s více než jednou stránkou jsou opatřeny v záhlaví aktivními tlačítky s čísly stránek a nadto umožňují zadat přímo číslo stránky, kterou chceme otevřít, v poli Vybrat stranu napravo od číslování stránek.
• jako první stránku lze zařadit úvodní slovo, obsah stránek anebo ozdobný obal ke konkrétnímu Magazínu
• Stránky tvořené obrázkem (JPG, GIF, PNG) mohou mít k dispozici zvětšovací sklo v podobě pohyblivého čtverce pro snazší čtení podrobností na stránce. Velikost lupy lze nastavit
Řídící soubor folio.php
Metoda Showfolio používá soubor folio.php jako řídící soubor. Tento soubor je povinnou součástí každé složky se soubory Magazínu a slouží ke dvěma účelům:
1. soubor folio.php ze složky Magazínu bude "nahrán" jako médium (viz dále) a tím bude TNG znát součástí jednotlivých skupin Magazínů
2. Pokud potřebujeme upravit nastavení konkrétního Magazínu, vepíšeme individuální úpravu sem. Jinak může soubor folio.php zůstat zcela prázdný, anebo obsahovat pouze poznámky a plní pouze účel č. 1.
Kód: Vybrat vše
Kromě výše popsaných dvou základních funkcí se používá analogicky soubor folio.php i v každé složce skupiny Magazínů, aby TNG vědělo, které skupiny a pod jakým názvem se zobrazí v rozbalovacím menu Media.
Kam je dovoleno umístit složky s Magazíny
Podmínkou správné funkce doplňku ShowFolio v TNG je dodržet několik zásad. Pro přehlednější výklad předpokládejme nejprve založení všeho všudy dvou Magazínů a to v jediné skupině, kterou pro rozbalovací menu Media nazvěme Skupina:
1. V rámci instalace TNG založíme novou složku pro skupinu Magazínů, která bude zatím prázdná a kterou si nazveme skupina (název musí být jednoslovný a bez diakritických znamének). NOVOU SLOŽKU skupina SMÍME UMÍSTIT POUZE DO ADRESÁŘE DOCUMENTS ANEBO HISTORIES jako podsložku !
Pokud bychom si složku pro skupinu Magazínů založili kdekoliv jinde, nebude metoda ShowFolio fungovat !!!
2. Ve správně založené složce skupina si založíme tolik podsložek, kolik plánujeme Magazínů, v naší ukázce tedy 2, které pojmenujeme třeba almanach a bichle.
3. Z praktických důvodů je šikovné do složky skupina vložit obrázek, který se objeví vlevo od názvu této skupiny Magazínů v rozbalovacím menu. U něj na formátu nezáleží, ale měl by být malé velikosti.
4. A z podobných důvodů je šikovné do každé z podsložek almanach a bichle vložit obrázek, který se bude objevovat v přehledu jednotlivých Magazínů vlevo od názvu konkrétního Magazínu v rozbalovacím menu. Z čistě praktických důvodů, aby se nezobrazil jako stránka Magazínu, je dobré jej převést např. do formátu ICO.
5. Do jednotlivých složek almanach a bichle vložíme soubory, které se mají zobrazit jako stránky Magazínu. Stránky jsou do Magazínu přidány přidáním dalšího souboru do složky Magazínu a naopak vyjmuty smazáním odpovídajícího souboru.
6. Pořadí zobrazených stránek Magazínu předurčují názvy souborů. Stránky budou zobrazeny v unixové posloupnosti řazení, takže velká písmena se zobrazí před malá písmena a čísla budou považována za alfanumerické znaky. Pochopitelně se vyplatí vyhýbat se českým znakům. Pozor, konečné pořadí se může lišit na webu od pořadí na lokálním serveru.
7. Titulní stránka Magazínu je nepovinná. Soubor nemůže být ve formátu PDF, název musí zajistit první místo v alfanumerickém pořadí.
Přiřazení Magazínu jako média
Každý Magazín představuje v TNG jednu mediální položku, bez ohledu na počet stran. Přiřazení předchází založení nové kolekce s odpovídajícími vlastnostmi viz
Přiřazení k mdiím se provede ve dvou krocích pomocí řídícího souboru folio.php - viz následující 2 obrázky:
a
Nastavení individuálních podmínek pro zvolený Magazín
Obecné parametry zobrazení pro všechny vytvořené magazíny se nastavují v Manažeru módů - pod tlačítkem Možnosti u módu Showfolio. Pokud potřebujeme pro konkrétní Magazín odlišné zobrazení, vložíme do řídícího souboru folio.php odpovídající volby, které mají přednost před obecným nastavením. Při znalosti PHP sem lze zadávat i další zajímavé úpravy.
PDF soubory v Magazínu
PDF soubor, vložený do složky Magazínu si návštěvník může stáhnout stiskem tlačítka s názvem PDF, které se zobrazí nahoře, vpravo od stránkování Magazínu.
Překlady výrazů do češtiny
Autor přišel s geniálním nápadem a jazykové mutace při instalování módu Showfolio nekopíruje do souborů cust_text.php v jednotlivých jazykových složkách, ale do jazykových složek přidává malý soubor folio_text.php. Případné úpravy překladu jsou proto ve všech jazycích velmi snadné.