Changelog - Template Bootstrap .Italia

• .it-category: Versione template (uppercase, tracking, opacity 0.9)
• h2: Titolo template (2rem, bold, white)
• p: Descrizione (nascosta mobile con d-none d-lg-block)
• .it-btn-container: Container bottoni (flex, gap, center, wrap)
• hr: Separatore credits (border white opacity 25%)
• .small: Footer credits (opacity 0.8, link white)

• Default: background: white; color: #0066cc;
• Hover: background: #f0f6ff; color: #004d99; transform: translateY(-2px); box-shadow

• Default: background: rgba(255,255,255,0.1); color: white; text-shadow: 0 1px 2px rgba(0,0,0,0.2)
• Hover: background: white; color: #0066cc; text-shadow: none; transform: translateY(-2px)
• ✅ Fix: Background semi-trasparente + text-shadow per visibilità in dark mode

• language/it-IT/it-IT.tpl_bootstrapitalia.ini - Aggiunta sezione "Install Template Messages" (7 costanti iniziali)
• language/en-GB/en-GB.tpl_bootstrapitalia.ini - Traduzioni inglesi delle stesse costanti

• TPL_BOOTSTRAPITALIA_INSTALL_TITLE - "Template Installato" / "Template Installed"
• TPL_BOOTSTRAPITALIA_INSTALL_DESC - Descrizione configurazione template
• TPL_BOOTSTRAPITALIA_INSTALL_BTN_CONFIGURE - "Configura Template" / "Configure Template"
• TPL_BOOTSTRAPITALIA_INSTALL_BTN_SAMPLE - "Installa Dati di Esempio" / "Install Sample Data"
• TPL_BOOTSTRAPITALIA_POWERED_BY - "Powered by"
• TPL_BOOTSTRAPITALIA_POWERED_BY_AUTHOR - "Claudio Rosselli" (poi rimossa - v2 cleanup)
• TPL_BOOTSTRAPITALIA_POWERED_BY_URL - "https://iamawebmaster.com" (poi rimossa - v2 cleanup)

• install/templates/update.html.twig - Sostituzione stringhe con {{'TPL_CONST'|t}}
• install/templates/install.html.twig - Sostituzione stringhe con {{'TPL_CONST'|t}}

• ❌ Gantry ThemeInstaller non carica automaticamente sistema lingua Joomla nel contesto Twig
• ❌ Filtri Twig translation (|t, |trans) non registrati in ambiente install isolato
• ❌ Sistema lingua Joomla potenzialmente non completamente inizializzato durante install phase
• ✅ Factory::getLanguage()->load() + Text::_() funzionano correttamente lato PHP

• Step 1: Caricamento esplicito file lingua

  $lang = Factory::getLanguage();
  $lang->load('tpl_bootstrapitalia', JPATH_SITE . '/templates/bootstrapitalia');

• Step 2: Creazione array traduzioni con Text::_()

  $translations = array(
      'install_title' => Text::_('TPL_BOOTSTRAPITALIA_INSTALL_TITLE'),
      'install_desc' => Text::_('TPL_BOOTSTRAPITALIA_INSTALL_DESC'),
      'btn_configure' => Text::_('TPL_BOOTSTRAPITALIA_INSTALL_BTN_CONFIGURE'),
      'btn_sample' => Text::_('TPL_BOOTSTRAPITALIA_INSTALL_BTN_SAMPLE'),
      'powered_by' => Text::_('TPL_BOOTSTRAPITALIA_POWERED_BY'),
      'powered_by_author' => 'Claudio Rosselli',  // Hardcoded v2
      'powered_by_url' => 'https://iamawebmaster.com'  // Hardcoded v2
  );

• Step 3: Passaggio array come secondo parametro a render()

  echo $installer->render('update.html.twig', $translations);

• ❌ Rimosso: {{'TPL_CONST'|t}} (filtro non disponibile)
• ✅ Aggiunto: {{ variable }} (interpolazione variabili diretta)
• Esempio: <h2>{{ name }} - {{ install_title }}</h2>
• Footer: {{ powered_by }} <a href="{{ powered_by_url }}">{{ powered_by_author }}</a>

• ⚠️ Problema riscontrato: TPL_BOOTSTRAPITALIA_POWERED_BY_AUTHOR visualizzata come stringa costante letterale (non tradotta)
• ✅ Decisione: Hardcode valori author/URL direttamente in PHP (nome/link autore non cambiano per lingua)
• ✅ Vantaggio affidabilità: Eliminata dipendenza da sistema lingua potenzialmente incompleto in install phase
• ✅ Risultato: Crediti sempre visualizzati correttamente indipendentemente da stato sistema lingua

