You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jetspeed-dev@portals.apache.org by "Michael Lipp (JIRA)" <je...@portals.apache.org> on 2005/10/21 10:15:53 UTC

[jira] Created: (JS2-383) Configuring portlet in PSML

Configuring portlet in PSML
---------------------------

         Key: JS2-383
         URL: http://issues.apache.org/jira/browse/JS2-383
     Project: Jetspeed 2
        Type: New Feature
  Components: PSML  
    Reporter: Michael Lipp


It should be possible to provide preferences for the initial instantiation of portlets in PSML. These preferences customize the portlet by overriding (or adding to) the default preferences defined in the portlet.xml.

Example: If I want to have an introductory page displaying e.g. the three most important RSS feeds, then the selection of the RSS stream is related to layout, because I want a layout displaying e.g. "Company news", "Department news" and "Team issues". Binding an RSS portlet to a particular feed makes it a specific item that I want to put at a specific place. I don't want to layout three generic RSS feeds, I want to layout company, department and team news.

As I want to layout portlet instances, it is not sufficient to be able to layout portlet types. Configuring the instances within PSML would be convenient and intuitive. It would also be acceptable if I could configure the instances in some other configuration file. But only laying out three generic RSS portlets and handing the task to bind the feeds to the end user is not feasable.

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


---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org


[jira] Commented: (JS2-383) Configuring portlet in PSML

