Scopri come installare e configurare il modulo WHMCS di SupportHost per iniziare a rivendere domini con noi.
Indice
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.
- Accedi all’area clienti e vai su Prodotti > Reseller.
- Dalla sezione “Modulo registrar” clicca sul link “Gestisci i token 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.
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.
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.
Cliccando sull’icona a forma di matita puoi modificare il nome della chiave API e gli IP in whitelist.
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.
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:
- inserisci l’importo da ricaricare – importo minimo 10€
- clicca su 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:
- scaricare il file zip del modulo e caricarlo su WHMCS;
- attivare il modulo;
- configurare il modulo inserendo la chiave API;
- configurare i campi addizionali;
- fare una verifica finale;
- aggiungere altre lingue (opzionale).
Vediamo come.
Scarica il modulo e caricalo su WHMCS
Per prima cosa devi scaricare il modulo e caricarlo su WHMCS:
- Scarica il modulo “SupportHost” per WHMCS dall’area clienti: vai su Prodotti > Reseller e clicca su Scarica nella sezione Modulo Registrar.
- Scompatta il file zip del modulo.
- 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”.
Pronto a costruire il tuo sito WordPress?
Prova il nostro servizio gratuitamente per 14 giorni. Nessun impegno, nessuna carta di credito richiesta.