Attention !

Cet article contient du code PHP et est destiné aux développeurs. Nous fournissons ce code à titre de courtoisie, mais nous n'offrons pas de support pour les personnalisations de code ou le développement tiers.

Pour obtenir de l'aide supplémentaire, veuillez consulter le tutoriel de WPBeginner sur l'ajout de code personnalisé.

Ignorer

Comment créer un nouveau symbole de devise pour WPForms

Voulez-vous créer un nouveau symbole de devise pour votre WPForms ? WPForms propose déjà de nombreuses devises, mais si vous souhaitez ajouter un nouveau symbole ou simplement déplacer la position d'un symbole de devise existant, cela est facilement réalisable. Ce tutoriel vous guidera à travers les étapes d'ajout d'une nouvelle devise à votre WPForms.

Créer un nouveau symbole de devise

Le code ci-dessous ajoutera la devise Lira comme option sous l'onglet WPForms » Paramètres » Paiements. Ajoutez simplement l'extrait de code ci-dessous à votre site.

Si vous avez besoin d'aide pour ajouter des extraits à votre site, veuillez consulter ce tutoriel.

/**
 * Add a new currency symbol
 *
 * @link https://wpforms.com/developers/how-to-create-a-new-currency-symbol-for-wpforms/
 */

function wpf_dev_currencies( $currencies ) {

    $currencies['LRA'] = array(
        'name'                => esc_html__( 'Lira', 'wpforms' ),
        'symbol'              => '₤',
        'symbol_pos'          => 'right', // enter left or right to position the symbol
        'thousands_separator' => ',',
        'decimal_separator'   => '.',
        'decimals'            => 2,
    );

    return $currencies;
}

add_filter( 'wpforms_currencies', 'wpf_dev_currencies', 10, 1 );

Une fois que vous avez ajouté l'extrait, vous pouvez aller dans WPForms » Paramètres » Paiements et sélectionner votre nouvelle devise dans la liste déroulante Devise.

Vous avez maintenant utilisé PHP pour créer un nouveau symbole de devise

Autres exemples

Voici quelques exemples supplémentaires.

Euro

/**
 * Add a new currency symbol - Euros
 *
 * @link https://wpforms.com/developers/how-to-create-a-new-currency-symbol-for-wpforms/
 */

function wp_add_currencies( $currencies ) {

    $currencies['EUR'] = array(
        'name'                => esc_html__( 'Euro', 'wpforms' ),
        'symbol'              => '€',
        'symbol_pos'          => 'left', // LEFT
        'thousands_separator' => '.',
        'decimal_separator'   => ',',
        'decimals'            => 2,
    );

    return $currencies;
}

add_filter( 'wpforms_currencies', 'wp_add_currencies', 10, 1 );

Dollar de Hong Kong

/**
 * Add a new currency symbol - Hong Kong Dollar
 *
 * @link https://wpforms.com/developers/how-to-create-a-new-currency-symbol-for-wpforms/
 */

function wp_add_currencies( $currencies ) {

    $currencies['HKD'] = array(
        'name'                => esc_html__( 'Hong Kong Dollar', 'wpforms' ),
        'symbol'              => '$',
        'symbol_pos'          => 'left', // LEFT
        'thousands_separator' => ',',
        'decimal_separator'   => '.',
        'decimals'            => 2,
    );

    return $currencies;
}

add_filter( 'wpforms_currencies', 'wp_add_currencies', 10, 1 );

Et voilà ! Vous avez maintenant ajouté une nouvelle devise à votre WPForms. Souhaitez-vous savoir comment changer la position de la description ? Jetez un œil à notre tutoriel sur Comment positionner la description du champ au-dessus du champ du formulaire.

Filtre de référence

wpforms_currencies

FAQ

Q : Comment puis-je déplacer le symbole de la devise ?

Veuillez noter que la personnalisation de la position des décimales de n'importe quelle devise pourrait entraîner un dysfonctionnement de la devise sur n'importe quel module de paiement WPForms. Le processus de paiement ignorerait les valeurs décimales.

R : Dans cet exemple, nous allons déplacer le symbole du dollar américain (USD) de la gauche vers la droite en utilisant l'extrait suivant.

/**
 * Add a new currency symbol
 *
 * @link https://wpforms.com/developers/how-to-create-a-new-currency-symbol-for-wpforms/
 */

function wpf_dev_currencies( $currencies ) {

    $currencies['USD'] = array(
        'name'                => esc_html__( 'U.S. Dollar', 'wpforms' ),
        'symbol'              => '$',
        'symbol_pos'          => 'right', // left or right
        'thousands_separator' => ',',
        'decimal_separator'   => '.',
        'decimals'            => 2,
    );

    return $currencies;
}

add_filter( 'wpforms_currencies', 'wpf_dev_currencies', 10, 1 );

Maintenant, le symbole a été déplacé de la gauche vers la droite.

En ajoutant simplement ‘symbol_pos’ => ‘left’, ou ‘symbol_pos’ => ‘right’, vous déplacez la position de la devise d'un côté à l'autre.

Q : Comment supprimer le point décimal ?

R : Actuellement, le 'decimals' => 2, n'acceptera pas un montant zéro après le point décimal. Ceci est nécessaire pour le filtre.