Aplicado a um URL, este filtro tenta copiar o arquivo para o qual aponta o URL e, se tiver sucesso, retorna o URL relativo da cópia local do ficheiro (por exemplo, "IMG/distant/jpg/l_image.jpg"). Se a operação de cópia falhar, o filtro não retorna nada.
O URL do ficheiro que se quer copiar localmente pode
- ser indicado explicitamente:
[(#VAL{url_do_ficheiro_remoto}|copie_locale)];
- vir de uma tabela externa:
[(#URL_FICHEIRO_REMOTO|copie_locale)];
- ou vir de uma tag enclosure de um fluxo RSS sindicado:
[(#TAGS|afficher_tags{enclosure}|extraire_attribut{href}|copie_locale)].
Atualização da cópia
O filtro aceita um argumento opcional: |copie_locale{modo}, que pode assumir quatro valores:
- auto (padrão):
neste caso, uma cópia local do ficheiro remoto é criada em IMG/distant/. Esta cópia só é feita uma vez. Ela não é atualizada quando a página for recalculada se o ficheiro remoto tiver sido atualizado e o seu URL permanecer o mesmo.
- force:
a cópia local é realizada a cada recálculo da página. O ficheiro local pode eventualmente ser atualizado. (Use com precaução, esta função consome muitos recursos do servidor).
- modif:
a cópia local já presente só será atualizada se for anterior ao cabeçalho «If-Modified-Since» do ficheiro original.
- test:
o filtro apenas verifica se já existe uma cópia local do ficheiro informado no URL e retorna o URL dessa cópia. Senão, não faz nem retorna nada.
Nota:
Para aplicar um filtro de imagem a um ficheiro remoto, é indispensável aplicar-lhe previamente o filtro |copie_locale.
Exemplo:
[(#VAL{https://contrib.spip.net/IMG/logo/siteon0.png}|copie_locale|image_reduire{200})]