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.

Configuration

Configure parameters

Field / Property	Type	Description
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.

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>

Metadata group “Joomla Publication” fields description:

Field	Description
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:

Field	Description
Id	Description
Name	The unique Joomla filename.
URL	The Joomla media url.

Configure automation task

You must configure two automation tasks:

Name	Event	At	Validation	Action	Description
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.