En esta guía repasaremos los comandos básicos que podemos utilizar con WP-CLI y algunos ejemplos prácticos de su uso y opciones que podemos tener a la hora de utilizarlos.

WP-CLI es una utilidad de línea de comandos que te permitirá, a través de SSH y un conjunto de comandos simples realizar tareas en ocasiones muy lentas desde el apartado web del administrador de WordPress, ya que las realizaremos con un solo comando o muy pocos más,

  1. Instalar WordPress con wp-cli
  2. Actualizar WordPress con wp-cli
  3. Gestionar plugins con wp-cli
  4. Añadir una entrada con wp-cli
  5. Añadir un usuario con wp-cli
  6. Crear un tema hijo con wp-cli
  7. Importar archivos multimedia con wp-cli
  8. Regenerar miniaturas con wp-cli
  9. Crear backup MySQL con wp-cli
  10. Generar contenido demo con wp-cli

Instalar WordPress con wp-cli

WordPress puede ser instalado descargando los archivos desde su sitio oficial y subiéndolos mediante FTP. Si realizamos esta tarea a menudo, cualquier mejora en el tiempo necesario para realizarla es fundamental para desempeñar nuestro trabajo.

WP-CLI nos permite realizar esto en tan solo 3 pasos y sin necesidad de un navegador web.

¿Qué es WP-CLI?
Si estás familiarizado con entornos de servidores y terminal, conocerás el uso y ventajas en automatización que tiene el uso de la línea de comandos.

WP-CLI es una utilidad de línea de comandos para WordPress que nos permite acelerar la ejecución de tareas rutinarias ejecutándolas con un comando en lugar de a través del clásico wp-admin.

Guía paso a paso

Estos son los pasos a realizar para conseguirlo:

  1. Accede mediante SSH a tu cuenta y dirígete a la ruta donde deseas instalar WordPress. Por ejemplo, la raíz del dominio.

    Comando a ejecutar

    cd public_html/
    BASH
  2. Descarga WordPress a este directorio, para que no lo descargue en inglés, acompañaremos al comando del parámetro --locale=es_ES

    Comando a ejecutar

    wp core download --locale=es_ES
    BASH
  3. Una vez hayamos descargado WordPress, debemos generar el archivo wp-config.php, para ello utilizaremos el comando:

    Comando a ejecutar

    wp core config --dbname=usuario_basededatos --dbuser=usuario_usuariobasededatos --dbpass=tuclave --dbhost=localhost --dbprefix=prefijo_
    BASH

    Párametros y su significado

    PárametroDescripciónEjemplo
    --dbname=Base de datos a utilizar--dbname=usuario_basededatos
    --dbuser=Usuario MySQL para conectar--dbuser=usuario_usuariobasededatos
    --dbpass=Contraseña del usuario MySQL--dbpass=tuclave
    --dbhost=Host MySQL--dbhost=localhost
    --dbprefix=Prefijo para las tablas--dbprefix=prefijo_

    Antes de continuar

    Esta base de datos y usuario deben haber sido creados con anterioridad, a continuación dispones de las guías para realizar cada tarea:

    1. Crear una base de datos en cPanel
    2. Crear un usuario MySQL en cPanel
  4. Una vez todo está conectado, es hora de instalar WordPress definiendo los valores de dominio y detalles del administrador:

    Comando a ejecutar

    wp core install –url=demo.nicalia.com –title="Nicalia" –admin_user=usuario_admin –admin_password=tu_clave –admin_email=correo@tudominio.com
    BASH

    Párametros y su significado

    PárametroDescripciónEjemplo
    –url=Dominio de tu web--dbname=usuario_basededatos
    –title=Título para el sitio--dbuser=usuario_usuariobasededatos
    –admin_user=Usuario admin a configurar--dbpass=tuclave
    –admin_password=Contraseña admin a configurar--dbhost=localhost
    –admin_email=Dirección email del admin--dbprefix=prefijo_

Instalar una versión específica de WordPress con wp-cli

Por motivos de compatibilidad es posible que necesitemos una versión específica de WordPress, en ese caso, podemos añadir lo siguiente al comando de instalación:

Comando a ejecutar

--version=4.2.2
BASH

Artículos relacionados

There is no content with the specified labels

Actualizar WordPress con wp-cli

Para actualizar WordPress, basta con acceder a wp-admin y seguir sus instrucciones. Sin embargo, si gestionamos una gran cantidad de instalaciones, puede ser tedioso actualizar todas de esta forma.

