Publicar con bloques y shortcodes

Esta guía se aplica a la versión de ShopiPress indicada en la cabecera de la página, publicada oficialmente en Freemius. Confirma la versión instalada antes de aplicar el procedimiento. Las versiones posteriores pueden cambiar pantallas, valores por defecto o fronteras de servicio.

Resultado esperado

Los productos y colecciones sincronizados se colocan en páginas de WordPress con los bloques entregados, los shortcodes públicos o los constructores compatibles, mientras que toda ruta de compra continúa en Shopify.

Coloca los datos de catálogo sincronizados en Gutenberg, temas y áreas de contenido con 17 bloques y 27 shortcodes con prefijo.

Antes de empezar

• Al menos un producto y una colección sincronizados y verificados.
• Un tema o plantilla de página cuyo ancho de contenido y tipografía sean conocidos.
• Un método de renderizado elegido: Gutenberg, shortcode, Elementor PRO o WPBakery PRO.
• Una decisión canónica y de indexación para la superficie de producto de WordPress.

Prepara un punto de restauración e identifica el registro Shopify de referencia y la URL o pantalla de administración de WordPress que probará el resultado. La prueba debe ser lo bastante pequeña para repetirse sin crear un estado de catálogo ambiguo.

Alcance y límites actuales

La presencia de un constructor no demuestra atributos, controles, marcado ni salida idénticos. Once shortcodes públicos no tienen componente dedicado en ninguno de los tres constructores, y CollectionProductsPerPage existe solo en los constructores en la versión candidata exacta.

Mantén visible el modelo de responsabilidad durante toda la tarea: Shopify sigue siendo la fuente comercial y el sistema de pago; ShopiPress conecta, sincroniza y renderiza el catálogo según los contratos entregados; WordPress es el contexto de publicación. Un resultado correcto en WordPress no debe interpretarse como una transferencia de pedidos, clientes, pagos o autoridad sobre el inventario.

Procedimiento

1. Abre la superficie Añadir a mis páginas y decide si encaja mejor una salida compuesta de producto o colección, o bien componentes granulares.
2. Inserta el bloque de Gutenberg entregado o copia el shortcode exacto con su prefijo en el área de contenido prevista.
3. Para los constructores PRO, añade el componente nativo y compara sus controles con la referencia de shortcodes o bloques en lugar de suponer paridad.
4. Previsualiza la página en anchos de escritorio y móvil, incluidas variantes, disponibilidad, precio y estados vacíos.
5. Sigue la acción de compra hasta la creación del carrito y confirma que el pago está alojado en Shopify.

No omitas el paso de revisión entre una acción administrativa y la publicación pública. Una respuesta correcta del control es solo una capa de evidencia; el registro guardado en WordPress, la página renderizada y la ruta comercial de Shopify deben coincidir.

Verificar el resultado

• La identidad y el precio del producto renderizado coinciden con el registro sincronizado.
• La maquetación funciona con navegación por teclado y a 320 píxeles sin desbordamiento horizontal.
• El enlace de compra o la acción de carrito apuntan a la ruta comercial prevista de Shopify.

Verifica el resultado en la página WordPress renderizada y en la superficie autorizada de Shopify, no solo dentro de la pantalla de administración de ShopiPress. Usa un producto representativo con datos de precio, disponibilidad, variante y colección. Repite la operación segura más pequeña cuando la idempotencia importe y registra cualquier diferencia antes de ampliar la prueba.

Errores frecuentes

• Componente granular vacío: confirma que la página aporta el contexto de producto o colección requerido.
• La salida del constructor difiere: consulta la matriz de cobertura y prueba el renderizador propio del constructor; no trates la cobertura conceptual como paridad de marcado.
• La compra falla: verifica la identidad del producto y de la variante, la conexión Storefront pública y la respuesta del carrito de Shopify.

Cuando un resultado sea inesperado, detén las acciones amplias y reduce el caso a un registro, una URL y un renderizador. Conserva la respuesta fallida antes de cambiar ajustes o vaciar cachés para que el diagnóstico siga siendo reproducible.

Resolución de problemas

1. Confirma la versión y la edición del paquete.
2. Reproduce el caso seguro más pequeño con datos controlados.
3. Identifica si Shopify, ShopiPress o WordPress es responsable del paso que falla.
4. Compara el resultado observado con el estado de capacidad entregado, parcial o ausente.
5. Restaura el entorno de prueba, repite una vez y anota si el resultado es estable.

Seguridad y datos

No pegues tokens en campos de constructores de páginas ni en HTML personalizado. Trata el CSS proporcionado por el usuario y el acceso al constructor como capacidades de publicación privilegiadas.

Registra la versión instalada, la edición, las versiones de WordPress y PHP, el constructor o la integración SEO activa, la URL exacta, el viewport y las acciones ordenadas que produjeron el resultado. Captura únicamente datos de catálogo controlados. Oculta el token Storefront, los datos de clientes, la información de pedidos, los dominios privados y cualquier secreto de entorno antes de que un artefacto salga del espacio de validación.

Consecuencias SEO

Inspecciona la URL final, los encabezados, los enlaces internos, el canónico, el robots y los datos estructurados. Una vista previa visualmente correcta en el constructor no prueba que los rastreadores reciban el HTML previsto.

Evidencia que registrar

Registra la versión instalada, la edición, las versiones de WordPress y PHP, el constructor o la integración SEO activa, la URL exacta, el viewport y las acciones ordenadas que produjeron el resultado. Captura únicamente datos de catálogo controlados. Oculta el token Storefront, los datos de clientes, la información de pedidos, los dominios privados y cualquier secreto de entorno antes de que un artefacto salga del espacio de validación.

Guías relacionadas

• Instalación
• Publicar con WordPress
• Google y SEO
• Seguridad y datos

Versión y estado del producto

ShopiPress está publicado oficialmente en Freemius. Esta guía describe la versión documentada. Los enlaces de compra y descarga se añadirán a este sitio cuando sus destinos estén configurados.