Instalar un tema y cargar su contenido de ejemplo
Un tema es el escaparate: lo que ve el cliente. El panel y la tienda van por separado, así que cambiar de tema no toca tus productos ni tus pedidos.
Instalarlo
Sección titulada «Instalarlo»Copia la carpeta del tema dentro de themes/. El panel lee esa carpeta del
disco: en cuanto tenga un theme.json válido, aparece en Panel → Temas.
Si tus temas viven en otro sitio, dilo con THEMES_DIR en el .env.
Cada tema declara en su theme.json qué stack usa (Next, Astro, Vite, Nuxt…),
qué páginas trae y qué variables de entorno necesita. Eso es el
contrato de tema, y es lo que permite que
temas de tecnologías distintas convivan en el mismo catálogo.
Cargar su contenido de ejemplo
Sección titulada «Cargar su contenido de ejemplo»Un tema recién puesto se ve vacío, y así no se puede juzgar. Casi todos traen contenido de ejemplo: categorías y productos con foto y precio.
En Panel → Temas, el botón del paquete te enseña qué trae antes de meterlo — cuántos productos, cuántas categorías y si el contenido es válido. Un botón que solo dijera «instalar demo» te obligaría a aceptar a ciegas.
Al importar:
- No borra nada. Lo que ya tuvieras se queda.
- Es idempotente. Si un producto ya existe con el mismo identificador, se actualiza en vez de duplicarse. Puedes importar dos veces sin miedo.
- Va a un canal de venta propio del tema. Esto es lo importante: si tienes el contenido de ejemplo de dos temas en la misma tienda, cada escaparate ve solo el suyo. Sin eso, la pastelería enseñaría los productos del growshop.
Al terminar te da la clave publicable del tema. Ponla en su .env
(COMMERCE_KEY, o VITE_… / NEXT_PUBLIC_… según el stack): sin esa clave
su web no ve ningún producto, y el error no dice que falte una clave.
Activarlo
Sección titulada «Activarlo»Activar conmuta el panel a la tienda de ese tema y le carga su contenido de ejemplo. Si el tema tiene su propia tienda declarada, es otro backend con sus propios usuarios: puede pedirte la contraseña de esa tienda.
Activar no cambia la web pública. El escaparate lo sirve otra aplicación, en otro puerto, y no se entera. Para cambiar lo que ve el cliente hay que desplegar ese tema.
Personalizarlo
Sección titulada «Personalizarlo»Personalizar abre el editor: colores, tipografías, textos y bloques de la
portada, según lo que el tema declare en su settings.schema.json. Se guarda
por tienda, así que actualizar el tema no pisa tu configuración.
Cuando algo no cuadra
Sección titulada «Cuando algo no cuadra»«0 productos» en la web → falta la clave publicable en el .env del tema, o
no coincide con el canal donde está el contenido.
El escaparate enseña productos que no son suyos → están todos en el mismo canal de venta. Reimporta el contenido de ejemplo: los coloca en el canal del tema.
«Este tema no trae contenido de ejemplo» → no tiene demo/contenido.json.
No es un error, es que no lo trae.
Ver también
Sección titulada «Ver también»- Contrato de tema — qué debe cumplir un tema
- Seguridad de los temas — qué riesgo tiene instalar uno de terceros