<!DOCTYPE reference SYSTEM "http://commons.omniupdate.com/dtd/standard.dtd">
<reference language="tagging">

	<tag contained="false" type="comment">
		<title>Editable Region Tag</title>
		<syntax>com.omniupdate.div</syntax>
		<description>
		<p>Defines an editable region.</p>
		</description>		
		<example>
		&lt;!-- com.omniupdate.div label="Text Full" group="Everyone" padding="3" button="106" bgcolor="white" border="#33FF00" break="break" --&gt;
		&lt;!-- /com.omniupdate.div --&gt;
		</example>
		<parameters>
			<parameter required="true">
				<title>label</title>
				<syntax>
					<attribute>label</attribute>
					<option>
						<value>unique name or id</value>
						<description>A unique-per-page identifier for a editable region.</description>
					</option>
				</syntax>					
				<description>
				<p>
				Name of tag (required, and must be unique per page). Never assign the same label name to multiple areas on the same page. Choose any name, but do not use any punctuation characters.
				</p>				
				</description>
			</parameter>
			<parameter required="true">
				<title>group</title>
				<syntax>
					<attribute>group</attribute>
					<option>
						<value>Everyone</value>
						<description>All users</description>					
					</option>
					<option>
						<value>group name</value>
						<description>A group name as configured within OmniUpdate's group setup.</description>
					</option>
				</syntax>					
				<description>
				<p>Editing group that can edit this area (Optional): The group identifies which group has access to edit the specific tagged area. If you do not include a group there will be no editing button shown — even for administrators. Level-9 and 10 users will only see the editing buttons on tagged areas that have a valid group defined. All other editors will only see the editing buttons on tagged areas that have a valid group defined — assuming they are also a member of the specified group.</p>
				<p>It is often helpful to use the default group "Everyone" for the main body area of the page, then unique groups such as "Side Navbar Editors" for the side navigation area and so on. Because the group "Everyone" contains all users you'll be able to quickly assign page access to any specific sub-group without changing the group tag in the code. Remember that only people assigned access to a page can access and edit that page — regardless of the "Group" assigned to selective areas.</p>
				<p>Note: to exclude individuals from gaining access to a specific area (such as a block of scripted code, image maps, or Java applets), simply tag the area and do not include the "Group".  This exclusionary method is very useful for areas you want to ensure are "hands-off" to all but administrative (Level-9 and 10) users.</p>
				</description>
			</parameter>	
			<parameter>
				<title>path</title>
				<syntax>
					<attribute>path</attribute>
					<option>
						<value>staging absolute path</value>
						<description>An absolute path relative to the root of the staging server.</description>
					</option>
				</syntax>					
				<description>
				<p>The path to the actual Include file: This must be an absolute link and begin with "/". Without the include tag you have a static area or inline area that occurs within the page itself.</p>
				</description>
			</parameter>	
			<parameter>
				<title>button</title>
				<syntax>button="102"</syntax>
				<syntax>
					<attribute>button</attribute>
					<option>
						<value>button id</value>
						<description>The id or name of a button. A list of buttons currently available can be found <a href="http://support.omniupdate.com/documentation/ox/implementation/pagetagging/buttons/">here</a>.</description>
					</option>
					<option>
						<value>hide</value>
						<description>Hide the button. This is used in conjunction with the multiedit tag, found <a href="/documentation/ox/10/implementation/pagetagging/reference/#com.omniupdate.multiedit">here</a>.</description>
					</option>
				</syntax>					
				<description>
				<p>Editing Graphic or Button type (Optional): Numeric value (list of buttons currently available can be found <a href="http://support.omniupdate.com/documentation/ox/implementation/pagetagging/buttons/">here</a>).  If the Button is not used, the default button graphic is displayed:<img src="http://www.omniupdate.com/resources/ox/images/editbutton/edit001.gif" alt="001" title="Button # 001"/></p>
				<p>New button graphics can also be added -- feel free to make a request.</p>
				</description>
			</parameter>	
			<parameter>
				<title>hide</title>
				<syntax>hide="true"</syntax>
				<syntax>
					<attribute>hide</attribute>
					<option>
						<value>yes</value>
					</option>
					<option>
						<value>true</value>
					</option>
					<option>
						<value>hide</value>
					</option>
				</syntax>					
				<description>
				<p>When used in conjunction with the <I>path</I> parameter, this parameter allows for omission of included text. Omit parameter for default behavior.</p>
				</description>
				
			</parameter>				
			<parameter>
				<title>position</title>
				<syntax>
					<attribute>position</attribute>
					<option>
						<value>bottom</value>
					</option>
					<option>
						<value>top</value>					
					</option>
				</syntax>					
				<description>
				<p>Position of button (Optional): The position allows you to specify the position of the button relative to the selective content area itself. The default behavior of the button is to position itself at the top of the editable content (just above the content), but it can be useful to force the button to follow directly after the content.  For instance, if the position's value is set to "bottom" and  you've assigned no "break" value (see above) then the actual position of the button will be to the right following the content.</p>
				</description>
			</parameter>	
			<parameter>
				<title>break</title>
				<syntax>
					<attribute>break</attribute>
					<option>
						<value>break</value>
					</option>
				</syntax>					
				<description>
				<p>Break after button (Optional): The break simply adds a carriage return (br) after the editing button. This is completely cosmetic, but can be very useful depending on the size of the button being used.</p>
				</description>
			</parameter>	
			<parameter>
				<title>border</title>
				<syntax>
					<attribute>border</attribute>
					<option>
						<value>color name</value>
						<description>Color name like green or red.</description>
					</option>
					<option>
						<value>color Hex</value>
						<description>Hexadecimal value for a color (#FF00CC).</description>					
					</option>
				</syntax>	
				<description>
				<p>Border color of editing area (Optional): Value of color can be a hex number (such as: "#FFFFFF") or the color name (such as: "white"). The border applies a colored rectangle surrounding the editable area. In the Gallena example above, the border color is set to purple in for the footer area and green in the main body text area.</p>
				</description>
			</parameter>	
			<parameter>
				<title>padding</title>
				<syntax>
					<attribute>padding</attribute>
					<option>
						<value>pixel number</value>
						<description>Padding in number of pixels</description>
					</option>
				</syntax>	
				<description>
				<p>Padding in pixels (Optional): Values in pixels, the padding adds space around  the tagged editable area. This padding is only visible within OmniUpdate during page editing.  When a "border" is used, the padding value will create a colored border surrounding the tagged area.</p>
				</description>
			</parameter>	
			<parameter>
				<title>bgcolor</title>
				<syntax>
					<attribute>bgcolor</attribute>
					<option>
						<value>color name</value>
						<description>Color name like green or red.</description>
					</option>
					<option>
						<value>color Hex</value>
						<description>Hexadecimal value for a color (#FF00CC).</description>					
					</option>
				</syntax>	
				<description>
				<p>Background color of editing area (Optional): Value of color can be a hex number (such as: "#FFFFFF") or the color name (such as: "white"). This applies a background color to the editable area. The bgcolor can be very helpful when there is an existing background color that you would like to match. This only affects the editable area when viewed within OmniUpdate.</p>
				</description>
			</parameter>	
		</parameters>	
	</tag>

	<tag contained="true" type="comment">
		<title>Editor Tag</title>
		<syntax>com.omniupdate.editor</syntax>
		<description>
		<p>Allows customization of various attributes of the WYSIWYG editor. <strong>Note:</strong> this tag does not require a closing equivalent.</p>
		</description>		
		<example>
		&lt;!-- com.omniupdate.editor csspath="/omnistyles/mainbodythird.css" cssmenu="/omnistyles/mainbody.txt" width="799" --&gt;
		</example>
		<parameters>
			<parameter>
				<title>csspath</title>
				<syntax>
					<attribute>csspath</attribute>
					<option>
						<value>production absolute path</value>
						<description>An absolute path relative to the root of the production server. Do not include a protocol or domain. (http://omniupdate.com)</description>
					</option>
				</syntax>				
				<description>
				<p>The csspath (optional) refers to a css file (absolute from the base of the web site) that is used within the editing area. It can include a body background image with margins.</p>
				</description>
			</parameter>
			<parameter>
				<title>cssmenu</title>
				<syntax>
					<attribute>cssmenu</attribute>
					<option>
						<value>production absolute path</value>
						<description>An absolute path relative to the root of the production server. Do not include a protocol or domain. (http://omniupdate.com)</description>
					</option>
				</syntax>				
				<description>
				<p>The cssmenu (optional) refers to a shortcut of CSS classes that are available to your users within the WYSIWYG editor (Please update the copy on the staging server for this.) This file will contain a short list of css classes that the user can select from.</p>
				<p>.special    special<br />
				.special2  special2<br />
				</p>
				<p>The .txt menu file is nothing more than the actual css style followed by the friendly name. In this example the style is ".special" (always with a period in front) and the friendly name "special" separated only by a tab. With a list of styles separate them with carriage returns. The file must be free of anything but carriage returns and tabs. It is much easier to keep track of things if the friendly name and the actual css style are the same.</p>
				</description>
			</parameter>	
			<parameter>
				<title>width</title>
				<syntax>
					<attribute>width</attribute>
					<option>
						<value>pixel number</value>
						<description>A numeric value representing the pixel width of the editor when loaded.</description>
					</option>
				</syntax>
				<description>
				<p>The width (optional) controls the width of the editor itself in pixels. This is useful when the page structure has a right border that you wish to represent while users are editing text areas.</p>
				</description>
			</parameter>	
			<parameter deprecated="true">
				<title>div</title>
				<syntax>
					<attribute>div</attribute>
					<option>
						<value>css class</value>
					</option>
				</syntax>
				<description>
				<p>Name DIV (optional) assigns a div to the editing area in the check out page screen within the OmniUpdate system.</p>
				#OUPreview{
				width:534px;
				}
				This class should be added to the CSS file for that editing area.
				</description>
			</parameter>	
			<parameter>
				<title>parag</title>
				<syntax>
					<attribute>parag</attribute>
					<option>
						<value>no</value>
						<description>The editor will use &lt;br&gt; instead of &lt;p&gt;</description>
					</option>
					<option default="true">
						<value>on</value>	
						<description>The editor will use &lt;p&gt; instead of &lt;br&gt;. (Note: Shift-Enter will insert &lt;br&gt; in editor.)</description>				
					</option>
				</syntax>				
				<description>
				<p>The paragraph (optional) - will force the editor to use &lt;br&gt; tags instead of using paragraph tags. This is useful for some heavily CSS driven areas like navigation files.</p>
				<p>NOTE: By default, paragraphs are turned "on".</p>
				</description>
			</parameter>	
			<parameter>
				<title>reflow</title>
				<syntax>
					<attribute>reflow</attribute>
					<option>
						<value>no</value>
						<description>Where the editor will leave the structure of the page alone.</description>
					</option>
					<option default="true">
						<value>yes</value>	
						<description>Where the editor will add structure to the page as described above.</description>				
					</option>
				</syntax>				
				<description>
				<p>The reflow (optional) - will force the editor to structure your page by adding line breaks to the code where necessary. This is useful to keep the code structured in a readable way. Having code crunched together without line breaks makes the code harder to read and harder to debug.</p>
				<p>NOTE: By default, reflow is turned "on".</p>
				</description>
			</parameter>	
			<parameter>
				<title>toolbar</title>
				<syntax>
					<attribute>toolbar</attribute>
					<option>
						<value>toolbar name</value>
					</option>
				</syntax>
				<description>
				<p>The toolbar (optional) - this will force a particular toolbar for an editing area.</p>
				<p>This will cause the page area to load with the toolbar named "toolbar_name" regardless of what level the user is or what toolbar is assigned to that user.</p>
				<p>NOTE: If this is not used, the editor will load the default toolbar for the user account - irrespective of user level.</p>
				</description>
			</parameter>	
			<parameter>
				<title>wysiwyg</title>
				<syntax>
					<attribute>wysiwyg</attribute>
					<option>
						<value>noie</value>
						<description>This will force the editor to load the applet editor even in Windows with Internet Explorer</description>
					</option>
					<option default="true">
						<value>yes</value>
						<description>This will force the editor to load the omnidev editor when the browser is Internet Explorer on Windows and the applet when it is not.</description>
					</option>
					<option>
						<value>no</value>
						<description>This will skip the editor altogether, loading the HTML editor.</description>
					</option>
				</syntax>
				<description>
				<p>The wysywig (optional) - this will force different types of editors for the editing area.</p>
				<p>NOTE: If this is not used, the editor loaded will be the default editor for the account. Accounts can be set up in the super admin (outside of the OmniUpdate system) to load particular editor types. </p>
				</description>
			</parameter>
			<parameter>
				<title>editor</title>
				<syntax>
					<attribute>editor</attribute>
					<option>
						<value>0</value>
						<description>ActiveX + EOPro</description>
					</option>
					<option>
						<value>1</value>
						<description>ActiveX</description>
					</option>
					<option>
						<value>2</value>
						<description>EOPro</description>
					</option>
					<option>
						<value>3</value>
						<description>OmniDev + EOPro</description>
					</option>
					<option>
						<value>4</value>
						<description>EditLive</description>
					</option>
					<option>
						<value>5</value>
						<description>OmniDev + EditLive</description>
					</option>		
					<option>
						<value>6</value>
						<description>Universal Editor v2 (IE,Fx) + v1 (Safari)</description>
					</option>																			
				</syntax>
				<description>
				<p>Provides the ability to specifically select a certain editor to be used to edit a region where it is defined.</p>
				</description>
			</parameter>	
		</parameters>	
	</tag>

	<tag contained="true" type="comment">
		<title>MultiEdit Tag</title>
		<syntax>com.omniupdate.multiedit</syntax>
		<description>
		<p>Multiedit tags are a special form of OmniUpdate Tag that allows a user to edit multiple content regions at one time on a page. A page can have several tags or a multiedit tag, or a combination of both </p>
                <p> Multiedit Tags are surrounded by OmniUpdate editable region tags with the button attribute set to hide or button number. Button attribute controls whether the user is presented the edit button in the preview screen or not. This allows the user to use both Multiedit as well as WYSIWYG editor for that editable region. Setting the button=”hide” will make the region only editable via Multiedit.</p>
                <p><strong>Note:</strong> : If a web page has MultiEdit tags, JustEdit is disabled automatically for that page.</p>
		</description>		
		<example>
		&lt;!-- com.omniupdate.multiedit type="Type" prompt="string" alt="string" -- &gt;
		</example>
		<parameters>
			
                            <parameter required="true">
				<title>type</title>
				  <syntax>                 
					<attribute>type</attribute>
                                        <option>
						<value>text</value>
						<description>Variable is simple text<br/>
                                                <p><b> Additional parameter:</b> maxlength(optional)- Specifies the maximum length of the variable. <br/>
                                                   <b>Example:</b> maxlength="50"
                                                </p></description>
                                        </option>
                                        <option>
						<value>textarea</value>
						<description>Text area is defined by user<br/>
                                                <p><b>Additional Parameter:</b> rows(optional) , editor="yes|no" <br/>
                                                <b>rows="No.of Rows" </b> - user can have any number of rows<br/>
                                                <b> editor="yes|no" </b> - provides the ability to use a editor to edit a region where it is defined<br/>
                                                <b>Example:</b> rows="50" editor="yes"
                                                </p> </description>
                                                
					</option>
                                        <option>
						<value>radio</value>
						<description>Variable is defined by user by choosing from a set of radio buttons. Variable will be the value of the user-selected option.<br/>
                                                <p><b>Additional Parameter:</b>options(required)-Specifies the options for the variable defined by user. Keys must have no spaces.Keys are shown in list. Values are what is submitted.<br/>
                                                <b>options="key1:value1;key2:value2;"</b><br/>
                                                <b>Example:</b> options="Morning:Morning; Noon:Noon; Evening:Evening;"
                                                </p></description>
                                                
					</option>
                                        <option>
						<value>checkbox</value>
						<description>Variable is defined by user by toggling the value of a checkbox. Variable will be the value of the user-selected option.<br/>
                                                <p><b>Additional Parameter:</b> options(required)-Specifies the options for the variable defined by user. Keys must have no spaces.Keys are shown in list. Values are what is submitted.<br/>
                                                <b>options="key1:value1;key2:value2;"</b><br/>
                                                <b>Example:</b> options="Morning:Morning; Noon:Noon; Evening:Evening;"
                                                </p></description>
					</option>
                                        <option>
						<value>select</value>
						<description>Variable is defined by user by choosing from a select-pull down. Variable will be the value of the user-selected option.<br/>
                                                <p><b>Additional Parameter:</b> options(required)-Specifies the options for the variable defined by user. Keys must have no spaces.Keys are shown in list. Values are what is submitted.<br/>
                                                <b>options="key1:value1;key2:value2;"</b><br/>
                                                <b>Example:</b> options="Morning:Morning; Noon:Noon; Evening:Evening;"
                                                </p> </description>
					</option>
                                        <option>
						<value>image</value>
						<description>Variable is defined by the user by defining the path where the image exists <br/>
                                                <p><b>Additional Parameter:</b> path(required),lockout(optional)<br/>
                                                <b>path="Path to a directory" </b> <br/>
                                                <b>lockout="yes|no" </b> - lockout="yes" will prevent the user from traversing outside the directory that has been set<br/>
                                                <b>Example:</b> path="/navigation/images" lockout="yes"                                           
                                                </p></description>
					</option>
                              </syntax>				
				<description>
				<p>Specify the type of the contents</p>
				</description>
                           </parameter>
                           <parameter required="true">
                              <title>prompt</title>
                                 <syntax>                 
					<attribute>prompt</attribute>
                                        <option>
						<value>string</value>
						
                                        </option>
                                </syntax>
                               <description>
				<p>The question posed to the user. It’s displayed on the left side of the user’s input text field. A colon (:) is automatically added to the end of this prompt. </p>
			       </description>
                           </parameter>
                            <parameter>
                              <title>alt</title>
                                 <syntax>                 
					<attribute>alt</attribute>
                                        <option>
						<value>string</value>
                                        </option>
                                        
                                </syntax>
                               <description>
				<p>Similar to the prompt parameter, alt gives more information about the input required in a text field. It's displayed to the right of the text box, and usually offers an example or more information. This field is not required, and defaults to null / not displayed.</p>
			       </description>
                           </parameter>
		</parameters>	
	</tag>

	<tag contained="false" type="comment">
		<title>Date Time Tag</title>
		<syntax>com.omniupdate.date</syntax>
		<description>
		<p>Date Time stamp. Can appear anywhere on the page but can only appear once per page (only the first one is processed.)</p>
		</description>		
		<example>
		&lt;!-- com.omniupdate.date type="datetime" style="short" --&gt;
		&lt;!-- /com.omniupdate.date --&gt;
		</example>
		<parameters>
			<parameter>
				<title>type</title>
				<syntax>
					<attribute>type</attribute>
					<option default="true">
						<value>datetime</value>
						<description></description>
					</option>
					<option>
						<value>date</value>
						<description></description>
					</option>
					<option>
						<value>time</value>
						<description></description>
					</option>
				</syntax>
				<description>
				<p>Specify the type of datetime stamp. datetime by default.</p>
				</description>
			</parameter>	
			<parameter>
				<title>style</title>
				<syntax>
					<attribute>style</attribute>
					<option>
						<value>full</value>
						<description>Tuesday, April 12, 1952 AD or 3:30:42pm PST</description>
					</option>
					<option>
						<value>long</value>
						<description>January 12, 1952 or 3:30:32pm</description>
					</option>
					<option>
						<value>medium</value>
						<description>Jan 12, 1952</description>
					</option>
					<option default="true">
						<value>short</value>
						<description>12.13.52 or 3:30pm</description>
					</option>
				</syntax>
				<description>
				<p>Style of the datetime stamp. short by default.</p>
				</description>
			</parameter>				
		</parameters>	
	</tag>

	<tag contained="false" type="comment">
		<title>Direct Entry/Login Tag</title>
		<syntax>com.omniupdate.ob</syntax>
		<description>
		<p>Direct entry or login button code is inserted by the system at the location of this tag at publish time. Cannot reside within an editable region tag.</p>
		</description>		
		<example>
		&lt;!-- com.omniupdate.ob --&gt;&lt;!-- /com.omniupdate.ob --&gt;
		</example>
		<parameters />
	</tag>
	
	<tag contained="true" type="comment">
		<title>Edit Full Page Tag</title>
		<syntax>com.omniupdate.efp</syntax>
		<description>
		<p>The placement of this tag provides control over where on a given page the edit full page source button should be placed. Useful on pages that rely heavily on CSS with absolute positioned and floated divs.</p>
		</description>		
		<example>
		&lt;!-- com.omniupdate.efp --&gt;
		</example>
		<parameters />
	</tag>	
	
	<tag contained="false" type="comment">
		<title>Properties Tag</title>
		<syntax>com.omniupdate.properties</syntax>
		<description>
		<p>The properties tag provides control over what metadata is editable in the <a href="/documentation/ox/10/interface/content/pages/pageproperties/">Properties Editor</a>. If correct functionality of the Properties Editor is required in PCFs, this tagging is required.</p>
		<p>Any meta data (HTML meta tags) within the properties tagging will appear within the Properties Editor.</p>
		</description>		
		<example>
      &lt;document&gt;<br />
      &lt;!-- com.omniupdate.properties --&gt;<br />
      &lt;title&gt;Properties Test&lt;/title&gt;<br />
      &lt;!-- /com.omniupdate.properties --&gt;<br />
      &lt;metadata&gt;<br />
      &lt;meta http-equiv="Content-Type" content="text/html; charset=utf-8" /&gt;<br />
      &lt;!-- com.omniupdate.properties --&gt;<br />
      &lt;meta name="keywords" content="keyword, keywords, keywords" /&gt;<br />
      &lt;meta name="description" content="This is a description." /&gt;<br />
      &lt;!-- /com.omniupdate.properties --&gt;<br />
      &lt;/metadata&gt;<br />
      &lt;/document&gt;<br />
		</example>
		<parameters />
	</tag>	
	
	
	
	
	
	<!--
		<tag>
		<title></title>
		<syntax></syntax>
		<description>
		
		</description>		
		<example>
		
		</example>
		<parameters>
			<parameter>
				<title></title>
				<syntax></syntax>
				<description>
				
				</description>
				<example>
				
				</example>
			</parameter>
			<parameter>
				<title></title>
				<syntax></syntax>
				<description>
				
				</description>
				<example>
				
				</example>
			</parameter>			
		</parameters>	
	</tag>
	
	-->

</reference>
