Installing and upgrading
Backups
Security
User management
Advanced user group options
Customising ResourceSpace
Plugins
StaticSync
Configuring ResourceSpace
Integrations

Joomla integration

Selected resources in ResourceSpace can be synchronised automatically with the media library in Joomla 5.x. Resources are added and removed as they become available, or are deleted/hidden from the ResourceSpace user.

Installation

1. Create the Joomla user in ResourceSpace

Create a user (for example with username "joomla") that will have access only to the resources you want to synchronise. Consider using a search filter to restrict access to assets, for example where a metadata field such as "publish to web" has been set to "yes", or alternatively use permissions to limit access based on a workflow status.

IMPORTANT - ensure access is appropriately limited otherwise all assets the user has access to will be copied to your Joomla media library!

Make a note of the API key which is shown when editing the user's details.

2. Install the plugin 

Download the plugin. In the Joomla admin interface go to System, then Extensions, then Upload Package File and upload the zip file from your system. Now go to System, the Extensions, Manage Extensions, search for ResourceSpace and enable the plugin.

3. Configure the plugin

Go to Components, then ResourceSpace. Select "Options".

Joomla settings

Enter the URL of your system with "/api" added, as with the example above. Enter the username and API key of the ResourceSpace Joomla user created earlier.

4. Test the integration

Going back to Components, ResourceSpace, use the search function to verify that the link with ResourceSpace is working. You can manually select resources to synchronise, however all assets can be synchronised manually if so configured.

Scheduled synchronisation

  1. Download the scheduling plugin. In the Joomla admin interface go to System, then Extensions, then Upload Package File and upload the zip file from your system. Go to System, Extensions, Manage Extensions then search for ResourceSpace and ensure both the main plugin and the newly uploaded scheduled tasks plugin is enabled.
  2. Go to System, Scheduled Tasks and click New. From the list of options choose "ResourceSpace auto import". Set the interval as appropriate.
  3. Back on System, Scheduled Tasks, select "Run Test" next to the new scheduled task and verify that resources added to ResourceSpace and made available to the Joomla user appear in your media library on execution.