Author: julien(a)jboss.com Date: 2007-02-12 17:28:08 -0500 (Mon, 12 Feb 2007) New Revision: 6232 Modified: docs/trunk/referenceGuide/en/modules/xmldescriptors.xml Log: update descriptor section to update with new DTDs Modified: docs/trunk/referenceGuide/en/modules/xmldescriptors.xml =================================================================== --- docs/trunk/referenceGuide/en/modules/xmldescriptors.xml 2007-02-12 22:15:50 UTC (rev 6231) +++ docs/trunk/referenceGuide/en/modules/xmldescriptors.xml 2007-02-12 22:28:08 UTC (rev 6232) @@ -29,10 +29,13 @@ . <programlisting><![CDATA[ <?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE deployments PUBLIC + "-//JBoss Portal//DTD Portal Object 2.6//EN" + "http://www.jboss.org/portal/dtd/portal-object_2_6.dtd"> <deployments> <deployment> + <parent-ref>default.default</parent-ref> <if-exists>overwrite</if-exists> - <parent-ref>default.default</parent-ref> <window> <window-name>HelloWorldJSPPortletWindow</window-name> <instance-ref>HelloWorldJSPPortletInstance</instance-ref> @@ -149,6 +152,9 @@ from McDonalds announcements. <programlisting><![CDATA[ <?xml version="1.0" standalone="yes"?> +<!DOCTYPE deployments PUBLIC + "-//JBoss Portal//DTD Portlet Instances 2.6//EN" + "http://www.jboss.org/portal/dtd/portlet-instances_2_6.dtd"> <deployments> <deployment> <instance> @@ -166,8 +172,8 @@ </preferences> <security-constraint> <policy-permission> + <action-name>view</action-name> <unchecked/> - <action-name>view</action-name> </policy-permission> </security-constraint> </instance> @@ -188,8 +194,8 @@ </preferences> <security-constraint> <policy-permission> + <action-name>view</action-name> <unchecked/> - <action-name>view</action-name> </policy-permission> </security-constraint> </instance> @@ -260,8 +266,8 @@ <para> <programlisting><![CDATA[<security-constraint> <policy-permission> + <action-name>viewrecursive</action-name> <unchecked/> - <action-name>viewrecursive</action-name> </policy-permission> </security-constraint>]]></programlisting> The security contraint portion is worth taking a look at, in an isolated fashion. It allows you to @@ -323,11 +329,15 @@ <title>Injecting Header Content</title> <para> <programlisting><![CDATA[ +<?xml version="1.0" standalone="yes"?> +<!DOCTYPE portlet-app PUBLIC + "-//JBoss Portal//DTD JBoss Portlet 2.6//EN" + "http://www.jboss.org/portal/dtd/jboss-portlet_2_6.dtd"> <portlet-app> <portlet> <portlet-name>ManagementPortlet</portlet-name> <header-content> - <link rel="stylesheet" type="text/css" href="/images/management/management.css" title="" media="screen"/> + <link rel="stylesheet" type="text/css" href="/images/management/management.css" media="screen"/> </header-content> </portlet> </portlet-app>]]></programlisting> @@ -339,6 +349,10 @@ <title>Injecting Services in the portlet context</title> <para> <programlisting><![CDATA[ +<?xml version="1.0" standalone="yes"?> +<!DOCTYPE portlet-app PUBLIC + "-//JBoss Portal//DTD JBoss Portlet 2.6//EN" + "http://www.jboss.org/portal/dtd/jboss-portlet_2_6.dtd"> <portlet-app> <service> <service-name>UserModule</service-name> @@ -436,8 +450,7 @@ </listitem> <listitem> <para> - <programlisting> - <![CDATA[<init-param><name>...</name><value>...</value></init-param>]]></programlisting> + <programlisting><![CDATA[<init-param><name>...</name><value>...</value></init-param>]]></programlisting> Using the <emphasis>init-param</emphasis> tag, you can specify initialization parameters to create initial state inside your portlet class. @@ -557,8 +570,7 @@ <user-name>portal</user-name> <password>portalpassword</password> </local-tx-datasource> -</datasources> - ]]></programlisting> +</datasources>]]></programlisting> Please verify that the username, password, url, and driver-class are correct for your flavor of DB. </para> @@ -625,25 +637,28 @@ <emphasis>helloworldportalpage.war/WEB-INF/</emphasis> , and it looks like this: <programlisting><![CDATA[<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE deployments PUBLIC + "-//JBoss Portal//DTD Portal Object 2.6//EN" + "http://www.jboss.org/portal/dtd/portal-object_2_6.dtd"> <deployments> <deployment> + <parent-ref>default</parent-ref> <if-exists>overwrite</if-exists> - <parent-ref>default</parent-ref> <properties/> <page> <page-name>MyPage</page-name> + <security-constraint> + <policy-permission> + <action-name>viewrecursive</action-name> + <unchecked/> + </policy-permission> + </security-constraint> <window> <window-name>HelloWorldPortletPageWindow</window-name> <instance-ref>HelloWorldPortletPageInstance</instance-ref> <region>center</region> <height>0</height> </window> - <security-constraint> - <policy-permission> - <unchecked/> - <action-name>viewrecursive</action-name> - </policy-permission> - </security-constraint> </page> </deployment> </deployments>]]> @@ -732,8 +747,8 @@ <para> <programlisting><![CDATA[<security-constraint> <policy-permission> + <action-name>viewrecursive</action-name> <unchecked/> - <action-name>viewrecursive</action-name> </policy-permission> </security-constraint>]]></programlisting> The security contraint portion is worth taking a look at, in an isolated fashion. It allows you to @@ -794,12 +809,25 @@ , and it looks like this: <programlisting><![CDATA[ <?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE deployments PUBLIC + "-//JBoss Portal//DTD Portal Object 2.6//EN" + "http://www.jboss.org/portal/dtd/portal-object_2_6.dtd"> <deployments> <deployment> <parent-ref/> <if-exists>overwrite</if-exists> <portal> <portal-name>HelloPortal</portal-name> + <supported-modes> + <mode>view</mode> + <mode>edit</mode> + <mode>help</mode> + </supported-modes> + <supported-window-states> + <window-state>normal</window-state> + <window-state>minimized</window-state> + <window-state>maximized</window-state> + </supported-window-states> <properties> <!-- Set the layout for the default portal --> <!-- see also portal-layouts.xml --> @@ -826,57 +854,46 @@ <value>maximizedRegion</value> </property> </properties> - <supported-modes> - <mode>view</mode> - <mode>edit</mode> - <mode>help</mode> - </supported-modes> - <supported-window-states> - <window-state>normal</window-state> - <window-state>minimized</window-state> - <window-state>maximized</window-state> - </supported-window-states> + <security-constraint> + <policy-permission> + <action-name>personalizerecursive</action-name> + <unchecked/> + </policy-permission> + </security-constraint> <page> <page-name>default</page-name> - <properties/> + <security-constraint> + <policy-permission> + <action-name>viewrecursive</action-name> + <unchecked/> + </policy-permission> + </security-constraint> <window> <window-name>MyPortletWindow</window-name> <instance-ref>MyPortletInstance</instance-ref> <region>center</region> <height>0</height> </window> - <security-constraint> - <policy-permission> - <unchecked/> - <action-name>viewrecursive</action-name> - </policy-permission> - </security-constraint> </page> - <security-constraint> - <policy-permission> - <unchecked/> - <action-name>personalizerecursive</action-name> - </policy-permission> - </security-constraint> </portal> </deployment> <deployment> + <parent-ref>HelloPortal</parent-ref> <if-exists>overwrite</if-exists> - <parent-ref>HelloPortal</parent-ref> <page> <page-name>foobar</page-name> + <security-constraint> + <policy-permission> + <action-name>viewrecursive</action-name> + <unchecked/> + </policy-permission> + </security-constraint> <window> <window-name>MyPortletWindow</window-name> <instance-ref>MyPortletInstance</instance-ref> <region>center</region> <height>0</height> </window> - <security-constraint> - <policy-permission> - <unchecked/> - <action-name>viewrecursive</action-name> - </policy-permission> - </security-constraint> </page> </deployment> </deployments>]]>