Oracle Site Studio is a powerful, flexible web development application suite that offers a comprehensive approach to designing, building, and maintaining enterprise-scale web sites. Site Studio uses Oracle WebCenter Content Server as the main repository for a web site.

Content Presenter integrates with Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in a custom Content Presenter display template that makes use of region definitions.

Before you can display Site Studio contributor data files in Content Presenter, the system administrator must enable the following components in WebCenter Content Server:

• Site Studio components. The system administrator must also configure the cookie path to the context root of your application to prevent losing your session when editing Site Studio content. For more information, see Configuring Oracle WebCenter Content Server and Setting Up Site Studio in Administering Oracle WebCenter Portal

• WebCenterConfigure and Portal VCRHelper components. This allows for adding and editing Site Studio documents from within Content Presenter. For more information, see Enabling the WebCenterConfigure Component in Administering Oracle WebCenter Portal.

For proper surfacing in Content Presenter, the following link types can be used in a Site Studio contributor data file (or in a Site Studio region template):

• Links to nodes in the portal navigation (for more information, see Adding Links from Content to Navigation Nodes)

• Links to inline images

• Links to documents (except for absolute or relative path links)

  When clicking the link at runtime, it renders within the context of the application and displays the document using the Default View display template.

• Absolute HTTP links, whether created in Site Studio contributor mode or in Site Studio Designer region template HTML

The following Site Studio link types are not supported in Content Presenter:

• Links to Site Studio sections

• Absolute or relative path links to Site Studio documents

For guidelines on authoring recommendations for displaying a Site Studio contributor data file in Content Presenter, see Authoring Site Studio Content to Optimize Presentation in Content Presenter.

You can create and edit Site Studio contributor data files from the Content Presenter Configuration dialog (see Creating or Editing Site Studio Content in the Content Presenter Configuration Dialog) or in-context when displayed in Content Presenter at runtime (see Creating and Editing Files In-Context in a Content Presenter Task Flow).

