File di configurazione del modulo
Il file config.xml è il file che definisce un modulo. Viene utilizzato da NexoPOS per identificare un modulo e distinguerlo dagli altri moduli. Questo spiegherà tutto ciò che devi sapere sul file config.xml.
Struttura del file config.xml
Quel file si trova nella root di ogni modulo. Un modulo che non ha quel file non è un modulo valido e potrebbe anche non comparire come modulo nella dashboard. Quel file deve avere una struttura specifica come questa:
<?xml version="1.0" ?>
<module>
<namespace>NsStockTransfers</namespace>
<version>4.5.1</version>
<author>Blair Jersyer</author>
<name>Stock Transfers Module</name>
<description>module description</description>
</module>
Il tag «module» è un parametro obbligatorio. Come figlio, contiene i seguenti tag
- namespace (required): a unique identifier of the module. Should not have any space or special character.
- version (required): the actual version of the module.
- author (required): The name of the author.
- name (required): A human name for the module. This will be displayed on the module list.
- description (required): a brief description of the module. This will also be displayed on the modules list.
Definizione della dipendenza
Se desideri richiedere alcuni moduli prima che un modulo possa essere attivato, dovresti definire un tag "requires" che accetta come sottotag i moduli che desideri richiedere.
<requires>
<dependency namespace="NsMultiStore" min-version="6.1.0">Nexo Multi Store Module</dependency>
</requires>
Nell’esempio precedente, abbiamo impostato come dipendenza “NsMultiStore”, che deve essere almeno alla versione “6.1.0”.
Possiamo anche definire una “max-version” per impostare la versione massima consentita.
Version du noyau de force
Se desideri che il modulo sia compatibile con una versione specifica di NexoPOS, puoi definire la versione del core utilizzando il tag "core" come segue.
<core min-version="6.1.0" max-version="6.1.9"/>
Nell’esempio precedente, stiamo richiedendo la versione “6.1.0” di NexoPOS e impostiamo la versione massima su “6.1.9”.
Localizzazione
A partire da NexoPOS 6.x, abbiamo introdotto la localizzazione nella descrizione del modulo. L’idea è rendere la descrizione ampiamente comprensibile per utenti che non parlano inglese (che in precedenza era l’impostazione predefinita). Questo richiede l’aggiunta di un figlio del tag della descrizione, il tag “locale”, come segue:
...
<description>
<locale lang="en">Here is an english description</locale>
<locale lang="fr">Voici une description en français</locale>
</description>
...