Publicar y restaurar configuraciones de Product Add-Ons

La publicación por etapas permite al gestor de WooCommerce preparar cambios sin alterar de inmediato las páginas de producto. Los grupos, las opciones reutilizables y los complementos específicos de producto disponen de un borrador editable. Las páginas de producto, las API públicas, los carritos y el proceso de pago utilizan únicamente la última revisión publicada.

Antes de publicar

• Guarda en el borrador todos los campos previstos, opciones, precios, disponibilidad, ajustes obligatorios y asignaciones.
• Comprueba el alcance de producto o catálogo que se muestra en Publication.
• Coordina las publicaciones de todo el catálogo con otros gestores de WooCommerce.
• Añade un motivo breve cuando ayude a otro gestor a entender la revisión más adelante.

Las configuraciones existentes siguen activas tras la actualización. POM Tweaks conserva la primera versión editada como la revisión publicada inicial, de modo que abrir y guardar un borrador no elimina de forma inesperada los complementos activos.

Publicar un grupo o una opción reutilizable

1. Ve a Products → Product Add-Ons.
2. Abre un grupo o una opción reutilizable y guarda el borrador previsto.
3. En Publication, confirma si el borrador tiene cambios sin publicar.
4. Expande Preview changes y revisa los valores publicados y los del borrador.
5. Revisa el impacto potencial. El impacto de un grupo identifica el alcance de todos los productos, de producto directo y de categoría. El impacto de una opción reutilizable informa de los campos que hacen referencia a ella.
6. Opcionalmente, introduce un Publication reason.
7. Selecciona Publish draft.

La operación publica el borrador completo de una sola vez. Los clientes no pueden recibir una mezcla de dos revisiones durante una misma solicitud. Tras la confirmación en la base de datos, POM avanza la generación coherente de publicaciones y refresca la caché del producto o el índice de asignaciones cuando ese agregado lo requiere.

Publicar complementos específicos de producto

1. Edita el producto y abre Product data → Add-Ons.
2. Prepara sus campos locales, la exclusión global o los grupos excluidos individuales.
3. Selecciona Update una vez para guardar esos cambios como borrador y vuelve a Product data → Add-Ons.
4. Revisa la vista previa de cambios sin publicar en Publication.
5. Selecciona Publish the previously saved draft when the product is updated.
6. Opcionalmente, introduce un motivo de publicación.
7. Selecciona Update para el producto.

Dejar la casilla de publicación sin marcar guarda únicamente el borrador. La casilla de publicación siempre publica el borrador que estaba presente cuando se cargó el editor; cualquier edición adicional del formulario en esa misma solicitud se guarda como el siguiente borrador. Esto evita que cambios del navegador no revisados eludan la vista previa de impacto.

Restaurar una revisión anterior

1. Abre el grupo o la opción reutilizable.
2. Expande Revision history.
3. Comprueba la fecha, el autor, el motivo y la generación de la revisión anterior.
4. Selecciona Restore as new revision junto a la versión requerida.

Restaurar nunca elimina ni reescribe el historial. POM Tweaks copia la configuración seleccionada en el borrador y la publica como una nueva revisión más reciente. Los carritos y pedidos existentes conservan sus selecciones de complementos y precios almacenados; las nuevas solicitudes de producto utilizan la configuración restaurada.

Para una revisión específica de producto, selecciona Restore revision en Product data → Add-Ons y, a continuación, actualiza el producto. Las revisiones de producto también pueden revisarse, publicarse o restaurarse mediante un cliente de gestión autenticado a través de /wp-json/pom-tweaks/v1/product-add-ons/publications/{type}/{id}. Una escritura envía operation como publish o rollback, un reason opcional, el revision optimista actual y source_revision_id para la reversión. Las revisiones obsoletas o inexistentes devuelven la misma respuesta 409 o 428 que utilizan los demás endpoints de gestión de Product Add-Ons.

Retención e historial

POM Tweaks conserva por defecto las 50 revisiones más recientes por configuración, con un mínimo protegido de 5 y un máximo de 200. Los desarrolladores pueden ajustar el número conservado con pom_tweaks_product_addons_revision_retention. La limpieza se ejecuta después de una publicación correcta y nunca elimina la revisión publicada actualmente.

El historial almacena el ID de usuario de WordPress, la hora de publicación en UTC y un motivo opcional. No copia direcciones de correo electrónico ni otros datos del perfil en la revisión.

Verificar una publicación

1. Guarda un cambio visible de etiqueta o precio sin publicarlo y confirma que una página de producto privada sigue mostrando el valor anterior.
2. Publica el borrador y recarga el producto en una nueva solicitud.
3. Confirma que la REST clásica y la Store API muestran los mismos UUID de campo y los nuevos valores publicados.
4. Conserva una línea de carrito creada antes de la publicación y confirma que sus selecciones y precios almacenados permanecen sin cambios.
5. Añade el producto de nuevo y confirma que la nueva línea utiliza la revisión publicada actual.
6. Restaura la revisión anterior y confirma que una nueva solicitud la utiliza mientras las instantáneas anteriores del carrito o del pedido permanecen sin cambios.

Solución de problemas

• Si la publicación informa de un conflicto, recarga el editor. Otra solicitud guardó el agregado después de que se abriera la página.
• Si la publicación está temporalmente ocupada, espera un momento y vuelve a intentarlo. Una breve protección de publicación por sitio evita que generaciones concurrentes se superpongan.
• Si el impacto es mayor de lo esperado, no publiques. Corrige primero las referencias de todos los productos, categoría, producto directo u opción reutilizable del borrador.
• Si un producto sigue mostrando un valor anterior, inicia una nueva solicitud y confirma que el borrador previsto se publicó en lugar de guardarse únicamente.