Wdir_XH umožňuje zobrazovanie obsahu adresárov na Vašej webstránke, takže umožňuje aj nastavenie rôznych zoznamov na sžahopvanie súborov.
Wdir_XH možno považovať za nástupcu obľúbeného pluginu Wdir, ktorý sa už dávnejšie nevyvíja. Škoda, že livencia, pod ktorou bol dostupný, neumožňuje modifikácie. Preto bol Wdir_XH od zájkladu prepísaný.
Prv, než sa vystavíte nejakým problémom, prečítajte si tento manuál!
Wdir_XH zatiaľ nebol testovaný v rôznych prostrediach. Je to tzv. beta verzia. Používajte uvážlivo!
Wdir_XH je plugin pre CMSimple_XH. Vyžaduje CMSimple_XH ≥ 1.6 a PHP ≥ 5.2.0.
Inštalácia prebieha rovnako ako pri väčšine pluginov pre CMSimple_XH. Podrbonosti nájdete na CMSimple_XH wiki.
Konfigurácia pluginu sa vykonáva - rovnako ako pri väčšine pluginov pre CMSimple_XH - v správcovskom prostredí. Prihláste sa ako správca stránky a zvoľte "Wdir" v zozname "Plugins".
You can change the default settings of Wdir_XH under "Config". Hints for the options will be displayed when hovering over the help icon with your mouse.
Jazykový súbor (ak nie je k dispozícii v inštalačnom balíku) vytvoríte aktualizáciou údajov v "Language". Tu môžete jednoducho preložiť textové reťazce do Vášho jazyka alebo ich upraviť podľa vašich potrieb.
The look of Wdir_XH can be customized under "Stylesheet".
Východiskovým adresárom pre Wdir_XH je adresár /userfiles.
Pre zobrazenie obsahu adresára na stránke použite:
{{{PLUGIN:wdir('PATH');}}}
kde PATH je názov podadresára v adresári /userfiles. TEda ak chcete zobraziť obsah adresára userfiles/downloads/, použijete:
{{{PLUGIN:wdir('downloads');}}}
Ak chcete zobraziť celý obsah adresára /userfiles, použite:
{{{PLUGIN:wdir('');}}}
Názvy súborov v zoznamoch sú formátované ako odkazy na tieto súbory, takže užívatelia k nim majú prástup v závislosti od nastavenia ich serverov (niektoré sa dajú priamo zobraziť v prehliadači, iné prostredníctvom ich lokálnych programov, alebo sa dajú stiahnuť a uložiť.
Wdir_XH nezobrazuje žiadne podadresáre adresárov udaných ako argument funkcie Wdir, takže návštevníci k podadresárom nemajú prístup. Ak chcete návštevníkom umožniť prístup aj k podadresárom, musíte na stránke použiť pre každý z nich samostatný príkaz wdir().
Vo funkcii wdir() môžete použiť premenné na filtrovanie súborov vo vytvorených zoznamoch. Do zoznamov sa tak zaradia iba súbory, ktoré vyhovujú nastavenému filtru.
Štandardne sa filtre nastavujú ako jednoduché masky, kde hviezdička (*) nahradzuje akýkoľvek textový reťazec a otáznik (?) jedno písmeno/znak.
Ak chcete zobraziť napr. iba PDF súbory obsuahnuté v /userfiles, použite:
{{{PLUGIN:wdir('', '*.pdf');}}}
Ak chcete zobraziť všetky súbory v /userfiles, ktoré začínajú s "Zmluva_", použite:
{{{PLUGIN:wdir('', 'Zmluva_*');}}}
Precíznejšie filtrovanie môžete docieliť, ak povolíte použitie Filter → Regexp v nastavení pluginu. V takom prípade bude druhá premenná vo wdir() považovaná za štandardný výraz PERL. Tento mód je však určený iba pre skúsených správcov stránok, ktorí ovládajú potrebnú syntax. Viac v PHP manual.
Wdir_XH zatiaľ neposkytruje všetky funkcie, ktoré poskytuje Wdir 03beta. Niektoré z nich možno nebudú uvedené ani v budúcnosti (napr. zobrazovanie vlastníka súboru, oprávnení a i.).
V niektorých prostrediach (napr. Windows s podporou PHP < 5.3) nemusia fungovať jednoduché masky (*.*). V takom prípade musíte povoliť štandardné výrazy, alebo zvážte použitie samostatných funkcií s roznymi parametrami.
Wdir_XH is licensed under GPLv3.
© 2012-2015 Christoph M. Becker
Slovak translation © 2015 Dr. Martin Sereday
Russian translation © 2015 Васильев Леонид Валерьевич
Ikona pluginu je od Alexander Moore. Ďakujem za jej poskytnutie pod GPL.
Ikony súborov sú od 19eighty7. Ďakujem za ich poskytnutie pod liberálnou licenciou.
The sort icons are taken from MediaWiki. Many thanks for publishing these icons.
A na koniec poďakovanie Petrovi Hartegovi, "otcovi" CMSimple aa všetkým vývojárom CMSimple_XH bez ktorých by tento úžasný CMS neexistoval.