source: spip-zone/_plugins_/geoip_country_code/geoipcc_aide.html @ 70522

Last change on this file since 70522 was 31759, checked in by paladin@…, 11 years ago

L'aide en ligne (bouton Aide en espace prive') et un petit squelette de demonstration

  • Property svn:eol-style set to native
  • Property svn:keywords set to LastChangedRevision LastChangedDate LastChangedBy
File size: 9.0 KB
Line 
1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2<html>
3<head>
4<!--
5
6/**
7 * Copyright (c) 2009 Christian Paulus - http://www.quesaco.org
8 * Dual licensed under the MIT and GPL licenses.
9 * */
10 
11Ce fichier a ete cree/edite' via SeaMonkey.
12
13http://www.seamonkey-project.org/
14
15
16Svp, essayez de conserver l'utilisation de cet outil. Il permet de mettre a' jour
17la table des contenus tres simplement.
18
19-->
20  <meta http-equiv="Content-Type"
21 content="text/html; charset=iso-8859-1">
22  <title>Aide GEOIP Country Code</title>
23  <meta content="Christian Paulus &lt;cpaulus@quesaco.org&gt;" name="author">
24  <meta
25 content="Aide en ligne pour le plugin Ecrire Contact (EcCo) / SPIP"
26 name="description">
27  <style type="text/css">
28<!--
29body { background: url(#CHEMIN{images/geoipcc-64.png}) no-repeat top center; 
30font: 90%/1.5em "Luxi sans", "Lucida Grande", Lucida, "Lucida Sans Unicode", sans-serif; color: #000;
31padding:1em 2ex;
32}
33h1 small {display:block; font-weight:500; margin:0; padding:0}
34img { text-align:center;display:block; margin:1em auto; padding:1ex; border:1px solid gray }
35table { margin:0 auto; border:0; border-collapse:collapse; }
36td { border:1px solid #ccc;padding:0.5em 1ex }
37-->
38  </style>
39</head>
40<body>
41<h1><a class="mozTocH1" name="mozTocId902493"></a>GeoIP Country Code<small>Aide
42en ligne</small>
43</h1>
44<ol id="mozToc">
45<!--mozToc h1 1 h2 2-->
46  <li><a href="#mozTocId902493">GeoIP Country CodeAide
47en ligne </a>
48    <ol>
49      <li><a href="#mozTocId438123">Pr&eacute;sentation</a></li>
50      <li><a href="#mozTocId257163">Avertissements</a></li>
51      <li><a href="#mozTocId573185">Installation</a></li>
52      <li><a href="#mozTocId82496">Acc&egrave;s &agrave;
53l'aide en ligne</a></li>
54      <li><a href="#mozTocId591014">Principe de
55fonctionnement</a></li>
56      <li><a href="#mozTocId453610">API et base de donn&eacute;es</a></li>
57      <li><a href="#mozTocId966567">Utilisation</a></li>
58      <li><a href="#mozTocId684173">D&eacute;sinstallation</a></li>
59      <li><a href="#mozTocId455542">Remerciements</a></li>
60    </ol>
61  </li>
62</ol>
63<h2><a class="mozTocH2" name="mozTocId438123"></a>Pr&eacute;sentation</h2>
64<span style="font-weight: bold;">GeoIP Country Code</span>,
65nomm&eacute; ci-dessous <span style="font-weight: bold;">GeoIPcc</span>,
66est un plugin mettant &agrave; disposition des webma&icirc;tres
67une balise SPIP pour leurs squelettes. Cette balise ins&egrave;re
68&agrave; la compilation le
69code pays (<a
70 href="http://fr.wikipedia.org/wiki/Domaine_de_premier_niveau">Domaine_de_premier_niveau</a>)
71du visiteur. <br>
72Exemples :<br>
73<ul>
74  <li>pour une adresse IP 123.123.123.123, le code renvoy&eacute; sera
75: #GEOIP_COUNTRY_CODE{123.123.123.123}</li>
76  <li>si vous &ecirc;tes sur un r&eacute;seau local, de classe C, le
77code pays renvoy&eacute; est celui d&eacute;fini par d&eacute;faut :
78#GEOIP_COUNTRY_CODE&nbsp;</li>
79</ul>
80Pour <a href="?page=geoipcc_demo">d'autres exemples, consultez cette
81page de d&eacute;monstration</a>.<br>
82<h2><a class="mozTocH2" name="mozTocId257163"></a>Avertissements</h2>
83<span style="font-weight: bold;">GeoIPcc</span>, est un programme
84libre,
85vous pouvez le redistribuer et/ou le modifier selon les termes de la
86Licence Publique Generale GNU publi&eacute;e par la <a
87 href="http://www.fsf.org/">Free Software Foundation</a> (version 2 ou
88bien toute autre version ult&eacute;rieure choisie par vous). <span
89 style="font-weight: bold;">GeoIPcc</span>, est distribu&eacute;, car
90potentiellement utile, mais SANS AUCUNE GARANTIE, ni explicite ni
91implicite, y compris les garanties de commercialisation ou d'adaptation
92dans un but sp&eacute;cifique. Reportez-vous &agrave; la Licence
93Publique G&eacute;n&eacute;rale GNU pour plus de d&eacute;tails. Vous
94devez avoir re&ccedil;u une copie de la Licence Publique
95G&eacute;n&eacute;rale GNU en m&ecirc;me temps que ce programme ; si ce
96n'est
97pas le cas, &eacute;crivez &agrave; la Free Software Foundation, Inc.,
9859 Temple Place, Suite 330, Boston, MA 02111-1307, Etats-Unis.<br>
99<br>
100<span style="font-weight: bold;">GeoIPcc</span>, is free software; you
101can
102redistribute it and/or modify it under the terms of the GNU General
103Public License as published by the <a href="http://www.fsf.org/">Free
104Software Foundation</a>; either version 2 of the License, or (at your
105option) any later version. <span style="font-weight: bold;">GeoIPcc</span>,
106is distributed in the hope that it will be useful, but WITHOUT ANY
107WARRANTY; without even the implied warranty of MERCHANTABILITY or
108FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
109for more details. You should have received a copy of the GNU General
110Public License along with this package.
111If not, write to the Free Software Foundation, Inc., 51 Franklin St,
112Fifth Floor, Boston, MA 02110-1301 USA.<br>
113<h2><a class="mozTocH2" name="mozTocId573185"></a>Installation</h2>
114T&eacute;l&eacute;chargez l&#8217;archive <span style="font-weight: bold;">GeoIPcc</span>
115sur la zone puis d&eacute;compressez l'archive. Le r&eacute;sultat est
116un dossier portant le nom du plug-in, dossier qu'il vous faut placer le
117dossier du plug-in, dans le dossier <span style="font-style: italic;">plugins</span>
118de votre site. Pour plus d&#8217;information sur l&#8217;installation d&#8217;un plug-in,
119<a href="http://www.spip.net/fr_article3396.html">consulter
120cette page sur Spip.net</a>.<br>
121<h2><a class="mozTocH2" name="mozTocId82496"></a>Acc&egrave;s &agrave;
122l'aide en ligne</h2>
123L'aide en ligne de <span style="font-weight: bold;">GeoIPcc</span> est
124accessible via l'espace priv&eacute; du site, aux administrateurs en
125charge de toutes les rubriques.<br>
126<h2><a class="mozTocH2" name="mozTocId591014"></a>Principe de
127fonctionnement</h2>
128Pour identifier le pays du visiteur, <span style="font-weight: bold;">GeoIPcc</span>
129recherche l'adresse IP qui vous passez en param&egrave;tre, lit le
130fichier GeoIP Country - base de donn&eacute;es de MaxMind - et renvoie
131le code pays correspondant &agrave; cette adresse IP.<br>
132Le fichier base de donn&eacute;es est t&eacute;l&eacute;charg&eacute;
133lors de l'installation du plug-in. Il est sauvegard&eacute; dans <span
134 style="font-weight: bold;">tmp/GeoIP.dat</span>. Si vous supprimez
135tous les fichiers pr&eacute;sents dans votre dossier <span
136 style="font-weight: bold;">tmp/</span>, <span
137 style="font-weight: bold;">GeoIPcc</span> replacera automatiquement ce
138fichier <span style="font-weight: bold;">tmp/GeoIP.dat</span>,
139&agrave; condition bien s&ucirc;r que l'acc&egrave;s au serveur
140MaxMind soit disponible.<br>
141De plus, tous les 1er du mois, <span style="font-weight: bold;">GeoIPcc</span>
142effectuera une mise &agrave; jour de <span style="font-weight: bold;">tmp/GeoIP.dat</span>
143si n&eacute;cessaire.
144<br>
145<!--
146
147        API et base
148
149-->
150<h2><a class="mozTocH2" name="mozTocId453610"></a>API et base de
151donn&eacute;es</h2>
152Il peut arriver que la structure de la base soit modifi&eacute;e par
153son cr&eacute;ateur. Dans ce cas, il y a de fortes chances que l'<a
154 href="http://fr.wikipedia.org/wiki/Interface_de_programmation">API</a>
155soit modifi&eacute;e aussi.<br>
156L'API (script <span style="font-weight: bold;">geoip.inc.php</span>)
157est issue de <a
158 href="http://geolite.maxmind.com/download/geoip/api/php/">geolite.maxmind.com</a>.
159Si le plug-in ne donne plus de bons r&eacute;sultats, il sera
160peut-&ecirc;tre n&eacute;cessaire de&nbsp; v&eacute;rifier s'il n'y a
161pas une nouvelle version de l'API dans ce r&eacute;pertoire distant. Si
162c'est le cas, t&eacute;l&eacute;chargez le script <span
163 style="font-weight: bold;">geoip.inc</span>, ou sa nouvelle version.
164V&eacute;rifiez-le, et
165enregistrez-le sous le nom <span style="font-weight: bold;">geoip.inc.php</span>
166dans le r&eacute;pertoire du plug-in. Testez le tout sur un serveur de
167test et si le r&eacute;sultat est positif, svp, signalez cette
168modification sur la zone. Merci.<br>
169<!--
170
171        Utilisation
172
173-->
174<h2><a class="mozTocH2" name="mozTocId966567"></a>Utilisation</h2>
175Placez la balise #GEOIP_COUNTRY_CODE dans un le squelette. Lorsque la
176page est appel&eacute;e et construite par SPIP, la balise
177d&eacute;tectera l'adresse IP du visiteur et renverra le code pays
178comme r&eacute;sultat. C'est ce code pays qui sera affich&eacute; en
179espace public.<br>
180<!--
181
182        desintallation
183
184-->
185<h2><a class="mozTocH2" name="mozTocId684173"></a>D&eacute;sinstallation</h2>
186Pour d&eacute;sinstaller le plug-in <span style="font-weight: bold;">GeoIPcc</span>,,
187il suffit, comme pour d&eacute;sinstaller tout plug-in, de cliquer sur
188la petite bo&icirc;te en page de configuration.<br>
189En cliquant sur la petite bo&icirc;te, vous supprimez les fichiers
190temporaires des pays. Si vous ne d&eacute;sirez pas supprimer ces
191fichiers temporaires, cliquez sur la case &agrave; cocher &agrave;
192gauche du nom du plug-in et validez.<br>
193<h2><a class="mozTocH2" name="mozTocId455542"></a>Remerciements</h2>
194<ul>
195  <li>A <a href="http://www.maxmind.com/app/geolitecountry">MaxMind
196pour la mise &agrave; disposition de la base de donn&eacute;es GeoIP
197Country</a>.</li>
198  <li>A toute l'&eacute;quipe de <a href="http://www.spip.net/fr">SPIP</a> et
199   les contributeurs de <a
200 href="http://zone.spip.org/trac/spip-zone/">la zone SPIP</a>.</li>
201</ul>
202<br>
203<br>
204</body>
205</html>
Note: See TracBrowser for help on using the repository browser.