Salta ai contenuti
SeC kLebSeC kLeb

AI-HTML Theme

AI-HTML e il tema base dell’ecosistema Smart eCommerce. Fornisce cornice sito, template, menu, header, footer, SEO, bridge verso plugin e Code Slots.

Responsabilita

Sezione intitolata “Responsabilita”
  • Header, footer e template base.
  • Menu WordPress e risorse di identita del sito.
  • Bridge verso Smart Bootstrap Manager, Smart Builder Site e Smart Customizer Frameworks.
  • API di integrazione per AI e builder.
  • Code Slots per sezioni controllate del tema.

Code Slots

Sezione intitolata “Code Slots”

I Code Slots permettono di aggiungere o sostituire blocchi controllati del tema, per esempio header e footer. Gli slot sono ordinati per hook e priorita.

Endpoint principale:

/wp-json/aihtml/v1/ai/code-slots

Operativita AI

Sezione intitolata “Operativita AI”

Una AI puo:

  • leggere Manifest AI-HTML;
  • aggiornare opzioni whitelist;
  • creare, disattivare o rimuovere Code Slots non distruttivi;
  • generare pagine base;
  • verificare menu, logo, social e contatti.

Una AI non deve:

  • duplicare contenuti di Smart Builder Site nel tema;
  • sostituire menu WordPress con copie statiche;
  • hardcodare logo, menu, social, contatti o form quando esistono componenti runtime;
  • introdurre JS critico per contenuto SEO;
  • fare deploy/reset live senza conferma.

Contratto runtime pubblico

Sezione intitolata “Contratto runtime pubblico”

AI-HTML espone risorse dinamiche a Smart Builder Site, AI Canvas e agenti AI tramite:

/wp-json/aihtml/v1/ai/integration-manifest

Le risorse runtime da usare nel markup sono:

<smart-logo variant="transparent" class="site-logo"></smart-logo>
<smart-menu location="naviga" class="site-menu" depth="3"></smart-menu>
<smart-social class="site-social-link"></smart-social>
<smart-contact field="email" link="true"></smart-contact>
<smart-addon provider="contact_form_7" id="123"></smart-addon>

Per menu e logo, la AI deve leggere il manifest e usare resources.menus e resources.logos. Sul progetto Smart eCommerce la location attiva e naviga; non va sostituita con link statici generati a mano.

Verifica

Sezione intitolata “Verifica”
  • endpoint manifest disponibile;
  • pagina sorgente contiene header/footer corretti;
  • mobile menu funzionante;
  • Code Slot ordinati per hook e priorita;
  • nessun duplicato Bootstrap rispetto a Smart Bootstrap Manager.

Documenti locali utili

Sezione intitolata “Documenti locali utili”
  • AI-html/ARCHITECTURE.md
  • AI-html/THEME-INTEGRATION-CONTRACT.md
  • AI-html/CODE-SLOTS-GUIDE.md
  • AI-html/JSON-IMPORT-GUIDE.md
  • AI-html/MOBILE-NAVIGATION-TECHNICAL.md