Shoutbox od A do Z

[BitGit]

Krok 1. Pobieranie
Jeżeli jesteś zarejestrowanym klientem IPS bez trudu pobierzesz bezpłatną aplikację Shoutbox w Marketplace: http://community.inv...5-ipb-shoutbox/
Jeżli jesteś zarejestrowanym użytkownikiem forum invisionize.pl bez trudu pobierzesz polską paczkę językową: http://forum.invisio...2-shoutbox-140/

Krok 2. Instalacja aplikacji
Po pobraniu paczki z Marketplace zobaczysz katalog zip, który musisz oczywiście rozpakować. We wnętrzu znajdują się dwie teczki : Documentation (która zawiera instrukcję instalacji) oraz teczkę Upload. Nas interesuje zawartość właśnie tej drugiej teczki . W środku znajdziemy katalogi admin oraz public, które z pomocą klienta ftp przerzucimy na nasz serwer. Istotną sprawą jest prawidłowe wgranie teczek i plików, które muszą zachować swoją strukturę w docelowych katalogach.

Krok 3. Instalacja
Po wgraniu plików na nasz serwer przechodzimy do panelu administracyjnego ACP, do sekcji Aplikacje i moduły. (1)

 

 

Po prawej stronie listy naszych aplikacji, pojawiła się informacja, że nowa aplikacja - Shoutbox oczekuje na instalację (2) Nie pozostaje nam więc nic innego, jak tylko w nią kliknąć i zainstalować. Przed startem skrypt zapyta Cię o tworzenie lub nadpisywanie tabel - wybierz opcję domyślną (nic nie zmieniaj). Instalacja odbywa się automatycznie, skrypt sam stworzy tabele, zaimportuje hooki, doda style itd..

Po zaimportowaniu aplikacji, na naszej liście znajduje się teraz także Shoutbox.

 

 

(Porada)

Shoutbox nie jest aplikacją wymagającą "wchodzenia" w nią z poziomu menu forum, można więc ukryć wyświetlanie tej zakładki. Żeby to zrobić wybierz z prawej strony ( mówimy tu o liście aplikacji w sekcji aplikacje i moduły) i kliknij w ikonę ołówka, a następnie w ograniczeniach zakładki zaznacz "ukryj kartę" i zaznacz wszystkie grupy w sekcji ukryte dla grup -> zapisz.

 

Krok 4. Spolszczenie
Ten krok możesz wykonać teraz lub później. Ja proponuję nie czekać, tylko od razu przejść w głównym panelu do zakładki Wygląd (1) > tłumaczenia (2) > import pliku tłumaczenia (3) i zainstalować pobraną wcześniej z forum polską wersję językową dla Twojego nowego Shoutboxa.

 

Krok 5. Konfiguracja
Konfigurowanie ustawień Shoutboxa odbywa się w dwóch etapach:

Krok 5. cz A.
W pierwszej kolejności przejdź do zakładki systemowej Aplikacje (1), po najechaniu na nią myszką rozwinie się lista Twoich dodatkowych aplikacji. Pośród niej znajduje się Shoutbox (2).

 

 

Z rozwijanej listy wybierz Overview (3). Masz oto przed sobą przegląd ustawień całej aplikacji, hooki, narzędzia.

 

pkt.1 Na początek, w ustawieniach (Setting) wybierz zakładk� Global Configuration :
Większość ustawień powinieneś zrozumieć bez problemu. Poniżej lista ciekawostek:

Shoutbox title - tutaj możesz zmienić nazwę wyświetlaną na belce Twojego Shoutboxa
Announcement - jest miejsce, w którym możesz umieścić ogłoszenie, regulamin, lub cokolwiek przyjdzie Ci na myśl - dodany tutaj tekst wyświetli się na zielonym tle, nad shoutami. Jeśli nie chcesz uzupełniać tego miejsca treścią i wolałbyś, aby zielony paseczek zniknął - odznacz HTML, wyłącz tryb BBC i nic nie wpisuj.
Format shouter names? - formatowanie nazw użytkowników
Ustawienia daty:
Long time format: %d %b %Y - %H:%M
today format: %H:%M
Archive clock format 24 hour
Default height - możesz zapragnąć, aby Twój SB pokazywał więcej treści (shoutów) - zmieniając tutaj wartości zrobisz go wyższym lub niższym..

pkt.2 Po zapisaniu ustawień przejdź do zakładki Hook Global Shoutbox

Tutaj między innymi skonfigurujesz jak i gdzie ma się wyświetlać  Twój SB.
Wybierz temat:
theme 1 - pole wpisywanej treści oraz przyciski znajdą się z boku SB, po prawej stronie

theme 2 - pole wpisywanej treści oraz przyciski znajdą się pod shoutami, na dole SB

