Documentazione consigliata

Per crearne uno nuovo, è necessario avere familiarità con lo sviluppo del modulo Adobe Commerce.

Prima di creare un nuovo modulo, consulta i seguenti argomenti nella documentazione per gli sviluppatori:

Informazioni richieste

In Adobe Commerce, un nuovo paese deve avere un nome univoco, un ID paese, codici ISO2 e ISO3.

Struttura del modulo

In questo esempio verrà creato un nuovo modulo denominato `ExtraCountries` con la seguente struttura di directory:

Per ulteriori informazioni sulla struttura del modulo, consulta Panoramica del modulo nella documentazione per gli sviluppatori.

<ExtraCountries>
 |
 <etc>
 | |
 | config.xml
 | di.xml
 | module.xml
 |
 <Plugin>
 | |
 | <Framework>
 |   |
 |   <Locale>
 |     |
 |     TranslatedListsPlugin.php
 |
 <Setup>
 | |
 | <Patch>
 |   |
 |   <Data>
 |     |
 |     AddDataForAbstractCountry.php
 |
 compositore.json
 registration.php
NOTA
Ogni sezione dell’intestazione di questo articolo descrive i file della sezione della struttura del modulo.

ExtraCountries/etc/config.xml

In questo file XML viene definita una nuova configurazione del modulo. È possibile modificare le configurazioni e i tag riportati di seguito per modificare le nuove impostazioni predefinite del paese.

  • allow - Per aggiungere il nuovo paese all'elenco "Paesi consentiti" per impostazione predefinita, aggiungi il nuovo codice paese alla fine del contenuto del tag allow. I codici paese sono separati da virgola. Tieni presente che questo tag sovrascriverà i dati del file di configurazione del modulo Directory (Directory/etc/config.xml) allow tag. Per questo motivo qui vengono ripetuti tutti i codici e viene aggiunto il nuovo.
  • optional_zip_countries - Se il codice postale del nuovo paese aggiunto deve essere facoltativo, aggiungi il codice del paese alla fine del contenuto del tag optional_zip_countries. I codici paese sono separati da virgola. Tieni presente che questo tag sovrascriverà i dati del file di configurazione del modulo Directory (Directory/etc/config.xml) optional_zip_countries tag. Per questo motivo qui vengono ripetuti tutti i codici e viene aggiunto il nuovo.
  • eu_countries - Se per impostazione predefinita il nuovo paese aggiunto deve far parte dell'elenco dei paesi dell'Unione europea, aggiungi il codice del paese alla fine del contenuto del tag eu_countries. I codici paese sono separati da virgola. Tieni presente che questo tag sovrascriverà i dati del file di configurazione del modulo Store (_Store/etc/config.xml_) eu_countries tag. Per questo motivo qui vengono ripetuti tutti i codici e ne viene aggiunto uno nuovo.
  • config.xml esempio di file
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Store:etc/config.xsd">
    <default>
        <general>
            <country>
                <!-- append a new country codes to the end of this list -->
                <allow>AF,AL,DZ,AS,AD,AO,AI,AQ,AG,AR,AM,AW,AU,AT,AX,AZ,BS,BH,BD,BB,BY,BE,BZ,BJ,BM,BL,BT,BO,BQ,BA,BW,BV,BR,IO,VG,BN,BG,BF,BI,KH,CM,CA,CD,CV,KY,CF,TD,CL,CN,CX,CW,CC,CO,KM,CG,CK,CR,HR,CU,CY,CZ,DK,DJ,DM,DO,EC,EG,SV,GQ,ER,EE,ET,FK,FO,FJ,FI,FR,GF,PF,TF,GA,GM,GE,DE,GG,GH,GI,GR,GL,GD,GP,GU,GT,GN,GW,GY,HT,HM,HN,HK,HU,IS,IM,IN,ID,IR,IQ,IE,IL,IT,CI,JE,JM,JP,JO,KZ,KE,KI,KW,KG,LA,LV,LB,LS,LR,LY,LI,LT,LU,ME,MF,MO,MK,MG,MW,MY,MV,ML,MT,MH,MQ,MR,MU,YT,FX,MX,FM,MD,MC,MN,MS,MA,MZ,MM,NA,NR,NP,NL,AN,NC,NZ,NI,NE,NG,NU,NF,KP,MP,NO,OM,PK,PW,PA,PG,PY,PE,PH,PN,PL,PS,PT,PR,QA,RE,RO,RS,RU,RW,SH,KN,LC,PM,VC,WS,SM,ST,SA,SN,SC,SL,SG,SK,SI,SB,SO,ZA,GS,KR,ES,LK,SD,SR,SJ,SZ,SE,CH,SX,SY,TL,TW,TJ,TZ,TH,TG,TK,TO,TT,TN,TR,TM,TC,TV,VI,UG,UA,AE,GB,US,UM,UY,UZ,VU,VA,VE,VN,WF,EH,XK,YE,ZM,ZW,XX</allow>
​
                <!-- if added countries need to belong to the European Union Countries list by default, append their codes to the end of this list -->
                <eu_countries>AT,BE,BG,CY,CZ,DK,EE,FI,FR,DE,GR,HR,HU,IE,IT,LV,LT,LU,MT,NL,PL,PT,RO,SK,SI,ES,SE,GB,XX</eu_countries>
​
                <!-- if added countries are not require zip code, append it's code to the end of this list -->
                <optional_zip_countries>HK,IE,MO,PA,GB,XX</optional_zip_countries>
            </country>
        </general>
    </default>
</config>

Per ulteriori informazioni sui file di configurazione del modulo, consulta Guida per gli sviluppatori PHP > Definire i file di configurazione nella documentazione per gli sviluppatori.

Queste modifiche sono facoltative e influiranno solo sull’appartenenza predefinita del nuovo paese agli elenchi "Paesi consentiti", "CAP è facoltativo per" e "Paesi dell’Unione europea". Se questo file viene ignorato dalla struttura del modulo, verrà comunque aggiunto un nuovo paese, ma dovrà essere configurato manualmente nella pagina delle impostazioni Admin > Stores > Settings > Configuration > General > Country Options.