Maho 26.7.0: la nuova API, l'admin ridisegnato e lo schema del database
La 26.7.0 porta l'API su REST v2 e GraphQL, il backend ridisegnato, lo schema dichiarativo, il secondo fattore per i clienti e il recesso UE.
La 26.7.0 cambia tre cose di fondo: come si parla con Maho dall’esterno, come si presenta l’area di amministrazione e come si descrive il database. Intorno ci sono anche il secondo fattore per i clienti e il pulsante di recesso che la normativa europea chiede ai negozi che vendono al consumatore.
L’API nuova
L’API è riscritta su API Platform e offre circa 140 endpoint REST con 212 operazioni, su prodotti, categorie, ordini, fatture, spedizioni, note di credito, clienti, carrelli, checkout completo, CMS, blog, recensioni, liste desideri, newsletter, coupon, carte regalo, inventario, tasse, directory e negozi. Ogni risorsa risponde sia in REST, in JSON o JSON-LD, sia in GraphQL, con gli stessi provider e processori.
L’autenticazione usa i token JWT, revocabili e rivalidati a ogni richiesta, con i grant per cliente,
client credentials e il vecchio utente API. I permessi sono granulari per risorsa e operazione, con un
editor dei ruoli nell’admin e account di servizio legati a uno o più siti. Ci sono la cache HTTP con
ETag e invalidazione per tag, le chiavi di idempotenza sul database, il rate limit e una lista di
origini ammesse per CORS. La specifica OpenAPI 3.1 è su /api/docs.json, e un modulo può aggiungere
risorse con l’attributo #[Maho\Config\ApiResource].
In 26.7.0 questa parte va considerata beta: è coperta da 565 test automatici ed è pronta per
costruirci sopra, con rifiniture attese nelle versioni successive. I moduli Mage_Api e Mage_Api2
sono segnati come deprecati.
L’admin ridisegnato
Il backend è stato ridisegnato da zero, senza dipendenze nuove e senza passo di build: una palette grafite neutra con il verde di Maho come unico accento. La modalità scura segue il sistema operativo oppure si sceglie dal pulsante nell’intestazione, e la scelta viene applicata prima del primo disegno della pagina, senza sfarfallio.
Con il nuovo stile cambiano intestazione con ricerca globale, menu a scomparsa, griglie, form, schede, configurazione di sistema, dashboard, finestre e browser dei media. La ricerca globale si apre e si chiude da tastiera ed è navigabile con uno screen reader. Tutte le misure sono passate a unità relative, quindi l’area admin rispetta la dimensione del carattere impostata nel browser.
Lo schema del database dichiarativo
Tutti i 47 moduli del core che possiedono tabelle descrivono ora lo schema in modo dichiarativo su Doctrine DBAL. Un’installazione esistente viene allineata sul posto, in modo idempotente, e arriva allo stesso risultato di un’installazione nuova su MySQL, MariaDB e PostgreSQL. Un passaggio di normalizzazione toglie le differenze solo rappresentative, quindi vengono applicate solo le modifiche strutturali vere, e colonne o tabelle non dichiarate restano dove sono.
La parte sui dati resta imperativa: gli script sql/ e data/ convivono con il nuovo sistema, e i
moduli di terze parti continuano a funzionare senza modifiche. Le date sentinella 0000-00-00
lasciano il posto a colonne nullable.
Il secondo fattore per i clienti
Il secondo fattore TOTP, che proteggeva solo l’admin, è disponibile anche per i clienti, per scelta di ciascun cliente e con la possibilità per il negozio di renderlo obbligatorio. Si attiva da una pagina dedicata dell’area cliente leggendo un codice QR, e l’accesso riconosce il secondo fattore e chiede il codice, come già succede nell’admin. Anche i percorsi senza password, come il Magic Link, passano dalla verifica. I segreti sono cifrati. La guida al doppio fattore per i clienti copre attivazione e iscrizione.

Il pulsante di recesso
Dal 19 giugno 2026 la direttiva europea 2023/2673 chiede ai negozi che vendono al consumatore
nell’Unione un pulsante per recedere dal contratto. Maho lo porta nel core come modulo, spento di
default: c’è un modulo pubblico su /revocation, un widget da inserire in una pagina CMS e una voce
nell’area cliente entro il periodo di recesso configurato. Configurazione e integrazione sono
descritte nell’approfondimento sul pulsante di recesso europeo.
Ogni richiesta viene scritta in una tabella che vale come ricevuta, prima di qualunque email, con orari in UTC e il controllo che l’ordine appartenga davvero a chi scrive. La protezione dagli abusi è fatta di trappola per i bot, controllo del tempo di compilazione, Altcha e limiti per indirizzo IP e per email. Le richieste si gestiscono in Sales > Revocation Requests, con esportazione CSV e accettazione o rifiuto con commento sull’ordine.

Contenuti, ricerca e media
- Dati strutturati Schema.org per prodotti, breadcrumb, organizzazione, ricerca del sito e post del blog, con la configurazione in Catalog > Structured Data;
- SEO della navigazione a livelli: le pagine filtrate e paginate sono
noindex, i link dei filtri sononofollowe il canonical ha un comportamento predefinito sensato; - PDF allegati alle email di fattura, spedizione e nota di credito;
- Media Cleaner in System > Tools > Media Cleaner, che trova i file orfani della libreria;
- i widget Bestsellers e On Sale per lo storefront.
Aggiornare alla 26.7.0
È un aggiornamento di linea: conviene leggere per intero le note della release prima di iniziare,
perché il cambio dello schema del database e il nuovo modulo API toccano il modo in cui il negozio è
fatto. Chi ha moduli che usano le vecchie API li tiene d’occhio, dato che Mage_Api e Mage_Api2
sono deprecati, e chi vuole il pulsante di recesso lo attiva dopo l’aggiornamento.
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.7.0
Il tuo negozio vende ancora?
Raccontaci da dove parti: ti rispondiamo con una prima valutazione, senza impegno.
Chiedi l'analisi del negozio