Installation du module registrar

Pré-requis

Le module se connecte aux systèmes de Netim en utilisant l'API et le protocole SOAP, les fonctions SOAP doivent donc être activées dans votre installation de php:

http://www.php.net/manual/fr/book.soap.php

Les chaînes de caractères multi-octets sont utilisées, les fonctions mb_string doivent donc être activées dans votre installation de php:

http://fr.php.net/manual/fr/book.mbstring.php

L'utilisation de l'addon NETIM TLD manager avec des centaines d'extensions nécessite le paramétrage suivant dans php.ini :

max_input_vars à 5000

Télécharger le module

Le module n'est pas inclu par défaut dans l'application.

Vous pouvez le télécharger ici Télécharger le module registrar NETIM

Installation des fichiers

Vous devez extraire les fichiers de l'archive dans le répertoire d'installation de votre WHMCS

Au final, vous obtenez:

/modules/registrars/netim/
/modules/widget/netim.php
/includes/hooks/netim.php

Installation des champs additionnels

Par défaut WHMCS défini une liste de champs additionnels pour les modules intégrés dans la distribution.

Les champs additionnels sont nécessaires pour de nombreuses extensions qui demandent des informations complémentaires telles que le numéro d'enregistrement de la société, son numéro de TVA, etc, etc

Netim utilise ses propres champs additionnels qui seront utilisés automatiquement si Netim est le registrar par défaut de l'extension

Pour WHMCS 6.x

Editez le fichier /includes/additionaldomainfields.php

Ajoutez les lignes suivantes à la fin du fichier

// Netim additionnal fields
include(ROOTDIR."/modules/registrars/netim/additionaldomainfields.v6.inc.php");

Pour WHMCS 7+

Editez (créez si nécessaire) le fichier /resources/domains/additionalfields.php

Ajoutez les lignes suivantes à la fin du fichier

// Netim additionnal fields
include(ROOTDIR."/modules/registrars/netim/additionaldomainfields.v7.inc.php");

Nos champs additionnels nécessitent des traductions qui doivent aussi être installées. Ainsi, pour chaque langue activée dans WHMCS, vous devez redéfinir les fichiers de langues afin d'ajouter les traductions.

Par défaut, vous fournissons les traductions en français et en anglais.

Pour l'anglais

Créez si nécessaire le fichier /lang/overrides/english.php

Ajoutez les lignes suivantes au contenu

<?php

// Netim language pack
include(ROOTDIR."/modules/registrars/netim/english.inc.php");

?>

Attention: si le fichier existe déjà, n'ajoutez que le contenu entre les balises php

Pour le français

Créez si nécessaire le fichier /lang/overrides/french.php

Ajoutez les lignes suivantes au contenu

<?php

// Netim language pack
include(ROOTDIR."/modules/registrars/netim/french.inc.php");

?>

Attention: si le fichier a déjà un contenu, ne mettez pas les balises php

Pour les autres langues

Redéfinissez les langues de votre choix en créant le fichier correspondant dans le répertoire /lang/overrides/ (Voir http://docs.whmcs.com/Language_Overrides)

Copiez dans ce fichier les valeurs correspondantes aux champs additionnels des extensions voulues (à copier depuis french.inc.php)

Traduisez dans la langue correspondante

Synchronisation

La synchronisation des domaines est réalisée par les tâches planifiées de WHMCS.

Néanmoins, WHMCS ne connaît pas le résultat de toutes les opérations notamment celles qui sont traitées de manière asynchrone.

Les opérations asynchrones doivent donc être traitées séparément. Lorsque le cas se produit, le numéro d'opération interne à NETIM est enregistré dans le champ "subscription Id" du domaine.

Un script de synchronisation des opérations (netim_opesync.php) est alors nécessaire

Manuellement

Vous pouvez appeler dans votre navigateur le script de synchronisation à l'adresse http://URL/modules/registrars/netim/netim_opesync.php

Automatiquement

Vous pouvez le planifier l’exécution sur votre serveur, par exemple sous linux:

*/10 * * * * php /chemin_absolu_whmcs/modules/registrars/netim/netim_opesync.php

Utilisateurs du module < 2.6

Dans les anciennes versions, le script réalise toutes les synchronisations (domaines et opération en attente)

*/10 * * * * php /chemin_absolu_whmcs/modules/registrars/netim/netimsync.php