WP-CLI nos permite realizar esto con comandos y sin necesidad de acceder vía web a wp-admin.

¿Qué es WP-CLI?
Si estás familiarizado con entornos de servidores y terminal, conocerás el uso y ventajas en automatización que tiene el uso de la línea de comandos.

WP-CLI es una utilidad de línea de comandos para WordPress que nos permite acelerar la ejecución de tareas rutinarias ejecutándolas con un comando en lugar de a través del clásico wp-admin.

Guía paso a paso

Estos son los pasos a realizar para conseguirlo:

  1. Accede mediante SSH a tu cuenta y dirígete a la ruta donde deseas instalar WordPress. Por ejemplo, la raíz del dominio.

    Comando a ejecutar

    cd public_html/
    BASH
  2. Actualiza los archivos de WordPress, para ello ejecuta el siguiente comando:

    Comando a ejecutar

    wp core update
    BASH
  3. Por último, actualiza la base de datos para que tome los cambios de la última versión:

    Comando a ejecutar

    wp core update-db
    BASH
    1. Este paso solo es necesario si la actualización lo requiere. Si no estás seguro, es mejor que lo ejecutes.

Gestionar plugins con wp-cli

En ocasiones puede que necesitemos gestionar el estado de un plugin sin acceso a wp-admin, bien sea para actualizarlo o bien para desactivarlo y conseguir de nuevo el acceso. Ya hemos hablado sobre cómo desactivar plugins en WordPress, pero también podemos realizarlo con wp-cli desde la consola de comandos.

En este artículo, repasaremos las funciones de administración de plugins que wp-cli pone a nuestra disposición desde la consola.

Listar plugins y su estado

Para listar todos los plugins instalados en nuestro WordPress basta con usar el siguiente comando:

Comando a ejecutar

wp plugin status
BASH

Este comando nos devolverá un resultado similar al siguiente:

Comando a ejecutar

17 installed plugins:
  I autoptimize                 2.5.1
  I backwpup                    3.7.0
  I better-search-replace       1.3.3
  N classic-editor              1.5
  N contact-form-7              5.1.6
  I duplicate-post              3.2.4
  N contact-form-7-honeypot     1.14.1
  I igniteup                    3.4.1
  N litespeed-cache             2.9.9.2
  N mailchimp-for-wp            4.7.4
  N multisite-language-switcher 2.3.0
  N wp-seopress                 3.7.7.1
  N wp-simple-firewall          8.4.4
  I updraftplus                 1.16.21
  N wp-mailto-links             3.1.0
  I wp-migrate-db               1.0.11
BASH
Leyenda (Letra precedente)Significado
IInstalado
NActivado

Instalar un plugin

Para instalar un plugin en WordPress a través de wp-cli solo debemos buscar su nombre y ejecutar:

Comando a ejecutar

wp plugin install litespeed-cache
BASH

Si además, deseas activarlo a la vez que lo instalas, solo tendrías que añadir --activate al final:

Comando a ejecutar

wp plugin install litespeed-cache --activate
BASH

Activar un plugin

Para activar un plugin en WordPress con wp-cli basta con ejecutar:

Comando a ejecutar

wp plugin activate litespeed-cache
BASH

Desactivar un plugin

Para desactivar un plugin en WordPress con wp-cli bastaría con ejecutar:

Comando a ejecutar

wp plugin deactivate litespeed-cache
BASH

Donde litespeed-cache colocaríamos el nombre del plugin a desactivar.

Actualizar un plugin

Para actualizar un plugin en WordPress con wp-cli solo tienes que ejecutar:

Comando a ejecutar

wp plugin update litespeed-cache
BASH

Si deseamos actualizar todos los plugins a la vez, bastaría con:

Comando a ejecutar

wp plugin update --all
BASH

Eliminar un plugin

Para desinstalar y eliminar un plugin de WordPress  con wp-cli bastaría con ejecutar:

Comando a ejecutar

wp plugin delete litespeed-cache
BASH

Buscar un plugin

Para buscar un plugin en el directorio de WordPress con wp-cli o conocer su nombre exacto para realizar tareas con él, basta con ejecutar:

Comando a ejecutar

wp plugin search litespeed
BASH

Donde litespeed colocaríamos el nombre del plugin a buscar o alguna palabra clave.

El resultado devuelto debe ser similar a este:

Comando a ejecutar

