<html lang="pt-pt" dir="ltr"><head></head><body>### [wpforms_currencies](https://wpforms.com/developers/wpforms_currencies/)

**Publicado:** 19 de fevereiro de 2020
**Autor:** Equipa Editorial

**Excerto:** O filtro `wpforms_currencies` permite filtrar as opções de moeda disponíveis nas Definições do WPForms para selecionar a moeda desejada para o seu WPForms. 

**Conteúdo:**

## Descrição

O filtro `wpforms_currencies` permite filtrar as opções de moeda disponíveis nas Definições do WPForms (listadas em **WPForms » Definições » Pagamentos**, no campo de lista pendente **Moeda**).

## Parâmetros

$currencies*(array) (Obrigatório)* Opções de moeda suportadas, incluindo os detalhes para cada tipo de moeda.

## Origem

`wpforms/includes/functions/payments.php`

## Mais Informações

O filtro `wpforms_currencies` fornece uma lista de moedas suportadas.

Desde a versão 1.2.6, o WPForms suporta [múltiplas moedas](https://wpforms.com/multiple-currency-support-and-payment-enhancements-wpforms-1-2-6/ "Suporte a Múltiplas Moedas e Melhorias de Pagamento – WPForms 1.2.6") para o campo de lista pendente **Moeda**.

## Exemplos

Tenha em atenção que personalizar a posição dos `decimals` de qualquer moeda pode quebrar a moeda em qualquer um dos add-ons de pagamento do WPForms. O processo de pagamento ignorará os valores decimais.

```php

/**
 * Filtra uma lista de moedas suportadas.
 * 
 * @link   https://wpforms.com/developers/wpforms_currencies/
 *
 * @param  array $currencies Opções de moeda suportadas, incluindo os detalhes para cada tipo de moeda.
 *
 * @return array
 */
function wpf_dev_currencies( $currencies ) {

	$currencies = array(
	'USD' =&gt; array(
    	'name'                =&gt; esc_html__( 'Dólar Americano', 'wpforms' ),
		'symbol'              =&gt; '$',
		'symbol_pos'          =&gt; 'left',
		'thousands_separator' =&gt; ',',
		'decimal_separator'   =&gt; '.',
		'decimals'            =&gt; 2,
		),
	);
	return $currencies;

}

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

## Artigos de Referência

[Como Criar um Novo Símbolo de Moeda para o WPForms](https://wpforms.com/developers/how-to-create-a-new-currency-symbol-for-wpforms/ "Como Criar um Novo Símbolo de Moeda para o WPForms")

**Categorias:** Filtros Hooks

**Tags:** Moeda, PHP

---</body></html>