# Note di reintegro post-upgrade VTE 26.04 (Fibbi)

Data analisi: 2026-05-13
Sorgente backup: /var/www/html/vte23083_2711 (versione pre-upgrade 25.02.2 build 3001)
Target: 26.04 build 3367 su PHP 8.3-FPM

## Riepilogo

Su 34 file segnalati come "diversi dall'originale" dall'updater VTE:
- 33 file = solo vendor (upgrade core 25.02.2 -> 26.04). NON reintegrare.
- 1  file = customizzazione reale (branding tema next22). Reintegrato via SDK ufficiale.

## File VENDOR (NON reintegrare)

Motivazioni ricorrenti, tutte coerenti con le guide vendor su
https://usermanual.vtenext.com/books/developers :

1) Header SPDX Vtenext aggiunto su tutti i file .php/.tpl/.js vendor.
2) Migrazione a RequestHandler: $_REQUEST['x'] / vtlib_purify(...) sostituiti
   con RH::r('x'), RH::ensureMethod('POST'), ecc.
3) Smarty con escaping automatico: rimossi VStr::toHtmlAttr(...) e
   VStr::toHtml(...) ridondanti dai .tpl.
4) Patch funzionali vendor riferite a ticket crmv@... (es. 345110, 348708).
5) CSS minificati (style.css, jquery-ui.css, vte_materialize.css, dp.css,
   style_login.css, datetimepicker.css): sono BUILD OUTPUT del nuovo SCSS,
   non vanno mai editati a mano (li rigenera compile.sh).
6) maintenance.php: in 25.02.2 era vuoto, in 26.04 contiene il default
   "$vte_maintenance = false;" — niente da reintegrare.

Elenco vendor (33):
  Smarty/templates/modules/Reports/EditStepAdvFilters.tpl
  Smarty/templates/modules/Reports/ClustersList.tpl
  Smarty/templates/modules/Messages/DetailViewHeader.tpl
  Smarty/templates/PopupContents.tpl
  Smarty/templates/SelectEmail.tpl
  Smarty/templates/ReportContents.tpl
  Smarty/templates/ComposeEmail.tpl
  include/js/ListView.js
  include/utils/VTEOAuthClient/VTEOAuthClient.php
  include/utils/ListViewUtils.php
  include/utils/EditViewUtils.php
  include/utils/RequestHandler.php
  include/ListView/ListViewController.php
  Popup.php
  modules/SDK/src/Todos/Utils.php
  modules/Users/RecoverPwd.php
  modules/Reports/EditReport.js
  modules/VteCore/FolderEdit.php
  modules/Emails/Emails.php
  modules/Emails/EditView.php
  modules/Utilities/FolderHandler.php
  modules/CustomView/ShowColumn.php
  modules/DocFolders/DocFolders.php
  modules/DocFolders/FolderManagerAjax.php
  modules/Calendar/ActivityReminderCallbackAjax.php
  modules/Popup/index.php
  maintenance.php
  themes/next22/style_login.css
  themes/next22/datetimepicker.css
  themes/next22/style.css
  themes/next22/vte_materialize.css
  themes/next22/dp.css
  themes/next22/jquery-ui.css

## File CUSTOM (reintegrato)

  themes/next22/scss/vars/_colors.scss

Contenuto rilevante nel backup:
    $vte-primary: #333 !default;
    $accent-color: #D38600 !default;
    @import 'sdk_overrides';

In 26.04 questo file e' stato riscritto dal vendor e l'aggancio agli
override SDK e' stato spostato in:
  themes/next22/scss/vars/_sdk_overrides.scss     (light mode)
  themes/next22/scss/vars/_sdk_overrides_dm.scss  (dark mode)

REINTEGRO EFFETTUATO in _sdk_overrides.scss (light mode):
    $vte-primary:       #333333;
    $vte-primary-dark:  #1a1a1a;
    $vte-primary-light: #cccccc;
    $vte-accent:        #D38600;

Dark mode: _sdk_overrides_dm.scss lasciato invariato (nessun branding dark
era presente nel pre-upgrade). Se in futuro Fibbi attivera' la dark mode,
replicare lo stesso blocco li'.

Font: pre-upgrade usava "Open Sans, sans-serif"; 26.04 default e' "Inter".
Decisione conservativa: mantenere "Inter" (default vendor 26). In
_sdk_overrides.scss e' stato lasciato un commento con la variabile esatta
($font-family-sans-serif) per ri-attivare Open Sans se richiesto.

## Cosa fare per finalizzare

  cd /var/www/html/vte23083_2711/themes/next22
  sudo apt install -y ruby-sass        # se manca il binario 'sass'
  sudo -u www-data php ./compile.sh

Hard refresh nel browser. I CSS rigenerati conterranno il branding nero/oro.

## Cosa NON fare mai

- Non copiare nessuno dei 33 file vendor dal backup in produzione: causerebbe
  errori su PHP 8.3 + 26 (RequestHandler mancante, escaping doppio Smarty,
  ecc.).
- Non editare i CSS minificati: vengono sovrascritti da compile.sh.
- Non riscrivere _colors.scss del 26 con la versione 25: API diverse, rompe.