ShopiPress 1.0.0 · 02
Conectar Shopify con seguridad
Usa el subdominio de la tienda y un token público de la API Storefront, prueba la conexión y preserva la frontera comercial.
Se aplica a ShopiPress 1.0.0, publicado oficialmente en Freemius.
Flujo verificado
- Introduce el subdominio myshopify.com.
- Prueba la conexión antes de guardar.
- No uses credenciales privadas de Admin API.
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
Una tienda Shopify queda conectada con su subdominio myshopify.com y un token público de la API Storefront. La prueba de conexión se completa sin introducir una credencial privada de la API Admin.
Usa el subdominio de la tienda y un token público de la API Storefront, prueba la conexión y preserva la frontera comercial.
Antes de empezar
- Una tienda Shopify existente y permiso para crear u obtener un token Storefront público.
- Una instalación de ShopiPress operativa cuya identidad candidata ya haya sido verificada.
- Conexiones HTTPS salientes desde WordPress hacia el endpoint Storefront myshopify.com configurado.
- Ningún dato de cliente, pedido, pago ni credencial privada de la API Admin en las notas de prueba.
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 versión candidata exacta admite la conexión de una sola tienda. Una conexión correcta verifica el acceso a Storefront; no demuestra que cada registro del catálogo pueda sincronizarse ni que exista automatización en segundo plano.
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
- Copia únicamente el subdominio de la tienda que espera el campo, no una URL arbitraria con rutas o parámetros de consulta.
- Introduce el token Storefront público. No lo sustituyas por un token de acceso de la API Admin cuando una prueba falle.
- Elige Probar conexión y espera una respuesta explícita de éxito o de error.
- Guarda solo después de que la prueba de conexión se complete y la identidad de tienda mostrada sea la prevista.
- Pasa al descubrimiento del catálogo, revisa su resumen y mantén manual la primera sincronización.
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 superficie Inicio indica la tienda conectada en lugar de Desconectado.
- El descubrimiento del catálogo puede consultar la fuente sin exponer el token en páginas renderizadas ni en capturas.
- Una acción de compra sigue resolviéndose a través de Shopify y no de un motor transaccional de WordPress.
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
- Respuesta no autorizada: comprueba de nuevo que el token es público, está activo y corresponde a la tienda prevista.
- Tienda no encontrada: normaliza el subdominio myshopify.com y elimina protocolos, barras y dominios ajenos.
- Error de red: confirma que WordPress puede realizar peticiones HTTPS salientes y que ninguna capa de seguridad bloquea el endpoint Storefront.
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
- Confirma la versión y la edición del paquete.
- Reproduce el caso seguro más pequeño con datos controlados.
- Identifica si Shopify, ShopiPress o WordPress es responsable del paso que falla.
- Compara el resultado observado con el estado de capacidad entregado, parcial o ausente.
- Restaura el entorno de prueba, repite una vez y anota si el resultado es estable.
Seguridad y datos
El token público merece igualmente un tratamiento controlado porque delimita el acceso a la tienda. No lo publiques en tickets, capturas, grabaciones de navegador ni configuraciones versionadas. Restringe la administración de ShopiPress a roles de confianza.
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
La conexión no cambia por sí sola ninguna decisión canónica. Antes de publicar los productos sincronizados, decide si Shopify o WordPress es la superficie principal de producto y verifica la respuesta renderizada en lugar de fiarte de una etiqueta de ajustes.
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
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.
Mantén visible la frontera
Shopify gestiona el comercio, ShopiPress transporta el catálogo y WordPress publica.
Shopify · catálogo y pago
ShopiPress · sincronización y renderizado
WordPress · contenido, plantillas y SEO
Verifica antes de continuar
- Confirma el resultado en WordPress.
- Mantén carrito y pago en Shopify.
- Registra la versión al informar un error.