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
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 tagallow
. I codici paese sono separati da virgola. Tieni presente che questo tag sovrascriverà i dati del file di configurazione del moduloDirectory
(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 tagoptional_zip_countries
. I codici paese sono separati da virgola. Tieni presente che questo tag sovrascriverà i dati del file di configurazione del moduloDirectory
(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 tageu_countries
. I codici paese sono separati da virgola. Tieni presente che questo tag sovrascriverà i dati del file di configurazione del moduloStore
(_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.