Spring naar inhoud

Veelgebruikte commando’s

Deze tekst is vertaald met AI. Als je de oorspronkelijke tekst in het Engels wilt bekijken, klik hier.

Er zijn een aantal opdrachten die handig kunnen zijn wanneer je met je site werkt. Deze opdrachten en hun veelgebruikte parameters staan hieronder. Er zijn ook veel andere nuttige opdrachten beschikbaar, en deze secties bevatten ze niet allemaal. Raadpleeg de WordPress.org Developer CLI Commands Guide voor meer informatie.

In de CLI zelf kun je ook de help-opdracht gebruiken om meer informatie te vinden over welke parameters en flags beschikbaar zijn. 

Bijvoorbeeld: wp help plugin

Gebruikers beheren

Gebruik de volgende opdrachten om de lokale gebruikers van je site te beheren. Houd er rekening mee dat het wijzigen van gebruikersaspecten in CLI de instellingen voor WordPress.com-gebruikersaccounts die mogelijk aan lokale accounts zijn gekoppeld niet wijzigt.

De gebruiker die als je primaire Jetpack-verbinding fungeert, moet een e-mailadres hebben dat overeenkomt met het e-mailadres van het WordPress.com-account van de site-eigenaar. Als het e-mailadres niet overeenkomt, werkt de Jetpack-verbinding van de site niet correct. De gebruikersnaam hoeft niet overeen te komen.

wp user list

Geef alle gebruikers op de site weer. Als je veel gebruikers hebt, wil je de lijst mogelijk beperken tot specifieke rollen door de flag --role te gebruiken:

wp user list –role=adminstrator
wp user list –role=adminstrator

wp user get {USER ID/NAME/EMAIL}

Retourneer een specifieke gebruiker, op basis van gebruikers-ID, gebruikersnaam of e-mailadres.

wp user create {NAME} {USER EMAIL} –role={ROLE}

Maak een nieuwe gebruiker aan met de opgegeven naam, het e-mailadres van de gebruiker en de rol.

Deze opdracht maakt geen overeenkomende WordPress.com-gebruiker aan. Als je WordPress.com Secure Sign-On (SSO) gebruikt, moet je in plaats daarvan de lokale gebruiker aanmaken door een gebruiker uit te nodigen via Gebruikers > Nieuwe toevoegen. Zo zorg je ervoor dat er zowel een WordPress.com-account als een lokale gebruiker wordt aangemaakt.

wp user update {USER ID/NAME/EMAIL} –{KEY}={VALUE}

Werk een gebruiker bij op basis van de gebruikers-ID, naam of e-mail. Werkt de opgegeven set sleutel/waarde-paren bij. 

Sleutels zijn onder andere display_name, user_email, role en user_pass

Opmerking: je kunt de user_login van een gebruiker niet bijwerken met de opdracht wp user update. In plaats daarvan moet je wp search-replace gebruiken om de user_login bij te werken. Deze wijziging wordt echter niet aanbevolen, omdat hierbij gedeeltelijke vervangingen worden uitgevoerd. Bijvoorbeeld: als er twee gebruikers zijn met de gebruikersnamen “techie” en “nontechie”, dan leidt het vervangen van “techie” door “sense” tot “sense” en “nonsense”.

Als je toch een user_login wilt vervangen, gebruik dan de volgende opdracht:

wp --skip-plugins --skip-themes search-replace "old username" "new username" *users --include-columns=user_login,user_nicename --dry-run
wp –skip-plugins –skip-themes search-replace “old username” “new username” *users –include-columns=user_login,user_nicename –dry-run

Plugins en thema’s beheren

Gebruik de volgende opdrachten om je plugins en thema’s te beheren. Houd er bij het werken met plugins en thema’s rekening mee dat de bijbehorende slug niet altijd overeenkomt met de naam van de plugin/het thema.

Als je problemen hebt met een plugin of thema, kun je je opdracht beginnen met wp --skip-themes --skip-plugins om de opdrachten ondanks conflicten uit te voeren.

Je vindt hieronder meer informatie over skip-opdrachten.

wp plugin/theme list

Maak een lijst van alle plugins/thema’s die op de site zijn geïnstalleerd en hun status. In deze lijsten vind je de slugs van je geïnstalleerde plugins en thema’s, die je kunt gebruiken om de onderstaande opdrachten uit te voeren.

