Ligação autorizada conduz a um ficheiro descarregável, separado do endereço direto.

Downloads WooCommerce: como diagnosticar ficheiros indisponíveis

WordPress

Quando os downloads WooCommerce ficam indisponíveis após a compra, comece por identificar o sintoma: pagamento confirmado sem ligação, ligação inválida, falha no ficheiro ou URL direto público. Cada situação pede uma verificação diferente; alterar o estado da encomenda não confirma um pagamento.

Por onde começar nos downloads WooCommerce

Identifique primeiro o que o cliente consegue fazer e confirme a evidência correspondente. Uma ligação autorizada depende das permissões da compra; um URL direto aponta para o ficheiro e pode funcionar sem passar por essa verificação.

Percursos de acesso autorizado e direto a um ficheiro de downloads WooCommerce.

Diagnóstico por sintoma

SintomaEvidência a verificarAção segura
Pagamento feito, sem ligaçãoEstado da encomenda, pagamento confirmado e permissões de downloadConfirmar a compra e a configuração de concessão de acesso antes de alterar algo
Ligação inválida ou expiradaLigação atual, conta usada e prazo ou limite de descargasVerificar as permissões da encomenda sem expor dados do cliente
Ficheiro não abre ou falhaMétodo de entrega, localização e funcionamento do ficheiroTestar uma cópia em ambiente de ensaio com acesso autorizado
URL direto acessívelOrigem do ficheiro e resultado de acesso anónimoRever armazenamento e proteção do servidor antes de voltar a testar

Na documentação oficial Digital/Downloadable Product Guide, encontra as condições de entrega, armazenamento e proteção dos ficheiros. O diagnóstico abaixo separa o acesso da encomenda, a entrega técnica e a proteção na origem.

Cliente pagou mas não recebeu ligação de download WooCommerce

Confirme o pagamento e as permissões separadamente. Em WooCommerce > Definições > Produtos > Produtos descarregáveis, a opção de conceder acesso após pagamento permite descarregar com a encomenda em processamento ou concluída. Sem essa opção, o acesso aguarda o estado concluído. Não altere o estado apenas para contornar um pagamento pendente, falhado ou não confirmado.

Consulta do pagamento e das permissões numa encomenda WooCommerce.

Confirmar o acesso à compra

  • Confirmar o pagamento com o meio de pagamento e consultar o estado da encomenda.
  • Verificar se a encomenda tem permissões de download; procurar em Opções do ecrã se estiverem ocultas.
  • Confirmar o endereço de email da compra e testar a ligação atual sem divulgar dados do cliente.
  • Verificar se a compra foi feita como convidado antes de exigir início de sessão.

O email e Minha conta > Downloads são vias de acesso distintas. Se o ficheiro aparece na conta mas falta no email recebido, investigue o modelo do email e as personalizações; se o email inteiro não chegou, investigue o envio e a entrega. A opção que exige início de sessão não se aplica a compras como convidado: para exigir conta a todos os compradores, é também necessário desativar o checkout como convidado. Numa ligação expirada, consulte os downloads restantes e a data de expiração na permissão da encomenda.

Se a ligação for rejeitada, peça ao cliente a ligação atual do email ou da conta, sem a divulgar publicamente. Confirme a correspondência entre encomenda, email de faturação e permissão do ficheiro; corrija um email errado antes de reconstruir permissões. Se faltar uma permissão, pode conceder acesso ao produto na encomenda depois de validar a compra. Regenerar permissões substitui as atuais pelas dos ficheiros atuais do produto: registe antes limites personalizados, expiração e histórico necessários. Após a reparação, reveja as permissões e use a ação de enviar detalhes da encomenda ao cliente para fornecer o acesso atual. Consulte o diagnóstico oficial de emails sem ligações de download; não faça regenerações em massa como primeira resposta.

Ficheiro descarregável WooCommerce não abre: o que verificar

Verifique se o ficheiro está íntegro, se a localização é acessível pelo método escolhido e se cumpre as regras de diretórios aprovados, quando ativas. Para armazenamento remoto, teste o URL específico com esse método.

No produto, confirme a opção Descarregável e pelo menos um ficheiro com nome e URL válidos. Virtual indica que não há envio físico; não substitui Descarregável. Se o ficheiro descarrega mas não abre, compare-o com a cópia original para separar um ficheiro corrompido de uma falha de entrega.

Escolher o método de entrega pelo sintoma

MétodoQuando investigarCondição e limite
Force downloadsDescarga interrompida, sobretudo em ficheiros grandesEntrega por PHP; podem ocorrer timeouts. Para ficheiros remotos, o alojamento deve verificar allow_url_fopen.
X-Accel-Redirect/X-SendfileEntrega de ficheiros pelo servidor em vez do PHPExige suporte e configuração no servidor; confirme com o alojamento antes de selecionar.
Redirect only (insecure)O cliente é enviado diretamente ao URL do ficheiroExpõe o URL e permite a sua partilha. Não é uma correção segura para ficheiros pagos que devam permanecer privados.

