SupportHost italian

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 Prodotti > Reseller.

Da qui puoi:

  • creare la chiave API aggiungendo gli IP autorizzati ad usarla;
  • 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 Prodotti > Reseller.
  2. Dalla sezione “Modulo registrar” clicca sul link “Gestisci i token API“.
Supporthost Portal Modulo Reseller Chiave Api

Clicca su Crea chiave API e poi compila i campi:

  • Nome: inserisci un nome per identificare la chiave API
  • Cliente: seleziona il cliente corretto.
  • Whitelist IP: qui puoi inserire gli IP autorizzati a usare la chiave API. Se lasci il campo vuoto, tutti gli IP saranno autorizzati.
Supporthost Portal Modulo Reseller Crea 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.

Supporthost Portal Modulo Reseller Copiare Chiave Api

Per gestire tutte le operazioni di gestione, registrazione e trasferimento dei domini via API, consulta la nostra documentazione.

Modificare o eliminare chiave API

Dalla gestione dei token puoi visualizzare le chiavi create, modificarle ed eliminarle.

Supporthost Portal Modulo Reseller Modifica Elimina Chiave Api

Cliccando sull’icona a forma di matita puoi modificare il nome della chiave API e gli IP in whitelist.

Supporthost Portal Modulo Reseller Aggiorna Chiave Api

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.

Vai su Prodotti > Reseller, da qui puoi attivare il rinnovo automatico cliccando su “Rinnovo automatico dei nuovi domini” e poi su Salva.

Supporthost Portal Reseller Rinnovo Automatico Domini

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, Prodotti > 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
  • credito.

Puoi aggiungere credito al tuo account e utilizzarlo per registrazioni, trasferimenti e rinnovi.

Per farlo, accedi all’area clienti e clicca su Fatturazione > Credito.

A questo punto:

  1. inserisci l’importo da ricaricare – importo minimo 10€
  2. clicca su Aggiungi fondi.
Supporthost Portal Credito Aggiungi Fondi

Verrà generata la fattura e potrai pagarla con tutti i metodi di pagamento accettati (bonifico, addebito e carta di credito).

Il credito aggiunto non è rimborsabile e se sono previsti costi di transazione saranno scalati dal credito che ti verrà accreditato.

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 dall’area clienti: vai su Prodotti > Reseller e clicca su Scarica nella sezione Modulo Registrar.
  2. Scompatta il file zip del modulo.
  3. Carica i file nella cartella: WHMCS/modules/registrars/
Supporthost Portal Reseller Scaricare Modulo Whmcs

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.
Whmcs System Settings Domain Registrars

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

Attivare Modulo Supporthost Whmcs Reseller Domini

Configura il modulo

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

Configurare Modulo Supporthost Whmcs Reseller Domini

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”.

Configurazione Modulo Supporthost Whmcs Reseller Domini

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.
Campi Aggiuntivi Registrare 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”.

Tutorial categories

🚀