[ O PunBB ] [ Dla developerów ] [ Najczęściej Zadawane Pytania ] [ Instalacja i Aktualizacja ]

Poniżej znajdują się najczęściej zadawane pytania i odpowiedzi. Pamiętaj, że dokumentacja jest podstawowym źródłem pomocy, dlatego zanim utworzysz nowy wątek na polskim forum wsparcia upewnij się, że poniżej nie opisano Twojego problemu. Jeżeli nie znajdziesz tutaj odpowiedzi, to spróbuj skorzystać z wyszukiwarki serwisu. Być może ktoś już miał taki sam problem jak Ty!

1.1 Dlaczego nie mogę się zalogować?
Jest wiele możliwych powodów. Najprostszy z nich to złe podanie loginu lub hasła podczas logowania. Sprawdź dwa razy czy podałeś poprawne informacje zanim się zalogujesz ponownie. Jeśli nadal nie działa to skorzystaj z funkcji “Zapomniałeś hasła?”. Jeśli wprowadziłeś poprawne informacje to po logowaniu powinieneś zostać przeniesiony na stronę z której się logowałeś. Jeżeli po powrocie nadal nie jesteś zalogowany problem może leżeć po stronie cookies. PunBB opiera się o cookies, w których zapisane są informacje o tym czy jesteś zalogowany. Upewnij się, że twoja przeglądarka ma włączoną obsługę cookies. Jeżeli nadal masz problemy to powiadom administratora forum, na którym jesteś użytkownikiem lub zasięgnij rad na http://pun.fluxbb.pl.

1.2 Czy PunBB wspiera BBCode, jeśli tak to jak go użyć?
Tak, PunBB wspiera BBCode. Obsługiwana jest większość tagów, które są używane w innych skryptach. Tagi zaimplementowane w PunBB to: bold (pogrubienie), underline (podkreślenie), italic (kursywa), color (kolor), url (link), email, img (obraz), quote (cytat) oraz code (kod). Informacje o używaniu tagów znajdują się w pliku help.php. Link do niego znajduje się w polu BBCode podczas pisania posta.

2.1 Otrzymuję wiadomość w stylu “Bad HTTP_REFERER.”. Jak się jej pozbyć?
Podczas otrzymywania danych PunBB sprawdza poprawność zmiennej HTTP_REFERER aby upewnić się, że dane zostały wysłane z poprawnego skryptu. Sprawdzanie jest robione tylko w przypadku administratorów i moderatorów. Skrypt ten sprawdza bezpieczeństwo forum i upewnia się, że dany użytkownik jest tym kimś, za kogo się podaje. Niestety może on zawieść w wielu przypadkach. Sprawdzanie polega na poprawnych danych w polu “Base URL” opcji panelu administratora. Jeśli “Base URL” jest niepoprawnie ustawiony to referrer zawiedzie. Drugą przyczyną może być to, iż wchodzisz z innego adresu w przeglądarce niż ten ustawiony w “Base URL“. Gdy go ustawiono np. na http://somehost.com a Ty wchodzisz przez http://www.somehost.com (zauważ część www), sprawdzanie może zawieść. Inną przyczyną może być to, że używasz Firewalla lub Proxy i HTTP_REFERER niepoprawnie wykonuje żądania. Norton Internet Security oraz Norton Personal Firewall niepoprawnie interpretują referera. Niektóre popup killery także mają takie skłonności (większość na szczęście nie).

Nota: Możesz znaleść artykuł o konfiguracji Norton Internet Security oraz Norton Personal Firewall, tak aby nie ograbiały referera z informacji ;)

2.2 Jak ustawić moderatora do forum?
Najpierw musisz przenieść użytkownika do grupy Moderatorów. Możesz to zrobić w profilu użytkownika, w zakładce “Administration/Administracja”. Następnym krokiem jest nadanie praw moderatorskich na jednym lub więcej for. Ten krok także wykonuje się w profilu użytkownika. Ustaw tylko w menu wyboru a następnie zaznacz fora do moderacji a następnie kliknij na przycisk Update Forums/Aktualizuj fora. Użytkownik jest teraz moderatorem i ma prawo do usuwania, przenoszenia, edytowania i zamykania postów.

2.3 Wysyłanie avatarów nie działa, co może być źle?
W pierwszej kolejności przy braku możliwości wysyłania powinieneś sprawdzić uprawnienia dla folderu w którym mają być trzymane. Na systemach klasy UNIX rozwiązywane jest to za pomocą komendy “chmod”. W większości klientów FTP sprowadza się to do znalezienia opcji Atrybuty (Attributes lub Permissions). Jeżeli nie wiesz jakie liczby wpisać, to spróbuj po prostu 0777 lub 777 (dla trzy-cyfrowych miejsc).

