Upload de arquivos no WPForms falha: como corrigir

Tipo Outros erros

Nome do erro Erro de upload de arquivos no WPForms EN: WPForms file upload error

Severidade Grave

Descrição O upload de arquivos no WPForms falha quando a extensão esta fora da lista permitida do campo, o arquivo passa do limite do servidor (upload_max_filesize) ou um plugin de cache serve uma versão antiga do formulário. A correção trata cada uma dessas três frentes.

O que é erro de upload de arquivos no WPForms?

O campo File Upload do WPForms permite que o visitante anexe arquivos no envio do formulário. Quando esse envio falha, o arquivo não chega ao servidor e a entrada fica sem o anexo, ou o formulário nem conclui o envio. A falha quase sempre vem de três camadas: a configuração do próprio campo (extensões permitidas e tamanho máximo), os limites de PHP do servidor que valem para qualquer upload do site, e a lista permanente de extensões perigosas que o WPForms bloqueia do lado do formulário, independente do que o WordPress core libere.

Como identificar

Mensagem ‘File exceeds the max size allowed’ ou ‘file exceeds the maximum upload size for this website’ exibida abaixo do campo File Upload no momento do envio.
Mensagem ‘File type is not allowed’ ao tentar anexar um arquivo cuja extensão não esta na lista permitida do campo.
No estilo Modern, a barra de progresso do arquivo trava em ‘Processando’ ou volta a zero e o botão de envio fica desabilitado.
O formulário envia sem erro visivel, mas a entrada em WPForms -> Entradas chega sem o anexo e a notificação por email vem sem o arquivo prometido.

Como prevenir

Mantenha o campo Allowed File Extensions explicito com apenas os tipos que o formulário realmente precisa, em vez de deixar aberto.
Documente o teto real de upload do servidor com o seu provedor e alinhe o Max File Size do campo um pouco abaixo desse teto.
Nunca tente liberar extensões executaveis para contornar a denylist do WPForms; ela existe para impedir upload de código malicioso.
Sempre que ajustar plugin de cache ou CDN, exclua as páginas com formulários e revalide um envio de teste com anexo.

Causa

A extensão do arquivo não consta no campo 'Allowed File Extensions' das opções do File Upload (lista de extensões separadas por virgula); qualquer extensão fora dela e recusada com 'File type is not allowed'.
O arquivo ultrapassa o valor do campo 'Max File Size' ou o limite de PHP do servidor (upload_max_filesize e post_max_size); por padrão o campo herda o teto do servidor mostrado no icone de ajuda ao lado da opção Max File Size.
A extensão esta na denylist permanente do WPForms (.php, .exe, .js, .jar, .html, .htm, .swf, .json), que e bloqueada do lado do formulário mesmo que o WordPress core libere o tipo.
O estilo Modern (drag-and-drop, com upload por AJAX) esta com o campo 'Max File Number' menor que a quantidade de arquivos que o visitante anexa, entao os arquivos extras são recusados.
Um plugin de cache (como o WP Rocket) ou um CDN serve uma versão estática antiga do formulário, deixando o token de segurança do WPForms defasado e fazendo o upload por AJAX falhar silenciosamente.

Como resolver

Libere a extensão no próprio campo: No construtor do formulário, clique no campo File Upload e abra Field Options. No campo Allowed File Extensions, liste as extensões permitidas separadas por virgula, cada uma com ponto inicial. Salve e teste com o mesmo tipo de arquivo que falhava.
```
.pdf, .docx, .jpg, .png, .heic
```
Confirme o teto do campo e do servidor: Ainda em Field Options, passe o mouse no icone de ajuda ao lado de Max File Size para ver o teto que o servidor permite. Defina um número menor ou igual a esse teto. Se precisar de mais, eleve os limites de PHP via php.ini (ou via .htaccess no Apache) e reinicie o PHP.
```
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
```
Respeite a denylist permanente do WPForms: Se o arquivo for de uma extensão executavel, ele e recusado de proposito pelo WPForms por segurança, e isso não deve ser contornado. Oriente o visitante a compactar o arquivo num formato seguro antes de enviar.
```
.php, .exe, .js, .jar, .html, .htm, .swf, .json
```
Exclua o formulário do cache: Se o upload por AJAX falha so para alguns visitantes, limpe todo o cache do site e do CDN e adicione a página do formulário a lista de exclusão do plugin de cache, para que o token de segurança seja sempre gerado fresco.
```
/contato/
/(.*)formulário(.*)/
```

PHP

// wp-content/mu-plugins/wpforms-upload-limit.php
// Sobe o teto de upload SO nas paginas que tem o WPForms,
// mantendo o resto do site no limite padrao do servidor.
add_filter( 'upload_size_limit', function ( $bytes ) {
    if ( function_exists( 'wpforms_current_form_has_field' ) ) {
        return 64 * 1024 * 1024; // 64 MB em bytes
    }
    return $bytes;
} );

