[gatein-commits] gatein SVN: r6825 - in epp/docs/branches/5.1/Site_Publisher/User_Guide: en-US and 3 other directories.

Author: smumford Date: 2011-07-04 23:47:13 -0400 (Mon, 04 Jul 2011) New Revision: 6825 Modified: epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/Revision_History.xml epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/images/authhomepage.png epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/modules/Basics/SitesExplorer/Actions.xml epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/modules/Get_Started/Account.xml epp/docs/branches/5.1/Site_Publisher/User_Guide/publican.cfg Log: Updates for new Publication process Modified: epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/Revision_History.xml =================================================================== --- epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/Revision_History.xml 2011-07-05 03:46:44 UTC (rev 6824) +++ epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/Revision_History.xml 2011-07-05 03:47:13 UTC (rev 6825) @@ -116,7 +116,7 @@ </author> <revdescription> <simplelist> - <member>Exported conpany-specific content to separate files.</member> + <member>Exported company-specific content to separate files.</member> </simplelist> </revdescription> </revision> Modified: epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/images/authhomepage.png =================================================================== (Binary files differ) Modified: epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/modules/Basics/SitesExplorer/Actions.xml =================================================================== --- epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/modules/Basics/SitesExplorer/Actions.xml 2011-07-05 03:46:44 UTC (rev 6824) +++ epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/modules/Basics/SitesExplorer/Actions.xml 2011-07-05 03:47:13 UTC (rev 6825) @@ -609,7 +609,7 @@ is selected by default). </para> <para> - Each document (except<guilabel>Article</guilabel>) must be added to categories when being created. + Each document (except <guilabel>Article</guilabel>) must be added to categories when being created. </para> </step> </procedure> @@ -5531,4 +5531,4 @@ A message will appear for you to confirm the action. </para> </section> -</section> \ No newline at end of file +</section> Modified: epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/modules/Get_Started/Account.xml =================================================================== --- epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/modules/Get_Started/Account.xml 2011-07-05 03:46:44 UTC (rev 6824) +++ epp/docs/branches/5.1/Site_Publisher/User_Guide/en-US/modules/Get_Started/Account.xml 2011-07-05 03:47:13 UTC (rev 6825) @@ -167,7 +167,7 @@ <title>Sign in</title> <step> <para> - Go to the Site Publisher in the public mode by inputting the URL in the address bar (e.g: <ulink url="http://localhost:8080//portal/public/classic/" type="http"/>). + Go to the your portal's Home Page by entering the URL in the address bar (e.g: <ulink url="http://localhost:8080//portal/public/classic/" type="http"/>). </para> </step> <step> @@ -182,16 +182,6 @@ <imagedata align="center" fileref="images/signin.png" format="PNG" width="150mm"/> </imageobject> </mediaobject> - </step> - <step> - <para> - Enter your registered User name and Password. - </para> - </step> - <step> - <para> - Click <guilabel>Sign in</guilabel> to submit your details or <guilabel>Discard</guilabel> to exit the form. - </para> <table id="tabl-User_Guide-Sign_in-Options"> <title>Options</title> <tgroup cols="2"> @@ -225,7 +215,17 @@ </tbody> </tgroup> </table> + </step> + <step> <para> + Enter your registered User name and Password. + </para> + </step> + <step> + <para> + Click <guilabel>Sign in</guilabel> to submit your details or <guilabel>Discard</guilabel> to exit the form. + </para> + <para> If the User Name does not exist or the submitted User name/Password set is invalid, an alert message will appear that requires users to re-submit the correct values. The page will be redirected to the private security checking mode. </para> <para> @@ -234,7 +234,7 @@ </step> </procedure> <para> - After signing in, you will be redirected to the authenticated homepage: + After signing in, you will be presented with the authenticated homepage: </para> <mediaobject> <imageobject role="html"> @@ -244,6 +244,15 @@ <imagedata align="center" fileref="images/authhomepage.png" format="PNG" width="150mm"/> </imageobject> </mediaobject> + <note> + <title>Toolbar Visibility</title> + <para> + The toolbar in the image above is, by default, only visible to members of the <emphasis>/platform/web-contributors</emphasis> role. + </para> + <para> + See <xref linkend="sect-User_Guide-Account-Toolbar_Visibility"/> for information about how to add the required permissions and/or change the default portal behavior. + </para> + </note> </section> <section id="sect-User_Guide-Account-Sign_Out"> <title>Sign Out</title> @@ -262,10 +271,10 @@ </imageobject> </mediaobject> <para> - or click <menuchoice> + Alternatively, members of the <emphasis>/platform/web-contributors</emphasis> role can click <menuchoice> <guimenu>Start Logo</guimenu> <guimenuitem>Sign Out</guimenuitem> - </menuchoice> from the menu: + </menuchoice> from the toolbar: </para> <mediaobject> <imageobject role="html"> @@ -460,4 +469,145 @@ </step> </procedure> </section> + <section id="sect-User_Guide-Account-Toolbar_Visibility"> + <title>Toolbar Visibility</title> +<!-- Source Metadata +URL: https://access.redhat.com/kb/docs/DOC-54051 +Author: Red Hat GSS +License: +--> + <para> + Newly registered users (or other users who are not members of the <emphasis>/platform/web-contributors</emphasis> role) will not see the toolbar at the top of the home page. These users will, however, be able to sign into and out of the Portal using the appropriate buttons in the site header. + </para> + <para> + Portal administrators can add individual users to the <emphasis>/platform/web-contributors</emphasis> though the interface: + </para> + <procedure> + <title>Add Permission via GUI</title> + <step> + <para> + Click on <menuchoice><guimenu>Group</guimenu><guimenuitem>Organization</guimenuitem><guimenuitem>Users and groups management</guimenuitem></menuchoice> then click on <guilabel>Group Management</guilabel>. + </para> + </step> + <step> + <para> + Click on the <menuchoice><guimenu>Platform</guimenu><guimenuitem>Content Manager</guimenuitem></menuchoice> sections in the left pane. + </para> + </step> + <step> + <para> + Enter the required username in the <guilabel>Add member</guilabel> box (below the list of users already in that role). + </para> + </step> + </procedure> + <warning> + <title>CMS Access</title> + <para> + Be aware that granting this membership will also give the user access to the Content Management System (CMS). + </para> + </warning> + <para> + If all new members require access to the toolbar (but <emphasis role="bold">NOT</emphasis> the <emphasis>CMS</emphasis>), administrators can change the default portal behavior: + </para> + <procedure> + <title>Grant all users access to toolbar but not CMS</title> + <step> + <para> + Explode the <filename><replaceable>&lt;JBOSS_HOME&gt;</replaceable>/jboss-as/server/<replaceable>&lt;PROFILE&gt;</replaceable>/deploy/gatein-wcm-extension-<replaceable>&lt;version&gt;</replaceable>.ear</filename> archive. + </para> + </step> + <step> + <para> + Within the exploded archive, explode the <filename>ecm-wcm-extension.war</filename> archive. + </para> + </step> + <step> + <para> + Then edit the <filename>/WEB-INF/conf/portal/portal/sharedlayout.xml</filename> file to match the following: + </para> +<example> + <title>sharedlayout.xml</title> +<programlisting language="XML" role="XML"><![CDATA[<container template="system:/groovy/portal/webui/container/UIContainer.gtmpl"> + <container template="system:/groovy/portal/webui/container/UIToolbarContainer.gtmpl"> + <!-- users containing to the following group can see the top toolbar --> + <access-permissions>*:/platform/users</access-permissions> +]]></programlisting> +</example> + </step> + <step> + <para> + Re-deploy the archive in the exploded form. Do not attempt to repackage it into a new <filename>.ear</filename> file. + </para> + </step> + </procedure> + <para> + If all users can have access to both the toolbar and the underlying <emphasis>CMS</emphasis> implementation, administrators can change the default portal behavior to grant the appropriate permissions to newly registered users: + </para> + <procedure> + <title>Grant all users access to toolbar and CMS</title> + <step> + <para> + Explode the <filename><replaceable>&lt;JBOSS_HOME&gt;</replaceable>/jboss-as/server/<replaceable>&lt;PROFILE&gt;</replaceable>/deploy/gatein-eppspdemo-portal-<replaceable>&lt;version&gt;</replaceable>.ear</filename> archive. + </para> + </step> + <step> + <para> + Within the exploded archive, explode the <filename>ecmdemo.war</filename> then explode the <filename>ecmdemo.war</filename>. + </para> + </step> + <step> + <para> + Then edit the <filename>WEB-INF/conf/sample-portal/portal/organization-configuration.xml</filename> and add <emphasis>/platform/web-contributors</emphasis> to <emphasis role="bold">wcm.new.user.event.listener</emphasis>. See the example below: + </para> +<example> + <title>organization-configuration.xml</title> +<programlisting language="XML" role="XML"><![CDATA[<component-plugin> + <name>wcm.new.user.event.listener</name> + <set-method>addListenerPlugin</set-method> + <type>org.exoplatform.services.organization.impl.NewUserEventListener</type> + <description>this listener assign group and membership to a new created user</description> + <init-params> + <object-param> + <name>configuration</name> + <description>description</description> + <object type="org.exoplatform.services.organization.impl.NewUserConfig"> + <field name="group"> + <collection type="java.util.ArrayList"> + <value> + <object type="org.exoplatform.services.organization.impl.NewUserConfig$JoinGroup"> + <field name="groupId"><string>/platform/users</string></field> + <field name="membership"><string>member</string></field> + </object> + </value> + <!-- new users should also be a member of the web-contributors group to see the top toolbar --> + <value> + <object type="org.exoplatform.services.organization.impl.NewUserConfig$JoinGroup"> + <field name="groupId"><string>/platform/web-contributors</string></field> + <field name="membership"><string>member</string></field> + </object> + </value> + </collection> + </field> + <field name="ignoredUser"> + <collection type="java.util.HashSet"> + <value><string>james</string></value> + </collection> + </field> + </object> + </object-param> + </init-params> + </component-plugin> +]]></programlisting> +</example> + </step> + <step> + <para> + Re-deploy the archive in the exploded form. Do not attempt to repackage it into a new <filename>.ear</filename> file. + </para> + </step> + </procedure> + <para> + Any of the above prcedures will grant access to the site's toolbar, which will allow a user to take the actions outlined in the following two sections. + </para> + </section> </section> \ No newline at end of file Modified: epp/docs/branches/5.1/Site_Publisher/User_Guide/publican.cfg =================================================================== --- epp/docs/branches/5.1/Site_Publisher/User_Guide/publican.cfg 2011-07-05 03:46:44 UTC (rev 6824) +++ epp/docs/branches/5.1/Site_Publisher/User_Guide/publican.cfg 2011-07-05 03:47:13 UTC (rev 6825) @@ -7,4 +7,7 @@ debug:1 toc_section_depth:10 max_image_width:660 -condition: redhat \ No newline at end of file +condition: redhat +cvs_branch: ENG-RHEL-6-DOCS +cvs_root: :ext:cvs.devel.redhat.com:/cvs/dist +cvs_pkg: JBoss_Enterprise_Portal_Platform-Site_Publisher_User_Guide-5.1-web-__LANG__ \ No newline at end of file