• ✅ Hero section visualizzata correttamente post-installazione e post-update
• ✅ Stringhe tradotte in italiano (lingua sistema default test)
• ✅ Cambio lingua Joomla riflesso correttamente in install templates
• ✅ Nessun errore PHP/Twig in console o log Joomla
• ✅ Credits "Powered by Claudio Rosselli" sempre visibili (hardcoded)

.btn-light {
    background: white;
    color: #0066cc !important;  /* Aggiunto !important per cross-theme consistency */
    border: 1px solid white;
}

• ✅ Testo blu #0066cc sempre visibile su sfondo bianco
• ✅ Contrasto WCAG AA compliant in light e dark mode
• ✅ !important forza blu text anche con override tema aggressivi
• ✅ Hover effect mantenuto (background: #f0f6ff; color: #004d99;)

• language/it-IT/it-IT.tpl_bootstrapitalia.ini - Da 7 a 5 costanti attive
• language/en-GB/en-GB.tpl_bootstrapitalia.ini - Da 7 a 5 costanti attive

• ❌ TPL_BOOTSTRAPITALIA_POWERED_BY_AUTHOR="Claudio Rosselli"
• ❌ TPL_BOOTSTRAPITALIA_POWERED_BY_URL="https://iamawebmaster.com"

• ✅ TPL_BOOTSTRAPITALIA_INSTALL_TITLE
• ✅ TPL_BOOTSTRAPITALIA_INSTALL_DESC
• ✅ TPL_BOOTSTRAPITALIA_INSTALL_BTN_CONFIGURE
• ✅ TPL_BOOTSTRAPITALIA_INSTALL_BTN_SAMPLE
• ✅ TPL_BOOTSTRAPITALIA_POWERED_BY

• ✅ Codebase più pulita (no dead code)
• ✅ Manutenzione semplificata (informazioni author in un solo punto: install.php)
• ✅ Performance minima (2 costanti in meno da caricare/parsare)

• install.php (~24 righe aggiunte, metodo postflight)
• install/templates/update.html.twig (~7 sostituzioni stringhe → variabili)
• install/templates/install.html.twig (~8 sostituzioni stringhe → variabili)
• install/templates/style.html.twig (1 riga, aggiunto !important)
• language/it-IT/it-IT.tpl_bootstrapitalia.ini (sezione Install: 5 costanti finali)
• language/en-GB/en-GB.tpl_bootstrapitalia.ini (sezione Install: 5 costanti finali)

• 📘 Pattern Gantry install context: PHP translation + variable passing (non Twig filters)
• 📘 Affidabilità install phase: Hardcode valori critici quando lingua system potrebbe essere incompleta
• 📘 CSS cross-theme: !important necessario per forzare consistenza visiva in contesti isolati
• 📘 DRY principle: Cleanup immediato informazioni duplicate dopo refactoring

• ✅ Hero section Bootstrap Italia completamente funzionale (Fase 1 + Fase 2)
• ✅ Internazionalizzazione completa (it-IT, en-GB), estendibile ad altre lingue
• ✅ Contrasto perfetto WCAG AA in light/dark mode
• ✅ Zero dipendenze CDN (tutto inline CSS)
• ✅ Zero conflitti backend Joomla
• ✅ Codebase pulito (no dead code, no duplicazioni)
• ✅ Sistema lingua robusto (fallback hardcoded per valori critici)

• ✅ install.php: Classe BootstrapItaliaInstallerScript con hooks preflight/postflight/update
• ✅ MD5SUMS: File manifest esistente (110 righe) con formato filepath\thash per ogni file template
• ✅ templateDetails.xml: Sezione <files> con elenco folder/file ufficiali, versione corrente in <version>

1. Fase Pre-Update: Nel metodo preflight('update') leggere MD5SUMS esistente e salvare lista file versione precedente in sessione/cache
2. Fase Post-Update: Nel metodo postflight('update') confrontare lista vecchia vs nuovo MD5SUMS + templateDetails.xml <files>
3. Cleanup Orphan: Eliminare file presenti in lista vecchia ma assenti in nuova versione (escluso whitelist custom/)
4. Logging: Registrare operazioni in file log per audit trail e rollback manuale se necessario