Vai al contenuto

Maho 26.11.1 chiude il callback di PayPal e riporta i giorni nei report

Nessuna funzionalità nuova nella 26.11.1: due correzioni di sicurezza, i report che non perdono più giorni di statistiche, i prezzi con imposta allineati al carrello e i feed che esportano il prezzo giusto.

La 26.11.1 è una release di manutenzione per la linea 26.11: nessuna funzionalità nuova, solo correzioni riprese da main. Conviene installarla presto, perché porta due correzioni di sicurezza e quella dei report che perdevano interi giorni di statistiche.

Sicurezza

  • #1775 limita il callback di spedizione del checkout PayPal. Chi conosceva l’ID dell’ordine PayPal di un carrello poteva cambiare indirizzo e metodo di spedizione di quel carrello con POST /paypal/checkout/shippingCallback. Il callback ora accetta solo le richieste che arrivano da PayPal.
  • #1817 toglie le credenziali dai log di debug. Con Debug acceso il log dei pagamenti mostrava in chiaro l’API login ID e la transaction key di Authorize.Net, e il log delle spedizioni lo site ID e la password di DHL. Al loro posto ora c’è ***.

Le correzioni della patch

  • Report e statistiche: #1709 ricostruisce ogni periodo che un aggiornamento parziale svuota. I cron notturni aggregate_sales_report_* e Refresh Statistics for the Last Day cancellavano interi periodi e ricostruivano solo le righe create dopo la data di partenza, così i giorni restavano fuori dai report Fatturato, Rimborsato, Spedizioni, Bestseller, Imposte, Coupon e Prodotti visti fino a un refresh completo. #1741 sistema le etichette dei report mensili, che leggevano 2026-0 in ogni riga: ora si leggono 2026-01, 2026-02 e così via, e un report annuale non ripete più l’anno corrente in ogni riga. Gli item renderer dell’admin mostrano anche l’imposta nella valuta giusta.
  • Fatture, note di credito e rimborsi: #1723 fa tornare i conti delle note di credito con uno sconto sulla spedizione. Una nota di credito creata dall’API senza shippingAmount rimborsava la spedizione senza il suo sconto, la spedizione con imposta rimborsava troppo poco, l’ultimo articolo veniva rifiutato dopo il rimborso della spedizione e i rimborsi parziali arrotondavano ogni quota per conto proprio. Le note di credito di un ordine ora sommano al totale pagato. #1728 corregge la fattura nuova che, dopo l’annullamento della fattura con la spedizione, risultava più alta dello sconto sulla spedizione e faceva catturare quell’importo maggiore. E #1733 ferma i rimborsi API con offlineRefund: false che l’ordine contava come rimborsati online senza arrivare al gateway di pagamento: ora l’API risponde 422 e chiede un rimborso offline.
  • Prezzi: #1735 allinea la pagina prodotto al carrello, che potevano differire di un centesimo. Un prezzo netto di 11.4754 con imposta al 22% si vedeva 14.00 sulla pagina prodotto e costava 14.01 nel carrello: ora tutti i punti che mostrano il prezzo mostrano 14.01. Per un prezzo lordo tondo, la strada è Catalog Prices su Including Tax.
  • Feed: #1772 fa esportare il prezzo che il negozio applica. Durante una promozione Facebook, Bing, Pinterest, Google Local Inventory e OpenAI mandavano lo stesso importo come prezzo e come prezzo scontato, e Trovaprezzi mandava un prezzo speciale scaduto. Con i mapping predefiniti il feed esporta il prezzo senza promozioni scadute o future, il truncate transformer conta anche il suffisso e una generazione che non riesce ad avanzare si ferma tenendo il feed precedente. #1738 non cambia più il titolo di un prodotto quando una virgoletta segue un backslash, e un feed con delimitatore pipe o punto e virgola, o con apice singolo come enclosure, non fallisce più con “No valid data rows found”. Anche l’enclosure “None” funziona di nuovo. #1739 segnala come errore il prodotto che un feed JSON non riesce a serializzare, per esempio per un valore INF: prima il prodotto spariva mentre il feed lo contava come scritto. E #1746 sistema i feed JSON e XML personalizzati con caratteri speciali: una virgoletta o un backslash nella chiave radice del JSON, o ]]> in un testo prodotto con CDATA, producevano un file non valido.
  • Giacenza: #1811 riporta fuori stock i prodotti bundle, configurabili e raggruppati con tutti i figli esauriti. Le liste mostravano “View Details” per un prodotto che non si poteva comprare, e API e feed erano d’accordo con loro. Un feed con Exclude Out of Stock ora lascia fuori quel prodotto.
  • Assistente AI: #1623 porta Maho su Symfony AI 1.0.0-BETA1, mcp/sdk 0.9 e API Platform 5.0.6, e fa fallire subito un task con un errore che un nuovo tentativo non può risolvere, per esempio una API key sbagliata.
  • Admin: #1706 toglie il doppio bordo dai campi in focus e fa scorrere dentro la propria card una pagina più larga della finestra, così una tabella larga non spinge più i pulsanti Save fuori dallo schermo. #1795 separa nome e stato nella finestra di generazione di un feed e aggiunge la barra di avanzamento, con una card verde quando il feed è pronto. #1807 traduce le pagine Gift Card e il menu dell’account anche con una locale diversa dall’inglese, e nove altri moduli avevano lo stesso problema nell’admin o sullo storefront. #1781 riaccende l’editor di testo ricco nelle home page dei dati di esempio, che si spegneva con colspan e rowspan, e salva come digitato un alt con & o una lista di classi Tailwind. #1749 sistema completamenti e diagnostica del language server dopo un testo Unicode, dove un accento, un carattere CJK o un’emoji spostavano l’intervallo del completamento e rompevano hover e go to definition.
  • Storefront e tema: #1724 ricostruisce subito il foglio di stile dello storefront dopo ./maho dev:frontend:theme:build, che fino a un cache:flush lasciava il vecchio css/styles.css nell’head. Un salvataggio di contenuto nell’admin arriva sullo storefront dopo 10 secondi invece di un minuto, e una build di contenuto fallita lascia un messaggio nella inbox dell’admin. #1793 fa funzionare il rinvio del JavaScript anche su una pagina con uno script inline oltre i 24 KB, che prima usciva invariata senza niente nel log. #1794 legge come JSON una risposta AJAX con il charset, dove mahoFetch perdeva i campi di errore e di scadenza della sessione, e non manda più un trace context vecchio nelle richieste in uscita tracciate.
  • Clienti, ordini e spedizioni: #1713 toglie l’errore 500 dalla pagina prodotto e da quella di confronto per le sessioni aperte prima della 26.11.0, che tengono gli ID del visitatore e del cliente come stringhe mentre i setter tipizzati vogliono un intero. #1717 salva di nuovo una regola carrello o catalogo con una data From o To, che prima falliva con un errore fatale. #1745 impedisce all’automazione email di mandare il coupon monouso di un cliente a un altro: al cliente 1 poteva arrivare il codice del cliente 12, e chi lo usava per primo lasciava l’altro con un codice morto. #1780 sblocca i form protetti da captcha che restavano su “Verifying…” su alcuni browser mobili, con il widget ALTCHA che emetteva load prima di avere i metodi pronti. E #1777 tiene disponibili le tariffe originali di FedEx per un ordine con spedizione gratuita parziale, dove la seconda quotazione del peso imponibile poteva alzare un errore PHP o sostituire i metodi.
  • API e integrazioni: #1816 fa vincere una sola richiesta quando due chiamate parallele a POST /api/oauth/token mandano lo stesso refresh token o lo stesso authorization code: l’altra revoca la grant, come succede con un token riusato. #1740 salva un ruolo API legacy con un ruolo padre, che prima falliva con un TypeError. #1747 restituisce redirectType: 302 per un URL rewrite con opzione R, che l’API riportava come 301. #1768 lascia passare ./maho migrate su MySQL quando il database contiene una view con una colonna TIMESTAMP, dove si fermava con 1347 'example_view' is not BASE TABLE e lasciava non applicati tutti gli script successivi. Anche ./maho legacy:fix-zero-dates e il health check ora saltano le view.
  • Testi e link: #1788 porta l’avviso sull’arrotondamento delle imposte alla guida sul calcolo delle imposte di Maho, al posto della copia archiviata nel 2015 di una pagina Magento rimossa.

Prima di aggiornare

La patch non introduce impostazioni nuove. Questi sono i punti da mettere in conto.

  • Symfony AI 1.0.0-BETA1: se il progetto richiede un bridge di provider (symfony/ai-open-ai-platform, symfony/ai-anthropic-platform, symfony/ai-gemini-platform, symfony/ai-mistral-platform, symfony/ai-open-router-platform o symfony/ai-ollama-platform), va richiesta la ^1.0 di quel bridge, altrimenti composer update fallisce. Finché Symfony AI 1.0 non è stabile servono anche i pacchetti beta, con "minimum-stability": "beta" e "prefer-stable": true.
  • Rimborsi API con "offlineRefund": false: ora ricevono un 422. Quei rimborsi non arrivavano mai al gateway, quindi conviene controllare le note di credito create così e rimborsarle dal gateway.
  • Prezzi con imposta: su un prezzo di catalogo con più di due decimali possono cambiare di un centesimo nella pagina prodotto, nei prezzi a scaglioni, nei dati strutturati, nei feed, negli eventi di analytics e nelle email di avviso prezzo. Il prezzo nuovo è quello che il carrello applicava già.
  • Contenuti dell’editor di testo ricco: un contenuto salvato prima di questa release può avere unsafe: all’inizio di un attributo. Vale la pena cercare ="unsafe: nelle pagine CMS, nei blocchi CMS e nelle descrizioni di prodotti e categorie. Nell’admin window.xssKillah non esiste più: al suo posto si chiama xssFilter() o DOMPurify.sanitize().
  • Traduzioni di Gift Card e altri moduli: dopo l’aggiornamento va svuotata la cache translate.
  • Mapping dei feed: i mapping salvati non cambiano. Conviene rivedere i campi del prezzo e delle date di promozione per adottare i valori predefiniti nuovi, poi rigenerare i feed.
  • Build del tema: ./maho dev:frontend:theme:build compila anche le classi dei contenuti. In uno script di build che non deve toccare il database va aggiunto --no-content. Con -n i comandi di build del tema non installano più la toolchain di Tailwind: serve --force.
  • Firme tipizzate: una riscrittura dei metodi elencati qui sotto deve usare la firma tipizzata nuova, e setExpirationDate() prende una stringa UTC Y-m-d H:i:s o null, non un DateTime.
// firma tipizzata obbligatoria
Mage_Customer_Model_Session::getCustomerId()
Mage_Reports_Model_Product_Index_Abstract::getVisitorId()
Mage_Reports_Model_Product_Index_Abstract::getCustomerId()
Mage_Catalog_Model_Product_Compare_Item::addCustomerData()
Mage_Catalog_Model_Product_Compare_Item::addVisitorId()

// stringa UTC "Y-m-d H:i:s" oppure null, non un DateTime
Mage_SalesRule_Model_Coupon::setExpirationDate()

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.1

Il tuo negozio vende ancora?

Raccontaci da dove parti: ti rispondiamo con una prima valutazione, senza impegno.

Chiedi l'analisi del negozio