WebToDate/Utility/Kontrola a přesuny souborů ve zdrojích

Funkcionalita

Tato funkce provádí následující:

• Prochází všechny zdroje a kontroluje, zda soubory vložené do databáze zdrojů na cestách uložených v této databázi na disku serveru existují
• Volitelně přesunuje soubory v adresářích dle aktuálního nastavení složek ve stromu kategorií a odpovídajícím způsobem aktualizuje cesty k souborům ve zdrojích.

Každá kategorie ve stromu kategorií může mít definovaný název složky. Výchozí adresář pro uložení nějakého souboru se odvozuje od zřetězení těchto složek. Jako příklad můžeme uvést definice kategorií v následující tabulce.

Kategorie	Název složky	Soubory se nacházejí ve složce
Dokumenty	dokumenty	/assets/dokumenty/
Dokumenty » Oznámení	oznameni	/assets/dokumenty/oznameni/

Výše uvedené umístění samozřejmě platí v případě, že uživatel vkládající soubory použije výchozí nastavení - vždy lze ručně v příslušném formuláři pro vložení souboru do zdroje cestu k adresáři změnit.

Prefix /assets/ je dán konfigurační konstantou ASSETS_PUBLICFILES resp. ASSETS_PRIVATEFILES.

V případě, že v definici kategorie změníme název složky např. z oznameni na vyhlasky, na již vložené soubory to nemá žádný vliv, WebToDate automaticky nic nepřesouvá a nemění URL. V případě, že chceme po takovéto změně v kategoriích a složkách změnit adekvátně hromadně URL souborů ve zdrojích, je možné použít tuto utilitu.

Spuštění utility

Funkce se spouští na adrese adresa_serveru/adresář_s_redakčním_rozhraním/check_files.php, tedy např. na adrese http://www.mujserver.cz/admin/check_files.php.

Pokud je adresa zadána takto bez dalších parametrů, provede se pouze kontrola existence souborů, tj. porovnání cest k souborům v databázi zdrojů s tím, zda se soubory na těchto cestách skutečně nacházejí.

Podporovaný parametr skriptu je action, který může nabývat hodnot

• check - kromě kontroly existence souborů se vypíší všechny soubory, jejichž cesty by se automaticky změnily při spuštění změn dle aktuálního stavu stromu kategorií; žádné skutečné přesuny souborů se neprovádějí, čili s tímto nastavením skript pouze vypisuje sestavu a nic na webu nemění
• move - kromě kontroly existence souborů se provádí přesuny souborů do adresářů dle aktuální definice stromu kategorií.

Volání skriptu s parametrem je tedy např. http://www.mujserver.cz/admin/check_files.php?action=check.

Obsluha funkce

Po zadání URL skriptu do prohlížeče se proces okamžitě spustí, není vyžadováno žádné potvrzení. V případě spuštění bez parametrů nebo s parametrem action=check skript jen vypisuje zjištěné skutečnosti, s parametrem action=move může dojít k přesunům souborů a aktualizaci databáze zdrojů.

Podle objemu záznamů v databázi zpráv může tato funkce pracovat delší dobu. Před spuštěním zkontrolujte nastavení konfigurační konstanty LONG_TASK_TIMEOUT v konfiguračním souboru global.php, timeout tohoto skriptu se řídí touto konstantou.

Pokud www prezentace obsahuje nějaké statické stránky, na které jsou vloženy odkazy na soubory ze zdrojů a skript byl spuštěn s parametrem action=move, je třeba tyto stránky přegenerovat, jinak takto umístěné odkazy nemusí být platné.