Développer des plugins et des thèmes contre WordPress Trunk

Lors du développement de plugins ou de thèmes pour WordPress, l’une des stratégies que je recommande souvent est de le faire contre le tronc (ou l’instantané actuel du code) de WordPress.

Pour ceux qui sont des développeurs plus expérimentés, vous êtes déjà au courant du jargon et des mises en garde qui en découlent. Mais si vous êtes quelqu’un qui cherche des moyens d’améliorer ses pratiques de développement, cela vous aidera peut-être.

N’oubliez pas que WordPress étant un logiciel open source, vous pouvez afficher le code source sur le Web à tout moment.

Non seulement cela, mais vous pouvez également le télécharger sur votre ordinateur local et travailler avec lui. Cela nécessitera certains logiciels, et j’y reviendrai dans un instant; cependant, le but ultime de cet article est de parler de :

• comment travailler avec l’instantané de code actuel avec WordPress,
• comment et pourquoi il peut être avantageux d’utiliser cette base de code lorsque vous travaillez sur des projets pour d’autres.

Comme indiqué ci-dessus, il y a des mises en garde pour cela, et parfois c’est une bonne idée d’utiliser la dernière version stable de la base de code. Et j’aborderai cela plus tard dans l’article également.

Développer avec WordPress Trunk

Avant de commencer, il est important d’avoir installé Subversion ou un client Subversion. Si vous utilisez un gestionnaire de packages comme Homebrew pour gérer les logiciels, l’installation du client en ligne de commande est aussi simple que de saisir ceci dans votre terminal :

$ brew install subversion

Vous pouvez en savoir plus sur Homebrew et les gestionnaires de paquets dans les articles précédents ; cependant, vous pouvez également chercher à utiliser quelque chose comme Versions ou Cornerstone si vous cherchez à utiliser un frontal.

1 Téléchargez le dernier code

À ce stade, vous pouvez télécharger le dernier instantané de la base de code WordPress en utilisant cette commande :

$ svn co https://core.svn.wordpress.org/trunk/ .

Si, en revanche, vous utilisez un frontal, vous pouvez utiliser l’URL suivante dans le client de votre choix pour parcourir le référentiel :

https://core.svn.wordpress.org/trunk

À partir de là, téléchargez le contenu du répertoire du tronc sur votre ordinateur et préparez-vous à l’installer sur votre ordinateur.

Ou en utilisant le front-end de votre choix :

Pour ce faire, assurez-vous d’avoir préparé une base de données, puis suivez la procédure d’installation standard.

Vous pouvez lire comment faire cela dans le Codex ou dans ce post.

2 Configurer le mode de débogage

Une fois installé, je vous recommande de configurer WordPress en mode débogage afin que vous puissiez voir les informations dans les journaux de débogage ainsi que dans votre navigateur.

Pour ce faire, ouvrez wp-config.php et modifiez la ligne qui se lit comme suit :

define( 'WP_DEBUG', false );

Lire:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );
define( 'SCRIPT_DEBUG', true );

À partir de ce moment, chaque fois que vous travaillez avec du code, vous verrez des informations imprimées à l’écran et vous aurez des informations écrites dans debug.log que vous pourrez afficher dans votre éditeur de texte ou console préféré.

Cela ne signifie pas que vous ne devriez pas avoir un outil tel que Xdebug installé, mais c’est le contenu d’ un autre article.

3 Travailler avec les répertoires appropriés

Maintenant que WordPress est installé et que vous êtes prêt à travailler sur votre projet, notez si vous travaillez ou non avec des plugins ou des thèmes. Naturellement, vous trouverez chacun dans wp-content/plugins ou wp-content/themes.

Disons, par exemple, que vous travaillez sur un plugin alors vous allez garder votre plugin dans le répertoire des plugins. Dans mon cas, comme vous le voyez dans la capture d’écran ci-dessus, je travaille avec le raccourci de publication planifiée contre le tronc.

Un mot sur les versions stables

Chaque fois que vous travaillez avec un plugin ou un thème, et que vous allez essayer de travailler avec eux contre une version stable de WordPress, vous avez un choix à faire :

• fonctionnent avec la version stable du code disponible sur WordPress.org,
• travailler contre l’instantané du code dans le tronc.

Si vous utilisez le premier, vous savez que votre code fonctionnera avec la dernière version stable. Mais si vous choisissez de travailler avec ce dernier, vous savez que votre code fonctionnera avec la prochaine version de WordPress.

Mais voici la mise en garde : les choses peuvent changer entre ce qui est dans le coffre et ce qui est finalement publié. Donc, si vous allez travailler avec le tronc, n’oubliez pas que vous devrez continuer à tester votre travail par rapport au code jusqu’à ce que l’équipe de base marque le tronc comme une version stable.

En revanche, dès qu’ils le feront, vous aurez une version de travail de votre projet prête à l’emploi lorsqu’ils expédieront WordPress.