Hi, On Mon, Apr 7, 2008 at 11:36 AM, Marco Casavecchia Morganti <[EMAIL PROTECTED]> wrote: > Hello all, > I hope that my previous post were rejected by the moderator because of size > of the attachment. > > All I wanted to say was that i developed a new plugin. > It can include and transform external resources into xwiki pages. > > I used it to embed my pages with some external RSS feeds. > The plugin is based upon xsl transformations. > > I attach to this mail only the README included into the package. > > Tell me if you are intrested.
You should add you plugin on http://code.xwiki.org/xwiki/bin/view/Main/WebHome (Use "Add Plugin...") for everyone to be able to look at it and to write some description. > > Hope to be useful. > -- > By MCM. > > Hello, > > This is a simple plugin that lets you include an external content into any > xwiki page. Actually I used it to show external RSS contents into "dynamic" > panels. > > To work properly the plugin needs an XSL template that produces the desired > html code from the source content. > The "example" directory of this package countains a simple XSL stylesheet > that transform an RSS 2.0 feed into an html fragment. > > How to build it: > - A precompiled version (only for JDK 1.5) is available into the dist/lib > directory of the package. > > - you can build the whole project by typing: > ant -f ant/build.xml dist > > How to install: > - Copy all the jars from the "dist/lib" directory into the "WEB-INF/lib" > of > your XWiki installation. > > - Edit your "WEB-INF/xwiki.cfg" and add the following line into the > "xwiki.plugins" section: > com.xpn.xwiki.plugin.xsltransformer.XslURITransformerPlugin > > - At the end of the same file, append the following lines > (WEB-INF/xwiki.cfg) > #XSLTransormer Plugin configuration parameters > xwiki.xsluritransformer.debug=disabled > xwiki.xsluritransformer.connectiontimeout=15000 > xwiki.xsluritransformer.fallbackencoding=UTF-8 > > - Restart your XWiki > > How to use it: > - First of all you need a new Wiki page, so create it. > - Now you have to attach the "example/rss2xhtml.xsl" file to the page. > - Go to edit the page and add the following snippet code (change the uri > with something that works ;O): > > $xwiki.xslURITransformer.cachedTransformURI("http://rss.host/path/to/the/rssfeed.xml","http://your.wiki.host/xwiki/bin/download/path/to/the/attached/rss2xhtml.xsl";, > "900") > > - Save the page and enjoy the included and reformatted rss ;O) > > How does it works: > > The plugnin uses 2 http connections to fetch the source and the xsl (that i > often attach to the same page) and performs the transformation. > > It has 2 functions that performs the same work but in 2 different ways: > $xwiki.xslURITransformer.cachedTransformURI(SourceURI,XSLURI,Timeout) > $xwiki.xslURITransformer.transformURI(SourceURI,XSLURI) > > Common parameters: > The SourceURI parameter is the full URI of the resource that you want > include. > The XSLURI parameter is the full URI of the XSL stylesheet to use for the > transformation (if you followed my instructions you wil find it attached to > the page) > > The "normal" version performs all the tasks every time the page is viewed > (with lot of http traffic to fetch the resources and cpu usage for the > transformation). > > The "cached" version has an extra "timeout" parameter that specify the > amount of seconds to consider the resource as valid. > This function mantains an internal cache of the transformed resources and > send them back to the client without perform the whole work every time. > The resource is fetched again after it expires (with a great incement of > speed and a better memory usage). > > NOTE: This whole package is released under Apache License. > > PS: Sorry for my english.. > > By Marco Casavecchia M. > ([EMAIL PROTECTED]) > > _______________________________________________ > devs mailing list > [email protected] > http://lists.xwiki.org/mailman/listinfo/devs > > -- Thomas Mortagne _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
