Häufig verwendete Befehle

Dieser Text wurde mithilfe von KI übersetzt. Wenn du den Originaltext auf Englisch lesen möchtest, klicke hier.

Es gibt eine Reihe von Befehlen, die bei der Arbeit mit deiner Website hilfreich sein können. Diese Befehle und ihre gängigen Parameter sind unten aufgeführt. Es gibt auch viele weitere nützliche Befehle, die in diesen Abschnitten nicht alle enthalten sind. Weitere Informationen findest du im WordPress.org Developer CLI Commands Guide.

Benutzer verwalten

Verwende die folgenden Befehle, um die lokalen Benutzer deiner Website zu verwalten. Bitte beachte, dass Änderungen an Benutzeraspekten im CLI nicht die Einstellungen für WordPress.com-Benutzerkonten ändern, die möglicherweise mit lokalen Konten verknüpft sind.

wp user list

Listet alle Benutzer der Website auf. Wenn du viele Benutzer hast, kannst du die Liste mithilfe des Flags --role auf bestimmte Rollen einschränken:

wp user list –role=adminstrator

wp user get {USER ID/NAME/EMAIL}

Gibt einen bestimmten Benutzer zurück, entweder anhand der Benutzer-ID, des Benutzernamens oder der E-Mail-Adresse.

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

Erstellt einen neuen Benutzer mit dem angegebenen Namen, der Benutzer-E-Mail-Adresse und der Rolle.

Dieser Befehl erstellt keinen zugehörigen WordPress.com-Benutzer. Wenn du WordPress.com Secure Sign-On (SSO) verwendest, solltest du den lokalen Benutzer stattdessen erstellen, indem du einen Benutzer über Benutzer > Neu hinzufügen einlädst. Dadurch wird sichergestellt, dass sowohl ein WordPress.com-Konto als auch ein lokaler Benutzer erstellt werden.

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

Aktualisiert einen Benutzer anhand der Benutzer-ID, des Namens oder der E-Mail-Adresse. Aktualisiert die angegebenen Schlüssel/Wert-Paare. 

Zu den Schlüsseln gehören display_name, user_email, role und user_pass

Hinweis: Du kannst den user_login eines Benutzers nicht mit dem Befehl wp user update aktualisieren. Stattdessen erfordert die Aktualisierung des user_login die Verwendung von wp search-replace. Diese Änderung wird jedoch nicht empfohlen, da sie teilweise Ersetzungen durchführt. Beispiel: Wenn es zwei Benutzer mit den Benutzernamen „techie“ und „nontechie“ gibt, führt das Ersetzen von „techie“ durch „sense“ zu „sense“ und „nonsense“.

Wenn du dennoch einen user_login ersetzen möchtest, lautet der zu verwendende Befehl:

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

Plugins und Themes verwalten

Verwende die folgenden Befehle, um deine Plugins und Themes zu verwalten. Bitte beachte bei der Arbeit mit Plugins und Themes, dass der zugehörige Slug nicht immer mit dem Plugin-/Theme-Namen übereinstimmt.

Wenn du Probleme mit einem Plugin oder Theme hast, kannst du deinen Befehl mit wp --skip-themes --skip-plugins beginnen, um die Befehle trotz Konflikten auszuführen.

Weitere Informationen zu Skip-Befehlen findest du weiter unten.

wp plugin/theme list

Listet alle auf der Website installierten Plugins/Themes und deren Status auf. In diesen Listen findest du die Slugs deiner installierten Plugins und Themes, die du für die Ausführung der unten aufgeführten Befehle verwenden kannst.

wp plugin/theme activate {SLUG}

Aktiviert das angegebene Plugin/Theme.

Um ein Theme zu deaktivieren, musst du ein anderes an seiner Stelle aktivieren.

wp plugin deactivate {SLUG}

Deaktiviert das angegebene Plugin.

wp plugin/theme delete {SLUG}

Löscht das angegebene Plugin/Theme.

