WP-CLI Parte 7, importar y exportar contenido

• 1. Instalación y primeros pasos
• 2. Instalando WordPress y primeros pasos y configuraciones
• 3. Trabajando con posts
• 4. Trabajando con usuarios
• 5. Trabajando con la base de datos
• 6. Search & Replace, un comando imprescindible
• 7. Importar y Exportar contenido
• 8. Scaffold, genera esqueletos de código
• 9. Paquetes de comandos adicionales
• 10. Crea tus propios comandos

Séptima entrega de la serie sobre WP-CLI. En esta ocasión vamos a ver cómo exportar e importar contenido en nuestra web.

Para ello, disponemos de los comandos wp export y wp import.

Exportar contenido con WP-CLI

A través del comando wp export podemos exportar el contenido a un fichero WXR. Este fichero contendrá la información sobre autores, términos, entradas, comentarios y adjuntos. No incluye configuración del sitio (options) ni los propios ficheros de los archivos adjuntos.

Admite los siguientes parámetros:

• [--dir=<dirname>], ruta completa donde se almacenará el fichero WXR. Por defecto es el actual directorio desde el que estamos ejecutando el comando.
• [--skip_comments], para no incluir los comentarios en el archivo WXR.
• [--max_file_size=<MB>], para establecer en megas el tamaño máximo del archivo WXR. Por defecto 15
• [--start_date=<date>], para establecer una fecha de publicación a partir de la cual exportar el contenido. El formato de fecha debe ser YYYY-MM-DD.
• [--end_date=<date>], para exportar entradas que tengan como tope esta fecha de publicación. El formato de fecha debe ser YYYY-MM-DD.
• [--post_type=<post-type>], para exportar las entradas de un tipo de contenido concreto. Pueden establecerse varios tipos de contenido separados por coma. Ej: post,page,product… Por defecto se exporta todo (any)
• [--post_type__not_in=<post-type>], al contrario que el anterior, para exportar las entradas excepto de los tipos de contenido indicados. Pueden establecerse varios tipos de contenido separados por coma.
• [--post__in=<pid>], para exportar todos los posts especificados. Admite una lista de IDs separados por coma o espacio.
• [--start_id=<pid>], para exportar todos los posts con ID igual o superior al indicado (número).
• [--author=<author>], para exportar todos los posts que ha creado un usuario concreto. Se puede identificar al usuario por ID o por nombre de usuario (user_login).
• [--category=<name>], para exportar todos los posts de una categoría concreta.
• [--post_status=<status>], para exportar todos los posts que se encuentren en un determinado status (publish, future, draft, trash…).
• [--filename_format=<format>], para especificar un formato al nombre de fichero que se va a exportar. Por defecto: ‘{site}.wordpress.{date}.{n}.xml’.

Como puede observarse, disponemos de multitud de filtros para exportar contenido muy concreto: entre fechas, de un autor determinado, de una categoría determinada, de un tipo de contenido concreto, etc… Veamos algunos ejemplos:

Por ejemplo, para exportar todos los posts de la categoría noticias:

wp export --category=noticias --skip_comments

Otro ejemplo, exportar todos los post del custom post type eventos entre dos fechas. Por ejemplo: todos los eventos del año 2017:

wp export --post_type=events --start_date=2017-01-01 --end_date=2017-12-31 --skip_comments

También podemos hilar un poco más fino y concatenar varios comandos, como por ejemplo para exportar todos los posts que tengan un custom field con un determinado valor:

wp export --post__in="$(wp post list --meta_key=my_custom_field --meta_value='my_custom_value' --format=ids)"

Importar contenido con WP-CLI

Siempre que hablamos de exportar, lo siguiente es hacerlo de importar. Para este caso el comando es wp import. Este comando lo que hace es importar el contenido desde un fichero WXR. Éstos son los parámetros que acepta:

• <file>…, ruta a uno o más ficheros WXR válidos. Además de la ruta completa a un fichero concreto, también son aceptados directorios.
• --authors=<authors>, para indicar cómo manejar el mapeo de autores. Las opciones que acepta este parámetro son: ‘create’, ‘mapping.csv’, o ‘skip’. Para más información te aconsejo que leas la documentación oficial.
• [--skip=<data-type>], para saltar la importación de datos específicos. Las opciones que acepta este parámetro son: ‘attachment’ y ‘image_resize’. Se ahorraría tiempo al evitar generar los thumbnails.

El ejemplo más sencillo es simplemente importar los datos de un fichero concreto:

wp import admin.wordpress.2017-10-14.000.xml --authors=create

Para que la importación funcione es necesario que tengas instalado y activado el plugin WordPress Importer. Puedes instalarlo y activarlo directamente desde la línea de comandos:

wp plugin install wordpress-importer --activate

• « WP-CLI Parte 6, search replace,…
• WP-CLI Parte 8, Scaffold: genera… »