# MokoSuiteCross

<!-- VERSION: 01.07.04 -->

Cross-posting Joomla content to social media, email marketing, and chat platforms for Joomla 5/6.

## Overview

MokoSuiteCross automatically publishes your Joomla articles to multiple platforms when you hit publish. Connect your social media accounts, email marketing tools, and chat channels — then cross-post with one click. Each platform is a separate plugin, so you only install what you need and third-party developers can add new services.

## Features

- **One-click cross-posting** — Publish to all connected platforms when an article goes live
- **Plugin-based services** — Each platform is a separate plugin; install only what you need
- **Default bot mode** — Pre-configured bots for Telegram (@mokosuite_bot), Discord, and Slack — just add your channel
- **Post queue** — Scheduled posting, retry on failure, detailed delivery logs
- **Message templates** — Customize post format per platform with placeholders ({title}, {url}, {social}, {short}, {chat}, {email_subject}, {email_body}, {field:xxx})
- **Share Content panel** — Per-article fields for platform-optimized text (social, short, chat, email) with image picker
- **Caption rotation** — {random:opt1|opt2|opt3} placeholder for varying evergreen re-shares
- **UTM tracking** — Auto-append UTM parameters to shared links with {platform} token
- **Delete from platforms** — Remove cross-posted content when articles are unpublished/trashed (7 platforms)
- **Post history** — Track what was posted where, with platform response data
- **Evergreen re-sharing** — Automatically re-share articles on a configurable interval
- **Category routing** — Route articles to specific services by Joomla category
- **Mailchimp templates** — Use saved Mailchimp templates with section injection, or built-in responsive email wrapper
- **Migration** — Import settings from Perfect Publisher Pro
- **REST API** — WebServices plugin for headless/external integration

### Supported Platforms (38)

#### Social Media
| Platform | Plugin | Status |
|----------|--------|--------|
| Facebook / Meta | `plg_mokosuitecross_facebook` | Implemented |
| X / Twitter | `plg_mokosuitecross_twitter` | Implemented |
| Instagram | `plg_mokosuitecross_instagram` | Implemented |
| YouTube | `plg_mokosuitecross_youtube` | Implemented |
| LinkedIn | `plg_mokosuitecross_linkedin` | Implemented |
| Mastodon | `plg_mokosuitecross_mastodon` | Implemented |
| Bluesky | `plg_mokosuitecross_bluesky` | Implemented |
| Threads | `plg_mokosuitecross_threads` | Implemented |
| Pinterest | `plg_mokosuitecross_pinterest` | Implemented |
| Reddit | `plg_mokosuitecross_reddit` | Implemented |
| TikTok | `plg_mokosuitecross_tiktok` | Implemented |
| Tumblr | `plg_mokosuitecross_tumblr` | Implemented |

#### Email Marketing
| Platform | Plugin | Status |
|----------|--------|--------|
| Mailchimp | `plg_mokosuitecross_mailchimp` | Implemented |
| SendGrid | `plg_mokosuitecross_sendgrid` | Implemented |
| Brevo | `plg_mokosuitecross_brevo` | Implemented |
| Constant Contact | `plg_mokosuitecross_constantcontact` | Implemented |
| ConvertKit | `plg_mokosuitecross_convertkit` | Implemented |

#### Chat / Messaging
| Platform | Plugin | Status |
|----------|--------|--------|
| Telegram | `plg_mokosuitecross_telegram` | Implemented |
| Discord | `plg_mokosuitecross_discord` | Implemented |
| Slack | `plg_mokosuitecross_slack` | Implemented |
| Microsoft Teams | `plg_mokosuitecross_teams` | Implemented |
| WhatsApp | `plg_mokosuitecross_whatsapp` | Implemented |
| Google Chat | `plg_mokosuitecross_googlechat` | Implemented |
| Matrix | `plg_mokosuitecross_matrix` | Implemented |
| Ntfy | `plg_mokosuitecross_ntfy` | Implemented |

#### Publishing Platforms
| Platform | Plugin | Status |
|----------|--------|--------|
| WordPress | `plg_mokosuitecross_wordpress` | Implemented |
| Medium | `plg_mokosuitecross_medium` | Implemented |
| Dev.to | `plg_mokosuitecross_devto` | Implemented |
| Ghost | `plg_mokosuitecross_ghost` | Implemented |
| Hashnode | `plg_mokosuitecross_hashnode` | Implemented |
| Blogger | `plg_mokosuitecross_blogger` | Implemented |

#### Other
| Platform | Plugin | Status |
|----------|--------|--------|
| Webhook | `plg_mokosuitecross_webhook` | Implemented |
| RSS Feed | `plg_mokosuitecross_rssfeed` | Implemented |
| ActivityPub | `plg_mokosuitecross_activitypub` | Implemented |
| Google Business | `plg_mokosuitecross_googlebusiness` | Implemented |
| Nostr | `plg_mokosuitecross_nostr` | Stub (WebSocket deferred) |

## Installation

1. Download the latest `pkg_mokosuitecross-*.zip` from [Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteCross/releases)
2. In Joomla Administrator → Extensions → Install → Upload Package File
3. System and content plugins are enabled automatically on install
4. Navigate to Components → MokoSuiteCross to connect your first service

## Documentation

See the [Wiki](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteCross/wiki) for full documentation.

## Migrating from Perfect Publisher Pro

MokoSuiteCross includes a built-in migration tool:

1. Install MokoSuiteCross (Perfect Publisher Pro can remain installed)
2. Navigate to Components → MokoSuiteCross → Dashboard
3. Click "Migrate from Perfect Publisher Pro"
4. Review detected services and confirm import

## License

GPL-3.0-or-later — See [LICENSE](LICENSE) for details.

## Author

[Moko Consulting](https://mokoconsulting.tech) — hello@mokoconsulting.tech