wp plugin/theme activate {SLUG}

Activeer de opgegeven plugin/het opgegeven thema.

Om een thema te deactiveren, moet je een ander thema in plaats daarvan activeren.

wp plugin deactivate {SLUG}

Deactiveer de opgegeven plugin.

wp plugin/theme delete {SLUG}

Verwijder de opgegeven plugin/het opgegeven thema.

Je kunt met deze opdracht geen actief thema of beheerde thema’s verwijderen. Als je een actief thema wilt verwijderen, schakel je eerst over naar een ander thema en verwijder je daarna het gewenste thema. Als je beheerde thema’s wilt verwijderen, kun je dit doen via SFTP.

wp plugin/theme install {SLUG or URL TO INSTALLATION_FILE}

Installeer een plugin/thema vanuit de WordPress.org-repository op basis van de slug of via een URL-pad naar een .zip-installatiebestand.

Je kunt een bestaande plugin/thema niet overschrijven, tenzij je de opdracht uitvoert met de vlag --force. Je kunt dit gebruiken om plugins bij te werken en beschadigde pluginmappen te herstellen.

Als je een plugin na de installatie automatisch wilt activeren, voeg je de vlag --activate toe.

wp plugin/theme update {SLUG}

Werk de opgegeven plugin/het opgegeven thema bij als er een update beschikbaar is. Je kunt deze opdracht niet gebruiken om beheerde plugins/thema’s bij te werken.

Je kunt ook de vlag --all gebruiken als je alle plugins/thema’s wilt bijwerken.

wp plugin auto-updates {COMMAND} {PLUGIN SLUG}

Toon de status van plugin-updates of schakel updates in/uit voor een specifieke plugin.

Beschikbare COMMANDS zijn status, enable, disable.

Je kunt updates voor beheerde plugins of thema’s niet uitschakelen.

Jetpack beheren

Gebruik de volgende opdrachten om Jetpack-modules aan te passen, je Jetpack-verbinding te controleren of Jetpack-problemen op te lossen.

Als je Jetpack loskoppelt, worden veel belangrijke WordPress.com-functies uitgeschakeld, waaronder algemeen site- en factuurbeheer.

Als je --skip-plugins gebruikt, werken deze opdrachten niet.

Je vindt hieronder meer informatie over skip-opdrachten.

wp jetpack module list

Geef de Jetpack-modules en hun statussen weer.

wp jetpack module activate {MODULE NAME}

Activeer de opgegeven Jetpack-module.

Je kunt ook all gebruiken in plaats van {MODULE NAME}

wp jetpack module deactivate {MODULE NAME}

Deactiveer de opgegeven Jetpack-module.

Je kunt ook all gebruiken in plaats van {MODULE NAME}

wp jetpack status

Rapporteer de status van Jetpack, inclusief welk gebruikersaccount de primaire verbinding is (dit moet altijd de site-eigenaar zijn).

Er kan een extra parameter, full, worden toegevoegd om volledige details te rapporteren, waaronder de Jetpack-versie, WordPress-versie en modulestatus.

Terwijl de zichtbaarheid van je site is ingesteld op Privé, zijn sommige Jetpack-modules uitgeschakeld en kunnen ze niet worden beheerd in CLI. Deze modules zijn: Ads, Asset CDN, Enhanced Distribution, Google Analytics, Image CDN, JSON API, Publicize, Sharing, Site Verification en Sitemaps.

Site-instellingen beheren

Gebruik de volgende opdrachten om verschillende aspecten van je site en gebruikers te beheren.

wp site empty –yes

Maak een site leeg van content (berichten en pagina’s).

wp site empty –uploads –yes

Maak de site leeg, inclusief mediabestanden.

wp site empty-opdrachten zijn onomkeerbaar. Als je ze gebruikt, wordt je content permanent verwijderd. Om deze te herstellen, moet je herstellen vanaf een eerdere back-up. Zorg ervoor dat je een back-up beschikbaar hebt voordat je de functie gebruikt.

wp site-opdrachten verwijderen geen thema’s of plugins, en ze resetten ook geen thema of wissen plugin-instellingen. Als je je site volledig moet resetten, neem dan contact op met WordPress.com ondersteuning.

wp option get {OPTION}

Geef de waarde van een optie terug.

wp option update {OPTION} {VALUE}

Werk de waarde van een optie bij.

