Documentazione Commerce Guida alla configurazione

[Contributo di David Lambauer]{class="badge informative" title="David Lambauer"}

riferimento system.xml

Last update: Wed Sep 13 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Configuration
System

Creato per:

Experienced
Admin
Developer

Il system.xml consente di gestire la configurazione del sistema Commerce. Utilizzare questo argomento come riferimento generale per system.xml file. Il system.xml il file si trova in etc/adminhtml/system.xml in una determinata estensione di Commerce 2.

Il seguente frammento di codice mostra l'ossatura del file:

<?xml version="1.0" ?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Config:etc/system_file.xsd">
    <system>
        <!-- PLACE YOUR MODULE SPECIFIC CONFIGURATION HERE -->
    </system>
</config>

TIP

Se desideri una convalida immediata *XSD nell’IDE, puoi eseguire bin/magento dev:urn-catalog:generate [--ide IDE] [--] <path>.

Schede // Sezioni // Gruppi // Campi

In system.xml file, è possibile definire quattro diversi tipi di entità, che sono correlate tra loro. Nella sezione seguente viene descritta la relazione tra schede, sezioni, gruppi e campi. La schermata seguente mostra la configurazione del sistema Commerce 2 nel backend di amministrazione.
I quadrati rossi contrassegnano i diversi tipi definiti nella system.xml file:

Schermata che mostra una sezione configurata in Admin.

Le schede vengono utilizzate per dividere semanticamente diverse aree di configurazione. Ogni scheda può contenere una o più sezioni, a cui è possibile fare riferimento come sottomenu. Una sezione contiene uno o più gruppi.
Ogni gruppo elenca uno o più campi. È inoltre possibile utilizzare un gruppo per aggiungere una descrizione generale per i campi seguenti. Come accennato, ogni gruppo può avere uno o più campi. I campi sono l'entità più piccola nel contesto di configurazione del sistema.

Schede

A <tab>-Assegnare tag ai riferimenti a una scheda esistente o a una nuova scheda nella configurazione di sistema.

Riferimento attributo scheda

A <tab>-Tag può avere i seguenti attributi:

Attributo

Descrizione

Tipo

Obbligatorio

id

Definisce l’identificatore utilizzato che fa riferimento alla sezione.

typeId

obbligatorio

translate

Definisce il campo da tradurre. Fornire label per rendere traducibile l’etichetta.

string

facoltativo

sortOrder

Definisce l’ordinamento della sezione. I numeri alti spingono la sezione nella parte inferiore della pagina, mentre i numeri bassi spingono la sezione nella parte superiore.

float

facoltativo

class

Aggiunge una classe CSS definita all'elemento HTML scheda sottoposto a rendering.

string

facoltativo

Riferimento nodo scheda

A <tab>-Tag può avere il seguente elemento figlio:

Nodo

Descrizione

Tipo

label

Definisce l’etichetta visualizzata nel front-end.

string

Esempio: creare una scheda

Il seguente frammento di codice illustra la creazione di una nuova scheda con dati di esempio.

<?xml version="1.0" ?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Config:etc/system_file.xsd">
    <system>
        <tab id="A_UNIQUE_ID" translate="label" class="a-custom-css-class-to-style-this-tab" sortOrder="10">
            <label>A meaningful label</label>
        </tab>
    </system>
</config>

Lo snippet crea una nuova scheda con l’identificatore A_UNIQUE_ID. Come translate-attribute è definito e fa riferimento all'etichetta, il label-node è traducibile. Durante il rendering, la classe CSS a-custom-css-class-to-style-this-tab verrà applicato all'elemento HTML creato per questa scheda.
Il sortOrder-attribute con il valore di 10 definisce la posizione della scheda nell’elenco di tutte le schede sottoposte a rendering.

Sezioni

A <section>-Assegna tag ai riferimenti a una sezione esistente o nuova nella configurazione del sistema.

Riferimento attributo sezione

A <section>-Tag può avere i seguenti attributi:

Attributo

Descrizione

Tipo

Obbligatorio

id

Definisce l’identificatore utilizzato che fa riferimento alla sezione.

typeId

obbligatorio

translate

Definisce il campo da tradurre. Fornire label per rendere traducibile l’etichetta.

string

facoltativo

type

Definisce il tipo di input dell'elemento HTML sottoposto a rendering. Impostazione predefinita text.

string

facoltativo

sortOrder

Definisce l’ordinamento della sezione. I numeri alti spingono la sezione nella parte inferiore della pagina, mentre i numeri bassi spingono la sezione nella parte superiore.

float

facoltativo

showInDefault

Definisce se la sezione viene visualizzata nell'ambito di configurazione predefinito. Specifica 1 per visualizzare la sezione e 0 per nascondere la sezione.

int

facoltativo

showInStore

Definisce se la sezione viene visualizzata a livello di punto vendita. Specifica 1 per visualizzare la sezione e 0 per nascondere la sezione.

int

facoltativo

showInWebsite

Definisce se la sezione viene visualizzata a livello di sito Web. Specifica 1 per visualizzare la sezione e 0 per nascondere la sezione.

int

facoltativo

canRestore

Definisce se la sezione può essere ripristinata sul valore predefinito.

int

facoltativo

advanced

Obsoleto dalla versione 100.0.2.

bool

facoltativo

extends

Specificando un identificatore di un’altra sezione, il contenuto di questo nodo estenderà la sezione a cui hai fatto riferimento.

string

facoltativo

Riferimento nodo sezione

A <section>-Tag può avere i seguenti elementi secondari:

Nodo

Descrizione

Tipo

label

Definisce l’etichetta visualizzata nel front-end.

string

class

Aggiunge una classe CSS definita all'elemento HTML della sezione di cui è stato eseguito il rendering.

string

tab

Fa riferimento alla scheda associata. Prevede l’ID della scheda.

typeTabId

header_css

Né utilizzato né valutato al momento di questa scrittura.

string

resource

Fa riferimento a una risorsa ACL per fornire le impostazioni delle autorizzazioni per questa sezione.

typeAclResourceId

group

Definisci uno o più sottogruppi.

typeGroup

frontend_model

Specifica un modello front-end diverso per modificare il rendering e l'output.

typeModel

include

Utilizzato per includere system_include.xsd file compatibili. Di solito utilizzato per strutturare grandi system.xml file.

includeType

Esempio: creare una sezione e assegnarla a una scheda

Il seguente frammento di codice illustra l'utilizzo di base della creazione di una nuova sezione.

<?xml version="1.0" ?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Config:etc/system_file.xsd">
    <system>
        <tab id="A_UNIQUE_ID" translate="label" class="a-custom-css-class-to-style-this-tab" sortOrder="10">
            <label>A meaningful label</label>
        </tab>

        <section id="A_UNIQUE_SECTION_ID" showInDefault="1" showInWebsite="0" showInStore="1" sortOrder="10" translate="label">
            <label>A meaningful section label</label>
            <tab>A_UNIQUE_ID</tab>
            <resource>VENDOR_MODULE::path_to_the_acl_resource</resource>
        </section>
    </system>
</config>

La sezione descritta sopra definisce l’ID A_UNIQUE_SECTION_ID, è visibile nella vista di configurazione predefinita e in un contesto store. Il label-node è traducibile. La sezione è associata alla scheda con l’ID A_UNIQUE_ID. È possibile accedere alla sezione solo da utenti che dispongono delle autorizzazioni definite nell’ACL VENDOR_MODULE::path_to_the_acl_resource.

Gruppi

Il <group>-Tag viene utilizzato per raggruppare i campi.

Riferimento attributo gruppo

A <group>-Tag può avere i seguenti attributi:

Attributo

Descrizione

Tipo

Obbligatorio

id

Definisce l’identificatore utilizzato che fa riferimento al gruppo.

