GeoIP Country CodeAide en ligne

  1. GeoIP Country CodeAide en ligne
    1. Présentation
    2. Avertissements
    3. Installation
    4. Accès à l'aide en ligne
    5. Principe de fonctionnement
    6. API et base de données
    7. Utilisation
    8. Désinstallation
    9. Remerciements

Présentation

GeoIP Country Code, nommé ci-dessous GeoIPcc, est un plugin mettant à disposition des webmaîtres une balise SPIP pour leurs squelettes. Cette balise insère à la compilation le code pays (Domaine_de_premier_niveau) du visiteur.
Exemples :
Pour d'autres exemples, consultez cette page de démonstration.

Avertissements

GeoIPcc, est un programme libre, vous pouvez le redistribuer et/ou le modifier selon les termes de la Licence Publique Generale GNU publiée par la Free Software Foundation (version 2 ou bien toute autre version ultérieure choisie par vous). GeoIPcc, est distribué, car potentiellement utile, mais SANS AUCUNE GARANTIE, ni explicite ni implicite, y compris les garanties de commercialisation ou d'adaptation dans un but spécifique. Reportez-vous à la Licence Publique Générale GNU pour plus de détails. Vous devez avoir reçu une copie de la Licence Publique Générale GNU en même temps que ce programme ; si ce n'est pas le cas, écrivez à la Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, Etats-Unis.

GeoIPcc, is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. GeoIPcc, is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this package. If not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

Installation

Téléchargez l’archive GeoIPcc sur la zone puis décompressez l'archive. Le résultat est un dossier portant le nom du plug-in, dossier qu'il vous faut placer le dossier du plug-in, dans le dossier plugins de votre site. Pour plus d’information sur l’installation d’un plug-in, consulter cette page sur Spip.net.

Accès à l'aide en ligne

L'aide en ligne de GeoIPcc est accessible via l'espace privé du site, aux administrateurs en charge de toutes les rubriques.

Principe de fonctionnement

Pour identifier le pays du visiteur, GeoIPcc recherche l'adresse IP qui vous passez en paramètre, lit le fichier GeoIP Country - base de données de MaxMind - et renvoie le code pays correspondant à cette adresse IP.
Le fichier base de données est téléchargé lors de l'installation du plug-in. Il est sauvegardé dans tmp/GeoIP.dat. Si vous supprimez tous les fichiers présents dans votre dossier tmp/, GeoIPcc replacera automatiquement ce fichier tmp/GeoIP.dat, à condition bien sûr que l'accès au serveur MaxMind soit disponible.
De plus, tous les 1er du mois, GeoIPcc effectuera une mise à jour de tmp/GeoIP.dat si nécessaire.

API et base de données

Il peut arriver que la structure de la base soit modifiée par son créateur. Dans ce cas, il y a de fortes chances que l'API soit modifiée aussi.
L'API (script geoip.inc.php) est issue de geolite.maxmind.com. Si le plug-in ne donne plus de bons résultats, il sera peut-être nécessaire de  vérifier s'il n'y a pas une nouvelle version de l'API dans ce répertoire distant. Si c'est le cas, téléchargez le script geoip.inc, ou sa nouvelle version. Vérifiez-le, et enregistrez-le sous le nom geoip.inc.php dans le répertoire du plug-in. Testez le tout sur un serveur de test et si le résultat est positif, svp, signalez cette modification sur la zone. Merci.

Utilisation

Placez la balise #GEOIP_COUNTRY_CODE dans un le squelette. Lorsque la page est appelée et construite par SPIP, la balise détectera l'adresse IP du visiteur et renverra le code pays comme résultat. C'est ce code pays qui sera affiché en espace public.

Désinstallation

Pour désinstaller le plug-in GeoIPcc,, il suffit, comme pour désinstaller tout plug-in, de cliquer sur la petite boîte en page de configuration.
En cliquant sur la petite boîte, vous supprimez les fichiers temporaires des pays. Si vous ne désirez pas supprimer ces fichiers temporaires, cliquez sur la case à cocher à gauche du nom du plug-in et validez.

Remerciements