#-- 
#-- Opis tworzenia i wykorzystywania modulow w XdeFactor-ng
#--

  Zaczynajac pisac modul najpierw sprawdz, czy ktos juz nie napisal, lub nie
pisze takiego modulu. Nie ma sensu, aby kilka osob robilo to samo. Interfejs
modulu powinien byc w pelni niezalezny. Funkcja wywolujaca ten modul powinna 
miec jeden parametr, mianowicie wskaznik do struktury xdfConnModule, ktora 
jest przedstawiona i opisana w katalogu  '../xdefactor-ng/src/tools'. Jej 
nazwa powinna byc w stylu: 'moduleNazwa', np. moduleAbout. Komentarze 
w plikach zrodlowych powinny byc dostosowane do pakietu DOC++. Kiedy zrobisz 
juz odpowiedni modul, musisz stworzyc plik Makefile (przyklad takiego pliku 
mozesz  zobaczyc w dowolnym innym module) ktory skompiluje odpowiednio twoj 
modul. Plik .so  nalezy skopiowac do sciezki zawartej w '/etc/ld.so.conf' i 
wydac polecenie ldconfig.

Po tym zabiegu, musisz stworzyc jeszcze plik, ktory bedzie opisywal twoj modul.
Plik ten nazwij wg. przyjetej konwencji Nazwa.conf. Musisz zawrzec w nim kilka 
danych, oto przyklad takiego pliku:

#start
#nazwa funkcji, ktora wywoluje Twoj modul
name=moduleNazwa
#Twoje dane(tworca modulu), czyli imie i nazwisko, nick oraz jak zechcesz email
author=Jan Kowalski Kowal <jan@kowalski.pl>
#W jakim menu ma znalezc sie Twoj modul
#Do wyboru mamy cztery:
#1)Plik
#2)Dodatki
#3)Admin
#4)Pomoc
#U Ciebie bedzie to najczesciej Dodatki
menu=Dodatki
#Jak w tym menu ma byc widoczny Twoj modul
submenu=Fakturowanie
#Teraz co Twoj modul robi
about_module=Modul odpowiadajacy za wystawianie faktur VAT
#to juz koniec opisu twojego modulu

Po tym zabiegu masz juz calkowicie sprawny modul. Teraz zostalo tylko sprawic,
aby przy  nastepnym uruchomieniu XdeFactor-ng nasz modul byl widoczny 
w zakladce "Funkcje". 
Najpierw skopiuj Twoj plik Nazwa.conf do katalogu /etc/defactor-ng/x/modules.
Potem  nalezy wejsc do katalogu /etc/defactor-ng/x i otworzyc plik modules.conf.
Po ostatniej  linijce nalezy dopisac:

/modules/Nazwa.conf
libxdef_nazwa.so

Teraz juz mozesz uruchomic XdeFactor-ng u przetestowac swj modu.


  Powodzenia
	  XdeFactorTEAM

W razie problemow skontaktuj sie z:
				    armad@linuxindex.pl

lub po prostu wyslij mail'a na adres:
				    defactor-ng@vix.netsync.pl

