# Używanie modułu InPageMonitorPHP

## Spis rzeczy

1. Opis
2. Instalacja
3. Podgląd

## Opis

InPageMonitor PHP jest witryną WWW, korzystającą z PHP, służącą do prezentacji podglądów stron, wygenerowanych przez wtyczkę InPageMonitor.

InPageMonitorPHP wymaga:

- Serwera FTP
- Serwera HTTP (WWW), obsługującego PHP w wersji 5 (np. Apache).

# Rys. 1: Konstrukcja pakietu InPageMonitor

Wtyczka programu InPageMonitor zapisuje podglądy stron na serwerze FTP, w odpowiednich folderach. Struktura tych folderów dostępna jest dla serwera WWW, dzięki czemu moduł InPageMonitor może czytać bezpośrednio z danych, jakie zostają przesłane do serwera FTP i wyświetlać je na stronach WWW.

## Instalacja

Struktura WWW:

    WWW root
       |
       |--- InPageMonitorPHP
       |  |
       |  |--- InPageMonitorConfiguration.php
       |  |
       |  |--- InPageMonitor.xml
       |
       |--- ftp_link
       |  |
       |  |--- (...)

Pakiet InPageMonitorPHP jest webaplikacją PHP. Jego instalacja sprowadza się do skopiowania folderu pakietu do folderu, który dostepny jest dla serwera WWW (np. folderu htdocs w serwerze Apache).

Po przekopiowaniu folderu InPageMonitorPHP do powyższego folderu, możliwe jest uruchomienie webapliakcji korzystając z przeglądarki WWW (Firefox/IE i inne), podając adres serwera WWW, na którym umieszczono pliki oraz folder, do którego wrzucono pliki, czyli np. http://localhost/InPageMonitorPHP.

InPageMonitorPHP wymaga instalacji - musi wygenerować 2 pliki:

- Plik konfiguracyjny InPageMonitor.xml, który będzie służył wtyczce programu InDesign.
- Plik konfiguracyjny InPageMonitorConfiguration.php, który będzie służył modułowi InPageMonitorPHP, zawierający informacje o położeniu podglądów stron, opcjach itd.

Zanim jednak można przystąpić do instalacji, niezbędne jest poprawne ustawienie serwera FTP. Należy utworzyć użytkownika z danym hasłem, nadać mu odpowiednie prawa oraz przypisać folder, do którego wtyczka InDesign'a InPageMonitor zapisaywać będzie za pośrednictwem serwera FTP pliki.

Następnie należy umieścić referencję do powyższego folderu1 (folderu prewek) gdzieś wewnątrz struktury plików serwera WWW tak, aby możliwe było odczytanie pogdlądu strony, przez przeglądarkę WWW.

Uwaga: Pod systemem Windows można utworzyć odnośnik do folderu wirtualnego, pamiętając o tym, by serwer WWW miał prawo czytać z takiego folderu.
Pod systemem MacOS, wystarczy utworzyć link symboliczny wewnątrz folderu htdocs serwera WWW komendą:
`ln -s [pełna ścieżka do folderu FTP z prewkami] prewki`
Taka komenda utworzy link do folderu wskazanego przez użytkownika i nada mu nazwę prewki. Folder ten będzie dostępny przez WWW pod adresem http://[adres twojego serwera]/prewki
Uwaga: Należy sprawdzić, czy struktura udostępnionego folderu FTP dostępna jest dla serwera WWW (np. skopiować coś przez FTP do udostępnionego folderu i sprawdzić w przeglądarce, czy jest on odczytywalny). Jeżeli InPageMonitorPHP nie będzie mieć dostępu do wyżej wymienionego folderu, nie będzie on działać.

Po poprawnym przygotowaniu folderu FTP, można przystąpić do konfiguracji samego InPageMonitor'a PHP. Wprowadzenie adresu w przeglądarce internetowej wskazującej na folder InPageMonitorPHP, użytkownik otrzyma okienko wyboru języka instalacji:

# Rys. 2: Wybór języka instalacji

## Opcje instalacji, dostyczące modułu InPageMonitorPHP:

# Rys. 3: Opcje instalacji 1

- Pełna ścieżka do folderu FTP jest ścieżką dostępu do struktury sewera FTP, którą chcemy udostępnić, np. C:\ścieżka do folderu FTP\prewki
- URL do folderu FTP jest adresem, względem głównego folderu "WWW" do linku symbolicznego (lub folderu wirtualnego) struktury FTP prewek (patrz okienko struktury, wg. tej struktury, ta wartość powinna być równa /ftp_link).
- Web folder wewnątrz folderu root serwera WWW to nazwa folderu InPageMonitora względem głównego folderu root serwera WWW, jeżeli folder InPageMonitor został skopiowany do głównego folderu root serwera WWW, ta wartość powinna byc równa InPageMonitorPHP.

Przykładowa konfiguracja WWW InPageMonitora PHP:

# Rys. 4: Przykładowa konfiguracja

## Opcje instalacji, dostyczące wtyczki InPageMonitor:

# Rys. 5: Opcje instalacji 2

- Plik xml konfiguracji wtyczki progamu InDesign to nazwa pliku, jaki instalator utworzy, konfigującego zachowanie wtyczki do programu InDesign. URL z tą nazwą wprowadzony musi być w do preferencji.
- Adres do serwera FTP w postaci:

      ftp://nazwa_uzytkownika:hasło_uzytkownika@server:port/ew_sciezka_do_folderu

Po kliknięciu przycisku Install instalator spróbuje wygenerować pliki. Jeżeli proces się nie powiedzie, użytkownik otrzyma informację, co ilustruje obrazek:

# Rys. 6: Błąd zapisu plików

W takiej sytuacji, należy dane pliki utworzyć ręcznie, korzystając z danych udostępnionych przez instalator.

Uwaga: Jeżeli wszystko poszło dobrze, zakończenie instalacji sprowadza się do skasowania folderu install z web folder InPageMonitorPHP.

## Podgląd

Wprowadzając adres w pole przeglądarki internetowej (np. http://nasz-serwer/InPageMonitorPHP/) otrzymamy widok prewek stron:

# Rys. 7: Gotowy podląd