Tuto WP-CLI : Comment installer et configurer WordPress en moins d’une minute et en seulement un clic

Ce tutoriel fait suite à ma conférence au WP Tech à Nantes, où j’ai présenté notre process d’agence optimisé, et notamment notre script Wippy d’automatisation d’installation et configuration WordPress via l’outil WP-CLI.

Et visiblement beaucoup d’entre vous l’attendent avec impatience !

On aura tous des installs #WordPress 100x plus efficaces dès lundi grâce à @Maximebj ! #WPTechNantes

— Jenny Beaumont (@jennybeaumont) November 29, 2014

Ma conférence

J’ai originalement présenté WP-CLI au WP Tech 2014 à Nantes. Voici les slides de ma présentation :

Qu’est-ce que WP-CLI ?

WP-CLI est un outil fonctionnant en ligne de commande (CLI = command line interface) permettant de procéder à des opérations sur un WordPress via un script Bash. Je ne suis pas fan de la ligne de commande à la base, mais j’ai bien vite changé d’avis en voyant toutes les possibilités !

Toutes les commandes se lancent via wp. Techniquement vous aurez accès à toutes les fonctions de WordPress : télécharger, installer WordPress, les plugins, les thèmes, créer ou modifier des articles, ajouter des utilisateurs, modifier des options…

Imaginez donc toutes les possibilités ! 

Pour vous donner une idée de l’étendue de WP-CLI,  je vous invite à consulter la documentation en ligne :

[smoothie_button url=”http://wp-cli.org/commands/” label=”Documentation WP-CLI”]

Quelques idées de scripts

Une autre idée, grâce aux fonctions avancées, est de faire un équivalent de Velvet Blues URL, qui permet de remplacer des URLS par des autres, très utile lors de la mise en ligne d’un site WordPress, afin de remplacer en masse les URLs locales vers les URLs finales.La première idée qui nous vient à l’esprit, c’est d’automatiser l’installation de WordPress afin de gagner un temps considérable lors d’un démarrage de projet. On fait donc chuter de 20 minutes à 30 secondes l’installation d’un site.

Il est possible d’accéder à toutes les fonctions de WordPress avec WP-CLI, donc les possibilités sont presques infinies !

En installant WP-CLI sur vos hébergements, et en vous y connectant en SSH, vous pourriez très bien imaginer de gérer à distance la mise à jour de vos sites et vérifier qu’ils sont toujours en ligne. Un peu comme proposerait le service Manage WP, mais sans la nécessité d’installer un plugin.

Lorsque vous poussez un site en ligne via Git, vous pourriez également imaginer un Git hook qui lance le script WP-CLI sur votre hébergement, afin de remplacer les options Home et Site URL pour mettre les bonnes URLs

Et vous ? Quelle est votre idée ?

Installer WP-CLI

Il vous faudra une invite de commande. Sur Mac je vous conseille de télécharger iTerm qui est plutôt bien pensé. Il vous faudra ensuite installer WP-CLI, et éventuellement Git.

Pour lancer l’installation de WP-CLI, tapez ceci dans la console :

[pastacode lang=”bash” message=”” highlight=”” provider=”manual” manual=”curl%20-O%20https%3A%2F%2Fraw.githubusercontent.com%2Fwp-cli%2Fbuilds%2Fgh-pages%2Fphar%2Fwp-cli.phar”/]

Vérifiez que c’est bien installé :

[pastacode lang=”bash” message=”” highlight=”” provider=”manual” manual=”php%20wp-cli.phar%20–info”/]

Si vous utilisez Mamp, il faudra faire pointer vers le bon PHP et le bon MySQL (ceux de Mamp). Pour cela ouvrez ~/.zshrc à la racine de votre ordinateur.

[pastacode lang=”bash” message=”” highlight=”” provider=”manual” manual=”%23%20FIX%20PHP%20MAMP%20for%20WP-CLI%0Aexport%20PATH%3D%2FApplications%2FMAMP%2Fbin%2Fphp%2Fphp5.6.2%2Fbin%3A%24PATH%0Aexport%20PATH%3D%24PATH%3A%2FApplications%2FMAMP%2FLibrary%2Fbin%2F”/]

redémarrez votre console ensuite.

Le Script en détails

protip : ne vous embêtez pas à copier/coller. Je vous file le script à la fin de ce tuto ;).

