<html lang="pt-pt" dir="ltr"><head></head><body>### [Como Definir um Valor Mínimo para um Campo de Preço](https://wpforms.com/developers/how-to-set-minimum-amount-for-a-price-field/)

**Publicado:** 17 de agosto de 2021
**Autor:** Equipe Editorial

**Resumo:** Este tutorial mostrar-lhe-á como definir um valor mínimo num campo de preço definido pelo utilizador utilizando PHP.

**Conteúdo:**

## Introdução

Gostaria de definir um valor mínimo para um campo de preço no seu WPForms? Usando um pequeno trecho de PHP, pode facilmente definir um valor mínimo para o campo de preço **Item Único** que é **Definido pelo Utilizador**. Neste tutorial, iremos guiá-lo através de cada passo sobre como conseguir isto.

## Criação do formulário

Primeiro, terá de criar um formulário e adicionar um campo de preço **Item Único** ao formulário. Assim que tiver adicionado o campo, certifique-se de que o **Tipo de Item** está definido como **Definido pelo Utilizador**.

Se precisar de alguma assistência na configuração de um formulário com o campo **Item Único**, [consulte este artigo](https://wpforms.com/how-to-add-optional-payment-to-your-wordpress-forms/ "Como Adicionar Pagamento Opcional aos Seus Formulários WordPress").

![criar um novo formulário, adicionar um campo de preço de item único ao seu formulário e definir o tipo de item como definido pelo utilizador](https://wpforms.com/wp-content/uploads/2021/08/wpforms-user-defined-price-field.jpg)

## Adição da classe CSS

Em seguida, vamos adicionar uma classe CSS a este campo para que ele acione o trecho para verificar o valor mínimo que exigimos.

Para adicionar um nome de classe CSS a um campo de formulário, selecione o campo **Item Único** e clique no separador **Avançado**. Dentro das **Classes CSS**, insira `set-minimum` e guarde o formulário.

![adicionar o nome da classe css ao campo de item único](https://wpforms.com/wp-content/uploads/2021/08/wpforms-add-class-name.jpg)

## Adição do trecho para definir um valor mínimo

Neste último passo, terá de adicionar o trecho ao seu site. Se precisar de ajuda para adicionar trechos ao seu site, [consulte este tutorial](https://wpforms.com/developers/how-to-add-custom-php-or-javascript-for-wpforms/ "Como Adicionar PHP ou JavaScript Personalizado para WPForms").

```

/**
 * Definir um campo de preço de valor mínimo.
 *
 * @link https://wpforms.com/developers/how-to-set-minimum-amount-for-a-price-field/
 */

function wpf_set_minimum_amount_input( $field_id, $field_submit, $form_data ) {
 
    // Este trecho será executado para todos os formulários
    $form_id = $form_data[ 'id' ];
 
    // E será executado para todos os campos com a classe CSS set-minimum
    $fields  = $form_data[ 'fields' ];

	// Defina o seu valor mínimo aqui.
	$minimum_amount = 5;
 
    // Verificar se o campo tem uma classe CSS personalizada configurada
    if ( !empty( $fields[ $field_id ][ 'css' ] ) ) {
 
        $classes = explode( ' ', $fields[$field_id][ 'css' ] );
 
        if ( in_array( 'set-minimum', $classes ) ) {
 
            if ( $minimum_amount &gt; (float) wpforms_sanitize_amount( $field_submit ) ) {
 
                wpforms()-&gt;process-&gt;errors[ $form_id ][ $field_id ] = __( 'O valor mínimo é $' . $minimum_amount . '.', 'plugin-domain' );
 
                return;
            }
        }
    }
}
add_action( 'wpforms_process_validate_payment-single', 'wpf_set_minimum_amount_input', 10, 3 );
```

Este trecho será executado automaticamente para todos os formulários, mas só será executado nos campos que tiverem o nome da classe CSS **set-minimum**. Se o valor introduzido não atingir o mínimo, será gerado um erro quando o formulário for submetido.

![agora existe um erro de valor mínimo quando o formulário é submetido.](https://wpforms.com/wp-content/uploads/2021/08/wpforms-error-minimum-not-met.jpg)

E é tudo o que precisa! Gostaria de saber como ocultar este valor nas notificações por e-mail? Consulte o nosso tutorial sobre [Como Ocultar o Valor do Preço do Item nas Notificações por E-mail](https://wpforms.com/developers/how-to-hide-the-item-price-value-in-the-email-notifications/ "Como Ocultar o Valor do Preço do Item nas Notificações por E-mail").

## FAQ

#### P: Por que isto não está a funcionar no meu site?

**R:** Se este erro não estiver a impedir o envio do seu formulário, verifique novamente se introduziu o nome da classe CSS no campo correto.

![adicionar o nome da classe css ao campo de item único](https://wpforms.com/wp-content/uploads/2021/08/wpforms-add-class-name.jpg)

#### P: Como defino um valor máximo?

**R:** Para usar um trecho semelhante para definir um valor máximo, primeiro terá de atualizar o nome das **Classes CSS** para `set-maximum` da mesma forma que fez no passo anterior.

Em seguida, basta adicionar este trecho ao seu site.

```

/**
 * Definir um campo de preço de valor máximo.
 *
 * @link https://wpforms.com/developers/how-to-set-minimum-amount-for-a-price-field/
 */
 
function wpf_set_maximum_amount_input( $field_id, $field_submit, $form_data ) {
 
    // Este trecho será executado para todos os formulários
    $form_id = $form_data[ 'id' ];
 
    // E será executado para todos os campos com a classe CSS set-minimum
    $fields  = $form_data[ 'fields' ];

	// Defina o seu valor mínimo aqui.
	$maximum_amount = 5000;
 
    // Verificar se o campo tem uma classe CSS personalizada configurada
    if ( !empty( $fields[ $field_id ][ 'css' ] ) ) {
 
        $classes = explode( ' ', $fields[ $field_id ][ 'css' ] );
 
        if ( in_array( 'set-maximum', $classes ) ) {
 
            if ( $maximum_amount &lt; (float) wpforms_sanitize_amount( $field_submit ) ) {
 
                wpforms()-&gt;process-&gt;errors[ $form_id ][ $field_id ] = __( 'O valor máximo é $' . $maximum_amount . '.', 'plugin-domain' );
 
                return;
            }
        }
    }
}
add_action( 'wpforms_process_validate_payment-single', 'wpf_set_maximum_amount_input', 10, 3 );

```

**Categorias:** Tutoriais

**Tags:** PHP

---</body></html>