Configuring Joomla integration

Joomla publication feature automatically publish contents from OpenKM to Joomla. OpenKM Joomla publication feature can upload HTML contents and related images from OpenKM to Joomla. 

This feature needs thirdparty software installation, ask to your OpenKM technical staff for it.

More information at Joomla publication extension 

Configuration

Configure parameters

Field / PropertyTypeDescription

joomla.url

String

The Joomla url.

http://www.yoursite.com/

joomla.user

String

The Joomla user.

User must have publish grants.

joomla.pass

String

The password of the user.

These parameters are set at Administration > Configuration parameters view.

Register metadata group

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE property-groups PUBLIC "-//OpenKM//DTD Property Groups 2.3//EN"
                                 "http://www.openkm.com/dtd/property-groups-2.3.dtd">
<property-groups>
  <property-group label="Joomla Publication" name="okg:joomla_publication">
    <input label="Id Article" type="text" name="okp:joomla_publication.article.id" readonly="true" />  
    <input label="Title" type="text" name="okp:joomla_publication.title" width="300px">
       <validator type="req"/>   
    </input> 
    <input label="Id Category" type="text" name="okp:joomla_publication.category.id" readonly="true" />        
    <select label="Category" name="okp:joomla_publication.category" type="simple">
      <option label="OpenKM Features" value="OpenKM Features"/>
      <option label="OpenKM Blog" value="OpenKM Blog"/>
      <validator type="req"/>
    </select>  
    <input label="Publish Up" type="date" name="okp:joomla_publication.publish_up" >
      <validator type="req"/>
    </input>      
    <input label="Publish Down" type="date" name="okp:joomla_publication.publish_down" />      
    <select label="State" name="okp:joomla_publication.state" type="simple">
      <option label="Published" value="1"/>
      <option label="Unpublished" value="0"/>          
      <option label="Archived" value="2"/>
      <option label="Trash" value="-2"/>
      <validator type="req"/>
    </select>
    <select label="Access" name="okp:joomla_publication.access" type="simple">
      <option label="Public" value="1"/>
      <option label="Registered" value="2" /> 
      <option label="Special" value="3"/> 
    <validator type="req"/>
    </select>      
    <select label="Language" name="okp:joomla_publication.language" type="simple">
      <option label="All" value="*"/>
      <option label="English" value="en-GB"/> 
      <option label="Spanish" value="es-ES" />           
      <validator type="req"/>
    </select>
    <select label="Synchronized" name="okp:joomla_publication.synchronized" type="simple">
      <option label="True" value="true"/>
      <option label="False" value="false"/>
      <validator type="req"/>
    </select>          
  </property-group>
  <property-group label="Joomla Media" name="okg:joomla_media" readonly="true">
    <input label="Id" type="text" name="okp:joomla_media.id" />  
    <input label="name" type="text" name="okp:joomla_media.name" />
    <input label="path" type="text" name="okp:joomla_media.path" />                   
  </property-group>
</property-groups>

More information at Administration > Metadata.

Metadata group "Joomla Publication" fields description:

FieldDescription

Id article

The joomla content id.

Title

The Joomla title.

Id Category

The joomla category id.

Category

The Joomla categories

Publish Up

The Joomla publish up date.

Publish Down

The Joomla publish down date.

State

The Joomla publication state.

Available values:

  • Published.
  • Unpublished.
  • Archived.
  • Trash.

Access

The Joomla publication access.

Available values:

  • Public.
  • Registered.
  • Special.

Language

The Joomla publication language.

Available values:

  • All.
  • English.
  • Spanish.

You can add more languages.

Metadata group "Joomla Media" fields description:

FieldDescription

Id

Description

Name

The unique Joomla filename.

URL

The Joomla media url.

Configure automation task

You must configure two automation tasks:

NameEventAtValidationActionDescription

Joomla metadata

Set property group

Post

Optional.

Joomla properties publication

Create or update contents based on metadata group changes.

Joomla content and media

Document update

Post

Optional.

Joomla content publication

Update content or media.