typeId

obbligatorio

translate

Definisce i campi da tradurre. Fornire label per rendere traducibile l’etichetta. Più campi devono essere separati da uno spazio.

string

facoltativo

type

Definisce il tipo di input dell'elemento HTML sottoposto a rendering. Impostazione predefinita text.

string

facoltativo

sortOrder

Definisce l’ordinamento della sezione. I numeri alti spingono la sezione nella parte inferiore della pagina, mentre i numeri bassi spingono la sezione nella parte superiore.

float

facoltativo

showInDefault

Definisce se il gruppo viene visualizzato nell'ambito di configurazione predefinito. Specifica 1 per mostrare il gruppo e 0 per nascondere il gruppo.

int

facoltativo

showInStore

Definisce se il gruppo viene visualizzato a livello di archivio. Specifica 1 per mostrare il gruppo e 0 per nascondere il gruppo.

int

facoltativo

showInWebsite

Definisce se il gruppo viene visualizzato a livello di sito Web. Specifica 1 per mostrare il gruppo e 0 per nascondere il gruppo.

int

facoltativo

canRestore

Definisce se il gruppo può essere ripristinato al valore predefinito.

int

facoltativo

advanced

Obsoleto dalla versione 100.0.2.

bool

facoltativo

extends

Specificando un identificatore di un altro gruppo, il contenuto di questo nodo estenderà la sezione a cui si fa riferimento.

string

facoltativo

Riferimento nodo di gruppo

A <group>-Tag può avere i seguenti elementi secondari:

Nodo

Descrizione

Tipo

label

Definisce l’etichetta visualizzata nel front-end.

string

fieldset_css

Aggiunge una o più classi CSS a un set di campi gruppo.

string

frontend_model

Specifica un modello front-end diverso per modificare il rendering e l'output.

typeModel

clone_model

Specifica un determinato modello per clonare i campi.

typeModel

clone_fields

È stata abilitata o disabilitata la clonazione dei campi.

int

help_url

Non estensibile. Vedi sotto.

typeUrl

more_url

Non estensibile. Vedi sotto.

typeUrl

demo_link

Non estensibile. Vedi sotto.

typeUrl

comment

Aggiunge un commento sotto l'etichetta del gruppo. Utilizzando <![CDATA[//]]> HTML può essere applicato.

string

hide_in_single_store_mode

Indica se il gruppo deve essere visibile in modalità archivio singolo. 1 nasconde il gruppo; 0 mostra il gruppo.

int

field

Definisci uno o più campi che devono essere disponibili in questo gruppo.

field

group

Definisci uno o più sottogruppi.

unbounded

depends

Può essere utilizzato per dichiarare dipendenze da altri campi. Viene utilizzato per mostrare campi/gruppi specifici solo quando un determinato campo ha il valore 1. Questo nodo richiede un section/group/field-string.

depends

attribute

Gli attributi personalizzati possono essere utilizzati dai modelli front-end. Di solito utilizzato per rendere più dinamico un determinato modello di front-end.

attribute

include

Utilizzato per includere system_include.xsd file compatibili. Di solito utilizzato per strutturare grandi system.xml file.

includeType

WARNING

I nodi more_url, demo_url e help_url sono definiti da un modello di front-end PayPal utilizzato una sola volta. Questi nodi non sono riutilizzabili.

Esempio: creare un gruppo per una determinata sezione

Il seguente frammento di codice illustra l'utilizzo di base della creazione di un nuovo gruppo.

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Config:etc/system_file.xsd">
    <system>
        <tab id="A_UNIQUE_ID" translate="label" class="a-custom-css-class-to-style-this-tab" sortOrder="10">
            <label>A meaningful label</label>
        </tab>

        <section id="A_UNIQUE_SECTION_ID" showInDefault="1" showInWebsite="0" showInStore="1" sortOrder="10" translate="label">
            <label>A meaningful section label</label>
            <tab>A_UNIQUE_ID</tab>
            <resource>VENDOR_MODULE::path_to_the_acl_resource</resource>

            <group id="A_UNIQUE_GROUP_ID" translate="label comment" sortOrder="10" showInDefault="1" showInWebsite="0" showInStore="1">
                <label>A meaningful group label</label>
                <comment>An additional comment helping users to understand the effect when configuring the fields defined in this group.</comment>
                <!-- Add your fields here. -->
            </group>
        </section>
    </system>
