📰 ContentSync
▶️ Data Import & Export
✍️ Joomill

Version: 1.0.0
Developer: Joomill
License: GPLv2 or later
Type: Free download
Includes: Plugin
Compatibility: J5, J6

⬇️ Download
🌐 Demo
❓ Support
📚 Documentation

Mirror articles from one Joomla site to another as a scheduled task. Images come along, categories, authors and access levels are mapped, and a dry run shows what will change first.

What it does

You publish an article on one Joomla site and want it on another one too. So you copy the text, upload the images again, fix the paths and pick the category. And you do it again when the article changes.

ContentSync does that for you. It is a task for the Joomla Task Scheduler that fetches articles from a source site through the Joomla Web Services API and creates, updates or removes them on the site it is installed on. Set it up once, give it a schedule, and the target site follows the source.

The sync runs one way: from the source site to the site with the plugin. An article that has not changed on the source since the last run is skipped.

How it works


- Create an API token on the source site. In Users, open a user and copy the token from the Joomla API Token tab. Nothing has to be installed on the source.
- Add the task on the target site. In System > Scheduled Tasks, choose "Content Sync: Synchronise Articles" and enter the source site URL and the token.
- Choose what to sync and where it goes. Set the filters, the target category and the mappings.
- Give it a schedule. The Joomla Task Scheduler runs it from then on.


You can add the task more than once, for instance one task per source site or per category.

Sync only what you need

The filters are applied on the source, so only matching articles are fetched:


- Category IDs
- Tag IDs
- Language
- Publication state
- Featured, not featured, or both
- Workflow stage (needs Joomla 6.2 or newer on the source)


Everything lands in the right place

IDs are different on every site. ContentSync maps them instead of copying them:


- Categories. One target category for everything, or a mapping from source category to local category.
- Tags. A mapping from source tag to local tag. Leave it empty to skip tags.
- Authors. A mapping from source user to local user, with a default author for everyone else.
- Access levels. A mapping from source view level to local view level.


Members-only stays members-only

View level 4 on the source is not the same audience as view level 4 on the target. Reusing the number can publish a members-only article to everyone. The levels Joomla installs (Public, Registered, Special, Guest and Super Users) have the same ID on every site and are carried over as they are. For an article with a view level you created yourself that is not in your mapping, you choose what happens:


- Use the most restrictive local view level (the default)
- Skip the article
- Reuse the number from the source, for sites with identical view levels


Images mirrored

Images in the article text and in the intro and full article image fields are downloaded and stored in the same folder structure on the target site.


- Only JPG, PNG, GIF, WebP and AVIF files are written, and the file type must match its extension.
- Images are only written inside the folders you allow: images and files by default, the folders of the Joomla Media Manager.
- An image that already exists is not downloaded again.


Documents, audio and video too

Switch on Mirror Documents and Media and the files your articles link to or play come along as well: PDF, Word, Excel, PowerPoint and OpenDocument