Hi,
About documentation related to modules, there is:
http://doc.otrs.org/1.3/en/html/, chapter 24 and 25
It's 1.3, but I don't think there are that much differences with 2.0.
Another usefull link is http://dev.otrs.org/
Bert.
Daniel Dumitrache a écrit :
On Tuesday 07 March 2006 18:10, Denis Jedig wrote:
Greetings list,
I wonder where I can find a comprehensive documentation on how to
write and install modules in OTRS2.
yeah, that would be so nice :)
I made some efforts mimicing some of the simpler internal modules but
already ran into trouble by just renaming an existent module (namely
AgentTicketCustomer) and trying to incorporate it into the MenuModule
- it shows up in the ticket menu but calling the appropriate URL[1]
throws me a "Can't locate Kernel/Modules/myModule.pm in @INC (@INC
contains: ../../[..]"
I solved this by registering myModule in Kernel/Config/Files/
I did not perfectly understand where/how to register a module, but using
the existing registered modules I managed to do it.
For example, I have a module that displays/modify(+other sstuff) some
info on a customer, in Ticket.xml I copied the section for
AgentCustomerInfo, and modified it to fit myModule (mostly renaming
some xml keys/data). Here's an example, my module is named
AgentLiveCustomer :
$ grep -C 15 Live Ticket.xml
</Setting>
</ConfigItem>
<ConfigItem Name="Frontend::Module###AgentTicketZoom" Required="0"
Valid="1">
<Description Lang="en">Frontend module registration for the
AgentTicketZoom object in the agent interface.</Description>
<Description Lang="de">Frontendmodul-Registration des
AgentTicketZoom-Objekts im Agent-Interface.</Description>
<Group>Ticket</Group>
<SubGroup>Frontend::Agent::ModuleRegistration</SubGroup>
<Setting>
<FrontendModuleReg>
<Description>Ticket Zoom</Description>
<Title>Zoom</Title>
<NavBarName>Ticket</NavBarName>
</FrontendModuleReg>
</Setting>
</ConfigItem>
<ConfigItem Name="Frontend::Module###AgentLiveCustomer" Required="0"
Valid="1">
<Group>Ticket</Group>
<SubGroup>Frontend::Agent::ModuleRegistration</SubGroup>
<Setting>
<FrontendModuleReg>
<Description>AgentLiveCustomer</Description>
<Title>AgentLiveCustomer</Title>
<NavBarName>AgentLiveCustomer</NavBarName>
</FrontendModuleReg>
</Setting>
</ConfigItem>
<ConfigItem Name="Frontend::Module###AgentCustomerInfo" Required="0"
Valid="1">
<Group>Ticket</Group>
<SubGroup>Frontend::Agent::ModuleRegistration</SubGroup>
<Setting>
<FrontendModuleReg>
<Description>AgentCustomerInfo</Description>
<Title>AgentCustomerInfo</Title>
<NavBarName>AgentCustomerInfo</NavBarName>
</FrontendModuleReg>
</Setting>
</ConfigItem>
<ConfigItem Name="Frontend::Module###AgentTicketChat" Required="0"
Valid="1">
and I've done the same thing for some other modules in Ticket.xml and
Framework.xml, had no problems with it, it works
sometimes, after I manually edit one of the .xml files I must also
enable the new module from:
Admin->SysConfig->Ticket/Framework->Frontend::Admin/Agent::ModuleRegistration
I do not understand why this interface does not offer the possibility to
register new modules, only to edit already existing ones. It took me
some time until I figured out how to add new ones by editing the xml.
the modules you will want to add, most probably will be somehow similar
to existing ones (more or less), you should just grep
Kernel/Config/Files/ for the existing module, and register the new one
the same way the existing one is registered. this has always worked for
me :)
So I wondered about a bunch of questions:
- if INC contains relative paths, which directory are they relative
to? The one containing index.pl?
- where/how is INC assembled?
- why does it work for all kind of in-the-box modules but does not
work for "mine"?
- why can't I find any documentation on how to write new modules for
OTRS2?
Thanks for helping out.
[1] http://otrs/index.pl?Action=myModule&TicketID=10
--
Denis Jedig
syneticon networks GbR http://syneticon.net/service/
_______________________________________________
OTRS mailing list: dev - Webpage: http://otrs.org/
Archive: http://lists.otrs.org/pipermail/dev
To unsubscribe: http://lists.otrs.org/cgi-bin/listinfo/dev
_______________________________________________
OTRS mailing list: dev - Webpage: http://otrs.org/
Archive: http://lists.otrs.org/pipermail/dev
To unsubscribe: http://lists.otrs.org/cgi-bin/listinfo/dev
