Introduction aux plugins : Différence entre versions
m |
m (mises en parties) |
||
Ligne 1 : | Ligne 1 : | ||
+ | == Introduction == | ||
Thelia est une application modulaire pouvant être enrichie à l'aide de plugins. | Thelia est une application modulaire pouvant être enrichie à l'aide de plugins. | ||
Le plugin est un système qui permet d'ajouter proprement des fonctionnalités à Thélia et donc de pouvoir les intégrer proprement à chaque mise à jour. | Le plugin est un système qui permet d'ajouter proprement des fonctionnalités à Thélia et donc de pouvoir les intégrer proprement à chaque mise à jour. | ||
Il répond à des conventions propres à Thelia. | Il répond à des conventions propres à Thelia. | ||
+ | |||
+ | == Types de plugins == | ||
Il existe 4 types de plugins : | Il existe 4 types de plugins : | ||
Ligne 10 : | Ligne 13 : | ||
* les plugins paiement permettent d'ajouter un nouveau mode de paiement | * les plugins paiement permettent d'ajouter un nouveau mode de paiement | ||
* les plugins filtre (à partir de Thelia 1.5) | * les plugins filtre (à partir de Thelia 1.5) | ||
− | |||
Tous ces plugins peuvent être enrichis d'une interface administrateur. | Tous ces plugins peuvent être enrichis d'une interface administrateur. | ||
+ | |||
+ | ==Composants d'un plugin== | ||
Un plugin est constitué au minimum : | Un plugin est constitué au minimum : | ||
Ligne 22 : | Ligne 26 : | ||
Pour ajouter une gestion du plugin au niveau de l'interface d'administration, le code nécessaire se trouvera dans le fichier ''nom''_admin.php<br /><br /> | Pour ajouter une gestion du plugin au niveau de l'interface d'administration, le code nécessaire se trouvera dans le fichier ''nom''_admin.php<br /><br /> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
Le fichier plugin.xml situé dans le répertoire du plugin est tout simplement la carte d'identité du plugin. | Le fichier plugin.xml situé dans le répertoire du plugin est tout simplement la carte d'identité du plugin. | ||
Voici un exemple : | Voici un exemple : | ||
Ligne 48 : | Ligne 46 : | ||
</plugin> | </plugin> | ||
</pre> | </pre> | ||
− | Le plugin peut être enrichi de plusieurs fichiers selon sa fonction : | + | ==Installation == |
+ | *Le plugin sera installé dans le répertoire ''client/plugins'' de l'application Thelia.<br /> | ||
+ | *Il pourra être installé de manière autonome depuis l'interface d'administration. Il suffira pour cela de fournir un fichier zip à l'utilisateur. Notre plugin test deviendrait donc ''test.zip'' | ||
+ | <br /> | ||
+ | |||
+ | ==Autres composants== | ||
+ | Le plugin peut être aussi enrichi de plusieurs fichiers selon sa fonction : | ||
*Un fichier Readme.txt qui explique comment l'installer, comment insérer une boucle dans une page... | *Un fichier Readme.txt qui explique comment l'installer, comment insérer une boucle dans une page... | ||
*Un fichier template (''test.html'' par exemple) qui est ajouté dans le dossier template à la racine, dans le cas d'un plugin qui ajoute une page dans le site. | *Un fichier template (''test.html'' par exemple) qui est ajouté dans le dossier template à la racine, dans le cas d'un plugin qui ajoute une page dans le site. | ||
*Le fichier php (''test.php'' dans notre cas) n'est plus nécessaire depuis la version 1.5. | *Le fichier php (''test.php'' dans notre cas) n'est plus nécessaire depuis la version 1.5. | ||
[[Sommaire]] | [[Sommaire]] |
Version actuelle en date du 13 mai 2012 à 14:05
Sommaire
Introduction
Thelia est une application modulaire pouvant être enrichie à l'aide de plugins.
Le plugin est un système qui permet d'ajouter proprement des fonctionnalités à Thélia et donc de pouvoir les intégrer proprement à chaque mise à jour. Il répond à des conventions propres à Thelia.
Types de plugins
Il existe 4 types de plugins :
- les plugins classiques permettent d'ajouter des actions, des boucles ...
- les plugins transports permettent d'ajouter un mode de transport
- les plugins paiement permettent d'ajouter un nouveau mode de paiement
- les plugins filtre (à partir de Thelia 1.5)
Tous ces plugins peuvent être enrichis d'une interface administrateur.
Composants d'un plugin
Un plugin est constitué au minimum :
- d'un répertoire étant le nom du plugin. Prenons un exemple simple. Un plugin nommé test. Nous aurions un répertoire test contenant le fichier Test.class.php
- une classe se nommant Nom.class.php. Le "Nom" de la classe est tout simplement le nom du plugin avec sa 1ère lettre en majuscule comme le fichier Test.class.php
- d'un fichier plugin.xml
Pour ajouter une gestion du plugin au niveau de l'interface d'administration, le code nécessaire se trouvera dans le fichier nom_admin.php
Le fichier plugin.xml situé dans le répertoire du plugin est tout simplement la carte d'identité du plugin. Voici un exemple :
<?xml version="1.0" encoding='UTF-8'?> <plugin> <nom>Alerte stock</nom> <version>1.0</version> <prefixe>alertstock</prefixe> <type>classique</type> <auteur>Yoan De Macedo - yoan@octolys.fr</auteur> <thelia>1.4.0</thelia> <description>Ce plugin vous avertira par mail lorsque le stock d'un produit sera inférieur à une quantité paramétrée.</description> <rubrique>administration</rubrique> <lien>http://contrib.thelia.fr/spip.php?article53</lien> <documentation>Readme.txt</documentation> <etat>production</etat> <install>http://contrib.thelia.fr/IMG/zip/alertstock.zip</install> </plugin>
Installation
- Le plugin sera installé dans le répertoire client/plugins de l'application Thelia.
- Il pourra être installé de manière autonome depuis l'interface d'administration. Il suffira pour cela de fournir un fichier zip à l'utilisateur. Notre plugin test deviendrait donc test.zip
Autres composants
Le plugin peut être aussi enrichi de plusieurs fichiers selon sa fonction :
- Un fichier Readme.txt qui explique comment l'installer, comment insérer une boucle dans une page...
- Un fichier template (test.html par exemple) qui est ajouté dans le dossier template à la racine, dans le cas d'un plugin qui ajoute une page dans le site.
- Le fichier php (test.php dans notre cas) n'est plus nécessaire depuis la version 1.5.