<?xml version="1.0"?>
<!--
	Licensed to the Apache Software Foundation (ASF) under one or more
	contributor license agreements.  See the NOTICE file distributed with
	this work for additional information regarding copyright ownership.
	The ASF licenses this file to You under the Apache License, Version 2.0
	(the "License"); you may not use this file except in compliance with
	the License.  You may obtain a copy of the License at
	
	http://www.apache.org/licenses/LICENSE-2.0
	
	Unless required by applicable law or agreed to in writing, software
	distributed under the License is distributed on an "AS IS" BASIS,
	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	See the License for the specific language governing permissions and
	limitations under the License.
-->
<document>
	<properties>
		<title>Portlet Decorators</title>
		<subtitle>Customizing PortletDecorators</subtitle>
		<authors>
			<person name="David Sean Taylor" email="taylor@apache.org" />
		</authors>
	</properties>
	<body>
    <section name="Portlet Decorators">
      <p> 
      Each Jetspeed portlet window on a page can be associated with a different portlet decoration. 
      Portlet decorations control some important aspect of a portlet window:
      <ul>
      <li>The colors, images, CSS styles that skin this window</li>
      <li>The title portion of the portlet</li>
      <li>The borders of the window</li>
      <li>Action buttons displayed on the window</li>
      </ul>      
      Jetspeed comes with several portlet decorations out of the box. The default page decorator for 
      most pages is called <i>tigris</i>. It looks like this:
      </p>
      <img src="../images/tigris-portlet.png"/>
      <p>
      We are going to create a new decorator for this tutorial.
      This new decorator can be copied into our project from the <i>/JetspeedTutorial/resources/decorations/portlet/express-portlet/</i> directory.
      This will save you the trouble of creating all the logo images and CSS definitions.
      </p>
	 <source>
	 <![CDATA[
# Linux	 
cd /JetspeedTraining/workspace/jetexpress
mkdir portal/src/webapp/decorations/portlet/express-portlet
cp -r ../../resources/decorations/portlet/express-portlet/* portal/src/webapp/decorations/portlet/express-portlet/

# Windows
cd \JetspeedTraining\workspace\jetexpress
mkdir portal\src\webapp\decorations\portlet\express-portlet
xcopy /s ..\..\resources\decorations\portlet\express-portlet\* portal\src\webapp\decorations\portlet\express-portlet
     ]]>
     </source>	  	  
     <p>
     We are going to skip over the intricate details of portlet decorators, as page decorators are much more 
     important, as they set your organization's branding. Whereas the standard window decorators are good 
     enough for getting you started. Go ahead and review the content of our custom portlet decorator.
     You will see that the directory layout is the same as for page decorators. The decorator simply
     creates a new color variation on an existing window decorator.
	  </p>	      
	  <p>
	    <a href='page-decoration.html'>Previous</a> <a href='desktop-theme.html'>Next</a>
	  </p>	      	  
 </section>	  
</body>
</document>