Gostaria de criar um novo símbolo de moeda para o seu WPForms? O WPForms já tem muitas moedas para escolher, no entanto, se você gostaria de adicionar um novo símbolo ou simplesmente mover a posição de um símbolo de moeda já existente, isso é facilmente realizável. Este tutorial irá guiá-lo através dos passos para adicionar uma nova moeda ao seu WPForms.
Criar um novo símbolo de moeda
O código abaixo adicionará a moeda Lira como uma opção no separador WPForms " Definições " Pagamentos. Basta adicionar o trecho de código abaixo ao seu site.
Se precisar de ajuda para adicionar snippets ao seu site, consulte 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 snippet, pode ir a WPForms " Definições " Pagamentos e selecionar a sua nova moeda na lista pendente Moeda.
Mais exemplos
Eis mais alguns exemplos.
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! Agora você adicionou uma nova moeda ao seu WPForms. Gostaria de saber como mudar a posição da descrição? Dê uma olhada no nosso tutorial sobre Como posicionar a descrição do campo acima do campo do formulário.
Filtro de referência
FAQ
P: Como é que posso mover o símbolo da moeda?
Tenha em atenção que, ao personalizar o decimals o posicionamento de qualquer moeda poderia quebrar a moeda em qualquer addon de pagamento do WPForms. O processo de pagamento ignoraria os valores decimais.
R: Neste exemplo, vamos mover o símbolo do dólar americano (USD) da esquerda para a direita utilizando o seguinte snippet.
/**
* 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 );
Simplesmente adicionando 'symbol_pos' => 'left', ou 'symbol_pos' => 'right', está a mover a posição da moeda de um lado para o outro.
P: Como é que retiro o ponto decimal?
A: Atualmente, o 'decimals' => 2, não aceita um valor zero após o ponto decimal. Isto é necessário para o filtro.