Lire une page de paquet

L’en-tête

Le haut de chaque page de paquet nomme le paquet (1) et son créateur, et donne son nom Composer (2) avec la dernière version. À droite :

• Suivre (3) : soyez prévenu des nouvelles versions ou des avis de sécurité (Étoiles, listes et suivi).
• Ajouter une étoile (4) : enregistrez-le dans l’une de vos listes ; la flèche à côté choisit les listes (Étoiles, listes et suivi).
• Installer (5) : les commandes Composer et le téléchargement ZIP (Installer des paquets avec Composer).

Sous l’en-tête, les onglets (6) permettent de passer d’une vue du paquet à l’autre.

Versions

Le premier onglet répertorie chaque version publiée, de la plus récente à la plus ancienne, avec la ligne de note de version tirée du journal des modifications de l’éditeur.

1. La version la plus récente porte Dernière (1) ; les préversions portent Préversion, et une version retirée Retirée.
2. Vérifié (2) signifie que la version a passé tous les contrôles avant sa publication ; le libellé renvoie vers l’onglet Sécurité.
3. Le SHA-256 du ZIP (3) se copie en un clic, pour le comparer avec ce que Composer a téléchargé.
4. zip (4) télécharge cette version (avec l’accès au dépôt).
5. Afficher n versions plus anciennes (5) déplie le reste de la liste.
6. Afficher n versions pas encore disponibles (6) répertorie les publications annoncées par l’éditeur que le dépôt n’a pas encore.

Une fois connecté, vous pouvez aussi marquer des versions d’une étoile, n’afficher que celles-ci et passer d’une liste détaillée à une liste simple (Versions marquées d’une étoile).

Sous la liste, le fichier lisez-moi décrit le paquet, ce qu’il ajoute à WordPress (blocs, shortcodes, commandes WP-CLI …), comment l’installer et sa licence.

Versions pas encore disponibles

Les publications citées dans le journal des modifications de l’éditeur ou sur WordPress.org, mais absentes du dépôt, affichent Pas encore disponible (1), avec leur date de publication et un lien vers l’Entrée du journal des modifications (2) ou vers WordPress.org. Elles deviennent installables lorsque le dépôt les reçoit et les contrôle. Suivez le paquet pour en être prévenu.

Journal des modifications

L’onglet Journal des modifications affiche le journal des modifications de l’éditeur par publication. Recherchez-y, filtrez par type de modification (Nouveau, Amélioré, Corrigé, Sécurité, Supprimé), par année ou par disponibilité (toutes les publications, dans le dépôt, pas encore disponibles). CHANGELOG.md fournit le même contenu sous forme de fichier Markdown.

Fichiers

L’onglet Fichiers (pour les comptes connectés) affiche les fichiers de la dernière version sous forme d’arborescence, avec leur taille et la version dans laquelle chacun a changé pour la dernière fois, les langages dans lesquels le code est écrit et les dossiers les plus volumineux.

Sécurité

L’onglet Sécurité montre comment chaque version a été contrôlée avant sa publication : l’analyse des logiciels malveillants, les règles de motifs, l’analyse PHP, l’intégrité de la licence, la syntaxe PHP et la politique des ressources, avec les résultats par version, la politique de sécurité et les vulnérabilités connues (Contrôle des paquets et demandes de retrait).

Statistiques

L’onglet Statistiques contient les statistiques du paquet : étoiles, personnes qui le suivent, téléchargements et rapports d’installation, pages vues, fréquence de sortie des nouvelles versions, modifications du code par publication, évolution de la taille et, pour les paquets également présents sur WordPress.org, leurs chiffres sur ce site.

La barre latérale

À droite de l’onglet Versions :

• Votre licence (1) : la clé de licence de votre coffre pour ce paquet, ou un lien pour l’ajouter (Licences et coffre de clés de licence).
• Activité (2) : étoiles, personnes qui le suivent, téléchargements et versions, avec des liens vers Statistiques et vers la manière dont il a été analysé.
• Acheter une licence auprès de l’éditeur (3) : le support et les mises à jour dans WordPress viennent avec la licence de l’éditeur.

Plus bas : les prérequis (PHP, WordPress, WooCommerce …), les contributeurs, les langues, les chiffres de WordPress.org, le flux des versions (Atom), la page au format Markdown et Signaler ce paquet.