Perguntas frequentes

Por que aparece 'File type is not allowed' no WPForms

A extensão do arquivo não esta na lista do campo Allowed File Extensions ou pertence a denylist permanente do WPForms. Adicione a extensão na opção do campo, com ponto inicial, se ela for um tipo seguro.

Como aumentar o tamanho máximo de upload no WPForms

Defina o campo Max File Size dentro do teto do servidor mostrado no icone de ajuda. Para subir esse teto, aumente upload_max_filesize e post_max_size no PHP e reinicie o serviço.

Qual a diferenca entre os estilos Modern e Classic do File Upload

O Modern usa drag-and-drop com upload por AJAX e aceita vários arquivos pelo campo Max File Number. O Classic mostra um botão Choose File e não suporta múltiplos arquivos no mesmo campo.

Por que o upload trava em 'Processando' no estilo Modern

Geralmente o token de segurança esta defasado porque um plugin de cache serve o formulário antigo. Limpe o cache e exclua a página do formulário do cache para o upload por AJAX voltar a concluir.

Posso permitir upload de arquivos PHP no WPForms

Não. As extensões .php, .exe, .js, .jar, .html, .htm, .swf e .json ficam numa denylist permanente do WPForms e não podem ser liberadas pelo campo, mesmo que o WordPress core as aceite.

O formulário envia mas a entrada chega sem o anexo, por que

O arquivo foi recusado em silencio por tamanho ou por cache, e o WPForms concluiu o envio sem o anexo. Revise o Max File Size, os limites de PHP do servidor e a exclusão de cache da página.

O anexo não chega no email de notificação, o que verificar

Confirme que o upload em si foi aceito vendo a entrada em WPForms -> Entradas. Se a entrada tem o arquivo mas o email não, o problema esta no envio de email do site, não no campo de upload.

Atenção

Como corrigir o WP-Cron que não executa no WordPress

O WP-Cron não executa quando o WordPress depende de visitas para disparar as tarefas agendadas, então posts agendados, backups e e-mails ficam parados em sites com pouco tráfego. A correção é desativar o WP-Cron interno e agendar um cron real do servidor para chamar o wp-cron.php em intervalos fixos.

Crítico

Como corrigir o erro de pagamento (Stripe e PayPal) no Tutor LMS

O pagamento do Tutor LMS não funciona quando o aluno tenta comprar um curso pelo Stripe ou PayPal e o checkout não conclui ou o pedido nunca confirma. Quase sempre vem de chaves de API no ambiente errado (Test no lugar de Live), webhook não configurado no gateway, ou mais de uma engine de eCommerce ativa ao mesmo tempo.

Atenção

Como corrigir o course archive que não exibe todos os cursos no Tutor LMS

O Tutor LMS course archive não mostra todos os cursos quando há cursos fora do status Publicado, paginação limitando a quantidade exibida, cache servindo uma versão antiga da página ou um filtro de categoria ativo escondendo parte da lista.

Crítico

Como corrigir a integração Stripe/PayPal que não processa pagamentos no WPForms

O pagamento Stripe ou PayPal não processa no WPForms quando o formulário envia mas a cobrança não acontece, é recusada ou fica pendente. As causas reais costumam ser SSL ausente na página, modo Teste ligado em produção, AJAX desabilitado, licença Pro inativa ou o campo de pagamento faltando no formulário.

Grave

Como corrigir a lógica condicional que não funciona no WPForms

A lógica condicional WPForms não funciona quando as regras Smart Logic não executam no frontend e os campos deixam de aparecer ou esconder conforme a resposta do usuário. A causa quase sempre esta no JavaScript do formulário que não carrega.

Atenção

Como corrigir o addon Form Abandonment que não captura dados no WordPress

O WPForms Form Abandonment não funciona quando a licenca não e Pro ou superior, quando a opção Disable User Cookies esta ligada, ou quando a captura de leads não foi ativada no formulário, fazendo as entradas abandonadas nunca chegarem em WPForms Entries.

Setores

Extensões

Integrações

Como corrigir o erro de upload de arquivos no WPForms

O que é erro de upload de arquivos no WPForms?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o WP-Cron que não executa no WordPress

Como corrigir o erro de pagamento (Stripe e PayPal) no Tutor LMS

Como corrigir o course archive que não exibe todos os cursos no Tutor LMS

Como corrigir a integração Stripe/PayPal que não processa pagamentos no WPForms

Como corrigir a lógica condicional que não funciona no WPForms

Como corrigir o addon Form Abandonment que não captura dados no WordPress

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos