Commit | Line | Data |
---|---|---|
ca88871f H |
1 | <title>Harvie's JuKe!Box Help</title> |
2 | <pre><h2>Autorská práva</h2> | |
3 | Autorem této aplikace je <~~Harvie (2oo8), který se zříká autorských práv (CopyLefted) a zároveň také zodpovědnosti. | |
4 | Licence pro software z třetí strany (musicplayer,...) najdete v souboru COPYING. | |
5 | Pokud je pomocí tohoto webu zpřístupněn materiál, jehož stažením se vy nebo poskytovatel dopouštíte porušení autorských práv, tento obsah nestahujete! | |
6 | Instalací nebo používáním aplikace potvrzujete, že jste s právy srozuměni a že je akceptujete. V opačném případě aplikaci nepoužívejte ani neinstalujte. | |
7 | ||
8 | <h2>Základy Ovládání</h2> | |
9 | Na úvodní stránce vidíte výpis souborů a adresářů (označeny [DIR]). | |
10 | Kliknutím na jméno souboru zahájíte stahování. | |
11 | Kliknutím na jméno adresáře vstoupíte do adresáře. | |
12 | Pokud zobrazený adresář obsahuje soubor index.html nebo index.txt, bude tento zobrazen nad výpisem. | |
13 | Vedle každého adresáře nebo hudebního souboru najdete písmenka, pomocí kterých můžete spustit příslušnou akci. | |
14 | ||
15 | Tady je krátký přehled významu jednotlivých písmenek: | |
16 | P - Přehrát (je nutné stáhnout playlist.m3u a otevřít v přehrávači hudby - např. Winamp, to se dá po nastavení prohlížeče dělat automaticky...) | |
17 | - U složek tato volba přehraje všechny zvukové soubory, které složka obsahuje | |
18 | R - To samé jako P, ale přehraje se i hudba v podsložkách (POZOR! raději nepoštět na velké adresáře!!!) | |
19 | D - Otevře nadřazenou složku pro daný soubor (pouze u vyhledávání) | |
20 | F - Spustí přehrávání v prohlížeči (vyžaduje flash), otevřete odkaz v novém okně, pokud si chcete dál prohlížet knihovnu... | |
21 | S - Zastaví přehrávání v prohlížeči | |
22 | ||
23 | <h2>Vyhledávání</h2> | |
24 | Před prvním vyhledáváním je potřeba vytvořit cache a nastavit ji práva pr zápis. | |
25 | Potom je soubor s cache třeba obnovovat (na stránce vyhledávání se zadá heslo pro obnovení/vytvoření db a stiskne se "refresh cache"). | |
26 | Na Linuxu se může dát obnovování cache do cronu jako skript používající příkaz find, databáze tak bude udržována stále aktuální. | |
27 | Při vyhledávání je možné použít regulární výrazy (mezery budou nahrazeny řetězcem '(.*)' !!!). | |
28 | Kromě vyhledávání hudby v lokálním archivu skript také umožňuje vyhledávání hudby a textů písní na www. | |
29 | Je limitován počet souborů, u kterých se při vyhledávání zobrazuje velikost. (To by vylučovalo funkci cache - cachovat velikost se mi ale nechce). | |
30 | Kromě vyhledávání lze z databáze také vygenerovat (pseudo)náhodný playlist. | |
31 | ||
32 | <h2>Přihlašování</h2> | |
33 | Pokud je povolen přihašovací modul, budete při prvním otevření stránky vyzváni k zadání příslušných údajů. | |
34 | Odhlášení provedete kliknutím na odkaz "LOGOUT" v horním menu. | |
35 | ||
36 | <h2>Instalace</h2> | |
37 | Instalace se provádí nakopírováním souborů do adresáře přístupného webovému servru, | |
38 | upravením nastavení ve zdrojovém souboru a přihlašovacím modulu (http_auth.php). | |
39 | Pro zakázání přihlašovacího modulu smažte první řádek kódu (obsahuje http_auth.php). | |
40 | a správným nastavením přístupových práv daným souborům. | |
41 | Také doporučuji nastavit php open base dir pro pojisteni pred directory traversingem do nadrazenych adresaru... | |
42 | ||
43 | Přehled vlastností v hlavním souboru: | |
44 | $title = Nadpis stránky | |
45 | $music_dir = Relativní cesta k adresáři s hudbout | |
46 | $music_dir_url = URL pro přístup k hudbě z venku | |
47 | $cache_passwd = Heslo pro obnovení vyhledávací cache | |
48 | $access_limit = Maximální počet souborů zpracovaných bez použití cache (při vyhledávání) | |
49 | $default_random_count = Výchozí počet v náhodném playlistu | |
50 | $sort = Povolit abecedni razeni? 0=ne, 1=jen playlisty, 2=playlisty i listingy, 3=vse i vyhledavani | |
51 | - Razeni je potreba pouzivat s rozvahou s ohledem na zatez CPU a RAM (coz muze byt omezeno nastavenim serveru/php) | |
52 | - Razeni vyhledavaci databaze muze byt narocnejsi zvlaste u rozsahlejsich hudebnich knihoven | |
53 | - V takovem pripade je vhodne ho zakazat, nebo pouzit k razeni shellove skripty | |
54 | ||
55 | $playlist_name = Jméno generovaného playlistu | |
56 | $m3u_exts = Přípony souborů, které se zobrazí v playlistu a ve vyhledávání | |
57 | ||
58 | $indexlist = Pole se jmény souborů, které se mají případně zobrazit před výpisem složky | |
59 | $bonus_dir = Adresář s pomocnými soubory | |
60 | $search_cache = Cesta k vyhledávací cache | |
61 | $flash_player = Cesta k swf souboru webového přehrávače | |
62 | $css_file = Cesta k CSS stylu | |
63 | ||
64 | ||
65 | <h2>Nefunguje</h2> | |
66 | Skript - potřebujete webserver s podporou PHP | |
67 | Vyhledávání - skript nemá práva pro zápis/čtení databáze, nebo databáze ještě nebyla vytvořená... | |
68 | Přehrávání v prohlížeči - není přítomný swf soubor přehrávače, prohlížeč nepodporuje flash, nebo inline framy... | |
69 | Něco jiného - UTFS && UTFG... | |
70 | </pre> |