Success: Showing 10 of 48 plugins.
+---------------------------------------------------------------------------------+----------------------------+--------+
| name                                                                            | slug                       | rating |
+---------------------------------------------------------------------------------+----------------------------+--------+
| LiteSpeed Cache                                                                 | litespeed-cache            | 98     |
| Fast Velocity Minify                                                            | fast-velocity-minify       | 94     |
| Hide My WP Ghost – Security Plugin                                        	  | hide-my-wp                 | 88     |
| iThemes Security (anteriormente Better WP Security)                             | better-wp-security         | 94     |
| LuckyWP Cookie Notice (GDPR)                                                    | luckywp-cookie-notice-gdpr | 100    |
| NinjaFirewall (WP Edition) – Advanced Security                                  | ninjafirewall              | 96     |
| WP PleaseWait                                                                   | wp-pleasewait              | 100    |
| Hummingbird – Speed Optimize, Cache, Minify & Defer Critical CSS/Javascript | hummingbird-performance        | 96     |
| Edgemesh                                                                        | edgemesh                   | 100    |
| WP Auto Republish                                                               | wp-auto-republish          | 100    |
+---------------------------------------------------------------------------------+----------------------------+--------+
BASH

Cada columna representa lo siguiente:

ColumnaSignificado
NameNombre completo del plugin
Slug

Palabra clave del plugin para utilizarlo con wp-cli

RatingValoración en la comunidad de WordPress

Añadir una entrada con wp-cli

A veces puede sernos necesarios añadir una entrada a WordPress de prueba o por defecto.

Esto podemos realizarlo con wp-cli utilizando el siguiente comando:

Comando a ejecutar

wp post create --post_type=post --post_status=publish --post_title='Entrada de prueba' --post_content='Este es el contenido de la nueva entrada'
Success: Created post 15.
BASH

Añadir un usuario con wp-cli

Añadir un usuario a WordPress con wp-cli es muy sencillo, basta con ejecutar el siguiente comando:

Comando a ejecutar

wp user create USUARIO tutorial@nicalia.com --role=administrator
BASH

Esto debe devolver un resultado similar a:

Comando a ejecutar

Success: Created user 2.
Password: 0S4FBioDxU
BASH

Si deseamos asignar la contraseña nosotros, bastaría con ejecutarlo añadiendo --user_pass= y la contraseña que deseamos:

Comando a ejecutar

wp user create USUARIO tutorial@nicalia.com --role=administrator --user_pass=SuPassword
BASH

Crear un tema hijo con wp-cli

Si deseamos crear un tema hijo para nuestro theme actual, la mejor forma es utilizando wp-cli. Para ello, basta con ejecutar el siguiente comando:

Comando a ejecutar

wp scaffold child-theme tema-hijo --parent_theme=twentysixteen
BASH

En este ejemplo, crearemos un theme llamado tema-hijo dependiente del tema Twenty Sixteen.


Importar archivos multimedia con wp-cl

A veces deseamos subir una gran cantidad de imágenes a WordPress y la biblioteca de medios o realizarlo a través del navegador se nos hace insuficiente. Esto podemos atajarlo con WP-CLI.

WP-CLI nos permite importar todos los archivos multimedia colocados en una carpeta con el siguiente comando:

Comando a ejecutar

wp media import ~/public_html/wordpress/wp-content/uploads/\*\*\/\*.jpg
BASH

Es necesario adaptar la ruta a la carpeta que quieres integrar.

Regenerar miniaturas con wp-cli

En ocasiones puede sernos necesario regenerar las miniaturas de nuestra instalación de WordPress, para realizarlo, bastaría con hacer lo siguiente:

Comando a ejecutar

wp media regenerate --yes
BASH

El subcomando --yes lo que indica es que no pida confirmación para cada imagen.

Crear backup MySQL con wp-cli

Cuando vamos a realizar una actualización a WordPress es muy recomendable realizar un backup MySQL. Si estás familiarizado con WP-CLI, puedes usar el siguiente comando:

Comando a ejecutar

wp db export backupmysql.sql
BASH

Importante

Sustituye backupmysql.sql por el nombre que desees dar al archivo de backup.

Generar contenido demo con wp-cli

A veces puede ser necesario probar el desempeño de una instalación o cómo quedaría un diseño con contenido.

WP-CLI nos permite generar contenido de prueba en una instalación, dependiendo del tipo de contenido, utilizaremos un comando u otro.

Generar entradas

Comando a ejecutar

wp post generate --count=5
BASH

Generar páginas

Si deseamos generar páginas, podemos utilizar:

Comando a ejecutar

wp post generate --post_type=page --count=3
BASH

Generar comentarios

Comando a ejecutar

wp comment generate --count=3 --post_id=1
BASH