Integracja z CMS - Instalacja serwera i wtyczki dla CMS

JavuServer pozwala na integrację z systemami CMS:
Drupal, e107, Joomla, Mambo, PHP-Fusion, PHP-Nuke, PostNuke i XOOPS.

Integracja z systemem CMS adresowana jest do posiadaczy własnego serwera WWW (zwykle Apache+MySQL+PHP), gdyż integracja z systemem użytkowników możliwa jest tylko, gdy JavuServer pracuje na tym samym komputerze, co serwer WWW.

1. Rozpakować program

Program instaluje się rozpakowując gdziekolwiek plik zip, tar.gz, jest też instalator exe dla Windows.

2. Uruchomić program

Do uruchomienia potrzebna jest Java 1.4.2 lub nowsza, można ją pobrać z java.com.
Program uruchamia się klikając w javuserver.exe pod Windows, javuserver.sh pod Unixem, lub bezpośrednio w javuserver.jar.
Można też wpisać w linii poleceń: java -jar javuserver.jar

Program próbuje uruchomić okno z panelem administracyjnym, ale działa też w trybie tekstowym.
Jeżeli będzie uruchomiony pod Unixem bez X-Windows wyświetli po uruchomieniu adres, który należy wpisać do przeglądarki żeby otworzyć panel administracyjny w przeglądarce. Nie trzeba do tego niczego konfigurować program sam poszuka sobie wolnego portu dla wbudowanego serwera WWW.
Panel administracyjny w okienku:


Panel w przeglądarce:


Po pierwszym uruchomieniu pojawi się wizard ustawiający szybko najważniejsze opcje.
Nie trzeba robić tego zbyt uważnie, bo wszystkie opcje można później zmienić.
Opcje zapisywane są w pliku javuserver.ini, zawsze można go usunąć i zacząć konfigurację od początku.

W pierwszej kolejność ustawia się hasło admina dla panelu administracyjnego.

3. Integracja z CMS

Integracja z każdym obsługiwanym systemem CMS odbywa się tak samo, aktualnie (wersja 2.0.2) są to:
Drupal, e107, Joomla, Mambo, PHP-Fusion, PHP-Nuke, PostNuke i XOOPS.


Najpierw wybiera się z listy rodzaj instalacji, integracja z jednym z dostępnych CMS-ów, dowolną stroną PHP, lub samodzielny serwer WWW.
Można to później dowolnie zmieniać.

Po wybraniu integracji z którymś z CMS-ów należy wskazać programowi ścieżkę do katalogu, gdzie zainstalowany jest ten CMS.
W przypadku CMS-ów, które nie przechowują w konfigu adresu URL strony (e107, PHP-Fusion, PHP-Nuke, PostNuke), pojawi się też pole gdzie należy go wpisać.
Dalej program importuje ustawienia z pliku konfiguracyjnego.

Dalej program próbuje odczytać z konfiguracji CMS-a adres URL strony, należy tylko sprawdzić czy adres jest poprawny i kliknąć dalej. Jeżeli URL został wpisany już w poprzednim kroku to okno się nie pojawi.

Teraz po kliknięciu "dalej" nastąpi instalacja plugina
Strona (czyt. Apache+MySQL) powinna na tym etapie działać.
Program wygeneruje odpowiednią wtyczkę do CMS-a oraz wywoła skrypt PHP, który ją zainstaluje, dopisze też Gry & Czat do menu. Na końcu program weryfikuje treść strony, aby sprawdzić czy plugin działa właściwie.
Gdyby coś poszło nie tak wtyczka zostanie od razu automatycznie od-instalowana, wpisy w bazie i pliki usunięte.
Można wtedy jeszcze raz kliknąć dalej, jeżeli nie pomoże lepiej kliknąć wstecz i wybrać instalację z dowolną stroną PHP i zgłosić problem na feedback@programics.com.

Dalej wybieramy gry (najlepiej wszystkie) i dobieramy im skórki.

Dalej tworzymy swój baner, który będzie wyświetlany w grze.
Baner jest potrzebny, bo okienko z grą będzie zasłaniać stronę i reklamy na niej, a w gry można grać też przez komunikator JavuJavu i wtedy strona nie będzie widoczna tylko nasz baner.
Czas banera jest standardowo dzielony 50/50, druga połowa dla javujavu. Jeżeli ktoś czuje się bardzo pokrzywdzony takim podziałem można to indywidualnie zmienić.

Na koniec rejestracja w katalogu stron z grami Javu Web Directory.
Jest to opcjonalne, jeżeli nie chcemy w ogóle rejestrować można wybrać 'Ustaw ID, ale zarejestruj później' i wpisać wybrany ID. ID może być dowolny, ale najlepiej, aby był to po prostu adres strony np. moja.strona.com.pl
Jeżeli nie zarejestrujemy, serwer będzie normalnie działać tylko pojawi się na dole informacja że nie można zalogować do katalogu JWD i będzie wyświetlany tylko baner z tekstem javujavu.com, bo wszystkie inne są przechowywane w katalogu.

Potwierdzenie rejestracji
Jeżeli rejestrujemy ID serwera w katalogu JWD, zostanie wysłany email weryfikujący na wskazany w formularzu adres.
Adres nadawcy tej wiadomości będzie zawierać @javujavu.com lub @programics.com.
Aby potwierdzić rejestrację należy otworzyć w przeglądarce adres wskazany w wiadomości.

Instalacja zakończona

Po zakończeniu konfiguracji pojawia się normalny panel administracyjny z przyciskami start, stop i mnóstwem opcji, które można dowolnie zmieniać.
Po naciśnięciu 'Start serwera' strona z grami będzie już działać, można ją otworzyć klikając 'Otwórz stronę Gry & Czat'.
Jeżeli serwer był uruchomiony w trybie tekstowym i konfigurowany za pomocą przeglądarki, zamiast 'Start' należy kliknąć 'Restart'.

Na dole listy opcji która jest z lewej strony, są pozycje "Wtyczka integrująca", "Wtyczka dla ..." i "Autoryzacja użytkowników"

Na pierwszej z tych kart można zmienić typ instalacji, np. zintegrować z innym CMS-em.
Po zatwierdzeniu nowego wyboru stary plugin będzie od-instalowany.

Na karcie "Wtyczka dla ..." są przyciski "Instalacja", "Odinstalowanie" i "Odświeżenie plików" można w nie klikać dowolną ilość razy instalując i od-instalowując plugin.
Odświeżanie plików przydatne jest po zmianie plików językowych, modyfikacji skórki czy zestawu emotikon.
Po wybraniu innego CMS-a czy istotnych zmianach parametrów naszej strony warto przed instalacją wtyczki nacisnąć przycisk "Import ustawień z pliku konfiguracyjnego..."

Ostatnia karta pozwala zmienić sposób integracji gier z systemem użytkowników CMS. Do wyboru jest autoryzacja przez skrypt jj.php zainstalowany w katalogu plugina, który pobiera odpowiednie informacje z bazy oraz bezpośredni dostęp do bazy ale na dzisiaj (wersja 2.0.2) tylko dla MySQL.
Autoryzacja przez bazę działa szybciej, ale aby ją włączyć trzeba najpierw wrzucić driver JDBC do MySQL do katalogu javuserver/jar, aktualnie dostępny na mysql.com driver "mysql-connector-java-5.0.0-beta-bin.jar" działa poprawnie.

Każdy, kto chciałby program uruchomić na swojej stronie, a będzie miał jakiekolwiek problemy z instalacją, nie znalazł odpowiedniej wtyczki dla swojej wersji CMS, lub ma po prostu jakieś pytania techniczne może liczyć na pomoc autora (po polsku).
email: feedback@programics.com