wp option add {OPTION} {VALUE}

Voeg een nieuwe optie toe.

wp option delete {OPTION}

Verwijder een optie.

De optietabel is het “controlecentrum” van een website. Als een optie verkeerd wordt bewerkt of verwijderd, kan je hele site stoppen met werken.

Wanneer je met wp option-opdrachten werkt, kan de volgende foutmelding in de terminal betekenen dat de optietabel beschadigd is:

One or more database tables are unavailable. The database may need to be repaired
One or more database tables are unavailable. The database may need to be repaired

Je kunt de tabel herstellen door de SQL-tabel van de site terug te zetten naar de laatste goede kopie. Let op: hiermee worden alle wijzigbare aanpassingen aan de database die na het herstelpunt zijn gedaan teruggedraaid, wat kan leiden tot gegevensverlies.

Een SQL-tabel herstellen:

  1. Ga in het dashboard van de site naar Jetpack > Activiteitenlog.
  2. Selecteer een back-uppunt om naar terug te spoelen.
  3. Schakel alle vakjes uit behalve Site-database (SQL).
  4. Klik op Terugspoelen bevestigen.

wp role list

Geef een lijst met rollen terug

wp role reset {ROLE}

Reset de opgegeven rol. Je kunt meerdere rollen opgeven (zonder komma’s)

wp reset role administrator editor
wp reset role administrator editor

Je kunt {ROLE} ook vervangen door --all om alles in één keer te resetten

Content beheren

Je kunt de volgende commando’s gebruiken om de content van je site te beheren, waaronder berichten/pagina’s, menu’s en media.

wp post list

Geef een lijst met blogberichten terug.

Je kunt verschillende flags gebruiken met deze opdracht, waaronder:

--format={FORMAT}

