MediaCP Manual
WHMCS integratiegids

Last updated 2 maanden ago

Overzicht

Integratie met WHMCS stelt u in staat om serviceplannen in te stellen om audio- en videostreamingservices te verkopen met automatische installatie en provisioning van klant- en streamingaccounts.

Opmerkingen bij de release van de module

Changelog is beschikbaar op GitHub.

Whmcs-module

Installeer de nieuwste module

1. Zorg ervoor dat u de nieuwste versie van MediaCP hebt

2. Download de nieuwste versie van de MediaCP-module voor WHMCS

3. Pak het .zip-bestand uit naar uw bureaublad

4. Maak verbinding met uw WHMCS-server via FTP en navigeer naar [WHMCS]/modules/servers

5. Sleep de mediacp-map van uw bureaublad naar uw FTP-client om de bestanden te uploaden.

6. U zou nu de mediacp-map in uw [WHMCS]/modules/servers-pad op de ftp-server moeten zien

Het toevoegen van een server in WHMCS

  1. Log in op WHMCS als beheerder en navigeer naar
    Systeeminstellingen.
  2. Selecteer Producten en services inhet linkermenu en selecteer vervolgens de optie Servers .
  3. Selecteer de knop + Nieuwe server toevoegen boven aan de pagina en vul het formulier in.
  4. Selecteer
    Ga naar geavanceerde modus
  5. Vul het formulier in volgens de onderstaande gegevens:
    • Naam – Voer een label in voor deze server.
    • Hostnaam – Voer het primaire domein of subdomein in waarop MediaCP is geïnstalleerd, zoals streaming.myserver.com
    • IP-adres – voer het IP-adres van de MediaCP-server in, dit wordt door WHMCS gebruikt om de toegang tot de poorten te valideren.
    • Server status adres – Dit wordt gebruikt om de netwerkstatus en belasting aan WHMCS te verstrekken. MediaCP biedt een speciale URL die u in de WHMCS-serverconfiguratie kunt plakken. Als u de onlinestatus in WHMCS wilt weergeven, moet u er eerst voor zorgen dat MediaCP-poort 80 is ingeschakeld.

      De indeling van het WHMCS-statusadres wordt hieronder beschreven, waarbij yourdomain.com:2020 wordt vervangen door de MediaCP-hostnaam en -poort en
      {api-key}
      door uw MediaCP API-sleutel.

      https://yourdomain.com:2020/whmcs-status/{api-key}/

      Voorbeeld:

      https://demo.mediacp.net/whmcs-status/iMtTpHvVWMjMh8dZgn6n0Vqoq3aWyomKmp-KjMV9W5uY06eepH2Mxg==/
    • Module – Media Configuratiescherm
    • Gebruikersnaam – Gebruikersnaam beheerder, standaard ingesteld op “admin”
    • Wachtwoord- Dit veld wordt niet gebruikt.
    • Toegang tot hash – Geef de MediaCP API-sleutel op in dit veld.
    • Veilig – Vink dit vakje aan als HTTPS/SSL is geconfigureerd met MediaCP (standaard AAN).
    • Poort – De primaire poort die MediaCP-software gebruikt. Standaard is 2020. Wijzig alleen als u een alternatieve poort voor MediaCP Web hebt geconfigureerd.
    • Naamservers – deze informatie is niet vereist voor de MediaCP-module.
  6. Druk op de knop Wijzigingen opslaan om te voltooien.

Uw eerste product maken

U bent nu klaar om uw eerste product voor de MediaCP te maken en te configureren.

1. Navigeer naar Setup -> Producten/Services. Klik vervolgens op Een nieuw product maken.

2. Selecteer Shared Hosting Account en selecteer een geschikte productgroep en naam en klik op Doorgaan.

nieuw-product

3. Selecteer het tabblad Module-instellingen en vul de basisinstellingen naar wens in.

whmcs_module_settings

4. Druk op Wijzigingen opslaan

Aanvullend

Configureerbare opties

