Gestionar plugins con WP-CLI: instalar, activar y más

Con WP-CLI puedes administrar plugins directamente desde la consola, sin necesidad de entrar en el panel de administración de WordPress. Esto resulta muy útil cuando no tienes acceso a wp-admin, necesitas realizar cambios de forma rápida en múltiples sitios, o quieres automatizar operaciones de plugins en scripts o pipelines de despliegue.

Para usar WP-CLI necesitas acceso SSH a tu servidor. Consulta la guía cómo acceder por SSH a tu hosting de Nicalia. Todos los comandos deben ejecutarse desde el directorio raíz de la instalación de WordPress o pasando la ruta con --path=/ruta/a/wordpress.

Referencia rápida de comandos

Operación	Comando
Listar plugins y estado	wp plugin status
Instalar un plugin	wp plugin install nombre-plugin
Instalar y activar	wp plugin install nombre-plugin --activate
Activar un plugin	wp plugin activate nombre-plugin
Desactivar un plugin	wp plugin deactivate nombre-plugin
Actualizar un plugin	wp plugin update nombre-plugin
Actualizar todos los plugins	wp plugin update --all
Eliminar un plugin	wp plugin delete nombre-plugin
Buscar un plugin	wp plugin search término

ℹ️ El slug del plugin (el identificador que usas en los comandos) es el nombre de su carpeta en wp-content/plugins/. Por ejemplo, el slug de LiteSpeed Cache es litespeed-cache. Si no lo sabes, búscalo con wp plugin search o consúltalo en la URL del plugin en el repositorio de WordPress.org.

Listar plugins y su estado

Para ver todos los plugins instalados y comprobar si están activos o no:

wp plugin status

El resultado mostrará una lista con información similar a esta:

17 installed plugins:
  I autoptimize         2.5.1
  I backwpup            3.7.0
  N classic-editor      1.5
  N contact-form-7      5.1.6
  I updraftplus         1.16.21
  ...

Leyenda:

• I → Instalado y activo.
• N → Instalado pero no activo.

También puedes ver la lista con más detalle (nombre, estado, versión y si tiene actualización disponible) con:

wp plugin list

Consulta la guía específica listar plugins y su estado con WP-CLI para más opciones de filtrado y formato de salida.

Instalar un plugin

Para instalar un plugin desde el repositorio oficial de WordPress.org:

wp plugin install litespeed-cache

Si quieres instalarlo y activarlo en un solo comando:

wp plugin install litespeed-cache --activate

Consulta la guía instalar un plugin en WordPress con WP-CLI para opciones adicionales (instalar desde URL, instalar una versión específica, etc.).

Activar un plugin

wp plugin activate litespeed-cache

Para activar todos los plugins instalados de una vez:

wp plugin activate --all

Desactivar un plugin

wp plugin deactivate litespeed-cache

Para desactivar todos los plugins instalados (útil para diagnóstico de conflictos):

wp plugin deactivate --all

Consulta la guía desactivar un plugin en WordPress con WP-CLI para más opciones.

Actualizar un plugin

Actualizar un plugin concreto:

wp plugin update litespeed-cache

Actualizar todos los plugins instalados:

wp plugin update --all

Para ver qué plugins tienen actualizaciones disponibles sin aplicarlas:

wp plugin update --all --dry-run

Consulta la guía actualizar un plugin en WordPress con WP-CLI para más opciones.

Eliminar un plugin

Para desinstalar completamente un plugin (lo desactiva si está activo y elimina sus archivos):

wp plugin delete litespeed-cache

⚠️ wp plugin delete elimina los archivos del plugin del servidor pero no elimina los datos que el plugin haya guardado en la base de datos (tablas propias, opciones en wp_options, etc.). Si necesitas limpiar también esos datos, el plugin debería tener una opción de desinstalación completa desde wp-admin antes de eliminarlo.

Consulta la guía eliminar un plugin en WordPress con WP-CLI para más detalles.

Buscar un plugin

Si no recuerdas el nombre exacto del slug de un plugin, puedes buscarlo en el directorio oficial de WordPress.org con:

wp plugin search litespeed

El resultado mostrará una tabla similar a esta:

