V článku Instalace DAlbum jsme si do podrobna popsali spuštění této výborné opensource galerie (ukazka). Tento článek Vám pomůže s nastavením klíčových vlastností programu jako jsou velikosti zmenšených obrázků (thumbnailů), počet zobrazovaných obrázků na stránce, způsob autentifikace uživatelů a mnoha dalších. Článek se nezabývá různými rozšířeními, které jsou dostupné na domovské stránce programu ani nastavením vzhledu galerie.

Soubor config.php a jeho struktura

Veškerá nastavení programu, které můžete jako uživatel měnit i bez znalosti jazyka PHP, se provádějí přímou editací souboru config.php v adresáři config. V něm se nacházejí proměnné, které pak ke svému běhu používají skripty programu. Obsah těchto skriptů neměňte, pokud k tomu nemáte zvláštní důvody a zejména pokud netriviálně neovládáte PHP.

Strukturu souboru config.php si můžete prohlédnout na následujícím obrázku. Obsahuje řádky s deklarací proměnných prokládané komentáři. Řádek s proměnnou vždy začíná znakem $ a končí středníkem. Naproti tomu řádky s komentáři začínají dvěma lomítky - ty neodstraňujte, riskovali byste nefunkčnost programu. V komentářích se nachází popis proměnných, případně seznam hodnot, jakých mohou jednotlivé proměnné nabývat.

Nejdůležitější proměnné

Nyní si probereme nejdůležitější proměnné rozdělené do pěti hlavních sekcí, řekneme si, k čemu jsou dobré a jak je správně nastavit. Při editaci měnte pouze hodnoty proměnných, nikoli jejich názvy. Každý řádek s deklarací proměnné je ve tvaru

$název_proměnné=hodnota_proměnné;

Main settings

"$g_bDirectAccess" - pokud zvolíte true, obrázky budou přístupné přímo ve tvaru www.vasestranka.cz/.../obrazek.jpg.

"$g_nFileAccessCheckLevel" - nastavením hodnoty mezi 0,1,2 volíte mezi maximální rychlostí zobrazování (0) a maximální bezpečností (2).

"$g_sCharset" - znaková sada, která bude použita pro zobrazení stránek v prohlížeči, souvisí se zvolením jazyka (viz níže).

"$g_arrLangList" - pole všech dostupných jazyků. Odkomentováním řádku umožníte zobrazení galerie v daném jazyku - to v jakém jazyku se galerie zobrazí, záleží na nastavení prohlížeče. Defaultní jazyk se nachází na prvním řádku.

"$g_sStylesheet" - absolutní cesta k CSS souboru, který se použije pro nastavení vzhledu galerie.

Access control

"$g_bHTTPAuth" - způsob autentifikace uživatelů galerie, při nastavení false (defaultně) bude použita přihlašovací stránka programu, při true bude autentifikace ponechána Apache serveru (v tom případě je třeba nastavit také hodnoty proměnných $g_sPrivateDir, $g_sSiteRootDir a $g_sAuthName)

"$g_sAdminUsers" - seznam uživatelů s administrátorskými oprávněními oddělených čárkou (jen ti mohou spouštět reindexaci a měnit definici alb)

Thumbnails and resized images generation

"$g_sThumbnailXSize" - šířka thumbnailu

"$g_sThumbnailYSize" - výška thumbnailu

"$g_sThumbnailQuality" - JPEG kvalita thumbnailu

Podobné nastavení je dostupné pro zmenšené obrázky (resized images) zobrazované stránkou showimg.php. Při vytváření zmenšenin je zachován poměr šířky a výšky obrázku - pro určení velikosti se použije relativně menší z nastavených rozměrů.

"$g_newDirRights" - nastavení přistupových práv při vytváření zmenšenin, defaultní hodnotu 0755 byste neměli snižovat, jinak riskujete nefunkčnost aplikace.

Následují řádky s možností zapnutí FTP funkcí při uploadu souborů. Ty se uplatní na serveru se zapnutou direktivou Safe Mode, probírají se už ve článku Instalace DAlbum a nebudu se k nim tedy vracet.

Index page settings

"$g_nPicturesPerPage" - nastavení počtu thumbnailů na stránku

"$g_nColumnsPerPage" - v kolika sloupcích mají být thumbnaily zobrazeny

Show image page

"$g_bShowOriginalImageButton" - zobrazení tlačítka na zobrazení/stáhnutí obrázku v originální velikosti - tlačítko můžete skrýt (0), zobrazit ve formě odkazu na novou stránku s obrázkem (1) nebo odkazu na obrázek ke stažení (2)

"$g_sBrowserFitMethod" - nastavení velikosti zobrazeného obrázku vzhledem k velikosti okna prohlížeče, defaultně nastaveno na noresize.