Manual de usuario del Módulo de Registro para WHMCS
DonDominio
Este es el manual de usuario para el Módulo de Registro para WHMCS de DonDominio.
Este módulo añade la capacidad a WHMCS de registrar, transferir y renovar dominios a través de la API de DonDominio. También proporciona servicios adicionales como la actualización y gestión de contactos, gestión de servicios adicionales (como privacidad de whois) y otros.
Este módulo sólo añade capacidad a WHMCS para registrar, transferir y renovar dominios con WHMCS. Existe un addon adicional para WHMCS que gestiona dominios y TLDs desde el panel de administración de WHMCS. Para más información sobre este addon, visita la documentación del Addon de DonDominio para WHMCS.
El Módulo de Registro para WHMCS de DonDominio utiliza la API de DonDominio para funcionar. Es necesario disponer de una cuenta de API activa para poder usar este módulo.
Para activar el módulo necesitarás un Nombre de usuario de API y una Contraseña de usuario de API que habrá proporcionado previamente el equipo de soporte de DonDominio. Para más información sobre la API de DonDominio, consulta la documentación correspondiente.
El módulo permite las siguientes acciones:
WHMCS es una marca registrada de WHMCS Ltd.. DonDominio no forma parte ni está afiliado en ninguna forma a WHMCS Ltd.. Puedes obtener más información sobre WHMCS en la página web oficial de WHMCS.
Para instalar el módulo, descarga el archivo ZIP correspondiente desde nuestro
repositorio de Github. Una vez esté descargado, descomprímelo y deberías
obtener una carpeta llamada src. Copia el contenido de esta carpeta en el directorio raíz de WHMCS, normalmente
/path/to/whmcs/ y acepta todos los cambios.
Una vez copiados los contenidos de la carpeta, accede al panel de administración de WHMCS y
dirígite a la pantalla de configuración de registradores, Ajustes > Productos/Servicios > Registradores de dominios. Localiza el Módulo llamado
Dondominio y pulsa sobre el botón Activar. Una vez activado el módulo,
pulsa sobre el botón Configurar e introduce la configuración necesaria para
que el módulo funcione.
Nota
Si ya tienes instalado y configurado el Addon, los campos API Username y API Password se rellenarán automáticamente con los valores configurados en el Addon.
Las posibles configuraciones del módulo son las siguientes:
| Campo | Valores | Descripción |
|---|---|---|
| API Username | Texto | Nombre de usuario de la API de DonDominio |
| API Password | Texto | Contraseña de la API de DonDominio |
| VAT Number Field | Múltiple | Campo personalizado que contiene el NIF/CIF/VAT del cliente |
| Owner Contact DonDominio ID | Texto | ID de contacto de DonDominio para el propietario |
| Allow customers to modify Owner contact information | Sí/No | Si está activo, los clientes podrán modificar los datos del propietario aunque se haya proporcionado un ID de contacto |
| Admin Contact DonDominio ID | Texto | ID de contacto de DonDominio para el contacto administrativo |
| Allow customers to modify Admin contact information | Sí/No | Si está activo, los clientes podrán modificar los datos del contacto administrativo aunque se haya proporcionado un ID de contacto |
| Tech Contact DonDominio ID | Texto | ID de contacto de DonDominio para el contacto técnico |
| Allow customers to modify Tech contact information | Sí/No | Si está activo, los clientes podrán modificar los datos del contacto técnico aunque se haya proporcionado un ID de contacto |
| Billing Contact DonDominio ID | Texto | ID de contacto de DonDominio para el contacto de cobro |
| Lock modifications | Sí/No | Si está activo al bloquear transferencias en un dominio también se bloquearán las modificaciones |
La API de DonDominio requiere que se proporcione el NIF/CIF/Número VAT del cliente que registra el dominio para poder hacerlo efectivo. Este módulo incluye una modificación a la manera en que WHMCS gestiona estos campos personalizados para que este campo aparezca en todas las extensiones de dominio y no sólo en algunas.
WHMCS 6
Para activar la modificación, es necesario editar el fichero
/path/to/whmcs/includes/additionaldomainfields.phpincluido en la instalación de WHMCS 6Al final de este fichero, debe añadirse esta línea:
include(ROOTDIR . "/modules/registrars/dondominio/additionalfields.php");
WHMCS 7.x y 8.x
Para activar la modificación, es necesario copiar el archivo
/path/to/whmcs/modules/registrars/dondominio/additionalfields.phpdentro de la carpeta/path/to/whmcs/resources/domains.Si este archivo ya existe, deberá cancelar la operación y añadir los campos manualmente siguiendo las instrucciones de WHMCS Additional Domain Fields.
Si no está seguro de como hacerlo, por favor, consulte con nuestro equipo de soporte.
Así mismo, es posible que si instala módulos de otros registradores, estos campos dejen de funcionar. Por favor, asegúrese de que si instala otros módulos, éstos no interfieren con este archivo.
Además, el módulo incluye un sistema para tomar un campo por defecto en caso de que este no esté disponible. Este campo se añadirá al perfil del cliente y es necesario en caso de renovaciones y otras operaciones con contactos.
Para añadir este campo, accede al panel de administración de WHMCS y luego haz
clic en Ajustes > Campos personalizados. En el formulario que aparecerá,
introduce los siguientes datos:
VAT NumberEl resto de campos pueden quedar en blanco. Activa también las casillas
Campo obligatorio y Mostrar en el formulario de pedido.
Consulta la sección Configuración del módulo para más información sobre como configurar este campo en el módulo.
Una vez instalado y configurado ya se puede usar el módulo para registrar, transferir y renovar dominios.
Para que WHMCS use el módulo debe configurarse cada TLD para que haga uso del mismo. Puedes automatizar esta tarea usando nuestro Addon para WHMCS o bien manualmente siguiendo estos pasos:
Ajustes > Productos/Servicios > Precios de dominiosGuardar cambios. Si el
TLD ya está creado, ignora este paso.Abrir precios como deseesAutoregistro selecciona Dondominio en el desplegableGuardar cambios para confirmar la configuración
A partir de ese momento el TLD configurado usará el módulo de DonDominio para registrar, transferir y renovar dominios. El proceso se hará de forma transparente para el cliente.
Si se produce un error a la hora de registrar, transferir o renovar un dominio,
el pedido del cliente quedará en estado Pendiente. Pulsa sobre el enlace
X pedidos pendientes en la parte superior de WHMCS para verlos.
Puedes reintentar el proceso pulsando sobre Aceptar pedido para cada uno de
ellos. Si se produce un error verás una descripción en pantalla. Si la
operación tiene éxito el pedido quedará aceptado y el dominio activo en WHMCS.
El módulo incluye un servicio de sincronización automática para WHMCS. Este proceso funciona de forma automática, siempre y cuando hayas configurado las tareas Cron de WHMCS, tal y como indica la documentación de WHMCS sobre tareas Cron.
El servicio de sincronización actualizará el estado de los dominios pendientes de transferencia y el estado (y fecha de expiración) del resto de dominios en tandas de 50 en 50. Cuando todos los dominios están sincronizados, el proces empieza de nuevo desde el primero, y así indefinidamente.
El módulo registrador de DonDominio para WHMCS incluye servicios adicionales para los clientes. Estos servicios se describen a continuación.
Debido a que el sistema que WHMCS incorpora para gestionar la privacidad de whois puede crear conflictos cuando un dominio tiene las modificaciones bloqueadas, el módulo incorpora una opción personalizada que permite activar y desactivar la privacidad.
Esta característica es accesible desde el panel de gestión de clientes y aparecerá como
una opción de menú en la barra lateral, bajo el bloque Servicios adicionales, llamada Privacidad de Whois.
Al hacer clic en esta opción aparecerá una pantalla con un botón que permite activar y desactivar este servicio. Los cambios se aplican inmediatamente a través de la API de DonDominio.
Ten en cuenta que algunos TLDs no disponen del servicio de privacidad de Whois. Ten en cuenta también que existe una configuración adicional relacionada con este servicio en la configuración del módulo.
El módulo incorpora un sistema para realizar búsquedas de disponibilidad a través de DonDominio, así como para ofrecer dominios sugeridos disponibles.
Para configurar esta característica, por favor, siga las instrucciones de Domain Suggestions Help e infórmese de como se utiliza en Configure your domain lookup provider.