Pasos

• Acceder al directorio de WHMCS: /whmcs/includes/
• Directorio: /whmcs/includes/
• Abrir whoiservers.txt (incluído en el módulo)
• Incluir el contenido del TXT en el archivo: whoisservers.php
• Revisar el contenido del archivo whoisservers.php para los duplicados de extensión: En el WHMCS hay líneas por defecto para cada extensión de dominios y se ejecutaré el WHOIS del primero que encuentre. Por ejemplo, puede existir un WHOIS para las extensiones .ES ajeno a VIRTUALNAME y que de disponibilidades incorrectas de dominio.
• Solicitar a SOPORTE que validen la IP de tu WHMCS para las consultas WHOIS vía mail soporte@virtualname.es o ticket

Configuración

• El módulo de registrador se puede actualizar en un solo clic.
• Si hay una nueva versión disponible para actualizar, recibiremos un aviso en forma de PopUP en la página principal de administración del WHMCS. En dicho PopUp aparecerá un enlace para ir directamente a la ubicación del módulo de registrador de Virtualname.
• Haz clic en: Obtener Actualización
• O manualmente: AJUSTES > Productos/Servicios > Registradores de dominios > Virtualname
• Si el módulo detecta que falta alguno de los archivos por subir no se podrá ejecutar la actualización en un clic.
• Si el módulo detecta que no existen los permisos de archivos y directorios correctos no se podrá ejecutar la actualización automática.
• En este caso es recomendable descargarse el módulo y volverlo a subir siguiendo las instrucciones del primer paso 1. Subir módulo al WHMCS
• Todos los archivos a copiar están ubicados en el módulo de VIRTUALNAME, en el directorio “includes” del mismo
• En caso de no poder hacer la actualización en un clic y sea necesario subir el módulo manualmente, para que se apliquen todos los cambios es necesario hacer clic en el botón de Desinstalar Registrador y luego instalarlo nuevamente haciendo clic en Instalar Registrador

PopUp de nueva versión

Configuración

Lista de archivos a incluir:

1. Archivo: clientareadata.php – Ubicación WHMCS: Copiar en la carpeta RAIZ del WHMCS “/whmcs/”
2. Archivo: virtualname_hooks.php – Ubicación WHMCS: Copiar en la carpeta del WHMCS “/whmcs/includes/hooks/”
3. Archivo: clientsdatadomaincontacts.php – Ubicación WHMCS: Copiar en la carpeta de administración del WHMCS “/whmcs/admin/” * el nombre de la carpeta de administración puede variar si esta ha sido personalizada

Contenidos a incluir:

1. Incluir estas líneas:

   ######VIRTUALNAME REGISTRAR ADDITIONALS######
   $path = str_replace('/resources/domains', '', dirname(__FILE__));
   require_once($path."/modules/registrars/virtualname/includes/domainContacts.php");
   $additionaldomainfields = setExtraAdditional($_SESSION["uid"]);
   ######VIRTUALNAME REGISTRAR ADDITIONALS######

   Con WHCMS 7 y 8

   ---

   • En el archivo “additionalfields.php” ubicado en la ruta “/whmcs/resources/domains/”
   • Si el archivo no existe, crearlo e incluirle el contenido del archivo dist.additionalfields.php ubicado en el mismo directorio.
   • Subir los archivos english.php y spanish.php ubicados en el módulo: /virtualname/includes/overrides
   • En el directorio del WHMCS: /whmcs/langs/overrides/

   * En caso de que ya existan traducciones adicionales, es suficiente con añadir las traducciones de VIRTUALNAME ubicadas en esos dos archivos en las que haya ya en el WHMCS.

   Con WHCMS 5 y 6

   ---

   1. En el archivo “additionaldomainfields.php” ubicado en la ruta “/whmcs/includes/”
   2. Incluir estas líneas de traducción en el archivo “english.php” ubicado en la ruta “/whmcs/lang/”

      ######VIRTUALNAME REGISTRAR LANGS######
      // * @virtualname-version 1.1.13
      $_LANG['clientareanavgeneratecontact'] = 'Import Domain Contact';
      $_LANG['clientareanavgeneratecontactexplanation'] = 'Import domain contact creates a new contact in your account. This contact is link to the domain and can be modified to update WHOIS data for all domains linked to this contact.';
      $_LANG['clientarevalidationexplanation'] = 'Linked contacts can be used for contact data domains';
      $_LANG['clientareanaverrorsavecontacts'] = 'Only can link contacts that are validated (Validation Tick)';
      $_LANG['clientareanaverrordeletecontacts'] = 'Can\'t delete contact when this is linked with at domain';
      $_LANG['domainbillingcontact'] = 'Billing Contact';
      $_LANG['domaintechcontact'] = 'Technical Contact';
      $_LANG['domainadmincontact'] = 'Admin Contact';
      $_LANG['domainregcontact'] = 'Register Contact';
      $_LANG['domaindefaultcontact'] = 'Use default contact';
      $_LANG['domainaddcontact'] = 'Add new contact';
      $_LANG['domaincontactrefresh'] = 'Refresh';
      $_LANG['clientareavirtualnamevalidate'] = 'Contact exist inside registrar';
      $_LANG['clientareavirtualnamenovalidate'] = 'Contact not exist inside registrar';
      $_LANG['clientarealinkedcontact'] = 'Link Contact';
      $_LANG['clientareaunlinkedcontact'] = 'Unlink Contact';
      $_LANG['adminContactLinked'] = 'Contact Created - Linked';
      $_LANG['adminContactNoLinked'] = 'Contact created but not linked with registrar';
      $_LANG['adminContactUpdated'] = 'Contact updated';
      $_LANG['adminContactNotUpdated'] = 'Error on update contact';
      $_LANG['adminClientUpdated'] = 'Client updated';
      $_LANG['adminClientNotUpdated'] = 'Error on update client';
      $_LANG['adminContactCreated'] = 'Domain contact created';
      $_LANG['adminContactNotCreated'] = 'Domain contact not created: Invalid contact';
      $_LANG['adminUpdatedContactsError'] = 'Domain contacts not updated: Only can link contacts that are validated (Validation Tick)';
      $_LANG['adminUpdatedContacts'] = 'Domain contacts updated';
      $_LANG['adminDefaultContact'] = 'Use client data';
      $_LANG['admingenerate'] = 'Import Domain Contact';
      $_LANG['clientIdentificationNumber'] = 'Identification Number (CIF, DNI, NIE)';
      $_LANG['legal_form']['natural_person_or_individual'] = 'Natural person or individual';
      $_LANG['legal_form']['economic_interest_group'] = 'Economic interest grouping';
      $_LANG['legal_form']['association'] = 'Association';
      $_LANG['legal_form']['sports_association'] = 'Sports association';
      $_LANG['legal_form']['trade_association'] = 'Trade association';
      $_LANG['legal_form']['savings'] = 'Savings';
      $_LANG['legal_form']['community_property'] = 'Community property';
      $_LANG['legal_form']['community_of_owners'] = 'Community of owners';
      $_LANG['legal_form']['congregation_or_religious_institution'] = 'Congregation or religious institution';
      $_LANG['legal_form']['consulate'] = 'Consulate';
      $_LANG['legal_form']['public_corporation'] = 'Public corporation';
      $_LANG['legal_form']['embassy'] = 'Embassy';
      $_LANG['legal_form']['local_organization'] = 'Local organization';
      $_LANG['legal_form']['sports_federation'] = 'Sports federation';
      $_LANG['legal_form']['foundation'] = 'Foundation';
      $_LANG['legal_form']['mutual_insurance'] = 'Mutual insurance';
      $_LANG['legal_form']['organ_of_the_regional_administration'] = 'Organ of the regional administration';
      $_LANG['legal_form']['organ_of_the_state_administration'] = 'Organ of the state administration';
      $_LANG['legal_form']['political_party'] = 'Political party';
      $_LANG['legal_form']['union'] = 'Union';
      $_LANG['legal_form']['agrarian_transformation'] = 'Agrarian transformation';
      $_LANG['legal_form']['corporation'] = 'Corporation';
      $_LANG['legal_form']['sports_corporation'] = 'Sports corporation';
      $_LANG['legal_form']['civil_society'] = 'Civil society';
      $_LANG['legal_form']['partnership'] = 'Partnership';
      $_LANG['legal_form']['limited_partnership'] = 'Limited partnership';
      $_LANG['legal_form']['cooperative_society'] = 'Cooperative society';
      $_LANG['legal_form']['labour_society_limited'] = 'Labour society limited';
      $_LANG['legal_form']['limited_society'] = 'Limited society';
      $_LANG['legal_form']['branch_in_spain'] = 'Branch in spain';
      $_LANG['legal_form']['consortium'] = 'Consortium';
      $_LANG['legal_form']['education_corporation'] = 'Education corporation';
      $_LANG['legal_form']['autonomous_public_organization'] = 'Autonomous public organization';
      $_LANG['legal_form']['state_public_agency'] = 'State public agency';
      $_LANG['legal_form']['local_public_agency'] = 'Local public agency';
      $_LANG['legal_form']['other'] = 'Other';
      $_LANG['legal_form']['designation_of_origin_control_board'] = 'Designation of origin control board';
      $_LANG['legal_form']['natural_space_agency_manager'] = 'Natural space agency manager';
      $_LANG['modify_glue_records'] = 'Can\'t modify nameserver';
      $_LANG['delete_glue_records'] = 'Can\'t delete nameserver';
      ######VIRTUALNAME REGISTRAR LANGS######

   3. Incluir estas líneas de traducción en el archivo “spanish.php” ubicado en la ruta “/whmcs/lang/”

      ######VIRTUALNAME REGISTRAR LANGS######
      // * @virtualname-version 1.1.13
      $_LANG['clientareanavgeneratecontact'] = 'Importar Contacto del dominio';
      $_LANG['clientareanavgeneratecontactexplanation'] = 'Importar un contacto genera un contacto nuevo en su ficha. Este contacto está vinculado al dominio y podrá ser modificado para actualizar los datos de WHOIS de los dominios vinculados a ese contacto.';
      $_LANG['clientarevalidationexplanation'] = 'Los contactos vinculados pueden ser utilizados para los datos de contactos de los dominios';
      $_LANG['clientareanaverrorsavecontacts'] = 'Solo se pueden vincular contactos que estén validados (Tick de Validación)';
      $_LANG['clientareanaverrordeletecontacts'] = 'No se puede eliminar el contacto, está vinculado a un dominio';
      $_LANG['domainbillingcontact'] = 'Contacto Facturación';
      $_LANG['domaintechcontact'] = 'Contacto Técnico';
      $_LANG['domainadmincontact'] = 'Contacto Administrativo';
      $_LANG['domainregcontact'] = 'Propietario';
      $_LANG['domaindefaultcontact'] = 'Usar los datos de mi cuenta';
      $_LANG['domainaddcontact'] = 'Añadir nuevo contacto';
      $_LANG['domaincontactrefresh'] = 'Refrescar';
      $_LANG['clientareavirtualnamevalidate'] = 'Contacto vinculado al registrador';
      $_LANG['clientareavirtualnamenovalidate'] = 'Contacto no vinculado al registrador';
      $_LANG['clientarealinkedcontact'] = 'Vincular Contacto';
      $_LANG['clientareaunlinkedcontact'] = 'Desvincular Contacto';
      $_LANG['adminContactLinked'] = 'Contacto Creado - Vinculado';
      $_LANG['adminContactNoLinked'] = 'Contacto creado pero no vinculado al registrador';
      $_LANG['adminContactUpdated'] = 'Contacto actualizado';
      $_LANG['adminContactNotUpdated'] = 'Error al actualizar contacto';
      $_LANG['adminClientUpdated'] = 'Cliente actualizado';
      $_LANG['adminClientNotUpdated'] = 'Error al actualizar cliente';
      $_LANG['adminContactCreated'] = 'Contacto de dominio creado';
      $_LANG['adminContactNotCreated'] = 'Contacto de dominio no creado: Contacto no válido';
      $_LANG['adminUpdatedContactsError'] = 'Contactos de dominio no actualizados: Solo se pueden vincular contactos que estén validados (Tick de Validación)';
      $_LANG['adminUpdatedContacts'] = 'Contactos de dominio actualizados';
      $_LANG['adminDefaultContact'] = 'Usar los datos del cliente';
      $_LANG['admingenerate'] = 'Importar Contacto del dominio';
      $_LANG['clientIdentificationNumber'] = 'Nº de Identificación (CIF, DNI, NIE)';
      $_LANG['legal_form_contact'] = 'Forma jurídica';
      $_LANG['legal_form']['natural_person_or_individual'] = 'Persona física o particular';
      $_LANG['legal_form']['economic_interest_group'] = 'Agrupación de interés económico';
      $_LANG['legal_form']['association'] = 'Asociación';
      $_LANG['legal_form']['sports_association'] = 'Asociación deportiva';
      $_LANG['legal_form']['trade_association'] = 'Asociación gremial';
      $_LANG['legal_form']['savings'] = 'Caja de ahorros';
      $_LANG['legal_form']['community_property'] = 'Comunidad de bienes';
      $_LANG['legal_form']['community_of_owners'] = 'Comunidad de propietarios';
      $_LANG['legal_form']['congregation_or_religious_institution'] = 'Congregación o institución religiosa';
      $_LANG['legal_form']['consulate'] = 'Consulado';
      $_LANG['legal_form']['public_corporation'] = 'Corporación de derecho público';
      $_LANG['legal_form']['embassy'] = 'Embajada';
      $_LANG['legal_form']['local_organization'] = 'Entidad local';
      $_LANG['legal_form']['sports_federation'] = 'Federación deportiva';
      $_LANG['legal_form']['foundation'] = 'Fundación';
      $_LANG['legal_form']['mutual_insurance'] = 'Mutua de seguros';
      $_LANG['legal_form']['organ_of_the_regional_administration'] = 'Órgano de la administración pública';
      $_LANG['legal_form']['organ_of_the_state_administration'] = 'Órgano de la administración del estado';
      $_LANG['legal_form']['political_party'] = 'Partido político';
      $_LANG['legal_form']['union'] = 'Sindicato';
      $_LANG['legal_form']['agrarian_transformation'] = 'Sociedad agraria de la transformación';
      $_LANG['legal_form']['corporation'] = 'Sociedad anónima';
      $_LANG['legal_form']['sports_corporation'] = 'Sociedad anónima deportiva';
      $_LANG['legal_form']['civil_society'] = 'Sociedad civil';
      $_LANG['legal_form']['partnership'] = 'Sociedad colectiva';
      $_LANG['legal_form']['limited_partnership'] = 'Sociedad comanditaria';
      $_LANG['legal_form']['cooperative_society'] = 'Sociedad cooperativa';
      $_LANG['legal_form']['labour_society_limited'] = 'Sociedad laboral limitada';
      $_LANG['legal_form']['limited_society'] = 'Sociedad limitada';
      $_LANG['legal_form']['branch_in_spain'] = 'Sucursal en España';
      $_LANG['legal_form']['consortium'] = 'Unión temporal de empresas';
      $_LANG['legal_form']['education_corporation'] = 'Sociedad anónima laboral';
      $_LANG['legal_form']['autonomous_public_organization'] = 'Organismo público autonómico';
      $_LANG['legal_form']['state_public_agency'] = 'Organismo público estatal';
      $_LANG['legal_form']['local_public_agency'] = 'Organismo público local';
      $_LANG['legal_form']['other'] = 'Otras';
      $_LANG['legal_form']['designation_of_origin_control_board'] = 'Consejo regulador de denominación de origen';
      $_LANG['legal_form']['natural_space_agency_manager'] = 'Organismo gestor de espacio natural';
      $_LANG['modify_glue_records'] = 'No se puede editar el nameserver';
      $_LANG['delete_glue_records'] = 'No se puede eliminar el nameserver';
      ######VIRTUALNAME REGISTRAR LANGS######
      

