Return-Path: Delivered-To: apmail-cocoon-docs-archive@www.apache.org Received: (qmail 36721 invoked from network); 14 Jan 2005 07:37:08 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur-2.apache.org with SMTP; 14 Jan 2005 07:37:08 -0000 Received: (qmail 27499 invoked by uid 500); 14 Jan 2005 07:34:36 -0000 Delivered-To: apmail-cocoon-docs-archive@cocoon.apache.org Received: (qmail 27475 invoked by uid 500); 14 Jan 2005 07:34:36 -0000 Mailing-List: contact docs-help@cocoon.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: list-post: Reply-To: docs@cocoon.apache.org Delivered-To: mailing list docs@cocoon.apache.org Received: (qmail 27461 invoked by uid 99); 14 Jan 2005 07:34:36 -0000 X-ASF-Spam-Status: No, hits=-9.8 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from minotaur.apache.org (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.28) with SMTP; Thu, 13 Jan 2005 23:34:36 -0800 Received: (qmail 36024 invoked from network); 14 Jan 2005 07:34:33 -0000 Received: from localhost.hyperreal.org (HELO minotaur.apache.org) (127.0.0.1) by localhost.hyperreal.org with SMTP; 14 Jan 2005 07:34:33 -0000 Content-Type: text/plain; charset="iso-8859-1" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable From: docs@cocoon.apache.org To: docs@cocoon.apache.org Subject: =?iso-8859-1?q?=5BCocoon_Wiki=5D_Updated=3A__PortalPageLabels?= Date: Fri, 14 Jan 2005 07:34:07 -0000 Message-ID: <20050114073407.35928.58442@minotaur.apache.org> X-Spam-Rating: localhost.hyperreal.org 1.6.2 0/1000/N X-Virus-Checked: Checked X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N Date: 2005-01-13T23:34:07 Editor: RalphGoers Wiki: Cocoon Wiki Page: PortalPageLabels URL: http://wiki.apache.org/cocoon/PortalPageLabels no comment Change Log: ---------------------------------------------------------------------------= --- @@ -143,10 +143,48 @@ [[BR]]''parameterName'' - Identifies the request parameter to use to ident= ify the page label. The default value is =93pageLabel=94. [[BR]]''aspectName'' - Specifies the aspect name to use when creating even= ts. This must be the same value used when configuring the T''''''abbedConte= ntAspect. It is used along with the layout name and the layout hashcode to = construct the key to use when saving the value that identifies which item h= as been selected in a layout. The default value is =93tab=94. The specified= name must not conflict with any other keys stored using the same layout. = It is possible that individual T''''''abbedContentAspects can be configured= with different aspect names. However, since the P''''''ageLabelManager can= only be configured with a single aspectName, all T''''''abbedContentAspect= instances must be configured with the same value. [[BR]]''nonStickyTabs'' - Specifies whether sticky tabs are used. This is = described in the following section. The default value is =93false=94. +[[BR]]''marshallEvents'' - Specifies whether event marshalling is to occur= (currently only applies to JSR-168 portlet url events). If set to true mar= shalling will occur. See the section on JSR-168 Portlet URLs below. = =3D Sticky Tabs =3D = The Cocoon Portal supports pages with sub-navigation items on them. If a = sub-navigation item is selected, the default behavior of the portal wheneve= r the main navigation for the page is selected is to return to the last sub= -navigation item that was selected. The Page Label Manager allows this beh= avior to be changed so that whenever a main navigation tab is selected the = first sub-navigation item is displayed. This is accomplished by setting th= e nonStickyTabs element to true in the Page Label Manager=92s configuration. = +=3D JSR-168 Portlet URLs =3D + +JSR-168 defines two kinds of URLs; Action URLs and Render URLs. Pluto proc= esses Action URLs by issuing a redirect. Of course, this causes a second in= vocation of the Portal for the same initial request. The implication of thi= s is that any events created for the initial request are gone when control = is returned to the browser. Thus, simply refreshing the screen can cause un= expected behavior. The only good solution to solve this is not to return ev= ent ids to the browser for Portlet URLs. Support to do this has been added= in version 2.1.7. + +=3D=3D Configuration =3D=3D + +1. Portal P''''''ageLabels must be configured as described above. +1. Modify cocoon.xconf. + a. Add an aspect definition for C''''''onvertableEventAspect to the lis= t of the list of aspects in the component with the role named org.apache.co= coon.portal.event.aspect.E''''''ventAspectSelector. + a. Add the convertable aspect to the list of aspects in the event manage= r. = + a. Add a paramter defintion with name "parameter-name" and value "". The= list of aspects should now look like: +{{{ + + + + + + + + + + +}}} = + a. Add a new component using class org.apache.cocoon.components.E''''''x= tendedComponentSelector and role org.apache.cocoon.portal.event.C''''''onve= rtableEventFactorySelector. Within this component define factories as: +{{{ + + + + +}}} + a. Configure the P''''''ageLabelManager to enable event marshalling by s= pecifying: +{{{ + true +}}} + +'''''Note'''''[[BR]] +In release 2.1.7 the sample portal contains the configuration listed in th= e preceding sections. However, most of the features are disabled by default= . Comments have been placed in the configuration where needed to indicate h= ow to enable these features. = =20