Ajustes y alcance con WP-CLI

Con wp cloneworx-backup settings lees y cambias los ajustes que rigen para todo el sitio web. Con wp cloneworx-backup scope ves qué pertenece a tu sitio web y defines qué nunca entra en una copia de seguridad.

¿Aún falta WP-CLI? Las instrucciones están en Instalar WP-CLI. Todos los comandos del plugin los nombra Los comandos de un vistazo.

Lo que pertenece a un plan de copia o a un destino no está aquí: eso lo cambias con wp cloneworx-backup plan y wp cloneworx-backup target. Las salidas de los comandos están en inglés.

Mostrar los ajustes: settings list

settings list muestra todos los ajustes con su valor. Sin acción, wp cloneworx-backup settings hace lo mismo. La acción no tiene parámetros.

# Mostrar todos los ajustes
wp cloneworx-backup settings list

Cada línea nombra una clave y su valor. (default) detrás del valor significa: el valor es el predeterminado y nunca se ha guardado. Los interruptores aparecen como on u off. Si no hay ninguna dirección de correo introducida, la última línea indica la dirección de administración del sitio web: allí van las notificaciones.

Leer y establecer un ajuste: settings get, set

settings get muestra el valor de una clave. settings set guarda un valor nuevo. La clave y el valor van sin parámetro detrás de la acción.

Clave	En la interfaz	Valores permitidos	Predeterminado
notify_emails	Direcciones de correo	hasta 5 direcciones como un solo valor, separadas por comas	vacío: las notificaciones van a la dirección de administración del sitio web.
notify_errors	En errores y avisos	on, off	on
notify_success	En caso de éxito	on, off	off
notify_overdue	Cuando la última copia buena es más antigua de lo que permite el plan	on, off	on
step_max_seconds	Tiempo máximo por paso	de 5 a 20 (segundos)	20
step_pause_seconds	Pausa entre pasos	de 0 a 60 (segundos)	0
log_keep_days	Conservar registros durante	de 7 a 365 (días)	30
manual_retention	Máx. copias sin plan	de 1 a 99	7
remove_all_on_delete	Al eliminar el plugin, borrar todos los ajustes y el índice. Las copias se conservan.	on, off	off

# Leer un ajuste
wp cloneworx-backup settings get step_max_seconds

# Poner el tiempo máximo por paso en 10 segundos
wp cloneworx-backup settings set step_max_seconds 10

# Registrar dos destinatarios para las notificaciones
wp cloneworx-backup settings set notify_emails "eins@example.com, zwei@example.com"

# Activar el correo tras cada copia de seguridad correcta
wp cloneworx-backup settings set notify_success on

Tras guardar, el comando confirma la clave y el valor. Si el plugin no acepta un valor, no guarda nada. El comando termina entonces con un error e indica el motivo entre paréntesis:

Motivo	Significado
unknown	La clave no existe.
type	El valor tiene el tipo equivocado, por ejemplo texto en lugar de un número.
range	El número está fuera de los límites. El comando indica los límites permitidos.
email	Una dirección no es una dirección de correo válida.
too_many	Hay más de 5 direcciones.

Qué hace cada ajuste lo explica La página «Ajustes».

remove_all_on_delete solo tiene efecto cuando eliminas el plugin en WordPress. Con on, el plugin pide primero a Dropbox que revoque el acceso de cada destino del tipo Dropbox y después elimina ajustes, destinos, la lista de copias de seguridad y los registros. Con off, todo se queda en la base de datos y el plugin no revoca nada. Las copias de seguridad se conservan en ambos casos. Más al respecto: Desinstalar el plugin.

Restablecer todos los ajustes: settings reset

settings reset restablece todas las claves de la tabla de arriba a sus valores predeterminados. Las exclusiones y la lista de tablas se quedan como están.

# Restablecer todos los ajustes a los valores predeterminados
wp cloneworx-backup settings reset

Mostrar el alcance: scope

El alcance dice qué pertenece a tu sitio web: qué carpetas, qué tablas de la base de datos y qué se omite. scope lo muestra. La parte detrás de scope elige qué ves:

Parte	Qué muestra la salida
roots	Las raíces con su ubicación en el servidor. En la base de datos aparece database. not found significa: el plugin no ha encontrado la ubicación. Entre paréntesis hay indicaciones, por ejemplo inside para una raíz que está dentro de otra, o missing para una carpeta que no existe.
tables	El prefijo y el número de tablas, después cada tabla. view marca una vista, structure only una tabla de la que solo se guarda la estructura. Una advertencia nombra las tablas de otra instalación de WordPress en la misma base de datos: esas tablas no se respaldan.
exclusions	Las reglas de exclusión en vigor. default en el encabezado significa: rige la predeterminada. stored significa: rigen tus propias reglas. Debajo están las carpetas que otros plugins definen para su caché o sus registros, y lo que siempre está excluido.
all	Las tres partes. Es la predeterminada sin indicación.

