Installazione e configurazione modulo WHMCS (Reseller domini)

Scopri come installare e configurare il modulo WHMCS di SupportHost per iniziare a rivendere domini con noi.

Attivare l’account reseller

Apri un ticket nel reparto amministrazione e richiedi di diventare reseller di domini: dopo averti chiesto alcuni dati, potremo abilitare il tuo account alla rivendita dei domini.

Modificare le impostazioni reseller del tuo account

Dopo che il tuo account sarà stato abilitato come reseller di domini, potrai accedere alle impostazioni del tuo account.

Vai su Domini > Impostazioni reseller.

Da qui puoi:

• creare la chiave API
• aggiungere gli IP autorizzati ad usare la chiave API
• modificare le impostazioni di rinnovo automatico dei domini.

Creare la chiave API

Appena il tuo account sarà abilitato come reseller, potrai creare la chiave API che ti servirà per configurare il modulo WHMCS.

1. Accedi all’area clienti e vai su Domini > Impostazioni reseller.
2. Dalla sezione “Chiave API” clicca sul pulsante “Genera una nuova chiave API“.

Attenzione: dopo generata, la chiave API non sarà più visibile. Copiala e salvala appena generata. Se perdi la chiave API, ripeti i passaggi per generare una nuova chiave.

Aggiungere IP autorizzati

In area clienti, vai su Domini > Impostazioni reseller.

Nella sezione “IP autorizzati” devi inserire gli IP che vuoi autorizzare a eseguire le chiamate API:

1. inserisci l’IP nel campo
2. clicca su “Aggiungi IP”.

Ripeti il passaggio per aggiungere i diversi IP che vuoi autorizzare.

Nota che se ci sono errori durante la chiamata API, vedrai un errore che ti indica che l’IP non è autorizzato, in questo caso per risolvere, accedi alle impostazioni come abbiamo appena visto e aggiungi l’IP.

Per rimuovere un IP che hai autorizzato in precedenza, clicca sull’icona “-” accanto all’IP come mostro qui:

Impostare il rinnovo automatico

Di default, se non cambi l’impostazione, il rinnovo automatico dei domini è disattivato.

Con il rinnovo automatico disattivato:

• devi rinnovare a mano i domini:
  • tramite chiamata API;
  • attraverso l’area clienti di SupportHost.

Puoi attivare il rinnovo automatico cliccando sul pulsante “Abilita” dalla sezione Rinnovo automatico.

Con il rinnovo automatico attivato:

• tutti i domini registrati o trasferiti dopo che attivi il rinnovo automatico, avranno il rinnovo automatico attivo.
• 30 giorni prima della scadenza dei domini ti invieremo fattura per il rinnovo. Se è presente credito, il dominio verrà rinnovato 30 giorni prima della scadenza.

Dall’area clienti, Domini > I miei domini puoi vedere se è attivo il rinnovo automatico dei tuoi domini.

Come ricaricare il credito

Per il pagamento dei domini come reseller hai due opzioni:

• bonifico
• addebito sul conto.

Inoltre, puoi aggiungere credito al tuo account e utilizzare il credito per registrazioni, trasferimenti e rinnovi.

Per farlo, accedi all’area clienti e clicca su Domini > Aggiungi credito.

A questo punto:

1. inserisci l’importo da ricaricare – importo minimo 100€
2. clicca su Ricarica.

Verrà generata la fattura e potrai pagarla con bonifico o domiciliazione SEPA.

Il credito aggiunto non è rimborsabile.

Installare il modulo su WHMCS

Dopo aver generato la chiave API, aggiunto gli IP autorizzati e scelto le impostazioni per il rinnovo automatico, possiamo configurare il modulo.

I passi da seguire sono questi:

1. scaricare il file zip del modulo e caricarlo su WHMCS;
2. attivare il modulo;
3. configurare il modulo inserendo la chiave API;
4. configurare i campi addizionali;
5. fare una verifica finale;
6. aggiungere altre lingue (opzionale).

Vediamo come.

Scarica il modulo e caricalo su WHMCS

Per prima cosa devi scaricare il modulo e caricarlo su WHMCS:

1. Scarica il modulo “SupportHost” per WHMCS.
2. Scompatta il file zip del modulo.
3. Carica i file nella cartella: WHMCS/modules/registrars/

Attiva il modulo da WHMCS

Per attivare il modulo:

• Accedi a WHMCS.
• Passa il mouse sull’icona della chiave inglese e clicca su System Settings.
• Usa la barra di ricerca per trovare “Domain Registrars” e cliccaci.

Vedrai un elenco di Registrar, scorri fino a “SupportHost” e clicca sul pulsante verde “Activate“.

Configura il modulo

Dopo aver attivato il modulo “SupportHost”, dalla stessa pagina (System Setting > Domain Registrars) clicca sul pulsante “Configure“:

I campi che vedrai sono questi:

• email: inserisci l’email che usi per il tuo account su SupportHost (puoi vedere l’email dall’area clienti).
• api key: inserisci la chiave API che hai creato prima seguendo gli step di questo tutorial.
• Move domains to SupportHost: qui puoi inserire le estensioni dei domini che vuoi trasferire automaticamente a SupportHost. Quando un tuo cliente rinnova un dominio con una delle estensioni inserite, invece di rinnovarsi con il registrar corrente, viene creato un todo con la data di scadenza: al giorno della scadenza viene avviato il trasferimento del dominio verso SupportHost.

Dopo aver compilato i campi, clicca su “Save changes”.

Modifica il file additionalfields.php

Questa modifica che andiamo a fare permette di mostrare correttamente i campi aggiuntivi del dominio ed eseguire le validazioni.

Devi modificare il file: WHMCS/resources/domains/additionalfields.php

Nota che se il file non esiste, basta creare un file vuoto “additionalfields.php” nel percorso specificato sopra e incollare la riga che vedi dopo.

Apri il file, aggiungi questa riga e salva:

include(ROOTDIR."/modules/registrars/SupportHost/lib/supporthost-additionalfields.php");

A questo punto, è meglio controllare che non ci siano altri moduli che aggiungono campi addizionali ai domini, vediamo come.

Verifica i campi aggiuntivi e la validazione

Adesso devi verificare che i campi aggiuntivi del dominio siano corretti:

• prova a ordinare un dominio .it (da area clienti)
• vedrai i seguenti 4 campi aggiuntivi:
  • entità legale
  • codice fiscale / partita iva
  • pubblica i dati personali
  • accetto i termini e condizioni per i domini .it.

Se visualizzi altri campi oltre a questi, vuol dire che un altro modulo che stai usando (un modulo registrar) sta aggiungendo altri campi: a questo punto devi controllare quali moduli stai usando e capire come eliminare i campi aggiuntivi inseriti dagli altri moduli.

Il modulo ha un sistema di validazione dei campi che impedisce errori: questo significa ad esempio che se sto eseguendo un ordine come “persona fisica” (privato), devo inserire un codice fiscale e non un numero di partita IVA. Controlla gli errori più comuni per la registrazione dei domini .it.

Aggiungi altre lingue

Nei file del modulo trovi una cartella “lang”, al suo interno trovi i file della lingua: english.php e italian.php

Per aggiungere una nuova lingua:

• duplica uno dei due file
• traduci il contenuto
• salvalo come gli altri, esempio “french.php”.