Artifact fadf7c1a264489f6287bdf1e91759f921ba6575d:


0000: 3d 20 4c 65 73 20 70 6c 75 67 69 6e 73 20 64 61  = Les plugins da
0010: 6e 73 20 47 61 72 72 61 64 69 6e 20 3d 0a 0a 47  ns Garradin =..G
0020: 61 72 72 61 64 69 6e 20 70 65 72 6d 65 74 20 64  arradin permet d
0030: 27 c3 a9 74 65 6e 64 72 65 20 73 65 73 20 66 6f  '..tendre ses fo
0040: 6e 63 74 69 6f 6e 6e 61 6c 69 74 c3 a9 73 20 61  nctionnalit..s a
0050: 76 65 63 20 64 65 73 20 70 6c 75 67 69 6e 73 20  vec des plugins 
0060: 28 61 70 70 65 6c c3 a9 73 20 65 78 74 65 6e 73  (appel..s extens
0070: 69 6f 6e 73 20 64 61 6e 73 20 6c 61 20 70 61 72  ions dans la par
0080: 74 69 65 20 70 72 69 76 c3 a9 65 2f 61 64 6d 69  tie priv..e/admi
0090: 6e 20 64 65 20 47 61 72 72 61 64 69 6e 29 2e 0a  n de Garradin)..
00a0: 0a 4c 27 69 6e 74 65 72 66 61 63 65 20 64 65 20  .L'interface de 
00b0: 47 61 72 72 61 64 69 6e 20 65 73 74 20 73 c3 a9  Garradin est s..
00c0: 70 61 72 c3 a9 65 20 65 6e 20 64 65 75 78 20 73  par..e en deux s
00d0: 65 63 74 69 6f 6e 73 20 3a 20 6c 61 20 73 65 63  ections : la sec
00e0: 74 69 6f 6e 20 70 75 62 6c 69 71 75 65 20 63 6f  tion publique co
00f0: 72 72 65 73 70 6f 6e 64 20 61 75 20 73 69 74 65  rrespond au site
0100: 20 77 65 62 20 64 65 20 6c 27 61 73 73 6f 63 69   web de l'associ
0110: 61 74 69 6f 6e 2c 20 61 63 63 65 73 73 69 62 6c  ation, accessibl
0120: 65 20 c3 a0 20 74 6f 75 74 20 76 69 73 69 74 65  e .. tout visite
0130: 75 72 2c 20 65 74 20 6c 61 20 73 65 63 74 69 6f  ur, et la sectio
0140: 6e 20 70 72 69 76 c3 a9 65 2c 20 61 75 73 73 69  n priv..e, aussi
0150: 20 61 70 70 65 6c c3 a9 65 20 61 64 6d 69 6e 69   appel..e admini
0160: 73 74 72 61 74 69 6f 6e 20 64 65 20 6c 27 61 73  stration de l'as
0170: 73 6f 63 69 61 74 69 6f 6e 2e 20 4c 65 73 20 70  sociation. Les p
0180: 6c 75 67 69 6e 73 20 70 65 75 76 65 6e 74 20 c3  lugins peuvent .
0190: a9 74 65 6e 64 72 65 20 6c 27 75 6e 65 20 6f 75  .tendre l'une ou
01a0: 20 6c 27 61 75 74 72 65 20 70 61 72 74 69 65 2c   l'autre partie,
01b0: 20 6f 75 20 6d c3 aa 6d 65 20 6c 65 73 20 64 65   ou m..me les de
01c0: 75 78 2e 0a 0a 4c 65 73 20 70 6c 75 67 69 6e 73  ux...Les plugins
01d0: 20 70 65 75 76 65 6e 74 20 c3 aa 74 72 65 20 69   peuvent ..tre i
01e0: 6e 73 74 61 6c 6c c3 a9 73 20 64 65 20 64 65 75  nstall..s de deu
01f0: 78 20 6d 61 6e 69 c3 a8 72 65 73 20 3a 0a 23 20  x mani..res :.# 
0200: 70 61 72 20 6c 65 20 63 61 74 61 6c 6f 67 75 65  par le catalogue
0210: 20 64 65 73 20 65 78 74 65 6e 73 69 6f 6e 73 20   des extensions 
0220: 28 65 78 74 65 6e 73 69 6f 6e 73 20 6f 66 66 69  (extensions offi
0230: 63 69 65 6c 6c 65 73 29 0a 23 20 73 69 6d 70 6c  cielles).# simpl
0240: 65 6d 65 6e 74 20 65 6e 20 63 6f 70 69 61 6e 74  ement en copiant
0250: 20 6c 65 20 66 69 63 68 69 65 72 20 64 65 20 6c   le fichier de l
0260: 27 65 78 74 65 6e 73 69 6f 6e 20 64 61 6e 73 20  'extension dans 
0270: 6c 65 20 72 c3 a9 70 65 72 74 6f 69 72 65 20 22  le r..pertoire "
0280: 70 6c 75 67 69 6e 73 2f 22 20 64 65 20 47 61 72  plugins/" de Gar
0290: 72 61 64 69 6e 20 28 65 78 74 65 6e 73 69 6f 6e  radin (extension
02a0: 73 20 6e 6f 6e 2d 6f 66 66 69 63 69 65 6c 6c 65  s non-officielle
02b0: 73 29 0a 0a 0a 3d 3d 20 42 6f 6e 6e 65 73 20 70  s)...== Bonnes p
02c0: 72 61 74 69 71 75 65 73 20 3d 3d 0a 0a 4c 65 73  ratiques ==..Les
02d0: 20 70 6c 75 67 69 6e 73 20 6f 66 66 69 63 69 65   plugins officie
02e0: 6c 73 20 73 6f 6e 74 20 72 65 6c 75 73 20 65 74  ls sont relus et
02f0: 20 76 c3 a9 72 69 66 69 c3 a9 73 20 61 76 61 6e   v..rifi..s avan
0300: 74 20 70 75 62 6c 69 63 61 74 69 6f 6e 20 65 74  t publication et
0310: 20 67 61 72 61 6e 74 69 73 73 65 6e 74 20 71 75   garantissent qu
0320: 27 69 6c 73 20 6e 65 20 64 65 76 72 61 69 65 6e  'ils ne devraien
0330: 74 20 70 61 73 20 61 74 74 65 69 6e 64 72 65 20  t pas atteindre 
0340: 61 75 20 62 6f 6e 20 66 6f 6e 63 74 69 6f 6e 6e  au bon fonctionn
0350: 65 6d 65 6e 74 20 64 65 20 47 61 72 72 61 64 69  ement de Garradi
0360: 6e 20 6f 75 20 64 65 73 20 61 75 74 72 65 73 20  n ou des autres 
0370: 70 6c 75 67 69 6e 73 2e 0a 0a 50 6f 75 72 20 70  plugins...Pour p
0380: 6f 75 76 6f 69 72 20 c3 aa 74 72 65 20 69 6e 74  ouvoir ..tre int
0390: c3 a9 67 72 c3 a9 20 61 75 20 63 61 74 61 6c 6f  ..gr.. au catalo
03a0: 67 75 65 20 64 65 73 20 70 6c 75 67 69 6e 73 20  gue des plugins 
03b0: 6f 66 66 69 63 69 65 6c 73 20 69 6c 20 66 61 75  officiels il fau
03c0: 74 20 71 75 27 69 6c 20 72 65 73 70 65 63 74 65  t qu'il respecte
03d0: 20 75 6e 20 65 6e 73 65 6d 62 6c 65 20 64 65 20   un ensemble de 
03e0: 72 c3 a8 67 6c 65 73 20 c3 a9 64 69 63 74 c3 a9  r..gles ..dict..
03f0: 20 70 6c 75 73 20 62 61 73 20 3a 20 5b 5b 72 c3   plus bas : [[r.
0400: a8 67 6c 65 73 20 64 75 20 63 61 74 61 6c 6f 67  .gles du catalog
0410: 75 65 7c 23 52 c3 a8 67 6c 65 73 20 64 75 20 63  ue|#R..gles du c
0420: 61 74 61 6c 6f 67 75 65 5d 5d 2e 0a 0a 4c 65 73  atalogue]]...Les
0430: 20 70 6c 75 67 69 6e 73 20 6e 6f 6e 2d 6f 66 66   plugins non-off
0440: 69 63 69 65 6c 73 20 6e 65 20 73 6f 6e 74 20 73  iciels ne sont s
0450: 6f 75 6d 69 73 20 c3 a0 20 61 75 63 75 6e 65 20  oumis .. aucune 
0460: 72 c3 a8 67 6c 65 20 6d 61 69 73 20 69 6c 20 65  r..gle mais il e
0470: 73 74 20 71 75 61 6e 64 20 6d c3 aa 6d 65 20 72  st quand m..me r
0480: 65 63 6f 6d 6d 61 6e 64 c3 a9 20 64 65 20 73 75  ecommand.. de su
0490: 69 76 72 65 20 63 65 6c 6c 65 73 20 71 75 69 20  ivre celles qui 
04a0: 73 6f 6e 74 20 69 6e 64 69 71 75 c3 a9 65 73 20  sont indiqu..es 
04b0: 69 63 69 2e 0a 0a 3d 3d 3d 20 52 c3 a8 67 6c 65  ici...=== R..gle
04c0: 73 20 64 75 20 63 61 74 61 6c 6f 67 75 65 20 3d  s du catalogue =
04d0: 3d 3d 0a 0a 50 6f 75 72 20 69 6e 74 c3 a9 67 72  ==..Pour int..gr
04e0: 65 72 20 6c 65 20 63 61 74 61 6c 6f 67 75 65 20  er le catalogue 
04f0: 64 65 73 20 70 6c 75 67 69 6e 73 20 6f 66 66 69  des plugins offi
0500: 63 69 65 6c 73 20 64 69 73 70 6f 6e 69 62 6c 65  ciels disponible
0510: 73 20 64 69 72 65 63 74 65 6d 65 6e 74 20 64 65  s directement de
0520: 70 75 69 73 20 47 61 72 72 61 64 69 6e 20 6c 65  puis Garradin le
0530: 20 70 6c 75 67 69 6e 20 64 6f 69 74 20 3a 0a 0a   plugin doit :..
0540: 2a 20 c3 aa 74 72 65 20 73 6f 75 73 20 6c 69 63  * ..tre sous lic
0550: 65 6e 63 65 20 6c 69 62 72 65 20 28 63 6f 6d 70  ence libre (comp
0560: 61 74 69 62 6c 65 20 44 65 62 69 61 6e 20 65 74  atible Debian et
0570: 20 46 4f 53 53 20 3a 20 47 50 4c 2c 20 41 47 50   FOSS : GPL, AGP
0580: 4c 2c 20 42 53 44 2c 20 65 74 63 2e 29 20 61 66  L, BSD, etc.) af
0590: 69 6e 20 64 65 20 70 6f 75 76 6f 69 72 20 c3 aa  in de pouvoir ..
05a0: 74 72 65 20 6d 61 69 6e 74 65 6e 75 20 64 61 6e  tre maintenu dan
05b0: 73 20 6c 65 20 74 65 6d 70 73 20 70 61 72 20 6c  s le temps par l
05c0: 61 20 63 6f 6d 6d 75 6e 61 75 74 c3 a9 20 3b 0a  a communaut.. ;.
05d0: 2a 20 61 76 6f 69 72 20 75 6e 20 63 6f 64 65 20  * avoir un code 
05e0: 6c 69 73 69 62 6c 65 20 65 74 20 63 6c 61 69 72  lisible et clair
05f0: 20 28 70 65 75 20 69 6d 70 6f 72 74 65 20 6c 61   (peu importe la
0600: 20 63 6f 6e 76 65 6e 74 69 6f 6e 20 64 65 20 63   convention de c
0610: 6f 64 61 67 65 29 20 3b 0a 2a 20 6e 65 20 70 61  odage) ;.* ne pa
0620: 73 20 70 6f 72 74 65 72 20 61 74 74 65 69 6e 74  s porter atteint
0630: 65 20 c3 a0 20 6c 27 69 6e 74 c3 a9 67 72 69 74  e .. l'int..grit
0640: c3 a9 20 65 74 20 6c 61 20 73 74 61 62 69 6c 69  .. et la stabili
0650: 74 c3 a9 20 64 65 20 47 61 72 72 61 64 69 6e 2c  t.. de Garradin,
0660: 20 63 65 6c 61 20 69 6d 70 6c 69 71 75 65 20 3a   cela implique :
0670: 0a 2a 2a 20 4e 45 20 50 41 53 20 70 61 74 63 68  .** NE PAS patch
0680: 65 72 2c 20 c3 a9 64 69 74 65 72 2c 20 73 75 70  er, ..diter, sup
0690: 70 72 69 6d 65 72 20 6f 75 20 61 6a 6f 75 74 65  primer ou ajoute
06a0: 72 20 64 65 20 66 69 63 68 69 65 72 73 20 61 75  r de fichiers au
06b0: 20 63 6f 64 65 20 64 65 20 47 61 72 72 61 64 69   code de Garradi
06c0: 6e 20 6c 75 69 2d 6d c3 aa 6d 65 20 3a 20 6c 65  n lui-m..me : le
06d0: 20 70 6c 75 67 69 6e 20 64 6f 69 74 20 c3 aa 74   plugin doit ..t
06e0: 72 65 20 63 6f 6e 74 65 6e 75 20 64 61 6e 73 20  re contenu dans 
06f0: 73 6f 6e 20 61 72 63 68 69 76 65 2e 20 49 6c 20  son archive. Il 
0700: 65 73 74 20 70 61 72 20 63 6f 6e 74 72 65 20 70  est par contre p
0710: 6f 73 73 69 62 6c 65 20 64 65 20 66 61 69 72 65  ossible de faire
0720: 20 64 c3 a9 70 65 6e 64 72 65 20 75 6e 20 70 6c   d..pendre un pl
0730: 75 67 69 6e 20 64 65 20 63 6f 64 65 20 6f 75 20  ugin de code ou 
0740: 63 6f 6d 70 6f 73 61 6e 74 73 20 63 6f 6e 74 65  composants conte
0750: 6e 75 73 20 64 61 6e 73 20 75 6e 20 61 75 74 72  nus dans un autr
0760: 65 20 70 6c 75 67 69 6e 2e 0a 2a 2a 20 4e 45 20  e plugin..** NE 
0770: 50 41 53 20 73 74 6f 63 6b 65 72 20 64 65 20 64  PAS stocker de d
0780: 6f 6e 6e c3 a9 65 73 20 65 6e 20 64 65 68 6f 72  onn..es en dehor
0790: 73 20 64 65 20 6c 61 20 62 61 73 65 20 64 65 20  s de la base de 
07a0: 64 6f 6e 6e c3 a9 65 73 20 64 65 20 47 61 72 72  donn..es de Garr
07b0: 61 64 69 6e 2e 0a 2a 2a 20 4e 45 20 50 41 53 20  adin..** NE PAS 
07c0: 61 6a 6f 75 74 65 72 2c 20 6d 6f 64 69 66 69 65  ajouter, modifie
07d0: 72 20 6f 75 20 73 75 70 70 72 69 6d 65 72 20 64  r ou supprimer d
07e0: 69 72 65 63 74 65 6d 65 6e 74 20 64 65 73 20 64  irectement des d
07f0: 6f 6e 6e c3 a9 65 73 20 64 61 6e 73 20 6c 61 20  onn..es dans la 
0800: 62 61 73 65 20 64 65 20 64 6f 6e 6e c3 a9 65 73  base de donn..es
0810: 20 64 65 20 47 61 72 72 61 64 69 6e 20 28 68 6f   de Garradin (ho
0820: 72 6d 69 73 20 64 61 6e 73 20 73 61 20 70 72 6f  rmis dans sa pro
0830: 70 72 65 20 74 61 62 6c 65 29 2e 0a 2a 2a 20 4e  pre table)..** N
0840: 45 20 50 41 53 20 65 6e 72 65 67 69 73 74 72 65  E PAS enregistre
0850: 72 20 64 65 20 64 6f 63 75 6d 65 6e 74 73 20 73  r de documents s
0860: 61 6e 73 20 75 74 69 6c 69 73 65 72 20 6c 65 73  ans utiliser les
0870: 20 6d c3 a9 74 68 6f 64 65 73 20 66 6f 75 72 6e   m..thodes fourn
0880: 69 65 73 20 70 61 72 20 47 61 72 72 61 64 69 6e  ies par Garradin
0890: 2e 0a 2a 20 72 65 73 70 65 63 74 65 72 20 6c 61  ..* respecter la
08a0: 20 76 69 65 20 70 72 69 76 c3 a9 65 20 64 65 73   vie priv..e des
08b0: 20 75 74 69 6c 69 73 61 74 65 75 72 73 20 65 74   utilisateurs et
08c0: 20 6e 6f 74 61 6d 6d 65 6e 74 20 3a 0a 2a 2a 20   notamment :.** 
08d0: 4e 45 20 50 41 53 20 63 6f 6e 74 61 63 74 65 72  NE PAS contacter
08e0: 20 75 6e 20 73 65 72 76 65 75 72 20 64 69 73 74   un serveur dist
08f0: 61 6e 74 20 28 73 61 75 66 20 62 65 73 6f 69 6e  ant (sauf besoin
0900: 20 73 70 c3 a9 63 69 66 69 71 75 65 29 20 6e 69   sp..cifique) ni
0910: 20 74 72 61 6e 73 6d 65 74 74 72 65 20 64 65 73   transmettre des
0920: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 73 20 6f 75   informations ou
0930: 20 73 74 61 74 69 73 74 69 71 75 65 73 20 c3 a0   statistiques ..
0940: 20 75 6e 20 73 65 72 76 65 75 72 20 74 69 65 72   un serveur tier
0950: 73 2e 0a 0a 3d 3d 20 44 c3 a9 74 61 69 6c 73 20  s...== D..tails 
0960: 74 65 63 68 6e 69 71 75 65 73 20 3d 3d 0a 0a 3d  techniques ==..=
0970: 3d 3d 20 46 6f 72 6d 61 74 20 64 65 73 20 70 6c  == Format des pl
0980: 75 67 69 6e 73 20 3d 3d 3d 0a 0a 4c 65 73 20 70  ugins ===..Les p
0990: 6c 75 67 69 6e 73 20 73 6f 6e 74 20 64 65 73 20  lugins sont des 
09a0: 61 72 63 68 69 76 65 73 20 50 48 41 52 20 3a 20  archives PHAR : 
09b0: 74 6f 75 73 20 6c 65 73 20 66 69 63 68 69 65 72  tous les fichier
09c0: 73 20 64 75 20 70 6c 75 67 69 6e 20 28 63 6f 64  s du plugin (cod
09d0: 65 20 50 48 50 2c 20 43 53 53 2c 20 74 65 6d 70  e PHP, CSS, temp
09e0: 6c 61 74 65 73 2c 20 69 6d 61 67 65 73 2c 20 65  lates, images, e
09f0: 74 63 2e 29 20 73 6f 6e 74 20 73 74 6f 63 6b c3  tc.) sont stock.
0a00: a9 73 20 64 61 6e 73 20 6c 27 61 72 63 68 69 76  .s dans l'archiv
0a10: 65 20 65 74 20 79 20 72 65 73 74 65 6e 74 2e 0a  e et y restent..
0a20: 0a 49 6c 20 65 73 74 20 70 6f 73 73 69 62 6c 65  .Il est possible
0a30: 20 64 65 20 63 72 c3 a9 65 72 20 73 6f 69 2d 6d   de cr..er soi-m
0a40: c3 aa 6d 65 20 6c 27 61 72 63 68 69 76 65 20 50  ..me l'archive P
0a50: 48 41 52 20 64 65 20 63 65 74 74 65 20 6d 61 6e  HAR de cette man
0a60: 69 c3 a8 72 65 20 3a 0a 0a 5b 5b 5b 70 68 70 0a  i..re :..[[[php.
0a70: 2f 2f 20 52 c3 a9 70 65 72 74 6f 69 72 65 20 63  // R..pertoire c
0a80: 6f 6e 74 65 6e 61 6e 74 20 6c 27 61 72 62 6f 72  ontenant l'arbor
0a90: 65 73 63 65 6e 63 65 20 64 75 20 70 6c 75 67 69  escence du plugi
0aa0: 6e 0a 24 73 6f 75 72 63 65 5f 64 69 72 20 3d 20  n.$source_dir = 
0ab0: 27 2f 68 6f 6d 65 2f 62 6f 68 77 61 7a 2f 64 65  '/home/bohwaz/de
0ac0: 76 2f 70 6c 75 67 69 6e 73 2f 74 65 73 74 27 3b  v/plugins/test';
0ad0: 0a 0a 2f 2f 20 46 69 63 68 69 65 72 20 50 48 41  ..// Fichier PHA
0ae0: 52 20 c3 a0 20 63 72 c3 a9 65 72 0a 24 64 65 73  R .. cr..er.$des
0af0: 74 20 3d 20 27 2f 68 6f 6d 65 2f 62 6f 68 77 61  t = '/home/bohwa
0b00: 7a 2f 64 65 76 2f 67 61 72 72 61 64 69 6e 2f 73  z/dev/garradin/s
0b10: 72 63 2f 70 6c 75 67 69 6e 73 2f 74 65 73 74 2e  rc/plugins/test.
0b20: 70 68 61 72 27 3b 0a 0a 24 70 20 3d 20 6e 65 77  phar';..$p = new
0b30: 20 50 68 61 72 28 24 64 65 73 74 29 3b 0a 0a 24   Phar($dest);..$
0b40: 70 2d 3e 62 75 69 6c 64 46 72 6f 6d 44 69 72 65  p->buildFromDire
0b50: 63 74 6f 72 79 28 24 73 6f 75 72 63 65 5f 64 69  ctory($source_di
0b60: 72 29 3b 0a 0a 24 70 2d 3e 63 6f 6d 70 72 65 73  r);..$p->compres
0b70: 73 28 50 68 61 72 3a 3a 47 5a 29 3b 0a 0a 40 75  s(Phar::GZ);..@u
0b80: 6e 6c 69 6e 6b 28 24 64 65 73 74 29 3b 0a 72 65  nlink($dest);.re
0b90: 6e 61 6d 65 28 24 64 65 73 74 20 2e 20 27 2e 67  name($dest . '.g
0ba0: 7a 27 2c 20 24 64 65 73 74 29 3b 0a 5d 5d 5d 0a  z', $dest);.]]].
0bb0: 0a 55 6e 20 73 63 72 69 70 74 20 50 48 50 20 28  .Un script PHP (
0bc0: 2a 2a 6d 61 6b 65 5f 70 6c 75 67 69 6e 2e 70 68  **make_plugin.ph
0bd0: 70 2a 2a 29 20 65 73 74 20 66 6f 75 72 6e 69 20  p**) est fourni 
0be0: 64 61 6e 73 20 6c 65 20 72 c3 a9 70 65 72 74 6f  dans le r..perto
0bf0: 69 72 65 20 2a 2a 74 6f 6f 6c 73 2f 2a 2a 20 64  ire **tools/** d
0c00: 65 20 6c 61 20 76 65 72 73 69 6f 6e 20 64 65 20  e la version de 
0c10: 64 c3 a9 76 65 6c 6f 70 70 65 6d 65 6e 74 20 64  d..veloppement d
0c20: 65 20 47 61 72 72 61 64 69 6e 20 61 66 69 6e 20  e Garradin afin 
0c30: 64 65 20 76 c3 a9 72 69 66 69 65 72 20 6c 27 61  de v..rifier l'a
0c40: 72 62 6f 72 65 73 63 65 6e 63 65 20 65 74 20 64  rborescence et d
0c50: 65 20 63 72 c3 a9 65 72 20 6c 27 61 72 63 68 69  e cr..er l'archi
0c60: 76 65 20 50 48 41 52 20 65 6e 20 6c 69 67 6e 65  ve PHAR en ligne
0c70: 20 64 65 20 63 6f 6d 6d 61 6e 64 65 2e 20 53 6f   de commande. So
0c80: 6e 20 75 74 69 6c 69 73 61 74 69 6f 6e 20 65 73  n utilisation es
0c90: 74 20 74 72 c3 a8 73 20 73 69 6d 70 6c 65 20 3a  t tr..s simple :
0ca0: 0a 0a 20 24 20 70 68 70 20 2d 64 20 70 68 61 72  .. $ php -d phar
0cb0: 2e 72 65 61 64 6f 6e 6c 79 3d 30 20 7e 2f 64 65  .readonly=0 ~/de
0cc0: 76 2f 70 6c 75 67 69 6e 73 2f 74 65 73 74 20 7e  v/plugins/test ~
0cd0: 2f 67 61 72 72 61 64 69 6e 2f 73 72 63 2f 70 6c  /garradin/src/pl
0ce0: 75 67 69 6e 73 2f 74 65 73 74 2e 70 68 61 72 0a  ugins/test.phar.
0cf0: 0a 3d 3d 3d 20 49 6e 66 6f 72 6d 61 74 69 6f 6e  .=== Information
0d00: 73 20 73 75 72 20 6c 65 20 70 6c 75 67 69 6e 20  s sur le plugin 
0d10: 28 67 61 72 72 61 64 69 6e 5f 70 6c 75 67 69 6e  (garradin_plugin
0d20: 2e 69 6e 69 29 20 3d 3d 3d 0a 0a 43 68 61 71 75  .ini) ===..Chaqu
0d30: 65 20 70 6c 75 67 69 6e 20 64 6f 69 74 20 61 75  e plugin doit au
0d40: 20 6d 6f 69 6e 73 20 66 6f 75 72 6e 69 72 20 c3   moins fournir .
0d50: a0 20 6c 61 20 72 61 63 69 6e 65 20 64 65 20 73  . la racine de s
0d60: 6f 6e 20 61 72 63 68 69 76 65 20 75 6e 20 66 69  on archive un fi
0d70: 63 68 69 65 72 20 6e 6f 6d 6d c3 a9 20 27 27 67  chier nomm.. ''g
0d80: 61 72 72 61 64 69 6e 5f 70 6c 75 67 69 6e 2e 69  arradin_plugin.i
0d90: 6e 69 27 27 2e 20 43 65 20 66 69 63 68 69 65 72  ni''. Ce fichier
0da0: 20 66 6f 75 72 6e 69 74 20 6c 65 20 6e 6f 6d 2c   fournit le nom,
0db0: 20 6c 61 20 64 65 73 63 72 69 70 74 69 6f 6e 20   la description 
0dc0: 65 74 20 71 75 65 6c 71 75 65 73 20 64 c3 a9 74  et quelques d..t
0dd0: 61 69 6c 73 20 73 75 72 20 6c 65 20 70 6c 75 67  ails sur le plug
0de0: 69 6e 20 3a 0a 0a 20 6e 6f 6d 3d 22 4d 61 20 70  in :.. nom="Ma p
0df0: 72 65 6d 69 c3 a8 72 65 20 65 78 74 65 6e 73 69  remi..re extensi
0e00: 6f 6e 20 47 61 72 72 61 64 69 6e 22 0a 20 64 65  on Garradin". de
0e10: 73 63 72 69 70 74 69 6f 6e 3d 22 41 66 66 69 63  scription="Affic
0e20: 68 65 20 75 6e 20 6d 65 73 73 61 67 65 20 74 72  he un message tr
0e30: 6f 70 20 63 6f 6f 6c 22 0a 20 61 75 74 65 75 72  op cool". auteur
0e40: 3d 22 41 6e 6e 65 20 4f 6e 79 6d 65 22 0a 20 75  ="Anne Onyme". u
0e50: 72 6c 3d 22 68 74 74 70 3a 2f 2f 67 61 72 72 61  rl="http://garra
0e60: 64 69 6e 2e 65 75 2f 22 0a 20 76 65 72 73 69 6f  din.eu/". versio
0e70: 6e 3d 22 31 2e 30 22 0a 20 6d 65 6e 75 3d 31 0a  n="1.0". menu=1.
0e80: 20 63 6f 6e 66 69 67 3d 31 0a 0a 4c 61 20 64 69   config=1..La di
0e90: 72 65 63 74 69 76 65 20 27 27 6e 6f 6d 27 27 20  rective ''nom'' 
0ea0: 69 6e 64 69 71 75 65 20 6c 65 20 6e 6f 6d 20 64  indique le nom d
0eb0: 75 20 70 6c 75 67 69 6e 2c 20 71 75 69 20 73 65  u plugin, qui se
0ec0: 72 61 20 75 74 69 6c 69 73 c3 a9 20 64 61 6e 73  ra utilis.. dans
0ed0: 20 6c 65 73 20 6c 69 73 74 65 73 20 65 74 20 6d   les listes et m
0ee0: 65 6e 75 73 2e 20 27 27 64 65 73 63 72 69 70 74  enus. ''descript
0ef0: 69 6f 6e 27 27 20 66 6f 75 72 6e 69 74 20 75 6e  ion'' fournit un
0f00: 65 20 64 65 73 63 72 69 70 74 69 6f 6e 20 70 6c  e description pl
0f10: 75 73 20 6c 6f 6e 67 75 65 20 64 27 75 6e 65 20  us longue d'une 
0f20: 70 68 72 61 73 65 20 6f 75 20 64 65 75 78 2c 20  phrase ou deux, 
0f30: 27 27 61 75 74 65 75 72 27 27 20 64 6f 6e 6e 65  ''auteur'' donne
0f40: 20 6c 65 20 6e 6f 6d 20 64 65 20 6c 27 61 75 74   le nom de l'aut
0f50: 65 75 72 20 64 75 20 70 6c 75 67 69 6e 2c 20 65  eur du plugin, e
0f60: 74 20 27 27 75 72 6c 27 27 20 69 6e 64 69 71 75  t ''url'' indiqu
0f70: 65 20 6c 27 61 64 72 65 73 73 65 20 64 75 20 73  e l'adresse du s
0f80: 69 74 65 20 77 65 62 20 64 65 20 6c 27 61 75 74  ite web de l'aut
0f90: 65 75 72 2e 0a 0a 27 27 76 65 72 73 69 6f 6e 27  eur...''version'
0fa0: 27 20 65 73 74 20 75 74 69 6c 69 73 c3 a9 65 20  ' est utilis..e 
0fb0: 70 6f 75 72 20 73 61 76 6f 69 72 20 71 75 65 6c  pour savoir quel
0fc0: 6c 65 20 65 73 74 20 6c 61 20 76 65 72 73 69 6f  le est la versio
0fd0: 6e 20 64 75 20 70 6c 75 67 69 6e 20 66 6f 75 72  n du plugin four
0fe0: 6e 69 65 20 64 61 6e 73 20 6c 27 61 72 63 68 69  nie dans l'archi
0ff0: 76 65 2e 20 56 6f 69 72 20 70 6c 75 73 20 6c 6f  ve. Voir plus lo
1000: 69 6e 20 3a 20 5b 5b 4d 69 73 65 20 c3 a0 20 6a  in : [[Mise .. j
1010: 6f 75 72 7c 23 4d 69 73 65 20 c3 a0 20 6a 6f 75  our|#Mise .. jou
1020: 72 5d 5d 2e 0a 0a 27 27 6d 65 6e 75 27 27 20 69  r]]...''menu'' i
1030: 6e 64 69 71 75 65 20 c3 a0 20 47 61 72 72 61 64  ndique .. Garrad
1040: 69 6e 20 73 27 69 6c 20 64 6f 69 74 20 61 66 66  in s'il doit aff
1050: 69 63 68 65 72 20 75 6e 65 20 65 6e 74 72 c3 a9  icher une entr..
1060: 65 20 64 61 6e 73 20 6c 65 20 6d 65 6e 75 20 64  e dans le menu d
1070: 65 73 20 65 78 74 65 6e 73 69 6f 6e 73 20 64 65  es extensions de
1080: 20 6c 61 20 70 61 72 74 69 65 20 70 72 69 76 c3   la partie priv.
1090: a9 65 2e 20 43 65 74 74 65 20 65 6e 74 72 c3 a9  .e. Cette entr..
10a0: 65 20 73 65 72 61 20 76 69 73 69 62 6c 65 20 70  e sera visible p
10b0: 61 72 20 74 6f 75 73 20 6c 65 73 20 6d 65 6d 62  ar tous les memb
10c0: 72 65 73 20 71 75 69 20 70 65 75 76 65 6e 74 20  res qui peuvent 
10d0: 73 65 20 63 6f 6e 6e 65 63 74 65 72 2c 20 6d c3  se connecter, m.
10e0: aa 6d 65 20 73 69 20 6c 27 65 78 74 65 6e 73 69  .me si l'extensi
10f0: 6f 6e 20 72 65 73 74 72 65 69 6e 74 20 65 6e 73  on restreint ens
1100: 75 69 74 65 20 73 6f 6e 20 61 63 63 c3 a8 73 2e  uite son acc..s.
1110: 20 4c 27 65 6e 74 72 c3 a9 65 20 64 75 20 6d 65   L'entr..e du me
1120: 6e 75 20 61 70 70 65 6c 6c 65 72 61 20 6c 65 20  nu appellera le 
1130: 66 69 63 68 69 65 72 20 2a 2a 77 77 77 2f 61 64  fichier **www/ad
1140: 6d 69 6e 2f 69 6e 64 65 78 2e 70 68 70 2a 2a 20  min/index.php** 
1150: 71 75 69 20 64 65 76 72 61 20 64 6f 6e 63 20 65  qui devra donc e
1160: 78 69 73 74 65 72 2c 20 c3 a0 20 64 c3 a9 66 61  xister, .. d..fa
1170: 75 74 20 6c 27 69 6e 73 74 61 6c 6c 61 74 69 6f  ut l'installatio
1180: 6e 20 64 65 20 6c 27 65 78 74 65 6e 73 69 6f 6e  n de l'extension
1190: 20 c3 a9 63 68 6f 75 65 72 61 2e 0a 0a 27 27 63   ..chouera...''c
11a0: 6f 6e 66 69 67 27 27 20 69 6e 64 69 71 75 65 20  onfig'' indique 
11b0: 73 69 20 6c 27 65 78 74 65 6e 73 69 6f 6e 20 70  si l'extension p
11c0: 6f 73 73 c3 a8 64 65 20 75 6e 65 20 63 6f 6e 66  oss..de une conf
11d0: 69 67 75 72 61 74 69 6f 6e 20 6d 6f 64 69 66 69  iguration modifi
11e0: 61 62 6c 65 20 70 61 72 20 6c 27 75 74 69 6c 69  able par l'utili
11f0: 73 61 74 65 75 72 2e 20 53 69 20 70 6f 73 69 74  sateur. Si posit
1200: 69 6f 6e 6e c3 a9 20 c3 a0 20 31 20 28 6f 75 20  ionn.. .. 1 (ou 
1210: 27 27 74 72 75 65 27 27 29 20 61 6c 6f 72 73 20  ''true'') alors 
1220: 6c 61 20 70 61 67 65 20 64 65 20 67 65 73 74 69  la page de gesti
1230: 6f 6e 20 64 65 73 20 65 78 74 65 6e 73 69 6f 6e  on des extension
1240: 73 20 70 72 6f 70 6f 73 65 72 61 20 75 6e 20 6c  s proposera un l
1250: 69 65 6e 20 70 6f 75 72 20 63 6f 6e 66 69 67 75  ien pour configu
1260: 72 65 72 20 6c 27 65 78 74 65 6e 73 69 6f 6e 20  rer l'extension 
1270: 28 61 70 70 65 6c 61 6e 74 20 6c 65 20 66 69 63  (appelant le fic
1280: 68 69 65 72 20 2a 2a 77 77 77 2f 61 64 6d 69 6e  hier **www/admin
1290: 2f 63 6f 6e 66 69 67 2e 70 68 70 2a 2a 29 2c 20  /config.php**), 
12a0: 65 74 20 6c 65 20 66 69 63 68 69 65 72 20 2a 2a  et le fichier **
12b0: 63 6f 6e 66 69 67 2e 6a 73 6f 6e 2a 2a 20 73 65  config.json** se
12c0: 72 61 20 69 6d 70 6f 72 74 c3 a9 20 63 6f 6d 6d  ra import.. comm
12d0: 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20  e configuration 
12e0: 70 61 72 20 64 c3 a9 66 61 75 74 2e 20 43 65 73  par d..faut. Ces
12f0: 20 64 65 75 78 20 66 69 63 68 69 65 72 73 20 73   deux fichiers s
1300: 6f 6e 74 20 64 6f 6e 63 20 6f 62 6c 69 67 61 74  ont donc obligat
1310: 6f 69 72 65 73 20 73 69 20 27 27 63 6f 6e 66 69  oires si ''confi
1320: 67 27 27 20 65 73 74 20 61 63 74 69 76 c3 a9 2e  g'' est activ...
1330: 0a 0a 41 74 74 65 6e 74 69 6f 6e 2c 20 73 69 20  ..Attention, si 
1340: 6c 65 20 66 69 63 68 69 65 72 20 2a 2a 67 61 72  le fichier **gar
1350: 72 61 64 69 6e 5f 70 6c 75 67 69 6e 2e 69 6e 69  radin_plugin.ini
1360: 2a 2a 20 6e 27 65 78 69 73 74 65 20 70 61 73 20  ** n'existe pas 
1370: 64 61 6e 73 20 6c 27 61 72 63 68 69 76 65 20 65  dans l'archive e
1380: 6c 6c 65 20 6e 65 20 70 6f 75 72 72 61 20 70 61  lle ne pourra pa
1390: 73 20 c3 aa 74 72 65 20 69 6e 73 74 61 6c 6c c3  s ..tre install.
13a0: a9 65 2c 20 6e 27 c3 a9 74 61 6e 74 20 70 61 73  .e, n'..tant pas
13b0: 20 63 6f 6e 73 69 64 c3 a9 72 c3 a9 65 20 63 6f   consid..r..e co
13c0: 6d 6d 65 20 75 6e 20 70 6c 75 67 69 6e 20 64 65  mme un plugin de
13d0: 20 47 61 72 72 61 64 69 6e 2e 0a 0a 3d 3d 3d 20   Garradin...=== 
13e0: 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 75  Configuration du
13f0: 20 70 6c 75 67 69 6e 20 3d 3d 3d 0a 0a 53 69 20   plugin ===..Si 
1400: 27 27 63 6f 6e 66 69 67 27 27 20 65 73 74 20 70  ''config'' est p
1410: 6f 73 69 74 69 6f 6e 6e c3 a9 20 c3 a0 20 31 20  ositionn.. .. 1 
1420: 6f 75 20 74 72 75 65 20 28 6f 75 20 6d c3 aa 6d  ou true (ou m..m
1430: 65 20 27 27 4f 6e 27 27 29 20 64 61 6e 73 20 67  e ''On'') dans g
1440: 61 72 72 61 64 69 6e 5f 70 6c 75 67 69 6e 2e 69  arradin_plugin.i
1450: 6e 69 20 6c 61 20 63 6f 6e 66 69 67 75 72 61 74  ni la configurat
1460: 69 6f 6e 20 61 75 20 66 6f 72 6d 61 74 20 4a 53  ion au format JS
1470: 4f 4e 20 73 74 6f 63 6b c3 a9 65 20 64 61 6e 73  ON stock..e dans
1480: 20 2a 2a 63 6f 6e 66 69 67 2e 6a 73 6f 6e 2a 2a   **config.json**
1490: 20 73 65 72 61 20 69 6d 70 6f 72 74 c3 a9 65 20   sera import..e 
14a0: 63 6f 6d 6d 65 20 63 6f 6e 66 69 67 75 72 61 74  comme configurat
14b0: 69 6f 6e 20 70 61 72 20 64 c3 a9 66 61 75 74 20  ion par d..faut 
14c0: 64 75 20 70 6c 75 67 69 6e 2e 0a 0a 41 74 74 65  du plugin...Atte
14d0: 6e 74 69 6f 6e 20 6c 65 73 20 6f 62 6a 65 74 73  ntion les objets
14e0: 20 6a 61 76 61 73 63 72 69 70 74 20 73 6f 6e 74   javascript sont
14f0: 20 74 72 61 6e 73 66 6f 72 6d c3 a9 73 20 65 6e   transform..s en
1500: 20 74 61 62 6c 65 61 75 78 20 c3 a0 20 6c 27 69   tableaux .. l'i
1510: 6d 70 6f 72 74 2c 20 69 6c 20 6e 27 65 73 74 20  mport, il n'est 
1520: 64 6f 6e 63 20 70 61 73 20 70 6f 73 73 69 62 6c  donc pas possibl
1530: 65 20 64 65 20 73 74 6f 63 6b 65 72 20 75 6e 20  e de stocker un 
1540: 6f 62 6a 65 74 20 64 79 6e 61 6d 69 71 75 65 20  objet dynamique 
1550: 64 61 6e 73 20 6c 61 20 63 6f 6e 66 69 67 75 72  dans la configur
1560: 61 74 69 6f 6e 2e 0a 0a 3d 3d 3d 20 53 63 72 69  ation...=== Scri
1570: 70 74 73 20 6d 61 67 69 71 75 65 73 20 3d 3d 3d  pts magiques ===
1580: 0a 0a 43 68 61 71 75 65 20 61 72 63 68 69 76 65  ..Chaque archive
1590: 20 70 65 75 74 20 63 6f 6d 70 6f 72 74 65 72 20   peut comporter 
15a0: 63 65 72 74 61 69 6e 73 20 27 27 73 63 72 69 70  certains ''scrip
15b0: 74 73 20 6d 61 67 69 71 75 65 73 27 27 20 71 75  ts magiques'' qu
15c0: 69 20 73 65 72 6f 6e 74 20 61 70 70 65 6c c3 a9  i seront appel..
15d0: 73 20 61 75 74 6f 6d 61 74 69 71 75 65 6d 65 6e  s automatiquemen
15e0: 74 20 70 61 72 20 47 61 72 72 61 64 69 6e 20 6c  t par Garradin l
15f0: 6f 72 73 20 64 65 20 63 65 72 74 61 69 6e 73 20  ors de certains 
1600: c3 a9 76 c3 a9 6e 65 6d 65 6e 74 73 2e 0a 0a 2a  ..v..nements...*
1610: 20 2a 2a 69 6e 73 74 61 6c 6c 2e 70 68 70 2a 2a   **install.php**
1620: 20 65 73 74 20 61 70 70 65 6c c3 a9 20 71 75 61   est appel.. qua
1630: 6e 64 20 6c 65 20 70 6c 75 67 69 6e 20 61 20 c3  nd le plugin a .
1640: a9 74 c3 a9 20 74 c3 a9 6c c3 a9 63 68 61 72 67  .t.. t..l..charg
1650: c3 a9 20 65 74 20 71 75 27 69 6c 20 65 73 74 20  .. et qu'il est 
1660: 64 c3 a9 6a c3 a0 20 6e 6f 74 c3 a9 20 63 6f 6d  d..j.. not.. com
1670: 6d 65 20 69 6e 73 74 61 6c 6c c3 a9 20 28 70 6f  me install.. (po
1680: 73 74 2d 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 29  st-installation)
1690: 2c 20 75 74 69 6c 65 20 6e 6f 74 61 6d 6d 65 6e  , utile notammen
16a0: 74 20 70 6f 75 72 20 63 72 c3 a9 65 72 20 75 6e  t pour cr..er un
16b0: 65 20 74 61 62 6c 65 20 64 61 6e 73 20 6c 61 20  e table dans la 
16c0: 62 61 73 65 20 64 65 20 64 6f 6e 6e c3 a9 65 73  base de donn..es
16d0: 0a 2a 20 2a 2a 75 70 67 72 61 64 65 2e 70 68 70  .* **upgrade.php
16e0: 2a 2a 20 3a 20 71 75 61 6e 64 20 6c 61 20 76 65  ** : quand la ve
16f0: 72 73 69 6f 6e 20 64 65 20 6c 27 61 72 63 68 69  rsion de l'archi
1700: 76 65 20 28 6e 6f 74 c3 a9 65 20 64 61 6e 73 20  ve (not..e dans 
1710: 67 61 72 72 61 64 69 6e 5f 70 6c 75 67 69 6e 2e  garradin_plugin.
1720: 69 6e 69 29 20 6e 65 20 63 6f 72 72 65 73 70 6f  ini) ne correspo
1730: 6e 64 20 70 61 73 20 c3 a0 20 6c 61 20 76 65 72  nd pas .. la ver
1740: 73 69 6f 6e 20 65 6e 72 65 67 69 73 74 72 c3 a9  sion enregistr..
1750: 65 20 65 6e 20 62 61 73 65 20 64 65 20 64 6f 6e  e en base de don
1760: 6e c3 a9 65 0a 2a 20 2a 2a 75 6e 69 6e 73 74 61  n..e.* **uninsta
1770: 6c 6c 2e 70 68 70 2a 2a 20 3a 20 6a 75 73 74 65  ll.php** : juste
1780: 20 61 76 61 6e 74 20 71 75 65 20 6c 65 20 70 6c   avant que le pl
1790: 75 67 69 6e 20 6e 65 20 73 6f 69 74 20 73 75 70  ugin ne soit sup
17a0: 70 72 69 6d c3 a9 2c 20 75 74 69 6c 65 20 70 61  prim.., utile pa
17b0: 72 20 65 78 65 6d 70 6c 65 20 70 6f 75 72 20 73  r exemple pour s
17c0: 75 70 70 72 69 6d 65 72 20 75 6e 65 20 74 61 62  upprimer une tab
17d0: 6c 65 20 63 72 c3 a9 c3 a9 65 20 64 61 6e 73 20  le cr....e dans 
17e0: 6c 61 20 62 61 73 65 20 64 65 20 64 6f 6e 6e c3  la base de donn.
17f0: a9 65 73 0a 0a 43 65 73 20 73 63 72 69 70 74 73  .es..Ces scripts
1800: 20 6e 65 20 70 65 75 76 65 6e 74 20 70 61 73 20   ne peuvent pas 
1810: c3 aa 74 72 65 20 61 70 70 65 6c c3 a9 73 20 70  ..tre appel..s p
1820: 61 72 20 75 6e 65 20 72 65 71 75 c3 aa 74 65 20  ar une requ..te 
1830: 48 54 54 50 20 76 69 61 20 6c 27 69 6e 74 65 72  HTTP via l'inter
1840: 66 61 63 65 20 70 72 69 76 c3 a9 65 20 6f 75 20  face priv..e ou 
1850: 70 75 62 6c 69 71 75 65 2e 0a 0a 3d 3d 3d 20 4f  publique...=== O
1860: 62 6a 65 74 20 47 61 72 72 61 64 69 6e 5c 50 6c  bjet Garradin\Pl
1870: 75 67 69 6e 20 3d 3d 0a 0a 2a 20 5f 5f 63 6f 6e  ugin ==..* __con
1880: 73 74 72 75 63 74 28 73 74 72 69 6e 67 20 24 69  struct(string $i
1890: 64 29 0a 2a 20 73 65 74 43 6f 6e 66 69 67 28 73  d).* setConfig(s
18a0: 74 72 69 6e 67 20 24 6b 65 79 2c 20 73 74 72 69  tring $key, stri
18b0: 6e 67 20 24 76 61 6c 75 65 29 20 3a 20 65 6e 72  ng $value) : enr
18c0: 65 67 69 73 74 72 65 20 6c 61 20 63 6f 6e 66 69  egistre la confi
18d0: 67 75 72 61 74 69 6f 6e 20 64 75 20 70 6c 75 67  guration du plug
18e0: 69 6e 2c 20 73 69 20 24 76 61 6c 75 65 20 65 73  in, si $value es
18f0: 74 20 6e 75 6c 6c 20 61 6c 6f 72 73 20 74 74 65  t null alors tte
1900: 20 63 6c c3 a9 20 65 73 74 20 65 66 66 61 63 c3   cl.. est effac.
1910: a9 65 20 64 65 20 6c 61 20 63 6f 6e 66 69 67 75  .e de la configu
1920: 72 61 74 69 6f 6e 0a 2a 20 67 65 74 43 6f 6e 66  ration.* getConf
1930: 69 67 28 73 74 72 69 6e 67 20 24 6b 65 79 29 20  ig(string $key) 
1940: 3a 20 72 c3 a9 63 75 70 c3 a8 72 65 20 6c 61 20  : r..cup..re la 
1950: 76 61 6c 65 75 72 20 64 65 20 6c 61 20 63 6c c3  valeur de la cl.
1960: a9 20 24 6b 65 79 20 70 6f 75 72 20 6c 61 20 63  . $key pour la c
1970: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 75 20  onfiguration du 
1980: 70 6c 75 67 69 6e 0a 2a 20 67 65 74 49 6e 66 6f  plugin.* getInfo
1990: 73 28 29 20 3a 20 72 65 6e 76 6f 69 65 20 6c 65  s() : renvoie le
19a0: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 73 20 65  s informations e
19b0: 6e 72 65 67 69 73 74 72 c3 a9 65 73 20 73 75 72  nregistr..es sur
19c0: 20 6c 65 20 70 6c 75 67 69 6e 0a 2a 20 75 70 67   le plugin.* upg
19d0: 72 61 64 65 28 29 20 3a 20 6d 69 73 65 20 c3 a0  rade() : mise ..
19e0: 20 6a 6f 75 72 20 64 75 20 70 6c 75 67 69 6e 0a   jour du plugin.
19f0: 2a 20 6e 65 65 64 73 55 70 67 72 61 64 65 28 29  * needsUpgrade()
1a00: 20 3a 20 6c 65 20 70 6c 75 67 69 6e 20 64 6f 69   : le plugin doi
1a10: 74 2d 69 6c 20 c3 aa 74 72 65 20 6d 69 73 20 c3  t-il ..tre mis .
1a20: a0 20 6a 6f 75 72 20 3f 0a 2a 20 75 6e 69 6e 73  . jour ?.* unins
1a30: 74 61 6c 6c 28 29 20 3a 20 64 c3 a9 73 69 6e 73  tall() : d..sins
1a40: 74 61 6c 6c 65 72 20 6c 65 20 70 6c 75 67 69 6e  taller le plugin
1a50: 0a 2a 20 69 64 28 29 20 3a 20 72 65 6e 76 6f 69  .* id() : renvoi
1a60: 65 20 6c 27 69 64 65 6e 74 69 66 69 61 6e 74 20  e l'identifiant 
1a70: 64 75 20 70 6c 75 67 69 6e 0a 2a 20 70 61 74 68  du plugin.* path
1a80: 28 29 20 3a 20 72 65 6e 76 6f 69 65 20 6c 65 20  () : renvoie le 
1a90: 63 68 65 6d 69 6e 20 76 65 72 73 20 6c 27 61 72  chemin vers l'ar
1aa0: 63 68 69 76 65 20 50 48 41 52 20 64 75 20 70 6c  chive PHAR du pl
1ab0: 75 67 69 6e 0a 0a 3d 3d 3d 20 42 61 73 65 20 64  ugin..=== Base d
1ac0: 65 20 64 6f 6e 6e c3 a9 65 73 20 3d 3d 3d 0a 0a  e donn..es ===..
1ad0: 54 6f 75 73 20 6c 65 73 20 70 6c 75 67 69 6e 73  Tous les plugins
1ae0: 20 6f 6e 74 20 75 6e 20 61 63 63 c3 a8 73 20 69   ont un acc..s i
1af0: 6c 6c 69 6d 69 74 c3 a9 20 c3 a0 20 6c 61 20 62  llimit.. .. la b
1b00: 61 73 65 20 64 65 20 64 6f 6e 6e c3 a9 65 73 20  ase de donn..es 
1b10: 70 72 69 6e 63 69 70 61 6c 65 20 64 65 20 47 61  principale de Ga
1b20: 72 72 61 64 69 6e 2e 20 43 65 70 65 6e 64 61 6e  rradin. Cependan
1b30: 74 20 69 6c 20 65 73 74 20 69 6e 74 65 72 64 69  t il est interdi
1b40: 74 20 64 27 61 6a 6f 75 74 65 72 2c 20 6d 6f 64  t d'ajouter, mod
1b50: 69 66 69 65 72 20 6f 75 20 73 75 70 70 72 69 6d  ifier ou supprim
1b60: 65 72 20 64 65 73 20 64 6f 6e 6e c3 a9 65 73 20  er des donn..es 
1b70: 64 69 72 65 63 74 65 6d 65 6e 74 20 64 61 6e 73  directement dans
1b80: 20 6c 65 73 20 74 61 62 6c 65 73 20 64 65 20 63   les tables de c
1b90: 65 74 74 65 20 42 44 44 20 61 66 69 6e 20 64 65  ette BDD afin de
1ba0: 20 6e 65 20 70 61 73 20 63 6f 6d 70 72 6f 6d 65   ne pas comprome
1bb0: 74 74 72 65 20 6c 27 69 6e 74 c3 a9 67 72 69 74  ttre l'int..grit
1bc0: c3 a9 20 64 65 73 20 64 6f 6e 6e c3 a9 65 73 2e  .. des donn..es.
1bd0: 20 50 6f 75 72 20 6d 6f 64 69 66 69 65 72 20 63   Pour modifier c
1be0: 65 73 20 64 6f 6e 6e c3 a9 65 73 20 69 6c 20 66  es donn..es il f
1bf0: 61 75 74 20 75 74 69 6c 69 73 65 72 20 6c 65 73  aut utiliser les
1c00: 20 6d c3 a9 74 68 6f 64 65 73 20 64 65 20 47 61   m..thodes de Ga
1c10: 72 72 61 64 69 6e 2e 0a 0a 43 68 61 71 75 65 20  rradin...Chaque 
1c20: 70 6c 75 67 69 6e 20 70 65 75 74 20 63 72 c3 a9  plugin peut cr..
1c30: 65 72 20 75 6e 65 20 6f 75 20 70 6c 75 73 69 65  er une ou plusie
1c40: 75 72 73 20 74 61 62 6c 65 73 20 64 61 6e 73 20  urs tables dans 
1c50: 63 65 74 74 65 20 42 44 44 2c 20 65 6c 6c 65 73  cette BDD, elles
1c60: 20 64 65 76 72 6f 6e 74 20 70 61 72 20 63 6f 6e   devront par con
1c70: 74 72 65 20 c3 aa 74 72 65 20 73 75 70 70 72 69  tre ..tre suppri
1c80: 6d c3 a9 65 73 20 c3 a0 20 6c 61 20 64 c3 a9 73  m..es .. la d..s
1c90: 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2e 20 44 61  installation. Da
1ca0: 6e 73 20 63 65 20 63 61 73 20 75 6e 20 70 6c 75  ns ce cas un plu
1cb0: 67 69 6e 20 70 65 75 74 20 6d 6f 64 69 66 69 65  gin peut modifie
1cc0: 72 20 64 69 72 65 63 74 65 6d 65 6e 74 20 73 65  r directement se
1cd0: 73 20 74 61 62 6c 65 73 2e 0a 0a 3d 3d 3d 20 46  s tables...=== F
1ce0: 69 63 68 69 65 72 73 20 3d 3d 3d 0a 0a 4c 65 73  ichiers ===..Les
1cf0: 20 70 6c 75 67 69 6e 73 20 6e 65 20 64 6f 69 76   plugins ne doiv
1d00: 65 6e 74 20 70 61 73 20 63 72 c3 a9 65 72 2c 20  ent pas cr..er, 
1d10: 6d 6f 64 69 66 69 65 72 20 6f 75 20 73 75 70 70  modifier ou supp
1d20: 72 69 6d 65 72 20 64 65 20 66 69 63 68 69 65 72  rimer de fichier
1d30: 73 20 64 61 6e 73 20 6c 27 61 72 62 6f 72 65 73  s dans l'arbores
1d40: 63 65 6e 63 65 20 64 65 20 47 61 72 72 61 64 69  cence de Garradi
1d50: 6e 2e 0a 0a 4c 65 73 20 73 65 75 6c 73 20 66 69  n...Les seuls fi
1d60: 63 68 69 65 72 73 20 71 75 27 75 6e 20 70 6c 75  chiers qu'un plu
1d70: 67 69 6e 20 64 65 76 72 61 69 74 20 6d 6f 64 69  gin devrait modi
1d80: 66 69 65 72 20 73 6f 6e 74 20 3a 0a 2a 20 64 75  fier sont :.* du
1d90: 20 63 61 63 68 65 20 3a 20 75 74 69 6c 69 73 65   cache : utilise
1da0: 72 20 64 65 20 70 72 c3 a9 66 c3 a9 72 65 6e 63  r de pr..f..renc
1db0: 65 20 6c 27 6f 62 6a 65 74 20 53 74 61 74 69 63  e l'objet Static
1dc0: 5f 43 61 63 68 65 20 64 65 20 47 61 72 72 61 64  _Cache de Garrad
1dd0: 69 6e 2c 20 6f 75 20 66 61 69 72 65 20 61 74 74  in, ou faire att
1de0: 65 6e 74 69 6f 6e 20 61 75 78 20 63 6f 6c 6c 69  ention aux colli
1df0: 73 69 6f 6e 73 20 64 65 20 6e 6f 6d 73 20 3b 0a  sions de noms ;.
1e00: 2a 20 6c 65 73 20 73 71 75 65 6c 65 74 74 65 73  * les squelettes
1e10: 20 64 61 6e 73 20 6c 65 20 72 c3 a9 70 65 72 74   dans le r..pert
1e20: 6f 69 72 65 20 2a 2a 77 77 77 2f 73 71 75 65 6c  oire **www/squel
1e30: 65 74 74 65 73 2f 2a 2a 0a 0a 50 6f 75 72 20 65  ettes/**..Pour e
1e40: 6e 72 65 67 69 73 74 72 65 72 20 65 74 20 72 c3  nregistrer et r.
1e50: a9 63 75 70 c3 a9 72 65 72 20 64 65 73 20 64 6f  .cup..rer des do
1e60: 63 75 6d 65 6e 74 73 20 69 6c 20 66 61 75 74 20  cuments il faut 
1e70: 75 74 69 6c 69 73 65 72 20 6c 65 73 20 6d c3 a9  utiliser les m..
1e80: 74 68 6f 64 65 73 20 64 65 20 73 74 6f 63 6b 61  thodes de stocka
1e90: 67 65 20 64 65 20 66 69 63 68 69 65 72 73 20 66  ge de fichiers f
1ea0: 6f 75 72 6e 69 65 73 20 70 61 72 20 47 61 72 72  ournies par Garr
1eb0: 61 64 69 6e 2e 0a 0a 3d 3d 3d 20 44 61 6e 73 20  adin...=== Dans 
1ec0: 6c 65 73 20 74 65 6d 70 6c 61 74 65 73 20 3d 3d  les templates ==
1ed0: 3d 0a 0a 47 61 72 72 61 64 69 6e 20 66 6f 75 72  =..Garradin four
1ee0: 6e 69 74 20 6c 61 20 6c 69 62 20 54 65 6d 70 6c  nit la lib Templ
1ef0: 61 74 65 5f 4c 69 74 65 2c 20 64 c3 a9 6a c3 a0  ate_Lite, d..j..
1f00: 20 63 68 61 72 67 c3 a9 65 20 70 61 72 20 64 c3   charg..e par d.
1f10: a9 66 61 75 74 2e 20 43 27 65 73 74 20 75 6e 65  .faut. C'est une
1f20: 20 76 65 72 73 69 6f 6e 20 61 6c 6c c3 a9 67 c3   version all..g.
1f30: a9 65 20 64 65 20 53 6d 61 72 74 79 20 32 2e 0a  .e de Smarty 2..
1f40: 0a 41 66 66 69 63 68 65 72 20 75 6e 20 74 65 6d  .Afficher un tem
1f50: 70 6c 61 74 65 20 63 6f 6e 74 65 6e 75 20 64 61  plate contenu da
1f60: 6e 73 20 6c 65 20 70 6c 75 67 69 6e 20 3a 0a 3c  ns le plugin :.<
1f70: 70 72 65 3e 0a 20 20 20 20 24 74 70 6c 2d 3e 64  pre>.    $tpl->d
1f80: 69 73 70 6c 61 79 28 50 4c 55 47 49 4e 5f 52 4f  isplay(PLUGIN_RO
1f90: 4f 54 20 2e 20 27 2f 74 65 6d 70 6c 61 74 65 73  OT . '/templates
1fa0: 2f 69 6e 64 65 78 2e 74 70 6c 27 29 3b 0a 3c 2f  /index.tpl');.</
1fb0: 70 72 65 3e 0a 0a 49 6e 63 6c 75 72 65 20 75 6e  pre>..Inclure un
1fc0: 20 74 65 6d 70 6c 61 74 65 20 64 65 20 47 61 72   template de Gar
1fd0: 72 61 64 69 6e 20 64 65 70 75 69 73 20 75 6e 20  radin depuis un 
1fe0: 74 65 6d 70 6c 61 74 65 20 3a 0a 3c 70 72 65 3e  template :.<pre>
1ff0: 0a 20 20 20 20 7b 69 6e 63 6c 75 64 65 20 66 69  .    {include fi
2000: 6c 65 3d 22 61 64 6d 69 6e 2f 5f 68 65 61 64 2e  le="admin/_head.
2010: 74 70 6c 22 7d 0a 3c 2f 70 72 65 3e 0a 0a 49 6e  tpl"}.</pre>..In
2020: 63 6c 75 72 65 20 75 6e 20 74 65 6d 70 6c 61 74  clure un templat
2030: 65 20 64 75 20 70 6c 75 67 69 6e 20 64 65 70 75  e du plugin depu
2040: 69 73 20 75 6e 20 61 75 74 72 65 20 74 65 6d 70  is un autre temp
2050: 6c 61 74 65 20 64 75 20 70 6c 75 67 69 6e 20 3a  late du plugin :
2060: 0a 3c 70 72 65 3e 0a 20 20 20 20 7b 69 6e 63 6c  .<pre>.    {incl
2070: 75 64 65 20 66 69 6c 65 3d 22 60 24 70 6c 75 67  ude file="`$plug
2080: 69 6e 5f 72 6f 6f 74 60 2f 74 65 6d 70 6c 61 74  in_root`/templat
2090: 65 73 2f 5f 6e 61 76 2e 74 70 6c 22 7d 0a 3c 2f  es/_nav.tpl"}.</
20a0: 70 72 65 3e 0a 0a 46 61 69 72 65 20 75 6e 20 6c  pre>..Faire un l
20b0: 69 65 6e 20 76 65 72 73 20 75 6e 65 20 61 75 74  ien vers une aut
20c0: 72 65 20 70 61 67 65 20 64 75 20 70 6c 75 67 69  re page du plugi
20d0: 6e 20 3a 0a 3c 76 65 72 62 61 74 69 6d 3e 0a 20  n :.<verbatim>. 
20e0: 20 20 20 3c 61 20 68 72 65 66 3d 22 7b 70 6c 75     <a href="{plu
20f0: 67 69 6e 5f 75 72 6c 20 66 69 6c 65 3d 22 6c 69  gin_url file="li
2100: 73 74 65 2e 70 68 70 22 7d 22 3e 4c 69 73 74 65  ste.php"}">Liste
2110: 20 64 65 73 20 74 72 75 63 73 3c 2f 61 3e 0a 3c   des trucs</a>.<
2120: 2f 76 65 72 62 61 74 69 6d 3e 0a 0a 49 6e 63 6c  /verbatim>..Incl
2130: 75 72 65 20 75 6e 65 20 66 65 75 69 6c 6c 65 20  ure une feuille 
2140: 64 65 20 73 74 79 6c 65 20 43 53 53 20 73 75 70  de style CSS sup
2150: 70 6c c3 a9 6d 65 6e 74 61 69 72 65 20 73 75 72  pl..mentaire sur
2160: 20 6c 65 73 20 70 61 67 65 73 20 64 75 20 70 6c   les pages du pl
2170: 75 67 69 6e 20 28 63 68 65 6d 69 6e 20 72 65 6c  ugin (chemin rel
2180: 61 74 69 66 20 c3 a0 20 6c 61 20 72 61 63 69 6e  atif .. la racin
2190: 65 20 64 75 20 70 6c 75 67 69 6e 29 20 3a 0a 3c  e du plugin) :.<
21a0: 70 72 65 3e 0a 20 20 20 20 24 74 70 6c 2d 3e 61  pre>.    $tpl->a
21b0: 73 73 69 67 6e 28 27 70 6c 75 67 69 6e 5f 63 73  ssign('plugin_cs
21c0: 73 27 2c 20 27 73 74 79 6c 65 73 2f 62 6c 65 75  s', 'styles/bleu
21d0: 2e 63 73 73 27 29 3b 0a 3c 2f 70 72 65 3e 0a     .css');.</pre>.