Instrukcje instalacji, aktualizacji i konwersji znajdują się w artykule INSTALL znajdującym się w katalogu docs/. Jeśli masz zamiar dokonać konwersji z phpBB 2.0.x lub 3.0.x, przed przystąpieniem do konwersji zalecamy wykonanie kopii zapasowej wszelkich istniejących danych!

Nie można bezpośrednio zaktualizować wersji phpBB 3.0 i 3.1 Beta.

Nie są już wspierane następujące typy instalacji:

• aktualizacje z wersji phpBB 3.0 Beta do phpBB 3.0 RC1 i nowszych,
• aktualizacje z wersji 3.1 Beta do phpBB 3.1 RC1 i nowszych,
• konwersje z wersji phpBB 2.0.x do wersji phpBB 3.0 lub 3.1 Beta,
• instalacje phpBB 3.0 lub 3.1 Beta.

Dostarczamy wsparcie dla następujących typów instalacji:

• aktualizacje z wersji phpBB 3.0 i 3.1 RC1 do najnowszej wersji,
• Informacja. Pakiety automatycznej aktualizacji można używać począwszy od wersji phpBB 3.0.2. Aby używać tych pakietów, należy najpierw wykonać aktualizację do wersji 3.0.2.
• konwersje z wersji phpBB 2.0.x do najnowszej wersji,
• nowe instalacje phpBB 3.0.x – tylko najnowsza wersja,
• nowe instalacje phpBB 3.1.x – tylko najnowsza wersja

Po zainstalowaniu można łatwo zarządzać witryną phpBB z poziomu panelu administracji lub moderacji. Jeśli potrzebujesz pomocy lub porady dotyczącej phpBB, znajdziesz ją w sekcji trzeciej.

2.1. Lokalizacja (l10n)

Jest dostępnych wiele wersji językowych i elementów stylów związanych z daną wersją. Wykaz dostępnych wersji językowych znajduje się na stronach: Language Packs w sekcji pobierania lub w sekcji Language Packs w Customisation Database.

Więcej informacji na temat pakietów językowych znajduje się na stronie: https://www.phpbb.com/languages/

To jest miejsce wszystkich wspieranych, oficjalnych pakietów językowych. Jeśli pobierzesz pakiet językowy z innych źródeł, w razie potrzeby musisz zwracać się o pomoc do miejsca, z którego został on pobrany. W takich przypadkach phpBB nie świadczy pomocy!

Instalacja pakietów językowych jest łatwa. Należy pobrać pakiet, rozpakować go i przesłać na serwer do folderu language/ i folderów styles, zwracając uwagę na zachowanie struktury katalogu. Po przesłaniu na serwer, należy przejść na kartę Panel administracji » Dostosowywanie » Zarządzanie pakietami językowymi » Pakiety językowe i zainstalować nowy pakiet językowy. Szczegółowy opis procesu znajduje się w bazie wiedzy w artykule: How to Install a Language Pack.

Jeśli nie ma pakietu językowego dla twojego języka, przejdź na nasze forum [3.0.x] Translations, gdzie znajdziesz temat, w którym jest wykaz aktualnie dostępnych tłumaczeń, jak i tłumaczeń w trakcie realizacji. W tym temacie znajduje się również informacja, jak zostać tłumaczem niedostępnej obecnie wersji językowej.

2.2. Style

Mimo że dołączone style nam się podobają, zdajemy sobie sprawę, że nie wszystkich one zadowalają i dlatego w phpBB umożliwiono względnie łatwą zmianę stylów. Aby móc zmieniać style, najpierw trzeba znaleźć, pobrać i zainstalować styl. Aby ułatwić wybór i pobieranie stylów przejdź na witrynę: Customisation Database do sekcji Styles.

Więcej informacji na temat stylów znajduje się na stronie: https://www.phpbb.com/styles/

Musisz wiedzieć, że style innych twórców pobrane dla wersji phpBB2 nie będą działały w phpBB3. Ważne jest także, aby zainstalowane style były zgodne z zainstalowaną wersją phpBB.

