Różnice między wybraną wersją a wersją aktualną.
webfirmatic_-_instrukcja_dostosowania_systemu [2012/10/08 14:35] marek |
webfirmatic_-_instrukcja_dostosowania_systemu [2012/10/08 14:57] (aktualna) marek |
||
---|---|---|---|
Linia 1: | Linia 1: | ||
====== Ogólne informacje ====== | ====== Ogólne informacje ====== | ||
+ | |||
System WebFirmatic można dostosować w następującym zakresie: | System WebFirmatic można dostosować w następującym zakresie: | ||
- | - Logo programu WebFirmatic | + | |
- | - Logo firmy | + | - Logo programu WebFirmatic |
- | - Style CSS dla całej aplikacji | + | - Logo firmy |
- | - Tytuł strony, stopka strony, meta informacje | + | - Style CSS dla całej aplikacji |
- | - Ikony | + | - Tytuł strony, stopka strony, meta informacje |
- | - Ikona loadingu | + | - Ikony |
- | - Konfiguracja | + | - Ikona loadingu |
+ | - Konfiguracja | ||
W tym celu dostosowania należy skorzystać z następujących narzędzi: | 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/) | + | - Total Commander - odczyt archiwum war ([[http://totalcmd.pl/download/app/new/|http://totalcmd.pl/download/app/new/]]) |
- | - | + | - Notepad++ - edycja plików w kodowaniu UTF-8 ([[http://notepad-plus-plus.org/download/|http://notepad-plus-plus.org/download/]]) |
+ | - | ||
+ | |||
Dostosowanie polega na podmianie oryginalnych plików, dlatego konieczne jest zachowanie zgodnych nazw plików. | Dostosowanie polega na podmianie oryginalnych plików, dlatego konieczne jest zachowanie zgodnych nazw plików. | ||
+ | |||
====== Tytuł strony i meta informacje ====== | ====== Tytuł strony i meta informacje ====== | ||
- | ''<head> | ||
+ | <code html4strict> | ||
+ | <head> | ||
+ | |||
+ | |||
<meta http-equiv="content-type" content="text/html; charset=UTF-8"> | <meta http-equiv="content-type" content="text/html; charset=UTF-8"> | ||
<link type="text/css" rel="stylesheet" href="WebFirmatic.css"> | <link type="text/css" rel="stylesheet" href="WebFirmatic.css"> | ||
<title>WebFirmatic</title> | <title>WebFirmatic</title> | ||
+ | |||
+ | |||
<script type="text/javascript" language="javascript" | <script type="text/javascript" language="javascript" | ||
src="webfirmatic/webfirmatic.nocache.js"> | src="webfirmatic/webfirmatic.nocache.js"> | ||
</script> | </script> | ||
+ | |||
+ | |||
+ | </head> | ||
+ | </code> | ||
- | </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. | 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 ====== | ====== Stopka strony ====== | ||
+ | |||
+ | <code html4strict> | ||
<body> | <body> | ||
<iframe src="javascript:''" id="__gwt_historyFrame" tabIndex='-1' style="position:absolute;width:0;height:0;border:0"></iframe> | <iframe src="javascript:''" id="__gwt_historyFrame" tabIndex='-1' style="position:absolute;width:0;height:0;border:0"></iframe> | ||
Linia 52: | Linia 69: | ||
</div> | </div> | ||
</body> | </body> | ||
+ | </code> | ||
+ | |||
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. | 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 ====== | ====== 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. | 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. | ||
- | Nubitech • Katowice • tel. 794 924 897 • e-mail: biuro@nubitech.pl • www.nubitech.pl | + | |
- | + | ||
- | + | ||
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. | 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 loadingu ====== |
- | Ikona ta jest wyświetlana podczas ładowania kolejnych stron oraz podczas logowania. | + | |
+ | |||
+ | Plik o nazwie loading.png znajduje się w głównym katalogu. Ikona ta jest wyświetlana podczas ładowania kolejnych stron oraz podczas logowania. | ||
+ | |||
+ | |||
+ | ====== Konfiguracja ====== | ||
- | 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. | 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> | + | <code xml> |
- | <param-name>FirmPHPUrl</param-name> | + | <!– –> <!– Początek: Konfiguracja edytowalna - parametry –> <!– –> |
- | <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> | <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 --> <!-- --> | ||
- | |||
+ | <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 –> <!– –> | ||
+ | </code> | ||
+ | |||
+ | |||
Znaczenie parametrów zostało opisane w innym dokumencie. | 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. | ||
+ | ====== 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.// | ||