Files
Jonathan Miller 2872ae2b97
Universal: Auto Version Bump / Version Bump (push) Successful in 4s
Update Server / Update Server (push) Successful in 13s
feat: low-priority issues #19-#22
#19 Per-article cross-posting: Content plugin injects "Cross-Posting"
    fieldset into article editor via onContentPrepareForm. Dynamic
    checkbox list of all enabled services. Skip toggle. System plugin
    reads article attribs for mokojoomcross_services (array of service
    IDs) and mokojoomcross_skip (boolean). Unchecked = post to all.

#20 Analytics dashboard: Posts-by-service breakdown table with
    success rate column (color-coded). Top cross-posted articles
    list. DashboardModel methods: getServiceBreakdown(),
    getDailyTrend(), getTopArticles().

#21 OAuth flows: OAuthHelper with authorize URL generation (Facebook,
    LinkedIn, Twitter), PKCE for Twitter, code→token exchange, token
    storage in service credentials. OauthController with authorize
    and callback actions. Reads client ID/secret from plugin params.

#22 Wiki documentation: Services guide (all 9 platforms, default vs
    custom mode), REST API reference, Message Templates guide with
    examples per platform, Troubleshooting guide.

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-05-28 13:42:07 -05:00

2.0 KiB

Troubleshooting

Posts Stuck in "Queued" Status

Cause: The queue processor isn't running.

Fix:

  1. Check Components → MokoJoomCross → 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 "MokoJoomCross - 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 → MokoJoomCross → 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 "MokoJoomCross", 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 → MokoJoomCross → Options — "Auto-post on Publish" should be "Yes"
  2. Verify Extensions → Plugins → System - MokoJoomCross is enabled
  3. Check that at least one service is configured and enabled

Duplicate Posts

MokoJoomCross 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_mokojoomcross&task=oauth.callback
  3. Ensure your Joomla site uses HTTPS (required by most OAuth providers)