U kunt uw klanten hun eigen pakketten laten bouwen door Configureerbare opties in te stellen.

  1. Navigeer naar Setup-producten/diensten-configureerbare opties.
  2. Druk op Een nieuwe groep maken
  3. Configureer de groepsnaam en toegewezen producten en druk vervolgens op Nieuwe configureerbare optie toevoegen.
  4. Raadpleeg de onderstaande tabel om uw pakket opties op te bouwen. Het is belangrijk dat de opties correct worden geëtiketteerd, u ervoor kiezen om ofwel gebruik maken van de configureerbare optie of alternatieven voor de optie namen.
Media service – SHOUTcastshoutcast 2SHOUTcast 198icecasticecast 2icecast 2 KHicecast KHWowza Streaming EngineFlash Media serviceWindows Media Diensten Bron AutoDJ SHOUTcast transcoderv1 shoutcast transcoderv2 0,4 (MP3)ICES 2,0 (Ogg)stream transcoder v3 Als alternatief u deze waarde instellen op ja en de module zal automatisch configureren SHOUTcast transcoder v2.Verbindingen Luistererskijkersmaximale gebruikersmaximale luisterersmaximale kijkers Numerieke waarde Voer een waarde in tussen 0 en 9999. Bitrate Maximale bitrate 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 400, 480 , 560, 640, 720, 800, 920, 1024, 1280, 1536, 1792, 2048, 2560

Schijf gebruik Schijfquotum schijfquotum MB, GB of TB

Gegevensoverdracht Overdrachtbandbreedte MB, GB of TB

Beschrijving van configureerbare optiealternatieven
Mountpoints Numerieke waarde Aantal mountpoints dat de Shoutcast- of Icecast-service zal bevatten.
Moet een geheel getal zijn.
Numerieke waarde van AutoDJ-bronnen Aantal AutoDJ-bronnen dat kan worden toegepast op mountpoints op Shoutcast- en Icecast-services.
Moet een geheel getal zijn.
Stream Proxy Stream Proxy Yes
No
Schakel de HTTP/HTTPS-streamproxy in of uit op het account
Geo Locking Geolock
Country Locking
Ja
Nee
Toestaan of niet toestaan van geo country locking ondersteuning op service
Bron Reencode AutoDJ Reencode Ja
Geen
ICES 0.4 ALLEEN
Voer slechts een van de waarden in de kolomopties in. Dit kan ook “kbps” aan het eind van de optiewaarde bevatten.
Geef een waarde op waaronder MB, GB of TB. Bijvoorbeeld: 100MB
Geef een waarde op waaronder MB, GB of TB. Bijvoorbeeld: 100MB
Historische rapportage Geavanceerde
rapportage
Ja / Nee Historische rapportagemogelijkheden in-of uitschakelen. Het tabblad standaard gebruik wordt in beide gevallen weergegeven.
Stream Authentication Stream Authentication
Listener Authentication
Stream Auth
Ja / Nee Icecast &Icecast KH-services ALLEEN
in- of uitschakelt de verificatiefunctie voor listenerstreams.

Stream Publishing Opties (Wowza &Flussonic)

Configureerbare optie Alternatieven Opties Beschrijving
Stream Publishing Stream Targets Ja / Nee Schakelt alle streamdoelen in
Facebook Publiceren Ja / Nee
Youtube Publiceren Ja / Nee
Periscope Publishing Ja / Nee
Twitch Publishing Ja / Nee
Shoutcast Publishing Ja / Nee
Icecast Publishing Ja / Nee
RTMP Publishing Ja / Nee

Wowza streaming motor

Wowza Media TypeService TypeFlash Media ServiceLive StreamingLive Streaming Low LatencyTV StationOndemand StreamingShoutcast/Icecast RelayLive Camera Restream Live Authentication-YesNoWowza Streaming Engine ONLY.nDVR AddOnnDVRnDVR PlaybackYesNoWowza Streaming Engine ONLY.Stream RecordingLive Stream RecordingYesNoWowza Streaming Engine ONLY. RTMPRTMP SupportRTMP ServiceYesNoEnable RTMP/RTSP links for Shoutcast & Icecast Services ONLY.
Beschrijving van configureerbare optiealternatieven
Transcoderprofielen Transcoderprofielen 160p
240p
360p
480p
576p
720p
1080p
2160p
Passthru
Door komma’s gescheiden lijst van transcoderprofielen.
Beschikbaar met MediaCP 2.6 +
Bijvoorbeeld:
240p
360p, 576p
240p, 360p, 480p
480p, 750p, 1080p

