JBoss.orgCommunity Documentation

User Guide

A guide to using eXo Content.

by eXo Platform Documentation Team
edited by Scott Mumford (Red Hat)

Abstract

This document provides an easy-to-follow guide to the functions and options available in eXo Content. It is intended to be accessible and useful to both experienced and novice portal users.


Preface
1. Give us Feedback
1. Overall Introduction
1.1. Overview
1.2. Why Use eXo Content
1.3. About This Document
1.4. References and Related Sources
2. Product Introduction
2.1. eXo Content
2.2. Site Content Structure
2.3. Web Content
2.3.1. Web Content
2.3.2. Web Content Structure
2.4. Terminologies
2.4.1. Repository
2.4.2. Workspace
2.4.3. Drive
2.4.4. Node
2.4.5. Version
2.4.6. WebDAV
2.4.7. Podcast
2.4.8. File Plan
2.4.9. Symlink
3. Get Started
3.1. Account
3.1.1. Register an account
3.1.2. Sign In
3.1.3. Sign Out
3.1.4. Retrieve Username/Password
3.1.5. Change account information
3.1.6. Toolbar Visibility
3.2. Change the display language
3.3. Change the skin of the current site
4. Basic Actions
4.1. View a site
4.2. Print content
4.3. Manage a site
4.3.1. Create a new site
4.3.2. Edit a site
4.3.3. Switch between sites
4.3.4. Delete a site
4.4. Contribute Content
4.4.1. Edit Mode
4.4.2. InContext Editing
4.4.3. Inline Editing
4.4.4. Publication Process
4.5. Content Inside Categories
4.5.1. What is a Category in eXo Content?
4.5.2. Create a Content
4.6. Dynamic Navigation
4.7. SEO Management
4.8. Content Explorer
4.8.1. Access Content Explorer
4.8.2. Drives
4.8.3. Views
4.8.4. Actions
4.8.5. Manage Content In Content Explorer
4.8.6. Actions on Folders and Documents
4.9. Manage Content with WebDAV
4.9.1. What is WebDAV?
4.9.2. Why use WebDAV?
4.9.3. How to Use WebDAV With eXo Content
4.9.4. Actions
4.10. Search in Content Explorer
4.10.1. Quick Search
4.10.2. Advanced Search
4.10.3. Search with saved queries
4.11. Preferences
4.12. Search Porlet
4.12.1. How to search for contents?
4.12.2. Edit the Search portlet
4.13. Newsletters
4.13.1. Newsletter Viewer
4.13.2. Manage Newsletters
4.14. Fast Content Creator
4.14.1. Configuration
4.14.2. Create a new document
4.14.3. View a new document
4.15. Form Builder
4.16. Category Navigation
4.17. Contents By Query
5. Advanced Actions
5.1. Manage Site Resources in one place
5.1.1. CSS Folder
5.1.2. Document Folder
5.1.3. JS Folder
5.1.4. Links Folder
5.1.5. Media Folder
5.1.6. Web Content Folders
5.2. Administration page
5.2.1. Categories and Tags
5.2.2. Content Presentation Manager
5.2.3. Content Types
5.2.4. Advanced Configuration
6. Next Steps
A. Revision History

If you find a typographical error, or know how this guide can be improved, we would love to hear from you. Submit a report in JIRA against eXo Content. The following link will take you to bug report for eXo Content http://jira.exoplatform.org.

Select the document name and version number relevant to the document you found the error in from the available lists then complete the description with as much detail as you can provide.

Be sure to give us your name so that you can receive full credit for reporting the issue.

If you are looking for a powerful tool and strategies in managing website and contents, eXo Content is what you need. eXo Content is designed to provide webmasters who manage websites the way to maintain, control, modify and reassemble the content of a web-page easily and effectively. All components of your website can be organized, reconstructed easily, which helps you keep your website under the control. eXo Content really brings interesting experience for all users and changes their way of thinking about website. The followings are key features of eXo Content:

And More...

eXo Content also provides other powerful tools to manage an build content-rich websites such as CSS, Java Script and RSS support, advanced document management tool, collaboration tools, etc. All features is to meet your requirements for the purpose of easy site management, cost reduction in managing multiple sites in only one place.

eXo Content is the technologies used to Capture, Manage, Store, Preserve, and Deliver content and documents. It especially concerns content imported into or generated from within an organization in the course of its operation, and includes the control of access to this content from outside the organization's processes.

The eXo Content users can manage both structured and unstructured content, so that an organization, such as a business or a governmental agency, can more effectively meet business goals (increasing the profits or improving the organizational process with efficient use of budgets), serve its customers (as a competitive advantage, or to improve responsiveness), and protect itself (against non-compliance, law-suits, uncoordinated departments or turnover within the organization).

eXo Content improves your operational productivity and efficiency. It enables you to transform unstructured content into structured content through the process of capturing, storing, managing, preserving, publishing and backing up while securely distributing it. The eXo Content portlet gives you a portal solution that can help you achieve these processes and leverage your business content across all formats for competitive gain. It also provides an environment for employees to share and collaborate on digital content and delivering a comprehensive unified solution with rich functionalities. Every component of your website can be organized, reconstructed easily, which helps you keep your website under control.

eXo Content consists of three parts:

Document Management System (DMS) - an extension of eXo Content is used to store, manage and track electronic documents and electronic images and allows documents to be modified and managed easily and conveniently by managing versions, properties, and more.

Workflow: is the way of looking at and controlling the processes presented in an organization such as service provision or information processing, etc. It is an effective tool to use make certain that the processes are effective with the purpose of better and more cost efficient organization.

Web Content Management (WCM): helps in maintaining, controlling, changing and reassembling the content on a web-page. It also helps webmasters who handle all tasks needed to run a website, including development, design, content publication and monitoring.

To register a new account on the portal, do as follows:

After adding a new account, contact the administrator to get the confirmation.

These actions are for all registered users after they have logged in the accounts.

This function enables you to create a site (portal) to meet your own needs.

Do the following:

  1. Click Site on the administration bar. A list of existing portals is listed.

  2. Click the Add New Portal button to open the form to add a new portal.

    In the Portal Setting tab, set some properties for this site, including the portal name, locale and skin.


  3. Select the Properties tab to keep session alive.

    The Keep session alive option means keeping the working session for a long time to avoid the working time out. There are 3 options:

  4. Select the Permission Setting tab to set access and edit permission for this portal.

    The Permission Setting tab includes two sub-tabs: Access Permission Setting and Edit Permission Setting.

  5. Click Save to create a new portal.

After creating a new site, a list of the existing sites will be displayed on the screen. This new site will be added to the exiting site list in Site on the administration bar and to a drive list that includes all its default files.

To see it in the drive list, click Group > Content Explorer on the administrator bar.

For example, after creating a portal named 'eXo', there is a drive named 'eXo' in Content Explorer:

This function enables you to edit a site, including the configuration (setting, permission), the navigation and the layout components of the site.

There are two ways to approach a site that you want to edit:

Directly edit the site you are browsing by going to Site Editor > Edit Layout

The form to edit the site appears.

Details:


With this way, you can only edit the layout and the configuration of site.

Edit layout

Editing the layout means editing a banner, a navigation bar, a breadcrumb bar, a homepage and a footer of a website. You can also add more portlets to the site by dragging and dropping from the Applications tab of the Edit Inline Composer form to the main pane. Moreover, you can move a portlet from a location to another location.

Editing the banner portlet is similar to editing the Sign-in portlet and the footer portlet so in this guide, we only show how to edit the banner of the site as an example of editing the layout.

Procedure 4.2. Edit Banner

  1. Show the form to edit a banner by clicking the pencil icon of the banner portlet in the Edit Portal form like the illustration below.

    A form to edit the current banner will appear:

  2. Select Edit Mode tab:

    Content Selection: Select the path of the content that you want to show by clicking .

    Display Settings:

    • Show Title: Specify whether the title of the content is displayed or not.

    • Show Date: Specify whether the date of the content publication is displayed or not.

    • Show Option Bar:Show or hide the Option bar used to show the print link.

    Print Setting:

    • Show in page: Choose a page for the print review.

    • with: Parameters contains the content path.

    Advanced: The content should enable “dynamic navigation” that interprets the URL and shows a content.

    Note

    Click the question mark icon to see more explanation for each section.

  3. Select the Portlet Setting tab:

    Details:


  4. Select Icon tab: Select an icon for the portlet by clicking it.

  5. Select Decoration Theme tab: Select a decoration theme for the portlet.

  6. Select Access Permission tab:

    By default, all users can access the portlet:

    However, you can edit the access permission by unticking the checkbox > click Add Permission:

    The ListPermissionSelector form appears. Select a group on the left pane and a membership on the right pane.

  7. Click Save and Close to commit.

  8. Click the disk icon to quit the form to edit the current site.

Edit Configuration