Po pobraniu pakietu stylu trzeba go rozpakować i przesłać na serwer do katalogu styles/, a następnie przejść na kartę Panel administracji » Dostosowywanie » Zarządzanie stylami » Instaluj style, gdzie nowy styl powinien być widoczny. W otwartej karcie należy kliknąć odnośnik „Instaluj”, by zainstalować styl.

Należy pamiętać, że niektóre dane są buforowane i jeśli tworzy się lub modyfikuje istniejący styl, trzeba pamiętać, aby wyczyścić bufor witryny. W tym celu, należy przejść do sekekcji Panel administracji » Ogólne » Synchronizacja i resetowanie statystyk i nacisnąć przycisk Uruchom znajdujący się obok elementu Wyczyść bufor. Aby zmiany były widoczne, należy także odświeżyć stronę. Jeśli te czynności nie zostaną wykonane, dokonane zmiany nie będą widoczne.

2.3. Rozszerzenia

Jesteśmy dumni, że mamy wspaniale działającą społeczność tworzącą rozszerzenia. Rozszerzenia tworzone przez zewnętrznych programistów rozszerzają możliwości standardowego skryptu. Można je znaleźć w sekcji: Rozszerzenia znajdującej się w naszej bazie Customisation Database.

Więcej informacji na temat rozszerzeń znajduje się na stronie: https://www.phpbb.com/extensions

Jeśli po dodaniu rozszerzenia będą występowały błędy i problemy, nie należy zgłaszać ich w naszym systemie śledzenia błędów. Najpierw należy wyłączyć rozszerzenie i sprawdzić czy problem został rozwiązany. Pomoc dotyczącą rozszerzeń znajdziesz na forum dotyczącym tego rozszerzenia.

Należy pamiętać, że rozszerzenia zmieniające bazę danych mogą w przyszłości utrudniać aktualizację witryny.

Dla nowych użytkowników phpBB w niektórych miejscach może wydawać się nieco trudne – zwłaszcza system uprawnień. Pierwszą rzeczą, którą należy zrobić, to zapoznać się z często zadawanymi pytaniami, gdzie znajdują się odpowiedzi na podstawowe pytania. Obszerniejsze wyjaśnienia zagadnień związanych z phpBB można znaleźć w wielu miejscach.

3.1. Dokumentacja phpBB

Pełna dokumentacja jest dostępna online pod adresem:

https://www.phpbb.com/support/documentation/3.0/

Obejmuje ona wszystko, począwszy od instalacji przez ustawienia uprawnień, po zarządzanie użytkownikami.

3.2. Baza wiedzy

W bazie wiedzy znajduje się wiele szczegółowych artykułów dotyczących problemów, z jakimi spotykają się użytkownicy phpBB. Baza wiedzy znajduje sie pod adresem:

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

3.3. Fora społeczności

Projekt phpBB skupia wokół siebie społeczność spośród, której wielu wolontariuszy poświęca swój czas, by pomagać innym użytkownikom phpBB. Witryna, na której można uzyskać pomoc innych użytkowników znajduje się tutaj:

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

Zanim poprosisz o pomoc na naszych forach, spróbuj je przeszukać, a może już ktoś zgłosił podobny problem i uzyskał jego rozwiązanie. Może to zaoszczędzić twój, jak i nasz czas i umożliwi programiście, moderatorowi i grupie osób świadczących pomoc poświęcić więcej czasu na odpowiedzi osobom, które zgłosiły dotychczas nieznane problemy. Weź także pod uwagę, że phpBB jest całkowicie oparte na pracy wolontariuszy i zarówno programiści, jak i moderatorzy za swój poświęcony phpBB czas nie otrzymują żadnego wynagrodzenia, więc zachowaj cierpliwość i zrozumienie, gdy oczekujesz na odpowiedź.

3.4 Czat (IRC)

