====== Gestion des plugins (JcDenis : OK) ====== La liste des plugins installés est disponible via le menu de //Gestion de plugins//. ===== Installer un plugin ===== Les plugins étendent les fonctionnalités de Dotclear. Installer un plugin n’est pas compliqué, plusieurs options s’offrent à vous. ==== Installation via l'interface d'administration du blog ==== Pour pouvoir installer un plugin, il est nécessaire de s'identifier avec un compte doté des permissions de superadministrateur. === En utilisant l'installation automatique === Pour cela rendez vous sur la page de //Gestion des plugins// dans l'onglet //Ajouter des plugins// qui affiche la liste des plugins disponibles en installation automatique depuis Dotaddict.org. Vous pouvez soit parcourir l'index des plugins, soit faire une recherche par mots clés. une fois le plugin de vos rêves trouvé, il suffit de cliquer sur Installer et le tour est joué ! === En le téléchargeant depuis votre disque dur === Téléchargez le plugin de votre choix sur votre disque dur. Rendez vous ensuite sur le tableau de bord de l'interface d'administration de votre blog. Cliquez sur l'icône //Getion de plugins// (dans la partie //Système//), et choisissez l'onglet ''Installer ou mettre à jour manuellement''. Dans la zone ''Déposer un fichier zip'' cliquez sur le bouton ''Parcourir'' et sélectionnez le fichier .zip que vous venez de télécharger. Saisissez ensuite votre mot de passe dans le champ prévu puis validez votre choix en cliquant sur le bouton **Envoyer**. === En indiquant une URL de fichier distant === Relevez l'URL du fichier .zip du plugin que vous souhaitez installer. Rendez vous ensuite sur le tableau de bord de l'interface d'administration de votre blog. Cliquez sur l'icône //Gestion de plugins// (dans la partie //Système//), et choisissez l'onglet "Installer ou mettre à jour manuellement". Inscrivez l'URL du .zip dans le champ ''URL du fichier zip à télécharger''. Saisissez ensuite votre mot de passe dans le champ prévu puis validez votre choix en cliquant sur le bouton **Télécharger**. Les installeurs de plugins au format obsolète ''pkg.gz'' ne sont plus pris en charge par le gestionnaire de plugins de Dotclear. ==== Installation manuelle ==== Certains hébergeurs ne permettent pas l’installation automatique. Vous devrez alors télécharger l'archive du plugin (au format ''.zip'') sur votre disque dur. Puis décompressez et transférez le répertoire obtenu sur votre serveur dans le répertoire ''plugins'' de votre installation Dotclear Dans l’interface d'administration de votre blog, votre nouveau plugin doit maintenant figurer dans la liste des //Plugins installés// de la page de //Gestion des plugins//. Après avoir installé un nouveau plugin, repassez systématiquement par la page du tableau de bord. Nombre de plugins ont besoin que cette étape soit effectuée pour être activés. ===== Configuration des plugins ===== La gestion et la configuration des plugins depuis l’administration du blog est très variable et dépend en grande partie des fonctionnalités apportées par le plugin : * Les plugins les plus paramétrables auront un lien à leur nom dans la colonne de gauche, généralement dans la zone du bas, sous le titre //Plugins//. * Certains, réservés aux administrateurs, utilisent la page dédié de configuration dans la //Gestion des plugins//, pour cela dans leurs informations détaillées un lien conduira à leur configuration. * Certains ne proposent que quelques options qui sont activables dans les //Paramètres du blog//. * Les plugins du type widget sont accessibles par le lien //Widgets de présentation//, où vous les trouverez parmi les ''Widget disponibles'', d’où vous pourrez les faire glisser vers l’une ou l’autre partie de la barre de navigation et accéder aux éventuels réglages de leur affichage. * D’autres encore peuvent ne posséder ni lien dédié ni widget, reportez-vous alors à la documentation (sur le site de l’auteur) pour faire fonctionner correctement l'extension. Il peut arriver qu'un plugin réclame l'insertion ou la modification de code dans certains fichiers du thème (le plus souvent _head.html). Pour modifier ces fichiers, vous avez deux possibilités : * Utilisez un client FTP pour télécharger le fichier en question depuis le répertoire ''tpl'' de votre thème actuel (''themes/nomdutheme''). Si le fichier de n'y trouve pas, ce qui est très probable, téléchargez celui du thème par défaut (situé dans ''themes/default''). Puis, modifiez-le et déposez cette nouvelle version dans le répertoire ''tpl'' de //votre// thème. * Accédez aux **Paramètres des thèmes** via le Tableau de bord et cliquez sur le bouton **Éditeur de thème** après avoir sélectionné votre thème actuel dans la galerie. Cliquez sur le nom du fichier à modifier, faites les changements nécessaires et cliquez sur **Enregistrer**. ===== Désactivation d'un plugin ===== Dans certains cas il peut être nécessaire de désactiver un plugin. (Par exemple si il pose problème lors d'une mise à jour, si on ne sent sert pas, etc...) Pour cela sur la page de //Gestion des plugins// dans la liste des //plugins installés// un bouton permet d'un clic de désactivé un plugin. Un plugin désactivé n'est pas supprimé mais Dotclear n'en tiendra pas compte et ne l'utilisera pas. Si des plugins sont désactivés, ils seront listés en dessous de ceux installés, un bouton permet de les réactiver. ===== Suppression d'un plugin ===== Pour supprimer définitivement un plugin, enlevez d’abord : * les modifications éventuelles sur les fichiers du thème ; * les widgets liés à l'extension ; * les fichiers créés par l’administration de l'extension (s’il possède son propre lien dans l’administration du blog). Puis, reportez-vous au lien //Gestion des plugins// de l’administration, et dans la liste des //Plugins installés//, cliquez sur le bouton **Supprimer** correspondant au plugin. Si cela n’a pas d’effet, votre hébergeur ne permet pas cette opération automatique (c’est par exemple le cas de Free), ou si vous ne pouvez plus vous connecter à l'administration de Dotclear, vous serez obligés d'effectuer une désinstallation manuelle. Vous devrez alors supprimer par FTP le dossier du plugin en question dans le dossier ''plugins'' de votre installation Dotclear (par défaut les plugins sont installés dans le répertoire ''/dotclear/plugins/''). ===== Mettre à jour un plugins ===== Vous pouvez mettre à jour des plugins depuis la page de //Gestion des plugins// accessible à partir du menu //Système//. === Via la mise à jour automatique === Si des plugins disposent d'un mise à jour, un onglet apparait en premier et vous prévient automatiquement en listant ces plugins et leurs versions, il vous suffit ensuite de choisir ceux que vous souhaitez mettre à jour d'un simple clic. Le cas échéant, si vous avez placé sur votre tableau de bords l'icône de //Gestion des plugins//, l'icône et son texte changeront en indiquant le nombre de mises à jour disponibles, il vous suffit alors de suivre le lien pour voir la liste de ces plugins. === Via l'installation manuelle === Dans l'onglet //Installer ou mettre à jour manuellement// il suffit de procéder de la même manière que pour une installation. Dotclear reconnaît qu'il s'agit d'une version plus récente et fait automatiquement la mise à jour. Chez certains hébergeurs (Free par exemple), la mise à jour automatique n'est pas possible, la suppression n'étant pas permise (voir ci-dessus). Il faut donc passer par le ftp pour remplacer le dossier de l'extension par la nouvelle version, après avoir décompressé en local le fichier zip la contenant, dans le dossier ''plugins'' de votre installation Dotclear (comme indiqué ci-dessus). * [[http://abc.dotaddict.org/fiche/Installer-un-plugin-avec-daInstaller |Installer un plugin avec daInstaller (ABC)]]