To edit the configuration ( including language, skin and permissions) of the site, click the [ Site's Config ] button to open the same form as the form to add a new portal.

Do the same steps as in Section 4.3.1, “Create a new site”.

Note

You cannot change the name of the site.

This approach way enables you to edit the layout, configuration and navigation bar of a site by going to Sites > select the site in the existing site list.

Edit Layout

Do the following to edit the layout of an existing site.

Edit Navigation

Do the following to edit the navigation of a site.

  1. Click SiteEdit Navigation to open the Navigation Management form.

  2. Click Add Node to open the ADD/EDIT PAGE NODE form. (For more details, refer to the Section 5.3.1, Add a new node, GateIn User Guide 3.1.)

  3. In the Page Node Setting tab, enter a name for the node. It is required.

    Details:


  4. Select the Page Selector tab:

    Details:


    • Enter a title for the page.

    • Click Create Page to create a new page or Search and Select Page to select an existing page for the node.

  5. Select the Icon tab to choose an icon for the node. It is not required.

  6. Click Save to create a node for the navigation.

Edit Configuration

The portal's configuration including language, skin and permissions can be edited by doing the following:

InContext Editing enables you to edit content "in context" rather than having a WYSIWYG editor pop-up over the top of the page. This feature makes page editing a much more user intuitive process, with the new content automatically taking on the previous contents.

To use InContext Editing, turn on the Edit Mode.

Preferences enable you to edit contents in the Single Content Viewer (SCV) and the Content List Viewer (CLV), reset the display of the contents in SCV and CLV and publish contents.

Content Detail Preferences

To edit the Single Content Viewer, do the followings:

Procedure 4.8.  Edit Content Detail Viewer

  1. Turn on the Edit Mode > Select the Preferences icon of a Single Content Viewer.

    The Content Detail Preferences dialog appears:

    Details:

    Content Selection: Select the path of the content that you want to show by clicking the blue plus icon.

    Display Settings: Allow configuring Title, Date and OptionBar visibility.

    • Show Title: Specify whether the title of the content is displayed or not.

    • Show Date: Specify whether the date of the content publication is displayed or not.

    • Show Option Bar:Show or hide the Option bar used to show the print link.

    Print Setting:

    • Show in page: The content is shown in the page.

    • with: Parameters contains the content path.

    Advanced link: When clicking on this link, the Advanced pane will be shown.

    • Contextual Content: If Contextual Content property is set as "Disable", the Advanced pane is closed by default. The content should enable “dynamic navigation” that interprets the URL and shows a content.

    • Contents Visibility: Allows you to use a cache shared between users to get contents. If you want the contents displayed in CLV or SCV to be got from one cache, select Restricted by Authentication, and in verse, select Restricted by Users.

    Note

    Click the question mark icon to see a quick help pane for each section.

  2. Click the plus icon next to the Content Path to re-select another content. The Select Content dialog appears:

  3. Choose a folder on the left panel and a content in the folder on the right panel. The content chosen will be displayed in the Content Path field.

  4. Tick the checkboxes, including the Show Title box, the Show Date and the Show Option bar box if you want to display the content title, the publication date and the print button like the illustration below:

  5. In the Print Setting part, click the magnifying glass icon to open the UIPageselector dialog, you will see Printviewer.

    Click the Print button, the content is opened in the print viewer page.

    URL: http://localhost:8080/ecmdemo/private/acme/printviewer?content-id=/repository/collaboration/sites%20content/live/acme/web%20contents/site%20artifacts/Introduce&isPrint=true

    In which:

    • printviewer?: the print viewer page of the content.

    • content-id: the parameter containing the content path.

  6. Click Save to save all the changes.

Content List Preferences

To edit the Single Content Viewer, do the following:

Procedure 4.9. Edit Content List Viewer

  1. Turn on the Edit Mode > Select the Preferences icon of a Content List Viewer.

    The Content List Preferences dialog appears:

    Details:

    Table 4.6. 

    Mode This mode is to select web content for list viewer. There are two modes:

    By Folder: This mode allows you to select a content folder in the Folder path field.

    By Content: This mode allows you to select by the content in a specific folder in Folder path field.

    Folder path The path to a location of a folder that contains the content.
    Order by The field is selected to sort content in the list viewer. You can sort content by Title, Date created or Date modified in ascending or descending order.
    Header The title of all contents that are listed in List Viewer.
    Viewer template The template is used to view content list.
    Paginator template The template is used to view each content in the list.
    Items per page The number of items will be displayed per page.
    Show image The option is to show or hide the illustration of each published web content/document.
    Show summary The option is to show or hide the summary of each web content/document.
    Show header The option is whether to show a header or not.
    Show refresh button The option is whether to show the refresh button at the left bottom of this page or not.
    Show title The option is to show or hide title of each published web content and/or document.
    Show date created The option is to show or hide the created date of each published web content/document.
    Show link The option is to show or hide the link of web content and/or document.
    Read more The option is to show or hide the Read more to read all the content of a web content and/or document.

  2. Browse the documents or web content of an available site by clicking the blue plus icon next to the folder path field.

  3. If you select the By folder mode, select an available site on the left, then select a folder that contains contents (documents and/or web content) on the right by clicking the folder.

    If you select the By content mode, select an available folder from the left panel, all content in this folder will be listed on the right panel. Click a content on the right that you want to add to the content list. A message informs that you have successfully added it in the Content List. The selected content is listed in the Content List.

  4. Enter a header for the content list in the Header field if you want.

  5. Select a template to display the content list in the template list.

  6. Tick/untick some options that you want.

  7. Click Save to save all the changes.

The Inline Editing allows users to edit directly on the page without going to a separate one. Now, your interaction will become more intuitive as you can edit the text right at the shown same location.

To do the inline editing, do as follows:

After a new content is created, it is saved as draft and you can easily to publish it on your site. The publication process consists of four steps:

Request approval > Approval > Stage > Publish

If you do not have the right to approve or publish a content, so when you want to publish your content, you need to send your approval request first.

If you have the right to approve or publish a content, you do not need to send a request approval. You can yourself publish it with the Stage step immediately.

Dynamic Navigation enables you to get a parameter to configure the portlet by URL. It means that the URL containing the content path can be dynamically changed.

This section shows you how to use Dynamic Navigation in eXo Content.

Do the following to access Dynamic Navigation:

Procedure 4.13. Access Dynamic Navigation

  1. Turn on the Edit Mode > hover the mouse over SCV or CLV and select the Preferences icon.

    If you select the Preferences icon of SCV, the Content Detail Preferences form displays.

    If you select the Preferences icon of CLV, the Content List Preferences form displays.

  2. Click the Advanced link in the Content Detail Preferences form/ the Content List Preferences form.

    The Dynamic Navigation will display.

    Dynamic Navigation in SCV

    Details:


    For example, open a single content with the Content Path "ACME Introduce". The URL of the content is the following:

    URL: ... /ecmdemo/private/acme/printviewer?content-id=/repository/collaboration/sites content/live/acme/web contents/site artifacts/Introduce&isPrint=true

    Dynamic Navigation in CLV

    Details:


SEO (Search Engine Optimization) allows you to improve the visibility of your web pages and web content in the major search engines (Google, Yahoo, MSN, Live) via the search results. The higher your website position is in the search engine results page, the more visitors access it. Therefore, it is very important for you to maximize your web pages and contents' position in the search engines.

eXo Content supplies you with the SEO Management feature to meet this target. By using SEO Management, you can easily manage SEO data of web pages and web content and optimize your website for search engines.

To use this feature, do as follows:

Procedure 4.14. Manage SEO data

  1. Open the SEO Management form:

    Click the icon on the Administration bar and the SEO Management form appears. Depending on your SEO management for a page or a content, the content of the SEO Management form will be different:



    Details:

    Table 4.9. 

    Field Information
    Description The description of your page/content. This description will be seen in the results list of search engines.
    Keywords By using these keywords, other users can find out your page/ content via search engines.
    Robots Search engines can access the whole directories on a web site, or individual pages, or individual links on a page and list your page/content or not, it depends on your options:
    • INDEX: Allows search engines to index your page/content on the search engine results page.

    • NOINDEX: Restrict search engines from indexing your page/content on the search engine results page. Use this option in case you want to keep your page private.

    • FOLLOW: Allows search engines to follow links from your page to find other pages.

    • NOFOLLOW: Restricts search engines from following links from your page to find other pages. Use this option in case you want to prevent spam links in comments of blogs, forum and others.

    Sitemap Allows you to see the pages of the sites in the tree-like structure.
    Frequency Shows how often pages are updated on the site. Also, setting your frequency levels tells the search engines which pages should be crawled over other pages. The frequency levels include: Always, Hourly, Daily, Weekly, Monthly, Yearly and Never. If you set "Never" for the frequency level, meaning that this page never gets updated, so search engines will move onto other pages that get updated more frequently.
    Priority Allows search engines to search the page with the higher priority level first. The acceptable value in this field is 0 - 1. 0 is the lowest priority level and 1 is the highest.

  2. Fill out all the fields in the form.

  3. Click Save to finish creating SEO data.

There are many drives in the Content Explorer. Each drive has some views that enable you to look at data in the drive in a particular way. Each view has some tabs and each tab contains some functions (or called actions).

eXo Content supports you four ways to view nodes in a specific folder and show actions of corresponding tab on the Actions bar.

Actions are added in tabs in Content Explorer by administrators. Depending on each tab and each drive you are browsing and your role, you can see which action.

eXo Content consists of many actions. This section shows you how to take all the actions in Content Explorer.

There are several types of document in eXo Content, including File, Article, Podcast, Sample node, File Plan, Kofax.

The table below shows nodes types to which different document types can be added. The rows indicate what the node in the left column can be added to. The columns indicate what the node at the top can contain.


Note

  • The green tick icon indicates that the corresponding document can be added into.

  • A blank entry means the corresponding document can not be added into.

Follow the horizontal, you will know what the node can be added to.

Follow the vertical, you will know what the node can include.

Do the following to add a new document:

Procedure 4.22. Create a new File document

  1. Follow the steps in Add a new document to open the Add New Document form, then select File from the drop-down list for the field Select Template.

    The Add New Document form will be displayed.

  2. Input a name for the file document in the Name field. Some special characters cannot be used in the Name field: @ # % & * ( ) “ ' : ; [ ] {} / !

  3. Click the scroll arrows icon to see the Mime Type list and select one. There are two types of File document for you to choose:

    • text/html: when creating a text/html File document, you can input value in the Content field like source code (HyperText Markup Language HTML). After being created, it will generate the content you want, then you can see both the inputted source code and the generated content in that document.

    • text/plain: after being created, it will display exactly what you inputted in the Content field.html.

  4. Input a value in the Content field:

    • text/html: If you want to create a File document with a source code and generated content, click the [ Source ] button in the editor bar. In this mode, only Save, New Page, Preview icons in editor bar are visible for using. Click the magnifying glass icon to preview the generated content.

    • text/plain: If you select text/plain type, the content field will be displayed like the following illustration:

  5. Fill values in all the fields, including Title, Description, Creator and Source.

    Click the plus icon to open more fields.

  6. Click Save or Save & Close to accept creating a new file document.

    After being created successfully, a file document with type text/html will be displayed like the illustration below:

Procedure 4.23. Create a new Article

  1. Follow the steps in Add a new document to open the Add New Document form then select Article from the drop-down list for the field Select Template. (Actually, Article is selected by default).

    The Add New Document form will be displayed.

  2. Input the name and the title of the Article in the Name and Title field, some special characters can not be used in the Name field (@ # % & * ( ) “ ' : ; [ ] {} / !).

  3. Input value for the Summary field, and the Content field.

  4. Click Save or Save & Close to accept the inputted values, or Close to quit.

After being created, the new added Article document will be like the illustration below:

The Links is used to list all its related documents. After adding relations for a document, Article will be displayed. You can click these links to view the content of the related documents.

The Attachments is used to list all its uploaded files/documents that is attached with the Article. You can remove the attachments by clicking the trash can icon.

For more details about how to add an attachment, see Attach files to a document.

Existing Names

Document name can be the same as the existing one. When a new document is created with the same name as other existing document, its name will be added an index (e.g: test [2]).

Once created, a Podcast will appear as so:

Podcasts can be listened to immediately, or transferred to another device.

Procedure 4.25. Create a new Sample node

  1. Follow the instructions in Add a new document to open the Add New Document window and select Sample node from the drop-down list for the field Select Template.

    The Add New Sample Node form will appear.

  2. Complete the appropriate fields.

  3. To upload an image, click the Browse... button and select an image from your computer.

  4. Click Save or Save & Close to accept.

After being created, a new sample node will be displayed like the illustration below:

The Relations area is used to list all its related documents. See Section 4.8.4.15.3, “View Relations”.

You can click the links to view content of the related document.

The Attachments area is used to list all its uploaded files. See Attach files to a document.

Procedure 4.26. Create a new File Plan

Tabs in the Add File plan form

The Name tab

The Record properties tab

The Process Properties tab:

Table 4.15. 

Field Details
Process cutoffs The boolean data type is used to break a process. If the process cutoff flag is set in the file plan, the record is cutoff after the expiration, or after it has been obsolete or superseded, depending on the information in the file plan.
Event trigger The text data type is an automatic executing code which is used to tell the event to perform some actions.
Cutoff period The duration for the record cutoff performance.
Cutoff on obsolete The record is cutoff when it is obsolete.
Cutoff on superseded The record is cutoff when it is removed or replaced.
Process hold This boolean data type is used when a record process may be held before the further disposition is handled.
Hold period The duration when a record may be held after cutoff which is normally measured in Years.
Discretionary Hold The boolean data type is used when a hold may be discretionary, such as after a command change. So, the discretionary hold flag allows the records management module to track these manual checks.
Process transfer The boolean data type is used to determine how a record process will be transferred.
Default transfer location The text data type is used to determine where a record is transferred by default.
Transfer block size The float data type is used to determine in what size blocks for organizational purposes that is normally measured in Years.
Process accession The boolean data type is flagged when a record which is held permanently must be ultimately transferred to the national records authority.
Accession location The text data type is flagged to specify an area for the accession transfer.
Accession block size The text data type is flagged to determine the blocks size for organizational purposes which is normally measured in Years.
Process destruction The boolean data type is flagged if there is any record to be destroyed. After that, the record is marked in the Alfresco system to be permanently destroyed so that all information, metadata and physical traces are removed and cannot be recovered.

  1. Follow the instructions in Add a new document to open the Add New Document window and select File plan from the drop-down lis for the field Select Template.

    The Add File plan form will appear.

  2. Fulfill in the appropriate fields of the tabs in the Add File plan form.

  3. Click Click Save or Save & Close to accept. to accept creating a file plan.

After being created, the new File Plan will be displayed:

Procedure 4.27. Create a new Kofax

  1. Follow the instructions in Add a new document to open the Add New Kofax form and select Add New Kofax from the drop-down list for the field Select Template.

    The Add New Kofax form will appear:

  2. Input a name for a Kofax document in the Name field. This field is required. Some special characters can not be used in the Name field(@ # % & * ( ) “ ' : ; [ ] { } / !).

  3. Select categories for a Kofax document by clicking the plus icon.

  4. Click Save or Save & Close to accept creating a document.

After being created, a kofax document will be displayed like this illustration:

The File View tab is used to display all added nodes in that kofax. Besides, all added files in kofax are also displayed in the Document View tab:

Procedure 4.28. Create new Event

  1. Follow the instructions in Add a new document to open the Add New Event form and select Event from the drop-down list for the field Select Templatee.

    The Add New Event window will appear:

  2. Enter a title for the event.

  3. Input the location where the event will take place in Location field. Check the Google Maps checkbox if you want the location of the event shown on Google Maps.

  4. Enter the Start and End Date/time of the event.

  5. Fill the Summary and Content fields.

  6. Click Save to commit the event.

After being created, the event will be displayed like the illustration bellow:

The event will be displayed in a website as:

You can create a document immediately in a specific drive; however, adding a document into a specific folder enables you to manage documents better.

There are two types of folder:

In default skin, the icon for a content folder node is displayed in blue and the icon for a document folder node is displayed in yellow.

Procedure 4.37. 

  1. Select the node you want to add an action to.

  2. Click the [ Manage Actions ] button on the action bar.

    The Manage Actions form will appear.

  3. Select the Add Actions tab to open the form to add an action to the folder.

  4. Click the scroll arrows icon and select the type of action from the drop-down menu.


  5. Complete the required fields in the form for the selected action.


  6. Click Save to commit the action.

All actions of a node are listed in the Available Actions tab.

Once an action is added to a node it is automatically added to any child nodes of the selected node.

If an action added with the life-cycle 'user action', it will be applied for the current node. And an action added with other lifestyles, it will be applied for the child nodes.

This function is used to support users to add multiple languages for a document. Each document can be displayed in many languages.

To view the languages list of a document, do the following:

Language Notes

You cannot add multiple languages for a File Plan.

When a document is a sub-node of File Plan, you also cannot add language to it.

This function supports you to upload a file from your machine. All file types can be uploaded. The uploaded file's name must not include some special characters (! @ $ % & [ ])

Procedure 4.64. Do the following to upload file into folder:

  1. Select the folder that you want to upload a file into from the left/right panel

  2. Select the Actions tab to show some actions on the Action bar.

  3. Click the [ Upload ] button on the Action bar to open the Upload a file form:

  4. Browse and select a file on your computer by clicking the Browse... button. The selected file name will be displayed in the Select a file field.

    If you want to upload multi files at the same time, click the plus icon to open more forms to upload more files:

    The trash can icon closes the upload file form.

  5. You can change the uploaded file by clicking the trash can icon and select Browse... again to select another one.

  6. By default, the name of the uploaded file will be kept as original but if you want to change, you can type the new name in the Name field, this field is not required. The new name must not contain special characters: ! @ $ % & [ ].

  7. You can click the plus icon next to the List Taxonomy field to add categories for this file:

  8. Select categories by clicking the green tick icon. Click the plus to open child nodes of categories.

  9. Complete uploading file by clicking Save.

  10. After being saved, the main information of the uploaded file will be displayed:

  11. Click the pencil icon to see more details of its external metadata information. The List external metadata tab will be enable and you can input value in this tab.

  12. Click Save to accept changes or Cancel to quit without any changes.

  13. Data can be added for the uploaded file. Check the checkbox, then click Add, or Cancel to quit without adding anything.

  14. The new metadata are displayed in the External Metadatas list and you also can edit it by clicking the pencil icon.

  15. Click Close to quit the Uploaded information form.

  16. After being uploaded, the tree is displayed in the left panel:

    File Size Limits

    The size of the uploaded file depends on the size limit of the uploaded file that you set up in the 'Edit' mode of Content Explorer. If your file size exceeds the limit, a pop-up message will appears to alert you.

This function enables an administrator to manage the permissions for nodes.

With the Permissions Management form open you can perform the following actions:

A web content is a key resource to make a site. Other resources make a site more dynamic and animated by using layout, color, font, and more.This section focuses on how to manage a web content in a specific site.

This function is used to add a new web content into a specific site.

Do the following:

Procedure 4.74. Add new content

Tabs in the Add New Document form

TheMain Content tab includes:


The Illustration tab: enables you to upload an illustration that makes the site's content more attractive


Do the following to upload an image:

The Advanced tab: This tab includes two parts: CSS data and JS data:


  1. Go to Sites Management drive, and then select a site that you want to add a web content.

  2. Select the web content folder on the left.

  3. Open a list of content templates by clicking the [ Add Document ] icon on the Action bar.

  4. Select a template to present the web content by clicking one.

  5. Enter values in the fields of the Add New Document form.

  6. Click Save or Save & Close to save the content or Close to quit the Add New Document form.

This function helps you publish a web content that you have added to web content folder in Content Explorer.

See Section 4.4.4, “Publication Process” to know how to publish a web content.

After the content is published, all users who have the right to access that position can view the published web content as a page on the Navigation bar.

In this section, we will present the actions on folders and document in the right-click menu (Add to favorites, copy, cut, paste, add Symlink, lock/unlock, view document, rename, download and allow edition and copy URL to clipboard) and other actions (drag and drop folders or documents).

Depend on the actions on folders or documents, the right-click menu (drop-down menu) is different.

The actions in the right-click menu for documents:

The actions in the right-click menu for folders:

This function is used to make a copy of a node (including sub-nodes) to other places.

There are two ways to cut/copy/paste the node:

After the action has been taken, a confirmation message will appear with detailed information about the destination path.

This function is used to move a node (include sub nodes) to other places. There are two ways to cut/paste documents:

After the action has been taken, a confirmation message will appear with detailed information about the destination path.

This function helps you remove folders/documents from theirs location easily. Do the same steps as Section 4.8.5.3, “Delete a web content”

Delete Rights

  • You can only take the Delete action if you have the right on a node.

  • If the deleted node also contains sub-nodes, these will be deleted also.

To use WebDAV with eXo Content, you first need to have the Internet or Intranet connected. Next, you can follow one of the two following ways:

Procedure 4.94. Method Two:

This method can be done through Sites Management:

  1. Navigate to http://localhost:8080/portal in your web browser.

  2. Click Group > Content Explorer in the administration bar.

  3. Click the Drives button > select Sites Management.

    You will see all sites listed in the left sidebar:

  4. Right-click the site you want to view with WebDAV and select the Download and Allow Edition item in the menu.

    The selected site will be shown in WebDAV:

    In this view, you can access documents in the directories that are linked to the web server.

There are three ways to search an existing node:

To perform an advanced search:

The tabs in this form offer different search functions:

This search enables you to search with more constraints to limit the returned results.

Extra search constraints are entered in the Advanced Search tab of the Advanced Search form.

The Current location field is not editable. It shows the path selected to search.

Procedure 4.100. 

  1. Enter search terms in the A word of phrase in content field.

  2. Select the Operator.

    • Select AND operator to only return results that meet both the search terms and the entered constraints (see Step 3).

    • Select OR operator to return results that meet either the search terms or the entered constraints (see Step 3).

  3. Click Show/hide constraints form to add more constraints.

    A further constraint options window will appear:


  4. Select the constraint operator(AND/OR).

  5. Add the required constraints using one of the following methods:

  6. Click Add to add any/all activated constraints.

    The constraints will be converted to an SQL query and displayed in the search form:

    Remove unnecessary constraints with the trash can icon.

  7. Click Search to launch the search. Results will be displayed in the Search Results tab.

  8. Click Save and put a name for this search configuration if you want to save it to use at another time.

The Search function allows you to quickly search for any contents in the system with a keyword from the front page, even if you do not log in. However, the number of the search results displayed depends on your role.

For example, if you do not log in, you only see the search results that are published.

Editing the Search portlet allows you to change the display of search results.

Do the followings:

Procedure 4.109. Edit the Search portlet

  1. Open the Search page as Section 4.12.1, “How to search for contents?”.

  2. Open the form to edit the Search portlet

    There are two way:

    • The 1st way: Turn on the Edit mode, and then click the pencil icon:

    • The 2nd way: Click Site EditorEdit Page on the administration bar. The Page Editor will be displayed.

      • Hover the mouse pointer over the SearchResult portlet and the toolbar appears:

      • Click the pencil icon to edit the portlet.

    The form to edit the Search portlet appears:

    Details:


  3. Edit your desired portlet and click Save to accept your changes.

eXo Content provides a newsletter service aiming at helping users quickly get the updated newsletters from a website.

eXo Content facilitates administrators to easily and quickly manage newsletters. Go to Group > Newsletters on the administration bar to access Newsletters.

This section details category management.

An administrator can add more subscriptions to any category. There are two ways to do this:

Do the same steps as Method One.

Administrators can create newsletters for each subscriptions.

These Newsletters can be opened, edited, deleted or converted to a template for reuse.


Each subscription consists of many newsletters. eXo Content helps you easily create newsletters by following these steps.

Procedure 4.119. Creating Newsletters

  1. Go to Group > Newsletters on the administration bar. The eXo Newsletter appears.

  2. Click the [ New Letter ] button on the action bar. The Newsletter entry formappears:

    Details:


  3. Click the scroll arrows icon to select the template for the newsletter.

  4. Click the Send Date field. The calendar will appear to allow you to choose the date and time when you want to send the newsletter.

  5. Click the scroll arrows icon in the category field to select the category and the subscription in list.

  6. Click the Update sending parameters button to update information about this newsletter. A message pops up and informs you that you have updated information successfully.

  7. Input a title of a newsletter into the Title field.

  8. Create a content for a newsletter by inputting information into the Main content text box.

  9. Click Save to save this newsletter as draft, or click Send to send this newsletter.

  10. Select Contact Us on the navigation bar, or go to Site > Acme > Contact Us.

    The Contact Us page appears:


  11. Select a recipient and enter values in this form.

  12. Click Save to save a message.

Fast Content Creator portlet in eXo Content enables you to quickly create and save a new document with only one template in a specific location without accessing Content Explorer. This helps you save a lot of time when creating a new document.

There are two modes in Fast Content Creator: Basic Content Creator and Standard Content Creator.

The Standard Content Creator mode enables you to add an action to your document. Thus, when configuring it by opening the Edit Mode tab (see the details at Section 4.14.1, “Configuration” ), there is the Actions part that enables you to add an action to the document and view actions added to the document.

To add an action to a document, click Add or the plus icon to open the Add action form. Do the same steps in Section 4.8.4.10.1, “Add an action”.

In eXo Content, the Fast Content Creator is applied in the Contact Us portlet with the Basic Content Creator mode by default. Thus, in this case, you can configure the Fast Content Creator by editing the Contact Us portlet.

To configure the Fast Content Creator, do the following:

Procedure 4.120. Configuration of Fast Content Creator

  1. Go to Contact Us on the Navigation bar or go to SiteAcmeContact Us

  2. Click Site EditorEdit Page on the administration bar. The Page Editor will be displayed.

  3. Hover the mouse over the Contact Us portlet and the tool-bar appears.

    Click the pencil icon to edit the portlet.

    The form with the Edit Mode tab appears:


  4. Select the location to save

    1. Click the magnifying glass icon to select a specific location to save documents. The Select Location form appears:

    2. Select the parent node on the left panel and click the green tick icon in the Action column to choose the child node on the right panel. After being selected, this location will be displayed on the Location to save field. Created documents will be saved in this location.

  5. Select a template which is used to create a new document.

  6. Change the label for Custom save button, and the content for Custom save message.

  7. Tick the Redirect checkbox if you want to redirect to the path in the Redirect path field after clicking OK in the save message.

  8. Click Save to finish the configuration of Fast Content Creator. There will be an inform message, click the OK button to confirm.

  9. Click Close to quit the form to edit the configuration of Fast Content Creator.

The Form Builder portlet enables users to create and to edit template of document types. Documents are stored in the so-called node; therefore, the term “node” and node types are often applied.

Category Navigation Portlet and Parameterized Content List Viewer portlet get rid of long URLs when you view a content and enable users to see published documents or web contents in specific categories in one page. Thanks to the symbolic link, no matter where the object physically resides, the database can retrieve it. In addition, the relations amongst shortcuts can be managed. Now, you can view documents or web content in the Parameterized Content List Viewer easily.

The Edit Mode of the Category Navigation Portlet

Administrators can edit the Category Navigation portlet with the following procedure:

Note

In the Edit Mode tab, some options are disable.

You can easily manage all the site resources in Content Explorer.

Chose [ Sites Management ] in General drive. All of your created sites and their resources will be listed in the left panel.

All sites contain typical folders that are site resources:

This page is used to manage all workspaces, drives, node types, metadata, templates, queries, etc. Only administrators can access the Administration page.

This page enables you to access:

Manage Tags enables you to manage tag styles. The tag style will change depending on the number of documents in a tag.

Go to Administration > Categories and Tags > Manage Tags.

Perform the steps in Add a Taxonomy Tree to add a taxonomy tree.

Procedure 5.4. Add a Taxonomy Tree

  1. Click the Add Taxonomy Tree button to add a new taxonomy. The Add taxonomy tree form will appear.

  2. Enter the taxonomy tree name in the Name field. (*Required).

  3. Select the workspace you want to work with.

  4. Select the home path by clicking the plus item. The Select Home Path form will appear:

  5. Click the tick icon if you want to select the root path or click the arrow icon to go to the up level path. Click the plus sign to expand the folder.

  6. Click the tick icon corresponding to the path that you want to select as a home path.

    Click Reset if you want to reset values that have just been selected or Next to select permissions for a taxonomy tree.

  7. Click the "Select user" icon to select a user or the "Select memberships" icon to select memberships or the "Select everyone" icon to select everyone in order to set permissions. The user or membership that you have just selected will be displayed in the User or Group field.

    Then, check at least one of these below options to set rights for the selected user to membership:

    Read Right

    The option is to select the read right or not.

    Add Note Right

    The option is to select the Add Node right or not.

    Set Property Right

    The option is to select the Set Property Right or not.

    Remove Right

    The option is to select the Remove right or not.

  8. Click Save to save all values, or Reset to change values that have just been set. After clicking Save, click Next to go to the next step.

  9. Enter the name for an action of the taxonomy tree in the Name field. (*Required).

  10. Select values for Life-cycle, NodeTypes, Target workspace, Target path, Affected Node Types. (*Required).

  11. Click Save to save all values and, click Next to go to the next step.

When creating a node in eXo Content, you must set its properties. Thus, each node needs to have a form to enter data for their properties (called the dialog template), and display the existing values (called the view template). The template management allows users to view, delete and modify the predefined templates or to add a new template.

Procedure 5.7. Edit a Template

  1. Click AdministrationContent PresentationManage Templates

  2. Click the Pencil icon in the Action column corresponding to the template you want to edit.

  3. In the Template tab, you can edit the Label of the Template.

  4. To add a dialog, do the following:

    1. Input content for this dialog in the ' Content ' field.

    2. Input name for this dialog. (*Required).

    3. Select permissions for a group that can use this dialog. (*Required).

  5. To edit an existing dialog, do the following:

    1. Click the pencil icon in the dialog row you want to edit.

    2. Edit the dialog properties.

    3. Click Save to accept all changes in the Dialog tab.

  6. To delete an existing dialog, do the following:

    1. Click the trash can icon in the dialog row you want to edit.

    2. Click OK to continue with deletion.

    Note

    You can not delete the default dialog. You must create a new one before you can delete the current default dialog.

  7. To add a view, do the following:

    1. Click the View tab and enter content into the content field.

    2. Input name for this view. (*Required).

    3. Select permissions for a group that can use this view. (*Required).

  8. To edit an existing view, do the following:

    1. Click the pencil icon in the view row you want to edit.

    2. Edit the view properties.

    3. Click Save to accept all changes in the View tab.

    Notes about Editing Views

    You cannot change the view name.

    If you click Enable Version checkbox, this view automatically increments one version after you click Save. It is displayed at ' version' column in the View tab.

    If the dialog has at least two versions, in the View tab, it displays the Restore button. You can use Restore to roll back to the previous View.

  9. To delete an existing dialog, do the following:

    1. Click the trash can icon in the dialog row you want to edit.

    2. Click OK to continue with deletion.

    3. Click Save to accept all changes.

The function Manage View is used to control view ways of a user. It has three tabs: View, ECM Templates and BC Templates tabs.

To open the Manage View function, click AdministrationContent PresentationManage View. The Manage View form displays.

Views Tab

The procedures that describe how to Add, Edit, Delete, and Preview views.

The function supports to manage drives in the File Explorer. It allows adding, editing and deleting drives.

Go to AdministrationContent PresentationManage Drives.

The function enables you to manage queries. It allows adding, editing and deleting queries.

Go to Administration > Advanced Configuration > Manage Queries.

The function enables users to manage all script codes in the eXo Content and Browser Content system.

Go to Administration > Advanced Configuration > Manage Scripts.

Details:

The BC Scripts tab:

Revision History
Revision 1-2.3Wed Dec 15 2010Scott Mumford
Exported company-specific content to separate files.
Revision 1-2.1.1Fri Nov 19 2010Scott Mumford
Updated docbook source to WCM 2.1.1
Revision 1-2.0Mon Oct 25 2010Scott Mumford, Laura Bailey, Tom Wells, Eslpeth Thorne, Rebecca Newton, Jared Morgan
Completed docbook conversion.
Revision 1-0Tue Sep 28 2010Scott Mumford
Initial creation of book by publican