Różnice między wybraną wersją a wersją aktualną.
|
webfirmatic_-_instrukcja_dostosowania_systemu [2012/10/08 14:31] 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> | + | |
| - | <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <link type="text/css" rel="stylesheet" href="WebFirmatic.css"> <title>WebFirmatic</title> | + | <code html4strict> |
| + | <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" | <script type="text/javascript" language="javascript" | ||
| src="webfirmatic/webfirmatic.nocache.js"> | src="webfirmatic/webfirmatic.nocache.js"> | ||
| </script> | </script> | ||
| - | </head>'' | + | |
| + | |||
| + | </head> | ||
| + | </code> | ||
| 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 ====== | ||
| + | |||
| + | |||
| + | <code html4strict> | ||
| + | <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> | ||
| + | </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. | ||
| + | |||
| + | |||
| + | ====== 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. | ||
| + | |||
| + | |||
| + | <code xml> | ||
| + | |||
| + | <!– –> <!– 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 –> <!– –> | ||
| + | </code> | ||
| + | |||
| + | |||
| + | 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.// | ||