#-- 
#-- 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 wywloujaca 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++(artykul o DOC++, bedzie dostepny na CVS pod koniec lipca lub na poczatku sierpnia 2002). 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 zabiego 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 maz juz calkowicie sprawny modul. Teraz zostalo tylko sprawic, aby przy nastepnym uruchomieniu XdeFactor-ng nasz modul byl widoczny w zakladce Dodatki. 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
