Versions Compared

Version Old Version 1 New Version 2
Changes made by

Matthew Wagner

Matthew Wagner

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
top
top

In This Section

Table of Contents
maxLevel2

...

Building Your First Plugin

Now that XperienCentral is installed, it’s time to build your first plugin. The first plugin will contain one component: the helloWorld element component. After building and deploying this plugin, there will be a new element in XperienCentral. If that element is placed on a page, the text “Hello World!” will be displayed on the web page.

 

Maven

XperienCentral requires Maven 2.0.7 or higher. The current recommended version is Maven 3.3.3. It’s very easy to check which version you are currently using: open a command prompt and type:  

...

Anchor
creating_the_helloworld_element_plugin
creating_the_helloworld_element_plugin

Creating the helloWorld Element Plugin

To create a plugin that will add an element to XperienCentral, perform the following steps:

...

A new subfolder called "helloworldelement" is now present.

Building and Deploying the Plugin

In order to build and deploy the plugin, perform the following steps:

  1. Open a command prompt window.
  2. Go to the folder C:\GX\helloWorldWCBs\helloworldelement.
  3. Execute the command:

    mvn -s ..\..\XperienCentral\settings.xml clean package

  4. Copy the file helloworldelement-1.0.0.jar from the target folder to C:\GX\XperienCentral\work\deploy.
  5. The element is now available in XperienCentral. To prevent that everybody can just use it right away, the element has to be activated first (this can be done through the
    Configuration > Channel configuration > Functionalities menu). After activation, the element is available in the menu.

 

Back to Top

 

...

Creating a Plugin with a Panel Component

After creating your first plugin with an element component, it’s time to create a new type of component: a panel. A panel is a pop-up in XperienCentral that usually contains functionality that performs maintenance on objects. An example of such a panel is the pop-up in which you can maintain web users in XperienCentral.

Creating the helloWorld Panel

