Crear un tema¶

Enfoque¶

El uso de MageObsidian Components para temas marca un cambio radical en la forma en que se integran los temas frontend en Magento. Este enfoque elimina por completo el soporte para tecnologías heredadas como LESS, Knockout y RequireJS, y adopta herramientas y prácticas modernas.

Además, este nuevo estándar no solo garantiza una base más limpia y eficiente para el desarrollo de temas, sino que también mejora significativamente la experiencia de desarrollo. Al simplificar y modernizar las metodologías, MageObsidian Components busca atraer a nuevos desarrolladores al ecosistema de Magento, ofreciendo un entorno más intuitivo y alineado con las tendencias actuales en desarrollo web.

Configuración de Compatibilidad¶

A diferencia de los módulos, no recomendamos incluir soporte para MageObsidian Components en temas existentes que utilicen metodologías relacionadas con Luma o Blank. Este enfoque es radical y elimina completamente el soporte para tecnologías como LESS, Knockout, RequireJS, entre otros. Por lo tanto, sugerimos que este enfoque sea empleado únicamente en temas nuevos o en temas basados en MageObsidian Components.

Crear un Tema Compatible¶

Para crear un tema, primero sigue los pasos estándar descritos en la documentación oficial de Magento:
Creación de un tema en Magento

En resumen, necesitas crear una estructura como esta:

app/design/frontend/Vendor/ThemeName

Archivos Básicos¶

Asegúrate de incluir los archivos mínimos necesarios para registrar un tema en Magento:

registration.php
theme.xml

Declarar la Herencia del Tema¶

theme-default
padretheme-base
assets de módulosMódulos

Al configurar el archivo theme.xml, presta atención si deseas heredar de un tema compatible. Si declaras un tema no compatible como tema padre, la herencia será ignorada durante los pasos de compilación y el tema no funcionará como se espera.

Configuración de Compatibilidad del Tema¶

Para configurar un tema como compatible con MageObsidian Components, sigue estos pasos:

Crear el Archivo de Compatibilidad
- Nombre del archivo:
mage_obsidian_compatibility.xml

- Ruta del archivo:  
  Guarda el archivo en la siguiente ubicación:  
  ```
  app/design/frontend/Vendor/ThemeName/etc/mage_obsidian_compatibility.xml
  ```

Agregar el Contenido del Archivo
- Copia y pega el siguiente contenido en el archivo:

  ```xml
  <?xml version="1.0"?>
  <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:noNamespaceSchemaLocation="urn:magento:module:MageObsidian_ModernFrontend:etc/xsd/mage_obsidian_theme_compatibility.xsd">
        <features>
             <compatibility>true</compatibility>
        </features>
  </config>
  ```

Pasos Finales¶

Una vez configurado el archivo de compatibilidad, es necesario ejecutar los siguientes comandos para integrar el tema en Magento y generar los metadatos necesarios:

Cargar el tema en Magento
```
bin/magento setup:upgrade
```

Generar metadatos para MageObsidian Components

bin/magento mage-obsidian:frontend:config --generate

Notas Finales¶

Con estos pasos, tu tema estará completamente integrado con MageObsidian Components. Este enfoque garantiza que el tema aproveche al máximo las funcionalidades modernas de la arquitectura, eliminando dependencias de tecnologías obsoletas y promoviendo una experiencia más eficiente y limpia.