</config>

Il gruppo descritto sopra definisce l’ID A_UNIQUE_GROUP_ID, è visibile nella vista di configurazione predefinita e in un contesto store. Entrambi, il label e comment sono contrassegnati come traducibili.

Campi

Il <field>-Il tag viene utilizzato all'interno di <group>-Tag per definire valori di configurazione specifici.

Riferimento attributo campo

A <field>-Tag può avere i seguenti attributi:

Attributo

Descrizione

Tipo

Obbligatorio

id

Definisce l’identificatore utilizzato che fa riferimento al campo.

typeId

obbligatorio

translate

Definisce i campi da tradurre. Fornire label per rendere traducibile l’etichetta. Più campi devono essere separati da uno spazio.

string

facoltativo

type

Definisce il tipo di input dell'elemento HTML sottoposto a rendering. Impostazione predefinita text.

string

facoltativo

sortOrder

Definisce l’ordinamento della sezione. I numeri alti spingono la sezione nella parte inferiore della pagina, mentre i numeri bassi spingono la sezione nella parte superiore.

float

facoltativo

showInDefault

Definisce se il campo viene visualizzato nell'ambito di configurazione predefinito. Specifica 1 per visualizzare il campo e 0 per nascondere il campo.

int

facoltativo

showInStore

Definisce se il campo viene visualizzato a livello di archivio. Specifica 1 per visualizzare il campo e 0 per nascondere il campo.

int

facoltativo

showInWebsite

Definisce se il campo viene visualizzato a livello di sito Web. Specifica 1 per visualizzare il campo e 0 per nascondere il campo.

int

facoltativo

canRestore

Definisce se il campo può essere ripristinato al valore predefinito.

int

facoltativo

advanced

Obsoleto dalla versione 100.0.2.

bool

facoltativo

extends

Specificando un identificatore di un altro campo, il contenuto di questo nodo estenderà la sezione a cui hai fatto riferimento.

string

facoltativo

Riferimento tipo di campo

A <field>-Tag può avere i seguenti valori per type="" attributo:

Tipo

Descrizione

text

Campo di testo a riga singola standard

textarea

Blocco di testo

select

Menu a discesa Normale, potrebbe essere necessario un source_model. Utilizzato anche per Yes/No selezioni. Consulta Magento\Search\Model\Adminhtml\System\Config\Source\Engine ad esempio.

multiselect

Mi piace select ma sono valide più opzioni.

button

Pulsante che attiva un evento immediato. Richiede un modello front-end personalizzato per definire il testo del pulsante e l’azione. Consulta Magento\ScheduledImportExport\Block\Adminhtml\System\Config\Clean ad esempio.

obscure

Un campo di testo con il valore crittografato e visualizzato come ****. Se si modifica il tipo utilizzando l’elemento "Inspect" nel browser, il valore non viene visualizzato.

password

Mi piace obscure a parte il fatto che il valore nascosto non è crittografato e la modifica forzata del tipo tramite l’elemento "Inspect" nel browser non rivela il valore.

file

Consente di caricare un file per l’elaborazione.

label

Visualizza un'etichetta anziché un campo modificabile. Utilizzare questo tipo quando un campo è modificabile solo su ambiti specifici, ad esempio solo a livello di visualizzazione archivio.

time

Controllo per impostare il tempo utilizzando tre menu a discesa: Ora, minuto e secondo.

allowspecific

Un elenco a selezione multipla di paesi specifici. Richiede un source_model come Magento\Shipping\Model\Config\Source\Allspecificcountries

