INTEGRAÇÃO CMS · ELEVADA FIABILIDADE · ZERO PLUGINS

Ligar formulários no WordPress sem plugins de SMTP | Lugatu

Melhore o desempenho do seu site WordPress eliminando plugins de SMTP instáveis. Com a Lugatu, reencaminhe formulários diretamente via API REST fiável e sem manutenção.

Começar com WordPress → Ver código PHP

1. Porque os plugins de SMTP no WordPress causam instabilidade

Plugins como o WP Mail SMTP ou Contact Form 7 exigem atualizações constantes, tornam o painel lento e podem suspender a navegação se o servidor de correio falhar.

2. Opção A: Submissão direta no navegador

Insira um formulário HTML no seu tema ou bloco Gutenberg. Os dados são enviados para a Lugatu sem sobrecarregar a base de dados do WordPress.

functions.php php

<?php
// Secure WordPress server-side form forwarding
function handle_custom_contact_submission() {
    if ( ! isset( $_POST['contact_nonce'] ) || ! wp_verify_nonce( $_POST['contact_nonce'], 'contact_action' ) ) {
        wp_send_json_error( array( 'message' => 'Security check failed.' ), 403 );
    }

    // Silently drop automated spam if honeypot trap is filled
    if ( ! empty( $_POST['_gotcha'] ) ) {
        wp_send_json_success( array( 'message' => 'Thank you! Message received.' ) );
        return;
    }

    $name    = sanitize_text_field( $_POST['name'] ?? '' );
    $email   = sanitize_email( $_POST['email'] ?? '' );
    $message = sanitize_textarea_field( $_POST['message'] ?? '' );

    $payload = array(
        'fields' => array(
            'name'    => $name,
            'email'   => $email,
            'message' => $message,
        ),
    );

    $api_url = 'https://www.lugatu.com/api/v1/forms/' . LUGATU_FORM_GUID . '/submissions';

    $response = wp_remote_post( $api_url, array(
        'headers' => array(
            'Authorization'   => 'Bearer ' . LUGATU_API_KEY,
            'Content-Type'    => 'application/json',
            'Idempotency-Key' => wp_generate_uuid4(),
        ),
        'body'    => wp_json_encode( $payload ),
        'timeout' => 10,
    ) );

    if ( is_wp_error( $response ) || wp_remote_retrieve_response_code( $response ) >= 400 ) {
        wp_send_json_error( array( 'message' => 'Failed to deliver message.' ), 500 );
    }

    wp_send_json_success( array( 'message' => 'Thank you! Message received.' ) );
}
add_action( 'wp_ajax_custom_contact', 'handle_custom_contact_submission' );
add_action( 'wp_ajax_nopriv_custom_contact', 'handle_custom_contact_submission' );

3. Opção B: Envio através do servidor com wp_remote_post()

Se preferir validar os dados em PHP antes do envio, reencaminhe o pedido de forma autenticada com a sua chave de API privada.

wordpress-embed.html html

<iframe
  src="https://www.lugatu.com/embed/forms/YOUR_PUBLIC_FORM_ID"
  width="100%"
  height="540"
  frameborder="0"
  style="border:none; border-radius:16px; overflow:hidden;"
  title="Contact Form">
</iframe>

Invariante de segurança e autenticação

Segurança no WordPress: Guarde a sua LUGATU_API_KEY no ficheiro wp-config.php ou em variáveis de ambiente do servidor, nunca no tema público.

Solução de problemas e erros comuns de ingestão

wp_remote_post devolve timeout

Aumente o timeout para 15 segundos em wp_remote_post e confirme que o seu alojador autoriza ligações HTTPS externas.

Perguntas frequentes

É obrigatório ter algum plugin específico instalado?

Não. Pode utilizar HTML puro, Elementor, Divi ou os seus próprios ficheiros PHP sem instalar módulos extra.

Pronto para criar o endpoint do seu formulário?

Comece gratuitamente em segundos. Não é necessário cartão de crédito.

Comece grátis →