Děkujeme, že jste si stáhli software phpBB. Tento dokument vás seznámí se základy jeho instalace a provozu. Tento soubor i ostatní doprovodnou dokumentaci si prosím přečtěte v celém rozsahu před tím, než budete pokračovat v instalaci.

Readme


1. Instalace phpBB

Instrukce týkající se instalace, aktualizace a převodu naleznete v dokumentu INSTALL v tomto adresáři. Hodláte-li provést převod phpBB z verze 2.0.x nebo 3.0.x, vřele vám doporučujeme, abyste si nejdříve zazálohovali všechna data!

Uživatelé betaverzí phpBB 3.0, 3.1 a 3.2 nemohou provést přímou aktualizaci.

Mějte prosím na paměti, že následující druhy instalací nepodporujeme:

  • Aktualizace z betaverzí phpBB a verzí nižších než betaverze na Release Candidate verze phpBB a vyšší verze.
  • Převody z phpBB 2.0.x na betaverze phpBB 3.0, 3.1 nebo 3.2.
  • Instalace betaverzí 3.0, 3.1 nebo 3.2.

Podporu poskytujeme pro následující druhy instalací:

  • Aktualizace z phpBB 3.0 RC1, 3.1 RC1 a 3.2 RC1 na nejnovější verzi.
  • Poznámka: Při použití balíku pro automatickou aktualizaci jsou aktualizace podporovány od phpBB 3.0.2 výše. Chcete-li zaktualizovat verzi starší než 3.0.2, zaktualizujte ji nejprve na verzi 3.0.2 a teprve poté ji zaktualizujte na nejnovější verzi.
  • Převody z phpBB 2.0.x na nejnovější verzi.
  • Nové instalace phpBB 3.1.x – pouze nejnovější vydaná verze.
  • Nové instalace phpBB 3.2.x – pouze nejnovější vydaná verze.

2. Provozování phpBB

Poté, co phpBB nainstalujete, můžete ho snadno spravovat pomocí administrace fóra a moderátorského panelu. Potřebujete-li s phpBB pomoct nebo poradit, nahlédněte prosím do části 3 níže.

2.i. Jazyky (Internacionalizace – i18n)

K dispozici je řada jazykových balíků obsahujících i lokalizaci výchozího vzhledu. Naleznete je na stránce Language Packs v naší sekci pro stahování souborů nebo v části Language Packs naší databáze úprav.

Další informace o jazykových balících naleznete na stránce: https://www.phpbb.com/languages/

Tam naleznete všechny oficiálně podporované jazykové balíky. Pokud si balík stáhnete z jiných stránek, mějte na paměti, že vám k němu nebudeme schopní poskytnout podporu. Stáhnete-li si jazykový balík odjinud, nežádejte nás prosím v případě potíží o pomoc.

Instalace těchto balíků je snadná: Jednoduše si stáhněte požadovaný jazykový balík, dekomprimujte (rozbalte) ho a pomocí klienta FTP přeneste obsažené adresáře docs, language a styles do kořenového adresáře vaší instalace phpBB. Jazyk poté můžete nainstalovat v administraci fóra: záložka Přizpůsobení -> Správa jazyků -> Jazykové balíky. Podrobnější popis tohoto postupu naleznete v naší znalostní bázi, v článku How to Install a Language Pack (v angličtině).

Není-li váš jazyk k dispozici, navštivte prosím naše fórum [3.2.x] Translations, ve kterém naleznete témata věnující se chystaným překladům. Pokud byste nám chtěli nabídnout, že fórum přeložíte do jazyka, který momentálně není k dispozici, nebo že pomůžete s udržováním již existujícího jazykového balíku, můžete zažádat o funkci překladatele.

2.ii. Vzhledy

Třebaže jsme na výchozí vzhledy poměrně hrdí, uvědomujeme si, že se nemusejí zamlouvat každému. Proto phpBB umožňuje vzhledy relativně snadno přepínat. Nejprve musíte nalézt a stáhnout vzhled, který se vám líbí. Jejich seznam naleznete v části Styles naší databáze úprav.

Další informace o vzhledech naleznete na stránce: https://www.phpbb.com/styles/

Mějte prosím na paměti, že vzhledy třetích stran stažené pro phpBB2 nebudou v phpBB3 fungovat. Rovněž je důležité zkontrolovat, zda byl vámi zvolený vzhled zaktualizován tak, aby vyhovoval té verzi softwaru phpBB, kterou používáte.

Poté, co vzhled stáhnete, bývá obvykle dalším krokem rozbalení staženého archivu (nebo nahrání jeho vybaleného obsahu) do adresáře styles/ ve vaší instalaci phpBB. Následně musíte navštívit administraci fóra a v ní zvolit záložku Přizpůsobení -> Správa vzhledů -> Nainstalovat vzhledy, kde by se měl nový vzhled zobrazit. Jeho instalaci provedete kliknutím na odkaz „Nainstalovat vzhled“.

Mějte prosím na paměti, že v zájmu zvýšení efektivity si software ukládá určitá data do mezipaměti. Proto pokud vytváříte svůj vlastní vzhled nebo upravujete vzhledy existující, nezapomeňte pokaždé pročistit mezipaměť fóra kliknutím na tlačítko Spustit nyní vedle možnosti Pročistit mezipaměť na úvodní stránce administrace fóra. Stránku, kterou jste změnili, budete možná muset znovu načíst i ve svém webovém prohlížeči, abyste nahradili její verzi uloženou v jeho mezipaměti. Dokud mezipaměť nepročistíte, provedené změny se neprojeví.

2.iii. Rozšíření

Jsme hrdí na to, kolik rozšíření naše komunita vytváří. Tato rozšíření třetích stran pro výchozí verzi softwaru phpBB dále zvyšují jeho schopnosti. Mnoho z těchto rozšíření naleznete v části Extensions naší databáze úprav.

Další informace o rozšířeních naleznete na stránce: https://www.phpbb.com/extensions/

Mějte prosím na paměti, že chyby a další potíže vyskytnuvší se poté, co nainstalujete nějaké rozšíření, byste NEMĚLI hlásit v systému pro sledování chyb (viz níže). Nejprve rozšíření zakažte a zjistěte, zda se tím problém nevyřešil. O podporu týkající se rozšíření byste měli žádat pouze ve fóru „Discussion/Support“ u příslušného rozšíření.

Také mějte na paměti, že rozšíření zasahující nějakým způsobem do databáze mohou ztížit budoucí aktualizace vašeho fóra.


3. Jak získat pomoc s phpBB

phpBB se občas může novým uživatelům jevit jako příliš složité, obzvláště pokud jde o systém oprávnění. V případě potřeby byste proto ze všeho nejdřív měli nahlédnout do souboru FAQ, v němž naleznete odpovědi na některé základní otázky. Budete-li potřebovat pomoct i poté, máte hned několik možností.

3.i. Dokumentace k phpBB

Obsáhlá dokumentace je nyní k dispozici na webových stránkách phpBB:

https://www.phpbb.com/support/docs/en/3.2/ug/

V ní naleznete vše od instalace přes nastavování oprávnění až po správu uživatelů.

3.ii. Znalostní báze

Znalostní báze obsahuje množství podrobných článků pojednávajících o některých běžných potížích, s nimiž se uživatelé phpBB mohou při používání tohoto softwaru setkat. Znalostní bázi naleznete na adrese:

https://www.phpbb.com/kb/

3.iii. Komunitní fóra

Kolem projektu phpBB se utvořila početná komunita, z níž se řada členů velkoryse rozhodla věnovat svůj volný čas pomoci ostatním uživatelům. Místo, kde se tato komunita sdružuje, naleznete na adrese:

https://www.phpbb.com/community/

Budete-li hledat pomoc na našich fórech, nezapomeňte prosím před odesláním dotazu fóra prohledat. Pokud se s totožným problémem již setkal někdo jiný, pak možná zjistíte, že vaše otázka už byla zodpovězena. Mějte prosím na paměti, že o phpBB pečují výhradně dobrovolníci a že za čas, který tomuto projektu věnují, nedostávají žádnou odměnu, a to včetně moderátorů a vývojářů. Jestliže budete muset na odpověď chvíli počkat nebo se vám hned nedostane takové pomoci, jakou byste si představovali, pamatujte na to prosím.

3.iv Internet Relay Chat (IRC)