image

Consente di caricare un’immagine.

note

Consente di aggiungere una nota informativa alla pagina. Questo tipo richiede un frontend_model per riprodurre la nota.

È inoltre possibile creare un tipo di campo personalizzato. Questa operazione viene spesso eseguita quando è necessario un pulsante speciale, con un’azione. A tal fine sono necessari due elementi principali:

Creazione di un blocco in adminhtml area
Impostazione di type="" al percorso di questo blocco

Il blocco stesso richiede, come minimo, un __construct metodo e un getElementHtml() metodo. Il Magento_OfflineShipping è un semplice esempio di tipo personalizzato.

Ad esempio, nel modulo OfflineShipping, il pulsante Esporta è definito in Magento\OfflineShipping\Block\Adminhtml\Form\Field\Export e la definizione del campo sarà simile alla seguente:

<field id="export" translate="label" type="Magento\OfflineShipping\Block\Adminhtml\Form\Field\Export" sortOrder="5" showInDefault="0" showInWebsite="1" showInStore="0">
    <label>Export</label>
</field>

Riferimento nodo di campo

A <field>-Tag può avere i seguenti elementi secondari:

Nodo

Descrizione

Tipo

label

Definisce l’etichetta visualizzata nel front-end.

string

comment

Aggiunge un commento sotto l'etichetta del campo. Utilizzando <![CDATA[//]]> HTML può essere applicato.

string

tooltip

Un altro possibile elemento front-end che può essere utilizzato per descrivere il significato di questo campo. Viene visualizzata come una piccola icona accanto al campo.

string

hint

Visualizza informazioni aggiuntive. Disponibile solo con frontend_model.

string

frontend_class

Aggiunge una classe CSS definita all'elemento HTML della sezione di cui è stato eseguito il rendering.

string

frontend_model

Specifica un modello front-end diverso per modificare il rendering e l'output.

typeModel

backend_model

Specifica un modello di back-end diverso per la modifica dei valori configurati.

typeModel

source_model

Specifica un modello di origine diverso che fornisce un insieme specifico di valori.

typeModel

config_path

Può essere utilizzato per sovrascrivere il percorso di configurazione generico di un campo.

typeConfigPath

validate

Definire regole di convalida diverse (separate da spazi). Di seguito è riportato l’elenco completo dei riferimenti delle regole di convalida disponibili.

string

can_be_empty

Utilizzato quando type è multiselect per specificare che un campo può essere vuoto.

int

if_module_enabled

Utilizzato per visualizzare un campo solo quando un determinato modulo è abilitato.

typeModule

base_url

Utilizzato in combinazione con upload_dir per i caricamenti di file.

typeUrl

upload_dir

Specifica una directory di destinazione per i caricamenti. Questo nodo ha attributi e nodi aggiuntivi. Controllali prima di usare questo.

typeUploadDir

button_url

Visualizza un pulsante se button_url e button_label sono specificati. Di solito utilizzato in combinazione con un modello front-end personalizzato.

typeUrl

button_label

Visualizza un pulsante se button_label e button_url sono specificati. Di solito utilizzato in combinazione con un modello front-end personalizzato.

string

more_url

Non estensibile. Vedi sotto.

typeUrl

demo_url

Non estensibile. Vedi sotto.

typeUrl

hide_in_single_store_mode

Indica se il gruppo deve essere visibile in modalità archivio singolo. 1 nasconde il gruppo; 0 mostra il gruppo.

int

options

Non utilizzato. Potenzialmente obsoleto.

complexType

depends

Può essere utilizzato per dichiarare le dipendenze ad altri campi. Viene utilizzato per mostrare campi/gruppi specifici quando un determinato campo ha il valore 1. Questo nodo richiede un section/group/field-string.

complexType

attribute

Gli attributi personalizzati possono essere utilizzati dai modelli front-end. Di solito utilizzato per rendere più dinamico un determinato modello di front-end.

complexType

requires

Non estensibile. Vedi sotto.

complexType

WARNING

I nodi more_url, demo_url, requires e options sono definiti da un diverso modello di pagamento di base e sono utilizzati una sola volta. Questi nodi non sono riutilizzabili.

Esempio: creare due campi in un determinato gruppo

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Config:etc/system_file.xsd">
    <system>
        <tab id="A_UNIQUE_ID" translate="label" class="a-custom-css-class-to-style-this-tab" sortOrder="10">
            <label>A meaningful label</label>
        </tab>

        <section id="A_UNIQUE_SECTION_ID" showInDefault="1" showInWebsite="0" showInStore="1" sortOrder="10" translate="label">
            <label>A meaningful section label</label>
            <tab>A_UNIQUE_ID</tab>
            <resource>VENDOR_MODULE::path_to_the_acl_resource</resource>

            <group id="A_UNIQUE_GROUP_ID" translate="label" sortOrder="10" showInDefault="1" showInWebsite="0" showInStore="1">
                <label>A meaningful group label</label>
                <comment>An additional comment helping users to understand the effect when configuring the fields defined in this group.</comment>

                <field id="A_UNIQUE_FIELD_ID" translate="label" sortOrder="10" showInDefault="0" showInWebsite="0" showInStore="1" type="select">
                    <label>Feature Flag Example</label>
                    <comment>This field is an example for a basic yes or no select.</comment>
                    <tooltip>Usually these kinds of fields are used to enable or disable a given feature. Other fields might be dependent to this and will only appear if this field is set to yes.</tooltip>
                    <source_model>Magento\Config\Model\Config\Source\Yesno</source_model>
                </field>

                <field id="ANOTHER_UNIQUE_FIELD_ID" translate="label" sortOrder="10" showInDefault="0" showInWebsite="0" showInStore="1" type="text">
                    <label>A meaningful field label</label>
                    <comment>A descriptive text explaining this configuration field.</comment>
                    <tooltip>Another possible frontend element that also can be used to describe the meaning of this field. Will be displayed as a small icon beside the field.</tooltip>
                    <validate>required-entry no-whitespace</validate> <!-- Field is required and must not contain any whitespace. -->
                    <if_module_enabled>VENDOR_MODULE</if_module_enabled>
                    <depends> <!-- This field will only be visible if the field with the id A_UNIQUE_FIELD_ID is set to value 1 -->
                        <field id="A_UNIQUE_FIELD_ID">1</field>
                    </depends>
                </field>
            </group>
        </section>
    </system>
</config>

L'esempio precedente crea due campi, entrambi visibili/configurabili nella visualizzazione predefinita e nella visualizzazione punto vendita. Entrambi i campi hanno un commento e una descrizione per descriverne lo scopo per l’utente. Il label-node è traducibile.
Il campo con l’identificatore ANOTHER_UNIQUE_FIELD_ID è visibile quando il modulo specificato in if_module_enabled è abilitato a livello globale. Il campo convalida anche il suo valore in base alle regole required-entry e no-whitespace.
Il campo con l’identificatore A_UNIQUE_FIELD_ID definisce un modello di origine diverso che fornisce tali valori Yes e No.

Modelli di origine comuni

I seguenti modelli di origine sono forniti da Commerce 2 Core. In generale, ci sono molti più modelli di origine; l'elenco seguente descrive quelli più comuni. Tieni presente che questi modelli di origine richiedono l’attributo del campo type da impostare su select per funzionare correttamente.

Modello di origine

Descrizione

Magento\Config\Model\Config\Source\Yesnocustom

Fornisce i valori Yes, No e Specified.

Magento\Config\Model\Config\Source\Enabledisable

Fornisce i valori Enable, Disable. Salva i valori come 0 e 1 nel database.

Magento\AdminNotification\Model\Config\Source\Frequency

Fornisce i valori 1 Hour,2 Hours,6 Hours,12 Hours e 24 Hours. I valori vengono salvati come numeri interi.