Inne miejsce, gdzie możesz uzyskać pomoc, to kanał IRC. Działa on w sieci Freenode: irc.freenode.net na kanale #phpbb i jest dostępny za pomocą takich klientów IRC jak mIRC, XChat itp. Prosimy nie nadużywać tej usługi i zachować szacunek dla innych użytkowników.

Są także dostępne inne kanały. Pełny wykaz znajdziesz tutaj: https://www.phpbb.com/support/irc/.

To jest stabilne wydanie skryptu phpBB. Linia 3.1.x ma w zasadzie zamrożone funkcje, a jej zmiany sprowadzają się do publikowania poprawek bezpieczeństwa i naprawy błędów. Dopuszcza się zmiany funkcji i drobnych uzupełnień, jeśli zostanie uznane to za absolutnie konieczne. Kolejnym głównym wydaniem będzie phpBB 3.2, które jest w fazie tworzenia. Prosimy nie pytać o datę wydania wersji 3.2, ponieważ nie została ona jeszcze określona.

Osoby zainteresowane rozwojem phpBB mogą śledzić postęp prac na forum:

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

Forum to nie powinno być używane do uzyskania pomocy dotyczącej phpBB. Odpowiednim miejscem do uzyskania pomocy są główne fora społeczności i tam należy kierować się ze swoimi problemami.

Do gromadzenia, zarządzania i śledzenia zgłoszonych błędów, phpBB Limited używa systemu śledzenia błędów, który jest dostępny pod niżej podanym adresem. Prosimy nie zgłaszać błędów na naszych forach, będą one zamykane. Ponadto prosimy nie używać systemu śledzenia błędów do zgłaszania próśb o pomoc. Prośby o pomoc należy kierować bezpośrednio na forum pomocy.

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

Choć jesteśmy bardzo wdzięczni za zgłaszanie błędów, więcej zgłoszeń – bardziej stabilny skrypt phpBB, to bardzo prosimy przed zgłoszeniem błędu wykonać następujące czynności:

• ustal, czy błąd da się ponownie wywołać. W jaki sposób to zrobić, zależy od błędu. Tylko, jeśli błąd da się ponownie wywołać, może stanowić problem z phpBB lub czasami z połączeniem. Jeśli błąd nie da się reprodukować, być może dostawca usług hostingowych coś w tym czasie robił na serwerze, użytkownik robił coś niemądrego itp. Zgłoszenia błędów, których nie da sę reprodukować, mogą spowolnić nasze prace nad innymi, rzeczywistymi błędami,
  
  
• przeszukaj bazę istniejących błędów, by sprawdzić czy dany lub bardzo podobny błąd nie został już zgłoszony. Jeśli taki sam lub podobny błąd został już zgłoszony, zamiast tworzyć nowe zgłoszenie, dodaj do istniejącego błędu swoje uwagi,
  
  
• używając funkcji szukania, sprawdź fora, by upewnić się, że nie toczy się dyskusja o czymś, co przypomina twój błąd. Pamiętaj, by – jak pisaliśmy wcześniej – nie pisać o błędzie, który nie da się reprodukować lub nie masz pewności, że jest on związany z czymś, co było zrobione na phpBB,
  
  
• jeśli nie ma takiego lub podobnego błędu – zgłoś go w naszym systemie śledzenia błędów.

Przed zgłoszeniem błędu, używając tych samych, co do logowania na forum danych, zaloguj się w systemie śledzenia błędów. Zgłaszając błąd, podaj następujące dane:

• typ/wersję serwera, np. Apache 2.2.3, IIS 7, Sambar itp.
• wersję PHP i tryb operacji, np. PHP 5.3.3 jako moduł, PHP 5.4.0 uruchomione jako CGI itp.
• typ/wersję bazy danych, np. MySQL 5.0.77, PostgreSQL 9.0.6, MSSQL Server 2000 SP1 itp.

Typ i wersję używanej bazy danych można znaleźć w panelu administracji.