Flussonic Media server

Service type Service type Live streamingTV stationOnDemand streaming
Configureerbare optie Alternatieven Opties Beschrijving
Transcoder Profielen Transcoder Profielen 160p
240p
360p
480p
576p
720p
1080p
2160p
Passthru

Door komma’s gescheiden lijst met transcoder-profielen.

Beschikbaar met MediaCP 2.6 +

Bijvoorbeeld:
240p
360p, 576p
240p, 360p, 480p
480p, 750p, 1080p

nDVR AddOn nDVR Ja / Nee

Aangepaste velden

Met aangepaste velden kunnen klanten specifieke tekstwaarden invoeren voor bepaalde configuraties.

Beschrijving van veldnaamveldtype validatie
Tekstvak Naam publiceren /^[a-zd_]{4,28}$/i Beschikbaar voor alle media-service typen.
De klant kan de gewenste publicatienaam opgeven. Als deze niet beschikbaar is, wordt de naam automatisch bijgewerkt.
Controleer het vereiste veld en toon op bestelformulier.
Shoutcast URL Text Box-WOWZA SERVICES ALLEEN.
De klant kan zijn Shoutcast Restream-URL of IPCAM Restream-URL opgeven.
Alternatieve veldnamen kunnen zijn:
Icecast URL
Restream Address
IPCAM URL
IPCAM Address
Wowza VHost Drop Down-WOWZA SERVICES ALLEEN.
Alleen beheerder.
Verplicht veld.
Formaat:
VHOST: IP: RTMP_PORT:
Voorbeeld:
_defaultVHost_: 110.110.110.1: 1935

Klant toestaan om publicatienaam op te geven

U de klant toestaan hun voorkeurs publicatienaam op te geven door de volgende stappen uit te voeren.

  1. Navigeer naar Setup-Producten>/Diensten. Selecteer vervolgens een bestaand MediaCP product.
  2. Selecteer het tabblad Aangepaste velden en Nieuw aangepast veld toevoegen met de volgende instellingen.
    • Veldnaam- naam publiceren
    • Veld type- tekstvak
    • Validatie: /^[a-zd_]{4,28}$/i
    • Verplicht veld controleren
    • Vink Weergeven op bestelformulier aan

whmcs_custom_field

E-mail sjablonen

Audio Streaming (Shoutcast / Icecast)

U de volgende e-mail sjablonen gebruiken voor verschillende services.

SHOUTCAST/ICECAST DIENSTEN

LEES DEZE E-MAIL VOLLEDIG EN PRINT HET VOOR UW ADMINISTRATIE

Beste {$client_name},

Dank u voor uw bestelling van ons!

Uw SHOUTcast service is nu gemaakt en deze e-mail bevat alle informatie die u nodig heeft om te beginnen met het gebruik van uw diensten.

Hosting bedieningspaneel
Adres: https://{$service_server_hostname}:2020/
Username: {$service_username}
Password: {$service_password}

Media Service Information
Serviceadres: {$mediacp_host_address}
Servicepoort: {$mediacp_portbase}
Streaming Username: dj
Streaming Password: {$service_password}

Admin Address: http://{$service_domain}/admin
Username: admin
Password: {$service_password}

{foreach from=$service_config_options item=data} {$data.option}: {$data.value}
{/foreach}

Streamen naar uw nieuwe service
1. Download en installeer Winamp vanaf www.winamp.com
2. Download en installeer Winamp Shoutcast DSP Plugin vanaf http://shoutcast.com/BroadcastNow
3. Voer uw service-IP, poort en wachtwoord in de Shoutcast DSP-plug-in in en druk vervolgens op verbinden.