Shouts display ordering - wyświetlaj shouty od najstarszego do najnowszego, bądź na odwrót.
Na to ustawienie warto zwrócić uwagę, gdy chcesz zmienić domyślne położenie Shoutboxa,
które możesz ustalić w sekcji Location Settings:

Hook to enable? (lista rozwijana)

Top of Each Page - na górze każdej strony (zalecam ustawienie shoutów Newer>Older)
Bottom of Each Page - na dole każdej strony (zalecam ustawienie shoutów Older>Newer)
Sidebar - SB widoczny tylko na stronie głównej w Sidebarze
Above Forum Categories - wyświetlany tylko na stronie głównej ponad pierwszą kategorią forum (Newer>Older)
Below Forum Categories - wyświetlany tylko na stronie głównej - pod ostatnią kategorią forum (Older>Newer)

Jeśli wybrałeś opcję pierwszą lub drugą możesz zdecydować, czy SB będzie wyświetlać się tylko na stronie głównej, czy również w subforach i tematach. Odpowiada za to ustawienie:
Display on? - Every Page ( na wszystkich stronach) Board Index Page (tylko strona główna)

Możesz zdecydowac także, czy SB bedzie wyświetlać się w innych aplikacjach; w ustawieniu Type of Page Check masz do wyboru następujące opcje:
DISABLE Page Check - wyświetla się wszędzie, bez wyjątku
EXCLUDE - wyklucza aplikacje, zgodnie z ustaloną listą
INCLUDE - zezwala na wyświetlanie w obrębie danej aplikacji, zgodnie z ustaloną listą

Musisz podjąć decyzję, czy chcesz stworzyć listę miejsc w których będzie wyświetlał się SB, czy jednak łatwiej będzie Ci wykluczyć poszczególne aplikacje
Wybraną listę wpisz do ramki Pages list w postaci np. app=members
Na podanym powyżej przykładzie (aplikacja Użytkownicy) jeśli zaznaczyłeś wcześniej opcję EXCLUDE - SB nie będzie wyświetlał się w aplikacji Members, natomiast jeżeli zaznaczyłeś wcześniej opcję INCLUDE - SB pojawi się tylko w aplikacji Members

Dalsze ustawienia dotyczą emotikonów
Ustaw ilość wyświetlanych emotikonek w okienku wyboru ( po naciśnięciu przycisku uśmieszki) domyślnie: 20
oraz Ilość emotikonek w jednej linii - domyślnie: 5
Na koniec Aktualizuj ustawienia

Dalsze ustawienia obejmują hooki:

Hook Active Users - odpowiada za wyświetlanie listy użytkowników korzystających obecnie z Shoutboxa ( lista aktywnych userów pojawi się na dole strony pod statystykami forum ) Nie zapomnij wybrać i zaznaczyć upoważnionych grup, SB będzie wyświetlał tylko użytkowników z uprawnionych grup

Task Twitter Import
Jeśli masz stworzoną aplikacją Twitter możesz użyć Shoutboxa do importowania statusów z Twittera, które będą wyświetlać się jako Shouty.

Wypełnij wymagane dane i włącz hook.

Ajax - tutaj możesz ustawić z jaką częstotliwością będzie odświeżany Shoutbox, czas po którym SB przejdzie w stan "uśpienia" - inactivitty cutoff
a także czy ukryć przycisk odświeżania przed użytkownikami podczas przeładowania SB ( auto-hide button) a nawet zdecydować czy ukryć efekt graficzny wyświetlany na górze strony (refresh image)


Krok 5. cz. B
Masz już za sobą ustawienia globalne Shoutboxa, teraz aby zacząć działać musisz nadać odpowiednie uprawnienia poszczególnym grupom.

Pierwszą czynnością jaką powinieneś zrobić będzie ustanowienie pierwszego Modaratora Shoutboxa. W tym celu przejdź do zakładki Menage Moderators

i dodaj całą grupę, bądź pojedynczego użytkownika jako moderatora shoutboxa.

Teraz wróć do Overview i znajdź po prawej stronie Zarządzanie ustawieniami grup.

 

 

Dostosuj uprawnienia każdej z nich osobno, zgodnie z Twoimi preferencjami. Uwaga, po edytowaniu grupy możesz zostać przeniesiony do sekcji ACP - zarządzanie grupami użytkowników. W niczym to nie przeszkadza - pamiętaj każdą grupę, także w przyszłości możesz edytować właśnie w tym miejscu.


Do omówienia została tylko zakładka Tools.
W przyszłości możesz skorzystać z narzędzi Shoutbocxa, w których możesz odbudować cache, resetować ustawienia użytkowników czy opróżnić tabele shoutów.

To właściwie wszystko. Twój Shoutbox jest gotowy do pracy i jeżeli wrócisz teraz na forum, właśnie przywita Cię pierwszym, dodanym shoutem