Dziękujemy za pobranie phpBB3. Ten artykuł opisuje podstawowe zagadnienia związane z instalacją i działaniem skryptu. Zanim przystąpisz do instalacji, zapoznaj się z tym artykułem i towarzyszącą mu dokumentacją.

Informacje podstawowe


1. Instalacja

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

Nie można bezpośrednio zaktualizować wersji phpBB3 Beta.

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

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

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

  • aktualizacje z wersji phpBB3 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 phpBB3 – zawsze tylko do najnowszej wersji.

2. Uruchamianie

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 languages/ i folderów styles, zwracając uwagę na zachowanie struktury katalogu. Po przesłaniu na serwer, należy przejść na kartę Panel administracji » System » Pakiety językowe i zainstalować nowy pakiet językowy. Aby zainstalować zestaw obrazków danego stylu, należy pobrać zestaw dla danego języka, rozpakować i zachowując strukturę katalogu przesłać na serwer do odpowiedniego katalogu stylu, np. styles/prosilver/imageset lub styles/subsilver2/imageset. Po zainstalowaniu zestaw obrazków będzie natychmiast dostępny.

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 3 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że jest także, aby zainstalowane style były zgodne z zainstalowaną wersją phpBB3.

Po pobraniu pakietu stylu trzeba go rozpakować i przesłać na serwer do katalogu styles/, a następnie przejść na kartę Style znajdującą się w panelu administracji. W otwartej karcie należy kliknąć odnośnik „Instaluj”, by dokończyć instalację stylu.

Należy pamiętać, że jeśli tworzy się lub modyfikuje istniejący styl, trzeba w sekcji Panel administracji » Style » Komponenty stylów odświeżyć dla zmienionego stylu szablony, motywy i zestawy obrazków. 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. Modyfikacje

Chociaż oficjalnie modyfikacje nie są wspierane przez phpBB Group, phpBB ma kwitnącą sferę modyfikacji. Modyfikacje tworzone przez zewnętrznych programistów rozszerzają możliwości standardowego skryptu i można je znaleźć na witrynie: Customisation Database w sekcji Modifications.

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

Jeśli po dodaniu modyfikacji 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 usunąć dokonane zmiany i sprawdzić poprawność działania phpBB. Pomoc dotyczącą modyfikacji znajdziesz na forum dotyczącym tej modyfikacji.

Należy pamiętać, że modyfikacje zmieniające bazę danych mogą w przyszłości utrudniać aktualizację witryny. Mimo tych ostrzeżeń wielu użytkowników ma i będzie nadal używać wiele modyfikacji bezproblemowo.


3. Pomoc dla phpBB3

Dla nowych użytkowników phpBB3 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 phpBB3

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

phpBB Group 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/.


4. Status tej wersji

Jest to trzecie stabilne wydanie skryptu phpBB. Linia 3.0.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.1 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 lub zadawania pytań dotyczących phpBB 2.0.x, lub phpBB 3.0.x. Wersje te mają swoje fora pomocy i tam należy kierować się ze swoimi problemami dotyczącymi tych wersji. Wszelkie posty zamieszczane na tym forum, a dotyczące wersji 2.0.x oraz 3.0.x będą zamykane i pozostawione bez odpowiedzi.


5. Zgłaszanie błędów

Do gromadzenia, zarządzania i śledzenia zgłoszonych błędów, phpBB Group używa systemu śledzenia błędów, który jest dostępny pod adresem podanym niżej. 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 phpBB3 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 phpBB3,

  • 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 1.3.28, IIS 4, Sambar itp.
  • wersję PHP i tryb operacji, np. PHP 5.1.1 jako moduł, PHP 4.4.4 uruchomione jako CGI itp.
  • typ/wersję bazy danych, np. MySQL 4.0.1, PostgreSQL 7.3.2, 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 on 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.0.x wytyczne kodowania znajdują się tutaj: http://area51.phpbb.com/docs/30x/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/


6. Przegląd aktualnego wykazu błędów

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

7. Problemy z kompatybilnością PHP

Z powodu różnych problemów z kompatybilnością, phpBB nie obsługuje już PHP3 i aby używać phpBB, zalecamy zaktualizowanie PHP do najnowszej stabilnej wersji – PHP5. Najstarsza obsługiwana wersja PHP to: 4.3.3. Wersja phpBB 3.1 wymaga PHP w wersji minimum 5.3.3.

Uruchamianie phpBB3 na rozwojowych wersjach PHP, 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 phpBB3 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, używając MySQL 3.23, 4.x, 5.x, MSSQL Server 2000, PostgreSQL 7.x, Oracle 8, SQLite 2 i Firebird, a także PHP od wersji 4.3.3 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.


8. Odpowiedzialność i prawa autorskie

Ta aplikacja jest oprogramowaniem open-source udostępnionym na licencji GNU General Public License wer. 2. Więcej informacji znajdziesz w kodzie źródłowym i katalogu docs. Prawa autorskie tego pakietu i jego zawartości posiada Copyright © phpBB Group. Wszelkie prawa zastrzeżone.