Commit | Line | Data |
---|---|---|
2dce2790 TM |
1 | #summary About/Help; O aplikaci & Jak používat JuKe!Box? |
2 | <wiki:toc /> | |
3 | ||
4 | = English = | |
5 | == Copyright == | |
6 | You can find license document on the page called [License]. | |
7 | ||
8 | == Not jet! == | |
9 | ||
10 | = Česky = | |
11 | == Autorská práva == | |
12 | Licenční ustanovení týkající se tohoto programu naleznete na stránce [License]. | |
13 | ||
14 | Pokud je pomocí tohoto webu (myšleno aplikace jukebox) 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! | |
15 | 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. | |
16 | ||
17 | == Základy Ovládání == | |
18 | Na úvodní stránce vidíte výpis souborů a adresářů (označeny "DIR"). | |
19 | Kliknutím na jméno souboru zahájíte stahování. | |
20 | Kliknutím na jméno adresáře vstoupíte do adresáře. | |
21 | Pokud zobrazený adresář obsahuje soubor index.html nebo index.txt, bude tento zobrazen nad výpisem. | |
22 | Vedle každého adresáře nebo hudebního souboru najdete písmenka, pomocí kterých můžete spustit příslušnou akci. | |
23 | ||
24 | ||
25 | === Tady je krátký přehled významu jednotlivých písmenek === | |
26 | {{{ | |
27 | 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...) | |
28 | - U složek tato volba přehraje všechny zvukové soubory, které složka obsahuje | |
29 | 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!!!) | |
30 | D - Otevře nadřazenou složku pro daný soubor (pouze u vyhledávání) | |
31 | 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... | |
32 | S - Zastaví přehrávání v prohlížeči | |
33 | }}} | |
34 | == Vyhledávání == | |
35 | ||
36 | Před prvním vyhledáváním je potřeba vytvořit cache a nastavit ji práva pr zápis. | |
37 | 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"). | |
38 | 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í. | |
39 | Při vyhledávání je možné použít regulární výrazy (mezery budou nahrazeny řetězcem {{{'(.*)'}}} !!!). | |
40 | Kromě vyhledávání hudby v lokálním archivu skript také umožňuje vyhledávání hudby a textů písní na www. | |
41 | 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). | |
42 | Kromě vyhledávání lze z databáze také vygenerovat (pseudo)náhodný playlist. | |
43 | ||
44 | == Nastavení automatického přehrávání v oblíbeném přehrávači == | |
45 | http://img181.imageshack.us/img181/9925/autoplayzo6.png | |
46 | ||
47 | == Přihlašování == | |
48 | ||
49 | 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ů. | |
50 | Odhlášení provedete kliknutím na odkaz "LOGOUT" v horním menu. | |
51 | ||
52 | == Instalace == | |
53 | ||
54 | Instalace se provádí nakopírováním souborů do adresáře přístupného webovému servru, | |
55 | upravením nastavení ve zdrojovém souboru a přihlašovacím modulu (http_auth.php). | |
56 | Pro zakázání přihlašovacího modulu smažte první řádek kódu (obsahuje http_auth.php). | |
57 | a správným nastavením přístupových práv daným souborům. | |
58 | Také doporučuji nastavit php open base dir pro pojisteni pred directory traversingem do nadrazenych adresaru... | |
59 | ||
60 | === Přehled vlastností v hlavním souboru === | |
61 | {{{ | |
62 | $title = Nadpis stránky | |
63 | $music_dir = Relativní cesta k adresáři s hudbout | |
64 | $music_dir_url = URL pro přístup k hudbě z venku | |
65 | $cache_passwd = Heslo pro obnovení vyhledávací cache | |
66 | $access_limit = Maximální počet souborů zpracovaných bez použití cache (při vyhledávání) | |
67 | $default_random_count = Výchozí počet v náhodném playlistu | |
68 | $sort = Povolit abecedni razeni? 0=ne, 1=jen playlisty, 2=playlisty i listingy, 3=vse i vyhledavani | |
69 | - Razeni je potreba pouzivat s rozvahou s ohledem na zatez CPU a RAM (coz muze byt omezeno nastavenim serveru/php) | |
70 | - Razeni vyhledavaci databaze muze byt narocnejsi zvlaste u rozsahlejsich hudebnich knihoven | |
71 | - V takovem pripade je vhodne ho zakazat, nebo pouzit k razeni shellove skripty | |
72 | ||
73 | $playlist_name = Jméno generovaného playlistu | |
74 | $m3u_exts = Přípony souborů, které se zobrazí v playlistu a ve vyhledávání | |
75 | ||
76 | $indexlist = Pole se jmény souborů, které se mají případně zobrazit před výpisem složky | |
77 | $bonus_dir = Adresář s pomocnými soubory | |
78 | $search_cache = Cesta k vyhledávací cache | |
79 | $flash_player = Cesta k swf souboru webového přehrávače | |
80 | $css_file = Cesta k CSS stylu | |
81 | }}} | |
82 | ||
83 | == Něco nefunguje == | |
84 | ||
85 | * Skript - potřebujete webserver s podporou PHP | |
86 | * Vyhledávání - skript nemá práva pro zápis/čtení databáze, nebo databáze ještě nebyla vytvořená... | |
87 | * Přehrávání v prohlížeči - není přítomný swf soubor přehrávače, prohlížeč nepodporuje flash, nebo inline framy... | |
88 | * Něco jiného - RTFM && UTFS && UTFG... |