Success: Showing 10 of 48 plugins.
+------------------------------------------------------------+-------------------+--------+
| name                                                       | slug              | rating |
+------------------------------------------------------------+-------------------+--------+
| LiteSpeed Cache                                            | litespeed-cache   | 98     |
| Fast Velocity Minify                                       | fast-velocity-minify | 94  |
| iThemes Security (anteriormente Better WP Security)        | better-wp-security | 94    |
| NinjaFirewall (WP Edition) – Advanced Security             | ninjafirewall     | 96     |
+------------------------------------------------------------+-------------------+--------+

Columnas de la tabla:

• Name → Nombre completo del plugin.
• Slug → Identificador que se usa en los comandos de WP-CLI.
• Rating → Valoración en la comunidad de WordPress (sobre 100).

Consulta la guía buscar un plugin en WordPress con WP-CLI para opciones de filtrado avanzado.

Errores frecuentes al gestionar plugins con WP-CLI

«Error: Plugin ‘nombre-plugin’ not found»

El slug del plugin no existe en el repositorio de WordPress.org. Verifica el slug correcto buscando el plugin en wordpress.org/plugins — el slug es la última parte de la URL del plugin (ej: wordpress.org/plugins/litespeed-cache → slug: litespeed-cache). También puedes usar wp plugin search término para encontrarlo.

«Error: This does not appear to be a WordPress installation»

WP-CLI no puede localizar la instalación de WordPress. Ejecuta el comando desde el directorio raíz de WordPress (donde están wp-config.php y wp-content/), o especifica la ruta con el parámetro --path: wp plugin install litespeed-cache --path=/home/usuario/public_html.

El plugin se instala pero no aparece en wp-admin

WP-CLI instala el plugin pero no lo activa a menos que uses el flag --activate. Actívalo con wp plugin activate nombre-plugin o reinstálalo con wp plugin install nombre-plugin --activate.

«Warning: The plugin cannot be deactivated» al desactivar todos

Algunos plugins críticos (como plugins de seguridad o mu-plugins) pueden resistir la desactivación en masa. Si necesitas desactivar todos los plugins para diagnóstico sin poder acceder a wp-admin, puedes renombrar la carpeta wp-content/plugins directamente desde SSH o el Administrador de Archivos — WordPress desactivará todos los plugins al no encontrar la carpeta.

Preguntas frecuentes sobre WP-CLI y plugins

¿Cómo sé el slug de un plugin para usar en WP-CLI?

El slug es el nombre de la carpeta del plugin en wp-content/plugins/. También puedes encontrarlo en la URL del plugin en WordPress.org (la última parte de la URL) o usando wp plugin search nombre para ver el slug en la columna correspondiente.

¿Puedo instalar un plugin desde un archivo ZIP con WP-CLI?

Sí. Usa la URL del archivo ZIP o la ruta local: wp plugin install /ruta/al/plugin.zip o wp plugin install https://ejemplo.com/mi-plugin.zip. Esto es útil para instalar plugins premium que no están en el repositorio de WordPress.org.

¿Cómo actualizo solo los plugins con vulnerabilidades conocidas?

WP-CLI no tiene filtro de vulnerabilidades incorporado, pero puedes combinar la lista de plugins con herramientas de auditoría externas. Lo más práctico es mantener todos los plugins actualizados con wp plugin update --all — las actualizaciones de WordPress suelen incluir parches de seguridad.

¿WP-CLI elimina también los datos de la base de datos al hacer delete?

No. wp plugin delete solo elimina los archivos del plugin del servidor. Los datos guardados en la base de datos (tablas propias del plugin, opciones en wp_options) permanecen. Para eliminarlos, muchos plugins tienen una opción de «desinstalación completa» en su configuración que debe ejecutarse desde wp-admin antes de eliminar el plugin.

¿Puedo gestionar plugins en múltiples sitios WordPress a la vez con WP-CLI?

Sí, con el parámetro --path puedes ejecutar cualquier comando en una instalación específica. Para múltiples sitios, puedes crear un script de shell que itere sobre las rutas de cada instalación y ejecute el comando WP-CLI correspondiente en cada una. Consulta la guía WP-CLI: comandos básicos y ejemplos prácticos para más técnicas avanzadas.