Ir al contenido principal

ArtinTech Solution

Leafwise Shopify theme homepage next to a clean Theme Check result

La mayoría de los temas de Shopify a medida empiezan como una copia de Dawn. Es gratis, rápido y lo mantiene Shopify. Para Leafwise, un tema para viveros y tiendas de plantas que vendemos en nuestra propia tienda, ese punto de partida no era posible.

Así escribimos un tema de Shopify desde cero: por qué no bifurcamos Dawn, cómo está organizado el tema y los problemas de herramientas que encontramos hasta lograr un Theme Check limpio.

Sobre este artículo: Leafwise es nuestro propio producto, así que todo procede del proyecto real. Los ejemplos de código están abreviados, no inventados.

Leafwise Shopify theme homepage next to a clean Theme Check result
Leafwise junto a una ejecución limpia de Theme Check. (Ilustración.)

¿Por qué no bifurcar Dawn?

La licencia de Dawn permite construir sobre él, pero los temas derivados de Dawn solo pueden distribuirse a través de la Shopify Theme Store. Queríamos vender Leafwise directamente, con nuestro precio y nuestra licencia. Eso significaba ni una línea de Dawn: ni la estructura de secciones, ni el JavaScript, ni el CSS.

Empezar con una carpeta vacía también tuvo ventajas. Cada sección existe porque una tienda de plantas la necesita, y no queda nada de una tienda de moda.

La arquitectura en un párrafo

Leafwise es un tema Online Store 2.0 sencillo: plantillas JSON, un grupo de cabecera y otro de pie, y secciones con bloques en todas partes. Siete esquemas de color viven en un grupo de esquemas, y un snippet convierte cada uno en una clase CSS con propiedades personalizadas, de modo que cualquier sección cambia de esquema con un ajuste. No hay framework ni paso de compilación. Las partes interactivas son pequeños custom elements en cuatro archivos diferidos.

  • side-drawer y cart-drawer para el menú, la búsqueda y el carrito
  • product-form, variant-picker, media-gallery y sticky-atc en las páginas de producto
  • facets-area para filtros sin recargar, predictive-search para sugerencias
  • plant-quiz y filter-tabs en la portada

El carrito: una petición, todas las secciones actualizadas

Al añadir al carrito hay que actualizar a la vez el panel, el contador de la cabecera y la navegación móvil. La Section Rendering API lo hace en la misma petición: pedimos a Shopify que renderice las secciones necesarias y cambiamos su HTML.

formData.append('sections', 'cart-drawer,cart-count');
formData.append('sections_url', window.location.pathname);
const res = await fetch('/cart/add.js', { method: 'POST', body: formData });
const data = await res.json();
// data.sections['cart-drawer'] is fresh HTML for the drawer

Cada elemento que muestra datos del carrito lleva el atributo data-cart-section, así que un sitio nuevo que muestre el carrito solo necesita el atributo, no más JavaScript.

Theme Check decía “0 files inspected”

En Windows, shopify theme check terminaba sin errores e informaba de cero archivos revisados, desde cualquier carpeta. Un resultado limpio que no ha revisado nada es peor que un error. Llamamos al mismo verificador directamente desde su paquete de Node:

const { themeCheckRun } = require('@shopify/theme-check-node');
const { offenses, theme } = await themeCheckRun(root, undefined, console.error);
console.log('Files inspected:', theme.length);

Encontró un error y cuatro avisos, entre ellos un nombre de sección demasiado largo. Tras las correcciones: 90 archivos, 0 errores, 0 avisos.

El zip que Shopify podría rechazar

Compress-Archive de PowerShell escribía el zip con barras invertidas en las rutas, es decir sections\header.liquid en vez de sections/header.liquid. Algunos descompresores y validadores no lo aceptan. Generamos el zip con ZipArchive de .NET y escribimos cada ruta con barras normales.

$rel = $file.FullName.Substring($src.Length + 1).Replace('\', '/')
[IO.Compression.ZipFileExtensions]::CreateEntryFromFile($zip, $file.FullName, $rel)

Lo que volveríamos a hacer igual

  • Sin framework: cuatro archivos pequeños cargan más rápido que cualquier bundle y se leen con facilidad
  • Section Rendering API para todo lo que toca el carrito
  • Ejecutar Theme Check desde el paquete de Node en CI y fallar si no se revisó ningún archivo
  • Probar pronto en una tienda de desarrollo real. Theme Check estaba limpio, pero la tienda aún encontró ocho errores, tema de nuestro próximo artículo

Leafwise está a la venta en Charming Theme. Si necesitas un tema de Shopify hecho desde cero para tu tienda, consulta nuestro servicio de desarrollo de temas Shopify.

Preguntas frecuentes

¿Puedo vender un tema basado en Dawn fuera de la Theme Store?

La licencia de Dawn solo permite distribuir temas derivados a través de la Shopify Theme Store. Para vender en otro sitio, escribe tu propio código.

¿Cuánto más lleva un tema desde cero que una bifurcación de Dawn?

Más al principio, porque el carrito, los filtros y la lógica de variantes los escribes tú. A cambio, cada línea es tuya y no arrastras código sin usar.

¿Un tema de Shopify moderno necesita paso de compilación?

No. CSS normal con propiedades personalizadas y pequeños custom elements cubren todo lo que Leafwise necesita.

Share this article

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *