GeoIP Country CodeAide
en ligne
- GeoIP Country CodeAide
en ligne
- Présentation
- Avertissements
- Installation
- Accès à
l'aide en ligne
- Principe de
fonctionnement
- API et base de données
- Utilisation
- Désinstallation
- 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 une adresse IP 123.123.123.123, le code renvoyé sera
: #GEOIP_COUNTRY_CODE{123.123.123.123}
- si vous êtes sur un réseau local, de classe C, le
code pays renvoyé est celui défini par défaut :
#GEOIP_COUNTRY_CODE
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