= Escenic Plugin Tips =

== Forum Plug-in ==

=== XML Import ===

__Import configuration__

In your Escenic's localconfig, define two additional handlers for Forum and Posting imports:

''!ForumImportHandler.properties'' :
{{{
$class=com.escenic.forum.ForumImportHandler
}}}
''!PostingImportHandler.properties'' :
{{{
$class=com.escenic.forum.PostingImportHandler
}}}

Then, add these handlers to your import handler:

''!ImportHandler.properties'' :
{{{
..
importHandlers=/import/relatedReactions/ForumImportHandler, \
               /import/relatedReactions/PostingImportHandler
..
}}}
(possibly add more handlers to this chain)

__XML format__
You can import postings into a forum using this XML format:

{{{
<forum source="" sourceid="" type="<type of forum>" state="" articleType="" publishDate="">
</forum>

<posting source="" sourceid="" type="<type of forum>" state="" articleType="" publishDate="">
  <forum id="" dbid="" source="" sourceid=""/>
  <parent id="" dbid="" source="" sourceid=""/><!--if not defined, posting is a thread -->
</posting>
}}}

The 'articleType' attribute defines which articleType is used for this forum or posting (probably just 'forum' and 'posting' by default).

Both the <forum> and <posting> tags support all tags allowed in the <article> tag.

The valid forum types are "normal" and "qa".

Note that the 'id' attribute to the <forum> and <posting> tags are local to this XML file. If you are importing to an existing forum, use the forum's id in the 'dbid' attribute, or use the 'source/sourceid' attributes.

== Adding your own plug-in ==

See the attached simplePlugin.jar below for an example of how to add a plug-in page (JSP) to Escenic Web Studio (4.1-4.2). This plug-in does nothing, but it shows how to add a page to the "Components" menu.


== EAE/Statistics "Plug-in" (Tested with version 2.0-7) ==

=== Maintenance service ===

__Extra index for MySQL__
{{{
create index PageviewIdx3 on Pageview (
  objId desc, type asc
);
}}}
__Benefits__
Reduces the "Maintenance service" Query_time unbelievable :) 
(From 3-4 Hours to a couple of seconds in my case...)

Edward Fjellskål 21. Feb 2008