Utiliser Git avec WordPress : Un guide pas à pas

Partager ses créations, c’est ce qui donne vie à l’art, et il en va de même pour les développeurs WordPress. Lorsque vous avez créé quelque chose de nouveau ou de passionnant pour la plateforme, il est tout à fait naturel de vouloir le partager avec l’ensemble de la communauté WordPress. Peut-être pensez-vous même à héberger votre code personnalisé gratuitement. Si vous vous reconnaissez dans cette idée, l’utilisation de Git avec WordPress pourrait vous convenir parfaitement.

Git et GitHub travaillent ensemble pour fournir une solution puissante pour le contrôle de version et la gestion de votre base de code. Ils vous permettent d’héberger votre travail et d’inviter d’autres développeurs à examiner et à modifier votre code. De plus, avec les pages GitHub, vous pouvez bénéficier d’un hébergement gratuit si vous déployez un site WordPress statique.

Dans ce guide, nous allons vous montrer comment utiliser GitHub pour gérer vos thèmes et plugins WordPress. Vous découvrirez également comment utiliser un générateur de site statique WordPress pour déployer vos projets sur des pages GitHub, sans dépenser un centime.

Qu’est-ce que Git ?

Git, abréviation de « global information tracker », est un système de contrôle de version distribué conçu pour vous aider à suivre les modifications apportées aux projets de codage ou aux fichiers. Ces projets sont stockés dans un « dépôt » (repo en abrégé), qui est essentiellement un dossier parent que Git utilise pour organiser tous les fichiers qu’il gère.

Git est un outil indispensable pour les développeurs qui travaillent sur divers projets logiciels. L’un de ses principaux avantages est que plusieurs personnes peuvent créer leurs propres clones du dépôt principal, qui contient le code original. Elles peuvent alors effectuer des modifications sur leur propre machine locale sans modifier directement le dépôt principal.

Une fois que les modifications sont prêtes à être mises en ligne, les utilisateurs les téléchargent sur un service tel que GitHub, qui permet d’organiser les dépôts de l’équipe et de les rendre accessibles.

Git vs. GitHub

Une question fréquente, surtout pour les débutants, est la suivante : quelle est la différence entre Git et GitHub?

De nombreux nouveaux développeurs ou propriétaires de sites pensent que Git et GitHub sont identiques, mais il s’agit en fait d’outils différents. Git est le système de contrôle de version, qui permet de suivre les modifications apportées au code et de les organiser dans des référentiels. En revanche, GitHub est une plateforme d’hébergement web qui stocke les dépôts Git et les rend facilement accessibles aux équipes.

Alors que vous pouvez utiliser Git seul, en gérant tout localement, GitHub nécessite Git pour fonctionner. GitHub se distingue également des autres plateformes d’hébergement Git telles que Launchpad, Assembla et Bitbucket par ses fonctionnalités supplémentaires, particulièrement utiles pour les entreprises et les équipes à distance. Son interface conviviale et ses outils de collaboration simplifient grandement le travail sur les projets partagés.

De plus, avec GitHub, tout est stocké en toute sécurité dans le nuage, de sorte que même si votre machine locale est endommagée ou perdue, votre code est toujours en sécurité.

Conditions préalables à l’utilisation de Git avec WordPress

Avant de commencer à intégrer Git dans vos projets WordPress, il est essentiel de s’assurer que vous avez les outils nécessaires et les connaissances de base. Voici ce dont vous aurez besoin :

Connaissance de base de la ligne de commande

Une bonne connaissance des interfaces de ligne de commande (CLI) comme Terminal sur macOS/Linux ou Command Prompt/PowerShell sur Windows est cruciale. Vous utiliserez des commandes CLI pour interagir avec Git. Vous devez également savoir comment naviguer dans les répertoires (cd), lister les fichiers (ls ou dir) et exécuter des commandes de base.

Git installé sur votre machine locale

Vérifiez si Git est installé en exécutant le fichier git --version dans votre ligne de commande. S’il n’est pas disponible, vous pouvez le télécharger depuis le site officiel de Git. S’il n’a pas encore été installé, suivez les instructions d’installation de votre système d’exploitation.

