Messages d’avis

L’ajout de notifications à une page de paramètres peut fournir davantage de détails sur la manière de gérer les paramètres affichés. Cela peut inclure comment obtenir une clé API ou ce qui doit être fait pour que les paramètres fonctionnent correctement. Quelle que soit la raison, NexoPOS inclut un moyen d’afficher quatre types de notifications : information, erreur, avertissement et succès.

Le type d’avis ici définit ses couleurs. Vous utiliserez l’une de ces couleurs pour correspondre à l’expression de la gravité de l’avis.

Pour continuer, vous devez d’abord définir vos paramètres en créant une classe qui étend « App\Services\SettingsPage ». Dans cette classe, nous définirons nos paramètres comme suit :

<?php
namespace Modules\YourModule\Settings;

use App\Services\SettingsPage;
use App\Classes\SettingForm;

class MySettings extends SettingsPage 
{
    const IDENTIFIER = 'my-settings';
    const AUTOLOAD = true;
    
    public function __construct()
    {
        $this->form   =   SettingsForm::form(
            title: __m( 'My Settings', 'YourModule' ),
            description: __m( 'Configure your settings', 'YourModule' ),
            tabs: SettingsForm::tabs(
                SettingsForm::tab(
                    identifier: 'general',
                    label: __m( 'General Settings', 'YourModule' ),
                    fields: SettingsForm::fields(
                        // ... fields here
                    )
                )
            )
        )
    }
}

Désormais, nous allons ajouter à la méthode `SettingsForm::tab` les notifications que nous souhaitons afficher.

<?php
namespace Modules\YourModule\Settings;

use App\Services\SettingsPage;
use App\Classes\SettingForm;
use App\Classes\Notice;

class MySettings extends SettingsPage 
{
    const IDENTIFIER = 'my-settings';
    const AUTOLOAD = true;
    
    public function __construct()
    {
        $this->form   =   SettingsForm::form(
            title: __m( 'My Settings', 'YourModule' ),
            description: __m( 'Configure your settings', 'YourModule' ),
            tabs: SettingsForm::tabs(
                SettingsForm::tab(
                    identifier: 'general',
                    notices: [
                        Notice::info(
                            title: __m( 'How It Works', 'YourModule' ),
                            description: __m( 'You must retreive the API from your account...', 'YourModule' ),
                        )
                    ],
                    label: __m( 'General Settings', 'YourModule' ),
                    fields: SettingsForm::fields(
                        // ... fields here
                    )
                )
            )
        )
    }
}

De plus, nous avons ajouté la classe App\Classes\Notice, qui fournit le quatrième type d’avis sous forme de méthode. Par exemple, nous utiliserons « info » pour un avis bleu, « error » pour un avis rouge, etc.

Désormais, nous devrions avoir la sortie suivante sur notre page de paramètres.

Le formulaire n’a aucun champ, car nous n’avons défini aucun champ.