WordPress - WP-CLI gebruiken vanaf de command line

Voor ontwikkelaars is er een fantastische tool die je veel werk kan besparen: WP CLI (Command Line Interface). Door de snelheid waarmee je bepaalde zaken via deze weg kunt uitvoeren kun je als developer eigenlijk niet meer om deze tool heen. WP-CLI is dan ook standaard actief op ieder hosting account bij Hoasted.

WordPress WP-CLI gebruiken

Om gebruik te maken van WP-CLI dien je eerst in te loggen via SSH of via de cPanel Terminal, en naar de map van de installatie te navigeren. Vervolgens kun je verschillende commando's gebruiken zoals onderstaand beschreven.

ssh cpaneluser@domein.nl
cd public_html

Vanuit de hoofdmap van de installatie kun je vervolgens de WP-CLI commando's uitvoeren. In deze handleiding beschrijven we een aantal veel gebruikte commando's die het beheer van de website vele malen makkelijker maken. Voor de volledige lijst van commando's die je kunt gebruiken zie onderstaande link:

https://developer.wordpress.org/cli/commands/

Database

Vele zaken omtrent de database kunnen het best direct via de command line uitgevoerd worden. Zie onderstaand een aantal veel voorkomende taken en commando's.

Database exporteren

Gebruik onderstaande commando's om de database te exporteren naar een .sql bestand die geplaatst zal worden in de hoofdmap van de installatie.

wp db export
wp db export bestandsnaam.sql

Database importeren

Onderstaande commando zal de database importeren op basis van de bestandsnaam in de hoofdmap van de installatie. Het bestand zal vervolgens geïmporteerd worden naar de database welke in het wp-config.php bestand vermeld staat.

wp db import bestandsnaam.sql

Wijzig WordPress URL (database links herschrijven)

Je kunt dit gebruiken wanneer je bijvoorbeeld een staging website die op een andere URL heeft gedraaid te herschrijven zodat deze op de nieuwe link komt te draaien. Gebruik voor de veiligheid eerst het '--dry-run' commando aan het einde om een test run uit te voeren zonder dat hier iets bij herschreven word.

wp search-replace "staging.domein.nl" "domein.nl" --all-tables --dry-run
wp search-replace "staging.domein.nl" "domein.nl" --all-tables

Dit commando kan ook gebruikt worden om een website van http naar https te wijzigen

wp search-replace "http://domein.nl" "https://domein.nl" --all-tables --dry-run
wp search-replace "http://domein.nl" "https://domein.nl" --all-tables

Plugins

Via de command line kun je een aantal handige acties uitvoeren met betrekking tot de WordPress plugins:

Lijst van plugins tonen

wp plugin list

Plugin installeren

Je kunt plugins direct installeren door de 'slug' op te zoeken en deze in het commando te verwerken. Met de optionele '--activate' flag activeer je de plugin ook direct.

wp plugin install litespeed-cache --activate
wp plugin install https://codecanyon.net/downloads/plugin.zip

Plugin updaten

Gebruik onderstaande commando om de plugin te updaten naar een bepaalde versie. Wanneer je de optionele '--version' flag niet gebruikt zal de plugin naar de laatste versie geupdate worden.

wp plugin update litespeed-cache
wp plugin update litespeed-cache --version=1.0.1

Plugin deactiveren

Om een plugin direct te deactiveren kun je onderstaande commando gebruiken. Met de '--all' flag kun je alle plugins in één keer uitschakelen. Handig voor tijdens het debuggen!

wp plugin deactivate litespeed-cache
wp plugin deactivate --all

Gebruikers

Wanneer je om één of andere reden geen toegang meer hebt tot het WordPress dashboard kun je gemakkelijk via de command line alle zaken omtrent de gebruikers beheren.

Lijst van gebruikers tonen

Handig om snel alle beheerders te tonen.

wp user list
wp user list --role=administrator

Gebruiker toevoegen

Voeg razendsnel een nieuwe beheer toe aan de website.

wp user create jouwusername jouw@email.nl --role=administrator

Gebruiker verwijderen

Verwijder een gebruiker en verplaats zijn berichten naar een andere gebruiker.

wp user delete jouwusernaam --reassign=userid

WooCommerce

WooCommerce heeft een eigen set van commando's die niet standaard in de WP-CLI commando's zijn opgenomen. Zie onderstaand hoe je deze kunt activeren:

WooCommerce CLI activeren

Gebruike onderstaande commando's om WooCommerce CLI commando's beschikbaar te maken.

unalias wc
wc

Zie ook onderstaande link voor alle WooCommerce commando's die je kunt gebruiken:

https://github.com/woocommerce/woocommerce/wiki/WC-CLI-Commands

Overig

Onderstaand nog een aantal handige acties die je kunt gebruiken.

WordPress installeren via WP-CLI

Zet razendsnel een nieuwe WordPress installatie op met onderstaande commando.

wp core install --url=domein.nl --title=voorbeeld --admin_user=gebruikersnaam --admin_password=jouwwachtwoord --admin_email=info@domein.nl

WordPress onderhoudsmodus inschakelen via WP-CLI

Schakel de WordPress maintenance pagina in via de command line.

wp maintenance-mode activate
wp maintenance-mode deactivate
wp maintenance-mode status

WordPress permalinks flushen via WP-CLI

Flush de permalinks rechtstreeks via de CLI wanneer dit nodig is.

wp rewrite flush