MokoJoomCross/README.md

# MokoJoomCross

<!-- VERSION: 01.00.27 -->

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

## Overview

MokoJoomCross 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
- **Post queue** — Scheduled posting, retry on failure, detailed delivery logs
- **Message templates** — Customize post format per platform with placeholders ({title}, {url}, {intro}, {image})
- **Post history** — Track what was posted where, with platform response data
- **Migration** — Import settings from Perfect Publisher Pro
- **REST API** — WebServices plugin for headless/external integration

### Supported Platforms

| Platform | Plugin | Status |
|----------|--------|--------|
| Facebook / Meta | `plg_mokojoomcross_facebook` | Planned |
| X / Twitter | `plg_mokojoomcross_twitter` | Planned |
| LinkedIn | `plg_mokojoomcross_linkedin` | Planned |
| Mastodon | `plg_mokojoomcross_mastodon` | Planned |
| Bluesky | `plg_mokojoomcross_bluesky` | Planned |
| Mailchimp | `plg_mokojoomcross_mailchimp` | Planned |
| Telegram | `plg_mokojoomcross_telegram` | Planned |
| Discord | `plg_mokojoomcross_discord` | Planned |
| Slack | `plg_mokojoomcross_slack` | Planned |

## Installation

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

## Migrating from Perfect Publisher Pro

MokoJoomCross includes a built-in migration tool:

1. Install MokoJoomCross (Perfect Publisher Pro can remain installed)
2. Navigate to Components → MokoJoomCross → 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