HwGallery - jednoduchá galerie v PHP

HwGallery — jednoduchá galerie v PHP

Základní popis

HwGallery je balík PHP skriptů určený pro provozování jednoduché galerie obrázků. Jeho základními vlastnostmi jsou:

velmi jednoduchá instalace
galerie ke svému chodu nepotřebuje databázi
obrázky je možné rozdělovat do složek (stačí jen vytvořit příslušnou adresářovou strukturu)
v nepovinných pomocných souborech lze zadat název složky, její podrobnější popis a popis jednotlivých obrázků
vzhled galerie lze snadno upravovat pomocí šablon v jazyce HTML
náhledy obrázků jsou generovány automaticky a jsou cacheovány pro omezení zátěže serveru
díky zapoudření do tříd a úpravě vzhledu přes šablony lze galerii snadno včlenit jako modul do existujících stránek
základní šablona je vyladěna pro Internet Explorer, Firefox i Operu.
celý balík je k dispozici zdarma i pro komerční použití

Požadavky

PHP verze 5
adresář s právem zápisu pro PHP skripty

Ukázky

Stáhnutí

Poslední verze 0.85 (česká verze) (ZIP, 20KB).
Poslední verze 0.85 (anglická verze) (ZIP, 20KB).

Instalace

Pro instalaci této webové galerie je nutné provést následující kroky:

Stáhnout poslední verzi HwGallery.
Nahrát přes FTP (nebo jinak) obsah stáhnutého archívu na webový server.
Do připraveného adresáře photos nahrát obrázky (případně organizované pomocí adresářové struktury).

Upozornění: jména adresářů s obrázky mohou obsahovat pouze písmena malé a velké anglické abecedy, čísla a znak pomlčku.
Nastavit připravenému adresáři thumbs práva tak, aby do něj mohly zapisovat PHP skripty. Bližší informace naleznete v sekci Často kladené dotazy.

Popis balíku

Celý balík se skládá z následujících souborů:

[photos] - adresář, do kterého je potřeba umístit obrázky
[skins] - adresář pro šablony
- [default] - základní šablona
  - background.gif, folder.gif, next.gif, parent.gif, prev.gif - pomocné obrázky pro šablonu
  - folder_view.tpl - HTML šablona pro zobrazení obsahu složky
  - image_view.tpl - HTML šablona pro zobrazení obrázku
  - skin.properties - jediný povinný soubor šablony s jejími nastaveními
  - styles.css - pomocný CSS soubor se styly
[thumbs] - adresář, do kterého budou ukládány automaticky generované náhledy
hw_gallery.php - skript s třídou HwGallery, která je využívána pro generování galerie
hw_gallery.properties - hlavní nastavení galerie
hw_ini_file.php - pomocná třída pro načítání souborů s nastaveními
index.php - základní jednoduchý skript pro zobrazování galerie

Licence

Celý balík pro provoz galerie je k dispozici zdarma i pro komerční použití. Jedinou podmínkou je zachování odkazu na tuto stránku a odkazu na celý tento server (viz výchozí šablona).

Verze

0.85 - přidáno zobrazování dat vytvoření složek a obrázků, přidána možnost řadit složky/obrázky podle jména/data vytvoření.
0.84 - přidáno výchozí jméno kořenové složky (adresář photos). V české verzi je to Hlavní složka, v anglické Main folder. Možno změnit v skins/*/skin.properties, položka html_folder_path_default_root_name.
0.83 - opravena chyba v zobrazování adresářové cesty (pokud nebylo definováno jméno složky v __INFO souboru, bylo jméno složky zkráceno o první znak).

Často kladené dotazy

Nastavení práv zápisu pro adresář

Galerie vyžaduje adresář, do kterého může ukládat vygenerované náhledy obrázků. U některých hostingů jsou práva vyřešena tak, že PHP skripty mohou bez problémů do adresářů zapisovat, ale častější je ale zřejmě situace, kdy toto možné není.

V takovém případě jsou práva daného adresáře nejčastěji nastavena tak, že je zápis povolen pouze uživateli. PHP, které pracuje pod jiným uživatelem, zde proto zapisovat nemůže. Pokud běží PHP běží pod uživatelem, který je alespoň ve stejné skupině jako uživatel hostingu, pak stačí povolit právo zápisu skupině (kód 775). Pokud tomu tak není, je nutné nastavit právo zápisu všem (neboli světu, ostatním — kód 777). Než ale budete práva zápisu měnit, zjistěte si (např. pomocí zákaznícké podpory, fóra), zda tím na svém hostingu nevytvoříte bezpečnostní díru!

Práva lze snadno nastavit v FTP klientech. Například v Total Commanderu stačí vybrat příslušný adresář a v menu zvolit Soubor->Změna atributů.

Jak nastavovat jména a popisy složek a jména obrázků.

Standardně jsou obrázky a složky v galerii označeny jmény příslušných souborů a adresářů. Pokud si chcete nadefinovat vlastní názvy, je nutné vytvořit v adresáři (který odpovídá složce ve fotogalerii) pomocný soubor nazvaný __INFO. Jeho syntaxe je následující:


      __NAME=Jméno složky v galerii

      __DESCRIPTION=Podrobnější popis obsahu složky

      jmeno_prvniho_souboru=Jméno příslušného souboru v galerii

      jmeno_dalsiho_souboru=Jméno příslušného souboru v galerii

      ...

Příklad souboru __INFO je umístěn i v ukázkové galerii.

Tomáš Hula