Author: taylor
Date: Tue May 8 09:13:36 2007
New Revision: 536240
URL: http://svn.apache.org/viewvc?view=rev&rev=536240
Log:
completion of subsite documentation
add portlet selector to the subsite tree
Added:
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/folder.metadata
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/portlet-selector.psml
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/selector.psml
portals/jetspeed-2/trunk/xdocs/guides/images/user-profile.jpg (with props)
Removed:
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/customizer.psml
Modified:
portals/jetspeed-2/trunk/xdocs/guides/guide-profiler.xml
portals/jetspeed-2/trunk/xdocs/guides/guide-subsites.xml
Added:
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/folder.metadata
URL:
http://svn.apache.org/viewvc/portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/folder.metadata?view=auto&rev=536240
==============================================================================
---
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/folder.metadata
(added)
+++
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/folder.metadata
Tue May 8 09:13:36 2007
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+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.
+-->
+<folder hidden="true"
+ xmlns="http://portals.apache.org/jetspeed";
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+ xsi:schemaLocation="http://portals.apache.org/jetspeed
http://portals.apache.org/jetspeed-2/2.1/schemas/folder-metadata.xsd";>
+ <security-constraints>
+ <security-constraints-ref>AEUV</security-constraints-ref>
+ </security-constraints>
+</folder>
Added:
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/portlet-selector.psml
URL:
http://svn.apache.org/viewvc/portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/portlet-selector.psml?view=auto&rev=536240
==============================================================================
---
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/portlet-selector.psml
(added)
+++
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/portlet-selector.psml
Tue May 8 09:13:36 2007
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+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.
+-->
+<page id="j2-portlet-selector" hidden='true'
+ xmlns="http://portals.apache.org/jetspeed";
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+ xsi:schemaLocation="http://portals.apache.org/jetspeed
http://portals.apache.org/jetspeed-2/2.1/schemas/psml.xsd";>
+ <defaults
+ layout-decorator="simple"
+ portlet-decorator="clear"
+ />
+ <title>Portlet Selector</title>
+ <metadata name="title"
xml:lang="ja">ãã¼ãã¬ããã»ã¬ã¯ã¿</metadata>
+ <metadata name="title" xml:lang="es">Selector de portlets</metadata>
+ <metadata name="title" xml:lang="zh">Portletéæ©å¨</metadata>
+ <metadata name="title" xml:lang="zh-TW">Portleté¸æå¨</metadata>
+ <metadata name="title" xml:lang="ko">í¬í릿 ì í</metadata>
+
+ <fragment id="ss-portlet-selector" type="layout"
name="jetspeed-layouts::VelocityOneColumnNoActions">
+ <fragment id="ss-portlet-selector-1" type="portlet"
name="j2-admin::PortletSelector" >
+ </fragment>
+ </fragment>
+</page>
Added:
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/selector.psml
URL:
http://svn.apache.org/viewvc/portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/selector.psml?view=auto&rev=536240
==============================================================================
---
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/selector.psml
(added)
+++
portals/jetspeed-2/trunk/src/webapp/WEB-INF/pages/__subsite-root/system/customizer/selector.psml
Tue May 8 09:13:36 2007
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+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.
+-->
+<page id="Selector.psml" hidden="true"
+ xmlns="http://portals.apache.org/jetspeed";
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+ xsi:schemaLocation="http://portals.apache.org/jetspeed
http://portals.apache.org/jetspeed-2/2.1/schemas/psml.xsd";>
+ <defaults layout-decorator="tigris" portlet-decorator="tigris"/>
+ <title>Selector</title>
+ <short-title>Selector</short-title>
+ <fragment id="ss-js-cp-selector" type="layout"
name="jetspeed-layouts::VelocityOneColumn">
+ <fragment id="ss-js-cp-selector.2" type="portlet"
name="j2-admin::CategoryPortletSelector"/>
+ </fragment>
+</page>
Modified: portals/jetspeed-2/trunk/xdocs/guides/guide-profiler.xml
URL:
http://svn.apache.org/viewvc/portals/jetspeed-2/trunk/xdocs/guides/guide-profiler.xml?view=diff&rev=536240&r1=536239&r2=536240
==============================================================================
--- portals/jetspeed-2/trunk/xdocs/guides/guide-profiler.xml (original)
+++ portals/jetspeed-2/trunk/xdocs/guides/guide-profiler.xml Tue May 8
09:13:36 2007
@@ -237,6 +237,14 @@
<td>resolve by matching the browser's (client) user agent from the
request context device capabilities (originating from the HTML headers)</td>
</tr>
<tr>
+ <td>hostname</td>
+ <td>resolve by matching the host name from the server name in the
request, returning the host name</td>
+ </tr>
+ <tr>
+ <td>domain</td>
+ <td>resolve by matching the domain from the server name in the
request, returning the domain</td>
+ </tr>
+ <tr>
<td>navigation</td>
<td>A directive to changes the current navigation path during a
profile location resolution performed by the page manager. The value can be the
location of a folder, for example <quote>/pages/freecontent</quote></td>
</tr>
Modified: portals/jetspeed-2/trunk/xdocs/guides/guide-subsites.xml
URL:
http://svn.apache.org/viewvc/portals/jetspeed-2/trunk/xdocs/guides/guide-subsites.xml?view=diff&rev=536240&r1=536239&r2=536240
==============================================================================
--- portals/jetspeed-2/trunk/xdocs/guides/guide-subsites.xml (original)
+++ portals/jetspeed-2/trunk/xdocs/guides/guide-subsites.xml Tue May 8
09:13:36 2007
@@ -176,7 +176,7 @@
<tr><td>navigation-2</td><td>navigation</td><td>subsite-root</td><td>When a
page is not found under the user directory, we start over and navigate back to
the subsite root.</td></tr>
<tr><td>hostname</td><td>hostname</td><td>(provided at runtime)</td><td>Then
again navigate to the _hostname directory</td></tr>
<tr><td>role</td><td>role</td><td>(provided at runtime)</td><td>Navigate to
each role directory of the given user until we find the page. For example, for
a role named "role1", navigate to the control directory
/__subsite-root/_hostname/role, and then to the subdirectory matching each
runtime _role parameters. If the runtime _role parameter is only "role1", then
the physical location is
/__subsite-root/_hostname/localhost/_role/role1.</td></tr>
-<tr><td>path</td><td>path</td><td>home</td><td>This is a constant used in all
calculations, the path portion of the URL, such as home.psml, or
/accounting/worksheet.psml. It is always appended to the calculated path to
give the complete physical address of the page.</td></tr>
+<tr><td>path</td><td>path</td><td>home</td><td>This is a constant used in all
calculations, the path portion of the URL, such as home.psml, or
/accounting/worksheet.psml. It is always appended to the calculated path to
give the complete physical address of the page. In the case where there is no
page specified, the default value provided in the rule "home" is used, and that
actually maps to "home.psml" as the default page extensions.</td></tr>
</table>
<p>
The screenshot below shows the directory tree for a <i>localhost</i> subsite.
@@ -238,21 +238,76 @@
<subsection name='Associated Rules with Users'>
<p>
All users are either explicity or implicity associated with a profiling rule.
+The User Administration utility has a tab to setup the profiling rule
associated with a user:
</p>
+<img src='images/user-profile.jpg' border="0"/>
+<p>
+Additionally, you can associate users with profiling rules in the XML seed
data configuration:
+</p>
+ <source>
+ <![CDATA[
+<Users>
+...
+<User name="jetspeed">
+ <credentials password="jetspeed" enabled="TRUE" requiresUpdate="FALSE"/>
+ <roles>manager</roles>
+ <groups>engineering</groups>
+ <preferences/>
+ <userinfo/>
+ <Rules>
+ <Rule locator="menu" rule="role-group"/>
+ <Rule locator="page" rule="role-fallback"/>
+ </Rules>
+</User>
+</Users>
+]]>
+</source>
+<p>Looking at the <b>Rule</b> element of a User, the locator can be either:</p>
+<ul>
+<li>page - use associated profiling rule to locate pages</li>
+<li>menu - use the associated profiling rule to locate menus (if not
specified, use the page locator)</li>
+</ul>
+<p>The <b>rule</b> attribute on the <b>Rule</b> element of a User defines
which profiling rule is associated to either a page or menu locator.
+If a user is not associated with a locator, then there is a system wide
locator configured in the Spring configuration file <i>profiler.xml</i>.
+See the contructor-arg of index = 1. This locator is the default locator,
system-wide, for when there is no-associated profiling rule.
+Normally, profiling rules are associated with user during activities such as
the creation of new users with the User Administration portlet,
+or during new user registration.
+</p>
+<source>
+<![CDATA[
+<beans>
+ <!-- Profiler -->
+ <bean id="profilerImpl"
class="org.apache.jetspeed.profiler.impl.JetspeedProfilerImpl"
init-method="init">
+ <constructor-arg index="0">
+ <value>JETSPEED-INF/ojb/profiler_repository.xml</value>
+ </constructor-arg>
+ <constructor-arg index="1">
+ <value>j2</value>
+ </constructor-arg>
+ ....
+]]>
+</source>
</subsection>
</section>
<section name="Hostname Profiling Rule Configuration">
<p>
- There is an option for hostnames to use the entire hostname or a
prefix.
+There is an option for hostnames to use the entire hostname or a prefix.
+This is configured in the Spring configuration file <i>profiler.xml</i>.
</p>
- <source test="">
- <![CDATA[
+ <source>
+ <![CDATA[
+ <bean id='HostnameCriterionResolver'
class='org.apache.jetspeed.profiler.rules.impl.HostnameCriterionResolver'>
+ <!-- use the dot prefix, for ex: "accounting.xyz.com" returns
"accounting" -->
+ <constructor-arg type="boolean" index="0">
+ <value>false</value>
+ </constructor-arg>
+ </bean>
]]>
</source>
<p>
- </p>
-
+By settting the prefix boolean argument to true, the hostname resolve will
only look at the prefix of the hostname.
+For example, with the dot prefix flag set to true, a hostname of
"accounting.xyz.com" returns "accounting".
+ </p>
</section>
-
</body>
</document>
Added: portals/jetspeed-2/trunk/xdocs/guides/images/user-profile.jpg
URL:
http://svn.apache.org/viewvc/portals/jetspeed-2/trunk/xdocs/guides/images/user-profile.jpg?view=auto&rev=536240
==============================================================================
Binary file - no diff available.
Propchange: portals/jetspeed-2/trunk/xdocs/guides/images/user-profile.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