WooCommerce não impõe um tamanho máximo de ficheiro, mas o servidor pode limitar o carregamento ou interromper a entrega. Distinga uma falha ao carregar o ficheiro no produto de uma falha ao descarregá-lo. Peça ao alojamento para verificar o limite e o método efetivamente usado, sem ativar redirecionamento inseguro apenas para fazer desaparecer o erro.

Diretórios aprovados não equivalem a ficheiros privados

Em WooCommerce > Definições > Produtos > Diretórios de download aprovados, confirme que a localização está abrangida por uma regra ativa. Uma regra desativada ou eliminada pode desativar o ficheiro no produto, marcado por um asterisco vermelho, e impedir o acesso de clientes antigos. Peça a um administrador para corrigir a localização ou a regra específica, em vez de desligar toda a proteção.

As regras distinguem http de https e abrangem subdiretórios. Validam o URL guardado no produto, não os destinos para onde esse URL redireciona: aprovar um fornecedor implica confiar nos seus redirecionamentos. Esta lista controla locais permitidos, não autentica compradores nem protege URLs públicos. Consulte as regras oficiais dos diretórios aprovados e teste o URL remoto com o método de entrega escolhido.

Comparação dos caminhos de entrega de um ficheiro descarregável.

Ao substituir o ficheiro na linha existente do produto, as compras anteriores passam a usar o ficheiro atualizado, mantendo expiração e contagem. Adicionar uma nova linha não concede acesso retroativo: reveja o acesso das compras anteriores se a intenção era uma atualização para esses clientes.

Como proteger URL direto de ficheiros WooCommerce

Não confunda uma ligação de compra autorizada com proteção do ficheiro na origem. A biblioteca multimédia do WordPress é pública: quem conhece o URL direto pode aceder ao ficheiro. Carregue-o pela edição do produto e confirme que o servidor bloqueia o acesso direto ao diretório woocommerce_uploads.

Ensaio de acesso autorizado e anónimo ao endereço direto de um ficheiro.

Ficha de ensaio hipotética

  1. Preparar o ensaio
    Exemplo: loja de formação com um PDF de teste, numa cópia de ensaio e com pagamentos simulados. Resultado observado: por preencher.
  2. Testar o acesso legítimo
    Com uma conta autorizada, confirmar a ligação da encomenda e abrir o PDF de teste. Resultado observado: por preencher.
  3. Testar o acesso anónimo
    Sem sessão iniciada, tentar abrir o URL direto do PDF de teste. Resultado observado: por preencher.
  4. Registar e corrigir
    Registar o método, a localização e as diferenças entre os acessos; pedir revisão técnica se necessário. Resultado observado: por preencher.

Em Ferramentas > Saúde do site > Estado, consulte a proteção do diretório local. Com Force downloads ou X-Accel-Redirect/X-Sendfile, o teste verifica o acesso direto a um ficheiro; se for acessível, peça ao alojamento para bloquear esse acesso preservando a entrega autorizada. Com Redirect only, testa a listagem do diretório: uma listagem bloqueada não torna privados os URLs dos ficheiros. Um resultado inconclusivo não prova segurança nem exposição; peça a verificação das escritas de teste, pedidos ao próprio site e eventuais interferências de CDN ou firewall. Nenhum destes resultados certifica armazenamento remoto.

Em NGINX, um ficheiro .htaccess não bloqueia o acesso: o servidor ignora-o. O alojamento deve aplicar uma regra compatível com o método de entrega e com a ordem das regras existentes, conforme a documentação de proteção de uploads em NGINX. Um bloqueio direto também impede o fallback inseguro por redirecionamento; confirme depois que a ligação autorizada continua a funcionar.

Para completar a evidência, consulte Analytics > Downloads e filtre a encomenda ou produto no período afetado. O relatório oficial de downloads regista atividade, incluindo descargas repetidas do mesmo IP; não confunda esse total com compradores únicos nem com prova de leitura integral do ficheiro.

A ficha de ensaio é hipotética: execute-a apenas numa cópia de ensaio, com contas autorizadas e pagamentos simulados, sem emails reais nem alterações ao servidor às cegas. Para outra verificação do catálogo, Stock WooCommerce: diagnóstico de quantidades e disponibilidade ajuda a analisar quantidades e disponibilidade.

Considere o incidente resolvido apenas depois de repetir o cenário afetado: compra autorizada com acesso ao ficheiro certo, limites e expiração corretos e proteção na origem adequada ao método escolhido. Se precisar de apoio, partilhe estado da encomenda, método de entrega, dimensão do ficheiro e erro observado, removendo nomes, emails, ligações privadas de download, caminhos do servidor e credenciais.