Skip to content
This repository has been archived by the owner on May 26, 2023. It is now read-only.

Latest commit

 

History

History
108 lines (75 loc) · 4.65 KB

README.md

File metadata and controls

108 lines (75 loc) · 4.65 KB
Raw

WordPress project

Initialiser un nouveau projet

composer create-project studiometa/wordpress-project www.fqdn.com

Installation

Créer et configurer le fichier .env en vous basant sur le fichier .env.example. Créer et configurer le fichier .htaccess en vous basant sur le fichier .htaccess.example.

Installer les dépendances nécessaires :

# Installer les dépendances Composer avec PHP 7.3
php7.3 $(which composer) install

# Installer les dépendances NPM avec Node 16
nvm use 16
npm install

Utiliser wp-cli pour finaliser l'installation. Si vous utiliser ddev préfixer votre commande : ddev wp sinon lancer la commande depuis le dossier vendor: /vendor/bin/wp 

/vendor/bin/wp 

# Créer la base de donnée (non nécessaire si vous utilisez ddev)
/vendor/bin/wp db create 

# Installer WordPress 
/vendor/bin/wp core install --url="{URL_DU_SITE}" --title="{TITLE_DU_SITE}" --admin_user="{ADMIN_USER}" --admin_email="{ADMIN_EMAIL}"

# Installer la langue FR
/vendor/bin/wp language core install fr_FR

# Activer la langue FR
/vendor/bin/wp site switch-language

# Activer les plugins WordPress
/vendor/bin/wp plugin activate classic-editor advanced-custom-fields-pro seo-by-rank-math

Développement

Commandes disponibles

NPM

Commande Description
npm run dev Démarre le serveur de compilation des fichiers SCSS et JS du thème.
npm run build Build les fichiers SCSS, JS et Vue du thème.
npm run lint Lint les fichiers SCSS, JS, Vue et Twig du thème avec ESLint, Stylelint et Prettier.
npm run lint:scipts Lint les fichiers JS et Vue du thème avec ESLint et Prettier.
npm run lint:styles Lint les fichiers SCSS et Vue du thème avec Stylelint et Prettier.
npm run lint:templates Lint les fichiers Twig avec Prettier.
npm run fix Formate les fichiers SCSS, JS, Vue et Twig du thème avec ESLint, Stylelint et Prettier.
npm run fix:scipts Formate les fichiers JS et Vue du thème avec ESLint et Prettier.
npm run fix:styles Formate les fichiers SCSS et Vue du thème avec Stylelint et Prettier.
npm run fix:templates Formate les fichiers Twig du thème Prettier.

Composer

Commande Description
composer phpcs Lint les fichiers PHP du thème et des plugins customs
composer phpstan Analyse de manière statiques les fichiers PHP du thème et des plugins customs

WP CLI

Une liste (non exaustive) des commandes utiles de WPCLI

Si wp cli est installé sur votre machine et configuré dans votre $PATH utiliser les commandes ci-dessous, sinon utiliser ./vendor/bin/wp

Commande Description
wp user create <USER_LOGIN> <USER_EMAIL> --role=<ROLE_NAME> --user_pass=<PASSWORD> Créer un utilisateur
wp transient delete --all Supprimer tous les transients de la base de données
wp post delete $(wp post list --post_type='revision' --format=ids) --force Supprimer toutes les révisions
wp plugin activate Activer un plugin
wp plugin deactivate Désactiver un plugin
wp search-replace 'http://old-domain.com/' 'http://new-domain.com/' --precise --recurse-objects --all-tables-with-prefix Remplacer toutes les URL's pour migrer une base de données. ⚠ Faire un backup avant de lancer cette commande, ajouter le paramètre –dry-run pour lancer la commande sans effectuer de changements
wp language core install fr_FR && wp language core activate fr_FR Installer une nouvelle langue de back-office (changer fr_FR par la langue souhaitée)

Ajouter des plugins et mu-plugins

Pour ajouter des plugins et mu-plugins tiers, utilisez Composer avec l'aide de wpackagist.org. Par exemple, pour ajouter le plugin Classic Editor, vous pouvez procéder comme suit :

composer require wpackagist/classic-editor

Par défaut, tout ce qui se trouve dans les sous-dossiers de web/wp-content est ignoré par Git pour éviter de suivre les packages tiers installés avec Composer. Pour ajouter vos plugins et thèmes personnalisés à votre dépôt Git, vous devez ajouter des règles dans le fichier .gitignore :

!/web/wp-content/mu-plugins/my-mu-plugin.php
!/web/wp-content/plugins/my-plugin/

Fonctionnalités additionnelles

Désactivation de plugins par environnement

Le MU-plugin Studiometa plugin disabler permet de forcer la désactivation des plugins en fonction de l'environnement. Voir le readme pour plus d'informations.