Atenção!

Este artigo contém código PHP e destina-se a desenvolvedores. Oferecemos este código como uma cortesia, mas não fornecemos suporte para personalizações de código ou desenvolvimento de terceiros.

Para orientação extra, consulte o tutorial do WPBeginner sobre como adicionar código personalizado.

Dispensar

Como Criar um Novo Símbolo de Moeda para WPForms

Gostaria de criar um novo símbolo de moeda para o seu WPForms? O WPForms já oferece muitas moedas para escolher, no entanto, se você quiser adicionar um novo símbolo ou simplesmente mover a posição de um símbolo de moeda já existente, isso é facilmente alcançável. Este tutorial irá guiá-lo através das etapas para adicionar uma nova moeda ao seu WPForms.

Criando um novo símbolo de moeda

O código abaixo adicionará a moeda Lira como uma opção na aba WPForms » Configurações » Pagamentos. Basta adicionar o trecho de código abaixo ao seu site.

Se precisar de ajuda para adicionar trechos ao seu site, por favor, confira este tutorial.

/**
 * 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 );

Depois de adicionar o trecho, você pode ir em WPForms » Configurações » Pagamentos e selecionar sua nova moeda na lista suspensa Moeda.

Você agora usou PHP para criar um novo símbolo de moeda

Mais Exemplos

Aqui estão alguns exemplos adicionais.

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 );

Dólar 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 );

E é isso! Você adicionou uma nova moeda ao seu WPForms. Gostaria de saber como alterar a posição da descrição? Dê uma olhada em nosso tutorial sobre Como Posicionar a Descrição do Campo Acima do Campo do Formulário.

Filtro de Referência

wpforms_currencies

Perguntas Frequentes

P: Como posso mover o símbolo da moeda?

Por favor, observe que personalizar a posição dos decimais de qualquer moeda pode quebrar a moeda em qualquer um dos addons de pagamento do WPForms. O processo de pagamento ignoraria os valores decimais.

R: Neste exemplo, moveremos o símbolo do Dólar Americano (USD) da esquerda para a direita usando o seguinte trecho.

/**
 * 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 );

Agora o símbolo foi movido de ser exibido à esquerda para ser exibido à direita.

Simplesmente adicionando ‘symbol_pos’ => ‘left’, ou ‘symbol_pos’ => ‘right’, você está movendo a posição da moeda de um lado para o outro.

P: Como removo o ponto decimal?

R: Atualmente, o 'decimals' => 2, não aceitará um valor zero após o ponto decimal. Isso é necessário para o filtro.