MokoConsulting/MokoSuiteCross
1
0
Fork 0
Code Issues 27 Pull Requests 1 Releases 5 Wiki Activity
Page: Troubleshooting
Pages Search wiki Recent changes t Print view Export wiki (ZIP)
Architecture Changelog Configuration Database-Schema Home Installation Troubleshooting
Clone
1
Troubleshooting
Jonathan Miller edited this page 2026-06-28 19:45:50 +00:00
Contents
Table of Contents

Troubleshooting

Fatal TypeError on Article Save (Joomla 6)

Error:

MokoSuiteCrossContent::onContentAfterSave(): Argument #1 ($event) must be of type
Joomla\CMS\Event\Content\AfterSaveEvent, Joomla\CMS\Event\Model\AfterSaveEvent given

Cause: Joomla 6 moved model-level events (AfterSaveEvent, ContentChangeStateEvent) from the Joomla\CMS\Event\Content namespace to Joomla\CMS\Event\Model. Display events like BeforeDisplayEvent remained in Content\.

Fix: Update to v01.12.00 or later. This version removes strict type hints on event handler parameters, using untyped $event for cross-version compatibility.

Posts Stuck in "Queued" Status

Cause: The queue processor isn't running.

Fix:

  1. Check Components -> MokoSuiteCross -> Options -> Queue Processing -- ensure it's set to "Scheduler" or "Both"
  2. If using Scheduler: verify a task exists in System -> Scheduled Tasks of type "MokoSuiteCross - Process Queue"
  3. If using Page-load: ensure the system plugin is enabled and check the throttle interval

Posts Failing

Cause: Invalid credentials or platform API changes.

Fix:

  1. Check the error message in Components -> MokoSuiteCross -> Post Queue (hover over the red "Failed" badge)
  2. Check Activity Logs for detailed error messages
  3. Go to Services and verify credentials
  4. For services using Default mode, check the plugin params in Extensions -> Plugins

"No service plugin found" Warning

Cause: The service plugin for that platform is disabled.

Fix: Go to Extensions -> Plugins, search for "MokoSuiteCross", and enable the relevant service plugin.

Cross-posting Not Triggering on Publish

Cause: Auto-post is disabled or system plugin is inactive.

Fix:

  1. Check Components -> MokoSuiteCross -> Options -- "Auto-post on Publish" should be "Yes"
  2. Verify Extensions -> Plugins -> System - MokoSuiteCross is enabled
  3. Check that at least one service is configured and enabled

Duplicate Posts

MokoSuiteCross has a built-in duplicate guard. If you're seeing duplicates:

  1. Check if the article was saved multiple times in quick succession
  2. Check if both page-load and scheduler are running (shouldn't cause duplicates, but verify)
  3. Review the Activity Logs for the article in question

OAuth Connection Failing

  1. Verify the OAuth Client ID and Secret are correct in the plugin params
  2. Check that the redirect URI matches: https://yoursite.com/administrator/index.php?option=com_mokosuitecross&task=oauth.callback
  3. Ensure your Joomla site uses HTTPS (required by most OAuth providers)

Link Shortening Not Working

  1. Ensure you have a provider configured in Components -> MokoSuiteCross -> Options -> Link Shortening
  2. Use the {url_short} placeholder in your templates (not {url})
  3. Check that your API key is valid for Bitly, Rebrandly, or YOURLS

AI Caption Generation Fails

  1. Configure a provider (Claude or OpenAI) in Components -> MokoSuiteCross -> Options -> AI Caption Generation
  2. Ensure your API key has sufficient credits/quota
  3. The article must be saved before AI generation can read its content

Nostr Publishing Fails

  1. Requires ext-gmp PHP extension for BIP-340 Schnorr signatures
  2. Check your relay URLs are reachable (WebSocket connections)
  3. Verify your private key is a valid 64-character hex string
Revision Date Author Description
2.0 2026-06-28 Moko Consulting Add Joomla 6 event fix, link shortening, AI captions, Nostr
1.0 2026-06-23 Moko Consulting Initial version
Pages