2.4 Otrzymuję wiadomość “Unable to write configuration cache file to cache directory.”. O co chodzi?
Podobny problem jak w przypadku pytania wyżej. Nadaj po prostu chmod 777 lub 0777 na katalog cache, lub jeśli korzystasz z serwera Windows odznacz opcję “tylko do odczytu”.

2.5 Osoby korzystające z Internet Explorera 6 nie mogą się zalogować, czemu?
Problem tkwi w tym jak IE6 przechowuje trzeciorzędne cookies. Pierwszorzędne cookie pochodzi z domeny hosta a trzeciorzędne z innych domen znajdujących się na tym hoście. Problemem jest korzystanie z ramek lub aliasów www. Najlepszym rozwiązaniem na problem jest po prostu korzystanie z domyślnej i prawdziwej ścieżki do forum. Jeżeli jednak nadal Ci to nie pomoże, to przy odrobinie wiedzy możesz edytować skrypt includes/functions.php.

2.6 Ustawiłem forum w trybie remontu i się wylogowałem. Jak go wyłączyć?
Skopiuj/wyślij skrypt turn_off_maintenance_mode.php z katalogu extras/ do głównego katalogu forum i go włącz w przeglądarce. Następnie pojawi się wiadomość o udanej operacji. Po zakończeniu usuń natychmiast skrypt!

2.7 Czym jest “DEBUG mode” i jak go uruchomić?
Debug mode jest przydatnym rozwiązaniem przy poszukiwaniu błędów w skrypcie. Wyświetla on różne informacje, błędy i inne przejawy niespójności czy problemy ze skryptem. Wyświetla także czas generacji i ilość zapytań. Włącz tryb DEBUG edytując plik include/common.php (około 26 linii):

I usuwając dwa ukośniki aby wyglądało to tak:

define(’PUN_DEBUG’, 1);

2.8 Można posiadać więcej niż jeden “Base URL“?
Domyślnie nie ma takiej możliwości. Chyba, że uda Ci się rozwiązać problemy z DNSami i konfiguracją serwera tak aby możliwe było wchodzenie z IP i domeny, nie mając przy tym problemów z logowaniem. Według mnie to nie ma najmniejszego sensu, gdyż chyba nie każdemu chodzi o IP.

2.9 Zaktualizowałem bazę ręcznie, ale zmiany nie dają efektu. Dlaczego?
Aby odciążyć serwer PunBB potrafi utworzyć pliki do przechowywania danych w folderze (tzw. cache’owanie) cache/. Jeśli po jakimś czasie nie widzisz dalej zmian, to po prostu usuń zawartość katalogu cache (ale nie cały folder!).

3.1 Jak dodać więcej emotikon do forum?
Dodawanie nowych emotikon nie jest trudne, ale wymaga uważnego edytowania kodu oraz podstawowych znajomości PHP. Poniżej znajduje się instrukcja krok po kroku:

- Skopiuj obrazki które chcesz dodać/zamienić do katalogu img/smilies/.
- Otwórz plik include/parser.php w edytorze tekstowym i zlokalizuj linię zaczynającą się od słów “// Here you can add additional smilies if you like”. Następnie znajdziesz dwie zmienne PHP - $smiley_text oraz $smiley_img. $smiley_text zawiera znaki oznaczające tekstowe emotikony, (np. :D lub :rolleyes:) a $smiley_img zawiera nazwy plików obrazków (np. big_smile.png lub roll.png).
- Dla każdej nowej emotikony, którą chcesz dodać wstaw kombinację znaków do $smiley_text oraz nawę pliku do $smiley_img. Pamiętaj, że musisz zakańczać znakiem ‘ (pojedynczy cudzysłów) natomiast jeśli używasz go nie zakańczając musisz wstawić przed nim znak backslasha (np. ‘:rock’n’roll:’). Dla PHP pojedynczy cudzysłów jest znakiem końca linii. Gdy chcesz użyć backslasha także nie kończąc musisz przy nim postawić drugi (np. ‘:\’)
- Po dodaniu nowych emot powinieneś zwracać uwagę na to do której linijki należą wpisy.
- Na końcu zapisz/wyślij i wypróbuj nowe emoty, ich listę znajdziesz na samym dole skryptu help.php.


Jeżeli otrzymujesz błąd w stylu “Parse error”, najprawdopodobniej zapomniałeś postawić znaku cudzysłowia lub backslasha w zmiennej $smiley_text.

3.2 Jak dodać emotikony o innych rozmiarach niż 15×15?
Do używania nie-15×15 pixelowych emotikon musisz dodać/zedytować parametry width=”15” oraz height=”15” do tagów IMG. Można to zrobić przez otwarcie include/parser.php w edytorze i wyszukaniu w nim:

width=”15” height=”15”

Tekst powinien znajdować się w pobliżu linii 260. Następnie zmień wartości wysokości i szerokości na swoje. Jeśli chcesz używać emot o różnych rozmiarach usuń po prostu te wpisy z tagu.

