[Partage] Plugins Schema pour Joomla 5.03

[ManuelVoileux]

Bonjour tout le monde ,
j'ai préparé 6 plugins Schéma pour Joomla : Article, NewsArticle, Videoobject, Recipe, FAQPage, et Product. ils sont en Français et en anglais, et vous pouvez les télécharger à l'adresse https://joom.voileux.org/fr/pluginsschema.html
Je les ai testé sur l'outil de validation Schema, et sur l'outil de validation Google, plus chatouilleux.
Je voudrais remercier daneel qui m'a mis le pied à l'étrier en partageant un plugin "Scholarly-Article" sur le forum.

J'en profite pour remercier toute la communauté Joomla Fr qui m'a beaucoup aidé, et m'a permis de progresser. J'ai utilisé des logos de vos sites sur https://joom.voileux.org/fr/joomla.html Dites moi si ce n'est pas acceptable. J'enlèverai et je changerai immédiatement.

Je voudrais aussi remercier lomart une fois de plus. UP! m'a donné des ailes j'ai fait des mises en pages que je ne pensais pas possibles pour moi. La page UP! du site n'est pas aussi avancée que souhaitée, mais le printemps arrive et les balades vont reprendre., et je voulais mettre le site en ligne avant de partir.

Vous pouvez voir le dernier site que j'ai commis avec Joomla et Up! pour un ami qui fabrique et vend des pièces imprimées en 3D. https://atelierblb.eu/fr/
j'ai entré tous les articles, et je dois maintenant les référencer avec Schéma Produit.

[daneel]

Bonjour,

Merci pour le partage et avoir pris le temps de créer une présentation en anglais et en français... Bravo !

Je t'invite si ce n'est déjà fait de publier cela au plus vite sur l'annuaire des extensions de Joomla.org ( JED )
Afin d'inaugurer la nouvelle catégorie plugins schema ! Pour l'instant, c'est vide !

https://extensions.joomla.org/category/core-enhancements/schema-plugins/

A partir de Joomla 5.1, cette catégorie sera indiquée en extension des choix proposés dans joomla.org

[woluweb]

Je me demande même si ça ne vaudrait pas la peine de mettre ça dans le noyau, pour J5.2.
J'en parle aux Release Managers

[cavo789]

Lequel des deux ? Le bruxellois ? :-)

[ManuelVoileux]

Bonjour tout le monde , merci beaucoup pour vos encouragements.

[ManuelVoileux]

...
Je t'invite si ce n'est déjà fait de publier cela au plus vite sur l'annuaire des extensions de Joomla.org ( JED )
Afin d'inaugurer la nouvelle catégorie plugins schema ! Pour l'instant, c'est vide !

Je suis allé voir,

la catégorie core-enhancements/ existe, mais je n'ai pas trouvé core-enhancements/schema-plugins/

j'ai commencé à remplir tout le formulaire. Bon je n'ai pas autant de liens de demo, support, download que demandé, mais ça doit pouvoir aller.

Arrivé en bas je suis tombé sur cet os :








- intégration dans Joomla update system : Non

- j'ai téléchargé JEDchecker sur un site de test pour évaluer la compatibilité avec les exigences de JED. Pour l'instant j'ai récupéré beaucoup d'icones rouges, jaunes ou bleu.
en voici une qui me laisse perplexe

L'utilisation de serveurs de mise à jour est maintenant requise par le JED.
#001 /article.xml
Mettre à jour le tag du serveur manquant ou incorrect dans ce fichier XML

- naming convention : le lien aboutit sur une page blanche.http://extensions.joomla.org/support...xtension-names

C'est pas gagné.
A suivre

[daneel]

Bonjour,

Effectivement tu dois gérer les mises à jour automatiques. Cela consiste à définir un fichier xml contenant les liens vers les différentes versions.
L'url de ce fichier xml doit être collé dans le fichier manifeste de ton extension donc de ton plugin.

