"Packaged Stuff"

What is "Packaged Stuff" 

"Packaged Stuff" is a sub-pane of the customization options, which allows users to subscribe to tabs containing pre-defined sets of channels, in a similar manner to adding a portlet to their layout. These tabs must be configured in order to allow users to opt-in to their presence in the layout; this is done in the audience element of the fragment definition DLM file (similar to “uportal-war/src/main/data/quickstart_entities/fragment-definition/all-lo.fragment-definition.xml”).

To setup a fragment (tab) which users can subscribe to, the fragment must be configured to use "org.jasig.portal.layout.dlm.providers.SubscribedTabEvaluatorFactory" as the Evaluator factory instead of “org.jasig.portal.layout.dlm.providers.GroupMembershipEvaluatorFactory”. More information found on how to setup and define a fragment.

Note that generally the updated configuration must be loaded into the database after modification (changes to the file on disk are not loaded automatically). 

The resulting fragment should look something like this:

 <dlm:fragment name='Entertainment' ownerID='ent-lo' precedence='60' description="Games, humor, and entertainment news">
 	<dlm:audience evaluatorFactory="org.jasig.portal.layout.dlm.providers.SubscribedTabEvaluatorFactory"/>
 </dlm:fragment>

In this case it will be titled Entertainment, and the description will be "Games, humor, and entertainment news". If a description is not specified, the name of the fragment layout will be used as the description instead.

You must define a membership for the fragment’s owner, whether a single group membership or a group itself. By default a group called “Subscribable Fragments” is included, and is generally sufficient for this purpose.

<group script="classpath://org/jasig/portal/io/import-group_membership_v3-2.crn">
 <name>Custom Fragments</name>
 <entity-type>org.jasig.portal.security.IPerson</entity-type>
 <creator>system</creator>
 <description>This is a Custom Fragment</description>
 <children/>
</group>

To add a fragment to the “Packaged Stuff” sub-pane, you will need a permission set for the fragment. There is a sensible default permission set provided, which provides everyone with the ability to subscribe to fragments in the “Subscribable Fragments” group.

<permission-set script="classpath://org/jasig/portal/io/import-permission_set_v3-1.crn">
 <owner>UP_FRAGMENT</owner>
 <principal-type>org.jasig.portal.groups.IEntityGroup</principal-type>
 <principal>
 <group>Everyone</group>
 </principal>
 <activity>FRAGMENT_SUBSCRIBE</activity>
 <target permission-type="GRANT">
 <group>Custom Fragments</group>
 </target>
</permission-set>

This is what actually adds the portlet to the Packaged Stuff tab.   Users should be able to then subscribe to the fragment and it should editable via the fragment manager.