Dalším místem, kam se můžete obrátit pro pomoc, je náš kanál IRC. Ten funguje na IRC síti Freenode (chat.freenode.net) a nese název #phpbb. Připojíte se k němu z každého slušného klienta IRC, jako je například mIRC nebo XChat. Ani tuto službu prosím nezneužívejte a respektujte ostatní uživatele.

K dispozici jsou i další kanály IRC, jejich úplný seznam naleznete na adrese https://www.phpbb.com/support/irc/.


4. Status této verze

Toto je stabilní verze phpBB. V řadě 3.2.x nepřidáváme žádné nové funkce, jednotlivé aktualizace slouží hlavně k opravě nalezených chyb a bezpečnostních problémů. K úpravě funkcí a přidávání méně důležitých funkcí může docházet pouze v případě naprosté nutnosti. Další hlavní verzí bude phpBB 3.3, které je momentálně ve vývoji. Neptejte se prosím, kdy verze 3.3 vyjde, protože datum jejího vydání nebylo dosud stanoveno.

Ti, které vývoj phpBB zajímá, by měli sledovat vývojářská fóra, kde uvidí, jak práce postupují:

http://area51.phpbb.com/phpBB/

Mějte prosím na paměti, že na vývojářských fórech byste NEMĚLI žádat o pomoc s phpBB, k tomu jsou určena komunitní fóra.


5. Nahlašování chyb

Vývojáři phpBB používají k zanášení, evidenci a správě všech nahlášených chyb systém pro sledování chyb, na nějž naleznete odkaz níže. Nalezené chyby prosím NEHLASTE na komunitních fórech. Zároveň také prosím NEPOUŽÍVEJTE systém pro sledování chyb k žádostem o pomoc. Pokud v něm o něco takového požádáte, pouze vás odkážeme na fóra podpory (což nás i tak připraví o čas, který bychom jinak mohli věnovat odstraňování skutečných chyb).

http://tracker.phpbb.com/browse/PHPBB3/

Ačkoliv si velmi ceníme každého hlášení o nalezené chybě (čím víc hlášení, tím stabilnější phpBB bude), prosíme vás, abyste před tím, než přidáte nový záznam, provedli několik kroků:

  • Nejprve zjistěte, zda lze vámi nalezenou chybu reprodukovat. Jak to zjistit, závisí na dané chybě. Pouze lze-li chybu reprodukovat, je pravděpodobné, že se jedná o problém s phpBB (nebo s ním nějak související). Pokud něco nelze reprodukovat, může se ukázat, že to jenom poskytovatel vašeho hostingu na něčem pracoval, že nastal problém mezi židlí a počítačem atd. Hlášení o chybách, které nelze reprodukovat, mohou zpomalit naši snahu o nápravu skutečných, reprodukovatelných problémů.

  • Dále prosím projděte nebo prohledejte existující hlášení o chybách, abyste zjistili, zda vámi nalezená chyba (nebo nějaká jí velmi podobná) už nebyla nahlášena. Pokud ano, doplňte prosím informace k již existujícímu hlášení a nevytvářejte nový, duplicitní záznam (protože to nás jenom zpomalí).

  • Zkontrolujte komunitní fóra (použijte vyhledávání!) a zjistěte, jestli ostatní už neprobírali něco připomínající to, s čím jste se setkali. Nicméně, jak už bylo uvedeno výše, vámi nalezenou chybu prosím NEHLASTE na fórech, ledaže by ji nebylo možné reprodukovat nebo jste si byli jistí, že souvisí s něčím, co jste udělali, a ne přímo s phpBB.

  • Pokud žádná taková chyba nebyla dosud nahlášena, neváhejte a nahlaste ji.

Budete-li přidávat hlášení o nové chybě (tj. takové, která se dosud nenachází v systému pro sledování chyb), nezapomeňte se nejprve přihlásit (vaše uživatelské jméno a heslo jsou stejné jako na komunitních fórech) a poskytněte prosím i následující informace:

  • Druh/verze vašeho serveru, např. Apache 2.2.3, IIS 7, Sambar atd.
  • Verze PHP a provozní režim, např. PHP 5.4.0 jako modul, PHP 5.4.0 běžící jako CGI atd.
  • Druh/verze databáze, např. MySQL 5.0.77, PostgreSQL 9.0.6, MSSQL Server 2000 (přes ODBC) atd.

