| 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... |