Magento\Catalog\Model\Config\Source\TimeFormat

Fornisce i valori per il formato ora (12 h/24 h).

Magento\Cron\Model\Config\Source\Frequency

Fornisce i valori Daily, Weekly e Monthly. I valori vengono salvati nel database come D, W e M.

Magento\GoogleAdwords\Model\Config\Source\Language

Fornisce i valori per un codice di 2 lettere di una determinata lingua nel formato ISO 639-1 (ad esempio en).

Magento\Config\Model\Config\Source\Locale

Fornisce valori simili a quelli riportati sopra, ma contiene un codice locale (ad esempio en_US).

Convalida campo

A un campo possono essere assegnate una o più classi di convalida per garantire che l’input dell’utente soddisfi i requisiti dell’estensione. Le regole di convalida possono essere applicate con <validate>-Tag.
Nell'esempio seguente viene convalidato un campo e vengono aggiunte diverse regole di convalida.

<field id="A_CUSTOM_IDENTIFIER" showInDefault="1" showInWebsite="0" showInStore="1">
    <validate>required-entry validate-clean-url no-whitespace</validate>
</field>

Sono disponibili le seguenti regole di convalida:

Regola

Descrizione

alphanumeric

Consente solo lettere, numeri, spazi o trattini bassi.

integer

Consente un numero non decimale positivo o negativo.

ipv4

Consente un indirizzo IP v4 valido.

ipv6

Consente un indirizzo IP v6 valido.

letters-only

Consente solo lettere. Ad esempio, abcABC.

letters-with-basic-punc

Consente solo lettere o punteggiatura.
Deve trasmettere la seguente espressione: /^[a-z\-.,()\u0027\u0022\s]+$/i.

mobileUK

Consente un numero di telefono cellulare (Regno Unito).

no-marginal-whitespace

Non consente spazi vuoti all'inizio o alla fine del valore.

no-whitespace

Non consente spazi vuoti.

phoneUK

Consente un numero di telefono (Regno Unito).

phoneUS

Consente un numero di telefono (Stati Uniti).

required-entry

Non consente un valore vuoto (convalida equivalente come validate-no-empty).
Messaggio di errore di convalida: "Campo obbligatorio".

time

Consente un orario valido nel formato 24 ore, tra le 00:00 e le 23:59. Ad esempio 15, 15:05 o 15:05:48.

time12h

Consente un orario valido in formato 12 ore, tra le 12:00 e le 11:59:17:00 Ad esempio 3 am, 11:30 pm, 02:15:00 pm.

validate-admin-password

Consente 7 o più caratteri, sia numerici che alfabetici.

validate-alphanum-with-spaces

Consente l'uso di lettere (a-z o A-Z), numeri (0-9) o solo spazi.

validate-clean-url

Consente un URL valido. Ad esempio: https://www.example.com o www.example.com.

validate-currency-dollar

Consente un importo in dollari valido. Ad esempio, $100,00.

validate-data

