Artifact a0158658f69dc2cdf2f6513e162822f60d175d47:

Wiki page [Plugins] by bohwaz on 2017-08-01 06:00:38.
0000: 44 20 32 30 31 37 2d 30 38 2d 30 31 54 30 34 3a  D 2017-08-01T04:
0010: 30 30 3a 33 38 2e 32 32 30 0a 4c 20 50 6c 75 67  00:38.220.L Plug
0020: 69 6e 73 0a 4e 20 74 65 78 74 2f 78 2d 6d 61 72  ins.N text/x-mar
0030: 6b 64 6f 77 6e 0a 50 20 62 62 36 39 38 61 35 66  kdown.P bb698a5f
0040: 66 34 33 62 33 66 32 36 64 62 65 32 32 65 35 33  f43b3f26dbe22e53
0050: 65 36 61 38 63 35 65 31 65 64 31 65 62 35 30 39  e6a8c5e1ed1eb509
0060: 0a 55 20 62 6f 68 77 61 7a 0a 57 20 31 34 39 30  .U bohwaz.W 1490
0070: 38 0a 23 20 4c 65 73 20 70 6c 75 67 69 6e 73 20  8.# Les plugins 
0080: 64 61 6e 73 20 47 61 72 72 61 64 69 6e 0d 0a 0d  dans Garradin...
0090: 0a 47 61 72 72 61 64 69 6e 20 70 65 72 6d 65 74  .Garradin permet
00a0: 20 64 27 c3 a9 74 65 6e 64 72 65 20 73 65 73 20   d'..tendre ses 
00b0: 66 6f 6e 63 74 69 6f 6e 6e 61 6c 69 74 c3 a9 73  fonctionnalit..s
00c0: 20 61 76 65 63 20 64 65 73 20 70 6c 75 67 69 6e   avec des plugin
00d0: 73 20 28 61 70 70 65 6c c3 a9 73 20 65 78 74 65  s (appel..s exte
00e0: 6e 73 69 6f 6e 73 20 64 61 6e 73 20 6c 61 20 70  nsions dans la p
00f0: 61 72 74 69 65 20 70 72 69 76 c3 a9 65 2f 61 64  artie priv..e/ad
0100: 6d 69 6e 20 64 65 20 47 61 72 72 61 64 69 6e 29  min de Garradin)
0110: 2e 0d 0a 0d 0a 4c 27 69 6e 74 65 72 66 61 63 65  .....L'interface
0120: 20 64 65 20 47 61 72 72 61 64 69 6e 20 65 73 74   de Garradin est
0130: 20 73 c3 a9 70 61 72 c3 a9 65 20 65 6e 20 64 65   s..par..e en de
0140: 75 78 20 73 65 63 74 69 6f 6e 73 20 3a 20 6c 61  ux sections : la
0150: 20 73 65 63 74 69 6f 6e 20 70 75 62 6c 69 71 75   section publiqu
0160: 65 20 63 6f 72 72 65 73 70 6f 6e 64 20 61 75 20  e correspond au 
0170: 73 69 74 65 20 77 65 62 20 64 65 20 6c 27 61 73  site web de l'as
0180: 73 6f 63 69 61 74 69 6f 6e 2c 20 61 63 63 65 73  sociation, acces
0190: 73 69 62 6c 65 20 c3 a0 20 74 6f 75 74 20 76 69  sible .. tout vi
01a0: 73 69 74 65 75 72 2c 20 65 74 20 6c 61 20 73 65  siteur, et la se
01b0: 63 74 69 6f 6e 20 70 72 69 76 c3 a9 65 2c 20 61  ction priv..e, a
01c0: 75 73 73 69 20 61 70 70 65 6c c3 a9 65 20 61 64  ussi appel..e ad
01d0: 6d 69 6e 69 73 74 72 61 74 69 6f 6e 20 64 65 20  ministration de 
01e0: 6c 27 61 73 73 6f 63 69 61 74 69 6f 6e 2e 20 4c  l'association. L
01f0: 65 73 20 70 6c 75 67 69 6e 73 20 70 65 75 76 65  es plugins peuve
0200: 6e 74 20 c3 a9 74 65 6e 64 72 65 20 6c 27 75 6e  nt ..tendre l'un
0210: 65 20 6f 75 20 6c 27 61 75 74 72 65 20 70 61 72  e ou l'autre par
0220: 74 69 65 2c 20 6f 75 20 6d c3 aa 6d 65 20 6c 65  tie, ou m..me le
0230: 73 20 64 65 75 78 2e 0d 0a 0d 0a 23 23 20 49 6e  s deux.....## In
0240: 73 74 61 6c 6c 61 74 69 6f 6e 0d 0a 0d 0a 4c 65  stallation....Le
0250: 73 20 70 6c 75 67 69 6e 73 20 70 65 75 76 65 6e  s plugins peuven
0260: 74 20 c3 aa 74 72 65 20 69 6e 73 74 61 6c 6c c3  t ..tre install.
0270: a9 73 20 64 65 20 64 65 75 78 20 6d 61 6e 69 c3  .s de deux mani.
0280: a8 72 65 73 20 3a 0d 0a 0d 0a 2a 20 70 61 72 20  .res :....* par 
0290: 6c 65 20 63 61 74 61 6c 6f 67 75 65 20 64 65 73  le catalogue des
02a0: 20 65 78 74 65 6e 73 69 6f 6e 73 20 28 65 78 74   extensions (ext
02b0: 65 6e 73 69 6f 6e 73 20 6f 66 66 69 63 69 65 6c  ensions officiel
02c0: 6c 65 73 29 20 5b 6e 6f 6e 20 66 6f 6e 63 74 69  les) [non foncti
02d0: 6f 6e 6e 65 6c 20 70 6f 75 72 20 6c 65 20 6d 6f  onnel pour le mo
02e0: 6d 65 6e 74 5d 0d 0a 2a 20 73 69 6d 70 6c 65 6d  ment]..* simplem
02f0: 65 6e 74 20 65 6e 20 63 6f 70 69 61 6e 74 20 6c  ent en copiant l
0300: 65 20 66 69 63 68 69 65 72 20 64 65 20 6c 27 65  e fichier de l'e
0310: 78 74 65 6e 73 69 6f 6e 20 64 61 6e 73 20 6c 65  xtension dans le
0320: 20 72 c3 a9 70 65 72 74 6f 69 72 65 20 60 70 6c   r..pertoire `pl
0330: 75 67 69 6e 73 60 20 64 65 20 47 61 72 72 61 64  ugins` de Garrad
0340: 69 6e 20 28 65 78 74 65 6e 73 69 6f 6e 73 20 6e  in (extensions n
0350: 6f 6e 2d 6f 66 66 69 63 69 65 6c 6c 65 73 29 0d  on-officielles).
0360: 0a 0d 0a 23 23 20 44 c3 a9 76 65 6c 6f 70 70 65  ...## D..veloppe
0370: 6d 65 6e 74 0d 0a 0d 0a 50 6f 75 72 20 66 61 63  ment....Pour fac
0380: 69 6c 69 74 65 72 20 6c 65 20 64 c3 a9 76 65 6c  iliter le d..vel
0390: 6f 70 70 65 6d 65 6e 74 20 64 65 20 70 6c 75 67  oppement de plug
03a0: 69 6e 73 20 69 6c 20 65 73 74 20 61 75 73 73 69  ins il est aussi
03b0: 20 70 6f 73 73 69 62 6c 65 20 64 65 20 70 6c 61   possible de pla
03c0: 63 65 72 20 6c 65 20 63 6f 64 65 20 64 75 20 70  cer le code du p
03d0: 6c 75 67 69 6e 20 64 61 6e 73 20 75 6e 20 73 6f  lugin dans un so
03e0: 75 73 2d 72 c3 a9 70 65 72 74 6f 69 72 65 20 64  us-r..pertoire d
03f0: 65 20 60 70 6c 75 67 69 6e 73 60 2c 20 61 69 6e  e `plugins`, ain
0400: 73 69 20 69 6c 20 6e 27 65 73 74 20 70 61 73 20  si il n'est pas 
0410: 6e c3 a9 63 65 73 73 61 69 72 65 20 64 65 20 72  n..cessaire de r
0420: 65 2d 70 61 63 6b 61 67 65 72 20 6c 65 20 70 6c  e-packager le pl
0430: 75 67 69 6e 20 c3 a0 20 63 68 61 71 75 65 20 6d  ugin .. chaque m
0440: 6f 64 69 66 69 63 61 74 69 6f 6e 2e 0d 0a 0d 0a  odification.....
0450: 23 23 23 20 42 6f 6e 6e 65 73 20 70 72 61 74 69  ### Bonnes prati
0460: 71 75 65 73 0d 0a 0d 0a 4c 65 73 20 70 6c 75 67  ques....Les plug
0470: 69 6e 73 20 6f 66 66 69 63 69 65 6c 73 20 73 6f  ins officiels so
0480: 6e 74 20 72 65 6c 75 73 20 65 74 20 76 c3 a9 72  nt relus et v..r
0490: 69 66 69 c3 a9 73 20 61 76 61 6e 74 20 70 75 62  ifi..s avant pub
04a0: 6c 69 63 61 74 69 6f 6e 20 65 74 20 67 61 72 61  lication et gara
04b0: 6e 74 69 73 73 65 6e 74 20 71 75 27 69 6c 73 20  ntissent qu'ils 
04c0: 6e 65 20 64 65 76 72 61 69 65 6e 74 20 70 61 73  ne devraient pas
04d0: 20 61 74 74 65 69 6e 64 72 65 20 61 75 20 62 6f   atteindre au bo
04e0: 6e 20 66 6f 6e 63 74 69 6f 6e 6e 65 6d 65 6e 74  n fonctionnement
04f0: 20 64 65 20 47 61 72 72 61 64 69 6e 20 6f 75 20   de Garradin ou 
0500: 64 65 73 20 61 75 74 72 65 73 20 70 6c 75 67 69  des autres plugi
0510: 6e 73 2e 0d 0a 0d 0a 50 6f 75 72 20 70 6f 75 76  ns.....Pour pouv
0520: 6f 69 72 20 c3 aa 74 72 65 20 69 6e 74 c3 a9 67  oir ..tre int..g
0530: 72 c3 a9 20 61 75 20 63 61 74 61 6c 6f 67 75 65  r.. au catalogue
0540: 20 64 65 73 20 70 6c 75 67 69 6e 73 20 6f 66 66   des plugins off
0550: 69 63 69 65 6c 73 20 69 6c 20 66 61 75 74 20 71  iciels il faut q
0560: 75 27 69 6c 20 72 65 73 70 65 63 74 65 20 75 6e  u'il respecte un
0570: 20 65 6e 73 65 6d 62 6c 65 20 64 65 20 72 c3 a8   ensemble de r..
0580: 67 6c 65 73 20 c3 a9 64 69 63 74 c3 a9 20 70 6c  gles ..dict.. pl
0590: 75 73 20 62 61 73 20 3a 20 5b 72 c3 a8 67 6c 65  us bas : [r..gle
05a0: 73 20 64 75 20 63 61 74 61 6c 6f 67 75 65 5d 28  s du catalogue](
05b0: 23 52 c3 a8 67 6c 65 73 20 64 75 20 63 61 74 61  #R..gles du cata
05c0: 6c 6f 67 75 65 29 2e 0d 0a 0d 0a 4c 65 73 20 70  logue).....Les p
05d0: 6c 75 67 69 6e 73 20 6e 6f 6e 2d 6f 66 66 69 63  lugins non-offic
05e0: 69 65 6c 73 20 6e 65 20 73 6f 6e 74 20 73 6f 75  iels ne sont sou
05f0: 6d 69 73 20 c3 a0 20 61 75 63 75 6e 65 20 72 c3  mis .. aucune r.
0600: a8 67 6c 65 20 6d 61 69 73 20 69 6c 20 65 73 74  .gle mais il est
0610: 20 71 75 61 6e 64 20 6d c3 aa 6d 65 20 72 65 63   quand m..me rec
0620: 6f 6d 6d 61 6e 64 c3 a9 20 64 65 20 73 75 69 76  ommand.. de suiv
0630: 72 65 20 63 65 6c 6c 65 73 20 71 75 69 20 73 6f  re celles qui so
0640: 6e 74 20 69 6e 64 69 71 75 c3 a9 65 73 20 69 63  nt indiqu..es ic
0650: 69 2e 0d 0a 0d 0a 23 23 23 23 20 52 c3 a8 67 6c  i.....#### R..gl
0660: 65 73 20 64 75 20 63 61 74 61 6c 6f 67 75 65 0d  es du catalogue.
0670: 0a 0d 0a 50 6f 75 72 20 69 6e 74 c3 a9 67 72 65  ...Pour int..gre
0680: 72 20 6c 65 20 63 61 74 61 6c 6f 67 75 65 20 64  r le catalogue d
0690: 65 73 20 70 6c 75 67 69 6e 73 20 6f 66 66 69 63  es plugins offic
06a0: 69 65 6c 73 20 64 69 73 70 6f 6e 69 62 6c 65 73  iels disponibles
06b0: 20 64 69 72 65 63 74 65 6d 65 6e 74 20 64 65 70   directement dep
06c0: 75 69 73 20 47 61 72 72 61 64 69 6e 20 6c 65 20  uis Garradin le 
06d0: 70 6c 75 67 69 6e 20 64 6f 69 74 20 3a 0d 0a 0d  plugin doit :...
06e0: 0a 2a 20 c3 aa 74 72 65 20 73 6f 75 73 20 6c 69  .* ..tre sous li
06f0: 63 65 6e 63 65 20 6c 69 62 72 65 20 28 63 6f 6d  cence libre (com
0700: 70 61 74 69 62 6c 65 20 44 65 62 69 61 6e 20 65  patible Debian e
0710: 74 20 46 4f 53 53 20 3a 20 47 50 4c 2c 20 41 47  t FOSS : GPL, AG
0720: 50 4c 2c 20 42 53 44 2c 20 65 74 63 2e 29 20 61  PL, BSD, etc.) a
0730: 66 69 6e 20 64 65 20 70 6f 75 76 6f 69 72 20 c3  fin de pouvoir .
0740: aa 74 72 65 20 6d 61 69 6e 74 65 6e 75 20 64 61  .tre maintenu da
0750: 6e 73 20 6c 65 20 74 65 6d 70 73 20 70 61 72 20  ns le temps par 
0760: 6c 61 20 63 6f 6d 6d 75 6e 61 75 74 c3 a9 20 3b  la communaut.. ;
0770: 0d 0a 2a 20 61 76 6f 69 72 20 75 6e 20 63 6f 64  ..* avoir un cod
0780: 65 20 6c 69 73 69 62 6c 65 20 65 74 20 63 6c 61  e lisible et cla
0790: 69 72 20 28 70 65 75 20 69 6d 70 6f 72 74 65 20  ir (peu importe 
07a0: 6c 61 20 63 6f 6e 76 65 6e 74 69 6f 6e 20 64 65  la convention de
07b0: 20 63 6f 64 61 67 65 29 20 3b 0d 0a 2a 20 6e 65   codage) ;..* ne
07c0: 20 70 61 73 20 70 6f 72 74 65 72 20 61 74 74 65   pas porter atte
07d0: 69 6e 74 65 20 c3 a0 20 6c 27 69 6e 74 c3 a9 67  inte .. l'int..g
07e0: 72 69 74 c3 a9 20 65 74 20 6c 61 20 73 74 61 62  rit.. et la stab
07f0: 69 6c 69 74 c3 a9 20 64 65 20 47 61 72 72 61 64  ilit.. de Garrad
0800: 69 6e 2c 20 63 65 6c 61 20 69 6d 70 6c 69 71 75  in, cela impliqu
0810: 65 20 3a 0d 0a 20 2a 20 4e 45 20 50 41 53 20 70  e :.. * NE PAS p
0820: 61 74 63 68 65 72 2c 20 c3 a9 64 69 74 65 72 2c  atcher, ..diter,
0830: 20 73 75 70 70 72 69 6d 65 72 20 6f 75 20 61 6a   supprimer ou aj
0840: 6f 75 74 65 72 20 64 65 20 66 69 63 68 69 65 72  outer de fichier
0850: 73 20 61 75 20 63 6f 64 65 20 64 65 20 47 61 72  s au code de Gar
0860: 72 61 64 69 6e 20 6c 75 69 2d 6d c3 aa 6d 65 20  radin lui-m..me 
0870: 3a 20 6c 65 20 70 6c 75 67 69 6e 20 64 6f 69 74  : le plugin doit
0880: 20 c3 aa 74 72 65 20 63 6f 6e 74 65 6e 75 20 64   ..tre contenu d
0890: 61 6e 73 20 73 6f 6e 20 61 72 63 68 69 76 65 2e  ans son archive.
08a0: 20 49 6c 20 65 73 74 20 70 61 72 20 63 6f 6e 74   Il est par cont
08b0: 72 65 20 70 6f 73 73 69 62 6c 65 20 64 65 20 66  re possible de f
08c0: 61 69 72 65 20 64 c3 a9 70 65 6e 64 72 65 20 75  aire d..pendre u
08d0: 6e 20 70 6c 75 67 69 6e 20 64 65 20 63 6f 64 65  n plugin de code
08e0: 20 6f 75 20 63 6f 6d 70 6f 73 61 6e 74 73 20 63   ou composants c
08f0: 6f 6e 74 65 6e 75 73 20 64 61 6e 73 20 75 6e 20  ontenus dans un 
0900: 61 75 74 72 65 20 70 6c 75 67 69 6e 2e 0d 0a 20  autre plugin... 
0910: 2a 20 4e 45 20 50 41 53 20 73 74 6f 63 6b 65 72  * NE PAS stocker
0920: 20 64 65 20 64 6f 6e 6e c3 a9 65 73 20 65 6e 20   de donn..es en 
0930: 64 65 68 6f 72 73 20 64 65 20 6c 61 20 62 61 73  dehors de la bas
0940: 65 20 64 65 20 64 6f 6e 6e c3 a9 65 73 20 64 65  e de donn..es de
0950: 20 47 61 72 72 61 64 69 6e 2e 0d 0a 20 2a 20 4e   Garradin... * N
0960: 45 20 50 41 53 20 61 6a 6f 75 74 65 72 2c 20 6d  E PAS ajouter, m
0970: 6f 64 69 66 69 65 72 20 6f 75 20 73 75 70 70 72  odifier ou suppr
0980: 69 6d 65 72 20 64 69 72 65 63 74 65 6d 65 6e 74  imer directement
0990: 20 64 65 73 20 64 6f 6e 6e c3 a9 65 73 20 64 61   des donn..es da
09a0: 6e 73 20 6c 61 20 62 61 73 65 20 64 65 20 64 6f  ns la base de do
09b0: 6e 6e c3 a9 65 73 20 64 65 20 47 61 72 72 61 64  nn..es de Garrad
09c0: 69 6e 20 28 68 6f 72 6d 69 73 20 64 61 6e 73 20  in (hormis dans 
09d0: 73 61 20 70 72 6f 70 72 65 20 74 61 62 6c 65 29  sa propre table)
09e0: 2e 0d 0a 20 2a 20 4e 45 20 50 41 53 20 65 6e 72  ... * NE PAS enr
09f0: 65 67 69 73 74 72 65 72 20 64 65 20 64 6f 63 75  egistrer de docu
0a00: 6d 65 6e 74 73 20 73 61 6e 73 20 75 74 69 6c 69  ments sans utili
0a10: 73 65 72 20 6c 65 73 20 6d c3 a9 74 68 6f 64 65  ser les m..thode
0a20: 73 20 66 6f 75 72 6e 69 65 73 20 70 61 72 20 47  s fournies par G
0a30: 61 72 72 61 64 69 6e 2e 0d 0a 2a 20 72 65 73 70  arradin...* resp
0a40: 65 63 74 65 72 20 6c 61 20 76 69 65 20 70 72 69  ecter la vie pri
0a50: 76 c3 a9 65 20 64 65 73 20 75 74 69 6c 69 73 61  v..e des utilisa
0a60: 74 65 75 72 73 20 65 74 20 6e 6f 74 61 6d 6d 65  teurs et notamme
0a70: 6e 74 20 3a 0d 0a 20 2a 20 4e 45 20 50 41 53 20  nt :.. * NE PAS 
0a80: 63 6f 6e 74 61 63 74 65 72 20 75 6e 20 73 65 72  contacter un ser
0a90: 76 65 75 72 20 64 69 73 74 61 6e 74 20 28 73 61  veur distant (sa
0aa0: 75 66 20 62 65 73 6f 69 6e 20 73 70 c3 a9 63 69  uf besoin sp..ci
0ab0: 66 69 71 75 65 29 20 6e 69 20 74 72 61 6e 73 6d  fique) ni transm
0ac0: 65 74 74 72 65 20 64 65 73 20 69 6e 66 6f 72 6d  ettre des inform
0ad0: 61 74 69 6f 6e 73 20 6f 75 20 73 74 61 74 69 73  ations ou statis
0ae0: 74 69 71 75 65 73 20 c3 a0 20 75 6e 20 73 65 72  tiques .. un ser
0af0: 76 65 75 72 20 74 69 65 72 73 2e 0d 0a 0d 0a 23  veur tiers.....#
0b00: 23 20 44 c3 a9 74 61 69 6c 73 20 74 65 63 68 6e  # D..tails techn
0b10: 69 71 75 65 73 0d 0a 0d 0a 23 23 23 20 46 6f 72  iques....### For
0b20: 6d 61 74 20 64 65 73 20 70 6c 75 67 69 6e 73 0d  mat des plugins.
0b30: 0a 0d 0a 4c 65 73 20 70 6c 75 67 69 6e 73 20 73  ...Les plugins s
0b40: 6f 6e 74 20 64 65 73 20 61 72 63 68 69 76 65 73  ont des archives
0b50: 20 2e 74 61 72 2e 67 7a 20 3a 20 74 6f 75 73 20   .tar.gz : tous 
0b60: 6c 65 73 20 66 69 63 68 69 65 72 73 20 64 75 20  les fichiers du 
0b70: 70 6c 75 67 69 6e 20 28 63 6f 64 65 20 50 48 50  plugin (code PHP
0b80: 2c 20 43 53 53 2c 20 74 65 6d 70 6c 61 74 65 73  , CSS, templates
0b90: 2c 20 69 6d 61 67 65 73 2c 20 65 74 63 2e 29 20  , images, etc.) 
0ba0: 73 6f 6e 74 20 73 74 6f 63 6b c3 a9 73 20 64 61  sont stock..s da
0bb0: 6e 73 20 6c 27 61 72 63 68 69 76 65 20 65 74 20  ns l'archive et 
0bc0: 79 20 72 65 73 74 65 6e 74 20 28 6c 27 61 72 63  y restent (l'arc
0bd0: 68 69 76 65 20 6e 27 65 73 74 20 6a 61 6d 61 69  hive n'est jamai
0be0: 73 20 64 c3 a9 63 6f 6d 70 72 65 73 73 c3 a9 65  s d..compress..e
0bf0: 29 2e 0d 0a 0d 0a 49 6c 20 65 73 74 20 70 6f 73  ).....Il est pos
0c00: 73 69 62 6c 65 20 64 65 20 63 72 c3 a9 65 72 20  sible de cr..er 
0c10: 73 6f 69 2d 6d c3 aa 6d 65 20 6c 27 61 72 63 68  soi-m..me l'arch
0c20: 69 76 65 20 2e 74 61 72 2e 67 7a 20 64 65 20 63  ive .tar.gz de c
0c30: 65 74 74 65 20 6d 61 6e 69 c3 a8 72 65 2c 20 64  ette mani..re, d
0c40: 65 70 75 69 73 20 6c 65 20 72 c3 a9 70 65 72 74  epuis le r..pert
0c50: 6f 69 72 65 20 72 61 63 69 6e 65 20 64 75 20 70  oire racine du p
0c60: 6c 75 67 69 6e 20 3a 0d 0a 0d 0a 20 20 20 20 24  lugin :....    $
0c70: 20 74 61 72 20 63 7a 76 66 20 73 72 63 2f 70 6c   tar czvf src/pl
0c80: 75 67 69 6e 73 2f 74 65 73 74 2e 74 61 72 2e 67  ugins/test.tar.g
0c90: 7a 20 2e 2f 0d 0a 0d 0a 55 6e 20 73 63 72 69 70  z ./....Un scrip
0ca0: 74 20 50 48 50 20 28 60 6d 61 6b 65 5f 70 6c 75  t PHP (`make_plu
0cb0: 67 69 6e 2e 70 68 70 60 29 20 65 73 74 20 66 6f  gin.php`) est fo
0cc0: 75 72 6e 69 20 64 61 6e 73 20 6c 65 20 72 c3 a9  urni dans le r..
0cd0: 70 65 72 74 6f 69 72 65 20 60 74 6f 6f 6c 73 60  pertoire `tools`
0ce0: 20 64 65 20 6c 61 20 76 65 72 73 69 6f 6e 20 64   de la version d
0cf0: 65 20 64 c3 a9 76 65 6c 6f 70 70 65 6d 65 6e 74  e d..veloppement
0d00: 20 64 65 20 47 61 72 72 61 64 69 6e 20 61 66 69   de Garradin afi
0d10: 6e 20 64 65 20 76 c3 a9 72 69 66 69 65 72 20 6c  n de v..rifier l
0d20: 27 61 72 62 6f 72 65 73 63 65 6e 63 65 20 65 74  'arborescence et
0d30: 20 64 65 20 63 72 c3 a9 65 72 20 6c 27 61 72 63   de cr..er l'arc
0d40: 68 69 76 65 20 65 6e 20 6c 69 67 6e 65 20 64 65  hive en ligne de
0d50: 20 63 6f 6d 6d 61 6e 64 65 2e 20 53 6f 6e 20 75   commande. Son u
0d60: 74 69 6c 69 73 61 74 69 6f 6e 20 65 73 74 20 74  tilisation est t
0d70: 72 c3 a8 73 20 73 69 6d 70 6c 65 20 3a 0d 0a 0d  r..s simple :...
0d80: 0a 20 20 20 20 24 20 70 68 70 20 7e 2f 67 61 72  .    $ php ~/gar
0d90: 72 61 64 69 6e 2f 74 6f 6f 6c 73 2f 6d 61 6b 65  radin/tools/make
0da0: 5f 70 6c 75 67 69 6e 2e 70 68 70 20 7e 2f 64 65  _plugin.php ~/de
0db0: 76 2f 70 6c 75 67 69 6e 73 2f 74 65 73 74 20 7e  v/plugins/test ~
0dc0: 2f 67 61 72 72 61 64 69 6e 2f 73 72 63 2f 70 6c  /garradin/src/pl
0dd0: 75 67 69 6e 73 2f 74 65 73 74 2e 74 61 72 2e 67  ugins/test.tar.g
0de0: 7a 0d 0a 0d 0a 23 23 23 20 49 6e 66 6f 72 6d 61  z....### Informa
0df0: 74 69 6f 6e 73 20 73 75 72 20 6c 65 20 70 6c 75  tions sur le plu
0e00: 67 69 6e 20 28 67 61 72 72 61 64 69 6e 5f 70 6c  gin (garradin_pl
0e10: 75 67 69 6e 2e 69 6e 69 29 0d 0a 0d 0a 43 68 61  ugin.ini)....Cha
0e20: 71 75 65 20 70 6c 75 67 69 6e 20 64 6f 69 74 20  que plugin doit 
0e30: 61 75 20 6d 6f 69 6e 73 20 66 6f 75 72 6e 69 72  au moins fournir
0e40: 20 c3 a0 20 6c 61 20 72 61 63 69 6e 65 20 64 65   .. la racine de
0e50: 20 73 6f 6e 20 61 72 63 68 69 76 65 20 75 6e 20   son archive un 
0e60: 66 69 63 68 69 65 72 20 6e 6f 6d 6d c3 a9 20 60  fichier nomm.. `
0e70: 67 61 72 72 61 64 69 6e 5f 70 6c 75 67 69 6e 2e  garradin_plugin.
0e80: 69 6e 69 60 2e 20 43 65 20 66 69 63 68 69 65 72  ini`. Ce fichier
0e90: 20 66 6f 75 72 6e 69 74 20 6c 65 20 6e 6f 6d 2c   fournit le nom,
0ea0: 20 6c 61 20 64 65 73 63 72 69 70 74 69 6f 6e 20   la description 
0eb0: 65 74 20 71 75 65 6c 71 75 65 73 20 64 c3 a9 74  et quelques d..t
0ec0: 61 69 6c 73 20 73 75 72 20 6c 65 20 70 6c 75 67  ails sur le plug
0ed0: 69 6e 20 3a 0d 0a 0d 0a 20 20 20 20 6e 6f 6d 3d  in :....    nom=
0ee0: 22 4d 61 20 70 72 65 6d 69 c3 a8 72 65 20 65 78  "Ma premi..re ex
0ef0: 74 65 6e 73 69 6f 6e 20 47 61 72 72 61 64 69 6e  tension Garradin
0f00: 22 0d 0a 20 20 20 20 64 65 73 63 72 69 70 74 69  "..    descripti
0f10: 6f 6e 3d 22 41 66 66 69 63 68 65 20 75 6e 20 6d  on="Affiche un m
0f20: 65 73 73 61 67 65 20 74 72 6f 70 20 63 6f 6f 6c  essage trop cool
0f30: 22 0d 0a 20 20 20 20 61 75 74 65 75 72 3d 22 41  "..    auteur="A
0f40: 6e 6e 65 20 4f 6e 79 6d 65 22 0d 0a 20 20 20 20  nne Onyme"..    
0f50: 75 72 6c 3d 22 68 74 74 70 3a 2f 2f 67 61 72 72  url="http://garr
0f60: 61 64 69 6e 2e 65 75 2f 22 0d 0a 20 20 20 20 76  adin.eu/"..    v
0f70: 65 72 73 69 6f 6e 3d 22 31 2e 30 22 0d 0a 20 20  ersion="1.0"..  
0f80: 20 20 6d 65 6e 75 3d 31 0d 0a 20 20 20 20 63 6f    menu=1..    co
0f90: 6e 66 69 67 3d 31 0d 0a 20 20 20 20 6d 69 6e 5f  nfig=1..    min_
0fa0: 76 65 72 73 69 6f 6e 3d 22 30 2e 37 2e 30 22 0d  version="0.7.0".
0fb0: 0a 0d 0a 45 78 70 6c 69 63 61 74 69 6f 6e 20 64  ...Explication d
0fc0: 65 73 20 64 69 72 65 63 74 69 76 65 73 20 3a 0d  es directives :.
0fd0: 0a 0d 0a 2a 20 2a 2a 6e 6f 6d 2a 2a 20 69 6e 64  ...* **nom** ind
0fe0: 69 71 75 65 20 6c 65 20 6e 6f 6d 20 64 75 20 70  ique le nom du p
0ff0: 6c 75 67 69 6e 2c 20 71 75 69 20 73 65 72 61 20  lugin, qui sera 
1000: 75 74 69 6c 69 73 c3 a9 20 64 61 6e 73 20 6c 65  utilis.. dans le
1010: 73 20 6c 69 73 74 65 73 20 65 74 20 6d 65 6e 75  s listes et menu
1020: 73 2e 0d 0a 2a 20 2a 2a 64 65 73 63 72 69 70 74  s...* **descript
1030: 69 6f 6e 2a 2a 20 66 6f 75 72 6e 69 74 20 75 6e  ion** fournit un
1040: 65 20 64 65 73 63 72 69 70 74 69 6f 6e 20 70 6c  e description pl
1050: 75 73 20 6c 6f 6e 67 75 65 2c 20 70 65 75 74 20  us longue, peut 
1060: 66 61 69 72 65 20 70 6c 75 73 69 65 75 72 73 20  faire plusieurs 
1070: 6c 69 67 6e 65 73 2e 0d 0a 2a 20 2a 2a 61 75 74  lignes...* **aut
1080: 65 75 72 2a 2a 20 64 6f 6e 6e 65 20 6c 65 20 6e  eur** donne le n
1090: 6f 6d 20 64 65 20 6c 27 61 75 74 65 75 72 20 64  om de l'auteur d
10a0: 75 20 70 6c 75 67 69 6e 0d 0a 2a 20 2a 2a 75 72  u plugin..* **ur
10b0: 6c 2a 2a 20 69 6e 64 69 71 75 65 20 6c 27 61 64  l** indique l'ad
10c0: 72 65 73 73 65 20 64 75 20 73 69 74 65 20 77 65  resse du site we
10d0: 62 20 64 65 20 6c 27 61 75 74 65 75 72 2e 0d 0a  b de l'auteur...
10e0: 2a 20 2a 2a 76 65 72 73 69 6f 6e 2a 2a 20 65 73  * **version** es
10f0: 74 20 75 74 69 6c 69 73 c3 a9 65 20 70 6f 75 72  t utilis..e pour
1100: 20 73 61 76 6f 69 72 20 71 75 65 6c 6c 65 20 65   savoir quelle e
1110: 73 74 20 6c 61 20 76 65 72 73 69 6f 6e 20 64 75  st la version du
1120: 20 70 6c 75 67 69 6e 20 66 6f 75 72 6e 69 65 20   plugin fournie 
1130: 64 61 6e 73 20 6c 27 61 72 63 68 69 76 65 2e 20  dans l'archive. 
1140: 56 6f 69 72 20 70 6c 75 73 20 6c 6f 69 6e 20 3a  Voir plus loin :
1150: 20 5b 4d 69 73 65 20 c3 a0 20 6a 6f 75 72 5d 28   [Mise .. jour](
1160: 23 4d 69 73 65 20 c3 a0 20 6a 6f 75 72 29 2e 0d  #Mise .. jour)..
1170: 0a 2a 20 2a 2a 6d 65 6e 75 2a 2a 20 69 6e 64 69  .* **menu** indi
1180: 71 75 65 20 c3 a0 20 47 61 72 72 61 64 69 6e 20  que .. Garradin 
1190: 73 27 69 6c 20 64 6f 69 74 20 61 66 66 69 63 68  s'il doit affich
11a0: 65 72 20 75 6e 65 20 65 6e 74 72 c3 a9 65 20 64  er une entr..e d
11b0: 61 6e 73 20 6c 65 20 6d 65 6e 75 20 64 65 73 20  ans le menu des 
11c0: 65 78 74 65 6e 73 69 6f 6e 73 20 64 65 20 6c 61  extensions de la
11d0: 20 70 61 72 74 69 65 20 70 72 69 76 c3 a9 65 2e   partie priv..e.
11e0: 20 43 65 74 74 65 20 65 6e 74 72 c3 a9 65 20 73   Cette entr..e s
11f0: 65 72 61 20 76 69 73 69 62 6c 65 20 70 61 72 20  era visible par 
1200: 74 6f 75 73 20 6c 65 73 20 6d 65 6d 62 72 65 73  tous les membres
1210: 20 71 75 69 20 70 65 75 76 65 6e 74 20 73 65 20   qui peuvent se 
1220: 63 6f 6e 6e 65 63 74 65 72 2c 20 6d c3 aa 6d 65  connecter, m..me
1230: 20 73 69 20 6c 27 65 78 74 65 6e 73 69 6f 6e 20   si l'extension 
1240: 72 65 73 74 72 65 69 6e 74 20 65 6e 73 75 69 74  restreint ensuit
1250: 65 20 73 6f 6e 20 61 63 63 c3 a8 73 2e 20 4c 27  e son acc..s. L'
1260: 65 6e 74 72 c3 a9 65 20 64 75 20 6d 65 6e 75 20  entr..e du menu 
1270: 61 70 70 65 6c 6c 65 72 61 20 6c 65 20 66 69 63  appellera le fic
1280: 68 69 65 72 20 60 77 77 77 2f 61 64 6d 69 6e 2f  hier `www/admin/
1290: 69 6e 64 65 78 2e 70 68 70 60 20 71 75 69 20 64  index.php` qui d
12a0: 65 76 72 61 20 64 6f 6e 63 20 65 78 69 73 74 65  evra donc existe
12b0: 72 2c 20 c3 a0 20 64 c3 a9 66 61 75 74 20 6c 27  r, .. d..faut l'
12c0: 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 64 65 20  installation de 
12d0: 6c 27 65 78 74 65 6e 73 69 6f 6e 20 c3 a9 63 68  l'extension ..ch
12e0: 6f 75 65 72 61 2e 0d 0a 2a 20 2a 2a 63 6f 6e 66  ouera...* **conf
12f0: 69 67 2a 2a 20 69 6e 64 69 71 75 65 20 73 69 20  ig** indique si 
1300: 6c 27 65 78 74 65 6e 73 69 6f 6e 20 70 6f 73 73  l'extension poss
1310: c3 a8 64 65 20 75 6e 65 20 63 6f 6e 66 69 67 75  ..de une configu
1320: 72 61 74 69 6f 6e 20 6d 6f 64 69 66 69 61 62 6c  ration modifiabl
1330: 65 20 70 61 72 20 6c 27 75 74 69 6c 69 73 61 74  e par l'utilisat
1340: 65 75 72 2e 20 53 69 20 70 6f 73 69 74 69 6f 6e  eur. Si position
1350: 6e c3 a9 20 c3 a0 20 31 20 28 6f 75 20 60 74 72  n.. .. 1 (ou `tr
1360: 75 65 60 29 20 61 6c 6f 72 73 20 6c 61 20 70 61  ue`) alors la pa
1370: 67 65 20 64 65 20 67 65 73 74 69 6f 6e 20 64 65  ge de gestion de
1380: 73 20 65 78 74 65 6e 73 69 6f 6e 73 20 70 72 6f  s extensions pro
1390: 70 6f 73 65 72 61 20 75 6e 20 6c 69 65 6e 20 70  posera un lien p
13a0: 6f 75 72 20 63 6f 6e 66 69 67 75 72 65 72 20 6c  our configurer l
13b0: 27 65 78 74 65 6e 73 69 6f 6e 20 28 61 70 70 65  'extension (appe
13c0: 6c 61 6e 74 20 6c 65 20 66 69 63 68 69 65 72 20  lant le fichier 
13d0: 60 77 77 77 2f 61 64 6d 69 6e 2f 63 6f 6e 66 69  `www/admin/confi
13e0: 67 2e 70 68 70 60 29 2c 20 65 74 20 6c 65 20 66  g.php`), et le f
13f0: 69 63 68 69 65 72 20 60 63 6f 6e 66 69 67 2e 6a  ichier `config.j
1400: 73 6f 6e 60 20 73 65 72 61 20 69 6d 70 6f 72 74  son` sera import
1410: c3 a9 20 63 6f 6d 6d 65 20 63 6f 6e 66 69 67 75  .. comme configu
1420: 72 61 74 69 6f 6e 20 70 61 72 20 64 c3 a9 66 61  ration par d..fa
1430: 75 74 2e 20 43 65 73 20 64 65 75 78 20 66 69 63  ut. Ces deux fic
1440: 68 69 65 72 73 20 73 6f 6e 74 20 64 6f 6e 63 20  hiers sont donc 
1450: 6f 62 6c 69 67 61 74 6f 69 72 65 73 20 73 69 20  obligatoires si 
1460: 2a 2a 63 6f 6e 66 69 67 2a 2a 20 65 73 74 20 61  **config** est a
1470: 63 74 69 76 c3 a9 2e 0d 0a 2a 20 2a 2a 6d 69 6e  ctiv.....* **min
1480: 5f 76 65 72 73 69 6f 6e 2a 2a 20 65 73 74 20 66  _version** est f
1490: 61 63 75 6c 74 61 74 69 66 20 65 74 20 70 65 75  acultatif et peu
14a0: 74 20 63 6f 6d 70 6f 72 74 65 72 20 6c 65 20 6e  t comporter le n
14b0: 75 6d c3 a9 72 6f 20 64 65 20 76 65 72 73 69 6f  um..ro de versio
14c0: 6e 20 64 65 20 47 61 72 72 61 64 69 6e 20 6d 69  n de Garradin mi
14d0: 6e 69 6d 61 6c 20 6e c3 a9 63 65 73 73 61 69 72  nimal n..cessair
14e0: 65 20 c3 a0 20 6c 27 69 6e 73 74 61 6c 6c 61 74  e .. l'installat
14f0: 69 6f 6e 20 64 75 20 70 6c 75 67 69 6e 2e 20 50  ion du plugin. P
1500: 61 72 20 65 78 65 6d 70 6c 65 20 73 69 20 6f 6e  ar exemple si on
1510: 20 72 65 6e 73 65 69 67 6e 65 20 60 22 30 2e 38   renseigne `"0.8
1520: 2e 30 22 60 20 65 74 20 71 75 65 20 6c 61 20 76  .0"` et que la v
1530: 65 72 73 69 6f 6e 20 69 6e 73 74 61 6c 6c c3 a9  ersion install..
1540: 20 64 65 20 47 61 72 72 61 64 69 6e 20 65 73 74   de Garradin est
1550: 20 6c 61 20 30 2e 37 2e 31 2c 20 6c 65 20 70 6c   la 0.7.1, le pl
1560: 75 67 69 6e 20 72 65 66 75 73 65 72 61 20 64 65  ugin refusera de
1570: 20 73 27 69 6e 73 74 61 6c 6c 65 72 2e 0d 0a 0d   s'installer....
1580: 0a 41 74 74 65 6e 74 69 6f 6e 2c 20 73 69 20 6c  .Attention, si l
1590: 65 20 66 69 63 68 69 65 72 20 60 67 61 72 72 61  e fichier `garra
15a0: 64 69 6e 5f 70 6c 75 67 69 6e 2e 69 6e 69 60 20  din_plugin.ini` 
15b0: 6e 27 65 78 69 73 74 65 20 70 61 73 20 64 61 6e  n'existe pas dan
15c0: 73 20 6c 65 20 70 6c 75 67 69 6e 20 69 6c 20 6e  s le plugin il n
15d0: 65 20 70 6f 75 72 72 61 20 70 61 73 20 c3 aa 74  e pourra pas ..t
15e0: 72 65 20 69 6e 73 74 61 6c 6c c3 a9 65 2c 20 6e  re install..e, n
15f0: 27 c3 a9 74 61 6e 74 20 70 61 73 20 63 6f 6e 73  '..tant pas cons
1600: 69 64 c3 a9 72 c3 a9 65 20 63 6f 6d 6d 65 20 75  id..r..e comme u
1610: 6e 20 70 6c 75 67 69 6e 20 64 65 20 47 61 72 72  n plugin de Garr
1620: 61 64 69 6e 2e 0d 0a 0d 0a 23 23 23 20 43 6f 6e  adin.....### Con
1630: 66 69 67 75 72 61 74 69 6f 6e 20 64 75 20 70 6c  figuration du pl
1640: 75 67 69 6e 0d 0a 0d 0a 53 69 20 2a 63 6f 6e 66  ugin....Si *conf
1650: 69 67 2a 20 65 73 74 20 70 6f 73 69 74 69 6f 6e  ig* est position
1660: 6e c3 a9 20 c3 a0 20 31 20 6f 75 20 74 72 75 65  n.. .. 1 ou true
1670: 20 28 6f 75 20 6d c3 aa 6d 65 20 2a 4f 6e 2a 29   (ou m..me *On*)
1680: 20 64 61 6e 73 20 60 67 61 72 72 61 64 69 6e 5f   dans `garradin_
1690: 70 6c 75 67 69 6e 2e 69 6e 69 60 20 6c 61 20 63  plugin.ini` la c
16a0: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 75 20  onfiguration au 
16b0: 66 6f 72 6d 61 74 20 4a 53 4f 4e 20 73 74 6f 63  format JSON stoc
16c0: 6b c3 a9 65 20 64 61 6e 73 20 2a 2a 63 6f 6e 66  k..e dans **conf
16d0: 69 67 2e 6a 73 6f 6e 2a 2a 20 73 65 72 61 20 69  ig.json** sera i
16e0: 6d 70 6f 72 74 c3 a9 65 20 63 6f 6d 6d 65 20 63  mport..e comme c
16f0: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 70 61 72  onfiguration par
1700: 20 64 c3 a9 66 61 75 74 20 64 75 20 70 6c 75 67   d..faut du plug
1710: 69 6e 2e 0d 0a 0d 0a 41 74 74 65 6e 74 69 6f 6e  in.....Attention
1720: 20 6c 65 73 20 6f 62 6a 65 74 73 20 6a 61 76 61   les objets java
1730: 73 63 72 69 70 74 20 73 6f 6e 74 20 74 72 61 6e  script sont tran
1740: 73 66 6f 72 6d c3 a9 73 20 65 6e 20 74 61 62 6c  sform..s en tabl
1750: 65 61 75 78 20 c3 a0 20 6c 27 69 6d 70 6f 72 74  eaux .. l'import
1760: 2c 20 69 6c 20 6e 27 65 73 74 20 64 6f 6e 63 20  , il n'est donc 
1770: 70 61 73 20 70 6f 73 73 69 62 6c 65 20 64 65 20  pas possible de 
1780: 73 74 6f 63 6b 65 72 20 75 6e 20 6f 62 6a 65 74  stocker un objet
1790: 20 64 79 6e 61 6d 69 71 75 65 20 64 61 6e 73 20   dynamique dans 
17a0: 6c 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e  la configuration
17b0: 2e 0d 0a 0d 0a 4c 65 20 70 6c 75 67 69 6e 20 70  .....Le plugin p
17c0: 65 75 74 20 65 6e 73 75 69 74 65 20 6c 69 72 65  eut ensuite lire
17d0: 20 73 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f   sa configuratio
17e0: 6e 20 64 65 70 75 69 73 20 73 6f 6e 20 63 6f 64  n depuis son cod
17f0: 65 2c 20 61 76 65 63 20 60 24 70 6c 75 67 69 6e  e, avec `$plugin
1800: 2d 3e 67 65 74 43 6f 6e 66 69 67 28 73 74 72 69  ->getConfig(stri
1810: 6e 67 20 24 6b 65 79 29 60 2c 20 65 74 20 63 68  ng $key)`, et ch
1820: 61 6e 67 65 72 20 73 65 73 20 69 6e 66 6f 73 20  anger ses infos 
1830: 65 6e 20 66 61 69 73 61 6e 74 20 60 24 70 6c 75  en faisant `$plu
1840: 67 69 6e 2d 3e 73 65 74 43 6f 6e 66 69 67 28 73  gin->setConfig(s
1850: 74 72 69 6e 67 20 24 6b 65 79 2c 20 73 74 72 69  tring $key, stri
1860: 6e 67 20 24 76 61 6c 75 65 29 60 2e 0d 0a 0d 0a  ng $value)`.....
1870: 23 23 23 20 53 63 72 69 70 74 73 20 6d 61 67 69  ### Scripts magi
1880: 71 75 65 73 0d 0a 0d 0a 43 68 61 71 75 65 20 61  ques....Chaque a
1890: 72 63 68 69 76 65 20 70 65 75 74 20 63 6f 6d 70  rchive peut comp
18a0: 6f 72 74 65 72 20 63 65 72 74 61 69 6e 73 20 2a  orter certains *
18b0: 73 63 72 69 70 74 73 20 6d 61 67 69 71 75 65 73  scripts magiques
18c0: 2a 20 71 75 69 20 73 65 72 6f 6e 74 20 61 70 70  * qui seront app
18d0: 65 6c c3 a9 73 20 61 75 74 6f 6d 61 74 69 71 75  el..s automatiqu
18e0: 65 6d 65 6e 74 20 70 61 72 20 47 61 72 72 61 64  ement par Garrad
18f0: 69 6e 20 6c 6f 72 73 20 64 65 20 63 65 72 74 61  in lors de certa
1900: 69 6e 73 20 c3 a9 76 c3 a9 6e 65 6d 65 6e 74 73  ins ..v..nements
1910: 2e 0d 0a 0d 0a 2a 20 2a 2a 69 6e 73 74 61 6c 6c  .....* **install
1920: 2e 70 68 70 2a 2a 20 65 73 74 20 61 70 70 65 6c  .php** est appel
1930: c3 a9 20 71 75 61 6e 64 20 6c 65 20 70 6c 75 67  .. quand le plug
1940: 69 6e 20 61 20 c3 a9 74 c3 a9 20 74 c3 a9 6c c3  in a ..t.. t..l.
1950: a9 63 68 61 72 67 c3 a9 20 65 74 20 71 75 27 69  .charg.. et qu'i
1960: 6c 20 65 73 74 20 64 c3 a9 6a c3 a0 20 6e 6f 74  l est d..j.. not
1970: c3 a9 20 63 6f 6d 6d 65 20 69 6e 73 74 61 6c 6c  .. comme install
1980: c3 a9 20 28 70 6f 73 74 2d 69 6e 73 74 61 6c 6c  .. (post-install
1990: 61 74 69 6f 6e 29 2c 20 75 74 69 6c 65 20 6e 6f  ation), utile no
19a0: 74 61 6d 6d 65 6e 74 20 70 6f 75 72 20 63 72 c3  tamment pour cr.
19b0: a9 65 72 20 75 6e 65 20 74 61 62 6c 65 20 64 61  .er une table da
19c0: 6e 73 20 6c 61 20 62 61 73 65 20 64 65 20 64 6f  ns la base de do
19d0: 6e 6e c3 a9 65 73 0d 0a 2a 20 2a 2a 75 70 67 72  nn..es..* **upgr
19e0: 61 64 65 2e 70 68 70 2a 2a 20 3a 20 71 75 61 6e  ade.php** : quan
19f0: 64 20 6c 61 20 76 65 72 73 69 6f 6e 20 64 65 20  d la version de 
1a00: 6c 27 61 72 63 68 69 76 65 20 28 6e 6f 74 c3 a9  l'archive (not..
1a10: 65 20 64 61 6e 73 20 67 61 72 72 61 64 69 6e 5f  e dans garradin_
1a20: 70 6c 75 67 69 6e 2e 69 6e 69 29 20 6e 65 20 63  plugin.ini) ne c
1a30: 6f 72 72 65 73 70 6f 6e 64 20 70 61 73 20 c3 a0  orrespond pas ..
1a40: 20 6c 61 20 76 65 72 73 69 6f 6e 20 65 6e 72 65   la version enre
1a50: 67 69 73 74 72 c3 a9 65 20 65 6e 20 62 61 73 65  gistr..e en base
1a60: 20 64 65 20 64 6f 6e 6e c3 a9 65 0d 0a 2a 20 2a   de donn..e..* *
1a70: 2a 75 6e 69 6e 73 74 61 6c 6c 2e 70 68 70 2a 2a  *uninstall.php**
1a80: 20 3a 20 6a 75 73 74 65 20 61 76 61 6e 74 20 71   : juste avant q
1a90: 75 65 20 6c 65 20 70 6c 75 67 69 6e 20 6e 65 20  ue le plugin ne 
1aa0: 73 6f 69 74 20 73 75 70 70 72 69 6d c3 a9 2c 20  soit supprim.., 
1ab0: 75 74 69 6c 65 20 70 61 72 20 65 78 65 6d 70 6c  utile par exempl
1ac0: 65 20 70 6f 75 72 20 73 75 70 70 72 69 6d 65 72  e pour supprimer
1ad0: 20 75 6e 65 20 74 61 62 6c 65 20 63 72 c3 a9 c3   une table cr...
1ae0: a9 65 20 64 61 6e 73 20 6c 61 20 62 61 73 65 20  .e dans la base 
1af0: 64 65 20 64 6f 6e 6e c3 a9 65 73 0d 0a 2a 20 2a  de donn..es..* *
1b00: 2a 73 69 67 6e 61 6c 73 2e 70 68 70 2a 2a 20 3a  *signals.php** :
1b10: 20 69 6e 63 6c 75 73 20 71 75 61 6e 64 20 75 6e   inclus quand un
1b20: 20 73 69 67 6e 61 6c 20 65 6e 72 65 67 69 73 74   signal enregist
1b30: 72 c3 a9 20 65 73 74 20 61 70 70 65 6c c3 a9 0d  r.. est appel...
1b40: 0a 0d 0a 43 65 73 20 73 63 72 69 70 74 73 20 6e  ...Ces scripts n
1b50: 65 20 70 65 75 76 65 6e 74 20 70 61 73 20 c3 aa  e peuvent pas ..
1b60: 74 72 65 20 61 70 70 65 6c c3 a9 73 20 70 61 72  tre appel..s par
1b70: 20 75 6e 65 20 72 65 71 75 c3 aa 74 65 20 48 54   une requ..te HT
1b80: 54 50 20 76 69 61 20 6c 27 69 6e 74 65 72 66 61  TP via l'interfa
1b90: 63 65 20 70 72 69 76 c3 a9 65 20 6f 75 20 70 75  ce priv..e ou pu
1ba0: 62 6c 69 71 75 65 2e 0d 0a 0d 0a 23 23 23 20 4f  blique.....### O
1bb0: 62 6a 65 74 20 47 61 72 72 61 64 69 6e 5c 50 6c  bjet Garradin\Pl
1bc0: 75 67 69 6e 0d 0a 0d 0a 2a 20 60 5f 5f 63 6f 6e  ugin....* `__con
1bd0: 73 74 72 75 63 74 28 73 74 72 69 6e 67 20 24 69  struct(string $i
1be0: 64 29 60 0d 0a 2a 20 60 73 65 74 43 6f 6e 66 69  d)`..* `setConfi
1bf0: 67 28 73 74 72 69 6e 67 20 24 6b 65 79 2c 20 73  g(string $key, s
1c00: 74 72 69 6e 67 20 24 76 61 6c 75 65 29 60 20 3a  tring $value)` :
1c10: 20 65 6e 72 65 67 69 73 74 72 65 20 6c 61 20 63   enregistre la c
1c20: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 75 20  onfiguration du 
1c30: 70 6c 75 67 69 6e 2c 20 73 69 20 24 76 61 6c 75  plugin, si $valu
1c40: 65 20 65 73 74 20 6e 75 6c 6c 20 61 6c 6f 72 73  e est null alors
1c50: 20 74 74 65 20 63 6c c3 a9 20 65 73 74 20 65 66   tte cl.. est ef
1c60: 66 61 63 c3 a9 65 20 64 65 20 6c 61 20 63 6f 6e  fac..e de la con
1c70: 66 69 67 75 72 61 74 69 6f 6e 0d 0a 2a 20 60 67  figuration..* `g
1c80: 65 74 43 6f 6e 66 69 67 28 73 74 72 69 6e 67 20  etConfig(string 
1c90: 24 6b 65 79 29 60 20 3a 20 72 c3 a9 63 75 70 c3  $key)` : r..cup.
1ca0: a8 72 65 20 6c 61 20 76 61 6c 65 75 72 20 64 65  .re la valeur de
1cb0: 20 6c 61 20 63 6c c3 a9 20 24 6b 65 79 20 70 6f   la cl.. $key po
1cc0: 75 72 20 6c 61 20 63 6f 6e 66 69 67 75 72 61 74  ur la configurat
1cd0: 69 6f 6e 20 64 75 20 70 6c 75 67 69 6e 0d 0a 2a  ion du plugin..*
1ce0: 20 60 67 65 74 49 6e 66 6f 73 28 29 60 20 3a 20   `getInfos()` : 
1cf0: 72 65 6e 76 6f 69 65 20 6c 65 73 20 69 6e 66 6f  renvoie les info
1d00: 72 6d 61 74 69 6f 6e 73 20 65 6e 72 65 67 69 73  rmations enregis
1d10: 74 72 c3 a9 65 73 20 73 75 72 20 6c 65 20 70 6c  tr..es sur le pl
1d20: 75 67 69 6e 0d 0a 2a 20 60 75 70 67 72 61 64 65  ugin..* `upgrade
1d30: 28 29 60 20 3a 20 6d 69 73 65 20 c3 a0 20 6a 6f  ()` : mise .. jo
1d40: 75 72 20 64 75 20 70 6c 75 67 69 6e 0d 0a 2a 20  ur du plugin..* 
1d50: 60 6e 65 65 64 73 55 70 67 72 61 64 65 28 29 60  `needsUpgrade()`
1d60: 20 3a 20 6c 65 20 70 6c 75 67 69 6e 20 64 6f 69   : le plugin doi
1d70: 74 2d 69 6c 20 c3 aa 74 72 65 20 6d 69 73 20 c3  t-il ..tre mis .
1d80: a0 20 6a 6f 75 72 20 3f 0d 0a 2a 20 60 75 6e 69  . jour ?..* `uni
1d90: 6e 73 74 61 6c 6c 28 29 60 20 3a 20 64 c3 a9 73  nstall()` : d..s
1da0: 69 6e 73 74 61 6c 6c 65 72 20 6c 65 20 70 6c 75  installer le plu
1db0: 67 69 6e 0d 0a 2a 20 60 69 64 28 29 60 20 3a 20  gin..* `id()` : 
1dc0: 72 65 6e 76 6f 69 65 20 6c 27 69 64 65 6e 74 69  renvoie l'identi
1dd0: 66 69 61 6e 74 20 64 75 20 70 6c 75 67 69 6e 0d  fiant du plugin.
1de0: 0a 2a 20 60 70 61 74 68 28 29 60 20 3a 20 72 65  .* `path()` : re
1df0: 6e 76 6f 69 65 20 6c 65 20 63 68 65 6d 69 6e 20  nvoie le chemin 
1e00: 76 65 72 73 20 6c 27 61 72 63 68 69 76 65 20 64  vers l'archive d
1e10: 75 20 70 6c 75 67 69 6e 0d 0a 2a 20 60 72 65 67  u plugin..* `reg
1e20: 69 73 74 65 72 53 69 67 6e 61 6c 28 73 74 72 69  isterSignal(stri
1e30: 6e 67 20 24 73 69 67 6e 61 6c 2c 20 73 74 72 69  ng $signal, stri
1e40: 6e 67 20 24 63 61 6c 6c 62 61 63 6b 29 60 20 3a  ng $callback)` :
1e50: 20 65 6e 72 65 67 69 73 74 72 65 20 75 6e 20 63   enregistre un c
1e60: 61 6c 6c 62 61 63 6b 20 61 73 73 6f 63 69 c3 a9  allback associ..
1e70: 20 c3 a0 20 75 6e 20 73 69 67 6e 61 6c 0d 0a 0d   .. un signal...
1e80: 0a 23 23 23 20 42 61 73 65 20 64 65 20 64 6f 6e  .### Base de don
1e90: 6e c3 a9 65 73 0d 0a 0d 0a 54 6f 75 73 20 6c 65  n..es....Tous le
1ea0: 73 20 70 6c 75 67 69 6e 73 20 6f 6e 74 20 75 6e  s plugins ont un
1eb0: 20 61 63 63 c3 a8 73 20 69 6c 6c 69 6d 69 74 c3   acc..s illimit.
1ec0: a9 20 c3 a0 20 6c 61 20 62 61 73 65 20 64 65 20  . .. la base de 
1ed0: 64 6f 6e 6e c3 a9 65 73 20 70 72 69 6e 63 69 70  donn..es princip
1ee0: 61 6c 65 20 64 65 20 47 61 72 72 61 64 69 6e 2e  ale de Garradin.
1ef0: 20 43 65 70 65 6e 64 61 6e 74 20 69 6c 20 65 73   Cependant il es
1f00: 74 20 69 6e 74 65 72 64 69 74 20 64 27 61 6a 6f  t interdit d'ajo
1f10: 75 74 65 72 2c 20 6d 6f 64 69 66 69 65 72 20 6f  uter, modifier o
1f20: 75 20 73 75 70 70 72 69 6d 65 72 20 64 65 73 20  u supprimer des 
1f30: 64 6f 6e 6e c3 a9 65 73 20 64 69 72 65 63 74 65  donn..es directe
1f40: 6d 65 6e 74 20 64 61 6e 73 20 6c 65 73 20 74 61  ment dans les ta
1f50: 62 6c 65 73 20 64 65 20 63 65 74 74 65 20 42 44  bles de cette BD
1f60: 44 20 61 66 69 6e 20 64 65 20 6e 65 20 70 61 73  D afin de ne pas
1f70: 20 63 6f 6d 70 72 6f 6d 65 74 74 72 65 20 6c 27   compromettre l'
1f80: 69 6e 74 c3 a9 67 72 69 74 c3 a9 20 64 65 73 20  int..grit.. des 
1f90: 64 6f 6e 6e c3 a9 65 73 2e 20 50 6f 75 72 20 6d  donn..es. Pour m
1fa0: 6f 64 69 66 69 65 72 20 63 65 73 20 64 6f 6e 6e  odifier ces donn
1fb0: c3 a9 65 73 20 69 6c 20 66 61 75 74 20 75 74 69  ..es il faut uti
1fc0: 6c 69 73 65 72 20 6c 65 73 20 6d c3 a9 74 68 6f  liser les m..tho
1fd0: 64 65 73 20 64 65 20 47 61 72 72 61 64 69 6e 2e  des de Garradin.
1fe0: 0d 0a 0d 0a 43 68 61 71 75 65 20 70 6c 75 67 69  ....Chaque plugi
1ff0: 6e 20 70 65 75 74 20 63 72 c3 a9 65 72 20 75 6e  n peut cr..er un
2000: 65 20 6f 75 20 70 6c 75 73 69 65 75 72 73 20 74  e ou plusieurs t
2010: 61 62 6c 65 73 20 64 61 6e 73 20 63 65 74 74 65  ables dans cette
2020: 20 42 44 44 2c 20 65 6c 6c 65 73 20 64 65 76 72   BDD, elles devr
2030: 6f 6e 74 20 70 61 72 20 63 6f 6e 74 72 65 20 c3  ont par contre .
2040: aa 74 72 65 20 73 75 70 70 72 69 6d c3 a9 65 73  .tre supprim..es
2050: 20 c3 a0 20 6c 61 20 64 c3 a9 73 69 6e 73 74 61   .. la d..sinsta
2060: 6c 6c 61 74 69 6f 6e 2e 20 44 61 6e 73 20 63 65  llation. Dans ce
2070: 20 63 61 73 20 75 6e 20 70 6c 75 67 69 6e 20 70   cas un plugin p
2080: 65 75 74 20 6d 6f 64 69 66 69 65 72 20 64 69 72  eut modifier dir
2090: 65 63 74 65 6d 65 6e 74 20 73 65 73 20 74 61 62  ectement ses tab
20a0: 6c 65 73 2e 0d 0a 0d 0a 23 23 23 20 46 69 63 68  les.....### Fich
20b0: 69 65 72 73 0d 0a 0d 0a 4c 65 73 20 70 6c 75 67  iers....Les plug
20c0: 69 6e 73 20 6e 65 20 64 65 76 72 61 69 65 6e 74  ins ne devraient
20d0: 20 70 61 73 20 63 72 c3 a9 65 72 2c 20 6d 6f 64   pas cr..er, mod
20e0: 69 66 69 65 72 20 6f 75 20 73 75 70 70 72 69 6d  ifier ou supprim
20f0: 65 72 20 64 65 20 66 69 63 68 69 65 72 73 20 64  er de fichiers d
2100: 61 6e 73 20 6c 27 61 72 62 6f 72 65 73 63 65 6e  ans l'arborescen
2110: 63 65 20 64 65 20 47 61 72 72 61 64 69 6e 2e 0d  ce de Garradin..
2120: 0a 0d 0a 4c 65 73 20 73 65 75 6c 73 20 66 69 63  ...Les seuls fic
2130: 68 69 65 72 73 20 71 75 27 75 6e 20 70 6c 75 67  hiers qu'un plug
2140: 69 6e 20 64 65 76 72 61 69 74 20 6d 6f 64 69 66  in devrait modif
2150: 69 65 72 20 73 6f 6e 74 20 3a 0d 0a 0d 0a 2a 20  ier sont :....* 
2160: 64 75 20 63 61 63 68 65 20 3a 20 75 74 69 6c 69  du cache : utili
2170: 73 65 72 20 64 65 20 70 72 c3 a9 66 c3 a9 72 65  ser de pr..f..re
2180: 6e 63 65 20 6c 27 6f 62 6a 65 74 20 53 74 61 74  nce l'objet Stat
2190: 69 63 5f 43 61 63 68 65 20 64 65 20 47 61 72 72  ic_Cache de Garr
21a0: 61 64 69 6e 2c 20 6f 75 20 66 61 69 72 65 20 61  adin, ou faire a
21b0: 74 74 65 6e 74 69 6f 6e 20 61 75 78 20 63 6f 6c  ttention aux col
21c0: 6c 69 73 69 6f 6e 73 20 64 65 20 6e 6f 6d 73 20  lisions de noms 
21d0: 3b 0d 0a 2a 20 64 65 73 20 70 61 67 65 73 20 77  ;..* des pages w
21e0: 65 62 20 64 75 20 73 69 74 65 20 70 75 62 6c 69  eb du site publi
21f0: 63 20 64 61 6e 73 20 60 77 77 77 2f 60 0d 0a 0d  c dans `www/`...
2200: 0a 50 6f 75 72 20 65 6e 72 65 67 69 73 74 72 65  .Pour enregistre
2210: 72 20 65 74 20 72 c3 a9 63 75 70 c3 a9 72 65 72  r et r..cup..rer
2220: 20 64 65 73 20 64 6f 63 75 6d 65 6e 74 73 20 69   des documents i
2230: 6c 20 66 61 75 74 20 75 74 69 6c 69 73 65 72 20  l faut utiliser 
2240: 6c 65 73 20 6d c3 a9 74 68 6f 64 65 73 20 64 65  les m..thodes de
2250: 20 73 74 6f 63 6b 61 67 65 20 64 65 20 66 69 63   stockage de fic
2260: 68 69 65 72 73 20 66 6f 75 72 6e 69 65 73 20 70  hiers fournies p
2270: 61 72 20 47 61 72 72 61 64 69 6e 2e 0d 0a 0d 0a  ar Garradin.....
2280: 23 23 23 20 53 69 67 6e 61 75 78 0d 0a 0d 0a 4c  ### Signaux....L
2290: 65 73 20 70 6c 75 67 69 6e 73 20 70 65 75 76 65  es plugins peuve
22a0: 6e 74 20 73 65 20 c2 ab 20 62 72 61 6e 63 68 65  nt se .. branche
22b0: 72 20 c2 bb 20 73 75 72 20 64 65 73 20 73 69 67  r .. sur des sig
22c0: 6e 61 75 78 20 c3 a9 6d 69 73 20 70 61 72 20 47  naux ..mis par G
22d0: 61 72 72 61 64 69 6e 20 6c 6f 72 73 20 64 65 20  arradin lors de 
22e0: 63 65 72 74 61 69 6e 65 73 20 61 63 74 69 6f 6e  certaines action
22f0: 73 2e 0d 0a 0d 0a 4c 65 73 20 73 69 67 6e 61 75  s.....Les signau
2300: 78 20 61 63 63 65 73 73 69 62 6c 65 73 20 73 6f  x accessibles so
2310: 6e 74 20 3a 0d 0a 0d 0a 2a 20 60 6d 65 6d 62 72  nt :....* `membr
2320: 65 2e 6e 6f 75 76 65 61 75 60 2c 20 61 70 70 65  e.nouveau`, appe
2330: 6c c3 a9 20 6a 75 73 74 65 20 61 70 72 c3 a8 73  l.. juste apr..s
2340: 20 6c 27 69 6e 73 65 72 74 69 6f 6e 20 64 75 20   l'insertion du 
2350: 6d 65 6d 62 72 65 20 64 61 6e 73 20 6c 61 20 62  membre dans la b
2360: 61 73 65 20 64 65 20 64 6f 6e 6e c3 a9 65 73 0d  ase de donn..es.
2370: 0a 2a 20 60 6d 65 6d 62 72 65 2e 73 75 70 70 72  .* `membre.suppr
2380: 65 73 73 69 6f 6e 60 2c 20 61 70 70 65 6c c3 a9  ession`, appel..
2390: 20 6a 75 73 74 65 20 61 76 61 6e 74 20 6c 61 20   juste avant la 
23a0: 73 75 70 70 72 65 73 73 69 6f 6e 20 64 27 75 6e  suppression d'un
23b0: 20 6f 75 20 70 6c 75 73 69 65 75 72 73 20 6d 65   ou plusieurs me
23c0: 6d 62 72 65 73 20 64 65 20 6c 61 20 62 61 73 65  mbres de la base
23d0: 20 64 65 20 64 6f 6e 6e c3 a9 65 73 0d 0a 2a 20   de donn..es..* 
23e0: 60 62 6f 75 63 6c 65 2e 54 59 50 45 5f 44 45 5f  `boucle.TYPE_DE_
23f0: 4c 41 5f 42 4f 55 43 4c 45 60 2c 20 61 70 70 65  LA_BOUCLE`, appe
2400: 6c c3 a9 20 71 75 61 6e 64 20 75 6e 65 20 62 6f  l.. quand une bo
2410: 75 63 6c 65 20 64 65 20 74 79 70 65 20 69 6e 63  ucle de type inc
2420: 6f 6e 6e 75 20 65 73 74 20 72 65 6e 63 6f 6e 74  onnu est rencont
2430: 72 c3 a9 65 20 64 61 6e 73 20 75 6e 20 73 71 75  r..e dans un squ
2440: 65 6c 65 74 74 65 0d 0a 2a 20 60 72 61 70 70 65  elette..* `rappe
2450: 6c 73 2e 61 75 74 6f 60 20 28 64 65 70 75 69 73  ls.auto` (depuis
2460: 20 30 2e 38 2e 30 29 20 61 70 70 65 6c c3 a9 20   0.8.0) appel.. 
2470: 61 70 72 c3 a8 73 20 6c 27 65 6e 76 6f 69 20 61  apr..s l'envoi a
2480: 75 74 6f 6d 61 74 69 71 75 65 20 64 65 73 20 65  utomatique des e
2490: 6d 61 69 6c 73 20 64 65 20 72 61 70 70 65 6c 0d  mails de rappel.
24a0: 0a 2a 20 60 63 6f 74 69 73 61 74 69 6f 6e 2e 61  .* `cotisation.a
24b0: 6a 6f 75 74 60 20 28 64 65 70 75 69 73 20 30 2e  jout` (depuis 0.
24c0: 38 2e 30 29 20 61 70 70 65 6c c3 a9 20 61 70 72  8.0) appel.. apr
24d0: c3 a8 73 20 6c 27 61 6a 6f 75 74 20 64 27 75 6e  ..s l'ajout d'un
24e0: 65 20 63 6f 74 69 73 61 74 69 6f 6e 20 6c 69 c3  e cotisation li.
24f0: a9 65 20 c3 a0 20 75 6e 20 6d 65 6d 62 72 65 0d  .e .. un membre.
2500: 0a 0d 0a 55 6e 20 70 6c 75 67 69 6e 20 70 65 75  ...Un plugin peu
2510: 74 20 73 65 20 63 6f 6e 6e 65 63 74 65 72 20 c3  t se connecter .
2520: a0 20 75 6e 20 73 69 67 6e 61 6c 20 6c 6f 72 73  . un signal lors
2530: 20 64 65 20 73 6f 6e 20 69 6e 73 74 61 6c 6c 61   de son installa
2540: 74 69 6f 6e 20 6f 75 20 64 65 20 73 61 20 6d 69  tion ou de sa mi
2550: 73 65 20 c3 a0 20 6a 6f 75 72 20 3a 0d 0a 0d 0a  se .. jour :....
2560: 20 20 20 20 24 70 6c 75 67 69 6e 2d 3e 72 65 67      $plugin->reg
2570: 69 73 74 65 72 53 69 67 6e 61 6c 28 27 6d 65 6d  isterSignal('mem
2580: 62 72 65 2e 6e 6f 75 76 65 61 75 27 2c 20 27 47  bre.nouveau', 'G
2590: 61 72 72 61 64 69 6e 5c 50 6c 75 67 69 6e 5c 4d  arradin\Plugin\M
25a0: 6f 6e 50 6c 75 67 69 6e 3a 3a 6e 6f 75 76 65 61  onPlugin::nouvea
25b0: 75 4d 65 6d 62 72 65 27 29 3b 0d 0a 0d 0a 4c 61  uMembre');....La
25c0: 20 6d c3 a9 74 68 6f 64 65 20 69 6e 64 69 71 75   m..thode indiqu
25d0: c3 a9 65 20 65 6e 20 73 65 63 6f 6e 64 20 70 61  ..e en second pa
25e0: 72 61 6d c3 a8 74 72 65 20 73 65 72 61 20 61 70  ram..tre sera ap
25f0: 70 65 6c c3 a9 65 20 c3 a0 20 63 68 61 71 75 65  pel..e .. chaque
2600: 20 66 6f 69 73 20 71 75 65 20 6c 65 20 73 69 67   fois que le sig
2610: 6e 61 6c 20 65 73 74 20 64 c3 a9 63 6c 65 6e 63  nal est d..clenc
2620: 68 c3 a9 2c 20 61 76 65 63 20 64 65 75 78 20 61  h.., avec deux a
2630: 72 67 75 6d 65 6e 74 73 2c 20 6c 65 20 70 72 65  rguments, le pre
2640: 6d 69 65 72 20 65 73 74 20 75 6e 20 74 61 62 6c  mier est un tabl
2650: 65 61 75 20 64 65 20 70 61 72 61 6d c3 a8 74 72  eau de param..tr
2660: 65 73 2c 20 65 74 20 6c 65 20 73 65 63 6f 6e 64  es, et le second
2670: 20 75 6e 20 74 61 62 6c 65 61 75 20 64 65 20 76   un tableau de v
2680: 61 6c 65 75 72 73 20 c3 a0 20 72 65 74 6f 75 72  aleurs .. retour
2690: 6e 65 72 20 28 75 74 69 6c 69 73 c3 a9 20 70 6f  ner (utilis.. po
26a0: 75 72 20 6c 65 73 20 62 6f 75 63 6c 65 73 29 2e  ur les boucles).
26b0: 0d 0a 0d 0a 23 23 23 20 44 61 6e 73 20 6c 65 73  ....### Dans les
26c0: 20 74 65 6d 70 6c 61 74 65 73 0d 0a 0d 0a 47 61   templates....Ga
26d0: 72 72 61 64 69 6e 20 66 6f 75 72 6e 69 74 20 6c  rradin fournit l
26e0: 61 20 6c 69 62 20 53 6d 61 72 74 79 65 72 20 70  a lib Smartyer p
26f0: 6f 75 72 20 6c 65 73 20 70 61 67 65 73 20 70 72  our les pages pr
2700: 69 76 c3 a9 65 73 20 28 72 c3 a9 70 65 72 74 6f  iv..es (r..perto
2710: 69 72 65 20 2f 61 64 6d 69 6e 2f 29 2c 20 6f c3  ire /admin/), o.
2720: b9 20 65 6c 6c 65 20 65 73 74 20 64 c3 a9 6a c3  . elle est d..j.
2730: a0 20 63 68 61 72 67 c3 a9 65 20 70 61 72 20 64  . charg..e par d
2740: c3 a9 66 61 75 74 2e 20 43 27 65 73 74 20 75 6e  ..faut. C'est un
2750: 65 20 76 65 72 73 69 6f 6e 20 61 6c 6c c3 a9 67  e version all..g
2760: c3 a9 65 20 64 75 20 6d 6f 74 65 75 72 20 64 65  ..e du moteur de
2770: 20 74 65 6d 70 6c 61 74 65 20 53 6d 61 72 74 79   template Smarty
2780: 20 32 2e 20 5b 56 6f 69 72 20 6c 61 20 64 6f 63   2. [Voir la doc
2790: 75 6d 65 6e 74 61 74 69 6f 6e 20 64 65 20 53 6d  umentation de Sm
27a0: 61 72 74 79 65 72 5d 28 68 74 74 70 3a 2f 2f 64  artyer](http://d
27b0: 65 76 2e 6b 64 32 2e 6f 72 67 2f 6b 64 32 66 77  ev.kd2.org/kd2fw
27c0: 2f 53 6d 61 72 74 79 65 72 29 0d 0a 0d 0a 41 66  /Smartyer)....Af
27d0: 66 69 63 68 65 72 20 75 6e 20 74 65 6d 70 6c 61  ficher un templa
27e0: 74 65 20 63 6f 6e 74 65 6e 75 20 64 61 6e 73 20  te contenu dans 
27f0: 6c 65 20 70 6c 75 67 69 6e 20 3a 0d 0a 0d 0a 20  le plugin :.... 
2800: 20 20 20 24 74 70 6c 2d 3e 64 69 73 70 6c 61 79     $tpl->display
2810: 28 50 4c 55 47 49 4e 5f 52 4f 4f 54 20 2e 20 27  (PLUGIN_ROOT . '
2820: 2f 74 65 6d 70 6c 61 74 65 73 2f 69 6e 64 65 78  /templates/index
2830: 2e 74 70 6c 27 29 3b 0d 0a 0d 0a 0d 0a 49 6e 63  .tpl');......Inc
2840: 6c 75 72 65 20 75 6e 20 74 65 6d 70 6c 61 74 65  lure un template
2850: 20 64 65 20 47 61 72 72 61 64 69 6e 20 64 65 70   de Garradin dep
2860: 75 69 73 20 75 6e 20 74 65 6d 70 6c 61 74 65 20  uis un template 
2870: 3a 0d 0a 0d 0a 20 20 20 20 7b 69 6e 63 6c 75 64  :....    {includ
2880: 65 20 66 69 6c 65 3d 22 61 64 6d 69 6e 2f 5f 68  e file="admin/_h
2890: 65 61 64 2e 74 70 6c 22 7d 0d 0a 0d 0a 0d 0a 49  ead.tpl"}......I
28a0: 6e 63 6c 75 72 65 20 75 6e 20 74 65 6d 70 6c 61  nclure un templa
28b0: 74 65 20 64 75 20 70 6c 75 67 69 6e 20 64 65 70  te du plugin dep
28c0: 75 69 73 20 75 6e 20 61 75 74 72 65 20 74 65 6d  uis un autre tem
28d0: 70 6c 61 74 65 20 64 75 20 70 6c 75 67 69 6e 20  plate du plugin 
28e0: 3a 0d 0a 0d 0a 20 20 20 20 7b 69 6e 63 6c 75 64  :....    {includ
28f0: 65 20 66 69 6c 65 3d 22 25 73 2f 74 65 6d 70 6c  e file="%s/templ
2900: 61 74 65 73 2f 5f 6e 61 76 2e 74 70 6c 22 7c 61  ates/_nav.tpl"|a
2910: 72 67 73 3a 24 70 6c 75 67 69 6e 5f 72 6f 6f 74  rgs:$plugin_root
2920: 7d 0d 0a 0d 0a 0d 0a 46 61 69 72 65 20 75 6e 20  }......Faire un 
2930: 6c 69 65 6e 20 76 65 72 73 20 75 6e 65 20 61 75  lien vers une au
2940: 74 72 65 20 70 61 67 65 20 64 75 20 70 6c 75 67  tre page du plug
2950: 69 6e 20 3a 0d 0a 0d 0a 20 20 20 20 3c 61 20 68  in :....    <a h
2960: 72 65 66 3d 22 7b 70 6c 75 67 69 6e 5f 75 72 6c  ref="{plugin_url
2970: 20 66 69 6c 65 3d 22 6c 69 73 74 65 2e 70 68 70   file="liste.php
2980: 22 7d 22 3e 4c 69 73 74 65 20 64 65 73 20 74 72  "}">Liste des tr
2990: 75 63 73 3c 2f 61 3e 0d 0a 0d 0a 0d 0a 49 6e 63  ucs</a>......Inc
29a0: 6c 75 72 65 20 75 6e 65 20 66 65 75 69 6c 6c 65  lure une feuille
29b0: 20 64 65 20 73 74 79 6c 65 20 43 53 53 20 73 75   de style CSS su
29c0: 70 70 6c c3 a9 6d 65 6e 74 61 69 72 65 20 73 75  ppl..mentaire su
29d0: 72 20 6c 65 73 20 70 61 67 65 73 20 64 75 20 70  r les pages du p
29e0: 6c 75 67 69 6e 20 28 63 68 65 6d 69 6e 20 72 65  lugin (chemin re
29f0: 6c 61 74 69 66 20 c3 a0 20 6c 61 20 72 61 63 69  latif .. la raci
2a00: 6e 65 20 64 75 20 70 6c 75 67 69 6e 29 20 3a 0d  ne du plugin) :.
2a10: 0a 0d 0a 20 20 20 20 24 74 70 6c 2d 3e 61 73 73  ...    $tpl->ass
2a20: 69 67 6e 28 27 70 6c 75 67 69 6e 5f 63 73 73 27  ign('plugin_css'
2a30: 2c 20 27 73 74 79 6c 65 73 2f 62 6c 65 75 2e 63  , 'styles/bleu.c
2a40: 73 73 27 29 3b 0d 0a 0d 0a 0d 0a 23 23 23 20 53  ss');......### S
2a50: 69 74 65 20 70 75 62 6c 69 63 0d 0a 0d 0a 4c 65  ite public....Le
2a60: 20 73 69 74 65 20 70 75 62 6c 69 63 20 64 65 20   site public de 
2a70: 6c 27 61 73 73 6f 63 69 61 74 69 6f 6e 20 6e 27  l'association n'
2a80: 75 74 69 6c 69 73 65 20 70 61 73 20 53 6d 61 72  utilise pas Smar
2a90: 74 79 65 72 20 6d 61 69 73 20 64 65 73 20 73 71  tyer mais des sq
2aa0: 75 65 6c 65 74 74 65 73 2c 20 71 75 69 20 73 6f  uelettes, qui so
2ab0: 6e 74 20 74 72 c3 a8 73 20 73 69 6d 69 6c 61 69  nt tr..s similai
2ac0: 72 65 73 20 61 75 78 20 73 71 75 65 6c 65 74 74  res aux squelett
2ad0: 65 73 20 75 74 69 6c 69 73 c3 a9 73 20 70 61 72  es utilis..s par
2ae0: 20 53 50 49 50 2e 0d 0a 0d 0a 55 6e 20 70 6c 75   SPIP.....Un plu
2af0: 67 69 6e 20 70 65 75 74 20 6d 6f 64 69 66 69 65  gin peut modifie
2b00: 72 20 6c 65 73 20 73 71 75 65 6c 65 74 74 65 73  r les squelettes
2b10: 20 28 64 61 6e 73 20 63 65 20 63 61 73 20 69 6c   (dans ce cas il
2b20: 20 65 73 74 20 69 6e 74 c3 a9 72 65 73 73 61 6e   est int..ressan
2b30: 74 20 64 65 20 70 72 6f 70 6f 73 65 72 20 75 6e  t de proposer un
2b40: 65 20 73 61 75 76 65 67 61 72 64 65 20 c3 a0 20  e sauvegarde .. 
2b50: 6c 27 75 74 69 6c 69 73 61 74 65 75 72 20 70 6f  l'utilisateur po
2b60: 75 72 20 6e 65 20 70 61 73 20 c3 a9 63 72 61 73  ur ne pas ..cras
2b70: 65 72 20 6c 65 73 20 6d 6f 64 69 66 73 20 71 75  er les modifs qu
2b80: 27 69 6c 20 61 20 70 75 20 66 61 69 72 65 29 2c  'il a pu faire),
2b90: 20 76 69 61 20 6c 61 20 6d c3 a9 74 68 6f 64 65   via la m..thode
2ba0: 20 60 53 71 75 65 6c 65 74 74 65 3a 3a 65 64 69   `Squelette::edi
2bb0: 74 53 6f 75 72 63 65 28 73 74 72 69 6e 67 20 24  tSource(string $
2bc0: 66 69 6c 65 2c 20 73 74 72 69 6e 67 20 24 63 6f  file, string $co
2bd0: 6e 74 65 6e 74 29 60 2e 20 4e 65 20 70 61 73 20  ntent)`. Ne pas 
2be0: 6d 6f 64 69 66 69 65 72 20 6c 65 73 20 66 69 63  modifier les fic
2bf0: 68 69 65 72 73 20 64 65 73 20 73 71 75 65 6c 65  hiers des squele
2c00: 74 74 65 73 20 64 69 72 65 63 74 65 6d 65 6e 74  ttes directement
2c10: 2c 20 6d 61 69 73 20 73 65 75 6c 65 6d 65 6e 74  , mais seulement
2c20: 20 65 6e 20 75 74 69 6c 69 73 61 6e 74 20 63 65   en utilisant ce
2c30: 74 74 65 20 6d c3 a9 74 68 6f 64 65 2e 0d 0a 0d  tte m..thode....
2c40: 0a 55 6e 20 70 6c 75 67 69 6e 20 70 65 75 74 20  .Un plugin peut 
2c50: c3 a9 67 61 6c 65 6d 65 6e 74 20 69 6d 70 6c c3  ..galement impl.
2c60: a9 6d 65 6e 74 65 72 20 64 65 20 6e 6f 75 76 65  .menter de nouve
2c70: 61 75 78 20 74 79 70 65 73 20 64 65 20 62 6f 75  aux types de bou
2c80: 63 6c 65 73 2e 20 44 61 6e 73 20 63 65 20 63 61  cles. Dans ce ca
2c90: 73 20 6c 27 69 6e 73 74 61 6c 6c 61 74 69 6f 6e  s l'installation
2ca0: 20 64 75 20 70 6c 75 67 69 6e 20 64 6f 69 74 20   du plugin doit 
2cb0: 65 6e 72 65 67 69 73 74 72 65 72 20 75 6e 20 73  enregistrer un s
2cc0: 69 67 6e 61 6c 20 64 75 20 6e 6f 6d 20 60 62 6f  ignal du nom `bo
2cd0: 75 63 6c 65 2e 4e 4f 4d 5c 5f 44 45 5c 5f 4c 41  ucle.NOM\_DE\_LA
2ce0: 5c 5f 42 4f 55 43 4c 45 60 2e 20 50 61 72 20 65  \_BOUCLE`. Par e
2cf0: 78 65 6d 70 6c 65 20 3a 20 60 24 70 6c 75 67 69  xemple : `$plugi
2d00: 6e 2d 3e 72 65 67 69 73 74 65 72 53 69 67 6e 61  n->registerSigna
2d10: 6c 28 27 62 6f 75 63 6c 65 2e 6d 65 74 65 6f 27  l('boucle.meteo'
2d20: 2c 20 27 47 61 72 72 61 64 69 6e 5c 50 6c 75 67  , 'Garradin\Plug
2d30: 69 6e 5c 4d 65 74 65 6f 5c 53 69 67 6e 61 75 78  in\Meteo\Signaux
2d40: 3a 3a 62 6f 75 63 6c 65 27 29 60 2e 20 45 6e 73  ::boucle')`. Ens
2d50: 75 69 74 65 20 71 75 61 6e 64 20 63 65 74 74 65  uite quand cette
2d60: 20 62 6f 75 63 6c 65 20 73 65 72 61 20 75 74 69   boucle sera uti
2d70: 6c 69 73 c3 a9 65 20 64 61 6e 73 20 75 6e 20 73  lis..e dans un s
2d80: 71 75 65 6c 65 74 74 65 2c 20 6c 65 20 66 69 63  quelette, le fic
2d90: 68 69 65 72 20 73 69 67 6e 61 6c 73 2e 70 68 70  hier signals.php
2da0: 20 c3 a0 20 6c 61 20 72 61 63 69 6e 65 20 64 75   .. la racine du
2db0: 20 70 6c 75 67 69 6e 20 73 65 72 61 20 69 6e 63   plugin sera inc
2dc0: 6c 75 73 20 65 74 20 6c 61 20 6d c3 a9 74 68 6f  lus et la m..tho
2dd0: 64 65 20 69 6e 64 69 71 75 c3 a9 65 20 73 65 72  de indiqu..e ser
2de0: 61 20 61 70 70 65 6c c3 a9 65 2e 20 4c 65 73 20  a appel..e. Les 
2df0: 70 61 72 61 6d c3 a8 74 72 65 73 20 73 6f 6e 74  param..tres sont
2e00: 20 66 6f 75 72 6e 69 73 20 64 61 6e 73 20 75 6e   fournis dans un
2e10: 20 74 61 62 6c 65 61 75 20 63 6f 6e 74 65 6e 61   tableau contena
2e20: 6e 74 20 3a 0d 0a 0d 0a 2a 20 6c 6f 6f 70 4e 61  nt :....* loopNa
2e30: 6d 65 20 3d 20 6c 65 20 6e 6f 6d 20 64 65 20 6c  me = le nom de l
2e40: 61 20 62 6f 75 63 6c 65 20 28 70 61 72 20 65 78  a boucle (par ex
2e50: 65 6d 70 6c 65 20 64 61 6e 73 20 60 3c 42 4f 55  emple dans `<BOU
2e60: 43 4c 45 5f 61 63 74 75 28 41 52 54 49 43 4c 45  CLE_actu(ARTICLE
2e70: 53 29 3e 60 20 63 27 65 73 74 20 2a 2a 61 63 74  S)>` c'est **act
2e80: 75 2a 2a 29 0d 0a 2a 20 6c 6f 6f 70 54 79 70 65  u**)..* loopType
2e90: 20 3d 20 6c 65 20 74 79 70 65 20 64 65 20 62 6f   = le type de bo
2ea0: 75 63 6c 65 0d 0a 2a 20 6c 6f 6f 70 43 72 69 74  ucle..* loopCrit
2eb0: 65 72 69 61 73 20 3d 20 6c 65 73 20 63 72 69 74  erias = les crit
2ec0: c3 a8 72 65 73 20 64 65 20 6c 61 20 62 6f 75 63  ..res de la bouc
2ed0: 6c 65 2c 20 73 6f 75 73 20 66 6f 72 6d 65 20 64  le, sous forme d
2ee0: 65 20 74 61 62 6c 65 61 75 2c 20 76 6f 69 72 20  e tableau, voir 
2ef0: 6c 61 20 64 6f 63 20 64 65 20 4b 44 32 5c 4d 69  la doc de KD2\Mi
2f00: 6e 69 53 6b 65 6c 20 70 6f 75 72 20 6c 65 73 20  niSkel pour les 
2f10: 64 c3 a9 74 61 69 6c 73 0d 0a 2a 20 6c 6f 6f 70  d..tails..* loop
2f20: 43 6f 6e 74 65 6e 74 20 3d 20 6c 65 20 63 6f 6e  Content = le con
2f30: 74 65 6e 75 20 64 65 20 6c 61 20 62 6f 75 63 6c  tenu de la boucl
2f40: 65 0d 0a 2a 20 70 72 65 43 6f 6e 74 65 6e 74 20  e..* preContent 
2f50: 3d 20 6c 65 20 63 6f 6e 74 65 6e 75 20 28 66 61  = le contenu (fa
2f60: 63 75 6c 74 61 74 69 66 29 20 70 72 c3 a9 2d 62  cultatif) pr..-b
2f70: 6f 75 63 6c 65 20 71 75 69 20 6e 65 20 73 65 72  oucle qui ne ser
2f80: 61 20 72 65 6e 76 6f 79 c3 a9 20 71 75 27 65 6e  a renvoy.. qu'en
2f90: 20 63 61 73 20 64 65 20 73 75 63 63 c3 a8 73 0d   cas de succ..s.
2fa0: 0a 2a 20 70 6f 73 74 43 6f 6e 74 65 6e 74 20 3d  .* postContent =
2fb0: 20 6c 65 20 63 6f 6e 74 65 6e 75 20 28 66 61 63   le contenu (fac
2fc0: 75 6c 74 61 74 69 66 29 20 70 6f 73 74 2d 62 6f  ultatif) post-bo
2fd0: 75 63 6c 65 20 71 75 69 20 6e 65 20 73 65 72 61  ucle qui ne sera
2fe0: 20 72 65 6e 76 6f 79 c3 a9 20 71 75 27 65 6e 20   renvoy.. qu'en 
2ff0: 63 61 73 20 64 65 20 73 75 63 63 c3 a8 73 0d 0a  cas de succ..s..
3000: 2a 20 61 6c 74 43 6f 6e 74 65 6e 74 20 3d 20 6c  * altContent = l
3010: 65 20 63 6f 6e 74 65 6e 75 20 28 66 61 63 75 6c  e contenu (facul
3020: 74 61 74 69 66 29 20 61 6c 74 65 72 6e 61 74 69  tatif) alternati
3030: 66 20 71 75 69 20 73 65 72 61 20 61 66 66 69 63  f qui sera affic
3040: 68 c3 a9 20 73 69 20 6c 61 20 62 6f 75 63 6c 65  h.. si la boucle
3050: 20 6e 65 20 72 65 6e 76 6f 69 65 20 72 69 65 6e   ne renvoie rien
3060: 0d 0a 0d 0a 55 6e 20 73 65 63 6f 6e 64 20 74 61  ....Un second ta
3070: 62 6c 65 61 75 20 65 73 74 20 70 61 73 73 c3 a9  bleau est pass..
3080: 20 65 6e 20 73 65 63 6f 6e 64 20 70 61 72 61 6d   en second param
3090: c3 a8 74 72 65 20 63 6f 6e 74 65 6e 61 6e 74 20  ..tre contenant 
30a0: 6c 65 73 20 63 6c c3 a9 73 20 73 75 69 76 61 6e  les cl..s suivan
30b0: 74 65 73 2c 20 71 75 69 20 73 6f 6e 74 20 64 65  tes, qui sont de
30c0: 73 20 72 c3 a9 66 c3 a9 72 65 6e 63 65 73 20 71  s r..f..rences q
30d0: 75 69 20 70 65 75 76 65 6e 74 20 c3 aa 74 72 65  ui peuvent ..tre
30e0: 20 72 65 6d 70 6c 69 65 73 20 3a 0d 0a 0d 0a 2a   remplies :....*
30f0: 20 71 75 65 72 79 20 3d 20 6c 61 20 72 65 71 75   query = la requ
3100: c3 aa 74 65 20 53 51 4c 20 c3 a0 20 65 66 66 65  ..te SQL .. effe
3110: 63 74 75 65 72 20 70 6f 75 72 20 72 65 6d 70 6c  ctuer pour rempl
3120: 69 72 20 6c 61 20 62 6f 75 63 6c 65 0d 0a 2a 20  ir la boucle..* 
3130: 71 75 65 72 79 5f 61 72 67 73 20 3d 20 6c 65 73  query_args = les
3140: 20 61 72 67 75 6d 65 6e 74 73 20 c3 a0 20 75 74   arguments .. ut
3150: 69 6c 69 73 65 72 20 70 6f 75 72 20 6c 61 20 72  iliser pour la r
3160: 65 71 75 c3 aa 74 65 20 53 51 4c 20 70 72 c3 a9  equ..te SQL pr..
3170: 70 61 72 c3 a9 65 0d 0a 2a 20 6c 6f 6f 70 5f 73  par..e..* loop_s
3180: 74 61 72 74 20 3d 20 63 6f 64 65 20 50 48 50 20  tart = code PHP 
3190: c3 a0 20 65 78 c3 a9 63 75 74 65 72 20 61 75 20  .. ex..cuter au 
31a0: 64 c3 a9 62 75 74 20 64 65 20 63 68 61 71 75 65  d..but de chaque
31b0: 20 69 74 c3 a9 72 61 74 69 6f 6e 20 64 65 20 6c   it..ration de l
31c0: 61 20 62 6f 75 63 6c 65 0d 0a 2a 20 73 74 61 74  a boucle..* stat
31d0: 65 6d 65 6e 74 5f 63 6f 64 65 20 3d 20 63 6f 64  ement_code = cod
31e0: 65 20 50 48 50 20 c3 a0 20 65 78 c3 a9 63 75 74  e PHP .. ex..cut
31f0: 65 72 20 c3 a0 20 6c 61 20 70 6c 61 63 65 20 64  er .. la place d
3200: 65 20 6c 61 20 72 65 71 75 c3 aa 74 65 20 c3 a0  e la requ..te ..
3210: 20 6c 61 20 62 61 73 65 20 64 65 20 64 6f 6e 6e   la base de donn
3220: c3 a9 65 73 20 28 64 65 70 75 69 73 20 47 61 72  ..es (depuis Gar
3230: 72 61 64 69 6e 20 30 2e 38 29 0d 0a 0d 0a 4c 61  radin 0.8)....La
3240: 20 6d 61 6e 69 c3 a8 72 65 20 6c 61 20 70 6c 75   mani..re la plu
3250: 73 20 73 69 6d 70 6c 65 20 64 27 69 6d 70 6c c3  s simple d'impl.
3260: a9 6d 65 6e 74 65 72 20 75 6e 20 6e 6f 75 76 65  .menter un nouve
3270: 61 75 20 74 79 70 65 20 64 65 20 62 6f 75 63 6c  au type de boucl
3280: 65 20 65 73 74 20 64 65 20 72 65 6d 70 6c 69 72  e est de remplir
3290: 20 6c 65 20 70 61 72 61 6d c3 a8 74 72 65 20 71   le param..tre q
32a0: 75 65 72 79 20 64 61 6e 73 20 6c 65 20 63 61 6c  uery dans le cal
32b0: 6c 62 61 63 6b 20 64 75 20 73 69 67 6e 61 6c 2e  lback du signal.
32c0: 20 45 78 65 6d 70 6c 65 20 3a 0d 0a 0d 0a 20 20   Exemple :....  
32d0: 20 20 6e 61 6d 65 73 70 61 63 65 20 47 61 72 72    namespace Garr
32e0: 61 64 69 6e 5c 50 6c 75 67 69 6e 5c 4d 65 74 65  adin\Plugin\Mete
32f0: 6f 3b 0d 0a 0d 0a 20 20 20 20 63 6c 61 73 73 20  o;....    class 
3300: 53 69 67 6e 61 75 78 0d 0a 20 20 20 20 7b 0d 0a  Signaux..    {..
3310: 20 20 20 20 20 20 20 20 73 74 61 74 69 63 20 70          static p
3320: 75 62 6c 69 63 20 66 75 6e 63 74 69 6f 6e 20 62  ublic function b
3330: 6f 75 63 6c 65 28 61 72 72 61 79 20 26 24 70 61  oucle(array &$pa
3340: 72 61 6d 73 2c 20 61 72 72 61 79 20 26 24 72 65  rams, array &$re
3350: 74 75 72 6e 29 0d 0a 20 20 20 20 20 20 20 20 7b  turn)..        {
3360: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66  ..            if
3370: 20 28 24 70 61 72 61 6d 73 5b 27 6c 6f 6f 70 54   ($params['loopT
3380: 79 70 65 27 5d 20 3d 3d 20 27 6d 65 74 65 6f 27  ype'] == 'meteo'
3390: 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b  )..            {
33a0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ..              
33b0: 20 20 24 72 65 74 75 72 6e 5b 27 71 75 65 72 79    $return['query
33c0: 27 5d 20 3d 20 27 53 45 4c 45 43 54 20 74 65 6d  '] = 'SELECT tem
33d0: 70 65 72 61 74 75 72 65 2c 20 70 6c 75 69 65 2c  perature, pluie,
33e0: 20 73 6f 6c 65 69 6c 20 46 52 4f 4d 20 6d 65 74   soleil FROM met
33f0: 65 6f 20 57 48 45 52 45 20 76 69 6c 6c 65 20 3d  eo WHERE ville =
3400: 20 3a 76 69 6c 6c 65 27 3b 0d 0a 20 20 20 20 20   :ville';..     
3410: 20 20 20 20 20 20 20 20 20 20 20 24 72 65 74 75             $retu
3420: 72 6e 5b 27 71 75 65 72 79 5f 61 72 67 73 27 5d  rn['query_args']
3430: 20 3d 20 5b 27 76 69 6c 6c 65 27 20 3d 3e 20 27   = ['ville' => '
3440: 41 75 63 6b 6c 61 6e 64 27 5d 3b 0d 0a 20 20 20  Auckland'];..   
3450: 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74               ret
3460: 75 72 6e 20 74 72 75 65 3b 0d 0a 20 20 20 20 20  urn true;..     
3470: 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20         }....    
3480: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 66          return f
3490: 61 6c 73 65 3b 0d 0a 20 20 20 20 20 20 20 20 7d  alse;..        }
34a0: 0d 0a 20 20 20 20 7d 0d 0a 0d 0a 41 69 6e 73 69  ..    }....Ainsi
34b0: 20 6c 61 20 72 65 71 75 c3 aa 74 65 20 53 51 4c   la requ..te SQL
34c0: 20 73 65 72 61 20 65 78 c3 a9 63 75 74 c3 a9 65   sera ex..cut..e
34d0: 20 64 61 6e 73 20 6c 61 20 62 61 73 65 20 53 51   dans la base SQ
34e0: 4c 69 74 65 20 64 65 20 47 61 72 72 61 64 69 6e  Lite de Garradin
34f0: 20 65 74 20 63 68 61 71 75 65 20 69 74 c3 a9 72   et chaque it..r
3500: 61 74 69 6f 6e 20 64 65 20 72 c3 a9 73 75 6c 74  ation de r..sult
3510: 61 74 20 64 6f 6e 6e 65 72 61 20 6c 69 65 75 20  at donnera lieu 
3520: c3 a0 20 6c 27 61 66 66 69 63 68 61 67 65 20 64  .. l'affichage d
3530: 65 20 24 6c 6f 6f 70 43 6f 6e 74 65 6e 74 2c 20  e $loopContent, 
3540: 64 6f 6e 74 20 6c 65 73 20 74 61 67 73 20 73 65  dont les tags se
3550: 72 6f 6e 74 20 72 65 6d 70 6c 61 63 c3 a9 73 20  ront remplac..s 
3560: 28 69 63 69 20 70 61 72 20 65 78 65 6d 70 6c 65  (ici par exemple
3570: 20 23 54 45 4d 50 45 52 41 54 55 52 45 2c 20 23   #TEMPERATURE, #
3580: 50 4c 55 49 45 20 65 74 20 23 53 4f 4c 45 49 4c  PLUIE et #SOLEIL
3590: 20 73 65 72 6f 6e 74 20 61 75 74 6f 6d 61 74 69   seront automati
35a0: 71 75 65 6d 65 6e 74 20 72 65 6d 70 6c 61 63 c3  quement remplac.
35b0: a9 73 29 2e 0d 0a 0d 0a 49 6c 20 65 73 74 20 70  .s).....Il est p
35c0: 6f 73 73 69 62 6c 65 20 61 75 73 73 69 20 64 65  ossible aussi de
35d0: 20 72 65 6d 70 6c 69 72 20 64 61 6e 73 20 63 65   remplir dans ce
35e0: 20 63 6f 6e 74 65 78 74 65 20 6c 61 20 76 61 72   contexte la var
35f0: 69 61 62 6c 65 20 24 6c 6f 6f 70 5f 73 74 61 72  iable $loop_star
3600: 74 20 61 76 65 63 20 64 75 20 63 6f 64 65 20 50  t avec du code P
3610: 48 50 2c 20 71 75 69 20 73 65 72 61 20 65 78 c3  HP, qui sera ex.
3620: a9 63 75 74 c3 a9 20 c3 a0 20 63 68 61 71 75 65  .cut.. .. chaque
3630: 20 69 74 c3 a9 72 61 74 69 6f 6e 20 64 65 20 6c   it..ration de l
3640: 61 20 62 6f 75 63 6c 65 20 61 76 61 6e 74 20 6c  a boucle avant l
3650: 27 61 66 66 69 63 68 61 67 65 2e 20 50 61 72 20  'affichage. Par 
3660: 65 78 65 6d 70 6c 65 20 6f 6e 20 70 65 75 74 20  exemple on peut 
3670: 6c 27 75 74 69 6c 69 73 65 72 20 70 6f 75 72 20  l'utiliser pour 
3680: 72 65 6d 70 6c 69 72 20 75 6e 65 20 62 61 6c 69  remplir une bali
3690: 73 65 20 3a 0d 0a 0d 0a 20 20 20 20 24 6c 6f 6f  se :....    $loo
36a0: 70 53 74 61 72 74 20 3d 20 27 24 72 6f 77 5b 5c  pStart = '$row[\
36b0: 27 69 74 65 72 61 74 69 6f 6e 5c 27 5d 20 3d 20  'iteration\'] = 
36c0: 24 69 2b 2b 3b 27 3b 0d 0a 0d 0a 55 6e 65 20 61  $i++;';....Une a
36d0: 75 74 72 65 20 73 6f 6c 75 74 69 6f 6e 20 70 6f  utre solution po
36e0: 75 72 20 66 61 69 72 65 20 75 6e 65 20 62 6f 75  ur faire une bou
36f0: 63 6c 65 20 71 75 69 20 6e 27 75 74 69 6c 69 73  cle qui n'utilis
3700: 65 20 70 61 73 20 6c 61 20 62 61 73 65 20 64 65  e pas la base de
3710: 20 64 6f 6e 6e c3 a9 65 73 20 53 51 4c 69 74 65   donn..es SQLite
3720: 20 63 27 65 73 74 20 64 65 20 63 72 c3 a9 65 72   c'est de cr..er
3730: 20 73 6f 6e 20 70 72 6f 70 72 65 20 63 6f 64 65   son propre code
3740: 20 64 65 20 62 6f 75 63 6c 65 2e 20 50 6f 75 72   de boucle. Pour
3750: 20 63 65 6c 61 20 69 6c 20 66 61 75 74 20 75 74   cela il faut ut
3760: 69 6c 69 73 65 72 20 6c 65 20 70 61 72 61 6d c3  iliser le param.
3770: a8 74 72 65 20 64 65 20 72 65 74 6f 75 72 20 60  .tre de retour `
3780: 73 74 61 74 65 6d 65 6e 74 5f 63 6f 64 65 60 2e  statement_code`.
3790: 20 55 6e 20 65 78 65 6d 70 6c 65 20 70 72 69 73   Un exemple pris
37a0: 20 64 61 6e 73 20 6c 65 20 70 6c 75 67 69 6e 20   dans le plugin 
37b0: 4f 75 76 65 72 74 75 72 65 73 20 3a 0d 0a 0d 0a  Ouvertures :....
37c0: 20 20 20 20 24 72 65 74 75 72 6e 5b 27 63 6f 64      $return['cod
37d0: 65 27 5d 20 3d 20 27 24 4f 42 4a 5f 56 41 52 20  e'] = '$OBJ_VAR 
37e0: 3d 20 6e 65 77 20 50 6c 75 67 69 6e 5c 4f 75 76  = new Plugin\Ouv
37f0: 65 72 74 75 72 65 73 5c 4f 75 76 65 72 74 75 72  ertures\Ouvertur
3800: 65 3b 27 3b 0d 0a 20 20 20 20 72 65 74 75 72 6e  e;';..    return
3810: 20 74 72 75 65 3b 0d 0a 0d 0a 44 61 6e 73 20 63   true;....Dans c
3820: 65 20 63 61 73 20 60 24 4f 42 4a 5f 56 41 52 60  e cas `$OBJ_VAR`
3830: 20 73 65 72 61 20 72 65 6d 70 6c 61 63 c3 a9 20   sera remplac.. 
3840: 64 61 6e 73 20 6c 65 20 63 6f 64 65 20 66 69 6e  dans le code fin
3850: 61 6c 20 70 61 72 20 6c 65 20 6e 6f 6d 20 64 27  al par le nom d'
3860: 75 6e 65 20 76 61 72 69 61 62 6c 65 20 75 6e 69  une variable uni
3870: 71 75 65 20 64 69 66 66 c3 a9 72 65 6e 74 65 20  que diff..rente 
3880: 70 6f 75 72 20 63 68 61 71 75 65 20 62 6f 75 63  pour chaque bouc
3890: 6c 65 20 28 63 65 63 69 20 61 66 69 6e 20 64 65  le (ceci afin de
38a0: 20 70 6f 75 76 6f 69 72 20 61 76 6f 69 72 20 64   pouvoir avoir d
38b0: 65 73 20 62 6f 75 63 6c 65 73 20 72 c3 a9 63 75  es boucles r..cu
38c0: 72 73 69 76 65 73 20 65 74 20 69 6d 62 72 69 71  rsives et imbriq
38d0: 75 c3 a9 65 73 29 2c 20 65 74 20 6c 27 6f 62 6a  u..es), et l'obj
38e0: 65 74 20 60 50 6c 75 67 69 6e 5c 4f 75 76 65 72  et `Plugin\Ouver
38f0: 74 75 72 65 73 5c 4f 75 76 65 72 74 75 72 65 73  tures\Ouvertures
3900: 60 20 66 6f 75 72 6e 69 72 61 20 64 65 75 78 20  ` fournira deux 
3910: 6d c3 a9 74 68 6f 64 65 73 3a 20 60 63 6f 75 6e  m..thodes: `coun
3920: 74 52 6f 77 73 28 29 60 20 28 72 65 6e 76 6f 69  tRows()` (renvoi
3930: 65 20 6c 65 20 6e 6f 6d 62 72 65 20 64 65 20 72  e le nombre de r
3940: c3 a9 73 75 6c 74 61 74 73 29 20 65 74 20 60 66  ..sultats) et `f
3950: 65 74 63 68 41 72 72 61 79 28 24 6d 6f 64 65 29  etchArray($mode)
3960: 60 20 64 65 76 72 61 20 72 65 6e 76 6f 79 65 72  ` devra renvoyer
3970: 20 75 6e 65 20 6c 69 67 6e 65 20 64 65 20 72 c3   une ligne de r.
3980: a9 73 75 6c 74 61 74 20 c3 a0 20 63 68 61 71 75  .sultat .. chaqu
3990: 65 20 66 6f 69 73 20 70 6f 75 72 20 6c 61 20 62  e fois pour la b
39a0: 6f 75 63 6c 65 2c 20 73 27 69 6c 20 79 20 61 20  oucle, s'il y a 
39b0: 61 75 20 6d 6f 69 6e 73 20 75 6e 20 72 c3 a9 73  au moins un r..s
39c0: 75 6c 74 61 74 2e 0d 0a 0d 0a 45 6e 66 69 6e 2c  ultat.....Enfin,
39d0: 20 75 6e 65 20 61 75 74 72 65 20 6d c3 a9 74 68   une autre m..th
39e0: 6f 64 65 20 65 73 74 20 64 65 20 72 65 6e 76 6f  ode est de renvo
39f0: 79 65 72 20 75 6e 20 60 73 74 72 69 6e 67 60 20  yer un `string` 
3a00: 63 6f 6e 74 65 6e 61 6e 74 20 64 75 20 63 6f 64  contenant du cod
3a10: 65 20 50 48 50 20 64 61 6e 73 20 6c 65 20 63 61  e PHP dans le ca
3a20: 6c 6c 62 61 63 6b 2e 20 4c 65 20 63 6f 64 65 20  llback. Le code 
3a30: 73 65 72 61 20 65 6e 72 65 67 69 73 74 72 c3 a9  sera enregistr..
3a40: 20 64 61 6e 73 20 6c 65 20 66 69 63 68 69 65 72   dans le fichier
3a50: 20 64 65 20 63 61 63 68 65 20 63 6f 6d 70 69 6c   de cache compil
3a60: c3 a9 20 65 74 20 65 78 c3 a9 63 75 74 c3 a9 2e  .. et ex..cut...
3a70: 20 43 6f 6e 73 75 6c 74 65 72 20 6c 65 20 63 6f   Consulter le co
3a80: 64 65 20 64 65 20 5c 47 61 72 72 61 64 69 6e 5c  de de \Garradin\
3a90: 53 71 75 65 6c 65 74 74 65 20 70 6f 75 72 20 65  Squelette pour e
3aa0: 6e 20 73 61 76 6f 69 72 20 70 6c 75 73 2e 0a 5a  n savoir plus..Z
3ab0: 20 64 35 63 61 63 61 66 34 33 32 35 38 36 35 66   d5cacaf4325865f
3ac0: 61 64 61 63 30 65 37 62 37 31 39 36 32 65 34 33  adac0e7b71962e43
3ad0: 61 0a                                            a.