tutos-devel Mailing List for TUTOS

Hi list,

Here are some notes about the latest changes in the CVS tree.

As some of you might have noticed (see commit logs) I have introduced=20
something like a module concept in TUTOS.
This will allow a more independend development of additional features by=20
other developers (i.e. YOU).
As an example how this works you see a first module inside the=20
tutos/php/group subdirectory.

Here a first (brief) list of the things you have to know when writing mod=
ules=20
for TUTOS.

1. Best place for your module code is in a directory under tutos/php
   The name of directory,module and class inside the module should be the=
 same
   (hopefully other combinations will work but they were never tested by =
me)
2. register your module in modules.pinc and write create mconfig.pinc in =
your=20
modules directory. If you need additional Database table/indices etc crea=
te a=20
file mtable.pinc.
3. Your module class (modules are per definition classes !) should have t=
he=20
new tutos_module (fomr module_base.pinc) class as a parent
   This class defines the interface between TUTOS and its modules.
   There is a set of functions in every module, and these functions will =
be=20
called like hooks on different situations of the TUTOS page creation flow=
=2E
See the comments in the interface file (module_base.pinc)
4. Take care that the working directory in modules is differnt to the=20
classical TUTOS environment. That the reason for the=20
 $tutos['base'] =3D "../..";
 ini_set("include_path","..");
lines in top of every module file.
5. Modules will be initialized without including in the main TUTOS files.
  Just define the packages that need to know about your module in your=20
mconfig.pinc.  The loadmodules(PACKAGENAME) on top of  all displayable fi=
les=20
will take care about loading all modules that want to be loaded.
6. Translations: Its like in classical TUTOS. Create the files inside you=
r=20
module directory and TUTOS will find them.


OK. Please have a look on the changes. Test everything and give me feedba=
ck.


Some notes on the new module itself.=20
The group module will you allow to define "CRM groups" and add addresses=20
companies and department references to it. This way a user will have some=
=20
sorting criterias for his contacts.=20
Example:
Define a CRM Group   "Automotive" and add all your contacts form Automoti=
ve=20
Industry to this group.



Have fun, and please (!) give feedback

Gero