Vai al contenuto

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 dashboard dell'app: ricavi, ordini, imposte e spedizioni del periodo scelto, con il grafico La lista degli ordini con numero, cliente, importo e stato Il dettaglio di un ordine con stato, data, totale, fatture e cliente La lista dei prodotti con SKU, prezzo e giacenza La scheda di un prodotto con SKU, tipo, stato, visibilità e prezzo Il report degli ordini con il grafico delle vendite e i totali

Disponibile su Google Play

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 dell'assistente con il coupon XMAS10 già preparato: codice, tipo di sconto, importo, subtotale minimo e siti, con i pulsanti Approve e Deny

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.

Il page builder a schermo intero: il pannello dei blocchi a sinistra, un blocco trascinato nel contenuto e l'anteprima dello storefront a destra

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.

La nuova pagina di accesso dell'admin, in modalità scura, con il pulsante Log with Passkey sotto le credenziali

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.

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.

La pagina prodotto con le miniature a destra dell'immagine e la scritta che indica il layout scelto

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.

L'editor immagini dell'admin con la foto aperta, il pannello degli strumenti a destra e la striscia dei filtri

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:all passa 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 ./maho e 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. Ora symfony/mcp-bundle e nyholm/psr7 sono 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 migrate converte 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-run mostra la lista. Da app/etc/local.xml va 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:resize e 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_Queue disattivato 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 usano mahoFetch(). ./maho health-check elenca i template con un form POST senza chiave.
  • Il runtime del browser: ./maho sys:playwright:install una 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 con strict_types e 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