Anexos:

Añadir provincias de México: Reemplazar el archivo ./assets/js/StatesDropdown.js por este archivo: StatesDropdown

Con WHMCS 7 y 8

• En el archivo “additionalfields.php” ubicado en la ruta “/whmcs/resources/domains/”
• Si el archivo no existe, crearlo e incluirle el contenido del archivo dist.additionalfields.php ubicado en el mismo directorio.
• Añade tu APIKEY (puede generar un APIKEY en panel.virtualname.net, en “Mi cuenta” > “Configuración” > “API”)
• Eliminar las líneas que hagan referencia a los .ES:

  $additionaldomainfields[“.es”][] = array(“Name” => “ID Form Type”, “LangVar” => “estldidformtype”, “Type” => “dropdown”, “Options” => “Other Identification,Tax Identification Number,Tax Identification Code,Foreigner Identification Number”, “Default” => “Other Identification”,);
  $additionaldomainfields[“.es”][] = array(“Name” => “ID Form Number”, “LangVar” => “estldidformnum”, “Type” => “text”, “Size” => “30”, “Default” => “”, “Required” => true,);
  $additionaldomainfields[“.es”][] = array(…
                                                  

• Herramienta para actualizar todos los datos de dominios entre el WHMCS y el TCPanel de Virtualname.
• Opciones de la herramienta:
• Selector de clientes: Se puede seleccionar uno o todos los clientes para la sincronización.
• Lanzar sincronización: Según esté configurado (apartado 3.Opciones) ajustará el estado y las fechas de los dominios en el WHMCS que tengan asignado como registrador VIRTUALNAME

Sincronizar dominios

• Herramienta para actualizar todos los datos de contactos de dominios activos entre el WHMCS y el TCPanel de Virtualname.
• Opciones de la herramienta:
• Selector de clientes: Se puede seleccionar uno o todos los clientes para la sincronización.
• Lanzar sincronización: Según esté configurado (apartado 3.Opciones) actualizará o importará los contactos de los dominios activos en el WHMCS y que tengan asignado como registrador VIRTUALNAME

Sincronizar contactos

• Herramienta para actualizar una tarifa previamente creada de dominios entre el WHMCS y el TCPanel de Virtualname.
• Para poder usarlo es necesario tener una tarifa de cliente generada previamente: Puedes crearlas en tu panel de Virtualname haciendo clic aquí.
• Opciones de la herramienta:
• Tarifas TCPanel: Tarifas creadas para vuestros clientes en el panel de Virtualname: Puedes crearlas en tu panel de Virtualname haciendo clic aquí.
• Grupos WHMCS: Los grupos de clientes de WHMCS o la tarifa base
• Costes y periodos de restauración: Importar o no los costes de REDEMPTION y los periodos de los mismos.
• Mostrar AUTHCODES: Al importar la tarifa, si el TLD tiene authcode, activar que los clientes de WHMCS puedan consultarlo.
• Lanzar Actualización de tarifa: Importa los precios de cada TLD, de la tarifa creada para vuestros clientes, al grupo escogido de WHMCS

Sincronizar precios

• Dominios y fechas de vencimientos: Listado de dominios cuya fecha de expiración no coincide con la fecha de vencimiento de factura. Si un dominio tiene una fecha de caducidad inferior a su fecha de facturación, este dominio caducará. Al expirar no se facturará nunca más y podrá perderse dicho dominio.
• Limpiador de Dominios: Listado de dominios con errores sintácticos, subdominios o espacios adicionales.
• Transferir al renovar (TOR): Listado de dominios en otros registradores para transferir en su renovación hacia Virtualname.

Dominios y fechas de vencimiento

Limpiador

Tranferir al renovar

• Revisión de clientes: Listado de clientes que pueden tener errores en sus datos.
• Revisión de contactos: Listado de contactos que pueden tener errores en sus datos.

Gestión de Contactos

• Importar dominios: Listado de dominios que pueden ser importados del panel de Virtualname a clientes del WHMCS. Este listado incluye solo dominios que se encuentran en el panel de virtualname pero no en el WHMCS.
• Importar TLDs: Listado de TLDs disponibles en TCPanel que pueden ser importados al WHMCS.

Herramientas de importación

• Clientes con crédito: Listado de clientes con crédito en el WHMCS.
• Facturas a revisar: Listado de facturas de WHMCS con posibles datos erróneos, facturas sin transacción, con múltiples transacciones o aquellas cuyo importes totales no coinciden.
• FacturaE (BETA): Generar facturas electrónicas a partir de facturas generadas en WHMCS.

Gestión de facturas

• Transferencias entrantes de dominios: Listado de transferencias entrantes en TCPanel.
• Dominios en IRTP: Listado de dominios que están en estado pendiente o suspendido por IRTP

Listados adicionales

• Manual para transferir al renovar (TOR): Listado de dominios en otros registradores para transferir en su renovación hacia Virtualname.
• Se puede consultar aquí.

Tranferir al renovar