Installation locale de WordPress

Créez un environnement de serveur local avec MAMP, XAMPP, WampServer ou Local WP. Ensuite, installez WordPress localement pour disposer d’un terrain d’essai sûr pour votre travail de développement.

Compte GitHub

Créez un compte gratuit sur GitHub et apprenez à créer des dépôts GitHub, à livrer des modifications et à naviguer dans l’interface GitHub.

Éditeur de texte ou IDE

Vous pouvez utiliser un éditeur de texte comme Visual Studio Code, Sublime Text ou un environnement de développement intégré (IDE) comme PhpStorm pour coder.

Compréhension de base de la structure des fichiers WordPress

Vous devez savoir où se trouvent les thèmes(wp-content/themes/) et les plugins(wp-content/plugins/) dans le répertoire WordPress. La compréhension de base du rôle des fichiers principaux de WordPress permettra d’éviter des modifications involontaires.

Bien que les compétences en programmation ne soient pas obligatoires pour le contrôle de version, une bonne connaissance de PHP et des pratiques de développement de WordPress vous aidera à apporter des contributions significatives à vos projets.

Avantages de l’utilisation de Git et GitHub avec WordPress

Si vous travaillez sur le développement de WordPress, vous avez probablement été confronté à la frustration de gérer différentes versions de votre thème ou de votre plugin. Peut-être avez-vous fait des mises à jour et voulez-vous garder une trace des changements, ou peut-être avez-vous collaboré avec d’autres personnes et avez-vous besoin d’une méthode simplifiée pour gérer les contributions. C’est là que Git et GitHub deviennent utiles :

• Contrôle de version: Git vous permet de suivre les modifications apportées à vos fichiers, de conserver un historique des modifications, de revenir facilement aux versions précédentes et de collaborer sans chaos.
• Sécurité des sauvegardes: GitHub sauvegarde en toute sécurité votre code à plusieurs endroits, de sorte que vous n’avez pas à vous soucier de perdre des données importantes.
• Un partage sans effort: Le partage de votre code avec d’autres personnes devient facile, que vous travailliez sur des projets open-source ou que vous collaboriez avec une équipe privée.
• Collaboration fluide au sein de l’équipe: GitHub simplifie le travail en équipe, en permettant à plusieurs développeurs de contribuer de manière transparente à un même projet.
• Créez des liens: Collaborer sur GitHub permet de nouer des relations avec d’autres développeurs et d’élargir son réseau professionnel.
• Améliorez votre profil: GitHub n’est pas seulement une solution de stockage, c’est aussi un excellent moyen de présenter votre travail et de construire un profil professionnel que les autres peuvent consulter.
• Flux de développement professionnel: L’utilisation de Git et de GitHub rend la gestion du flux de développement de WordPress à la fois plus facile et plus professionnelle.

Comment utiliser Git et GitHub pour le développement de WordPress

Git et GitHub sont des outils inestimables pour le développement de thèmes et de plugins WordPress. Que vous travailliez à la création d’un nouveau thème ou à la personnalisation d’un thème existant, GitHub offre une plateforme idéale pour gérer la base de code de votre projet.

Par exemple, lorsque vous développez un thème personnalisé pour votre site, vous pouvez récupérer le dépôt de thème sur GitHub, apporter vos modifications et le tester sur un serveur local. Une fois que vous êtes satisfait des mises à jour, vous poussez le dépôt mis à jour sur GitHub, puis vous appliquez ces modifications au site web WordPress en ligne.

Le même flux de travail s’applique au développement de plugins. Si vous êtes un développeur WordPress et que vous créez un plugin, GitHub vous aide à gérer efficacement la base de code. C’est particulièrement utile pour les projets open-source, où d’autres développeurs peuvent contribuer en corrigeant des bogues ou en améliorant des fonctionnalités. Vous pouvez télécharger les fichiers du plugin depuis GitHub, les améliorer et partager votre travail avec la communauté.