Posted by "Randy Watler (JIRA)" <je...@portals.apache.org>.
    [ http://issues.apache.org/jira/browse/JS2-383?page=comments#action_12332715 ] 

Randy Watler commented on JS2-383:
----------------------------------

We too have this need, so I'll step up to the plate and get it on my next bug fix pass.

There is still some debate on this issue realated to SOC, (from DST):

I've thought about the need for this too. Very common requirement I think.

One solution for this kind of customization: add a short wizard-like configuration to the Portlet Selector. Say a user selects a stocks portlet. On an company employee portal, the portlet.xml may default to the stock for that company. Before the portal places the portlet on the page, a generic prefs wizard is presented, allowing the user to set additional preferences (stocks).

Another use case would be from a deployment POV.
I assume you would want to specify preferences on PSML, such as deploying specific preferecnes for a user page or a common (role,group,etc) page. I think this is a good use case.

I know some people have had strong objections to mixing preferences with PSML (layout) in the past. If anyone wants to make an argument against having 'default' preferences in PSML, please make your case.

I think 'default' preferences on PSML seems useful, although it does break the 'separation of layout from preferences' philosophy. I don't think that preferences should be actually stored into PSML from the Portlet API, but I do believe this is a good case for using 'default preferences' per page/user from a deployment POV.


> Configuring portlet in PSML
> ---------------------------
>
>          Key: JS2-383
>          URL: http://issues.apache.org/jira/browse/JS2-383
>      Project: Jetspeed 2
>         Type: New Feature
>   Components: PSML
>     Reporter: Michael Lipp
>     Assignee: Randy Watler

>
> It should be possible to provide preferences for the initial instantiation of portlets in PSML. These preferences customize the portlet by overriding (or adding to) the default preferences defined in the portlet.xml.
> Example: If I want to have an introductory page displaying e.g. the three most important RSS feeds, then the selection of the RSS stream is related to layout, because I want a layout displaying e.g. "Company news", "Department news" and "Team issues". Binding an RSS portlet to a particular feed makes it a specific item that I want to put at a specific place. I don't want to layout three generic RSS feeds, I want to layout company, department and team news.
> As I want to layout portlet instances, it is not sufficient to be able to layout portlet types. Configuring the instances within PSML would be convenient and intuitive. It would also be acceptable if I could configure the instances in some other configuration file. But only laying out three generic RSS portlets and handing the task to bind the feeds to the end user is not feasable.

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


---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org


[jira] Assigned: (JS2-383) Configuring portlet in PSML

Posted by "Randy Watler (JIRA)" <je...@portals.apache.org>.
     [ http://issues.apache.org/jira/browse/JS2-383?page=all ]

Randy Watler reassigned JS2-383:
--------------------------------

    Assign To: Randy Watler

> Configuring portlet in PSML
> ---------------------------
>
>          Key: JS2-383
>          URL: http://issues.apache.org/jira/browse/JS2-383
>      Project: Jetspeed 2
>         Type: New Feature
>   Components: PSML
>     Reporter: Michael Lipp
>     Assignee: Randy Watler

>
> It should be possible to provide preferences for the initial instantiation of portlets in PSML. These preferences customize the portlet by overriding (or adding to) the default preferences defined in the portlet.xml.
> Example: If I want to have an introductory page displaying e.g. the three most important RSS feeds, then the selection of the RSS stream is related to layout, because I want a layout displaying e.g. "Company news", "Department news" and "Team issues". Binding an RSS portlet to a particular feed makes it a specific item that I want to put at a specific place. I don't want to layout three generic RSS feeds, I want to layout company, department and team news.
> As I want to layout portlet instances, it is not sufficient to be able to layout portlet types. Configuring the instances within PSML would be convenient and intuitive. It would also be acceptable if I could configure the instances in some other configuration file. But only laying out three generic RSS portlets and handing the task to bind the feeds to the end user is not feasable.

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


---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org


[jira] Commented: (JS2-383) Configuring portlet in PSML

Posted by "Michael Lipp (JIRA)" <je...@portals.apache.org>.
    [ http://issues.apache.org/jira/browse/JS2-383?page=comments#action_12332854 ] 

Michael Lipp commented on JS2-383:
----------------------------------

>From your comment, I'm not sure: are you going to implement this or do you think the issue needs further discussion? I have another example (besides the RSS example that I consider pretty convincing ;-)). 

I have written a portlet that can be used in two modes: If you have limited space, you use it both as browser and as detail viewer (i.e. display switches when you select a detail). If you have more space on your page, you can use one instance as a browser and another instance as the "connected" detail viewer (i.e. the portlet has a "mode" preference that determines its behaviour). If configuring the portlet in the page description (as browser or as detail viewer) is considered "evil" I cannot layout the browser/detail viewer combination, I can just layout two unconfigured generic instances and can let the user wonder (and describe the issue in the manual; and hope the user reads the manual -- obviously not a real world scenario).

Of course, as a work-around, I could describe three portlets types instead of one in portlet.xml. They'd all be similar except for the name and the preferences. While this might be feasable for a mode preference with three possible values, this really becomes ridiculous if there are more values or preferences (e.g. the URL preference of the RSS portlet has an almost unlimited number of possible values). It it is also hardly feasable if I get a pre-packaged portlet.xml and have to patch the portlet.xml for every new version in order to define the required portlet instances as portlet types.

The bottom line is: the page description is about laying out portlet instances. But in general, a portlet instance is not a portlet type, it is a portlet type plus some initial configuration information, and that's why we need the possibility to specify this information when laying out portlets.


> Configuring portlet in PSML
> ---------------------------
>
>          Key: JS2-383
>          URL: http://issues.apache.org/jira/browse/JS2-383
>      Project: Jetspeed 2
>         Type: New Feature
>   Components: PSML
>     Reporter: Michael Lipp
>     Assignee: Randy Watler

>
> It should be possible to provide preferences for the initial instantiation of portlets in PSML. These preferences customize the portlet by overriding (or adding to) the default preferences defined in the portlet.xml.
> Example: If I want to have an introductory page displaying e.g. the three most important RSS feeds, then the selection of the RSS stream is related to layout, because I want a layout displaying e.g. "Company news", "Department news" and "Team issues". Binding an RSS portlet to a particular feed makes it a specific item that I want to put at a specific place. I don't want to layout three generic RSS feeds, I want to layout company, department and team news.
> As I want to layout portlet instances, it is not sufficient to be able to layout portlet types. Configuring the instances within PSML would be convenient and intuitive. It would also be acceptable if I could configure the instances in some other configuration file. But only laying out three generic RSS portlets and handing the task to bind the feeds to the end user is not feasable.

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


---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org


[jira] Assigned: (JS2-383) Configuring portlet in PSML

Posted by "Scott T Weaver (JIRA)" <je...@portals.apache.org>.
     [ http://issues.apache.org/jira/browse/JS2-383?page=all ]

Scott T Weaver reassigned JS2-383:
----------------------------------

    Assign To: Scott T Weaver  (was: Randy Watler)

> Configuring portlet in PSML
> ---------------------------
>
>          Key: JS2-383
>          URL: http://issues.apache.org/jira/browse/JS2-383
>      Project: Jetspeed 2
>         Type: New Feature
>   Components: PSML
>     Reporter: Michael Lipp
>     Assignee: Scott T Weaver

>
> It should be possible to provide preferences for the initial instantiation of portlets in PSML. These preferences customize the portlet by overriding (or adding to) the default preferences defined in the portlet.xml.
> Example: If I want to have an introductory page displaying e.g. the three most important RSS feeds, then the selection of the RSS stream is related to layout, because I want a layout displaying e.g. "Company news", "Department news" and "Team issues". Binding an RSS portlet to a particular feed makes it a specific item that I want to put at a specific place. I don't want to layout three generic RSS feeds, I want to layout company, department and team news.
> As I want to layout portlet instances, it is not sufficient to be able to layout portlet types. Configuring the instances within PSML would be convenient and intuitive. It would also be acceptable if I could configure the instances in some other configuration file. But only laying out three generic RSS portlets and handing the task to bind the feeds to the end user is not feasable.

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


---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org


[jira] Commented: (JS2-383) Configuring portlet in PSML

Posted by "Scott T Weaver (JIRA)" <je...@portals.apache.org>.
    [ http://issues.apache.org/jira/browse/JS2-383?page=comments#action_12356702 ] 

Scott T Weaver commented on JS2-383:
------------------------------------

I have just finished adding preference support into .psml pages.  Everything is pretty straightforward, please build the site docs and look at the Preference example/docs on the psml.html page.

Here is a working example from the bookmark portlet.

<fragment id="uhtemp-1012" type="portlet" name="demo::BookmarkPortlet">
    <property layout="TwoColumns" name="row" value="2" />
    <property layout="TwoColumns" name="column" value="1" />
    <preference name="Google" readOnly="false">
        <value>http://www.google.com</value>
     </preference>
</fragment>

> Configuring portlet in PSML
> ---------------------------
>
>          Key: JS2-383
>          URL: http://issues.apache.org/jira/browse/JS2-383
>      Project: Jetspeed 2
>         Type: New Feature
>   Components: PSML
>     Reporter: Michael Lipp
>     Assignee: Randy Watler

>
> It should be possible to provide preferences for the initial instantiation of portlets in PSML. These preferences customize the portlet by overriding (or adding to) the default preferences defined in the portlet.xml.
> Example: If I want to have an introductory page displaying e.g. the three most important RSS feeds, then the selection of the RSS stream is related to layout, because I want a layout displaying e.g. "Company news", "Department news" and "Team issues". Binding an RSS portlet to a particular feed makes it a specific item that I want to put at a specific place. I don't want to layout three generic RSS feeds, I want to layout company, department and team news.
> As I want to layout portlet instances, it is not sufficient to be able to layout portlet types. Configuring the instances within PSML would be convenient and intuitive. It would also be acceptable if I could configure the instances in some other configuration file. But only laying out three generic RSS portlets and handing the task to bind the feeds to the end user is not feasable.

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


---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org


[jira] Resolved: (JS2-383) Configuring portlet in PSML

Posted by "Scott T Weaver (JIRA)" <je...@portals.apache.org>.
     [ http://issues.apache.org/jira/browse/JS2-383?page=all ]
     
Scott T Weaver resolved JS2-383:
--------------------------------

    Fix Version: 2.0-FINAL
     Resolution: Fixed

> Configuring portlet in PSML
> ---------------------------
>
>          Key: JS2-383
>          URL: http://issues.apache.org/jira/browse/JS2-383
>      Project: Jetspeed 2
>         Type: New Feature
>   Components: PSML
>     Reporter: Michael Lipp
>     Assignee: Scott T Weaver
>      Fix For: 2.0-FINAL

>
> It should be possible to provide preferences for the initial instantiation of portlets in PSML. These preferences customize the portlet by overriding (or adding to) the default preferences defined in the portlet.xml.
> Example: If I want to have an introductory page displaying e.g. the three most important RSS feeds, then the selection of the RSS stream is related to layout, because I want a layout displaying e.g. "Company news", "Department news" and "Team issues". Binding an RSS portlet to a particular feed makes it a specific item that I want to put at a specific place. I don't want to layout three generic RSS feeds, I want to layout company, department and team news.
> As I want to layout portlet instances, it is not sufficient to be able to layout portlet types. Configuring the instances within PSML would be convenient and intuitive. It would also be acceptable if I could configure the instances in some other configuration file. But only laying out three generic RSS portlets and handing the task to bind the feeds to the end user is not feasable.

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


---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org