Consente solo l'utilizzo di lettere (a-z o A-Z), numeri (0-9) o caratteri di sottolineatura (_).
Il primo carattere deve essere una lettera.
(Deve corrispondere all'espressione: /^[A-Za-z]+[A-Za-z0-9_]+$/)
Messaggio di errore di convalida: "In questo campo utilizzare solo lettere (a-z o A-Z), numeri (0-9) o il carattere di sottolineatura (_); il primo carattere deve essere una lettera."

validate-date-au

Applica il seguente formato data: gg/mm/aaaa. Ad esempio, 17/03/2006 per il 17 marzo 2006.

validate-email

Consente un indirizzo e-mail valido. Ad esempio, johndoe@domain.com.

validate-emailSender

Consente un indirizzo e-mail valido. Ad esempio, johndoe@domain.com.

validate-fax

Consente un numero di fax valido. Ad esempio, 123-456-7890.

validate-no-empty

Non consente un valore vuoto (convalida equivalente come requried-entry).
Messaggio di errore di convalida: "Valore vuoto".

validate-no-html-tags

Non consente l’utilizzo di tag HTML.

validate-password

Consente 6 o più caratteri. Gli spazi iniziali e finali verranno ignorati.

validate-phoneLax

Consente un numero di telefono valido. Ad esempio, (123) 456-7890 o 123-456-7890.

validate-phoneStrict

Consente un numero di telefono valido. Ad esempio, (123) 456-7890 o 123-456-7890.

validate-select

Impone che l’opzione di selezione scelta non abbia un null valore, valore stringa di none o stringa di lunghezza pari a 0.

validate-ssn

Consente un numero di previdenza sociale (Stati Uniti) valido. Ad esempio, 123-45-6789.

validate-street

Consente l'utilizzo solo di lettere (a-z o A-Z), numeri (0-9), spazi e "#".

validate-url

Consente un URL valido. Protocollo obbligatorio (http://, https:// o ftp://).

validate-xml-identifier

Consente un identificatore XML valido. Ad esempio, something_1, block5, id-4.

validate-zip-us

Consente un CAP valido (Stati Uniti). Ad esempio, 90602 o 90602-1234.

vinUS

Consente il valore (US) del numero di identificazione del veicolo (VIN).

Valori predefiniti

I valori predefiniti per i campi possono essere impostati nel etc/config.xml specificando il valore predefinito in section/group/field_ID nodo.

Esempio: impostazione del valore predefinito per `ANOTHER_UNIQUE_FIELD_ID` (Ambito predefinito)

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Store:etc/config.xsd">
    <default>
        <A_UNIQUE_SECTION_ID>
            <A_UNIQUE_GROUP_ID>
                <ANOTHER_UNIQUE_FIELD_ID>This is the default value</ANOTHER_UNIQUE_FIELD_ID>
            </A_UNIQUE_GROUP_ID>
        </A_UNIQUE_SECTION_ID>
    </default>
</config>

Esempio: impostazione del valore predefinito per `ANOTHER_UNIQUE_FIELD_ID` (Ambito del sito web)

Utilizzo di websites , specifica il valore predefinito per un sito web specifico.

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Store:etc/config.xsd">
    <websites>
        <WEBSITE_CODE>
            <A_UNIQUE_SECTION_ID>
                <A_UNIQUE_GROUP_ID>
                    <ANOTHER_UNIQUE_FIELD_ID>This is the default value</ANOTHER_UNIQUE_FIELD_ID>
                </A_UNIQUE_GROUP_ID>
            </A_UNIQUE_SECTION_ID>
        </WEBSITE_CODE>
    </websites>
</config>

recommendation-more-help

386822bd-e32c-40a8-81c2-ed90ad1e198c

riferimento system.xml

Schede // Sezioni // Gruppi // Campi

Schede

Riferimento attributo scheda

Riferimento nodo scheda

Esempio: creare una scheda

Sezioni

Riferimento attributo sezione

Riferimento nodo sezione

Esempio: creare una sezione e assegnarla a una scheda

Gruppi

Riferimento attributo gruppo

Riferimento nodo di gruppo

Esempio: creare un gruppo per una determinata sezione

Campi

Riferimento attributo campo

Riferimento tipo di campo

Riferimento nodo di campo

Esempio: creare due campi in un determinato gruppo

Modelli di origine comuni

Convalida campo

Valori predefiniti

Esempio: impostazione del valore predefinito per ANOTHER_UNIQUE_FIELD_ID (Ambito predefinito)

Esempio: impostazione del valore predefinito per ANOTHER_UNIQUE_FIELD_ID (Ambito del sito web)

Esempio: impostazione del valore predefinito per `ANOTHER_UNIQUE_FIELD_ID` (Ambito predefinito)

Esempio: impostazione del valore predefinito per `ANOTHER_UNIQUE_FIELD_ID` (Ambito del sito web)