To create a plugin that will add a panel to XperienCentral, perform the following steps:

  1. Open a command prompt.
  2. Navigate to the folder in which you already created your helloworldelement (C:\GX\helloWorldWCBs, for example).
  3. Execute  the command (replace <XperienCentral Version> with the version number of XperienCentral that you’re building against, (10.10.0, for example):

    mvn archetype:generate -DinteractiveMode=false -DarchetypeGroupId=nl.gx.webmanager.archetypes -DarchetypeArtifactId=webmanager-panel-archetype -DarchetypeVersion=<XperienCentral Version> -DgroupId=com.gxwebmanager.helloworld -DartifactId=helloworldpanel -Dclassprefix=HelloWorld -s ..\XperienCentral\settings.xml

    A new subfolder called "helloworldpanel" is now present.

Building and Deploying the Panel

In order to build and deploy the plugin, perform the following steps:

...

Press F5 to refresh XperienCentral - The panel is now available in XperienCentral in the Configuration menu.

 

Back to Top

 

...

Creating a Plugin with a Mediaitem Component

In XperienCentral, the Content Repository can be filled with articles and multimedia items. These objects have a predefined set of metadata. If you need additional metadata for specific types of objects in the Content Repository, a new media item can be created. For example, vacancies have an additional selection list of predefined locations in the meta-data.

...

Note

In XperienCentral, the terms "mediaitem" and "contentitem" are synonymous. For reasons of backward compatability with earlier versions of GX WebManager 9.x, these terms are used interchangeably throughout our documentation.

 

Creating the helloWorld MediaItem

To create a plugin that will add a mediaItem to XperienCentral, perform the following steps:

...

A new subfolder called "helloworldmediaitem" is now present.

Building and Deploying the MediaItem

In order to build and deploy the plugin, perform the following steps:

...

Note

If you create a custom download media item that you want to be downloadable directly from a Content Overview and/or Dynamic Content Overview element, the custom mediaItemVersionImpl should implement: nl.gx.webmanager.cms.mediarepository.MediaItemDownloadVersion.

 

Back to Top

 

...

Creating a Plugin with a Page Metadata Component

In XperienCentral, pages are the building blocks of your website. Pages have some default metadata properties like title, navigation title, publication date and so forth. The page metadata component allows the plugin programmer to add additional metadata fields to each page in XperienCentral. This section describes how to create a plugin based on the pagemetadata archetype.

Creating the helloWorld pagemetadata

To create a plugin that will add page metadata to XperienCentral, perform the following steps:

...

 A new subfolder called "helloworldpagemetadata" is now present.

Building and Deploying the pagemetadata

In order to build and deploy the plugin, take the following steps:

...

Press F5 to refresh XperienCentral - The Page Metadata component is now available in XperienCentral. For each page it is now possible to enter a value for the new properties as defined in the page metadata component.

 

Back to Top

 

...

Creating a Plugin with a Presentation Component

Each XperienCentral page is connected to a presentation (appearance). A presentation is connected to its own JSP template, used by XperienCentral to generate the HTML of the page. With this component it is possible to create new presentation. Presentations can have small differences (like another lead color or logo) or can be completely different.

Creating the helloWorld Presentation

To create a plugin that will add a new presentation style to XperienCentral, perform the following steps:

...

A new subfolder called "helloworldpresentation" is now present.

Building and Deploying the Presentation Component

In order to build and deploy the plugin, perform the following steps:

...

The style is now available in XperienCentral.

 

Back to Top

 

...

Creating a Plugin with a Service Component

A service component is a so-called headless service - It has no user interface. Examples of services are mailing services, newsfeed imports, storage services and scheduling services. Often a service is used as support for components that work together, like a bookstore panel and a bookstore element: they depend on a service that regulates the storage of the content of the business objects.

Creating the helloWorld Service

To create a plugin that will add a new service component to XperienCentral, perform the following steps:

  1. Open a Command prompt.
  2. Navigate to the folder in which you already created your helloworldelement (C:\GX\helloWorldWCBs).
  3. Execute the command (replace <XperienCentral Version> with the version number of XperienCentral that you’re building against (10.6.0, for example):

    mvn archetype:generate -DinteractiveMode=false -DarchetypeGroupId=nl.gx.webmanager.archetypes -DarchetypeArtifactId=webmanager-service-archetype -DarchetypeVersion=<XperienCentral Version> -DgroupId=com.gxwebmanager.helloworld -DartifactId=helloworldservice -Dclassprefix=HelloWorld -s ..\XperienCentral\settings.xml

    A new subfolder called "helloworldservice" is now present.

Building and Deploying the Service Component

In order to build and deploy the plugin, perform the following steps:

...

The service is now available to other plugins in XperienCentral.

 

Back to Top

 

...

Creating a Plugin with a Servlet Component

A servlet is a Java program that runs in a web container. A servlet is an object that receives a request and generates a response based on that request. Examples of servlets are the controller and show servlet of XperienCentral. An example use case of a servlet: a servlet that handles AJAX calls.

Creating the helloWorld Servlet

To create a plugin that will add a new servlet component to XperienCentral, perform the following steps:

  1. Open a command prompt.
  2. Navigate to the folder in which you already created your helloworldelement (C:\GX\helloWorldWCBs).
  3. Execute the command (replace <XperienCentral Version> with the version number of XperienCentral that you’re building against (10.6.0, for example):

    mvn archetype:generate -DinteractiveMode=false -DarchetypeGroupId=nl.gx.webmanager.archetypes -DarchetypeArtifactId=webmanager-servlet-archetype -DarchetypeVersion=<XperienCentral Version> -DgroupId=com.gxwebmanager.helloworld -DartifactId=helloworldservlet -Dclassprefix=HelloWorld -s ..\XperienCentral\settings.xml

    A new subfolder called "helloworldservlet" is now present.

Building and Deploying the Servlet Component

In order to build and deploy the plugin, perform the following steps:

...

helloworldservlet - Hello World!
Init parameter: ‘key’ = ‘value’

 

Back to Top

 

...

Troubleshooting

The Plugin Does not Compile

Sun Microsystems provides two versions of Java for download on http://java.sun.com/:

...

  1. Open the menu Window > Preferences > Java > Installed JREs.
  2. Ensure that a JDK version of Java is used in your JRE definition
  3. If the used JRE definition points to a JRE version of Java, then remove the reference to the JRE and create a new reference to the JDK.

 

Back to Top