[jboss-jira] [JBoss JIRA] Commented: (JBPORTAL-1477) Custom render modes should be documented

[Julien Viet (JIRA)]

    [ http://jira.jboss.com/jira/browse/JBPORTAL-1477?page=comments#action_12364495 ] 
            
Julien Viet commented on JBPORTAL-1477:
---------------------------------------

IMHO there are two kinds of render mode:

- the ones which have a side effect for the portal, i.e that are interpreted by the portal in some way at runtime
- the ones which have a special meaning for the portlet

So far we don't support custom render mode as the portal really only uses the 3 default modes (although we could support the ADMIN mode too).

It could be possible to support portlet specific modes and map them to other existing modes but that would be really some syntactic sugar, in jboss-portlet.xml, smth like :

<custom-portlet-mode>
   <portlet-mode>BLAH</portlet-mode>
   <portlet-mode-ref>EDIT</portlet-mode-ref>
</custom-portlet-mode>

EDIT would one of the modes supported by the portal.

> Custom render modes should be documented
> ----------------------------------------
>
>                 Key: JBPORTAL-1477
>                 URL: http://jira.jboss.com/jira/browse/JBPORTAL-1477
>             Project: JBoss Portal
>          Issue Type: Feature Request
>      Security Level: Public(Everyone can see) 
>          Components: Portal Documentation
>    Affects Versions: 2.6.CR1, 2.4.1 SP1
>            Reporter: Andrew Oliver
>         Assigned To: Julien Viet
>
> It appears via: 
>  The blanket statement of support is based on: http://jira.jboss.com/jira/browse/JBPTL-20 and http://www.jbossworld.com/jbwv_2006/integration_and_presentation/LAPRUN_JBossPortalJBW3_WSRP.pdf and http://labs.jboss.com/portal/authors/articles/portal/magicbullet/
> That custom render modes are supported.  However the documentation is completely vague on support just saying the spec allows for custom modes and saying nothing about portals support for them.  The doc also does not say HOW to define them.  From these 3 I gather:
> Basically the last url states:
> "Some vendors define custom portlet modes that your portlets can implement. Support for custom portlet modes is briefly defined in the specification, and is as simple as adding a custom-portlet-mode node to the portlet descriptor and any other vendor-specific modifications to the descriptor or the portlet class."
> I suspect you define it in the portlet descriptor, the vendor specific descriptor and portal configuration and it should work.  
> However I think the documentation should explicitly state support or non-support (I think it is the former) and in the case of the former demonstrate how (which I think matches the above)...

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.jboss.com/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira