This chapter supplies you with the basic knowledge about templates, UI extension, APIs in eXo Content. Through it, you can build your own content. Also, with the step-by-step guides, you can create UI extension, deploy a workflow in eXo Content and do many different actions.
This chapter consists of the main following contents:
Overview
The templates are applied to a node type or a metadata mixin type. There are two types of templates:
Dialogs: are in the HTML form that allows creating node instances.
Views: are in the HTML fragments which are used to display nodes.
From the ECM admin portlet, the Manage Template lists existing node types associated to Dialog and/or View templates. These templates can be attached to permissions (in the usual membership:group form), so that a specific one is displayed according to the rights of the user (very useful in a content validation workflow activity).
Document Type
The checkbox defines if the node type should be considered as the Document type or not. Sites Explorer considers such nodes as user content and applies the following behavior:
View template will be used to display the document type nodes.
Document types nodes can be created by the 'Add Document' action.
Non-document types are hidden (unless the 'Show non document types' option is checked).
Templates are written by using Groovy Templates that requires some experiences with JCR API and HTML notions.
Dialogs are Groovy templates that generate forms by mixing static HTML fragments and Groovy calls to the components responsible for building the UI at runtime. The result is a simple but powerful syntax.
These following parameters are common and can be used for all input fields.
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| jcrPath |
string
|
 |
jcrPath=/node/exo:title
| The relative path inside the current node. |
| mixintype |
string with the commas (,) character. |
 |
