poniżej przedstawiam poradnik traktujący o konwersji innego skryptu forum do IP.Board serii 3.x przy użyciu nowego rodzaju konwertera. Poradnik został podzielony na kilka części tematycznych, by każdy szukający informacji mógł się łatwo w nim odnaleźć.
By oprzeć się na konkretnej wersji przestawię konwersję z systemu phpBB3, jednak idea jest taka, że poradnik będzie można zastosować do każdego możliwego typu forum ze względu na określoną kolejność podejmowanych kroków. Poradnik zostanie również zaprezentowany na angielskiej
2. Informacja
Konwersja spowoduje wykasowanie całej dynamicznej zawartości forum IP.Board na którym będzie przeprowadzana konwersja. Dynamiczna, czyli tematy, posty, użytkownicy - wszystko to, co zostało dodane na forum działalnością użytkowników. Innymi słowy znaczy to tyle, że konwersja nie powoduje 'doklejenie' zawartości z innego skryptu do istniejącego forum IP.Board.
3. Przygotowanie do konwersji
Etap przygotowujący jest relatywnie prosty i nie powinien powodować problemów.
Pierwszym z nich jest oczywiście instalacja forum IP.Board 3.x jeśli jeszcze nie zostało to zrobione. Poradnik, jak zainstalować forum można znaleźć tutaj, dlatego nie będzie to teraz ponownie opisane. Jeśli nie czujesz się na siłach, by zrobić to samemu, skorzystaj z linka, który podałem w poprzednim zdaniu.
Kolejny krok to przygotowanie forum, które będzie konwertowane, czyli tutaj będzie to phpBB3. Należy w panelu administracyjnym je zamknąć/zablokować w celu uniemożliwienia dodawania nowych treści na forum w trakcie procesu konwersji. Ważne jest też przygotowanie danych dostępowych do bazy danych forum, tj. nazwę serwera SQL (zwykle jest to localhost, nazwę bazy danych oraz login i hasło uprawionego użytkownika do korzystania z tej bazy).
Trzeci krok stanowi instalacja aplikacji konwertującej na forum IP.Board. Należy ją pobrać z tej strony i dla upewnienia się, po wybraniu typu skryptu z jakiego będzie dokonywana konwersja, sprawdzić, jakie dane zostaną skonwertowane, a jakie nie:


Legenda:
- dane zostaną skonwertowane
- dane zostaną skonwertowane, ale pod pewnym warunkiem (zwykle objaśnionym niżej)
- dane nie zostaną skonwertowaneInstalacja aplikacji konwertującej odbywa się identycznie, jak instalacja każdej innej aplikacji, czyli zawartość z folderu upload/ rozpakowanej paczki pobranej z linku dodanego wyżej, należy wysłać na główny poziom forum zachowując strukturę katalogów. Następnie należy przejść do:
ACP > System > Applications & Modules > Manage Applications & Modules
I z sekcji Applications Not Installed kliknąć na link Install przy pozycji o nazwie IPS Add On / IPS Converters:

Następnie nic nie zmieniając kliknąć na button o nazwie Continue:

Proces instalacji aplikacji konwertującej rozpocznie się automatycznie, a koniec instalacji zostanie nagrodzony takim oto wynikiem:

Do chwili obecnej zainstalowaliśmy aplikację konwertującą i na tym etapie proces przygotowania do konwersji został zakończony. Kolejny punkt będzie opisywać właściwy proces konwersji.
4. Konwersja
Otwórz menu aplikacji i wybierz pozycję o nazwie IPS Converters:

Główne okno konwertera zawiera kilka istotnych informacji:

Ad 1 - główne menu z pozycjami umożliwiającymi zarządzanie aktualnymi konwersjami lub dodanie nowych,
Ad 2 - możliwość wyboru do czego chcesz konwertować - do forum lub do kalendarza (jeśli możliwe),
Ad 3 - nie czujesz się na siłach wykonać samemu konwersję? Skorzystaj z odpłatnej pomocy IPSu, kosztuje to 60$. Informacja ta będzie pojawiać się w większości kroków podczas konwersji.
W każdej chwili możesz zablokować możliwość wykonywania jakichkolwiek konwersji poprzez kliknięcie na link w menu po lewej stronie, o nazwie Lock System. Spowoduje to zapisanie pliku o nazwie converter_lock.php w folderze cache/ na serwerze. Jedyną możliwością odblokowania systemu jest jego skasowanie. Co jak widać jest skuteczną metodą zablokowania przypadkowego skasowania zawartości forum i daje możliwość odblokowania systemu konwersji tylko dla osób posiadających dostęp do serwera FTP.
Uruchomienie konwertera
Kliknij na link w menu po lewej, o nazwie Start New Conversion i z menu środkowego wybierz pozycję IP.Board, jako, że będziemy konwertować inne forum do forum IP.Board.
Pojawi się nowe menu:

W pierwszej sekcji, oznaczonej cyfrą 1 należy z listy rozwijanej (1.a) wybrać forum z którego będzie dokonywana konwersja, ja wybieram phpBB 3.0, jako, że na jego przykładzie piszę ten poradnik. drugim polu (1.b) należy wpisać krótki identyfikator konwersji. Proszę nie stosować polskich znaków oraz spacji. Ma to być krótki, ale jednoznaczny skrót. Ja wpisuję forum_phpbb.
W drugiej sekcji (2) widnieje ostrzeżenie, że proces konwersji nie musi zawsze przebiegać w jednoznaczny sposób, mogą wystąpić pewne nieprzewidziane okoliczności komplikujące cały proces. Jednakże IPS oferuje pomoc ich techników, jednak z zastrzeżeniem, że czas, kiedy forum jest wyłączone może się przedłużyć.
Informacja w trzeciej sekcji (3) informuje, że jeśli na liście jest skrypt forum z jakiego chcesz wykonać konwersję, ale w niższej wersji niż w spisie należy uprzednio wykonać aktualizację forum do wymaganej wersji, by nie powodować komplikacji lub nawet nie uniemożliwiać wykonanie konwersji do IP.Board.
Dane dostępowe do bazy danych SQL
Po wybraniu wersji forum do konwersji oraz wpisaniu identyfikatora kliknij na button Continue. Pojawi się okno informacji o bazie SQL forum z którego chcesz wykonać konwersję:

Które należy uzupełnić w następujący sposób:
- Database Driver - zwykle MySQL. Jeśli nie wiesz, jaki masz sterownik bazy danych, zostaw domyślnie wybrany typ
- Database Host - nazwa serwera bazy danych
- Database Username - nazwa użytkownik bazy danych
- Database Password - hasło użytkownika bazy danych
- Database Name - nazwa bazy danych
- Database Table Prefix - prefix bazy danych
- Database Charset - zwykle puste. Jeśli pojawią się problemy ze znakami należy wpisać w to pole UTF8
Po wpisaniu informacji należy nacisnąć button o nazwie Continue. Jeśli z jakiegoś powodu pojawi się okno z komunikatem błędu, np. takie:

Należy kliknąć na link Reconfigure i poprawić formularz, upewniając się, że tym razem wpisano poprawne dane.
Główne okno konwertera - objaśnienie
Główne okno zaraz po zapisaniu danych konfiguracyjnych wygląda w ten sposób:

W pierwszej sekcji zaznaczyłem nagłówki poszczególnych kolumn, a ich wyjaśnienie jest następujące:
- Type - typ konwertowanej zawartości
- Local Rows - liczba wpisów w istniejącej bazie IP.Board
- Source Rows - liczba wpisów w bazie z której wykonywana jest konwersja
- Status - aktualny status operacji
- Per Cycle - ilość powtórzeń na cykl. W razie błędów należy zmniejszyć ilość.
- Empty local data? - skasować istniejącą zawartość forum IP.Board? Domyślnie powinno się to zaznaczać.
- Go - wykonanie danej operacji (wyjaśnienie niżej)
Krótkie wyjaśnienie ostatniej kolumny, co sygnalizowałem wyżej. Dlaczego niektórych danych nie można od razu konwertować? Otóż dlatego, że konwersja musi zostać wykonana w określonym porządku. Nie można sobie klikać dowolnie w buttony w ostatnie kolumnie.
Dla przykładu nie można skonwertować jeszcze ankiet (Polls) ponieważ nie zostały skonwertowane tematy, posty oraz głosujący użytkownicy. Opcja ta zostanie odblokowana w trakcie konwersji.
Sekcja oznaczona numerem 2 obrazuje, że możliwe jest przeprowadzenie konwersji wskazanej zawartości. Natomiast sekcja nr 3 informuję, że na chwilę obecną taka operacja nie może zostać przeprowadzona.
Informacja: po kliknięciu na czerwony button pojawi się okienko z informacją, co musi zostać najpierw przekonwertowane, by można było wykonać konwersję tejże zawartości. Jako przykład niech posłuży kliknięcie na button przy pozycji Member Groups, klikam i efektem jest pojawienie się takiej informacji:

Która informuje, że najpierw należy przeprowadzić konwersję zawartości o nazwie Permission Sets, a dopiero wtedy będzie możliwe skonwertowanie grup użytkowników.
Główne okno konwertera - konwersja
Przystępujemy do konwersji. W rym celu klikamy kolejno na buttony identyczne jak w sekcji 2 z samej góry do samego dołu. W trakcie konwersji poszczególnych typów danych będą pojawiać się rozmaite informacje, pytania, które to opisuję poniżej. Większość okien będzie pojawiać się po kliknięciu na button z sekcji 2 i takie też okna będą niżej opisane.
Custom BBCode - tagi BBCode

Pytanie dotyczy, jak chcesz postępować z identycznymi tagami BBCode, jeśli takowe znajdują się w bazie konwertowanego forum. Do wyboru są dwie opcje:
- Keep IP.Board Settings - zostaw oryginalne ustawienia z IP.Board
- Overwrite with remote settings - nadpisz ustawienia z konwertowanego forum.

Emoticons - emotikony (uśmieszki)

W tym miejscu należy wpisać path do folderu w którym składowane są emotikony używane w konwertowanym forum oraz wybrać jedną z dwóch opcji - nadpisanie identycznych emotikon z konwertowanego lub zatrzymanie istniejących ustawień z IP.Board.
Poniżej jest wskazówka dotycząc patha. Uwaga: może się różnić od stanu faktycznego. Należy to sprawdzić pytając administratora serwera.
Custom Profile Fields - pola profilu
--bez dodatkowych pytań--
Permission Sets - maski dostępu

W tym miejscu skrypt pyta w jakiej relacji skonwertować istniejące maski dostępu w konwertowanym forum do masek dostępnych w istniejącej instalacji IP.Board. Można je dopisać do istniejących lub stworzyć nowe poprzez wybranie z listy rozwijanej pozycji o nazwie --Create new set--.
Member Groups - grupy użytkowników

Podobnie jak w przypadku masek dostępu tak tutaj są przepisywane grupy. Można stworzyć nową grupę dla każdej konwertowanej grupy, ale można przypisać użytkowników z tychże grup do istniejących grup.
Members - użytkownicy

