RadioStreamServer – Centova Cast Connector
==========================================

INSTALL OVER AN EXISTING RELEASE 2 PORTAL
1. Back up your website files and MySQL database.
2. Upload this ZIP to the same folder as the portal and extract it, overwriting files.
3. Sign in as the portal administrator.
4. Visit: YOUR-BASE-PATH/update-centova.php
5. Click Run update, then DELETE update-centova.php.
6. Open Admin > Centova settings.
7. Enter the Centova panel base URL, for example:
   https://panel.example.com:2199
   Do not add /api.php.
8. Enter the Centova administrator password and save.
9. Click Test connection.
10. Configure your Centova account templates and plan limits.
11. Open an existing pending station in Admin and click Provision in Centova Cast.

REQUIREMENTS
- PHP 8.1 or newer
- PHP cURL and OpenSSL extensions
- A Centova Cast administrator password
- The cPanel server must be able to make outbound HTTPS requests to Centova
- A valid SSL certificate is strongly recommended on the Centova panel

IMPORTANT
- Use account templates in Centova Cast for detailed Icecast/SHOUTcast/AutoDJ settings.
- The connector stores the Centova administrator password encrypted with the portal app_key.
- Customer control-panel and source passwords are generated during provisioning and encrypted.
- Keep config.php and database backups private.
- Test with a disposable station before selling accounts.

SUPPORTED ACTIONS
- Test API connectivity
- Provision client accounts
- Sync stream status
- Start, stop, and restart streams
- Suspend and enable accounts
- Display stream and encoder information in the customer portal

NOT INCLUDED YET
- Permanent account deletion (intentionally omitted to prevent accidental data loss)
- Automatic billing-triggered provisioning
- Automatic email delivery of credentials
- Full AutoDJ media management inside the RadioStreamServer portal
