Maho 26.11.0: assistente AI nell'admin, page builder e media su bucket
La 26.11.0 porta un assistente in ogni pagina dell'admin, il page builder nei contenuti, i file su S3, Google Cloud o Azure e un admin ridisegnato su daisyUI.
La 26.11.0 cambia tre cose che si usano tutti i giorni: come si chiede qualcosa all’admin, come si compone un contenuto e dove stanno i file. Intorno a queste arriva il resto, compreso un admin ridisegnato, la gallery della pagina prodotto con i suoi layout e il passaggio a PHP 8.5. È anche la prima release che accompagna Maho Admin, l’app nativa per gestire il negozio da telefono o tablet, ora su Google Play.
Maho Admin, il negozio in tasca
La 26.11.0 è la prima release con cui funziona Maho Admin, l’app ufficiale per iPhone, iPad e Android. L’app parla direttamente con il negozio: nessun server in mezzo e nessun tracciamento. Mostra vendite, ordini, bestseller e visitatori per ogni sito e store view, e serve a spedire un ordine dal magazzino o a correggere un prezzo in treno. È su Google Play, arriva presto sull’App Store, e l’abbonamento costa 9,99 € al mese per istanza, con tutti i suoi siti e le sue store view.
La connessione usa lo stesso flusso OAuth dei client MCP, e il nuovo permesso Connect Applications lascia approvare l’app a un amministratore senza il potere di revocare le connessioni di tutti gli altri. Ogni amministratore vede e scollega le proprie applicazioni in System > My Account, e la pagina di consenso OAuth funziona su un telefono.
Un assistente in ogni pagina dell’admin
Un utente dell’admin apre un pannello con Option+A o Alt+A e chiede in linguaggio naturale. L’assistente legge il negozio con gli stessi strumenti che il server MCP espone, risponde con i link ai record e, su una pagina di dettaglio, compila il form aperto senza salvarlo. Ogni scrittura aspetta una conferma con il valore prima e dopo, e una modifica confermata si può annullare.
Il pannello è spento di default e si accende in System > Configuration > AI >
Assistant > Enable Admin Assistant. Serve un provider AI configurato e la
risorsa ACL system/ai/chat, e le conversazioni sono per singolo
amministratore. Le istruzioni ricorrenti si danno in System > AI > Assistant
Scheduled Tasks, con un’espressione cron nel fuso del negozio e un pubblico per
il risultato, che arriva nella inbox dell’admin. System > AI > Assistant
Actions Log elenca ogni scrittura eseguita, negata o fallita.
Sulla qualità delle risposte la release riporta una misura: su 49 domande su swatch, regole catalogo, impostazioni e ordini, Haiku 5.5 passa dal 49% al 78% di risposte corrette o dichiaratamente incerte, e Sonnet 5.5 dal 76% al 94%. Aiuta il fatto che la guida utente, la documentazione per chi sviluppa, quella dell’API e quella dell’hosting vivano ora nel repository accanto ai moduli, così ogni negozio legge le pagine della propria versione.
Il quadro completo, con i tool, i limiti e le regole di conferma, è nell’approfondimento su l’assistente dell’admin.
Il page builder nei contenuti
Il tab Contenuto di pagine CMS, blocchi statici e post del blog si apre a schermo intero come page builder: un pannello di blocchi a sinistra, il contenuto al centro, l’anteprima dello storefront a destra. L’anteprima è una bozza renderizzata dal server nel tema della store view selezionata, quindi mostra il contenuto non ancora salvato.
Con lo stesso lavoro l’editor renderizza widget e blocchi come li vede il
visitatore, un pulsante Source apre l’HTML in un editor di codice che completa
le classi del tema e ne mostra il CSS, e le classi Tailwind o daisyUI scritte nei
contenuti entrano nel foglio di stile dello storefront. Un salvataggio mette in
coda la compilazione, e ./maho theme:content:build la esegue in un deploy.
MageMEGA è stata parte del processo e ha lanciato l’idea con un proof of concept
(discussione #1572, un modulo standalone senza patch al core), poi fuso nel core
come Design Mode di empiricompany/maho-design-mode. Il funzionamento, i limiti
dell’anteprima e cosa resta dopo un salvataggio sono
nell’approfondimento sul page builder.
I file su S3, Google Cloud o Azure
Un negozio può girare su più nodi web senza disco condiviso. Ogni file che i nodi
devono leggere, media, upload dei clienti, prodotti scaricabili, sitemap, feed e
file di import ed export, passa da un mount di archiviazione con un nome, e
app/etc/local.xml punta ogni mount a S3 o a uno storage compatibile, a Google
Cloud Storage o ad Azure Blob Storage. Un server singolo con disco locale
mantiene gli stessi percorsi e gli stessi URL, e anche lì il guadagno c’è: le
immagini del catalogo non occupano disco sull’hosting, e i file li serve lo
storage con il suo URL pubblico o la CDN che gli sta davanti.
Tre comandi coprono il lavoro noioso: ./maho storage:migrate copia i file
esistenti sul bucket, ./maho storage:image:resize crea in anticipo le immagini
ridimensionate e ./maho storage:image:clean cancella le misure che nessun
template usa.
Un mount privato, come un file caricato da un cliente o un download acquistato, ha il suo spazio e non finisce mai nel bucket pubblico dei media. Il percorso e le opzioni sono nell’approfondimento sui media su bucket.
Un admin ridisegnato su daisyUI
Bottoni, campi, checkbox, messaggi, etichette di stato, box, tab, menu principale
e griglie usano ora i componenti di daisyUI 5 a una densità da pannello di
controllo, in modalità chiara e scura. Lo skin dell’admin ha il suo build di
Tailwind CSS 4 e daisyUI 5, come lo storefront, compilato da
./maho dev:admin:theme:build. Le pagine di accesso, password dimenticata,
reimpostazione e consenso OAuth sono nuove e stanno su uno schermo da telefono: quella
di accesso mette il pulsante Log with Passkey sotto le credenziali, e chi ha
registrato una passkey entra senza digitare la password.
Nella scheda prodotto le immagini sono card con un interruttore per ogni ruolo e si riordinano trascinando, anche da tastiera. Le etichette dei bottoni sono corte e coerenti: Save, Delete, Add, Submit, Save and Continue.
Gallery, immagini e le correzioni che si vedono
La gallery della pagina prodotto ha layout con le miniature sotto, a sinistra o a destra dell’immagine, oppure una griglia di tutte le immagini in una, due o tre colonne, in System > Configuration > Design > Product Page Gallery. Su telefono è un carosello a scorrimento con contatore, e “Phone Layout” riporta il layout precedente.
Nello stesso filone, ogni prodotto ha una sola Main Image: Small Image e
Thumbnail sceglievano solo una misura, e i template ora nominano uno slot
(getImgAttributes('listing')), che scrive src, srcset, sizes, width e
height. Le immagini ridimensionate di prodotti, categorie, post e swatch
nascono in coda al salvataggio, quindi categorie e blog non servono più i file a
misura originale.
L’editor immagini: upscale e regolazioni
L’editor delle immagini dell’admin prende due strumenti nuovi. Adjust porta dieci slider divisi in tre gruppi, luce, colore ed effetti, tredici filtri pronti e una linea di confronto da trascinare sulla foto, che mostra l’originale e il risultato nello stesso punto. Al posto di Hue e Warmth arrivano Temperature e Tint, cioè un bilanciamento del bianco vero, quello che serve quando la foto del prodotto è stata scattata in una stanza con la luce sbagliata. Upscale ingrandisce l’immagine fino a quattro volte, per i file che il fornitore manda a 256 pixel e che in scheda prodotto si vedrebbero sgranati. Si sceglie 2× o 4×, e il modello gira in un web worker dentro il browser, sulla scheda grafica quando c’è e altrimenti sul processore: la foto non viene inviata a nessun servizio, quindi passa di qui anche un’immagine che non si vuole far uscire dal negozio. Funziona fino a 1024 pixel sul lato lungo, oltre conviene ridimensionare prima.
Le opzioni degli strumenti si sono spostate in un pannello a destra della foto, e la guida utente ha una pagina dedicata all’editor.
Sul resto della release:
- reindex completo da tre a cinque volte più veloce (#1582): sullo store di
esempio con 1.040 prodotti e 15 store view,
index:reindex:allpassa da 5,2 a 0,95 secondi su SQLite, da 4,54 a 1,63 su MySQL e da 5,58 a 1,09 su PostgreSQL. Gli indici indipendenti girano in parallelo e un rebuild degli URL rewrite manda 545 query invece di 17.079; - righe libere nella creazione ordine da admin (#1577), per un costo di installazione, un acconto o un pezzo su misura, con nome, prezzo, classe di imposta e peso, che poi attraversano imposta, fattura, spedizione, nota di credito e modifica ordine come qualsiasi altra riga;
- CAP e regione validati per paese nel checkout, nella rubrica, nella registrazione e nei form dell’admin (#1481), con il paese come primo campo e un esempio di CAP nel segnaposto;
- un prodotto eliminato risponde 410 invece di 404 (#1444), e lo store ricorda quegli URL per 365 giorni;
- un limite ai filtri selezionabili nella navigazione a livelli (#1705): oltre Maximum Selected Filters, 7 per default, la pagina risponde 404 prima di caricare i prodotti;
- le azioni lunghe dell’admin girano in background (#1675): regole di relazione tra prodotti, export e import, con il risultato in System > Notifications.
La base tecnica si sposta di una major
Maho richiede ora PHP 8.5.1, gira su Symfony 8.1 e su API Platform
5.0, e ogni comando del terminale è un comando invocabile di Symfony Console con
argomenti e opzioni dichiarati su __invoke(). Il sanitizer SVG è riscritto sul
DOM e sul parser di URL WHATWG di PHP 8.5, quindi legge ogni link come lo legge un
browser.
Lato API, i client possono cercare prodotti con il metodo HTTP QUERY (RFC
10008) su /api/products, con i filtri in un corpo JSON, e una Scalar API
Reference è su /api/docs?ui=scalar, accanto a Swagger UI e ReDoc. La sezione
API dell’admin copre molto lavoro quotidiano: ordini, fatture, spedizioni, note di
credito e clienti si cercano come nelle griglie, le regole di prezzo del carrello
si gestiscono con condizioni e coupon, e i report e la ricerca globale sono
leggibili da un client.
Due cose escono dal core: il catalogo flat, con le due impostazioni, i due
bottoni di rebuild e i due indexer, e i profili ricorrenti, che nessun metodo
di pagamento poteva più elaborare da quando il vecchio modulo PayPal è uscito. Le
tabelle catalog_*_flat_* restano nel database e si eliminano a mano per
liberare spazio.
Sul fronte sicurezza, ogni azione dello storefront che cambia dati controlla la
form key, i messaggi di sessione sono sempre escapati, i download e l’editor non
escono più dalla propria cartella, e ogni release pubblica maho-<versione>.zip
con il suo SBOM CycloneDX e una provenienza di build firmata, verificabile con
gh attestation verify.
Cosa sapere prima di aggiornare
La guida di aggiornamento della release è lunga, perché questa è una major. Questi sono i punti da mettere in conto.
- Prima PHP 8.5.1, poi Maho. Su una versione precedente
./mahoe lo store si fermano con un errore di piattaforma di Composer. - I vincoli di Composer: Symfony
^8.1,api-platform/core^5.0,doctrine/dbal^4.5,mahocommerce/maho-composer-plugin^5.2. Orasymfony/mcp-bundleenyholm/psr7sono pacchetti richiesti. - Un backup del database, perché due aggiornamenti cancellano dati senza tornare indietro: Catalog 2.0.2 copia Small Image e poi Thumbnail in una Base Image vuota, ora Main Image, e cancella i due attributi con i loro valori; Sales 2.0.3 elimina le tabelle dei profili ricorrenti. Gli ordini restano.
./maho migrateconverte in utf8mb4 tutte le tabelle MySQL e MariaDB, comprese quelle di terze parti. Su un negozio grande serve una finestra di manutenzione:./maho migrate --dry-runmostra la lista. Daapp/etc/local.xmlva tolto<initStatements>SET NAMES utf8</initStatements>, che Maho ignora.- Su nginx una regola nuova per le immagini ridimensionate, quella documentata
nella guida del web server. Dopo il deploy si esegue una volta
./maho storage:image:resizee si svuota la cache delle pagine; su un bucket conviene farlo prima di aprire il negozio. Ogni immagine ridimensionata ha un URL nuovo, e la pulizia cancella i file vecchi, quindi gli URL nelle email già spedite smettono di funzionare. - Cron e worker della coda devono girare: ridimensionamento delle immagini,
export, import, regole catalogo e aggiornamento delle statistiche passano dalla
coda. Un negozio con
Maho_Queuedisattivato si ferma al caricamento, e un export non è più un download: la notifica linka il file. - Ogni POST dello storefront vuole una form key. Un pagamento, un webhook o un
ritorno del gateway va elencato in
$_publicActions, un form del tema stampa<?= $this->getBlockHtml('formkey') ?>e le chiamate JavaScript usanomahoFetch()../maho health-checkelenca i template con un form POST senza chiave. - Il runtime del browser:
./maho sys:playwright:installuna volta, altrimenti la scansione di accessibilità dell’admin fallisce. - Un negozio che aveva acceso MCP prima che i pacchetti fossero installati ora
ha un endpoint attivo su
/api/mcp: vale la pena controllare l’interruttore e MCP Requires Authentication. - Il permesso Connect Applications: approvare una connessione OAuth chiede ora
la risorsa
api_connect. L’aggiornamento copia la regola di ogni ruolo esistente, ma un ruolo creato dopo la richiede. - Con “Use Categories Path for Product URLs” su No gli URL di categoria dei prodotti diventano 301 al reindex successivo.
- Per chi scrive estensioni, i metodi di accesso tipizzati su tutti i modelli
Mage_*, i file constrict_typese i comandi riscritti su__invoke()sono i tre cambi che fanno fallire un override senza i tipi giusti.
Come aggiornare
Il percorso è quello di sempre e la guida di aggiornamento della 26.11.0 va tenuta
aperta mentre si lavora. Prima di toccare la produzione conviene provare su una
copia, aggiornare PHP, controllare che cron e worker della coda girino, e
verificare che il tema non copi i template elencati nella guida, da
sales/order/history.phtml a catalog/product/helper/gallery.phtml.
Testo preparato con l'aiuto dell'AI e verificato sulla fonte prima della pubblicazione. Può contenere errori: se ne trovi uno, segnalalo.Leggi il Manifesto
Fonte: Release 26.11.0
Il tuo negozio vende ancora?
Raccontaci da dove parti: ti rispondiamo con una prima valutazione, senza impegno.
Chiedi l'analisi del negozio