W zgłoszeniu podaj jak najwięcej szczegółów dotyczących błędu. Jeśli to możliwe, opisz wszystkie kolejne działania, które doprowadziły do wystąpienia błędu. Dzięki temu będziemy mogli łatwiej powielić błąd. Jeśli masz gotową łatkę, która rozwiązuje problem, dołącz ją do zgłoszenia lub wyślij do repozytorium na GitHubie.

Jeśli tworzysz łatkę, powinna ona być, ale nie musi, zgodna z naszymi wytycznymi kodowania. Zwróć uwagę, że wytyczne są różne dla różnych wersji phpBB. Dla phpBB 3.1.x wytyczne kodowania znajdują się tutaj: http://area51.phpbb.com/docs/31x/coding-guidelines.html.

Jeśli w twoim zgłoszeniu pojawią się nowe komentarze, będziesz otrzymywać powiadomienia. Jeśli pojawią się prośby o dodatkowe informacje – udziel na nie odpowiedzi! Jest to irytujące dla nas, gdy otrzymujemy zgłoszenie błędu, prosimy o dodatkowe informacje i nie uzyskujemy odpowiedzi. W takich przypadkach będziemy zamykali błędy, nawet jeśli poruszają bardzo ważny problem. Oczywiście wolelibyśmy, aby takie sytuacje nie miały miejsca.

5.1. Błędy związane z bezpieczeństwem

Jeśli znajdziesz lukę w zabezpieczeniach phpBB stanowiącą potencjalne zagrożenie bezpieczeństwa, nie zgłaszaj jej w systemie śledzenia błędów, ogólnodostępnych forach itp.! Może to umożliwić wykorzystanie tej luki do wykonania niepożądanych działań, zanim naprawimy ten błąd. Wszystkie błędy związane z bezpieczeństwem powinny być zgłaszane w miejscu specjalnie dla tego przeznaczonym:

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

Ta lista nie jest kompletna, ale prezentuje błędy, które mogą mieć wpływ na szeroką rzeszę użytkowników. Inne błędy znajdujące się w systemie śledzenia błędów zazwyczaj dotyczą niektórych ustawień, metody instalacji, aktualizacji lub konwersji.

• Konwersje dużych witryn na niektórych serwerach mogą się nie kończyć prawidłowo.
• Na niektórych serwerach duże aktualizacje mogą się nie kończyć prawidłowo.
• Emotikony umieszczone bezpośrednio za znacznikami BBCode nie będą przetwarzane. Emotikony muszą zawsze być poprzedzane spacją.

phpBB 3.1.x korzysta z nowych funkcji dodanych w PHP 5.3. Zalecamy zaktualizowanie PHP do najnowszej stabilnej wersji – PHP5. Najstarsza obsługiwana wersja PHP to: 5.3.3.

Uruchamianie aplikacji na rozwojowych wersjach PHP (niestabilnych, np. wydania beta), może powodować dziwne, nieoczekiwane działanie i wyświetlanie błędów programu, które nie zawsze będą prawdziwe. Dlatego przed uruchomieniem phpBB3 zaleca się uaktualnienie PHP do najnowszej stabilnej wersji. Jeśli witryna phpBB została uruchomiona na rozwojowej wersji PHP i wystąpiły błędy, przed ich zgłoszeniem, należy potwierdzić je na stabilnej wersji.

Witryna była tworzona i testowana na systemach Linux i Windows z serwerem Apache, używając MySQL 3.23, 4.x, 5.x, MariaDB 5.x, MSSQL Server 2000, PostgreSQL 8.x, Oracle 8, SQLite 2 i SQLite 3. Używano PHP od wersji 5.3.x do 5.4.x. Testy finalne nie wykazały żadnych problemów.

7.1. Informacje związane z bezpieczeństwem PHP

Obecnie nie ma żadnych problemów dotyczących bezpieczeństwa PHP.

Ta aplikacja jest darmowym oprogramowaniem wydanym na licencji GNU General Public License, wersja 2 (GPL-2.0). Prawa autorskie posiada Copyright © phpBB Limited. Więcej informacji dotyczących praw autorskich i licencji znajdziesz w katalogu docs w pliku CREDITS.txt.