Bardzo ważny etap konwersji. Wszak dotyczy użytkowników.
Pierwsze trzy pola są następujące:
- Path to avatars uploads folder (no trailing slash, default /pathtophpbb/images/avatars/upload): - tutaj należy wpisać path do folderu z awatarami użytkowników. Zwykle skrypt podpowiada ścieżkę.
- Path to avatars gallery folder (no trailing slash, default /pathtophpbb/images/avatars/gallery): - tutaj należy wpisać path do folderu z galerią dostępnych awatarów dla użytkowników.
- Avatar salt (this is the string that all files in the avatars uploads folder start with, no trailing underscore - if not applicable, enter "."): - jeśli dostępne to należy wpisać 'sól', czyli nazwa, jaka jest dodawana na początku nazw plików z awatarami.
Kolejna lista zawiera spis pól profilu dostępnych w konwertowanym forum i dlatego może ona wyglądać inaczej na twoim forum, jednak zasada jest taka by przepisać wszystkie lub wybrane pola ze starego systemu do nowego na zasadzie parowania. Jeśli pól jest za mało w IP.Board to należy je stworzyć i wykonać ponownie ten etap.
Friendships - znajomi
--bez dodatkowych pytań--
Ignored Users - ignorowani użytkownicy
--bez dodatkowych pytań--
Categories & Forums - kategorie i fora
--bez dodatkowych pytań--
Topics - tematy
--bez dodatkowych pytań--
Posts - posty
--bez dodatkowych pytań--
Polls - ankiety
--bez dodatkowych pytań--
Personal Conversations - prywatne rozmowy
--bez dodatkowych pytań--
Ranks - rangi
--bez dodatkowych pytań--
Attachments - załączniki
--bez dodatkowych pytań--
Bad Word Filters - filtry zakazanych słów
--bez dodatkowych pytań--
Ban Filters - filtry banów
--bez dodatkowych pytań--
Warning Logs - logi ostrzeżeń
--bez dodatkowych pytań--
Wykonanie konwersji powinno skutkować takim ekranem:

Gdzie jak widać ostatnia kolumna informuje, że wszystko zostało skonwertowane.
Przy niektórych pozycja widnieje checkbox o nazwie Reconfigure - co znaczy, że posiada, lub może posiadać ustawienia konwersji tejże zawartości przy której jest ta pozycja dodana i, że można zmienić ustawienia, np. zmienić path do galerii awatarów i wykonać ponownie konwersję tej pozycji.
Główne okno konwertera - czynności po wykonaniu konwersji
Zgodnie z poprzednim screenem głównego okna konwersji w sekcji oznaczonej numerem 4 widnieje informacja o konieczności przebudowania zawartości oraz cache całego forum.
By to zrobić należy kliknąć kolejno na link Click here and run the following tools: oraz Click here and recache all.. Oba linki otwierają nowe okna/karty, nie ma konieczności otwierania ich w nowej karcie z prawego menu myszy.
Po kliknięciu myszą na pierwszy link zostaniemy przeniesieni do nowego okna do menu przebudowywania, gdzie należy uruchomić następujące narzędzia:
- Recount Statistics
- Resynchronize Topics
- Resynchronize Forums
- Rebuild Attachment Thumbnails
- Rebuild Profile Photo Thumbnails
Po kliknięciu na drugi link należy wybrać opcję Recache All:

Ostatnia sekcja w głównym widoku konwersji, oznaczona numerem 5, przypomina, by po zakończeniu wszystkich czynności zablokować konwerter. By to zrobić po prostu kliknij na link lock the system.
GOTOWE! Właśnie wykonałeś konwersję swojego forum do najlepszego obecnie skryptu forum na świecie!
5. Uwagi końcowe
System konwersji jest zablokowany, ale najlepiej będzie odinstalować aplikację. W tym celu należy przejść do:
ACP > System > Applications & Modules > Manage Applications & Modules
i w sekcji IPS Add Ons z menu przy pozycji IPS Converters wybrać opcję Remove Application..., potem na ekranie potwierdzającym usunięcie aplikacji kliknąć na link Click here to remove this application:

Następnie z serwera usunąć wraz z całą zawartością folder o nazwie admin/applications_addon/ips/convert/
Autorem tutoriala jest DawPi. Zabrania się kopiowania, powielania. W szczególności na inne fora bez zgody autora.
Tutorial wykonany dla www.forum.invisionize.pl
(lista konwerterów aktualna na dzień 11 XI 2009r.)

