Mit diesem Befehl kannst du kein aktives Theme oder verwaltete Themes löschen. Um ein aktives Theme zu entfernen, wechsle zuerst zu einem anderen Theme und lösche dann das gewünschte Theme. Um verwaltete Themes zu entfernen, kannst du dies per SFTP tun.

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

Installiert ein Plugin/Theme aus dem WordPress.org-Repository anhand des Slugs oder über einen URL-Pfad zu einer Installations-.zip-Datei.

Du kannst ein vorhandenes Plugin/Theme nicht überschreiben, es sei denn, du führst den Befehl mit dem Flag --force aus. Du kannst dies verwenden, um Plugins zu aktualisieren und beschädigte Plugin-Ordner zu reparieren.

Um ein Plugin nach der Installation automatisch zu aktivieren, füge das Flag --activate hinzu.

wp plugin/theme update {SLUG}

Aktualisiert das angegebene Plugin/Theme, sofern verfügbar. Du kannst diesen Befehl nicht verwenden, um verwaltete Plugins/Themes zu aktualisieren.

Du kannst auch das Flag --all verwenden, wenn du alle Plugins/Themes aktualisieren möchtest.

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

Zeigt den Status von Plugin-Updates an oder aktiviert/deaktiviert Updates für ein bestimmtes Plugin.

Verfügbare COMMANDS sind status, enable, disable.

Du kannst Updates für verwaltete Plugins oder Themes nicht deaktivieren.

Jetpack verwalten

Verwende die folgenden Befehle, um Jetpack-Module anzupassen, deine Jetpack-Verbindung zu überprüfen oder Jetpack-Probleme zu beheben.

wp jetpack module list

Listet die Jetpack-Module und deren Status auf.

wp jetpack module activate {MODULE NAME}

Das angegebene Jetpack-Modul aktivieren.

Du kannst auch all anstelle von {MODULE NAME} verwenden.

wp jetpack module deactivate {MODULE NAME}

Das angegebene Jetpack-Modul deaktivieren.

Du kannst auch all anstelle von {MODULE NAME} verwenden.

wp jetpack status

Den Status von Jetpack anzeigen, einschließlich des Benutzerkontos, das die primäre Verbindung darstellt (dies sollte immer der Website-Betreiber sein).

Ein zusätzlicher Parameter, full, kann hinzugefügt werden, um vollständige Details anzuzeigen, einschließlich Jetpack-Version, WordPress-Version und Modulstatus.

Website-Einstellungen verwalten

Verwende die folgenden Befehle, um verschiedene Aspekte deiner Website und Benutzer zu verwalten.

wp site empty –yes

Eine Website von Inhalten leeren (Beiträge und Seiten).

wp site empty –uploads –yes

Die Website einschließlich Mediendateien leeren.

wp site-Befehle löschen weder Themes noch Plugins und setzen auch kein Theme zurück oder löschen Plugin-Einstellungen. Wenn du deine Website vollständig zurücksetzen musst, wende dich bitte an den WordPress.com-Support.

wp option get {OPTION}

Den Wert einer Option zurückgeben.

wp option update {OPTION} {VALUE}

Den Wert einer Option aktualisieren.

wp option add {OPTION} {VALUE}

Eine neue Option hinzufügen.

wp option delete {OPTION}

Eine Option löschen.

Wenn du bei der Arbeit mit wp option-Befehlen den folgenden Fehler im Terminal erhältst, kann dies bedeuten, dass die Options-Tabelle beschädigt ist:

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

Du kannst die Tabelle wiederherstellen, indem du die SQL-Tabelle der Website auf eine letzte funktionierende Kopie zurücksetzt. Bitte beachte, dass dadurch alle veränderbaren Änderungen an der Datenbank, die nach dem Wiederherstellungspunkt vorgenommen wurden, rückgängig gemacht werden und es zu Datenverlust kommen kann.

So stellst du eine SQL-Tabelle wieder her:

1. Navigiere im Dashboard der Website zu Jetpack > Aktivitätsprotokoll.
2. Wähle einen Sicherungspunkt aus, zu dem du zurückkehren möchtest.
3. Deaktiviere alle Kontrollkästchen außer Website-Datenbank (SQL).
4. Klicke auf Zurückspulen bestätigen.

wp role list

Gibt eine Liste der Rollen zurück.

wp role reset {ROLE}

Setzt die angegebene Rolle zurück. Du kannst mehrere Rollen auflisten (ohne Kommas).

wp reset role administrator editor

Du kannst {ROLE} auch durch --all ersetzen, um alle auf einmal zurückzusetzen.

Inhalte verwalten

Du kannst die folgenden Befehle verwenden, um die Inhalte deiner Website zu verwalten, einschließlich Beiträge/Seiten, Menüs und Medien.

wp post list

Gibt eine Liste von Blogbeiträgen zurück.

Du kannst verschiedene Flags mit diesem Befehl verwenden, darunter:

--format={FORMAT}

--posts_per_page={#}

--post_type={TYPE}

Mögliche Inhaltstypen sind posts, pages, attachments und products.

Mehrere Flags können gleichzeitig verwendet werden.

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

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

Beitragsinformationen aktualisieren.

wp post update123 --post_status=draft

wp post delete {POST_ID}

Einen Beitrag löschen.

wp post exists {POST_ID}

Prüfen, ob ein Beitrag existiert.

wp menu list

Menüs auf der Website auflisten.

wp menu item list {TERM_ID}

Menüeinträge eines bestimmten Menüs auflisten.

wp menu item update {MENU_ITEM_PARENT_ID}

Einen bestimmten Menüeintrag aktualisieren.

wp media regenerate

Medien-Thumbnails neu generieren, wenn das Jetpack-Photon-Modul deaktiviert ist.

Du kannst das Flag --only-missing verwenden, um bereits vorhandene Bildgrößen zu überspringen.

Fehlerbehebung bei Website-Problemen

Du kannst die folgenden Befehle bei der Fehlerbehebung auf deiner Website verwenden. Die Überprüfung auf PHP-Fehler kann dir helfen, Fehlerquellen auf deiner Website zu identifizieren, oder du kannst wp wpcomsh-Befehle nutzen, um schnell Plugin-Konfliktprüfungen durchzuführen oder anzupassen, ob du verwaltete Versionen von Plugins verwendest.

wp php-errors

Fehlerprotokolle in WP-CLI ausgeben.

Dieser Befehl gibt nur PHP-Fehler aus, keine Fehler anderer Sprachen wie HTML, Javascript oder CSS. Um diese anderen Fehler zu sehen, verwende den Browser-Inspektor.

Du kannst das Flag --limit verwenden, um die Anzahl der angezeigten Fehler zu reduzieren und die Lesbarkeit zu verbessern.

wp php-errors –limit10

wp wpcomsh deactivate-user-plugins

Benutzer-Plugins deaktivieren.

Du kannst das Flag --interactive verwenden, um eine Bestätigung für jedes Plugin zu erzwingen.

Dieser Befehl deaktiviert weder Akismet noch Jetpack oder verwaltete E-Commerce-Plugins.

wp wpcomsh reactivate-user-plugins

Benutzer-Plugins reaktivieren.

Du kannst das Flag --interactive verwenden, um eine Bestätigung für jedes Plugin zu erzwingen.

wp wpcomsh persistent-data {DATA}

Gibt persistente Daten zurück (die Jetpack verwendet, um Website-Funktionen zu verifizieren).

Verfügbare DATA-Optionen umfassen:

WPCOM_PLAN_EXPIRATION

JETPACK_BLOG_TOKEN

WPCOM_PURCHASES

WPCOM_PUBLIC_COMING_SOON

wp wpcomsh plugin use-managed {SLUG}

Verwendet eine verwaltete (per Symlink verknüpfte) Version eines Plugins.

Dieser Befehl entfernt vorhandene, nicht verwaltete Versionen und ersetzt sie durch verwaltete Versionen. Er ist verfügbar für amp, classic-editor, coblocks, crowdsignal-forms, full-site-editing, gutenberg, layout-grid, page-optimize, wp-seo, woocommerce, WooCommerce-Erweiterungen aus dem WordPress.com Marketplace und im Commerce-Tarif enthaltene Plugins.

Du kannst das Flag --remove-existing verwenden, um den Bestätigungsschritt zu überspringen.

wp wpcomsh theme use-managed {SLUG}

Eine verwaltete (per Symlink verknüpfte) Version eines Themes verwenden.

Dieser Befehl entfernt vorhandene, nicht verwaltete Versionen und ersetzt sie durch verwaltete Versionen. Er ist für alle WordPress.com-Themes, Storefront und alle Twenty-*-Themes (z. B. Twenty Twenty Two) verfügbar.

Du kannst das Flag --remove-existing verwenden, um den Bestätigungsschritt zu überspringen.

wp wpcomsh plugin use-unmanaged {SLUG}

Eine nicht verwaltete (nicht per Symlink verknüpfte) Version eines Plugins verwenden.

Dieser Befehl entfernt vorhandene, verwaltete Versionen und ersetzt sie durch nicht verwaltete Versionen aus dem WordPress.org-Plugin-Verzeichnis. Er funktioniert nicht für WooCommerce-Erweiterungen aus dem WordPress.com Marketplace und im Commerce-Tarif enthaltene Plugins. Diese Plugins musst du manuell installieren, um die nicht verwaltete Version zu erhalten.

Du kannst das Flag --remove-existing verwenden, um den Bestätigungsschritt zu überspringen, und das Flag --version={X.Y.Z}, um die zu installierende Version festzulegen.

wp wpcomsh theme use-unmanaged {SLUG}

Eine nicht verwaltete (nicht per Symlink verknüpfte) Version eines Themes verwenden.

Dieser Befehl entfernt vorhandene, verwaltete Versionen und ersetzt sie durch nicht verwaltete Versionen aus dem WordPress.org-Theme-Verzeichnis, sofern verfügbar.

Du kannst das Flag --remove-existing verwenden, um den Bestätigungsschritt zu überspringen, und das Flag --version={X.Y.Z}, um die zu installierende Version festzulegen.

Der WordPress.com Site Helper bzw. das wpcomsh Must-Use-Plugin läuft auf Websites mit aktivierten Hosting-Funktionen, damit diese nahtlos im WordPress.com-Ökosystem funktionieren.

wp cache flush

Den Cache leeren.

Dieser Befehl ist nicht als Lösung für Probleme gedacht und kann die eigentlichen Ursachen verschleiern. Bitte verwende ihn mit Bedacht. Das Leeren des Cache kann außerdem dazu führen, dass deine Website langsamer läuft, während der Cache beim Laden der Seite neu aufgebaut wird.

Plugins und Themes überspringen

Möglicherweise möchtest du beim Ausführen von CLI-Befehlen Plugins und manchmal auch Themes überspringen. Dies kann bei der Fehlerbehebung von Konflikten oder zum Umgehen von Einschränkungen durch Plugins nützlich sein, beispielsweise bei der Kontrolle über Rollen.

• --skip-plugins kann vor jedem Befehl hinzugefügt werden und überspringt Plugins
• --skip-themes kann vor jedem Befehl hinzugefügt werden und überspringt Themes

Du kannst diese Befehle zusammen verwenden. Du kannst diese Befehle auch mit Slugs nutzen, um bestimmte Plugins oder Themes zu überspringen. Das kann nützlich sein, um die Auswirkungen bestimmter Plugins oder Themes auszuschließen, wenn eine Deaktivierung nicht möglich ist.

Zum Beispiel:

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