Which version of Pluto should I use?

The latest release from the 1.1.x series is the current stable release. We recommend that you use this if you are looking for a stable release.

Pluto 2.x is currently under development. This is the reference implementation of JSR-286, the 2nd version of the Java Portlet Specification. Pluto 2.x requires the use of Java 5(a.k.a 1.5).

I've seen references to Pluto 1.0.0. What's the deal?

Pluto 1.0.x is based off of the code base which was originally donated to the ASF by IBM. The first release candidate in this series was published on October 8, 2004.

Around the same time that this release occured Pluto 1.1.0-ALPHA was imported into our source repository. The 1.1.x series is a refactoring/rewrite of Pluto. It's entire purpose is to simplify the container and make it easier for both Portlet Developers and Portal Developers looking to embed Pluto into their portal to use Pluto.

Now that Pluto 1.1.0 has been released, our team highly recommends that you migrate to it. Pluto 1.0.x development has been stagnant for some time and there are no plans to support it in the future. Pluto 1.1.x is also the basis for Pluto 2.x, which is the reference implementation for JSR-286 (Portlet 2.0).

Is Pluto an Enterprise Portal? No, the Pluto project aims to provide a Java Specification compliant Portlet Container. In order to support the container, the Pluto project provides a simple portal, however, this does not provides optional services such as single sign on. If you are looking for an Open Source enterprise Portal implementation, there are several available. Apache Jetspeed is an enterprise portal hosted by the Apache Software Foundation. Sakai and uPortal are both educational portals which utilize Pluto as their container. There are many other open source portals. What's the easiest way to include a portlet in my webapp

Simple, use the Pluto Portal Drivers "PortalDriverFilter". This allows you to embed a portlet directly into a jsp page. To use it, do the following:

Add the Portal Driver listener Configuration to your web.xml <listener> <listener-class>org.apache.pluto.driver.PortalStartupListener</listener-class> </listener>
Add the PortalDriverFilter configuration to your web.xml <filter> <filter-name>plutoPortalDriver</filter-name> <filter-class>org.apache.pluto.driver.PortalDriverFilter</filter-class> </filter> <filter-mapping> <filter-name>plutoPortalDriver</filter-name> <url-pattern>/about.jsp</url-pattern> </filter-mapping> <filter-mapping> <filter-name>plutoPortalDriver</filter-name> <url-pattern>/about.jsp/*</url-pattern> </filter-mapping>
Include the portlet (and perhaps some controls?) in your jsp. %@ taglib uri="http://portals.apache.org/pluto" prefix="pluto" % <pluto:portlet portletId="${portlet}"> <div class="portlet" id='>c:out value="${portlet}"/>'> <div class="header"> <h2 class="title"><pluto:title/></h2> </div> <div class="body"> <pluto:render/> </div> </div> </pluto:portlet>

How can I change the default encoding of the Pluto Portal

As of Pluto 1.1.5 you can change the default encoding of the Pluto Portal by editing the Pluto Portlet Servlet's web.xml. Add an init-param with the name of "charset" and set the value to the desired character set.

  <servlet>
    <servlet-name>plutoPortalDriver</servlet-name>
    <display-name>Pluto Portal Driver</display-name>
    <description>Pluto Portal Driver Controller</description>
    <servlet-class>org.apache.pluto.driver.PortalDriverServlet</servlet-class>
    <init-param>
      <param-name>charset</param-name>
      <param-value>UTF-8</param-value>
    </init-param>
  </servlet>

Do I need to have xml parsers in an endorsed classloader? (e.g.in Tomcat's 5.5 common/endorsed directory)

If you have installed Pluto 1.1.5 or greater, and are running on Java 5 or greater, then you do not need to endorse any XML libraries. Pluto will use JAXP.

The Pluto 1.1.x codebase targets Java 1.4, and so the bundled distribution of Pluto includes Tomcat with XML libraries in common/endorsed. Simply remove the XML libraries from common/endorsed if you meet the above requirements.