| The list of mixin types you want to initialize when creating the content. |
| validate |
string with the comma (,) character |
|
| The list of validators you want to apply to the input. Possible values are: name, email, number, empty, null, datetime, length OR validator classes. To know how to pass parameters to validators, refer here |
| editable |
string
|
|
editable=if-null
| The input will be editable only if the value of this parameter is if-null and the value of this input is null or blank. |
| multiValues |
boolean
|
|
multiValues=true
| Show a multi-valued component if true and must be used only with corresponding multi-valued properties. The default value of this parameter is false. |
| visible |
boolean
|
|
visible=true
| The input is visible if this value is true. |
| options |
String separated by the commas (,) character. |
| A list of parameters which are input while the content templates are initialized. |
"options=toolbar:CompleteWCM,height:'410px',noSanitization" |
"name" validator:
String[] webContentFieldTitle = ["jcrPath=/node/exo:title", "validate=name", "editable=if-null"];
uicomponent.addTextField("title", webContentFieldTitle) ;
"email" validator:
String[] webContentFieldTitle = ["jcrPath=/node/exo:title", "validate=email", "editable=if-null"];
uicomponent.addTextField("title", webContentFieldTitle) ;
"number" validator:
String[] webContentFieldTitle = ["jcrPath=/node/exo:title", "validate=number", "editable=if-null"];
uicomponent.addTextField("title", webContentFieldTitle) ;
"empty" validator:
String[] webContentFieldTitle = ["jcrPath=/node/exo:title", "validate=empty", "editable=if-null"];
uicomponent.addTextField("title", webContentFieldTitle) ;
"null" validator:
String[] webContentFieldTitle = ["jcrPath=/node/exo:title", "validate=null", "editable=if-null"];
uicomponent.addTextField("title", webContentFieldTitle) ;
"datetime" validator:
String[] webContentFieldTitle = ["jcrPath=/node/exo:title", "validate=datetime", "editable=if-null"];
uicomponent.addTextField("title", webContentFieldTitle) ;
"length" validator:
For a maximum length of 50 characters:
String[] webContentFieldTitle = ["jcrPath=/node/exo:title", "validate=empty,length(50;int)", "editable=if-null"];
uicomponent.addTextField("title", webContentFieldTitle) ;
For a minimum length of 6 characters and maximum length of 50 characters:
String[] webContentFieldTitle = ["jcrPath=/node/exo:title", "validate=empty,length(6;50;int)", "editable=if-null"];
uicomponent.addTextField("title", webContentFieldTitle) ;
See also
Note
The mixintype can be used only in the root node field (commonly known as the name field).
See also: Common parameters
<%
String[] fieldTitle = ["jcrPath=/node/exo:title", "validate=empty"] ;
uicomponent.addTextField("title", fieldTitle) ;
%>
See also: Common parameters
String[] hiddenField5 = ["jcrPath=/node/jcr:content/dc:date", "visible=false"];
uicomponent.addCalendarField("hiddenInput5", hiddenField5);
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| rows | Number | | The initial text area's number of rows. The value is 10 by default. | rows=20 |
| cols | Number | | The initial text area's number of cols. The value is 30 by default . | cols=50 |
See also: Common parameters
<%
String[] fieldDescription = ["jcrPath=/node/exo:description", "validate=empty"] ;
uicomponent.addTextAreaField("description", fieldDescription) ;
%>
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| options |
string with the semicolon (;) character |
| Some options for CKEditor field: toolbar, width and height. |
options=CompleteWCM;width:'100%';height:'200px';
|
| toolbar |
string
|
| The predefined toolbar for CKEditor. The value can be: Default, Basic, CompleteWCM, BasicWCM, SuperBasicWCM. |
options=CompleteWCM
|
| width |
string
|
| The width of CKEditor. Its value can be the percent of pixel. |
options=width:'100%'
|
| height |
string
|
| The height of CKEditor. Its value can be the percent of pixel. |
options=height:'200px'
|
See also: Common parameters
<%
String[] fieldSummary = ["jcrPath=/node/exo:summary", "options=toolbar:CompleteWCM,width:'100%',height:'200px'", "validate=empty"] ;
uicomponent.addRichtextField("summary", fieldSummary) ;
%>
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| options | string | | An option for the calendar field: Display time. | options=displaytime |
See also: Common parameters
<%
String[] fieldPublishedDate = ["jcrPath=/node/exo:publishedDate", "options=displaytime", "validate=datetime", "visible=true"] ;
uicomponent.addCalendarField("publishedDate", fieldPublishedDate) ;
%>
See also: Common parameters
When you create an upload form, you can store an image by two main ways:
If you want to store the image as a property, use the following code:
<%
String[] fieldMedia = ["jcrPath=/node/exo:image"] ;
uicomponent.addUploadField("media", fieldMedia) ;
%>
If you want to store the image as a node, use the following code:
<%
String[] hiddenField1 = ["jcrPath=/node/exo:image", "nodetype=nt:resource", "visible=false"] ;
String[] hiddenField2 = ["jcrPath=/node/exo:image/jcr:encoding", "visible=false", "UTF-8"] ;
String[] hiddenField3 = ["jcrPath=/node/exo:image/jcr:lastModified", "visible=false"] ;
uicomponent.addHiddenField("hiddenInput1", hiddenField1) ;
uicomponent.addHiddenField("hiddenInput2", hiddenField2) ;
uicomponent.addHiddenField("hiddenInput3", hiddenField3) ;
String[] fieldMedia = ["jcrPath=/node/exo:image"] ;
uicomponent.addUploadField("media", fieldMedia) ;
%>
But, this code is not complete. If you want to display the upload field, the image must be blank, otherwise you can display the image and an action enables you to remove it. You can do as follows:
<%
def image = "image";
// If you're trying to edit the document
if(uicomponent.isEditing()) {
def curNode = uicomponent.getNode();
// If the image existed
if (curNode.hasNode("exo:image")) {
def imageNode = curNode.getNode("exo:image") ;
// If the image existed and available
if (imageNode.getProperty("jcr:data").getStream().available() > 0 && (uicomponent.findComponentById(image) == null)) {
def imgSrc = uicomponent.getImage(curNode, "exo:image");
def actionLink = uicomponent.event("RemoveData", "/exo:image");
%>
<div>
<img src="$imgSrc" width="100px" height="80px"/>
<a href="$actionLink">
<img src="/eXoResources/skin/DefaultSkin/background/Blank.gif" alt="" class="ActionIcon Remove16x16Icon"/>
</a>
</div>
<%
} else {
String[] fieldImage = ["jcrPath=/node/exo:image/jcr:data"] ;
uicomponent.addUploadField(image, fieldImage) ;
}
} else {
String[] fieldImage = ["jcrPath=/node/exo:image/jcr:data"] ;
uicomponent.addUploadField(image, fieldImage) ;
}
} else if(uicomponent.dataRemoved()) {
String[] fieldImage = ["jcrPath=/node/exo:image/jcr:data"] ;
uicomponent.addUploadField(image, fieldImage) ;
} else {
String[] fieldImage = ["jcrPath=/node/exo:image/jcr:data"] ;
uicomponent.addUploadField(image, fieldImage) ;
}
%>
To have multiple upload fields, you just add the multiValues=true parameter to fieldProperty in dialog1.gtmpl:
# Multi upload
fieldProperty = ["jcrPath=/node/exo:value", "multiValues=true"];
uicomponent.addUploadField("/node/exo_value", fieldProperty);
Note
In this case, you must be sure that the node type definition of the document you are currently editing should allow the document to have a child node named 'exo:value' whose node type is 'nt:unstructured'. All uploaded files of this upload component are stored in this 'exo:value' child node.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| options | string with the comma (,) characters | | Some radio values. | options=radio1,radio2,radio3 |
See also: Common parameters
<%
String[] fieldDeep = ["jcrPath=/node/exo:isDeep", "defaultValues=true", "options=radio1,radio2,radio3"];
uicomponent.addRadioBoxField("isDeep", fieldDeep);
%>
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| options | string with the comma (,) characters | | Some option values. | options=option1,option2,option3 |
See also: Common parameters
<%
String[] fieldDeep = ["jcrPath=/node/exo:isDeep", "defaultValues=true", "options=checkbox1,checkbox2,checkbox3"];
uicomponent.addCheckBoxField("isDeep", fieldDeep);
%>
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| options | string with the comma (,) characters | | Some checkbox values. | options=checkbox1,checkbox2,checkbox3 |
See also: Common parameters
<%
String[] fieldDeep = ["jcrPath=/node/exo:isDeep", "defaultValues=true", "options=checkbox1,checkbox2,checkbox3"];
uicomponent.addCheckBoxField("isDeep", fieldDeep);
%>
See also: Common parameters
<%
String[] fieldId = ["jcrPath=/node", "editable=false", "visible=if-not-null"] ;
uicomponent.addMixinField("id", fieldId) ;
%>
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| selectorClass | string | | The component to display. | selectorClass=org.exoplatform.ecm.webui.tree.selectone.UIOneNodePathSelector |
| selectorIcon | string | | The action icon. | selectorIcon=SelectPath24x24Icon |
Depending on the selectorClass, some other parameters can be added.
For example, the component org.exoplatform.ecm.webui.tree.selectone.UIOneNodePathSelector needs the following parameter:
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| workspaceField | string | | The field which enables you to select a workspace. | workspaceField=targetWorkspace |
The component org.exoplatform.ecm.webui.selector.UIPermissionSelector does not need any special parameters.
See also: Common parameters
<%
String[] fieldPath = ["jcrPath=/node/exo:targetPath", "selectorClass=org.exoplatform.ecm.webui.tree.selectone.UIOneNodePathSelector", "workspaceField=targetWorkspace", "selectorIcon=SelectPath24x24Icon"] ;
uicomponent.addActionField("targetPath", fieldPath) ;
%>
To add an interceptor to a dialog, you can use this method
uicomponent.addInterceptor(String scriptPath, String type)
| Parameters | Type | Description |
|---|---|---|
| scriptPath | string | The relative path to the script file. |
| type | string | The type of interceptor: prev or post. |
<%
uicomponent.addInterceptor("ecm-explorer/interceptor/PreNodeSaveInterceptor.groovy", "prev");
%>
To avoid refreshing the first tab for every action execution, add a new private function to the template with tabs. In the template, you must insert a new piece of code like the following:
private String getDisplayTab(String selectedTab) {
if ((uicomponent.getSelectedTab() == null && selectedTab.equals("mainWebcontent"))
|| selectedTab.equals(uicomponent.getSelectedTab())) {
return "display:block";
}
return "display:none";
}
private String getSelectedTab(String selectedTab) {
if (getDisplayTab(selectedTab).equals("display:block")) {
return "SelectedTab";
}
return "NormalTab";
}
Changing in every event of onClick must be done like the following:
<div class="UITab NormalTabStyle">
<div class="<%=getSelectedTab("mainWebcontent")%>
">
<div class="LeftTab">
<div class="RightTab">
<div class="MiddleTab" onClick="<%=uicomponent.event("ChangeTab", "mainWebcontent")%>"><%=_ctx.appRes("WebContent.dialog.label.MainContent")%></div>
</div>
</div>
</div>
</div>
<div class="UITab NormalTabStyle">
<div class="<%=getSelectedTab("illustrationWebcontent")%>
">
<div class="LeftTab">
<div class="RightTab">
<div class="MiddleTab" onClick="<%=uicomponent.event("ChangeTab", "illustrationWebcontent")%>"><%=_ctx.appRes("WebContent.dialog.label.Illustration")%></div>
</div>
</div>
</div>
</div>
<div class="UITab NormalTabStyle">
<div class="<%= getSelectedTab("contentCSSWebcontent")%>
">
<div class="LeftTab">
<div class="RightTab">
<div class="MiddleTab" onClick="<%=uicomponent.event("ChangeTab", "contentCSSWebcontent")%>"><%=_ctx.appRes("WebContent.dialog.label.Advanced")%></div>
</div>
</div>
</div>
</div>
Finally, to display the selected tab, simply add it to the style of UITabContent class.
<div class="UITabContent" style="<%=getDisplayTab("mainWebcontent")%>">
In the content management sytem, its typical feature is enabling JavaScript in a content. This causes the XSS (Cross-site Scripting) attacks to the content displayed in the HTML format.
However, there is no solution to keep JavaScript and to prevent the XSS attacks at the same time, so eXo Content allows you to decide whether JavaScript is allowed to run on a field of the content template or not by using the option parameter.
To allow JavaScript to execute, add "
options = noSanitization" to the dialog template file. Normally, this file is nameddialog1.gtmpl.
For example: The following code shows how to enable JavaScript in the Main Content field of the Free Layout Wecontent content:
String [] htmlArguments = ["jcrPath = / node / default.html / JCR: content / JCR: data", "options = toolbar: CompleteWCM, height: '410px ', noSanitization" htmlContent];
By default, there is no "
options = noSanitization" parameter in the dialog template file and this helps you prevent the XSS attacks. When end-users input JavaScript into a content, the JavaScript is automatically deleted when the content is saved.
The following is an sample code of the View template of a content node:
Get a content node to display:
<%
def node = uicomponent.getNode() ;
def originalNode = uicomponent.getOriginalNode()
%>
Display the name of the content node:
<%=node.getName()%>
Display the exo:title property of the content node:
<%
if(node.hasProperty("exo:title")) {
%>
<%=node.getProperty("exo:title").getString()%>
<%
}
%>
Display the exo:date property of the content node in a desired format. For example: "MM DD YYYY" or "YYYY MM DD".
<%
import java.text.SimpleDateFormat ;
SimpleDateFormat dateFormat = new SimpleDateFormat() ;
%>
...
<%
if(node.hasProperty("exo:date")) {
dateFormat.applyPattern("MMMMM dd yyyy") ;
%>
<%=dateFormat.format(node.getProperty("exo:date").getDate().getTime())%>
<%
}
%>
Display the translation of the Sample.view.label.node-name message in different lanaguages.
<%=_ctx.appRes("Sample.view.label.node-name")%>
The Content List Template allows you to view the content list with various templates. eXo Platform supports the following content list templates:
| Template | Description |
|---|---|
| BigHotNewsTemplateCLV.gtmpl | Display contents under one column with a content list. The illustration of each content is displayed above the content. |
| ContentListViewerDefault.gtmpl | Its function is similar to BigHotNewsTemplateCLV.gtmpl. The illustration of each content is bigger. |
| DocumentsTemplate.gtmpl | Display contents under a content list with a NodeType icon or the illustration on the left of the corresponding content. |
| EventsTemplateCLV.gtmpl | Its function is similar to BigHotNewsTemplateCLV.gtmpl, but the illustration of each content is smaller. |
| OneColumnCLVTemplate.gtmpl | Display contents under one column. The illustration of each content is displayed on its left. |
| TwoColumnsCLVTemplate.gtmpl | Display contents under two columns. The illustration of each content is displayed on its left. |
| UIContentListPresentationBigImage.gtmpl | Its function is similar to BigHotNewsTemplateCLV.gtmpl, but the illustration of each content is bigger than the image displayed with ContentListViewerDefault.gtmpl and the text font is different. |
| UIContentListPresentationDefault.gtmpl | Its function is similar to BigHotNewsTemplateCLV.gtmpl, but the illustration of each content is smaller and the text font is different. |
| UIContentListPresentationSmall.gtmpl | Display contents under one column with a content list. The images are displayed on the left of the corresponding content and smaller than the images of the other templates. |
By using WCM, all the stylesheets of each site can be managed online easily. You do not need to access the file system to modify and wait until the server has been restarted. For the structure, each site has its own CSS folder which can contain one or more CSS files. These CSS files have the data, and the priority. If they have the same CSS definition, the higher priority will be applied. You can also disable some of them to make sure the disabled style will no longer be applied into the site.
For example, a WCM demo package has two sites by default: ACME and Classic. The Classic site has a CSS folder which contains a CSS file called DefaultStylesheet. Most of the stylesheets of this site are defined within this stylesheet. Moreover, the ACME site has two CSS files called BlueStylesheet and GreenStylesheet. The blue one is enabled and the green one is disabled by default. All you need to test is to disable the blue one (by editing it and setting Available to 'false') and enable the green one. Now, back to the homepage and see the magic.
Note
Remember the cache and refresh the browser first if you do not see any changes. Normally, this is the main reason why the new style is not applied.
Basically, if you want to add a rich text area to your dialogs, you can use the addRichtextField method. However, in case you want to add the rich text editor manually, you first need to use the addTextAreaField method and some additional Javascripts as shown below:
<%
String[] fieldDescription = ["jcrPath=/node/exo:description"] ;
uicomponent.addTextAreaField("description", fieldDescription)
%>
<script>
var instances = CKEDITOR.instances['description'];
if (instances) instances.destroy(true);
CKEDITOR.replace('description', {
toolbar : 'CompleteWCM',
uiColor : '#9AB8F3'
});
</script>
REST-style architectures consist of clients and servers. Clients initiate requests to servers; servers process requests and return appropriate responses. Requests and responses are built around the transfer of "representations" of "resources". A resource can be essentially any coherent and meaningful concept that may be addressed. A representation of a resource is typically a document that captures the current or intended state of a resource.
At any particular time, a client can either be in transition between application states or "at rest". A client in a REST state is able to interact with its users, but creates no load and consumes no per-client storage on the set of servers or on the network.
The client begins sending requests when it is ready to make the transition to a new state. While one or more requests are outstanding, the client is considered to be in transition. The representation of each application state contains links that may be used the next time, the client chooses to initiate a new state transition.
REST is initially described in the context of HTTP, but is not limited to that protocol. RESTful architectures can be based on other Application Layer protocols if they already provide a rich and uniform vocabulary for applications based on the transfer of meaningful representational state. RESTful applications maximize the use of the pre-existing, well-defined interface and other built-in capabilities provided by the chosen network protocol, and minimize the addition of new application-specific features on its top.
Here is the convention you should follow:
| Method | Definition |
|---|---|
| GET | Get a Resource. Its state should not be modified. |
| POST | Create a Resource (or anything that does not fit elsewhere). |
| PUT | Update a Resource. |
| DELETE | Delete a Resource. |
The followings are formats which need to be supported for all your APIs:
The default format is JSON.
The response format can be specified by a parameter in the request: "format". You need to specify the format requested.
First, you need to register the REST service class to the configuration file in the package named conf.portal.
<configuration xmlns="http://www.exoplaform.org/xml/ns/kernel_1_1.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.exoplaform.org/xml/ns/kernel_1_1.xsd http://www.exoplaform.org/xml/ns/kernel_1_1.xsd">
<component>
<type>org.exoplatform.services.ecm.publication.REST.presentation.document.publication.PublicationGetDocumentRESTService</type>
</component>
</configuration>
You can start creating GetEditedDocumentRESTService that implements from the ResourceContainer interface as follows:
@Path("/presentation/document/edit/")
public class GetEditedDocumentRESTService implements ResourceContainer {
@Path("/{repository}/")
@GET
public Response getLastEditedDoc(@PathParam("repository") String repository,
@QueryParam("showItems") String showItems) throws Exception {
........
}
}
| Parameters | Definition |
|---|---|
| @Path("/presentation/document/edit/") | Specify the URI path which a resource or class method will serve requests for. |
| @PathParam("repository") | Bind the value repository of a URI parameter or a path segment containing the template parameter to a resource method parameter, resource class field, or resource class bean property. |
| @QueryParam("showItems") | Bind the value showItems of a HTTP query parameter to a resource method parameter, resource class field, or resource class bean property. |
This part describes how to create a sample UI extension.
In eXo Content, it is possible to extend the Sites Explorer and the ECM Administration with the UI Extension Framework. Indeed, you can add your own action buttons to the Sites Explorer and/or add your own managers to the ECM Administration.
To add your own UIAction, do as follows:
1. Create a pom.xml file with the following content:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.exoplatform.ecms</groupId>
<artifactId>exo-ecms-examples-uiextension-framework</artifactId>
<version>2.2.0-SNAPSHOT</version>
</parent>
<artifactId>exo-ecms-examples-uiextension-framework-manage-wcm-cache</artifactId>
<name>eXo WCM Cache Examples</name>
<description>eXo WCM Cache Examples</description>
<dependencies>
<dependency>
<groupId>org.exoplatform.kernel</groupId>
<artifactId>exo.kernel.container</artifactId>
<version>2.3.7-GA</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>org.exoplatform.commons</groupId>
<artifactId>exo.platform.commons.webui.ext</artifactId>
<version>1.1.8</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.exoplatform.ecms</groupId>
<artifactId>exo-ecms-core-webui</artifactId>
<version>2.3.7</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.exoplatform.ecms</groupId>
<artifactId>exo-ecms-core-webui-administration</artifactId>
<version>2.3.7</version>
<scope>provided</scope>
</dependency>
</dependencies>
<build>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.xml</include>
</includes>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
<include>**/*.jar</include>
<include>**/*.pom</include>
<include>**/*.conf</include>
<include>**/*.gtmpl</include>
<include>**/*.gif</include>
<include>**/*.jpg</include>
<include>**/*.png</include>
</includes>
</resource>
</resources>
</build>
</project>
2. Create the src/main/java directory and start launching mvn eclipse:eclipse. Then, you can launch your eclipse and import this new project.
3. Create a new class called org.exoplatform.wcm.component.cache.UIWCMCacheComponent that extends org.exoplatform.ecm.webui.component.admin.manager.UIAbstractManagerComponent.
With the Webui framework, you will be notified if any given action is triggered. You just need to call your own action listener ($ACTIONNAME) ActionListener. For example, to create your own action listener for CacheView, do as follows:
1. Call CacheViewActionListener.
2. Add a static inner class called CacheViewActionListener that extends org.exoplatform.ecm.webui.component.admin.listener.UIECMAdminControlPanelActionListener.
You will see the expected code below:
public class CacheViewComponent extends UIAbstractManagerComponent {
public static class CacheViewActionListener extends UIECMAdminControlPanelActionListener
<UIWCMCacheComponent>{
public void processEvent(Event
<UIWCMCacheComponent>event) throws Exception {
UIECMAdminPortlet portlet = event.getSource().getAncestorOfType(UIECMAdminPortlet.class);
UIECMAdminWorkingArea uiWorkingArea = portlet.getChild(UIECMAdminWorkingArea.class);
uiWorkingArea.setChild(UIWCMCachePanel.class) ;
event.getRequestContext().addUIComponentToUpdateByAjax(uiWorkingArea);
}
}
}
3. Create the src/main/java directory and launch mvn eclipse:eclipse. You can then launch your eclipse and import this new project.
4. Create a new configuration file called conf/portal/configuration.xml to register your action (see Register your UI Action) with the org.exoplatform.webui.ext.UIExtensionManager service.
To register your UI Action, do as follows:
1. Create the code:
<configuration xmlns="http://www.exoplaform.org/xml/ns/kernel_1_1.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.exoplaform.org/xml/ns/kernel_1_1.xsd http://www.exoplaform.org/xml/ns/kernel_1_1.xsd">
<external-component-plugins>
<target-component>org.exoplatform.webui.ext.UIExtensionManager</target-component>
<component-plugin>
<name>Add.Actions</name>
<set-method>registerUIExtensionPlugin</set-method>
<type>org.exoplatform.webui.ext.UIExtensionPlugin</type>
<init-params>
<object-param>
<name>CacheView</name>
<object type="org.exoplatform.webui.ext.UIExtension">
<field name="type">
<string>org.exoplatform.ecm.dms.UIECMAdminControlPanel</string>
</field>
<field name="name">
<string>CacheView</string>
</field>
<field name="category">
<string>GlobalAdministration</string>
</field>
<field name="component">
<string>org.exoplatform.wcm.component.cache.UIWCMCacheComponent</string>
</field>
</object>
</object-param>
<object-param>
<name>UIWCMCacheManager</name>
<object type="org.exoplatform.webui.ext.UIExtension">
<field name="type">
<string>org.exoplatform.ecm.dms.UIECMAdminControlPanel</string>
</field>
<field name="name">
<string>UIWCMCacheManager</string>
</field>
<field name="category">
<string>GlobalAdministration</string>
</field>
<field name="component">
<string>org.exoplatform.wcm.manager.cache.UIWCMCacheManagerComponent</string>
</field>
<field name="extendedFilters">
<collection type="java.util.ArrayList">
<value>
<object type="org.exoplatform.webui.ext.filter.impl.UserACLFilter">
<field name="permissions">
<collection item-type="java.lang.String" type="java.util.ArrayList">
<value>
<string>*:/platform/administrators</string>
</value>
</collection>
</field>
</object>
</value>
</collection>
</field>
</object>
</object-param>
</init-params>
</component-plugin>
</external-component-plugins>
</configuration>
Note
With this configuration, only the users with the *:/platform/administrators membership have the right to access the CacheView item.
2. Launch mvn clean install.
Note
All resources can be located in the src/main/resource package because the resources (*.xml, images, conf file) and the code are separated. This is very useful in a hierarchical structure.
Create ExamplePortlet_en.xml with the following content and add it to the src/main/resource package:
<bundle>
<!-- ################################################################################ # org.exoplatform.wcm.component.cache.UIWCMCacheForm
# ################################################################################ -->
<UIWCMCacheForm>
<action>
<Cancel>Cancel</Cancel>
<Save>Save</Save>
<Clear>Clear the cache</Clear>
</action>
<label>
<maxsize>Max size :</maxsize>
<livetime>Live time in sec :</livetime>
<isCacheEnable>Cache enabled(should always be on production enviroment)</isCacheEnable>
<hit>Hit count :</hit>
<currentSize>Current size</currentSize>
<miss>Miss count :</miss>
</label>
</UIWCMCacheForm>
<!-- ################################################################################ # org.exoplatform.wcm.manager.cache.UIWCMCacheManagerForm
# ################################################################################ -->
<UIWCMCacheManagerForm>
<action>
<Cancel>Cancel</Cancel>
<Save>Save</Save>
<Clear>Clear the cache</Clear>
</action>
<label>
<cacheModify>Cache to modify :</cacheModify>
<maxsize>Max size :</maxsize>
<livetime>Live time in sec :</livetime>
<isCacheEnable>Cache enabled(should always be on production enviroment)</isCacheEnable>
<hit>Hit count :</hit>
<currentSize>Current size</currentSize>
<miss>Miss count :</miss>
</label>
</UIWCMCacheManagerForm>
<UIECMAdminControlPanel>
<tab>
<label>
<GlobalAdministration>Global Administration</GlobalAdministration>
</label>
</tab>
<label>
<UIWCMCache>WCM Cache</UIWCMCache>
<UIWCMCachePanel>WCM Cache Administration</UIWCMCachePanel>
<UIWCMCacheManager>Managing Caches</UIWCMCacheManager>
<UIWCMCacheManagerPanel>WCM Cache Management</UIWCMCacheManagerPanel>
</label>
</UIECMAdminControlPanel>
</bundle>
You must add the following content to configuration.xml to register the resource bundle.
Note
By being added this configuration, the resource bundle has been completely separated from the original system. This is clearly useful for you to get an independent plugin.
<external-component-plugins>
<!-- The full qualified name of the ResourceBundleService -->
<target-component>org.exoplatform.services.resources.ResourceBundleService</target-component>
<component-plugin>
<!-- The name of the plugin -->
<name>ResourceBundle Plugin</name>
<!-- The name of the method to call on the ResourceBundleService in order to register the ResourceBundles -->
<set-method>addResourceBundle</set-method>
<!-- The full qualified name of the BaseResourceBundlePlugin -->
<type>org.exoplatform.services.resources.impl.BaseResourceBundlePlugin</type>
<init-params>
<values-param>
<name>init.resources</name>
<description>Store the following resources into the db for the first launch</description>
<value>locale.portlet.cache.ExamplePortlet</value>
</values-param>
<values-param>
<name>portal.resource.names</name>
<description>The properties files of the portal , those file will be merged
into one ResoruceBundle properties
</description>
<value>locale.portlet.cache.ExamplePortlet</value>
</values-param>
</init-params>
</component-plugin>
</external-component-plugins>
Publication add-ons for eXo Content.
This extended publication has new states and new profiles that are enabled in eXo Content.
Profiles
Author: This profile can edit a content and mark this content as redacted.
Approver: This profile approves a pending content (marked by the Author).
Publisher: This profile publishes contents or marks them as "Ready for publication" in multi-server mode.
Archiver: An administrative profile which moves contents to an archive storage.
States
enrolled: It is a pure technical state, generally used for content creation.
draft (Author): Content is in editing phase.
pending (Author): The author validates the content.
approved (Approver): A content is approved by the manager.
inreview (Manager): This state can be used when a second approval state is needed (for i18 translation for example).
staged (Publisher): A content is ready for publication (multi-server mode).
published (Publisher or Automatic): A content is published and visible in the Live mode.
unpublished (Publisher or Automatic): A content is not visible in the Live mode.
obsolete: A content can still be published but it is not in an editing lifecycle anymore.
archived (Automatic): A content is archived and ready to be moved in the archive workspace if enabled.
In most cases, you do not want to publish a content directly, but at a defined date and you can also want the content to be unpublished automatically after that. New properties are added to the new publication plugin, that allows you to manage this:
publication:startPublishedDate_
publication:endPublishedDate_
The eXo Content rendering engine does not know anything about publication dates, so another service needs to manage that. When the publisher sets start/end publication dates, he can "stage" the content. The content will go automatically to the "published" state when the start date arrives and to the "unpublished" state after end date. A cron job checks every hour (or less) all contents which need to be published (the start date in the past and the "staged" state) or unpublished (the end date in the past and the "published" state).
Thus, the publication dates are not mandatory and a content can go to:
Staged: in multi-server mode, the publisher can only put the content to the "staged" state and wait for auto-publication.
Published: in single-server mode, the publisher can directly publish a content (with or without publication dates).
<nodeType hasOrderableChildNodes="false" isMixin="true" name="publication:authoringPublication" primaryItemName="">
<supertypes>
<supertype>publication:stateAndVersionBasedPublication</supertype>
</supertypes>
<propertyDefinitions>
<propertyDefinition autoCreated="false" mandatory="true" multiple="false" name="publication:startPublishedDate" onParentVersion="IGNORE" protected="false" requiredType="Date">
<valueConstraints/>
</propertyDefinition>
<propertyDefinition autoCreated="false" mandatory="true" multiple="false" name="publication:endPublishedDate" onParentVersion="IGNORE" protected="false" requiredType="Date">
<valueConstraints/>
</propertyDefinition>
</propertyDefinitions>
</nodeType>
Note that some labels containing special or non-ASCII characters could not be well displayed in the publication UI. You can extend the width of the current UI State button by adding:
.UIPublicationPanel .StatusTable .ActiveStatus {
width: 75px !important;
}
Also, for the publication date inputs, UIPublicationPanel should not initialize the dates to any default value. The publishing and unpublish CRON jobs will do this:
A staged document with null publication start date is published instantly.
A document with null publication end date is published forever.
See the export section for more information about the CRON jobs.
The Publication Manager manages lifecycles and contexts in the eXo Content platform. It allows to manages different lifecycles based on different publication plugin in the platform.
public interface PublicationManager {
public List<Lifecycle> getLifecycles();
public List<Context> getContexts();
public Context getContext(String name);
public Lifecycle getLifecycle(String name);
public List<Lifecycle> getLifecyclesFromUser(String remoteUser, String state);
}
In which:
getLifecycles: returns a list of lifecycles (see below), with lifecycle name, publication plugin involved and possible states.
getContexts: returns a list of context, with name, related Lifecycle and other properties (see below).
getContext: returns a context by its name.
getLifecycle: returns a lifecycle by its name.
getLifecycleFromUser: returns a list of lifecycles in which the user has rights (based on membership property).
A lifecycle is defined by a simple vertical workflow with steps (states) and profiles (membership). Each lifecycle is related to a Publication plugin (compliant with the JBPM or Bonita business processes).
For example: Two lifecycles with/without states
<external-component-plugins>
<target-component>org.exoplatform.services.wcm.publication.PublicationManager</target-component>
<component-plugin>
<name>AddLifecycle</name>
<set-method>addLifecycle</set-method>
<type>org.exoplatform.services.wcm.publication.lifecycles.StatesLifecyclePlugin</type>
<init-params>
<object-param>
<name>lifecyles</name>
<object type="org.exoplatform.services.wcm.publication.lifecycles.impl.LifecyclesConfig">
<field name="lifecycles">
<collection type="java.util.ArrayList">
<value>
<object type="org.exoplatform.services.wcm.publication.lifecycles.impl.LifecyclesConfig$Lifecycle">
<field name="name">
<string>lifecycle1</string>
</field>
<field name="publicationPlugin">
<string>States and versions based publication</string>
</field>
</object>
</value>
<value>
<object type="org.exoplatform.services.wcm.publication.lifecycles.impl.LifecyclesConfig$Lifecycle">
<field name="name">
<string>lifecycle2</string>
</field>
<field name="publicationPlugin">
<string>Authoring publication</string>
</field>
<field name="states">
<collection type="java.util.ArrayList">
<value>
<object type="org.exoplatform.services.wcm.publication.lifecycles.impl.LifecyclesConfig$State">
<field name="state">
<string>draft</string>
</field>
<field name="memberships">
<collection type="java.util.ArrayList">
<value>
<string>author:/CA/communicationDG</string>
</value>
<value>
<string>author:/CA/alerteSanitaire</string>
</value>
<value>
<string>author:/CA/alerteInformatique</string>
</value>
<value>
<string>author:/CA/informations</string>
</value>
</collection>
</field>
</object>
</value>
<value>
<object type="org.exoplatform.services.wcm.publication.lifecycles.impl.LifecyclesConfig$State">
<field name="state">
<string>pending</string>
</field>
<field name="membership">
<string>author:/platform/web-contributors</string>
</field>
</object>
</value>
<value>
<object type="org.exoplatform.services.wcm.publication.lifecycles.impl.LifecyclesConfig$State">
<field name="state">
<string>approved</string>
</field>
<field name="membership">
<string>manager:/platform/web-contributors</string>
</field>
</object>
</value>
<value>
<object type="org.exoplatform.services.wcm.publication.lifecycles.impl.LifecyclesConfig$State">
<field name="state">
<string>staged</string>
</field>
<field name="membership">
<string>publisher:/platform/web-contributors</string>
</field>
</object>
</value>
<value>
<object type="org.exoplatform.services.wcm.publication.lifecycles.impl.LifecyclesConfig$State">
<field name="state">
<string>published</string>
</field>
<field name="membership">
<string>automatic</string>
</field>
</object>
</value>
</collection>
</field>
</object>
</value>
<value>
<object type="org.exoplatform.services.wcm.publication.lifecycles.impl.LifecyclesConfig$Lifecycle">
<field name="name">
<string>lifecycle3</string>
</field>
<field name="publicationPlugin">
<string>Authoring publication</string>
</field>
<field name="states">
<collection type="java.util.ArrayList">
<value>
<object type="org.exoplatform.services.wcm.publication.lifecycles.impl.LifecyclesConfig$State">
<field name="state">
<string>draft</string>
</field>
<field name="membership">
<string>author:/platform/web-contributors</string>
</field>
</object>
</value>
<value>
<object type="org.exoplatform.services.wcm.publication.lifecycles.impl.LifecyclesConfig$State">
<field name="state">
<string>published</string>
</field>
<field name="memberships">
<collection type="java.util.ArrayList">
<value>
<string>publisher:/CA/communicationDG</string>
</value>
<value>
<string>publisher:/CA/alerteSanitaire</string>
</value>
<value>
<string>publisher:/CA/alerteInformatique</string>
</value>
<value>
<string>publisher:/CA/informations</string>
</value>
</collection>
</field>
</object>
</value>
</collection>
</field>
</object>
</value>
</collection>
</field>
</object>
</object-param>
</init-params>
</component-plugin>
</external-component-plugins>
In the last example, there are three lifecycles:
Lifecycle 1: Based on StatesAndVersionsPublicationPlugin .
This allows to be backward compliant with older eXo Content releases. If all your site contents are using an existing plugin, you can create a lifecycle for it and it will work.
For new instances, you should use the new plugin with dynamic states capabilities.
Lifecycle 2: Based on AuthoringPublicationPlugin .
Visibility: Define only the "visible" steps. In this example, there is no step for "enrolled". Even if this step exists, it will not be displayed in the UI.
Automatic: Set a step as "automatic". In this mode, the step will be visible in the UI but it will be managed by the system (e.g. a cron job).
Lifecycle 3: Simulates the StatesAndVersionsPublicationPlugin plugin. Note that this simple lifecycle will work in a single server configuration.
When a state is changed, you can broadcast an event to add features. The event could look like this:
listenerService.broadcast(AuthoringPlugin.POST_UPDATE_STATE_EVENT, null, node);
Listener declaration could look like this:
<external-component-plugins>
<target-component>org.exoplatform.services.listener.ListenerService</target-component>
<component-plugin>
<name>PublicationService.event.postUpdateState</name>
<set-method>addListener</set-method>
<type>org.exoplatform.services.wcm.publication.listener.post.PostUpdateStateEventListener</type>
<description>this listener will be called every time a content changes its current state</description>
</component-plugin>
</external-component-plugins>
To perform some tasks when a content's state is updated, you need to create a listener that handles the task and configure it. Following is the general configuration:
<external-component-plugins>
<target-component>org.exoplatform.services.listener.ListenerService</target-component>
<component-plugin>
<name>PublicationService.event.postUpdateState</name>
<set-method>addListener</set-method>
<type>my.package.MyListener</type>
<description>Your listener description</description>
</component-plugin>
</external-component-plugins>
With this configuration, your listener my.package.MyListener will be executed each time a content's state is changed.
For example, eXo provides a listener which automatically sends email notifications about the new state to all users of defined groups: org.exoplatform.wcm.authoring.listener.PostUpdateStateEventListener. So, the configuration will be:
<external-component-plugins>
<target-component>org.exoplatform.services.listener.ListenerService</target-component>
<component-plugin>
<name>PublicationService.event.postUpdateState</name>
<set-method>addListener</set-method>
<type>org.exoplatform.wcm.authoring.listener.PostUpdateStateEventListener</type>
<description>This listener will send a mail when there are changes in a content's state</description>
</component-plugin>
</external-component-plugins>
A context is defined by simple rules. In eXo Content, you can select to enroll the content in a specific lifecycle (for example, publication plugin) based on context parameters. There are three parameters used to define contexts:
Remote User: The current user who can create/edit the content.
Current site name: The site from where the content is created (not the storage but the navigation).
Node: The node which you want to enroll.
From these parameters, you can easily connect and define contexts based on:
Membership: Does the current user have this membership?
Site: On this particular site, you want to enroll contents in a specific lifecycle.
Path: You can enroll contents in the lifecycles based on their path (from the Node).
Type of content: You can enroll contents in the lifecycles based on their nodetype (from the Node).
Because each site has a content storage (categories + physical storage), you can select the right lifecycle for the right storage/site. To avoid conflicts on contexts, you can set a priority (the less is the best).
For example, Different Contexts:
<external-component-plugins>
<target-component>org.exoplatform.services.wcm.publication.PublicationManager</target-component>
<component-plugin>
<name>AddContext</name>
<set-method>addContext</set-method>
<type>org.exoplatform.services.wcm.publication.context.ContextPlugin</type>
<init-params>
<object-param>
<name>contexts</name>
<object type="org.exoplatform.services.wcm.publication.context.impl.ContextConfig">
<field name="contexts">
<collection type="java.util.ArrayList">
<value>
<object type="org.exoplatform.services.wcm.publication.context.impl.ContextConfig$Context">
<field name="name">
<string>contextdefault</string>
</field>
<field name="priority">
<string>200</string>
</field>
<field name="lifecycle">
<string>lifecycle1</string>
</field>
</object>
<object type="org.exoplatform.services.wcm.publication.context.impl.ContextConfig$Context">
<field name="name">
<string>context1</string>
</field>
<field name="priority">
<string>100</string>
</field>
<field name="lifecycle">
<string>lifecycle1</string>
</field>
<field name="membership">
<string>*:/platform/web-contributors</string>
</field>
<field name="site">
<string>acme</string>
</field>
<field name="path">
<string>repository:collaboration:/sites content/live/acme/categories</string>
</field>
</object>
<object type="org.exoplatform.services.wcm.publication.context.impl.ContextConfig$Context">
<field name="name">
<string>context2</string>
</field>
<field name="priority">
<string>100</string>
</field>
<field name="lifecycle">
<string>lifecycle1</string>
</field>
<field name="site">
<string>classic</string>
</field>
</object>
<object type="org.exoplatform.services.wcm.publication.context.impl.ContextConfig$Context">
<field name="name">
<string>context3</string>
</field>
<field name="priority">
<string>80</string>
</field>
<field name="lifecycle">
<string>lifecycle3</string>
</field>
<field name="membership">
<string>manager:/company/finances</string>
</field>
<field name="path">
<string>repository:collaboration:/documents/company/finances</string>
</field>
</object>
<object type="org.exoplatform.services.wcm.publication.context.impl.ContextConfig$Context">
<field name="name">
<string>context4</string>
</field>
<field name="priority">
<string>50</string>
</field>
<field name="lifecycle">
<string>lifecycle4</string>
</field>
<field name="memberships">
<collection type="java.util.ArrayList">
<value>
<string>manager:/CA/communicationDG</string>
</value>
<value>
<string>manager:/CA/alerteSanitaire</string>
</value>
<value>
<string>manager:/CA/alerteInformatique</string>
</value>
<value>
<string>manager:/CA/informations</string>
</value>
</collection>
</field>
<field name="path">
<string>repository:collaboration:/documents/company/finances</string>
</field>
<field name="nodetype">
<string>exo:article</string>
</field>
</object>
</value>
</collection>
</field>
</object>
</object-param>
</init-params>
</component-plugin>
</external-component-plugins>
The logic is very simple. When creating a content, it should be attached a lifecycle with the lifecyle priority:
context4 is the most important (priority=50): you will enroll the content in the lifecycle "lifecycle4" if:
The content creator has the manager:/company/finances membership.
The content is stored in repository:collaboration:/documents/company/finances or any subfolders.
The content is a '
exo:article'.
If not, you will continue with context3.
The logic is very simple. When you create a content, go lifecycle by lifecycle starting with the better priority:
context4 is the most important (priority=50): you will enroll the content in the lifecycle "lifecycle4" if:
The content creator has the manager:/company/finances membership.
The content is stored in 'repository:collaboration:/documents/company/finances or any subfolders.
The content is a exo:article.
If not, you will continue with context3.
Note
The contexts will be used only when the content is created and when you want to enroll it in a lifecycle for the first time. Once you have the corresponding lifecycle, you will set the lifecycle inside the content (see New Authoring Mixin) and the context service will not be called again for this content.
<nodeType hasOrderableChildNodes="false" isMixin="true" name="publication:authoring" primaryItemName="">
<propertyDefinitions>
<propertyDefinition autoCreated="false" mandatory="false" multiple="false" name="publication:lastUser" onParentVersion="IGNORE" protected="false" requiredType="String">
<valueConstraints/>
</propertyDefinition>
<propertyDefinition autoCreated="false" mandatory="false" multiple="false" name="publication:lifecycle" onParentVersion="IGNORE" protected="false" requiredType="String">
<valueConstraints/>
</propertyDefinition>
</propertyDefinitions>
</nodeType>
When adding the content in a lifecycle, set the publication:lifecycle_ property with the corresponding lifecycle.
Note
A content can be in one lifecycle only.
Each time you change from one state to another, set the user who changed the state in publication:lastUser.
Querying based on publication status:
By adding this mixin to contents, you can access contents by simple queries based on the current user profile. For example:
All your draft contents:
query: select * from nt:base where
publication:currentState"draft" andpublication:lastUser="benjamin".
All the contents you have to approve.
call: PublicationManager.getLifecycles('benjamin','approved') => returns lifecycles where you can go to the 'approved' state.
query: select * from nt:base where publication:currentState="pending"_ and _publication:lifecycle="lifecycle1" or publication:lifecycle="lifecycle3".
All the content that will be published tomorrow.
query: select * from nt:base where publication:currentState="staged" and publication:startPublishedDate="xxxx".
| Service name | Service URL | Location | Description |
|---|---|---|---|
| ThumbnailRESTService | {portalname}/{restcontextname}/thumbnailImage/ |
Maven groupId: ArtifactId: | Return a responding data as a thumbnail image. |
Note
{portalname}: The name of the portal.
{restcontextname}: The context name of rest webapplication which is deployed to the "{portalname}" portal.
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| getThumbnailImage | {portalname}/{restcontextname}/thumbnailImage/medium/{repoName}/{workspaceName}/{nodePath}/ |
repoName workspaceName nodePath |
String
| Return an image with the medium size (64x64). |
| getLargeImage | {portalname}/{restcontextname}/thumbnailImage/large/{repoName}/{workspaceName}/{nodePath}/ |
repoName workspaceName nodePath |
String
| Return an image with the large size (300x300). |
| getSmallImage | {portalname}/{restcontextname}/thumbnailImage/small/{repoName}/{workspaceName}/{nodePath}/ |
repoName workspaceName nodePath |
String
| Return an image with the small size (32x32). |
| getCustomImage | {portalname}/{restcontextname}/thumbnailImage/custom/{size} }}/{repoName}/{workspaceName}/{nodePath}/ |
size repoName workspaceName nodePath |
String
| Return an image with the custom size. |
| getOriginImage | {portalname}/{restcontextname}/thumbnailImage/origin/{repoName}/{workspaceName}/{nodePath}/ |
repoName workspaceName nodePath |
String
| Return an image with the original size. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| RssConnector | {portalname}/{restcontextname}/feed/ |
Maven groupId: ArtifactId: | Generate an RSS feed. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| generate | {portalname}/{restcontextname}/feed/rss/ |
|
| Generate an RSS feed. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| FCKCoreRESTConnector | {portalname}/{restcontextname}/fckconnector/jcr/ |
Maven groupId: ArtifactId: | Get a list of files and folders, and create a folder and upload files. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| getFoldersAndFiles | {portalname}/{restcontextname}/fckconnector/jcr/getFoldersAndFiles/{repositoryName}/{workspaceName}/{currentFolder}/{command}/{type}/ |
|
| Return the folders and the files in the current folder. |
| createFolder | {portalname}/{restcontextname}/fckconnector/jcr/createFolder/{repositoryName}/{workspaceName}/{currentFolder}/{newFolderName}/{language}/ |
|
| Create a folder under the current folder. |
| uploadFile | {portalname}/{restcontextname}/fckconnector/jcr/uploadFile/upload/ |
servletRequest
|
HttpServletRequest
| Uploads a file with the HttpServletRequest. |
| processUpload | {portalname}/{restcontextname}/fckconnector/jcr/uploadFile/control/{repositoryName}/{workspaceName}/{currentFolder}/{action}/{language}/{fileName}/{uploadId}/ |
|
| Control the process of uploading a file, such as aborting, deleting or progressing the file. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| ResourceBundleConnector | {portalname}/{restcontextname}/bundle/ |
Maven groupId: ArtifactId: | Get the bundle basing on the key and the locale. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| getBundle | {portalname}/{restcontextname}/bundle/getBundle/{key}/{locale}/ |
|
| Get the bundle basing on the key and the locale. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| VoteConnector | {portalname}/{restcontextname}/contents/vote/ |
Maven groupId: ArtifactId: | Return and set a vote value of a given node in the sent parameter. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| postVote | {portalname}/{restcontextname}/contents/vote/postVote/{repositoryName}/{workspaceName}/{jcrPath}/{vote}/{lang}/ |
|
| Set a vote value for a given content. |
| getVote | {portalname}/{restcontextname}/contents/vote/getVote/{repositoryName}/{workspaceName}/{jcrPath}/ |
|
| Return a vote value for a given content. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| DriverConnector | {portalname}/{restcontextname}/wcmDriver/ |
Maven groupId: ArtifactId: | Return a drive list, a folder list and a document list in a specified location for a given user. Also, it processes the file uploading action. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| getDrivers | {portalname}/{restcontextname}/wcmDriver/getDrivers/ | lang |
string
| Return a list of drives for the current user. |
| getFoldersAndFiles | {portalname}/{restcontextname}/wcmDriver/getFoldersAndFiles/ |
|
| Return all folders and files in a given location. |
| uploadFile | {portalname}/{restcontextname}/wcmDriver/uploadFile/upload/ | uploadId | string | Uploads a file. |
| processUpload | {portalname}/{restcontextname}/wcmDriver/uploadFile/control/ |
|
| Control the process of uploading a file, such as aborting, deleting or processing the file. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| GadgetConnector | {portalname}/{restcontextname}/wcmGadget/ |
Maven groupId: ArtifactId: | Instantiate a new gadget connector. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| getFoldersAndFiles | {portalname}/{restcontextname}/wcmGadget/getFoldersAndFiles/{currentFolder}/{lang}/{host}/ |
|
| Get the folders and files. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| PortalLinkConnector | {portalname}/{restcontextname}/portalLinks/ |
Maven groupId: ArtifactId: | Return a page URI for a given location. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| getPageURI | {portalname}/{restcontextname}/portalLinks/getFoldersAndFiles/ |
|
| Get the page URI. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| GetEditedDocumentRESTService | {portalname}/{restcontextname}/presentation/document/edit/ |
Maven groupId: ArtifactId: | Return the latest edited documents. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| getLastEditedDoc | {portalname}/{restcontextname}/presentation/document/edit/{repository}/ | repository
| string | Return the latest edited documents. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| PublicationGetDocumentRESTService | {portalname}/{restcontextname}/publication/presentation/ |
Maven groupId: ArtifactId: | Return a list of published documents. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| getPublishDocument | {portalname}/{restcontextname}/publication/presentation/{repository}/{workspace}/{state}/ |
|
| Return a list of published document by the default plugin. |
| getPublishedListDocument | {portalname}/{restcontextname}/publication/presentation/{repository}/{workspace}/{publicationPluginName}/{state}/ |
|
| Return a list of published documents by a specific plugin. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| FavoriteRESTService | {portalname}/{restcontextname}/favorite/ |
Maven groupId: ArtifactId: | Return a list of favourite documents of a given user. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| getFavoriteByUser | {portalname}/{restcontextname}/favorite/all/{repoName}/{workspaceName}/{userName} |
|
| Return a list of favourite documents of a given user. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| RESTImagesRendererService | {portalname}/{restcontextname}/images/ |
Maven groupId: ArtifactId: | Get the image binary data of a given image node. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| serveImage | {portalname}/{restcontextname}/images/{repositoryName}/{workspaceName}/{nodeIdentifier}/ |
|
| Get the image binary data of a given image node. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| LifecycleConnector | {portalname}/{restcontextname}/authoring/ |
Maven groupId: ArtifactId: | Return a list of contents in a given state range of the publication lifecycle. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| byState | {portalname}/{restcontextname}/authoring/bystate/ |
|
| Return a list of contents from the given state to the last state. |
| toState | {portalname}/{restcontextname}/authoring/toState/ |
|
| Return a list of contents from the beginning state to the last state. |
| byDate | {portalname}/{restcontextname}/authoring/byDate/ |
|
| Return a list of contents from the given beginning state and published before the given date. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| CopyContentFile | {portalname}/{restcontextname}/copyfile/ |
Maven groupId: ArtifactId: | Copy a file. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| copyFile | {portalname}/{restcontextname}/copyfile/copy/ | param - the file information |
string
| Copy a file. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| PDFViewerRESTService | {portalname}/{restcontextname}/pdfviewer//{repoName}/{workspaceName}/{pageNumber}/{rotation}/{scale}/{uuid}/ |
Maven groupId: ArtifactId: | Return the pdf content to display on the web page |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| getCoverImage | {portalname}/{restcontextname}/pdfviewer//{repoName}/{workspaceName}/{pageNumber}/{rotation}/{scale}/{uuid}/ |
|
| Return a thumbnail image for a pdf document. |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| ManageDocumentService | {portalname}/{restcontextname}/managedocument/ |
Maven groupId: ArtifactId: | The service which is used to perform some actions on a folder or a file, such as creating, deleting a folder/file, or uploading a file. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| getDrives | {portalname}/{restcontextname}/managedocument/getDrives/ |
| string
| Get all drives by type (General, Group or Personal drive). |
| getFoldersAndFiles | {portalname}/{restcontextname}/managedocument/getFoldersAndFiles/ |
|
| Get all folders and files which the current user can view. |
| createFolder | {portalname}/{restcontextname}/managedocument/createFolder/ |
|
| Create a new folder and return its information. |
| deleteFolderOrFile | {portalname}/{restcontextname}/managedocument/deleteFolderOrFile/ |
|
| Delete a folder or a file. |
| upload | {portalname}/{restcontextname}/managedocument//uploadFile/upload/ |
|
| Upload a file to the server. |
| control | {portalname}/{restcontextname}/managedocument//uploadFile/control/ |
|
| Return the information about the upload status of a file (upload percentage, file name, and more). |
| Service name | Service URL | Location | Description |
|---|---|---|---|
| DownloadConnector | {portalname}/{restcontextname}/contents/ |
Maven groupId: ArtifactId: | Enable downloading the content of nt:file. |
APIs usage:
| Name | Service URL endpoint | Parameters | Values | Description |
|---|---|---|---|---|
| download | {portalname}/{restcontextname}/contents/download/{workspace}/{path:.*}/ |
|
| Return to browser a stream got from jcr:content/jcr:data for downloading the content of the node. |
Taxonomy service is used to work with taxonomies. In this service, there are many functions which enable you to add, find, or delete taxonomies from a node.
| Method | Param | Return | Description |
|---|---|---|---|
| getTaxonomyTree(String repository, String taxonomyName, boolean system) throws ReposioryException; |
| node | Return the root node of the given taxonomy tree. |
| getTaxonomyTree(String repository, String taxonomyName) throws RepositoryException; |
| node | Return the root node of the given taxonomy tree with the user session. |
| getAllTaxonomyTrees(String repository, boolean system) throws RepositoryException; |
| List<Node>
| Return the list of all the root nodes of the taxonomy tree available. |
| getAllTaxonomyTrees(String repository) throws RepositoryException; |
repository: The name of repository. |
List<Node> | Return the list of all the root nodes of the taxonomy tree available with the user session. |
| hasTaxonomyTree(String repository, String taxonomyName) throws RepositoryException; |
| boolean | Check if a taxonomy tree with the given name has already been defined. |
| addTaxonomyTree(Node taxonomyTree) throws RepositoryException, TaxonomyAlreadyExistsException; |
taxonomyTree: The taxonomy tree to define. | void | Define a node as a new taxonomy tree. |
| updateTaxonomyTree(String taxonomyName, Node taxonomyTree) throws RepositoryException; |
| void | Re-define a node as a taxonomy tree. |
| removeTaxonomyTree(String taxonomyName) throws RepositoryException |
taxonomyName: The name of the taxonomy to remove. | void | Remove the taxonomy tree definition. |
| addTaxonomyNode(String repository, String workspace, String parentPath, String taxoNodeName, String creator) throws RepositoryException, TaxonomyNodeAlreadyExistsException; |
| void | Add a new taxonomy node at the given location. |
| removeTaxonomyNode(String repository, String workspace, String absPath) throws RepositoryException; |
| void | Remove the taxonomy node located at the given absolute path. |
| moveTaxonomyNode(String repository, String workspace, String srcPath, String destPath, String type) throws RepositoryException; |
| void | Copy or cut the taxonomy node from the source path to the destination path. The parameter type indicates if the node must be cut or copied. |
| hasCategories(Node node, String taxonomyName) throws RepositoryException; |
| boolean | Return true if the given node has categories in the given taxonomy. |
| hasCategories((Node node, String taxonomyName, boolean system) throws RepositoryException; |
|
boolean | Return true if the given node has categories in the given taxonomy. |
| getCategories (Node node, String taxonomyName) throws RepositoryException; |
|
List<Node> | Return all the paths of the categories (relative to the root node of the given taxonomy) which have been associated to the given node for the given taxonomy. |
| getCategories(Node node, String taxonomyName, boolean system) throws RepositoryException; |
| List<Node> | Return all the paths of the categories(relative to the root node of the given taxonomy) which have been associated to the given node for the given taxonomy. |
| getAllCategories(Node node) throws RepositoryException; |
|
List<Node> | Return all the paths of the categories which have been associated to the given node. |
| getAllCategories(Node node, boolean system) throws RepositoryException; |
|
List<Node> | Return all the paths of the categories which have been associated to the given node. |
| removeCategory(Node node, String taxonomyName, String categoryPath) throws RepositoryException; |
| void | Remove a category to the given node. |
| removeCategory(Node node, String taxonomyName, String categoryPath, boolean system) throws RepositoryException; |
| void | Remove a category to the given node. |
| addCategories(Node node, String taxonomyName, String[] categoryPaths) throws RepositoryException; |
| void | Add several categories to the given node. |
| addCategories(Node node, String taxonomyName, String[] categoryPaths, boolean system) throws RepositoryException; |
| void | Add several categories to the given node. |
| addCategory(Node node, String taxonomyName, String categoryPath) throws RepositoryException; |
| void | Add a new category path to the given node. |
| addCategory(Node node, String taxonomyName, String categoryPath, boolean system) throws RepositoryException; |
| void | Add a new category path to the given node. |
| getTaxonomyTreeDefaultUserPermission(); | N/A | Map<String, String[]> | Get the default permission for the user in taxonomy tree. |
| addTaxonomyPlugin(ComponentPlugin plugin); |
plugin: The plugin to add. | void | Add a new taxonomy plugin to the service. |
| init(String repository) throws Exception; | repository: The name of repository. | void | Initialize all taxonomy plugins that have been already configured in .xml files. |
| getCategoryNameLength(); | N/A | string | Get the limited length of the category name. |
Supply API to work with the linked node or the link included in a node.
Package org.exoplatform.services.cms.link.LinkManager
| Method | Param | Return | Description |
|---|---|---|---|
| createLink(Node parent, String linkType, Node target)throws RepositoryException; |
| Node | Create a new link that is added to the parent node and return the link. |
| createLink(Node parent, Node target)throws RepositoryException; |
| Node | Create a new node of type exo:symlink, then add it to the parent node and return the link node. |
| createLink(Node parent, String linkType, Node target, String linkName) throws RepositoryException; |
| Node | Create a new link that is added to the parent node and return the link. |
| updateLink(Node link, Node target)throws RepositoryException; |
| Node | Update the target node of the given link. |
| getTarget(Node link, boolean system) throws ItemNotFoundException, RepositoryException; |
| Node | Get the target node of the given link. |
| getTarget(Node link)throws ItemNotFoundException, RepositoryException; |
link: The node of type exo:symlink. | Node | Get the target node of the given link using the user. |
| isTargetReachable(Node link) throws RepositoryException; | link: The node of type exo:symlink. | boolean | Check if the target node of the given link can be reached using the user session. |
| isTargetReachable(Node link, boolean system)throws RepositoryException; |
| boolean | Check if the target node of the given link can be reached using the user session. |
| isLink(Item item) throws RepositoryException; |
item: The item to test. | boolean | Indicate whether the given item is a link. @return <code>true</code>: if the node is a link, <code>false</code> otherwise. |
| getTargetPrimaryNodeType(Node link)throws RepositoryException; | link: The node of type exo:symlink. | string | Return the primary node type of the target. |
| getAllLinks(Node targetNode, String linkType, String repoName)throws Exception |
|
List<Node> - the list of link of the target node with given type. | Return all links of the given node. |
PublicationService is to manage the publication.
| Method | Param | Return | Description |
|---|---|---|---|
| addLifecycle(ComponentPlugin plugin) | plugin | void | Add publication plugin to the publication service. |
| removeLifecycle(ComponentPlugin plugin) | plugin
|
void
| Remove publication plugin from the publication service. |
| addContext(ComponentPlugin plugin) | plugin
|
void
| Add publication plugin context to the publication service. |
| removeContext(ComponentPlugin plugin) | plugin
|
void
| Remove publication plugin context from the publication service. |
| getLifecycle(String name) | name - The name of the wanted lifecycle. | Lifecycle | Get a specific lifecycle with the given name. |
| getLifecycles() |
N/A
| List<Lifecycle> | Get all the lifecycles which were added to service instances. |
| getContext(String name) | name | Context | Get a specific context with the given names. |
| getContexts() |
N/A | List<Context> | Get all the contexts which were added to service instances. |
| getContents(String fromstate, String tostate, String date, String user, String lang , String workspace) throws Exception; |
| List<Node> | Get all the nodes. |
| getLifecyclesFromUser(String remoteUser, String state); |
| List<Lifecycle> | Get all the Lifecycle of a specific user. |
This class is used to get contents inside the WCM product. You should not access contents directly from the JCR on the front side.
In general, this service stands between publication and cache.
Package org.exoplatform.services.wcm.publication.WCMComposer
| Method | Param | Return | Description |
|---|---|---|---|
| getContent(String repository, String workspace, String nodeIdentifier, HashMap<String, String> filters, SessionProvider sessionProvider)throws Exception; |
| Node | Return contents at the specified path based on filters. |
| getContents(String repository, String workspace, String path, HashMap<String, String> filters, SessionProvider sessionProvider)throws Exception; |
| List<Node> | Return contents at the specified path based on filters. |
| updateContent(String repository, String workspace, String nodeIdentifier, HashMap<String, String> filters)throws Exception; |
| boolean | Update content. |
| getAllowedStatesString mode)throws Exception; |
mode
| List<String> | Return allowed states for a specified mode. |
| cleanTemplates()throws Exception; | N/A | void | Initialize the template hashmap. |
| isCached()throws Exception; | N/A | boolean | Check isCache or not. |
| updateTemplatesSQLFilter()throws Exception; | N/A | String | Update all document nodetypes and write a query cause. It returns a part of the query that allows to search all document nodes and taxonomy links. Return null if there is any exception. |
Package org.exoplatform.services.cms.folksonomy.NewFolksonomyService;
| Method | Return | Prototype | Description |
|---|---|---|---|
| addPrivateTag(String[] tagsName, Node documentNode, String repository, String workspace, String userName) throws Exception ; |
| void | Add a private tag to a document. A folksonomy link will be created in a tag node. |
| addGroupsTag(String[] tagsName, Node documentNode,String repository, String workspace, String[] roles) throws Exception ; |
| void | Add a group tag to a document. A folksonomy link will be created in a tag node. |
| addPublicTag(String treePath, String[] tagsName, Node documentNode, String repository, String workspace) throws Exception ; |
| void | Add a public tag to a document. A folksonomy link will be created in a tag node. |
| addSiteTag(String siteName, String[] tagsName, Node node, String repository, String workspace) throws Exception ; |
| void | Add a site tag to a document. A folksonomy link will be created in a tag node. |
| getAllPrivateTags(String userName, String repository, String workspace) throws Exception ; |
| List<Node> | Get all private tags. |
| getAllPublicTags(String treePath, String repository, String workspace) throws Exception ; |
| List<Node> | Get all public tags. |
| getAllGroupTagsString[] roles, String repository, String workspace) throws Exception ; |
| List<Node> | Get all tags by groups. |
| getAllGroupTags(String role, String repository, String workspace) throws Exception ; |
| List<Node> | Get all tags by a group. |
| getAllSiteTags(String siteName, String repository, String workspace) throws Exception ; |
| List<Node> | Get all tags of Site. |
| getAllDocumentsByTag(String tagPath, String repository, String workspace, SessionProvider sessionProvider) throws Exception ; |
| List<Node>
| Get all documents which are stored in a tag and return a list of documents in a tag. |
| getTagStyle(String tagPath, String repository, String workspace) throws Exception ; |
| string | Get HTML_STYLE_PROP property in styleName node in the repository. |
| addTagStyle(String styleName, String tagRange, String htmlStyle, String repository, String workspace) throws Exception ; |
| void | Update the properties TAG_RATE_PROP and HTML_STYLE_PROP, following the values tagRate, htmlStyle for a node in tagPath in repository. |
| updateTagStyle(String styleName, String tagRange, String htmlStyle, String repository, String workspace) throws Exception ; |
| void | Update the properties TAG_RATE_PROP and HTML_STYLE_PROP, following the value tagRate, htmlStyle for a node in tagPath in repository. |
| getAllTagStyle(String repository, String workspace) throws Exception ; |
| List<Node> | Get all tag style bases of a folksonomy tree. |
| init(String repository) throws Exception ; |
repository: The repository name. | void | Initialize all TagStylePlugin with session in repository name. |
| removeTagOfDocument(String tagPath, Node document, String repository, String workspace) throws Exception; |
| void | Remove a tag of a given document. |
| removeTag(String tagPath, String repository, String workspace) throws Exception; |
| void | Remove a tag. |
| modifyTagName(String tagPath, String newTagName, String repository, String workspace) throws Exception; |
| Node | Modify the tag name. |
| getLinkedTagsOfDocument(Node documentNode, String repository, String workspace) throws Exception; |
| List<Node> | Get all tags linked to a given document. |
| getLinkedTagsOfDocumentByScope(int scope, String value, Node documentNode, String repository, String workspace) throws Exception; |
| List<Node> | Get all tags linked to a given document by scope. |
| removeTagsOfNodeRecursively(Node node, String repository, String workspace, String username, String groups) throws Exception; |
| void | Remove all tags linked to the child nodes of a given node. |
| addTagPermission(String usersOrGroups); |
usersOrGroups | void | Add given users or groups to tagPermissionList. |
| removeTagPermission(String usersOrGroups); |
usersOrGroups | void | Remove given users or groups from tagPermissionList. |
| getTagPermissionList(); | N/A | List<String> | Return tagPermissionList. |
| canEditTag(int scope, List<String> memberships); |
| boolean | Set the permission to edit a tag for a user. |
| getAllTagNames(String repository, String workspace, int scope, String value) throws Exception; |
| List<String> | Get all tag names which start within a given scope. |
This class is used to manage dynamic groovy templates for WCM-based products.
Package org.exoplatform.services.cms.views.ApplicationTemplateManager;
| Method | Param | Return | Description |
|---|---|---|---|
| addPlugin(PortletTemplatePlugin portletTemplatePlugin) throws Exception |
portletTemplatePlugin |
void | Add the plugin.. |
| getAllManagedPortletName(String repository) throws Exception |
repository | List<String> | Retrieve all the portlet names that have dynamic groovy templates managed by service. |
| getTemplatesByApplication(String repository, String portletName, SessionProvider provider)throws Exception; |
|
List<String> | Retrieve the templates node by application. |
| getTemplatesByCategory(String repository, String portletName, String category, SessionProvider sessionProvider) throws Exception; |
| List<String> | Retrieve the templates node by category. |
| getTemplateByName(String repository, String portletName, String category, String templateName, SessionProvider sessionProvider)throws Exception; |
| node | Retrieve the template by name. |
| getTemplateByPath(String repository, String templatePath, SessionProvider sessionProvider)throws Exception ; |
| node | Get the template by path. |
addTemplate(node portletTemplateHome, PortletTemplateConfig config)throws Exception; |
|
void | Add the template. |
| removeTemplate(String repository, String portletName, String catgory, String templateName, SessionProvider sessionProvider)throws Exception; |
|
void | Remove the template. |
NodeFinder is used to find a node with a given path. If the path to the node contains sub-paths to exo:symlink nodes, find the real link node.
| Method | Param | Return | Description |
|---|---|---|---|
| getNode(Node ancestorNode, String relativePath) throws PathNotFoundException, RepositoryException; |
| node
| Return the node at relPath related to the ancestor node. |
| getNode(Node ancestorNode, String relativePath, boolean giveTarget) throws PathNotFoundException, RepositoryException; |
|
node | Return the node at relPath related to the ancestor node. If the node is a link and giveTarget has been set to <code>true</code>, the target node will be returned. |
| getItem(String repository, String workspace, String absPath) throws PathNotFoundException, RepositoryException; |
| item
| Return the item at the specified absolute path. |
| getItemSys(String repository, String workspace, String absPath, boolean system) throws PathNotFoundException, RepositoryException; |
| item
| Return the item at the specified absolute path. |
| getItem(String repository, String workspace, String : absPath, boolean giveTarget) throws PathNotFoundException, RepositoryException; |
| item | Return the item at the specified absolute path. If the item is a link and giveTarget has been set to <code>true</code>, the target node will be returned. |
| getItemGiveTargetSys(String repository, String workspace, String absPath, boolean giveTarget, boolean system) throws PathNotFoundException, RepositoryException; |
| Item | Return the item at the specified absolute path. If the item is a link and giveTarget has been set to <code>true</code>, the target node will be returned. |
| getItem(Session session, String absPath) throws PathNotFoundException, RepositoryException; |
| item
| Return the item at the specified absolute path. |
| getItem(Session session, String absPath, boolean giveTarget) throws PathNotFoundException, RepositoryException; |
| item | Return the item at the specified absolute path. If the item is a link and giveTarget has been set to <code>true</code>, the target node will be returned. |
| getItemTarget(Session session, String absPath, boolean giveTarget, boolean system) throws PathNotFoundException, RepositoryException; |
| item | Return the item at the specified absolute path. If the item is a link and giveTarget has been set to <code>true</code>, the target node will be returned. |
| itemExists(Session session, String absPath) throws RepositoryException; |
| boolean |
Return <code>true</code> if an item exists at absPath; otherwise returns <code>false</code>. Also returns <code>false</code> if the specified absPath is malformed. |
JodConverter is used to convert documents into different office formats.
Package org.exoplatform.services.cms.jodconverter.JodConverterService
| Method | Param | Return | Description |
|---|---|---|---|
| convert(InputStream input, String formatInput, OutputStream out, String formatOutput) throws Exception; |
| void | Convert InputStream in the formatInput format to OutputStream with the formatOutput format. Deprecate: This method is not supported by JODConverter 3.0 anymore, please use convert(File, File, String) instead. |
| convert(File input, File output, String outputFormat) throws OfficeException; |
|
boolean
| Convert input File to output File with the outputFormat. |
TimelineService is used to get all documents by time frame (day, month, year).
| Method | Param | Return | Description |
|---|---|---|---|
| getDocumentsOfToday(String nodePath,String repository,String workspace, SessionProvider sessionProvider, String userName, boolean byUser) throws Exception; |
|
List<Node>
| Get all documents of today. (Deprecated) |
| getDocumentsOfToday(String nodePath,String workspace, SessionProvider sessionProvider, String userName, boolean byUser) throws Exception; |
| List<Node>
| Get all documents of today. |
| getDocumentsOfToday(String nodePath,String workspace, SessionProvider sessionProvider, String userName, boolean byUser, boolean isLimit) throws Exception; |
|
List<Node>
| Get all documents of today. |
| getDocumentsOfYesterday(String nodePath,String repository,String workspace, SessionProvider sessionProvider, String userName, boolean byUser) throws Exception; |
|
List<Node>
| Get all documents of yesterday. (Deprecated) |
| getDocumentsOfYesterday(String nodePath,String workspace, SessionProvider sessionProvider, String userName, boolean byUser) throws Exception; |
|
List<Node>
| Get all documents of yesterday. |
| getDocumentsOfYesterday(String nodePath,String workspace, SessionProvider sessionProvider, String userName, boolean byUser, boolean isLimit) throws Exception; |
|
List<Node>
| Get all documents of yesterday. |
| getDocumentsOfEarlierThisWeek(String nodePath,String repository,String workspace, SessionProvider sessionProvider, String userName, boolean byUser) throws Exception; |
|
List<Node>
| Get all documents from earlier this week to yesterday. (Deprecated) |
| getDocumentsOfEarlierThisWeek(String nodePath,String workspace, SessionProvider sessionProvider, String userName, boolean byUser) throws Exception; |
|
List<Node>
| Get all documents from earlier this week to yesterday. |
| getDocumentsOfEarlierThisWeek(String nodePath,String workspace, SessionProvider sessionProvider, String userName, boolean byUser, boolean isLimit) throws Exception; |
|
List<Node>
| Get all documents from earlier this week to yesterday. |
| getDocumentsOfEarlierThisMonth(String nodePath,String repository,String workspace, SessionProvider sessionProvider, String userName, boolean byUser) throws Exception; |
|
List<Node>
| Get all documents from earlier this month to earlier this week. (Deprecated) |
| getDocumentsOfEarlierThisMonth(String nodePath,String workspace, SessionProvider sessionProvider, String userName, boolean byUser) throws Exception; |
| List<Node>
| Get all documents from earlier this month to earlier this week. |
| getDocumentsOfEarlierThisMonth(String nodePath,String workspace, SessionProvider sessionProvider, String userName, boolean byUser, boolean isLimit) throws Exception; |
|
List<Node>
| Get all documents since earlier this month to earlier this week. |
| getDocumentsOfEarlierThisYear(String nodePath,String repository,String workspace, SessionProvider sessionProvider, String userName, boolean byUser) throws Exception; |
|
List<Node>
| Get all documents from earlier this year to earlier this month. (Deprecated) |
| getDocumentsOfEarlierThisYear(String nodePath,String workspace, SessionProvider sessionProvider, String userName, boolean byUser) throws Exception; |
|
List<Node>
| Get all documents from earlier this year to earlier this month. |
| getDocumentsOfEarlierThisYear(String nodePath,String workspace, SessionProvider sessionProvider, String userName, boolean byUser, boolean isLimit) throws Exception; |
|
List<Node>
| Get all documents from earlier this year to earlier this month. |
| getItemPerTimeline() |
N/A |
int | Get the number of documents per category displayed in the Timeline view. |
SiteSearchService is used in the Search portlet that allows users to find all information matching with your given keyword.
| Method | Param | Return | Description |
|---|---|---|---|
| addExcludeIncludeDataTypePlugin(ExcludeIncludeDataTypePlugin plugin) | plugin: The plugin. | void | Filter mimetypes data in the search results. |
| searchSiteContents(SessionProvider sessionProvider, QueryCriteria queryCriteria, int pageSize, boolean isSearchContent) throws Exception; |
|
AbstractPageList<ResultNode>
| Find all child nodes whose contents match with the given keyword. These nodes will be put in the list of search results. |
SEOService supplies APIs to manage SEO data of a page or a content. This service includes some major functions which enables you to add, store, get or remove the metadata of a page or a content.
| Method | Param | Return | Description |
|---|---|---|---|
storePageMetadata(PageMetadataModel metaModel, String portalName, boolean onContent) throws Exception |
| void
| Store the metadata of a page/content. |
| getMetadata(ArrayList<String> params, String pageReference) throws Exception |
| PageMetadataModel | Return the metadata of a portal page or a content page. |
| getPageMetadata (String pageReference) throws Exception | pageReference: The reference of the page. |
PageMetadataModel
| Return the metadata of a portal page. |
| getContentMetadata(ArrayList<String> params) throws Exception |
params: The parameters list of a content page. | PageMetadataModel
| Return the metadata of a content page. |
removePageMetadata(PageMetadataModel metaModel, String portalName, boolean onContent) throws Exception |
| void
| Remove the metadata of a page. |
| getContentNode(String contentPath) throws Exception | contentPath: The content path. | Node | Return the content node by the content path. |
| getHash(String uri) throws Exception |
uri: The page reference of the UUID of a node. |
string
| Create a key from the page reference or the UUID of the node. |
| getSitemap(String portalName) throws Exception |
portalName: The portal name. | string
| Return a sitemap's content of a specific portal. |
| getRobots(String portalName) throws Exception |
portalName: The portal name. | string
| Return Robots' content of a specific portal. |
| getRobotsIndexOptions() throws Exception | N/A | List<String> | Return a list of options (INDEX and NOINDEX) for robots to index. |
| getRobotsFollowOptions() throws Exception | N/A | List<String> | Return a list of options (FOLLOW and NOFOLLOW) for robots to follow. |
| getFrequencyOptions() throws Exception |
N/A | List<String> | Return a list of options for frequency. |
In eXo Content, there are some deprecated portlets, including Browse Content (BC), Parameterized Content Viewer (PCV), Parameterized Content List Viewer (PCLV), Category Navigation (CN), Newsletter Viewer, Newsletter Manager, Form Builder.
In which:
The BC, Newsletter Viewer, Newsletter Manager and Form Builder portlets are not used anymore.
The PCV portlet is still used, but its java class named UIPCVPortlet is replaced by UISingleContentViewerPortlet of the Single Content Viewer (SCV) portlet.
The PCLV portlet is still used, but its java class named UIPCLVPortlet is replaced by UICLVPortlet of the Content List Viewer (CLV) porlet.
The CN portlet is still used, but its java class named UICategoryNavigationPortlet is replaced by UICLVPortlet of the CLV porlet.
The addPlugin() function of WorkflowServiceContainer service is used to register a Business Process when a workflow is implemented. Thus, if you want to use a workflow, you are required to configure the workflow service to invoke the addPlugin() function by adding the external-component-plugins element to the configuration file.
You have to set values for the name and location of the workflow which you want to use. There are two ways to configure the location of the workflow.
You can use "war:(FOLDER_PATH)" to configure which .jar files contain your workflow processes inside the .war file.
<external-component-plugins>
<target-component>org.exoplatform.services.workflow.WorkflowServiceContainer</target-component>
<component-plugin>
<name>deploy.predefined.processes</name>
<set-method>addPlugin</set-method>
<type>org.exoplatform.services.workflow.PredefinedProcessesPlugin</type>
<init-params>
<object-param>
<name>predefined.processes</name>
<description>load of default business processes</description>
<object type="org.exoplatform.services.workflow.ProcessesConfig">
<field name="processLocation">
<string>war:/conf/bp</string>
</field>
<field name="predefinedProcess">
<collection type="java.util.HashSet">
<value>
<string>/exo-ecms-ext-workflow-bp-jbpm-content-2.1.1.jar</string>
</value>
<value>
<string>/exo-ecms-ext-workflow-bp-jbpm-payraise-2.1.1.jar</string>
</value>
<value>
<string>/exo-ecms-ext-workflow-bp-jbpm-holiday-2.1.1.jar</string>
</value>
</collection>
</field>
</object>
</object-param>
</init-params>
</component-plugin>
</external-component-plugins>
You can use classpath: to configure which .jar files contain your workflow processes inside the .jar file.
<external-component-plugins>
<target-component>org.exoplatform.services.workflow.WorkflowServiceContainer</target-component>
<component-plugin>
<name>deploy.predefined.processes</name>
<set-method>addPlugin</set-method>
<type>org.exoplatform.services.workflow.PredefinedProcessesPlugin</type>
<init-params>
<object-param>
<name>predefined.processes</name>
<description>load of default business processes</description>
<object type="org.exoplatform.services.workflow.ProcessesConfig">
<field name="processLocation">
<string>classpath:</string>
</field>
<field name="predefinedProcess">
<collection type="java.util.HashSet">
<value>
<string>/exo-ecms-ext-workflow-bp-jbpm-content-myworkflow.jar</string>
</value>
</collection>
</field>
</object>
</object-param>
</init-params>
</component-plugin>
</external-component-plugins>
The notification message is displayed when you deploy a workflow on Jboss. If you use classpath: to register, you must put your workflow in the .jar files inside the gatein.ear/lib folder (instead of the lib folder) to make it work.