3.3 Jak dodać własną stopkę/nagłówek tak aby zintegrować wygląd z resztą serwisu?
PunBB ma bardzo prosty system szablonów, ich pliki znajdują się w katalogu include/template/. Pięć z nich odpowiada za generowanie układu forum - main.tpl, admin.tpl, help.tpl, maintenance.tpl oraz redirect.tpl. Plik main.tpl zawiera szablon dla wszystkich stron głównego forum (postów, profilu, wyszukiwarki itd.), admin.tpl jest szablonem interfejsu administratora, help.php służy do zmiany wyglądu pomocy, maintenance.tpl jest szablonem wykorzystywanym do wyświetlania wiadomości o remoncie forum, natomiast redirect.tpl jest używany do wyświetlania wiadomości o przekierowaniu (np. podczas logowania, czy po napisaniu posta). Szablon zawiera zmienne, które są zamieniane na właściwą treść podczas generacji. Wszelkie zmienne są ustawione między znakami (< oraz >). Na przykład zmienna wyświetlająca tytuł forum to . Gdy PunBB wyświetla index forum to wykorzystywany jest szablon main.tpl i zamienia na aktualny tytuł forum. W main.tpl znajduje się 11 zmiennych podobnych do tej, lecz robiących co innego. Jeżeli chcesz dobrze przystosować wygląd forum do reszty serwisu powinieneś zacząć właśnie od tego pliku. Na przykład gdybyś chciał(a) dodać logo/stopkę z serwisu musisz zedytować main.tpl i w odpowiednie miejsce wstawić zmodyfikowany kod. Możliwe jest wstawianie skryptów php. Przeczytaj następny wpis aby dowiedzieć się o tym więcej.

3.4 Czy jest możliwe wstawianie własnych skryptów php w szablonach?
Oczywiście. PunBB ma możliwość zamiany pun_include na zewnętrzny skrypt w szablonach. Na przykład jeśli chciałbyś wystawić plik banner.php (znajdujący się w głównym katalogu forum) na stopkach wszystkich podstron musisz w szablonie wstawić następujący znacznik:

<pun_include “banner.php”>

Zauważ, że banner.php nie ma ścieżki, gdyż znajduje się on w głównym katalogu forum. PunBB wsadzi skrypt na miejsce znacznika pun_include podczas generacji witryny w przeglądarce. Pamiętaj, że wszystkie wstawione skrypty za pomocą tej opcji mają możliwość korzystania ze zmiennych i funkcji PunBB, jeśli na przykład chciałbyś uzyskać dostęp do bazy używasz zmiennej $db tak jak robią to inne skrypty. Zamiana pun_include na właściwy skrypt(kod) to ostatnia rzecz, jaką PunBB robi przed generacją, więc o skutki jej użycia nie musisz się martwić.

3.5 Chcę umieścić informacje z forum na mojej stronie(serwisie). Jak to zrobić?
Skrypt extern.php znajdujący się w głównym katalogu forum służy do wyświetlania takich informacji. Więcej wskazówek i przykłady znajdują się w Informacjach dla Developerów.

3.6 Czy PunBB posiada feed RSS generujący ostatnie dyskusje?
Tak. Skrypt extern.php pozwala na generowanie feedów RSS 0.91. Aby zasięgnąć więcej informacji wejdź na Informacje dla developerów.

3.7 Stworzyłem modyfikację dla PunBB i chcę ją opublikować innym użytkownikom. Co mam zrobić?
Odwiedź stronę downloadu na PunBB.org i pobierz paczkę Mod SDK. Zawiera ona plik tekstowy z instrukcjami, szablon dla pliku readme.txt (każdy mod musi posiadać taki plik) oraz szablon pliku instalacyjnego, jeśli będzie potrzebny. Po więcej informacji o modowaniu PunBB skorzystaj z PunRes.org

4.1 Na jakiej licencji wydano PunBB?
PunBB wydano na licencji GNU General Public License. W skrócie oznacza to, że PunBB jest darmowe do pobierania, używania, dystrybucji czy modyfikacji. Jednak, na tej samej licencji muszą być wydawane ogólnodostępne modyfikacje do skryptu.

4.2 Czy można usunąć informacje o skrypcie ze stopki forum?
Tak, ale bardzo prosimy tego nie robić. Jeśli musisz, postaraj się zachować napis “Powered by PunBB” z linkiem do www.punbb.org.

4.3 Mogę dodać własny wpis w stopce?
Tak, ale nie może on zawierać mylących i nielegalnych informacji o pochodzeniu skryptu forum, (Powered by mojeforum itd.) nie może także być niezgodna w stosunku do oryginalnej stopki. Dodanie własnego linka, czy jakiegoś napisu jest jak najbardziej OK.

4.4 Mogę usunąć informacje o skrypcie z kodu źródłowego?
Nie. Informacje znajdujące się w kodzie muszą zostać. Modyfikowanie lub usuwanie jest niezgodne z postanowieniami licencji GNU General Public Licence.