Informace o druhu a verzi vaší databáze se zobrazuje v administraci fóra.

Ve svém hlášení prosím uveďte co nejvíce podrobností a, je-li to možné, přidejte kroky nezbytné k reprodukci problému. Pokud máte záplatu, která problém řeší, připojte ji prosím k hlášení nebo podejte žádost o začlenění vašich změn do našeho repozitáře na GitHubu.

Vytváříte-li záplatu, velmi bychom ocenili (avšak nevyžadujeme to), kdybyste mohli dodržet pravidla pro formátování kódu phpBB. Mějte prosím na paměti, že tato pravidla se mezi různými verzemi phpBB trochu liší. Pravidla pro formátování kódu phpBB 3.2.x naleznete na adrese: http://area51.phpbb.com/docs/32x/coding-guidelines.html.

Poté, co do systému vložíte hlášení o chybě, budete e-mailem dostávat všechny k němu následně přidané komentáře. Budete-li požádáni o doplnění dalších informací, učiňte tak prosím! Je frustrující, když nám přijde hlášení o chybě, my požádáme o další informace, ale ty už nedostaneme. V takovém případě pak příslušné hlášení v souladu s našimi zásadami uzavřeme, kvůli čemuž však může v softwaru zůstat zavážný problém. Pochopitelně bychom byli raději, kdyby k něčemu takovému nedocházelo.

5.i. Chyby související se zabezpečením

Pokud v phpBB naleznete potenciální zranitelnost související se zabezpečením, NEHLASTE ji prosím v systému pro sledování chyb, na komunitních fórech atd.! Kdybyste tak učinili, dali byste bezohledným uživatelům příležitost zneužít této zranitelnosti dřív, než ji stačíme odstranit. Všechny takovéto chyby byste měli hlásit v našem systému pro hlídání zabezpečení:

https://www.phpbb.com/security/


6. Seznam momentálně známých chyb

Tento seznam není úplný, obsahuje nicméně ty chyby, které by se mohly vyskytnout u většího počtu uživatelů. Ostatní nahlášené chyby se obvykle projevují pouze při určitých konkrétních nastaveních nebo způsobech instalace, aktualizace a převodu.

  • V případě velkých fór se u některých poskytovatelů hostingu nemusí zdařit převod.
  • V případě velkých aktualizací se u některých poskytovatelů hostingu nemusí aktualizace povést.
  • Smajlíci nacházející se hned za značkami BBCodu nejsou zpracováváni. Smajlíky je vždy nutné oddělovat mezerami.

7. Potíže s kompatibilitou s PHP

phpBB 3.2.x využívá nových funkcí přidaných v PHP 5.4. Doporučujeme vám, abyste před instalací phpBB přešli na nejnovější stabilní verzi PHP. Minimální požadovanou verzí je PHP 5.4.7 a nejvyšší podporovanou verzí je nejnovější stabilní verze PHP.

Mějte prosím na paměti, že provozování jakékoliv aplikace na vývojové verzi PHP (např. na nestabilní betaverzi) může vést k podivným/neočekávaným výsledkům, které se mohou jevit jako chyby v příslušné aplikaci. Proto vám doporučujeme, abyste před instalací phpBB přešli na nejnovější stabilní verzi PHP. Pokud používáte vývojovou verzi PHP, ověřte prosím každou nalezenou chybu před jejím nahlášením v systému používajícím stabilní verzi PHP.

Toto fórum bylo vyvinuto a testováno (nejenom) v systémech Linux a Windows využívajících Apache s MySQL 3.23, 4.x, 5.x, MariaDB 5.x, PostgreSQL 8.x, Oracle 8 a SQLite 3. Verze PHP používané bez jakýchkoliv problémů sahají od 5.4.7 přes 5.6.x až po 7.1.x a 7.2.x.

7.i. Poznámka k bezpečnostním problémům PHP

Momentálně nejsou známy žádné problémy související se zabezpečením PHP.


8. Autorská práva a zřeknutí se odpovědnosti

phpBB je svobodný software vydaný v souladu s podmínkami Obecné veřejné licence GNU verze 2 (GPL-2.0). Copyright © phpBB Limited. Úplné informace o autorských právech a licenci naleznete v souboru docs/CREDITS.txt.