--posts_per_page={#}

--post_type={TYPE}

Mogelijke berichttypes zijn posts, pages, attachments en products.

Je kunt meerdere flags tegelijk gebruiken.

wp post list --post_type=posts,pages --format=count
wp post list –post_type=posts,pages –format=count

wp post update {POST_ID} –{KEY}={VALUE}

Werk berichtinformatie bij.

wp post update123 --post_status=draft
wp post update123 –post_status=draft

wp post delete {POST_ID}

Verwijder een bericht.

wp post exists {POST_ID}

Controleer of een bericht bestaat.

wp menu list

Geef menu’s op de site weer.

wp menu item list {TERM_ID}

Geef menu-items van een specifiek menu weer.

wp menu item update {MENU_ITEM_PARENT_ID}

Werk een specifiek menu-item bij.

De wp menu-commando’s kunnen handig zijn als je ziet dat het hoofdmenu vastloopt in het Aanpassingsmenu of op het /wp-admin-scherm.

wp media regenerate

Genereer mediathumbnails opnieuw wanneer de Jetpack Photon-module is gedeactiveerd.

Je kunt de vlag --only-missing gebruiken om bestaande afbeeldingsformaten over te slaan.

Siteproblemen oplossen

Je kunt de volgende commando’s gebruiken bij het oplossen van problemen op je site. Controleren op PHP-fouten kan je helpen de oorzaken van fouten op je site te identificeren, of gebruik wp wpcomsh-commando’s om snel te controleren op pluginconflicten of om aan te passen of je beheerde versies van plugins gebruikt.

Zowel Jetpack als Akismet zijn beheerde plugins die vereist zijn om je site hier bij WordPress.com correct te laten werken. Deze plugins moeten geactiveerd blijven en kunnen niet worden omgezet naar onbeheerde versies.

wp php-errors

Geef foutlogs weer in WP-CLI.

Deze opdracht geeft alleen PHP-fouten weer, geen fouten van andere talen zoals HTML, Javascript of CSS. Gebruik de Browser Inspector om deze andere fouten te bekijken.

Je kunt de flag --limit toevoegen om het aantal weergegeven fouten te verminderen en de leesbaarheid te verbeteren.

wp php-errors –limit10
wp php-errors –limit10

wp wpcomsh deactivate-user-plugins

Deactiveer gebruikersplugins.

Je kunt de flag --interactive gebruiken om voor elke plugin bevestiging af te dwingen.

Deze opdracht deactiveert Akismet, Jetpack of beheerde e-commerceplugins niet.

wp wpcomsh reactivate-user-plugins

Activeer gebruikersplugins opnieuw.

Je kunt de flag --interactive gebruiken om voor elke plugin bevestiging af te dwingen.

wp wpcomsh persistent-data {DATA}

Retourneer persistente gegevens (die Jetpack gebruikt om sitemogelijkheden te verifiëren).

Beschikbare DATA-opties zijn onder andere:

WPCOM_PLAN_EXPIRATION

JETPACK_BLOG_TOKEN

WPCOM_PURCHASES

WPCOM_PUBLIC_COMING_SOON

wp wpcomsh plugin use-managed {SLUG}

Gebruik een beheerde (via symlink gekoppelde) versie van een plugin.

Deze opdracht verwijdert bestaande, onbeheerde versies en vervangt ze door beheerde versies. De opdracht is beschikbaar voor amp, classic-editor, coblocks, crowdsignal-forms, full-site-editing, gutenberg, layout-grid, page-optimize, wp-seo, woocommerce, WooCommerce Extensions uit de WordPress.com Marketplace en plugins die zijn inbegrepen bij het Commerce-abonnement.

Je kunt de --remove-existing-flag gebruiken om de bevestigingsstap over te slaan.

wp wpcomsh theme use-managed {SLUG}

Gebruik een beheerde (via symlink gekoppelde) versie van een thema.

Deze opdracht verwijdert bestaande, onbeheerde versies en vervangt ze door beheerde versies. Dit is beschikbaar voor alle WordPress.com-thema’s, Storefront en alle Twenty *-thema’s (bijv.: Twenty Twenty Two).

Je kunt de --remove-existing-flag gebruiken om de bevestigingsstap over te slaan.

wp wpcomsh plugin use-unmanaged {SLUG}

Gebruik een onbeheerde (niet via symlink gekoppelde) versie van een plugin

Deze opdracht verwijdert bestaande, beheerde versies en vervangt ze door onbeheerde versies uit de WordPress.org-pluginrepository. Dit werkt niet voor WooCommerce Extensions uit de WordPress.com Marketplace en plugins die zijn inbegrepen in het Commerce-abonnement. Je moet deze plugins handmatig installeren om de onbeheerde versie te krijgen.

Je kunt de --remove-existing-flag gebruiken om de bevestigingsstap over te slaan en de --version={X.Y.Z}-flag om de te installeren versie op te geven.

wp wpcomsh theme use-unmanaged {SLUG}

Gebruik een onbeheerde (niet gesymlinkte) versie van een thema.

Deze opdracht verwijdert bestaande, beheerde versies en vervangt ze door onbeheerde versies uit de WordPress.org-themarepository, indien beschikbaar.

Je kunt de vlag --remove-existing gebruiken om de bevestigingsstap over te slaan en de vlag --version={X.Y.Z} om de te installeren versie te definiëren.

De must-use plugin WordPress.com Site Helper of wpcomsh wordt uitgevoerd op sites met geactiveerde hostingfuncties, zodat ze soepel werken binnen het WordPress.com-ecosysteem.

wp cache flush

Wis de cache.

Deze opdracht is niet bedoeld als oplossing voor problemen en kan onderliggende oorzaken verhullen. Gebruik deze dus voorzichtig. Het wissen van de cache kan er ook voor zorgen dat je site langzamer wordt terwijl de cache opnieuw wordt opgebouwd bij het laden van pagina’s.

Plugins en thema’s overslaan

Je wilt mogelijk plugins, en soms thema’s, overslaan wanneer je CLI-opdrachten uitvoert. Dit kan handig zijn bij het oplossen van conflicten of om beperkingen te omzeilen die door plugins zijn ingesteld, zoals controle over rollen.

  • --skip-plugins kan vóór elke opdracht worden toegevoegd en slaat plugins over
  • --skip-themes kan vóór elke opdracht worden toegevoegd en slaat thema’s over

Je kunt deze opdrachten samen gebruiken. Je kunt deze opdrachten ook gebruiken met slugs om specifieke plugins of thema’s over te slaan. Dit kan handig zijn om de effecten van bepaalde plugins of thema’s uit te sluiten wanneer deactivering niet mogelijk is.

Bijvoorbeeld:

wp --skip-plugins=woocommerce, code-snippets, elementor-pro plugin list
wp –skip-plugins=woocommerce, code-snippets, elementor-pro plugin list

Laatste update: juni 23, 2026