Outre la gestion du développement, GitHub peut également être utilisé pour télécharger et installer des plugins et des thèmes WordPress sur votre site web. Toutefois, il convient de noter que si GitHub permet de stocker et de télécharger des fichiers, il n’est pas destiné à servir de lieu de stockage de fichiers comme Dropbox ou Google Drive.

Mise en place d’un environnement WordPress local pour Git

Avant de se plonger dans Git et GitHub, la meilleure pratique consiste à créer un environnement WordPress local. C’est là que vous pouvez travailler en toute sécurité sur votre projet, apporter des modifications, tester votre nouveau code et développer des plugins ou des thèmes sans affecter votre site web en direct. Si quelque chose ne va pas, vous pouvez facilement déboguer et corriger le code dans votre environnement local avant de le déployer en direct.

Pour mettre en place un environnement local, vous aurez besoin d’un logiciel qui vous permet d’héberger un site WordPress directement sur votre ordinateur, au lieu d’un serveur live ou d’un serveur d’essai. Des outils comme Local WP (anciennement connu sous le nom de Local by Flywheel), MAMP, XAMPP et WampServer sont tous d’excellents choix pour créer des environnements locaux. Ils sont gratuits, conviviaux et simples à configurer.

Installation locale de Git et création d’un dépôt Git

Une fois que votre environnement WordPress local est prêt, l’étape suivante consiste à installer Git sur votre ordinateur. Cependant, avant de se lancer dans l’installation, il est préférable de vérifier si Git a déjà été installé. Si vous utilisez un appareil macOS ou Linux, il y a de fortes chances que Git soit préinstallé.

Pour vérifier, ouvrez le Terminal (sur Mac ou Linux) et tapez la commande :

git --version

Sous Windows, vous pouvez vérifier en ouvrant l’invite de commande et en entrant la même commande :

git --version

Si Git est déjà installé, son numéro de version s’affiche. Si ce n’est pas le cas, vous ne verrez rien ou vous obtiendrez un message d’erreur indiquant que la commande est inconnue. Dans ce cas, vous devrez installer Git manuellement.

Pour installer Git, procédez comme suit :

• Allez sur le site web de Git.
• Naviguez jusqu’à la zone des téléchargements.

• Choisissez le lien de téléchargement approprié en fonction de votre système d’exploitation (Mac, Windows ou Linux/Unix).

• Lancer l’assistant d’installation après le téléchargement.
• Pour terminer l’installation, cliquez sur Suivant et suivez les instructions à l’écran.
• Pour s’assurer que Git a été installé correctement, redémarrez votre terminal ou votre invite de commande après l’installation et tapez la commande suivante :

git --version

Maintenant que Git est opérationnel, il est temps de créer un dépôt Git local. Ce dépôt vous permettra de valider les modifications apportées à vos fichiers WordPress avant de les envoyer sur GitHub.

Voici comment créer un dépôt local :

• Naviguez vers les fichiers de votre site WordPress local sur votre ordinateur.
• Allez dans le dossier wp-content et trouvez le dossier du plugin ou du thème sur lequel vous travaillez.

• Faites un clic droit n’importe où dans le dossier WordPress et sélectionnez Open Git Bash Here (ou ouvrez Git manuellement si vous êtes sur Mac/Linux).
• Dans le terminal, tapez la commande suivante pour initialiser un nouveau dépôt Git :

git init

• Ensuite, pour mettre en scène tous les fichiers pour votre premier commit, exécutez cette commande :

git add .

• Il est maintenant temps de valider vos modifications. Vous pouvez ajouter un message de validation pour expliquer les changements que vous avez effectués :

git commit -m "your message here"

Veillez à remplacer « votre message ici » par une note pertinente sur les mises à jour que vous avez effectuées. Appuyez sur Entrée pour terminer la validation.

Après cela, un dossier .git caché apparaîtra dans vos fichiers de thème ou de plugin WordPress locaux, indiquant que votre dépôt est configuré et prêt pour le contrôle de version.

Création d’un dépôt GitHub et validation des modifications

L’étape suivante consiste à créer un dépôt sur GitHub pour héberger votre projet après avoir configuré Git localement. Voici comment procéder :

