<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<!-- 
Copyright (c) 2006. Centre for e-Science. Lancaster University. United Kingdom. 

 Licensed 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.
-->
<taglib>
	<tlib-version>1.0</tlib-version>
	<jsp-version>1.2</jsp-version>
	<short-name>b</short-name>
	<uri>http://e_science.lancs.ac.uk/sakai-blogger-tool</uri>
	<tag>
		<name>ouputPost</name>
		<tag-class>uk.ac.lancs.e_science.jsf.components.blogger.OutputPostTag</tag-class>
		<body-content>JSP</body-content>
		<attribute>
			<name>post</name>
		</attribute>
	</tag>
	<tag>
		<name>editPost</name>
		<tag-class>uk.ac.lancs.e_science.jsf.components.blogger.EditPostTag</tag-class>
		<body-content>JSP</body-content>
		<attribute>
			<name>post</name>
		</attribute>
		<attribute>
			<name>controller</name>
		</attribute>		
	</tag>	
	<tag>
		<name>postListing</name>
		<tag-class>uk.ac.lancs.e_science.jsf.components.blogger.PostListingTag</tag-class>
		<body-content>JSP</body-content>
		<attribute>
			<name>postListing</name>
			<required>true</required>
		</attribute>
		<attribute>
			<name>action</name>
			<required>false</required>
			<rtexprvalue>true</rtexprvalue>
		</attribute>		
	</tag>	
  <tag>
    <name>rich_text_area</name>
    <tag-class>uk.ac.lancs.e_science.jsf.components.blogger.tag.RichTextEditArea</tag-class>
    <body-content>JSP</body-content>
    <description>
    	<![CDATA[
    	Renders a WYSIWYG text editor. Allows the user to edit HTML formatted text.
    	The JavaScript widget is based on the open-source 
    	<a href="http://www.htmlarea.com/" target="_blank">HTMLArea</a> project.  
    	]]>
    </description>

    <attribute>
      <name>value</name>
      <required>false</required>
      <rtexprvalue>false</rtexprvalue>
      <description>
      </description>
    </attribute>

    <attribute>
      <name>binding</name>
      <required>false</required>
      <rtexprvalue>false</rtexprvalue>
      <description>
      </description>
    </attribute>
    
	<attribute>
	  <name>columns</name>
	  <required>false</required>
	  <rtexprvalue>false</rtexprvalue>
	  <description>
		 Number of columns in the textarea (in character units).  Complements the the 'width' attribute.
	  </description>
	</attribute>

	<attribute>
	  <name>rows</name>
	  <required>false</required>
	  <rtexprvalue>false</rtexprvalue>
	  <description>
		 Number of rows in the textarea (in character units).  Complements the 'height' attribute.
	  </description>
	</attribute>

    <attribute>
      <name>width</name>
      <required>false</required>
      <rtexprvalue>false</rtexprvalue>
      <description>
        Width of the widget (in pixel units).  Complements the 'columns' attribute.
      </description>
    </attribute>

    <attribute>
      <name>height</name>
      <required>false</required>
      <rtexprvalue>false</rtexprvalue>
      <description>
        Height of the widget (in pixel units).  Complements the 'rows' attribute.
      </description>
    </attribute>
    
    <attribute>
      <name>toolbarButtonRows</name>
      <required>false</required>
      <rtexprvalue>false</rtexprvalue>
      <description>
        Number of rows of buttons in the toolbar.  Defaults to 2.  Valid values are 0, 2, or 3.
      </description>
    </attribute>

    <attribute>
      <name>javascriptLibrary</name>
      <required>false</required>
      <rtexprvalue>false</rtexprvalue>
      <description>
             The URL to the directory of the HTMLArea JavaScript library.
             Defaults to the Sakai legacy customized HTMLArea.  May be a relative URL. 
      </description>
    </attribute>

    <attribute>
      <name>autoConfig</name>
      <required>false</required>
      <rtexprvalue>false</rtexprvalue>
      <description>
             Whether to recalculate the configuration - defaults to false.  If true,
             the width, height, and toolbarButtonRows will be recalculated based on 
             the values given.
      </description>
    </attribute>

    <attribute>
      <name>justArea</name>
      <required>false</required>
      <rtexprvalue>false</rtexprvalue>
      <description>
        <![CDATA[<strong>DEPRECATED</strong>]]> - use toolbarButtonRows=0 instead.  
        If true, the WYSIWYG toolbar is not shown.  The text is still editable.  
        Keyboard shortcuts for formatting (like Ctrl-B for bold) still work.
      </description>
    </attribute>
    <attribute>
      <name>onChange</name>
      <required>false</required>
      <rtexprvalue>false</rtexprvalue>
      <description>
		Name of the function to be executed when the user makes a change in the editor        
      </description>
    </attribute>  
    <attribute>
      <name>onSubmit</name>
      <required>false</required>
      <rtexprvalue>false</rtexprvalue>
      <description>
		Name of the function to be executed when the content of the html editor will be submited. The common situation
		is this function should return the same value as the onsubmit function managed by the form that wrap the html editor
      </description>
    </attribute>  
    </tag>
	
</taglib>