Joomla

The Joomla integration publishes Grandranker articles directly to your Joomla site through Joomla's built-in Web Services API. It authenticates with a Joomla API token tied to one of your Joomla users, and you choose which content category new articles are filed under and whether they arrive published or unpublished.

How to Connect

1. In your Joomla admin, go to System → Plugins and enable both Web Services - Content and User - Joomla API Token.
2. Go to Users → Manage and open the account you want to publish as (a Super User works out of the box).
3. Open the Joomla API Token tab, enable it, and save.
4. Copy the token that appears. It is only shown to that user.
5. In Grandranker, open Integrations, pick Joomla, and fill in the form:
   • Site URL: your Joomla site's address (e.g. https://yoursite.com). Not the /administrator URL.
   • API Token: the token from step 4.
6. Click Test Connection. On success, the Category dropdown loads your site's categories automatically. You can also click Load categories.
7. Pick a Category. This is where new articles are filed. Leave it unset and Grandranker uses your first category.
8. Set Default Status to Published or Unpublished.
9. Click Save & Connect.

Publishing & Verifying

Articles publish as Joomla content articles in your chosen category with your chosen status. Scheduled articles from the Content Planner publish automatically.

To verify:

• Publish one article from Grandranker.
• In Joomla admin, open Content → Articles. The article should be there, in the right category and state.
• If Published, check the article on the front end of your site. It appears wherever that category is shown by your menus/templates.

To disconnect, open the Joomla integration page and click Disconnect.

Troubleshooting

Test Connection fails

• Confirm both plugins are enabled: Web Services - Content and User - Joomla API Token. Go to System → Plugins.
• Confirm the Site URL is the public site root, with https://. Not the /administrator backend URL.
• Re-copy the API Token. It belongs to a specific user. Regenerating it in Joomla invalidates the old one.
• Your site must run Joomla 4.0 or newer. Earlier versions do not have the Web Services API.

The category list won't load

Categories load with the same site URL and token used for the connection test. A failing token blocks them too. Fix the connection first. If the connection tests fine but the list is empty, your site may have no content categories. Create one under Content → Categories in Joomla.

Articles publish but don't appear on the site

• If Default Status is Unpublished, articles wait in Joomla admin until you publish them there.
• A published article is only visible on the front end if the category it is filed in is reachable through a menu item or blog layout. Check where your chosen category is displayed on the site.

Publishing stopped after a site change

If the API token user was deleted, disabled, or had its token regenerated, publishing fails. Generate a token again (steps 2-4) and re-save the form. Security extensions that block /api paths can also break the connection. Allowlist Joomla's API endpoint.

Questions? Contact us at [email protected].