J3.x:Creating a simple module/Adding Auto Update/fr

Joomla! 

3.x

Didacticiel

Création d'un module simple

Les articles de cette série

• Introduction
• Développement d'un module de base
• Utilisation de la base de données
• Ajouter des champs de formulaire
• Ajout d'une mise à jour automatisée
• Ajout d'un fichier script installation/désinstallation/mise à jour

Ceci est une série de plusieurs articles expliquant la façon de développer un module pour Joomla! Version . Vous pouvez naviguer dans les articles de cette série à l'aide du menu déroulant.

Commencez par l'Introduction puis naviguez dans les articles de cette série en utilisant soit les boutons de navigation situés en bas des articles, soit le menu droit (Les articles de cette série).

Cette section du didacticiel a pour vocation de vous aider à créer un serveur de mise à jour pour que votre module puisse utiliser le système de mise à jour en un clic de Joomla.

Introduction

Tout d'abord, veuillez lire le didacticiel sur la gestion des mises à niveau des composants avec Joomla! 2.5 - Partie 1 pour vous donner une idée du fonctionnement du processus de mise à jour dans Joomla. Même si ce didacticiel a été écrit pour la version 2.5, le processus n'a pas changé pour Joomla 3.x. Consultez également Déployer un serveur de mise à jour (ce que nous allons mettre en oeuvre dans ce didacticiel)..

Vous souvenez-vous du fichier sql de mise à jour dont nous avons parlé dans la section Utilisation de la base de données ? Il sera à nouveau utilisé pour mettre à jour notre base de données. Mais une nouvelle version compressée de notre module sera utilisée pour mettre à jour tous les fichiers PHP. Pour faire simple pour l'instant, nous allons mettre à jour les fichiers et la base de données sql sans vérifier la version de Joomla! ni la version du module actuellement installé (mais cela est bien sur recommandé pour un module en production).

Mise à jour de notre module

La seule façon de mettre à jour notre module est d'ajouter un serveur de mise à jour au fichier XML.

<updateservers>
	<server type="extension" name="Helloworld" priority="1">http://www.example.com/helloworld_update.xml</server>
</updateservers>

Joomla! va maintenant rechercher http://www.example.com/helloworld_update.xml pour les mises à jour avec une fréquence définie dans les options du gestionnaire des extensions.

Créer une mise à jour

Maintenant que Joomla! est à même de rechercher les mises à jour de notre extension, créons-en une afin de tester notre processus.

Créez une copie de votre module actuel. Puis mettons à jour le numéro de version en 1.0.1 et nous allons également ajouter un élément à notre fichier SQL de mise à jour (dans notre cas, un fichier de langue additionnel pour l'allemand).

<version>1.0.1</version>

INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Hallo Welt', 'de-DE');

Nous pouvons également modifier n'importe le quel de nos fichiers PHP - tous les fichiers PHP existants seront remplacés par ceux présents dans notre fichier de mise à jour (Remarque : c'est la raison pour laquelle le piratage des fichiers natifs d'une extension est déconseillée, car ces modifications seront perdues lors de la mise à jour de l'extension) .

Nous devons maintenant créer le fichier XML sur http://www.example.com/helloworld_update.xml pour faire savoir à Joomla! qu'une mise à jour est disponible.

<updates>
	<update>
		<name>Helloworld</name>
		<description>This is mod_helloworld 1.0.1</description>
		<element>mod_helloworld</element>
		<type>module</type>
		<version>1.0.1</version>
		<downloads>
			<downloadurl type="full" format="zip">http://www.example.com/mod_helloworld_101.zip</downloadurl>
		</downloads>
		<maintainer>Joomla</maintainer>
		<maintainerurl>http://www.example.com</maintainerurl>
		<targetplatform name="joomla" version="3.1"/>
		<client>site</client>
	</update>
</updates>

Dans notre exemple, http://www.example.com/mod_helloworld_101.zip est le dossier zip de notre mise à jour nouvellement créée. SI vous vous connectez au backend de Joomla, vous devriez voir dans le panneau d'administration qu'une mise à jour est disponible (si ce n'est pas le cas, purgez votre cache dans le menu 'Mise à jour' du gestionnaire des extensions). Il vous suffit de cliquer sur mettre à jour et vous verrez que votre module aura été mis à jour vers la version 1.0.1.

Commercial Modules

Note that in our files we have linked to the extensions updates xml file. And from that xml file we have a location for the zip of the module. This means that if someone were to track this backwards they could find the physical source of your modules zip file (and make it available/use it after a subscription has expired etc.). For this reason generally commercial modules do not contain automatic updates (although they often will inform you of updates in some alternative way).

Conclusion

Updating modules in Joomla is really easy for both users and the extension developers to perform and should be expected as standard with any module since Joomla! 3.1.

Préc. : Ajout de champs de formulaire

Suiv. : Ajout d'un fichier script installation-désinstallation-mise à jour