Jonathan Miller
be3eb9b8e7
Cross-posting Joomla content to social media, email marketing, and chat platforms. Plugin-based service architecture with custom mokojoomcross plugin group. 14 sub-extensions: - com_mokojoomcross (admin component: dashboard, posts, services, logs) - plg_system_mokojoomcross (triggers cross-posting on article publish) - plg_content_mokojoomcross (admin article status badges) - plg_webservices_mokojoomcross (REST API) - 9 service plugins: facebook, twitter, linkedin, mastodon, bluesky, mailchimp, telegram, discord, slack Includes Perfect Publisher Pro migration tool, message templates with placeholders, post queue with retry logic, and default/custom bot modes for services supporting universal bots. Authored-by: Moko Consulting Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
40 lines
1.5 KiB
Markdown
40 lines
1.5 KiB
Markdown
# Configuration
|
|
|
|
Navigate to **Components → MokoJoomCross** to access the admin panel.
|
|
|
|
## Global Settings
|
|
|
|
Go to **Options** (toolbar gear icon) to configure:
|
|
|
|
| Setting | Default | Description |
|
|
|---------|---------|-------------|
|
|
| Auto-post on Publish | Yes | Automatically cross-post when articles are published |
|
|
| Max Retries | 3 | How many times to retry a failed post |
|
|
| Retry Delay | 300s | Seconds between retry attempts |
|
|
| Log Retention | 90 days | How long to keep activity logs |
|
|
| Default Template | `{title}\n\n{introtext}\n\n{url}` | Fallback message template |
|
|
|
|
## Message Templates
|
|
|
|
Templates use placeholders that are replaced with article data:
|
|
|
|
| Placeholder | Description |
|
|
|-------------|-------------|
|
|
| `{title}` | Article title |
|
|
| `{url}` | Full article URL |
|
|
| `{introtext}` | Article intro text (stripped of HTML, max 280 chars) |
|
|
| `{image}` | Article intro image URL |
|
|
| `{category}` | Article category name |
|
|
| `{author}` | Article author name |
|
|
|
|
You can create per-platform templates. The system checks for a platform-specific template first, then falls back to the default.
|
|
|
|
## Service Modes
|
|
|
|
Services that support universal bots offer two modes:
|
|
|
|
- **Default Mode** — Uses the pre-configured MokoWaaS bot/app. API keys are stored in the component's encrypted global params and never exposed in the individual service record.
|
|
- **Custom Mode** — You provide your own API keys, tokens, and credentials.
|
|
|
|
Services supporting default mode: **Telegram** (@MokoWaaSBot), **Facebook**, **Discord**, **Slack**
|