Ogólne informacje

System WebFirmatic można dostosować w następującym zakresie:

Logo programu WebFirmatic
Logo firmy
Style CSS dla całej aplikacji
Tytuł strony, stopka strony, meta informacje
Ikony
Ikona loadingu
Konfiguracja

W tym celu dostosowania należy skorzystać z następujących narzędzi:

Total Commander - odczyt archiwum war (http://totalcmd.pl/download/app/new/)
Notepad++ - edycja plików w kodowaniu UTF-8 (http://notepad-plus-plus.org/download/)

Dostosowanie polega na podmianie oryginalnych plików, dlatego konieczne jest zachowanie zgodnych nazw plików.

Tytuł strony i meta informacje

<head>
 
 
<meta http-equiv="content-type" content="text/html; charset=UTF-8"> 
<link type="text/css" rel="stylesheet" href="WebFirmatic.css"> 
<title>WebFirmatic</title>
 
 
<script type="text/javascript" language="javascript"
src="webfirmatic/webfirmatic.nocache.js">
</script> 
 
 
</head>

Znacznik head można modyfikować pozostawiając odwołanie script, bez niego aplikacja się nie załaduje. Znacznik title informuje o tytule strony, który pojawia się na pasku.

Stopka strony

<body>
<iframe src="javascript:''" id="__gwt_historyFrame" tabIndex='-1' style="position:absolute;width:0;height:0;border:0"></iframe>
<noscript>
<div style="width: 22em; position: absolute; left: 50%; margin-left: -11em; color: red;
background-color: white; border: 1px solid red; padding: 4px; font-family: sans-serif">
Your web browser must have JavaScript enabled
in order for this application to display correctly.
</div>
</noscript>
<div id="loginInfo"></div>
<div id="master"></div>
<div id="main"></div>
<div id="footer">
<p>To jest webowa wersja oprogramowania Firmatic</p>
</div>
</body>

Można dopisywać elementy do tego fragmentu pamiętając że div-y loginInfo, master, main i footer muszą pozostać. Bezpośrednio za stopkę odpowiedzialny jest znacznik p zagnieżdżony w div o id równym footer.

Ikony

Wszystkie ikony wyświetlane w toolbarze i koło przycisków znajdują się w katalogu icons. Nazwę i położenie tego katalogu można zmienić w konfiguracji.

Pliki ikon odczytywane są zgodnie z wartością EVENTKEY podawaną w xml-u, z pominięciem rozszerzenia. Aplikacja najpierw wyszukuje plik z rozszerzeniem GIF, później ICO, a na końcu PNG. Istnieje możliwość ustawienia domyślnej wartości wielkości pobieranej z pliku ICO – konfiguracja.

Ikona loadingu

Plik o nazwie loading.png znajduje się w głównym katalogu. Ikona ta jest wyświetlana podczas ładowania kolejnych stron oraz podczas logowania.

Konfiguracja

Plik o nazwie web.xml znajduje się w katalogu WEB-INF. Zawiera on konfigurację aplikacji. Część wpisów jest nieedytowalna i ma bardzo duże znaczenie dla poprawnego działanie aplikacji. Część edytowalna jest odpowiednio oznaczona komentarzami.

<!– –> <!– Początek: Konfiguracja edytowalna - parametry –> <!– –> 
 
 
<context-param>
 
<param-name>FirmPHPUrl</param-name> 
<param-value>http://fir.venco.com.pl/MJJr/firm.php//</param-value> 
</context-param> <context-param> 
<param-name>ProxyPHPUrl</param-name> 
<param-value>http://fir.venco.com.pl/MJJr/proxy.php</param-value> 
</context-param> <context-param> 
<param-name>XMLpath</param-name> 
<param-value>/WEB-INF/xmls/</param-value> 
</context-param> <context-param> 
<param-name>Iconpath</param-name> 
<param-value>/icons/</param-value> 
</context-param> <context-param> 
<param-name>debugMode</param-name> 
<param-value>yes</param-value> 
</context-param> <context-param> 
<param-name>refreshMs</param-name> 
<param-value>1000</param-value> 
</context-param> <context-param> 
<param-name>fileManagerUrl</param-name> 
<param-value>http://fir.venco.com.pl//</param-value> 
</context-param> <context-param> 
<param-name>FirmaticUrl</param-name> 
<param-value>fir.venco.com.pl</param-value> 
</context-param> <context-param> 
<param-name>iconDefaultSize</param-name> 
<param-value>24</param-value> 
</context-param> 
<!– –> <!– Koniec: Konfiguracja edytowalna - parametry –> <!– –>

Znaczenie parametrów zostało opisane w innym dokumencie.

Zakończenie zmian

Po podmianie odpowiednich plików w archiwum WAR, tak przygotowany plik można wgrywać na serwer. Należy pamiętać o odpowiednich ustawieniu ścieżek do plików firm.php i proxy.php, konfigurowanych w pliku web.xml.

Narzędzia użytkownika

Narzędzia witryny

Spis treści