Dank u voor het kiezen van ons.

{$signature}

Videostreaming

Let op: in deze sjabloon wordt ervan uitgegaan dat u het aangepaste veld ‘ Publiceer naam ‘ hebt geconfigureerd als het eerste aangepaste veld.

LEES DEZE E-MAIL VOLLEDIG EN PRINT HET VOOR UW ADMINISTRATIE

Beste {$client_name},

Dank u voor uw bestelling van ons!

Uw media-service is nu gemaakt en deze e-mail bevat alle informatie die u nodig heeft om te beginnen met het gebruik van uw diensten.

Hosting bedieningspaneel
Adres: https://{$service_server_hostname}:2020/
Username: {$service_username}
Password: {$service_password}

Media Service Information
RTMP: rtmp://{$service_server_hostname}/{$service_custom_fields.0}/{$service_custom_fields.0}
RTSP: rtsp://{$service_server_hostname}/{$service_custom_fields.0}/{$service_custom_fields.0}

{foreach from=$service_config_options item=data} {$data.option}: {$data.value}
{/foreach}

Live encoder configuratie
Server URL: rtmp://{$service_server_hostname}/{$service_custom_fields.0}
Stream key: {$service_custom_fields.0}
Username: {$service_custom_fields.0}
Password: {$service_password}

Dank u voor het kiezen van ons.

{$signature}

Probleemoplossing

Aanvraag mislukt – Zorg ervoor dat de uitgaande poort van de firewall wordt geopend en zorg ervoor dat het domein kan worden opgelost.

De meest voorkomende reden voor deze fout is dat uw WHMCS-server niet kan communiceren met de MediaCP omdat de uitgaande poort 2020 wordt geblokkeerd van uw WHMCS-server.

We raden u aan de onderstaande stappen te volgen:

  1. Controleer of MediaCP up-to-date is met de meest recente versie om compatibiliteit te garanderen.
  2. Controleer of de hostnaam van de WHMCS-server, poort en SSL-modus precies overeenkomt met uw MediaCP-installatie
  3. Controleer outbound firewall poort 2020 is op de WHMCS-server, of neem contact op met uw hosting provider om dit te voltooien.
  4. Test de MediaCP API-verbinding met behulp van ons online testprogramma. Als de API-test succesvol is, ligt het probleem bij de firewall van uw WHMCS-server. Als de API-test niet succesvol is, neem dan contact met ons op met de uitvoerinformatie voor verdere probleemoplossing.

Transportfout – kan socket niet openen

Er is een verbindingsprobleem tussen uw WHMCS-server en de MediaCP. Volg de bovenstaande gids voor probleemoplossing.

Niet ondersteund met uw versie van MediaCP. Upgrade MediaCP naar versie 2.9.11, 2.10.7 of nieuwer.

Als u deze fout ziet wanneer u de knop Synchroniseren in WHMCS gebruikt, betekent dit het volgende:

  1. Uw MediaCP is niet up-to-date; of
  2. Als MediaCP up-to-date is, kan dit ook betekenen dat de uitgaande poort 2000 of 2020 wordt geblokkeerd door uw firewall op de WHMCS-server. Zorg ervoor dat deze poort is geopend en probeer het opnieuw.

MediaCP-accounts importeren in WHMCS

MediaCP 2.9.11 en 2.10.7 introduceren de mogelijkheid om WHMCS Server Sync tool te gebruiken.

  1. Log in op WHMCS en navigeer naar de pagina Servers
  2. Druk op de knop Accounts synchroniseren
  3. Selecteer de accounts die u wilt synchroniseren en druk op Doorgaan
  4. U moet nu het “Product/De Dienst” van elke nieuw gemaakte service in WHMCS bijwerken.

Notities:

  • Accounts worden gekoppeld aan domein- en gebruikersnaamvelden (e-mail)
  • Alle nieuw aangemaakte accounts worden op een WHMCS-pakket geplaatst met de naam “standaard”, na synchronisatie moet u de service openen en het product / de service overschakelen naar een geldig pakket.

Table of Contents