Guía WP-CLI: Comandos básicos y ejemplos prácticos
En esta guía repasarás los comandos básicos de WP-CLI y verás ejemplos prácticos de cómo usarlos en tu instalación de WordPress.
WP-CLI es una utilidad de línea de comandos que te permite, a través de SSH, realizar con un solo comando tareas que desde el administrador web serían mucho más lentas.
¿Qué es WP-CLI?
Si ya trabajas con servidores y terminal, sabrás las ventajas que tiene usar la línea de comandos para automatizar tareas.
WP-CLI es precisamente eso para WordPress: una forma de ejecutar operaciones rutinarias con comandos en lugar de hacerlo desde wp-admin.
Instalar WordPress con WP-CLI
Normalmente, WordPress se instala descargando archivos y subiéndolos por FTP. Si haces esto a menudo, WP-CLI te ahorra tiempo y lo puedes lograr en tres pasos.
Pasos a seguir
- Accede por SSH a tu cuenta y dirígete a la carpeta donde quieres instalar WordPress. Por ejemplo:
cd public_html/
- Descarga WordPress en ese directorio. Para obtenerlo en español añade el parámetro
--locale=es_ES:
wp core download --locale=es_ES
- Crea el archivo
wp-config.phpcon el comando:
wp core config --dbname=usuario_basededatos --dbuser=usuario_usuariobasededatos --dbpass=tuclave --dbhost=localhost --dbprefix=prefijo_
Parámetros y su significado
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| –dbname | Base de datos a utilizar | –dbname=usuario_basededatos |
| –dbuser | Usuario MySQL | –dbuser=usuario_usuariobasededatos |
| –dbpass | Contraseña del usuario MySQL | –dbpass=tuclave |
| –dbhost | Host de la base de datos | –dbhost=localhost |
| –dbprefix | Prefijo para las tablas | –dbprefix=prefijo_ |
Antes de ejecutar este paso, asegúrate de haber creado la base de datos y el usuario en tu cPanel.
- Instala WordPress con la información de tu dominio y usuario administrador:
wp core install --url=demo.nicalia.com --title="Nicalia" --admin_user=usuario_admin --admin_password=tu_clave --admin_email=correo@tudominio.com
Parámetros y su significado
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| –url | Dominio de tu web | –url=demo.nicalia.com |
| –title | Título del sitio | –title=”Nicalia” |
| –admin_user | Usuario administrador | –admin_user=usuario_admin |
| –admin_password | Contraseña del administrador | –admin_password=tu_clave |
| –admin_email | Email del administrador | –admin_email=correo@tudominio.com |
Instalar una versión específica de WordPress
Si por compatibilidad necesitas una versión concreta, añade el parámetro --version:
--version=4.2.2
Actualizar WordPress con WP-CLI
Si gestionas varias webs, actualizar desde wp-admin puede ser tedioso. Con WP-CLI lo haces en segundos.
Pasos
- Accede al directorio de tu WordPress por SSH.
- Actualiza los archivos:
wp core update
- Si es necesario, actualiza la base de datos:
wp core update-db
Gestionar plugins con WP-CLI
También puedes administrar plugins sin entrar en el panel de WordPress.
Listar plugins y su estado
wp plugin status
Resultado esperado:
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
Leyenda:
- I → Instalado y activo.
- N → Instalado y desactivado.
Instalar un plugin
wp plugin install litespeed-cache
Instalar y activar al mismo tiempo:
wp plugin install litespeed-cache --activate
Activar un plugin
wp plugin activate litespeed-cache
Desactivar un plugin
wp plugin deactivate litespeed-cache
Actualizar un plugin
wp plugin update litespeed-cache
Actualizar todos los plugins:
wp plugin update --all
Eliminar un plugin
wp plugin delete litespeed-cache
Buscar un plugin
wp plugin search litespeed
Resultado:
Success: Showing 10 of 48 plugins.
| LiteSpeed Cache | litespeed-cache | 98 |
| Fast Velocity Minify | fast-velocity-minify | 94 |
Añadir una entrada de prueba
wp post create --post_type=post --post_status=publish --post_title='Entrada de prueba' --post_content='Este es el contenido de la nueva entrada'
Añadir un usuario
wp user create USUARIO tutorial@nicalia.com --role=administrator
Asignar contraseña manual:
wp user create USUARIO tutorial@nicalia.com --role=administrator --user_pass=TuContraseña
Crear un tema hijo
wp scaffold child-theme tema-hijo --parent_theme=twentysixteen
Importar archivos multimedia
wp media import ~/public_html/wordpress/wp-content/uploads/**/*.jpg
(Asegúrate de adaptar la ruta a la carpeta correcta.)
Regenerar miniaturas
wp media regenerate --yes
Crear un backup MySQL
wp db export backupmysql.sql
(Puedes cambiar el nombre del archivo por el que prefieras.)
Generar contenido de prueba
Generar entradas
wp post generate --count=5
Generar páginas
wp post generate --post_type=page --count=3
Generar comentarios
wp comment generate --count=3 --post_id=1
Con estos comandos podrás gestionar tu WordPress mucho más rápido y sin depender siempre del panel de administración.
