Warning: main(http://www.adgame.cba.pl/extern.php?action=new&show=10&fid=1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25): failed to open stream: HTTP request failed! in /var/www/virtual/adgame.cba.pl/index.php on line 25

Warning: main(): Failed opening 'http://www.adgame.cba.pl/extern.php?act … 2,23,24,25' for inclusion (include_path='.:/usr/share/php:/usr/share/pear') in /var/www/virtual/adgame.cba.pl/index.php on line 25

Syndykacja

Skrypt extern.php jest używany do wyświetlania informacji z forum poza nim oraz ostatnich postów przez kanały RSS. Skrypt może wyświetlić listę najaktywniejszych wątkow (sortowanych przez datę rozpoczęcia lub napisania ostatniego posta), listę aktywnych użytkowników oraz statystyki forum. Skrypt może być wywoływany zdalnie przez adres URL (dla RSS), dla funkcji PHP - include lub podobnych PunBB używa SSI.

Skrypt jest kontrolowany przez zmienne zawarte w adresie URL. Wybrane opcje to na przyk?ład: action (co ma zostać wyświetlone), show (liczba wątków do wyświetlenia), forum (ID forum, z którego mają być pokazane tematy) oraz type (HTML lub RSS).
Możliwe/domyślne właściwości:

1 Action: 
  active (pokazuje najbardziej aktywne wątki) (HTML lub RSS)
  new (pokazuje najnowsze wątki) (HTML lub RSS)
  online (pokazuje liczbę użytkowników online) (HTML)
  online_full (jak powyżej, ale pokazuje pełną listę) (HTML)
  stats (pokazuje statystyki forum) (HTML)

2. Show: Liczba z przedziału 1 do 50. Ta opcja jest ignorowana przy RSS. Domyślną liczbą jest 15.
3. Fid: Z jednego lub więcej ID for (oddzielone przecinakmi bez spacji). Jeśli nie zdefiniowano to 
wszystkie wątki dostępne dla gości będą pokazywane.
4. Type: RSS. Cokolwiek innego oznacza HTML.

Kilka przykładów korzystających z PHP include().

Pokazuje najbardziej aktywne wątki z wszystkich for:
include(?host.com/forums/extern.php?action=active?);

Pokazuje 10 najnowszych postów z for o ID 5, 6 oraz 7:
include(?host.com/forums/extern.php?action=new&show=10&fid=5,6,7?);

Pokazuje użytkowników online:
include(?host.com/forums/extern.php?action=online?);

Pokazuje użytkowników online z pełną listą:
include(?host.com/forums/extern.php?action=online_full?);

Pokazuje statystyki forum:
include(?host.com/forums/extern.php?action=stats?);

host.com/forums zamieniamy na adres do naszego forum (np. http://strona.pl/forum)

Kilka przykładów korzystających z SSI.

5 najnowszych wątków z for o ID 11 oraz 22:
<!?#include virtual=?forums/extern.php?action=new&show=5&fid=11,22? ?>

Pokazuje statystyki forum:
<!?#include virtual=?forums/extern.php?action=stats? ?>

I w końcu przykłady wykorzystania extern.php do obsługi RSS 0.91.

Pokazuje 15 najbardziej aktywnych wątków:
host.com/extern.php?action=active&type=RSS

Pokazuje 15 najnowszych wątków z forum o ID=2:
host.com/extern.php?action=active&type=RSS&fid=2

Integracja z serwisem

Podstawowa integracja forum PunBB oraz Twojego serwisu jest prosta jeśli znasz minimum PHP. Przez wyświetlanie skryptu common.php otrzymasz dostęp do wszystkich podstawowych i przydatnych zmiennych globalnych jak na przykład $db czy $pun_user. Jednakże przed includem takiej zmiennej musisz zdefiniować PUN_ROOT. Ciąg ten jest używany do rozpoznawania relatwynej ścieżki do skryptu forum. Przykładowo jeśli Twój serwis znajduje się w /home/user/public_html/ a Twoje forum w /home/user/public_html/forums/, PUN_ROOT powinno wyglądać mniej więcej tak: ?./forums/?. Składnia kodu PHP:

define(?PUN_ROOT?, ?./forums/?); require PUN_ROOT.?include/common.php?;

Po jednorazowym zaincludowaniu common.php, otrzymujesz dostęp do wszystkich przydatnych zmiennych i funkcji PunBB. Zapewne będziesz zainteresowany zmienną $pun_user. Ta zmienna zawiera informacje dotyczące aktualnie zalogowanego użytkownika. Następną interesującą zmienną jest $db. Poniżej znajdziesz najprostszy przykład wykorzystania zmiennych i funkcji skryptu.

Witaj <?php echo pun_htmlspecialchars($pun_user[?username?]); ?>!

Po zdefiniowaniu PUN_ROOT, możesz wpisać ciąg innych opcji z common.php. Najbardziej interesującymi są PUN_TURN_OFF_MAINT oraz PUN_QUIET_VISIT. Jeśli PUN_TURN_OFF_MAINT zostało zdefiniowane po common.php, PunBB nie wyświetli informacji podczas prac konserwacyjnych nad forum. Przeważnie nie chcesz, żeby taka wiadomość widniała na stronie głównej, więc zdefiniowanie tej opcji jest dobrym pomysłem. Innym przykładem jest PUN_QUIET_VISIT, zapobiega aktualizacji danych użytkownika przy pobycie w serwisie, co oznacza brak zmiany daty ostatniego logowania i pokazania na liscie użytkowników bez pobytu na forum. To także w większości przypadków jest rozsądne wyjście. Nie ważne jaką wartośc przypiszesz definicji, ale musi być ona wyższa niż zero, a dobrym pomysłem jest wpisywanie 1. Przykład:

define(?PUN_TURN_OFF_MAINT?, 1); define(?PUN_QUIET_VISIT?, 1);

Pamiętaj, że te definicje muszą być zapisane przed includem common.php!

Pluginy Admina

Pluginy admina są małymi skryptami zintegorwanymi z panelem admina, do których uruchomienia wystarczy wysłanie ich na serwer do katalogu /plugins. Zbadaj przykładowy plugin aby dowiedzieć się więcej. Poniżej kilka wskazówek dla twórców:

- Jeśli chcesz wyświetlić wiadomość korzystając z funkcji message() wcześniej musisz użyć generate_admin_menu($plugin).
- Pluginy są ładowane przez admin_loader.php i nie mogą być zabijane (chodzi np. o wywoływanie funkcji exit()). Po zakończeniu skryptu plugina skrypt ładowania sam wyświetli stopkę, więc o to nie trzeba się martwić. Pomimo to proszę pamiętać, że calling message() lub redirect() jest dobrym rozwiązaniem.
- Atrybut akcji wszystkich tagów <form> oraz cel URL dla funkcji redirect() to $_SERVER[?REQUEST_URI?]. Ten adres URL może być rozszerzany o inne opcje (na przykład &foo=bar w przykładowym pluginie).
- Jeżeli Twój plugin jest tylko dla administratorów, Prefixem nazwy pliku musi być ?AP_?. Jeżeli zaś jest on zarówno dla administratorów jak i moderatorów, użyj prefixu ?AMP_?. Przykładowy plugin ma prefix ?AMP_? i jest dostępny dla administratorów oraz moderatorów w menu.
- Używaj _ zamiast spacji w nazwach plików pluginów.
- Odkąd pluginy są uruchamiane w admin_loader.php, otrzymujesz dostęp do zmiennych i opcji PunBB (np. $db, $pun_config, $pun_user itd.).
- Aby zachować całkowitą zgodność i prostotę projektuj interfejs zgodnie z resztą panelu admina. Rozsądnie pisz kod, dbając o jego czytelność i bezpieczeństwo.
- Pluginy muszą być wydawane na licencji GNU GPL lub jej kombatybilnej. Skopiuj preambułę (w j. ang) do początku Twojego skryptu oraz umieść informacje o autorze plugina (np. Tobie).