Certains font cela manuellement, utilise github pour publier sans avoir besoin de site.
D'autres utilisent une extension maison.


Sur Github, tu peux trouver l'exemple d'un auteur qui est aussi sur le forum :



Son extension AutoReadMore-J4 : https://github.com/conseilgouz/AutoReadMore-J4
Il a défini deux fichiers dans son code "plg_autoreadmore_changelog.xml" pour les dernière modifications et "plg_autoreadmore_update.xml" pour le fichier de mise à jour (celui demandé par la JED).

Tu peux voir dans son manifeste xml :

<changelogurl>https://raw.githubusercontent.com/conseilgouz/AutoReadMore-J4/master/plg_autoreadmore_changelog.xml</changelogurl>
<updateservers>
<servers type="extension" priority="1" name="autoreadmore">https://raw.githubusercontent.com/conseilgouz/updates_github/master/plg_autoreadmore_update.xml</servers></updateservers></extension>

​

Les liens pointent vers les versions "raw" donc les fichiers brut sans l'interface web de github.

Donc dans ce cas, tu créé ton compte github et tu publie en définissant un fichier update.xml que tu reprends dans ton plugin sous la forme d'url :

https://raw.githubusercontent.com/conseilgouz/updates_github/master/plg_autoreadmore_update.xml

Autre exemple mais géré sous Joomla :
Nicholas (l'auteur d'akeeba) gère ses extensions via son propre système ARS, c'est une extension qui permet de gérer des fichiers et de gérer les xml.
Seulement, depuis quelques années, Nicholas ne gère plus officiellement le suivi de cette extension ( donc aucun support ) mais il a tout de même continuer à publier le code mais ne demander rien sur ce sujet, il publie pour mettre à disposition et cela s'arrête là. Ce n'est pas pour autant que c'est obsolète, au contraire il vient de mettre à jour pour être compatible avec Joomla 5.1 qui sera publié cet après-midi.

Je te joins justement cette dernière version afin que tu puisse le tester à tes risques et périls !
Je te donnerai également la traduction de l'extension ARS.

[ManuelVoileux]

Merci pour cette réponse très détaillée. Je regarde.

[daneel]

Autre exemple, Lomart propose le téléchargement de son extension UP depuis son site officiel dans le repertoire files :

https://up.lomart.fr/files/plg_content_up-v5.0.2.zip

dans le fichier manifeste up.xml de son extension, il est précisé à la fin :

<updateservers>
<server type="extension" priority="1" name="UP - Universal Plugin">https://up.lomart.fr/files/plg_content_up_update.xml</server>
</updateservers>

​

Cela signifie qu'il propose un fichier xml "plg_content_up_update.xml" dans le même repertoire que l'archive de up (donc la version 5.0.2)

https://up.lomart.fr/files/plg_content_up_update.xml

ce fichier xml contient le code suivant :

<updates>
<update>
<name>UP</name>
<description>UP (Universal Plugin)</description>
<element>up</element>
<type>plugin</type>
<folder>content</folder>
<client>0</client>
<version>5.0.2</version>
<downloads>
<downloadurl type="full" format="zip">https://up.lomart.fr/files/plg_content_up-v5.0.2.zip</downloadurl>
</downloads>
<maintainer>LOMART</maintainer>
<maintainerurl>http://up.lomart.fr</maintainerurl>
<targetplatform name="joomla" version=".*"/>
<sha256>4d1985e13cdde86fa47650ece74502ccfa5be3700a 9fe941af95a3fb19949c09</sha256>
</update>
</updates>​

on peut comprendre la structure avec les différentes balises, le plus dur étant le calcul de l'empreinte numerique/checksum ou somme de contrôle encodé en "sha256"

https://lehollandaisvolant.net/tout/tools/checksum/

Cela veut dire que si la valeur est différente au téléchargement de la version indiqué dans le xml, l'installation de l'extension ne se fera pas car le fichier aura été considéré comme altéré.

Petite parenthèse avec Joomla 5.1 qui ajoute une couche de sécurité pour les mises à jour core avec TUF qui utilise des clés de lecture/ecriture.
(heureusement, cela ne concerne pas les extensions (pour l'instant).

[ManuelVoileux]

Bonjour , la méthode de LOMART me plait bien. Je ne suis pas mûr pour aller jouer avec Github. L'extension de Nicholas doit être parfaite, mais c'est un saut dans l'inconnu (pour moi)
dans le fichier blabla...update.xml, que doivent contenir les éléments ci dessous ?
<element>up</element> ??? le nom de l'extension en minuscule, le nom du répertoire sur le serveur ? le nom du répertoire sur le site joomla ?
<folder>content</folder> ??? le répertoire sur le site joomla ? parce que up est un plugin de content ? ou cela n'a rien à voir ?
<client>0</client> ça je vais bêtement copié collé

Merci pour votre aide

[daneel]

Je ne sais pas si tu as déjà consulté mais voici la documentation officielle :

https://docs.joomla.org/Deploying_an_Update_Server/fr

element - le nom de l'extension installée (obligatoire). Pour les plugins, ce doit être le même que la valeur de l'attribut du plugin dans le manifest du fichier principal du plugin. Pour <filename plugin="nomduplugin">nomduplugin.php</filename>, la valeur de l'élément doit être nomduplugin.

folder (dossier) - spécifique aux plugins, cette balise décrit le type du plugin mis à jour (contenu, système, etc.) (obligatoire pour les plugins).

client – Le client de l'extension. Requis pour les modules et modèles de site depuis la version 3.2.0. – Les valeurs possibles actuellement sont "site" ou "administrator". Attention ! Les plugins et les modules du site public sont automatiquement installés avec le client à 0 (site), mais vous devez tout de même indiquer le client dans une mise à jour ou il sera mis par défaut à 1 (administrator) et, du coup, la mise à jour trouvée ne sera pas affichée parce qu'elle ne correspondra à aucune extension. Les composants sont automatiquement installés avec un client à "administrator", ce qui est la valeur actuelle par défaut.

• Attention : Concernant Joomla! 4.0 seule une chaîne de caractère est autorisée. L'utilisation de nombres pour le champ client a été déprécié en 2012 et supprimé de Joomla! 4.0 (remplacer "0" par "site" et "1" par "administrator").

Edit : Pour ce qui est du "folder", il s'agit du dossier dans lequel le plugin sera installé, ce qui correspond effectivement au type mais physiquement il s'agit du sous-repertoire de plugins. Dans le cas de tes plugins, c'est donc "schemaorg"

[ManuelVoileux]

on peut comprendre la structure avec les différentes balises, le plus dur étant le calcul de l'empreinte numerique/checksum ou somme de contrôle encodé en "sha256"
Cela veut dire que si la valeur est différente au téléchargement de la version indiqué dans le xml, l'installation de l'extension ne se fera pas car le fichier aura été considéré comme altéré.

Bonjour, j'avance pas à pas.
Pour quel fichier doit on indiquer la valeur de sha256 ? le zip téléchargé ?

[lomart]

Bonsoir Manuel

Félicitations pour ton plongeon dans le grand bain
Pour récupérer la clé sha256, j'utilise le programme https://www.7-zip.org/
Le parcours en image

https://postimg.cc/z3fj2TS9

[daneel]

Bonjour, j'avance pas à pas.
Pour quel fichier doit on indiquer la valeur de sha256 ? le zip téléchargé ?

oui c'est bien l'archive en téléchargement comme le montre lomart (merci Loïc pour ton intervention !)

Effectivement 7zip et d'autres logiciels proposent d'afficher la valeur :

https://thewindowsclub.blog/fr/how-to-verify-md5-sha-1-and-sha-256-checksum-in-windows/

[ManuelVoileux]

Merci à vous. Je vais essayer et rester là ou j'ai pied