For more information about creating and using Site Studio contributor data files and Site Studio region templates, refer to the Oracle WebCenter Content documentation library (http://docs.oracle.com/cd/E28280_01/webcontent.htm).

To display content from your Content Server on a page, add and configure a Content Presenter task flow.

1. Open the page in the page editor.

   For more information, see Opening a Page in the Page Editor.

2. Click Add Content in the area of the page where you want to add the Content Presenter task flow to open the resource catalog.

3. In the resource catalog, navigate to the Content Presenter task flow, or search for it.

   Tip:

   The presence or location of this task flow depends on how the resource catalog is configured. For example, in the default resource catalog, open the Content Management folder to locate the Content Presenter task flow.

4. Add the Content Presenter task flow to the page in one of the following ways:

   • Click the task flow in the resource catalog to add it to the area where you clicked Add Content.

   • Drag the task flow from the resource catalog to the target location on the page.

   A new empty region appears on your page.

5. After adding the empty Content Presenter task flow to the page, edit it to select the content that you want to display.

   For more information, see Selecting Content.

After you add a Content Presenter task flow to a page, you must configure it to select the content that you want to display.

This section includes the following topics:

• Displaying the Content Presenter Configuration Dialog

• Selecting a Single Content Item

• Selecting the Contents of a Folder

• Selecting Content Based on the Results of a Query

• Selecting a List of Content Items

1. Open the Content Presenter Configuration dialog.

   For more information, see Displaying the Content Presenter Configuration Dialog.

2. Click Select Template or the Template tab.
3. If the Content Source selected on the Content tab is a multiple content item source (Contents Under a Folder, Results of a Query, or List of Items), from the Template Category list, select:

   • Default Templates to select one of the built-in Content Presenter display templates.

     See Table 19-1 and Table 19-2.

   • Site Studio Templates to select a Content Presenter display template that uses region definitions to display Site Studio contributor data files.

     Although Site Studio region templates are supported, they display the details of the contributor data files rather than the contributed content. It is strongly recommended that for Site Studio contributor data files, you use Content Presenter display templates that use region definitions instead.

   • Custom Template Category to select a custom Content Presenter display template, if any exist. There may be multiple custom template categories listed.

     Custom Content Presenter display templates are created in Oracle JDeveloper and published to WebCenter Portal as described in Creating Content Presenter Display Templates in Developing for Oracle WebCenter Portal.

   Figure 33-10 Selecting the Template Category (for Multiple Content Items)

   
   Description of "Figure 33-10 Selecting the Template Category (for Multiple Content Items)"
4. From the Template list, select the Content Presenter display template that you want to use.

   The templates that are available for selection in the Template list are those that are identified by Content Presenter as suitable for displaying the selected content item source type. If you select a Single Content Item, only those templates that display single items are listed. If you select a multiple content item source (Contents Under a Folder, Results of a Query, or List of Items), only those templates that display multiple items (and are of the selected Template Category) are listed (Figure 33-12).

   Figure 33-11 Selecting the Display Template (for Single Content Items)

   
   Description of "Figure 33-11 Selecting the Display Template (for Single Content Items)"

   Figure 33-12 Selecting the Display Template (for Multiple Content Items)

   
   Description of "Figure 33-12 Selecting the Display Template (for Multiple Content Items)"

   The Template list includes built-in display templates, custom display templates (created in JDeveloper and published to WebCenter Portal), and Site Studio region templates.

   Note:

   Choose templates appropriate to the type of content. Site Studio region templates should be used for Site Studio defined Contributor Data Files (CDF). Using non-Site Studio templates will display the details of the CDF file, rather than the content; using Site Studio templates for non-Site Studio content will simply not display. To identify the Site Studio region templates, hover your mouse pointer over the templates in the list to display hint text identifying the Site Studio region templates.

   For more information, see Understanding Site Studio Integration.

   If you create a Site Studio contributor data file directly from the Content Presenter Configuration dialog, as described in Creating or Editing Site Studio Content in the Content Presenter Configuration Dialog, the Site Studio region templates that match the region definition of the Site Studio contributor data file might not be immediately shown in the Template list. In this case, select the default template, and click Save. Then, open the Content Presenter Configuration dialog again to find the Site Studio region templates in the Template list.

Responsive templates enable you to display content that adjusts to the width of the browser.

Articles View Template

As well as providing different layouts, the Articles View template also uses different font and image sizes depending on the width of the browser.

If the browser is narrow (up to 480 pixels, for example, an iPhone), then the template lists the articles in a single column (Figure 33-13).

Figure 33-13 Articles View Single Column Layout

Description of "Figure 33-13 Articles View Single Column Layout"

If the browser is slightly wider (up to 780 pixels, for example, an iPad in portrait orientation), then the template lists the articles in two columns (Figure 33-14).

Figure 33-14 Articles View Two Column Layout

Description of "Figure 33-14 Articles View Two Column Layout"

If the browser is wide (over 780 pixels), then the template lists the articles in three columns (Figure 33-15).

Figure 33-15 Articles View Three Column Layout

Description of "Figure 33-15 Articles View Three Column Layout"

Full Article View Template

With the Full Article View template, if the browser is narrow (up to 480 pixels, for example, an iPhone), then the template displays an article with the image taking up the full width of the template (Figure 33-16).

Figure 33-16 Full Article View Template Narrow View

Description of "Figure 33-16 Full Article View Template Narrow View"

If the browser is wider (over 480 pixels), then the template displays an article with the image displayed to the right (Figure 33-17).

Figure 33-17 Full Article View Template Wide View

Description of "Figure 33-17 Full Article View Template Wide View"

Use a responsive Content Presenter display template if you want the layout of your content to change depending on the size of the browser.

1. Add the Content Presenter task flow to a page.

   See Adding a Content Presenter Task Flow to a Page.

2. Select the content.

   See Selecting Content.

   The Content Source should be Single Content Item, Results of a Query, or List of Items.

   If the Content Source is Results of a Query, then set Content Type to WCM:RD:RD_ARTICLE to restrict the query to just content created using the RD_ARTICLE region definition. If the Content Source is Single Content Item, then choose content that is based on the RD_ARTICLE region definition. If the Content Source is List of Items, then ensure that the content items chosen are based on the RD_ARTICLE region definition.

3. Select the display template.

   See Selecting a Display Template.

   • If the Content Source is Single Content Item, select the Full Article View template.

   • If the Content Source is Results of a Query or List of Items:

     1. Set the Template Category to Site Studio Templates.

     2. Select the Articles View template.

If you use the Articles View or Full Article View template on a page and want to optimize the layout for a mobile device, you must use a page template with the correct viewport.

1. Navigate to the Assets page for the portal.
2. Click Page Templates.
3. Select the page template.

   You cannot edit the out-of-the-box templates, but you can copy an out-of-the-box template and then edit the copy.

4. From the Actions menu, select Edit Source.
5. Click the Page Definition tab.
6. Within the <parameters> section, add the following:

   <parameter id="viewport" value="width=device-width, initial-scale=1.0"/>
   

   Note:

   The value of the viewport parameter will be used as the value for the content attribute of the <meta name="viewport" content="..."/> tag, so if you set it the recommended value of "width=device-width, initial-scale=1.0" then the following meta tag will be added to the page:

   <meta name="viewport" content="width=device-width, initial-scale=1.0"/>

7. Click Save and Close.

There are several guidelines to consider as you work with images in Site Studio contributor data files that will be displayed using Content Presenter.

There are several guidelines to consider as you work with style definitions in Site Studio contributor data files that will be displayed using Content Presenter.

There are several guidelines to consider as you work with JavaScript in Site Studio contributor data files that will be displayed using Content Presenter.

With appropriate permissions, end users can edit Site Studio contributor data files in-context in a Content Presenter task flow.

1. In the floating toolbar, click Contribute.

   Tip:

   • By default, the floating toolbar appears in the top right of the page, but you can move it around on the page by using the handle on the left of the toolbar to drag it to the preferred location.

   • If you cannot see the floating toolbar or the Contribute option, you do not have permission to use contribution mode.

   • The keyboard shortcut to enter and exit contribution mode is Ctrl+Shift+C.

     You can change the key sequence to enter contribution mode. See Changing the Contribution Mode Key Sequence.

   The editable areas of the page are highlighted with a dashed border.

2. Click the Edit icon in the upper right corner of the document chrome (Figure 33-24).

   Figure 33-24 In-Context Edit Mode for a Site Studio File in a Content Presenter Task Flow

   
   The file is opened in Site Studio Contributor.
3. In the Site Studio Contributor Data File editor, click a region to edit, as shown in Figure 33-25.

   For information about editing files in Site Studio Contributor, see the Oracle Site Studio documentation.

   Figure 33-25 Editing a File in Site Studio Contributor

   
   Description of "Figure 33-25 Editing a File in Site Studio Contributor"
4. Click Save and Close to exit the Site Studio Contributor editor and return to the portal.
5. Click Save in the floating toolbar.

With appropriate permissions, users can create new web content in Site Studio during in-context editing in a Content Presenter task flow.

1. In the floating toolbar, click Contribute.

   Tip:

   • By default, the floating toolbar appears in the top right of the page, but you can move it around on the page by using the handle on the left of the toolbar to drag it to the preferred location.

   • If you cannot see the floating toolbar or the Contribute option, you do not have permission to use contribution mode.

   • The keyboard shortcut to enter and exit contribution mode is Ctrl+Shift+C.

     You can change the key sequence to enter contribution mode. See Changing the Contribution Mode Key Sequence.

   The editable areas of the page are highlighted with a dashed border.

2. Click the Create icon in the upper right corner of the document chrome (Figure 33-26).

   Figure 33-26 Create Icon for a Site Studio File in a Content Presenter Task Flow

   
3. In the Choose Content window, select New Contributor data file, then click Next (Figure 33-27).

   Figure 33-27 Choose New Content File Window

   
   Description of "Figure 33-27 Choose New Content File Window"
4. Fill out the Check-in Content form.

   This form provides the metadata for the contributor data file and checks the file into Content Server. The file is empty until you (or another contributor) edits it. For more information on filling out this form, see Uploading and Checking In Documents in Using Oracle WebCenter Content.

5. In the Check-in Confirmation window, select Edit content item now.
6. Click Finish.

   The Site Studio Contributor Data File editor opens (Figure 33-28).

   Figure 33-28 Site Studio Contributor File Editor

   
   Description of "Figure 33-28 Site Studio Contributor File Editor"
7. Edit the file, then click Save and Close.
8. Click Save in the floating toolbar.

You can change the key sequence used to enter contribution mode.

1. Open the adf-config.xml file.
2. Find the content-contribution element.
3. Change the key-sequence entry to the required key combination.

******** Content Contributor Mode adf-config.xml entries ***************
 
<page-editor-config xmlns="http://xmlns.oracle.com/adf/pageeditor/config"> 
       <content-contribution> 
         <enabled>true</enabled> 
         <key-sequence>ctrl shift C</key-sequence> 
       </content-contribution> 
</page-editor-config>

The View Actions menu in the toolbar of the Content Presenter task flow in the page editor provides access to the properties dialogs: Parameters, Access, Display Options, Style, and Content Style.

Note:

The Content Presenter properties are intended for use by advanced users who want to bind a parameter to an EL expression. If you modify a property value in the properties dialogs, the new value overrides the value specified in the Content Presenter Configuration dialog, and that value becomes read-only in the Content Presenter Configuration dialog (Figure 33-29).

Figure 33-29 Read-Only Property Value in Content Presenter Configuration Dialog

Description of "Figure 33-29 Read-Only Property Value in Content Presenter Configuration Dialog"

To set Content Presenter task flow component properties:

1. Open the page in the page editor.

   See Opening a Page in the Page Editor.

2. In the component toolbar, click the View Actions menu and select the properties you want to set:

   Figure 33-30 Component Toolbar: View Actions Menu

   

   • Parameters control the default task flow content. For descriptions of each parameter, see Content Presenter Task Flow Parameters. Parameters can be wired to events, and can be used facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Wiring Pages and Components.

   • Access settings show or hide the component to specific roles, users, or groups. For more information, see Setting Component Access.

   • The Display Options, Style, and Content Style properties affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Modifying Component Properties.

   The Parameters and Display Options dialogs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the icon next to a property, then select Expression Builder to open the editor.

   Note:

   When you enter EL in the Display Options dialog, the parser reports an error only if it detects invalid syntax, such as a missing closing bracket. Validation is performed only on syntax, not on the expression value. Generic Display Options are those cataloged in Table 10-1.

   EL validation is not performed on non-generic display options.

   If you need EL assistance, an application developer can provide an EL expression; see Expression Language Expressions in Developing for Oracle WebCenter Portal.

3. Save your changes.

There are several parameters that are unique to the Content Presenter task flow.