• $1 fait référence au premier paramètre : le nom du site,
• $2 au titre du site, à fournir entre guillemets s’il a des espaces.

1. Les variables à renseigner

Ces quelques variables sont à changer en fonction de vos envies :

[pastacode lang=”bash” message=”” highlight=”” provider=”manual” manual=”%23%20admin%20email%0Aemail%3D%22mon%20%40%20email.com%22%0A%0A%23%20local%20url%20login%0Aurl%3D%22http%3A%2F%2F%22%241%22%3A8888%2F%22%0A%0A%23%20admin%20login%0Aadmin%3D%22admin-%241%22%0A%0A%23%20path%20to%20install%20your%20WPs%0Apathtoinstall%3D%22~%2FDesktop%22%0A%0A%23%20path%20to%20plugins.txt%0Apluginfilepath%3D%22~%2Fpath%2Fto%2Fwippy%2Fplugins.txt%22″/]

• L’email administrateur
• L’url locale de votre site
• l’identifiant admin (ici je génère admin-lenomdevotreprojet)
• Le dossier où installer WordPress
• Le fichier qui liste les plugins à installer

2. Les petites fonctions d’affichage (Optionnel)

J’ai ajouté quelques fonctions permettant d’afficher la progression : la fonction bot, ainsi que des codes couleurs pour iterm. Ces fonctions ne sont pas nécessaires au bon fonctionnement du script.

3. Télécharger, configurer, créer la base et installer WordPress

[pastacode lang=”bash” message=”” highlight=”” provider=”manual” manual=”wp%20core%20download%20–locale%3Dfr_FR%20–force%0Awp%20core%20version%0Awp%20core%20config%20–dbname%3D%241%20–dbuser%3Droot%20–dbpass%3Droot%20–skip-check%20–extra-php%20%3C%3CPHP%0Adefine(%20’WP_DEBUG’%2C%20true%20)%3B%0APHP%0Awp%20db%20create%0A%23%20generate%20password%0Apassgen%3D%60head%20-c%2010%20%2Fdev%2Frandom%20%7C%20base64%60%0Apassword%3D%24%7Bpassgen%3A0%3A10%7D%0A%23%20install%0Awp%20core%20install%20–url%3D%24url%20–title%3D%22%242%22%20–admin_user%3D%24admin%20–admin_email%3D%24email%20–admin_password%3D%24password”/]

Ici, on télécharge WordPress via la command core. On indique en paramètre que l’on veut la version Française. On génère un mot de passe aléatoire en 10 caractères (selon les configs cette commande peut peut-être différer).

Dans la configuration de la base de données, j’ai mis root pour identifiant et mot de passe. Si vous êtes sur Windows sur Easyphp, ce sera root comme identifiant, et mot de passe vide “”.

vous remarquerez quelques lignes bizarres à la fin de la config, elles permettent d’ajouter du PHP dans votre fichier. On en profite pour passer WP-DEBUG à True.

4. Installer les plugins à partir d’un fichier .txt

[pastacode lang=”bash” message=”” highlight=”” provider=”manual” manual=”while%20read%20line%0Ado%0A%20%20%20%20wp%20plugin%20install%20%24line%20–activate%0Adone%20%3C%20pluginfilepath”/]

Ces lignes permettent de récupérer la liste des plugins à installer depuis un fichier txt, qui comprend simplement l’identifiant d’un plugin par ligne. L’identifiant est celui dans l’URL quand vous êtes sur le site des extensions WordPress. Par exemple : wordpress-seo pour Yoast

5. Télécharger son thème versionné depuis Git

[pastacode lang=”bash” message=”” highlight=”” provider=”manual” manual=”cd%20wp-content%2Fthemes%2F%0Agit%20clone%20git%20%40%20bitbucket.org%3Amaximebj%2Fwordpress-zero-theme.git%0Awp%20theme%20activate%20%241″/]

On télécharge ici le thème WP0 thème (le thème ultra minimaliste WP-Spread pour démarrer votre développement rapidement) depuis Bitbucket via une commande git, et on active ce thème.

6. Créer les articles et pages

[pastacode lang=”bash” message=”” highlight=”” provider=”manual” manual=”wp%20post%20create%20–post_type%3Dpage%20–post_title%3D’Accueil’%20–post_status%3Dpublish%0Awp%20post%20create%20–post_type%3Dpage%20–post_title%3D’Blog’%20–post_status%3Dpublish%0Awp%20post%20create%20–post_type%3Dpage%20–post_title%3D’Contact’%20–post_status%3Dpublish%0Awp%20post%20create%20–post_type%3Dpage%20–post_title%3D’Mentions%20L%C3%A9gales’%20–post_status%3Dpublish%0A%0Acurl%20http%3A%2F%2Floripsum.net%2Fapi%2F5%20%7C%20wp%20post%20generate%20–post_content%20–count%3D5″/]

On crée les pages habituelles, comme Accueil, Contact, Mentions légales, ainsi qu’une série de 5 articles dont le contenu a été généré aléatoirement via l’api de loripsum.net.

7. Paramètres habituels, Permaliens et nettoyage

[pastacode lang=”bash” message=”” highlight=”” provider=”manual” manual=”%23%20Change%20Homepage%0Abot%20%22Je%20change%20la%20page%20d’accueil%20et%20la%20page%20des%20articles%22%0Awp%20option%20update%20show_on_front%20page%0Awp%20option%20update%20page_on_front%203%0Awp%20option%20update%20page_for_posts%204%0A%0A%23%20Menu%20stuff%0Abot%20%22Je%20cr%C3%A9e%20le%20menu%20principal%2C%20assigne%20les%20pages%2C%20et%20je%20lie%20l’emplacement%20du%20th%C3%A8me%20%3A%20%22%0Awp%20menu%20create%20%22Menu%20Principal%22%0Awp%20menu%20item%20add-post%20menu-principal%203%0Awp%20menu%20item%20add-post%20menu-principal%204%0Awp%20menu%20item%20add-post%20menu-principal%205%0Awp%20menu%20location%20assign%20menu-principal%20main-menu%0A%0A%23%20Misc%20cleanup%0Abot%20%22Je%20supprime%20Hello%20Dolly%2C%20les%20th%C3%A8mes%20de%20base%20et%20les%20articles%20exemples%22%0Awp%20post%20delete%201%20–force%20%23%20Article%20exemple%20-%20no%20trash.%20Comment%20is%20also%20deleted%0Awp%20post%20delete%202%20–force%20%23%20page%20exemple%0Awp%20plugin%20delete%20hello%0Awp%20theme%20delete%20twentytwelve%0Awp%20theme%20delete%20twentythirteen%0Awp%20theme%20delete%20twentyfourteen%0Awp%20option%20update%20blogdescription%20”%0A%0A%23%20Permalinks%20to%20%2F%25postname%25%2F%0Abot%20%22J’active%20la%20structure%20des%20permaliens%22%0Awp%20rewrite%20structure%20%22%2F%25postname%25%2F%22%20–hard%0Awp%20rewrite%20flush%20–hard%0A%0A%23%20cat%20and%20tag%20base%20update%0Awp%20option%20update%20category_base%20theme%0Awp%20option%20update%20tag_base%20sujet”/]

Ici on procède a un gros nettoyage de printemps : on enlève les thèmes de base inclus dans WordPress, les articles exemple, on vire Hello Dolly,  on active la structure des permaliens sur /%postname%/ et on défini Accueil en page d’accueil.

On crée également un menu que l’on assigne à la zone main-menu (définie dans le thème dans functions.php) et on y assigne les pages nouvellement créées.

8. Versionnement du projet

[pastacode lang=”bash” message=”” highlight=”” provider=”manual” manual=”cd%20..%2F..%0Agit%20init%20%20%20%20%23%20git%20project%0Agit%20add%20-A%20%20%23%20Add%20all%20untracked%20files%0Agit%20commit%20-m%20%22Initial%20commit%22%20%20%20%23%20Commit%20changes”/]

Pour les habitués de git, on va simplement lancer le versionnement du projet. Pour ceux pas à l’aise avec Git, je vous conseille de suivre quelques tutos, comme celui d’Openclassrooms, vous comprendrez bien assez vite les bénéfices d’un projet gité, que vous soyez seul ou en équipe.

#WPTechNantes Même si t'es tout seul UTILISE GIT ! – je dis oui @Maximebj