# Mostrar todo
wp cloneworx-backup scope

# Mostrar solo las raíces
wp cloneworx-backup scope roots

# Mostrar solo las tablas
wp cloneworx-backup scope tables

Las raíces

Una raíz es una parte con nombre del sitio web. Los nombres los necesitas para --roots en copia de seguridad, plan de copia y restauración.

Raíz	Contenido
db	Las tablas de la base de datos de este sitio web.
wp-config	El archivo wp-config.php. El plugin respalda el archivo, pero nunca lo restaura en una restauración.
wp-content	Todo lo de wp-content que no pertenece a plugins, temas, plugins imprescindibles ni subidas: archivos de idioma, drop-ins, carpetas de otros plugins.
wp-core	El núcleo de WordPress: las carpetas wp-admin y wp-includes y los archivos que WordPress entrega en la carpeta raíz.
wp-mu-plugins	La carpeta de los plugins imprescindibles.
wp-plugins	La carpeta de los plugins.
wp-themes	La carpeta de los temas.
wp-uploads	La carpeta de las subidas.
wp-root	Todo lo demás en la carpeta raíz del sitio web, por ejemplo .htaccess y robots.txt.

Establecer reglas de exclusión: scope exclusions

Las reglas de exclusión rigen para todo el sitio web y para cada plan de copia. Lo que coincide con una regla no entra en ninguna copia de seguridad.

Parámetro	Significado	Valores permitidos
--set	Sustituye toda la lista de reglas por las indicadas.	Reglas, separadas por comas
--reset	Restablece la predeterminada.	sin valor
--force	Establece también como un usuario distinto del propietario de las carpetas del plugin.	sin valor

--set y --reset solo tienen efecto junto con la parte exclusions. Una regla tiene una de tres formas:

Forma	Significado	Ejemplo
Nombre	Un archivo o una carpeta con exactamente ese nombre, a cualquier profundidad y en cualquier raíz. Con una barra al final, la regla solo coincide con carpetas.	.DS_Store, updraft/
Nombre con asterisco	Un nombre que empieza o termina así. Se permite un asterisco, al principio o al final.	*.log, backwpup*
Ruta	Una ruta en una raíz. La primera parte es el nombre de la raíz. La regla coincide con la entrada y todo lo que hay debajo.	wp-content/cache

Una ruta empieza por wp-content, wp-uploads, wp-plugins, wp-themes, wp-mu-plugins, wp-core o wp-root. Las mayúsculas y minúsculas no importan.

# Mostrar las reglas en vigor
wp cloneworx-backup scope exclusions

# Reemplazar la lista por tres reglas propias
wp cloneworx-backup scope exclusions --set="wp-content/cache,*.log,.DS_Store"

# Restablecer los valores predeterminados
wp cloneworx-backup scope exclusions --reset

El plugin comprueba cada regla antes de guardar. Si una regla no es válida, no guarda nada: el comando termina con un error y nombra cada regla no válida con el motivo. Tras guardar, indica el número de reglas y muestra la lista que rige ahora.

Respaldar tablas solo como estructura: scope tables

Algunos plugins mantienen tablas para sesiones, registros, cachés o estadísticas que crecen mucho. Para esas tablas puedes definir que cada copia de seguridad respalde solo la estructura y omita las filas. De forma predeterminada, el plugin respalda cada tabla por completo.

Parámetro	Significado	Valores permitidos
--structure-only	Sustituye la lista de tablas de las que solo se guarda la estructura. Un valor vacío vacía la lista.	Nombres de tablas sin prefijo, separados por comas
--force	Establece también como un usuario distinto del propietario de las carpetas del plugin.	sin valor

El parámetro solo tiene efecto junto con la parte tables.

# Respaldar dos tablas solo como estructura
wp cloneworx-backup scope tables --structure-only="woocommerce_sessions,wfHits"

# Vaciar la lista: volver a respaldar cada tabla completa
wp cloneworx-backup scope tables --structure-only=""

• El nombre va sin el prefijo de las tablas: woocommerce_sessions, no wp_woocommerce_sessions.
• Solo se permiten tablas de este sitio web. Si indicas una tabla que no existe, el plugin no guarda nada y el comando nombra los nombres desconocidos.
• Las tablas propias del plugin no están disponibles para elegir: de ellas siempre se guarda solo la estructura.
• En una restauración, una tabla así se queda como está en el sitio web, con sus datos. Si no existe allí, el plugin la crea vacía.

Tras guardar, el comando indica el número de tablas y muestra la lista de todas las tablas con sus etiquetas.

Consulta también

• La página «Ajustes»
• Definir qué se respalda
• Configurar notificaciones por correo electrónico
• Adaptar el plugin a tu servidor
• Desinstalar el plugin