Alterar a pasta de carregamentos e a organização multimédia no WordPress

O WordPress utiliza normalmente wp-content/uploads para os carregamentos e pode organizá-los em pastas de ano e mês. Alterar esta organização ou o seu caminho são operações diferentes: nenhuma move automaticamente os ficheiros existentes nem atualiza todas as suas ligações.

Desativar a organização por mês e ano

Em Definições > Multimédia, desmarque Organize my uploads into month- and year-based folders e guarde.

Os novos carregamentos utilizarão a pasta base sem acrescentar o ano e o mês. Os ficheiros anteriores devem permanecer nos seus caminhos originais enquanto existirem referências a eles. Desmarcar a opção não reorganiza a biblioteca já criada.

Alterar o caminho associado à biblioteca

Teste a alteração num clone com cópia dos ficheiros e da base de dados. Numa instalação simples, pode definir no wp-config.php, antes de carregar o WordPress:

define('UPLOADS', 'mis-ficheros');

O caminho é relativo à raiz do WordPress e não começa por /. Não duplique uma constante existente. Verifique as permissões e que o destino não permite executar ficheiros carregados como código. A referência de carregamentos do WordPress descreve como são calculados o caminho e o URL.

Plugins de armazenamento remoto ou uma rede Multisite podem alterar esse comportamento; não aplique o exemplo sem rever a configuração concreta. Alterar o caminho base pode também afetar os URL que o WordPress gera para anexos anteriores, mesmo que não mova os seus ficheiros.

Migrar a biblioteca existente

Faça o inventário dos caminhos originais, das miniaturas e das referências antes de mover o que quer que seja. Mantenha a estrutura relativa e prepare a substituição compatível com dados serializados, primeiro em simulação no clone. Não altere os GUID por rotina.

Por exemplo, se alterar apenas a pasta base de wp-content/uploads para mis-ficheros, um ficheiro antigo pode passar de:

https://ejemplo.com/wp-content/uploads/2018/12/hola.gif

para o destino equivalente:

https://ejemplo.com/mis-ficheros/2018/12/hola.gif

Desativar a organização por data para novos carregamentos não autoriza a eliminar 2018/12 dos caminhos existentes. Achatar a biblioteca seria outra migração, com possíveis colisões de nomes e alterações adicionais de metadados.

Depois da alteração, as minhas imagens não carregam

Verifique o URL pedido e a localização real do ficheiro. Reveja os originais, as miniaturas, o srcset, o conteúdo dos construtores de páginas e as versões na CDN. Uma imagem visível numa página não demonstra que todas as suas variantes funcionem.

Teste um carregamento novo, um anexo antigo e várias páginas no telemóvel. Se os caminhos anteriores tiverem ligações públicas, mantenha o seu acesso ou redirecione-os para o ficheiro equivalente antes de os retirar.

Para reverter, restaure a configuração, os ficheiros e as referências do ponto verificado. Não elimine a pasta anterior até concluir a validação e o período de recuperação.