# Installation

## Requirements

- Joomla 5.x or 6.x
- PHP 8.1+
- cURL extension enabled

## Install

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. Upload and install the package

The installer automatically:
- Enables the system plugin (triggers cross-posting on article publish)
- Enables the content plugin (shows cross-post status badges in admin)
- Enables the webservices plugin (REST API)
- Enables all service plugins in the `mokojoomcross` group

## Migrating from Perfect Publisher Pro

If Perfect Publisher Pro is installed, MokoJoomCross detects it and offers one-click migration:

1. Install MokoJoomCross (PP Pro can remain installed)
2. Navigate to **Components → MokoJoomCross → Dashboard**
3. Click **"Migrate from Perfect Publisher Pro"**
4. Review detected services and confirm import
5. Imported services are created in **disabled** state — verify credentials before enabling

## Uninstall

Uninstalling the package removes all MokoJoomCross database tables and data. Export any needed data before uninstalling.