Vai al contenuto

Attributi e set di attributi anche per categorie, clienti e contenuti

Una pull request aperta porta gli attributi personalizzati su categorie, clienti, indirizzi, post del blog e pagine CMS, con i valori nelle API.

Chi ha amministrato un negozio su Magento 1 conosce questa asimmetria: gli attributi esistono per i prodotti, con i loro set, i gruppi e le schede, e per tutto il resto non esiste niente. Un campo in più su una categoria, un numero di registrazione aziendale sul cliente, una stagione su una pagina CMS: ogni volta serve un modulo che aggiunga la colonna e la pagina di admin. La pull request #1674 di fballiano porta lo stesso meccanismo dei prodotti su cinque tipi di record che ne erano fuori. Non è unita: questo è il quadro del ramo oggi.

Cosa aggiunge

In System > Attributes compare una voce per ogni tipo di record: Blog Categories, Blog Posts, Categories, CMS Pages, Customer Addresses e Customers. Ogni voce apre la griglia degli attributi, e il pulsante Attribute Sets apre i set. Gli attributi dei prodotti restano dove sono, sotto Catalog > Attributes.

Il menu System con la voce Attributes aperta sulle sei sezioni

Il modello è quello che si conosce dai prodotti, applicato agli altri record:

  • un attributo ha un codice, un tipo di input e un’etichetta, e il codice e il tipo non si cambiano dopo il salvataggio;
  • un set raccoglie gli attributi in gruppi, e ogni gruppo diventa una scheda nella pagina del record;
  • i valori visibili si mostrano sullo storefront in una tabella, con la posizione impostata sull’attributo.

Le differenze stanno in come ogni tipo lega il set al record. Le categorie e i record del blog tengono il set nella propria riga, come i prodotti, e il set si sceglie alla creazione. I clienti e gli indirizzi non hanno un set proprio: il set arriva dal gruppo di clienti, che ne ha uno per il cliente e uno per l’indirizzo. Le pagine CMS non hanno set, e ogni pagina ha tutti gli attributi di pagina.

L’editor del set Brand, con un attributo nella scheda General Information

Perché conta

Il caso che rende l’idea è il gruppo di clienti. Un negozio che vende all’ingrosso e al dettaglio può dare al gruppo Wholesale un set con la partita IVA e i dati di fatturazione, e lasciare il gruppo Retail senza quei campi. Un attributo sceglie in quali form compare (registrazione, account, rubrica, checkout, admin) e, per ogni sito, se è nascosto, facoltativo o obbligatorio: lo stesso campo può essere obbligatorio sul sito B2B e invisibile sull’altro.

Le sezioni Forms, Input Rules e Websites di un attributo cliente

Sul checkout la catena non si interrompe: i valori degli attributi dell’indirizzo vengono copiati sull’ordine, e l’ordine conserva l’etichetta dell’opzione scelta, così il documento mostra quello che il cliente ha visto anche se l’opzione viene rinominata dopo. Un riordino dall’admin riporta i valori nel carrello.

Gli altri tre tipi coprono il resto del lavoro editoriale. Il blog post e la categoria del blog mostrano i valori visibili sul frontend, e l’import dei post legge il set e una colonna per ogni attributo. Le pagine CMS guadagnano una scheda Attributes nel form di modifica, una colonna nell’import per ogni attributo, e un modo semplice per il tema di leggere il valore. Per le categorie c’è un attributo in più che il negozio usa spesso, il marchio, e la pagina categoria lo mostra sotto la descrizione.

Le API seguono lo stesso confine. Le risorse REST e GraphQL di clienti, indirizzi, post, categorie del blog e pagine CMS leggono e scrivono customAttributes, una mappa da codice a valore, e per le categorie e il blog c’è anche attributeSetId. Le scritture passano dalle regole di input dell’attributo, e un codice sconosciuto, un attributo di sistema o un’opzione che non esiste tornano un 422 con il dettaglio degli errori.

🏷️ Campo nuovo: da qui in avanti “aggiungo un campo” smette di significare “aggiungo un modulo”.

Cosa serve

Non ci sono requisiti nuovi da installare: il lavoro è dentro il core e l’admin resta quello di sempre. Tre cose da sapere prima di usarlo:

  • un ruolo di amministrazione personalizzato non vede System > Attributes finché qualcuno non gli concede le nuove risorse ACL sotto quella voce;
  • un tema che sovrascrive i template di registrazione, account, rubrica o checkout non mostra i campi nuovi finché non renderizza il blocco dei campi del form;
  • un template di email o di indirizzo mostra un valore solo se contiene {{var attribute_code}} in System > Configuration > Customers > Customer Configuration > Address Templates.

Cosa può ancora cambiare

I limiti dichiarati nella pull request sono la parte da leggere con attenzione, perché sono scelte di progetto e non dettagli:

  • il set di categoria, post e categoria del blog si sceglie alla creazione e l’admin non lo cambia dopo il primo salvataggio, come per i prodotti. Lo può cambiare l’API;
  • ogni notte il negozio cancella il valore di un attributo che non è nel set del record. Un attributo aggiunto da un modulo senza set perde i valori, a meno che qualcuno non lo metta in un set;
  • customAttributes è riservato ai token di amministrazione e API. Il token di un cliente non può ancora leggere o scrivere i propri campi, quindi uno storefront headless non può compilarli;
  • un valore di una pagina CMS è unico per tutti gli store view, e il frontend non lo mostra da solo: il tema lo legge e decide dove metterlo;
  • un attributo di indirizzo aggiunge una colonna alle tabelle degli indirizzi dell’ordine, quindi il suo codice non può usare un nome già presente nella tabella, e non può riusare il codice di un attributo cancellato.

Sopra tutto questo c’è la regola di sempre: una pull request aperta può essere riscritta, divisa o abbandonata, e quello che si legge qui è una fotografia del ramo al giorno indicato.

🏷️ Campo nuovo: il valore resta solo se l’attributo è nel set. Il resto lo decide la cancellazione notturna.

Stato

Al 30 ottobre 2026 la pull request è aperta, non unita, con 20 commit, 154 file toccati e un bilancio di 7.719 righe aggiunte e 1.149 rimosse. La descrizione dichiara lo sviluppo con l’assistenza dell’AI e la revisione umana prima del merge, come per ogni cambiamento del progetto. Chi vuole seguire il ramo lo trova su MahoCommerce/maho#1674.

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: MahoCommerce/maho#1674

Il tuo negozio vende ancora?

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

Chiedi l'analisi del negozio