• Visitez le site web de GitHub et créez un compte gratuit. Après avoir saisi votre adresse électronique, cliquez sur le bouton S’inscrire de GitHub.

• Sur l’écran suivant, vous devez indiquer vos coordonnées, telles que votre nom d’utilisateur GitHub, votre mot de passe et vos préférences en matière d’e-mail. GitHub vous demandera également de résoudre une énigme rapide pour vérifier votre compte, similaire à reCAPTCHA.
• Une fois votre compte créé, vous accédez au tableau de bord de GitHub. Recherchez l’icône « + » en haut à droite, cliquez dessus et sélectionnez Nouveau dépôt.

Maintenant que vous créez un nouveau dépôt, voici ce qu’il faut faire :

• Entrez un nom pour votre nouveau dépôt. Vous pouvez également ajouter une description facultative.
• Choisissez si vous souhaitez rendre votre dépôt public ou le garder privé.
• Faites défiler vers le bas et vous verrez d’autres options, telles que l’ajout d’un fichier README (qui est idéal pour la documentation) et la sélection d’une licence pour votre projet.
• Une fois que vous avez rempli tous les détails, cliquez sur le bouton Créer un dépôt.

Vous obtiendrez une URL après la création du dépôt. Ce lien connectera votre dépôt local à celui que vous venez de créer sur GitHub. Vous trouverez l’URL dans la section Configuration rapide.

Pour lier votre dépôt local au dépôt GitHub, ouvrez Git Bash et exécutez la commande suivante, en remplaçant l’URL par le lien de votre dépôt GitHub :

git remote add origin URL

Ensuite, poussez vos fichiers locaux sur GitHub en tapant la commande suivante :

git push -u origin main

Si votre compte GitHub n’est pas encore lié à Git, vous serez invité à vous connecter et à autoriser la connexion. Une fois cette opération effectuée, vos fichiers locaux seront téléchargés sur GitHub, où ils pourront être consultés par d’autres personnes et faire l’objet d’une collaboration.

À ce stade, votre dépôt sur GitHub affichera les fichiers que vous avez modifiés localement. D’autres développeurs peuvent maintenant forker, cloner ou contribuer à votre projet. Si quelqu’un met à jour le dépôt, vous pouvez récupérer les dernières modifications dans votre environnement local en exécutant la commande suivante dans Git Bash (en remplaçant l’URL par le lien du dépôt GitHub) :

git fetch URL

Cela garantit que votre environnement local reste synchronisé avec les dernières mises à jour de GitHub. Une fois que vous êtes satisfait de vos modifications, vous pouvez les transférer sur votre site WordPress.

Déployer des thèmes et des plugins GitHub sur un site WordPress actif

Après avoir terminé le développement de votre plugin ou thème WordPress, la dernière étape consiste à le déployer sur votre site. Bien que vous puissiez utiliser les commandes Git pour pousser les mises à jour vers WordPress, il existe un moyen plus simple d’utiliser le plugin WP Pusher, qui simplifie ce processus.

Voici comment vous pouvez déployer votre projet en utilisant WP Pusher :

• Rendez-vous sur le site de WP Pusher et cliquez sur le bouton Télécharger. Enregistrez les fichiers du plugin sur votre ordinateur.

• Ensuite, installez et activez le plugin WP Pusher dans WordPress.
• Une fois WP Pusher activé, naviguez vers l’onglet GitHub dans les paramètres de WP Pusher depuis votre tableau de bord WordPress.
• Une fenêtre demandant l’autorisation d’établir une connexion avec votre compte GitHub s’affiche. Cliquez sur Autoriser wppusher et connectez-vous à votre compte GitHub.
• Après s’être connecté, GitHub génère un jeton pour WP Pusher. Copiez ce jeton.
• Dans les paramètres de WP Pusher, collez le jeton dans le champ Jeton GitHub et cliquez sur Enregistrer le jeton GitHub. Cela crée un lien entre votre compte GitHub et le site web de WordPress.

Maintenant que GitHub est connecté, vous pouvez déployer vos thèmes et plugins directement depuis votre dépôt GitHub.

Installer les plugins depuis GitHub :

• Pour installer un plugin, naviguez vers WP Pusher  » Install Plugin dans le panneau d’administration de WordPress.
• Saisissez l’URL du dépôt du plugin ou cliquez sur Pick from GitHub pour sélectionner le plugin à partir de votre compte GitHub.
• Après avoir collé l’URL du dépôt, vous pouvez spécifier des options supplémentaires comme la branche ou le sous-répertoire si nécessaire.
• Faites défiler vers le bas et cliquez sur Installer le plugin pour l’installer sur votre site WordPress.

Activer le plugin :

• Une fois le plugin installé, sélectionnez Plugins > Installed Plugins et cliquez sur le plugin nouvellement ajouté en cliquant sur Activate.
• A ce stade, votre site peut utiliser le plugin puisqu’il est actif.

Installer les thèmes à partir de GitHub :

• Si vous déployez un thème à la place, suivez le même processus sous Install Theme dans le menu WP Pusher.
• Saisissez l’URL du référentiel du thème, complétez les informations nécessaires et cliquez sur Installer le thème.

Avec WP Pusher, la gestion et le déploiement de thèmes et de plugins personnalisés à partir de GitHub deviennent transparents, ce qui vous permet de rationaliser le processus de développement et de vous assurer que votre site WordPress est toujours à jour avec les dernières modifications.

Installer des plugins et des thèmes WordPress à partir de GitHub

En plus d’utiliser Git et GitHub pour le développement, vous pouvez également trouver des plugins et des thèmes qui ne sont plus disponibles dans le dépôt de WordPress.org. De nombreux développeurs WordPress maintiennent leurs plugins et thèmes sur GitHub, ce qui en fait une ressource précieuse lorsque vous ne pouvez pas les trouver dans la bibliothèque officielle.

Voici comment installer des plugins et des thèmes à partir de GitHub :

• Ouvrez GitHub et recherchez le plugin ou le thème que vous souhaitez installer.
• Une fois que vous avez trouvé le dépôt, cliquez sur le bouton Code et sélectionnez Télécharger ZIP. Un fichier ZIP contenant les fichiers du plugin ou du thème sera alors téléchargé sur votre ordinateur.
• Pour installer le plugin ou le thème téléchargé, accédez à votre tableau de bord WordPress. Pour les plugins, naviguez vers Plugins > Ajouter un nouveau plugin et cliquez sur Télécharger un plugin.

• Pour les thèmes, allez dans Apparence > Thèmes et cliquez sur Ajouter nouveau, puis Télécharger. Choisissez le fichier ZIP que vous avez téléchargé et installez-le.

• Après l’installation, activez le plugin ou le thème dans les sections respectives de votre tableau de bord WordPress. Vous pouvez maintenant l’utiliser sur votre site.

Résolution des problèmes courants liés à Git dans les projets WordPress

En tant que nouveau développeur travaillant avec WordPress, vous pouvez rencontrer quelques problèmes courants avec Git. Voici un guide simple pour vous aider à dépanner et à résoudre ces problèmes efficacement.

Fusionner les conflits

Problème : Vous rencontrez des conflits lors de la fusion de branches.

Solution :

• Identifier les conflits : Git indique les fichiers en conflit.
• Modifiez manuellement les fichiers en conflit : Recherchez les marqueurs de conflit (par ex, <<<<<<< TÊTE et >>>>>>>) et les résoudre.
• Mettre en place et valider les modifications : Une fois le problème résolu, utilisez git add pour mettre en place les fichiers, puis validez les modifications.

Fichiers sensibles commis accidentellement

Problème : Des fichiers sensibles (comme des mots de passe ou des clés d’API) ont été accidentellement livrés dans votre référentiel.

Solution :

• Supprimer les fichiers : Utilisez git rm –cached filename pour supprimer le fichier de votre historique Git.
• Mettez à jour votre .gitignore : Ajoutez les fichiers sensibles à .gitignore afin qu’ils ne soient plus livrés.
• Supprimez-les de votre historique Git : Utilisez des outils comme BFG Repo-Cleaner pour nettoyer les commits passés.
• Mettez à jour les informations d’identification exposées : Veillez à modifier toutes les informations sensibles qui ont été exposées.

Problèmes de synchronisation

Problème : Vous rencontrez des erreurs lorsque vous essayez d’extraire ou de pousser des modifications.

Solution :

• Utilisez git pull –rebase : Cela permet de s’assurer que vos changements sont appliqués proprement sur les derniers commits.
• Éviter le passage en force : le passage en force n’est nécessaire qu’en cas d’absolue nécessité, car il peut écraser le travail d’autrui.
• Vérifier les URL distantes : Assurez-vous que l’URL de votre référentiel distant est correcte.

État de l’HEAD détaché

Problème : Vous travaillez dans un état « HEAD détaché », ce qui signifie que vous n’êtes pas sur une branche.

Solution :

• Créer une nouvelle branche : Exécutez git checkout -b nom-branche pour créer et basculer vers une nouvelle branche.
• Revenir à une branche existante : Utilisez git checkout nom-branche pour revenir à une branche sur laquelle vous travailliez précédemment.

Les fichiers dans .gitignore sont toujours suivis

Problème : Git suit toujours les fichiers que vous avez ajoutés à .gitignore.

Solution :

• Annuler le suivi des fichiers : Utilisez git rm –cached filename pour arrêter le suivi des fichiers.
• Vérifiez la syntaxe de votre fichier .gitignore : Assurez-vous qu’il n’y a pas d’erreurs dans la façon dont vous avez listé les fichiers dans .gitignore.

Grand dépôt en raison des fichiers multimédias

Problème : Votre référentiel devient trop volumineux à cause des fichiers multimédias.

Solution :

• Exclure les fichiers multimédias : Ajouter les fichiers multimédias à .gitignore pour qu’ils ne soient pas livrés.
• Utiliser Git LFS : Pour les fichiers volumineux, utilisez Git LFS (Git Large File Storage) pour les stocker plus efficacement.

Conflits de fin de ligne

Problème : Vous rencontrez des problèmes dus à l’utilisation de terminaisons de ligne différentes selon les systèmes d’exploitation (par exemple, Windows ou Mac/Linux).

Solution

• Configurer Git : Exécutez git config core.autocrlf true sous Windows pour gérer les différences de fin de ligne.
• Normaliser les paramètres : Veillez à ce que votre équipe utilise des paramètres Git cohérents afin d’éviter les conflits de fin de ligne.

Termes importants de Git et GitHub à connaître

Alors que vous vous apprêtez à utiliser Git et GitHub pour le développement de WordPress, vous rencontrerez plusieurs termes clés. Voici un glossaire rapide pour vous aider à vous y retrouver :

• Branches: Les branches sont des chemins distincts au sein d’un dépôt. Elles vous permettent d’apporter des modifications indépendamment de la base de code principale, afin que vous puissiez expérimenter sans affecter la version en cours.
• Fusionner: La fusion est le processus d’intégration des modifications d’une branche dans une autre. Par exemple, vous pouvez fusionner une branche de fonctionnalités avec la branche principale pour combiner les mises à jour.
• Extraction: l’extraction consiste à récupérer les modifications d’un dépôt distant et à les incorporer dans votre copie locale. Cela permet de s’assurer que les fichiers locaux restent à jour des dernières modifications.
• Demandes d’extraction (PR): Une méthode pour suggérer des modifications à un référentiel est la demande d’extraction (pull request). Avant que les modifications ne soient intégrées dans la base de code principale, cela permet à d’autres personnes d’examiner les changements et d’en débattre.
• Fork: Le fork crée une copie personnelle du dépôt d’un autre utilisateur. Vous pouvez apporter des modifications à votre fork sans affecter le projet original.
• Validation (Commitment) : Un commit est un enregistrement des modifications apportées au référentiel. Chaque livraison possède un identifiant unique et enregistre qui a effectué les modifications et à quel moment.
• Pousser: Le push envoie vos modifications locales vers un dépôt distant sur GitHub, les rendant ainsi accessibles à d’autres personnes.

FAQ sur l’utilisation de Git avec WordPress