— Julien OGER Ⓖ (@JulienOG) November 29, 2014

9. Ouvrir le navigateur, le finder et sublime text

[pastacode lang=”bash” message=”” highlight=”” provider=”manual” manual=”%23%20Open%20in%20browser%0Aopen%20%24url%0Aopen%20%22%24%7Burl%7Dwp-admin%22%0A%0A%23%20Open%20in%20Sublime%20text%0A%23%20REQUIRED%20%3A%20activate%20subl%20alias%20at%20https%3A%2F%2Fwww.sublimetext.com%2Fdocs%2F3%2Fosx_command_line.html%0Acd%20wp-content%2Fthemes%0Asubl%20%241%0A%0A%23%20Open%20in%20finder%0Acd%20%241%0Aopen%20.”/]

Juste pour le fun, on fait ouvrir le dossier dans l’explorateur, un onglet navigateur avec le site, un autre avec l’admin, et on ouvre le dossier du thème dans sublime text. Autant pousser la flemme jusqu’au bout !

10. Affichage du résumé et copie du mot de passe dans le presse papier

[pastacode lang=”bash” message=”” highlight=”” provider=”manual” manual=”%23%20Copy%20password%20in%20clipboard%0Aecho%20%24password%20%7C%20pbcopy%0A%0A%23%20That’s%20all%20!%20Install%20summary%0Abot%20%22%24%7Bgreen%7DL’installation%20est%20termin%C3%A9e%20!%24%7Bnormal%7D%22%0Aline%0Aecho%20%22URL%20du%20site%3A%20%20%20%24url%22%0Aecho%20%22Login%20admin%20%3A%20%20admin%241%22%0Aecho%20-e%20%22Password%20%3A%20%20%24%7Bcyan%7D%24%7Bbold%7D%20%24password%20%24%7Bnormal%7D%24%7Bnormal%7D%22″/]

Et enfin, on fait copier le mot de passe généré dans le presse papier (il restera plus qu’à coller) et on affiche un résumé des infos. Et voilà !

Bonus : Le Lancer avec Alfred

Si vous avez un Mac et Alfred d’installé, on va pouvoir créer en quelques secondes un mot-clé pour lancer le script avec élégance et rapidité, et s’affranchir totalement d’ouvrir le terminal.

De quoi impressionner vos potes n’est-ce pas ?

Vous allez avoir besoin du Power Pack Alfred (ça vaut le coup) afin de pouvoir créer vos propres actions.  Dans les préférences d’Alfred, rendez-vous dans l’onglet Workflow.

Nous allons créer une action en 3 étapes :

• Définir un mot-clé
• Lancer le script
• Afficher une notification système

Le Workflow

1. Créer le mot clé

Ajoutez une action de type Mot-clé. Donnez le nom qui vous servira à appeler votre script. Dans mon cas c’est Wippy. Vous pouvez également ajouter le logo WordPress. N’oubliez pas de cocher with space et de sélectionner Argument Required.

2. Lancer le script

Ajoutez une action de type terminal. Nous allons ici simplement appeler notre script bash. Ecrivez bash suivi de l’adresse terminal jusqu’à votre script.sh.  N’oubliez pas d’échapper les espaces avec un backslash.

Ajoutez à la fin {query} qui récupérera les paramètres à transmettre au script

3. Notification Système

Pas vraiment nécessaire, mais pour le fun, on peut lancer une petite notification système pour avertir l’utilisateur que le script est en cours d’exécution.

Télécharger WIPPY

Comme je suis sympa, je vous passe le fichier que j’ai utilisé lors de la conférence, qui pourra vous servir de base pour installer WordPress chez vous. N’hésitez pas à personnaliser, hacker et améliorer !

[smoothie_button url=”https://bitbucket.org/dysign/wippy-spread/src” label=”Wippy sur Bitbucket”]

Conclusion

Prenez un moment pour mettre en place WP-CLI chez vous, vous n’allez pas le regretter !

WP-CLI peut nous apporter énormément pour automatiser nos process de tous les jours. Ce tuto est un exemple parmi toutes les possibilités que l’on peut imaginer. Soumettez vos idées et vos projets !

En espérant que ce tuto vous a plu, je vous invite à le partager à vos connaissances, et me dire en commentaires sous quelle mesure WP-CLI vous a fait gagné du temps !