Image Tools
Este arquivo contém 4 funções bastante úteis quando você está construindo um tema. Para utilizá-lo, copie-o para a pasta do seu tema e inclua ele no seu arquivo includes.php utilizando a função include().
Funções:
theme_image($name [, $params])
Imprime a tag “img” para uma imagem que está na subpasta images dentro do seu tema. Útil para colocar as imagens fixas do seu tema, como header, rodapé, botões e etc.
Exemplo:
theme_image('logo.png');
Vai imprimir:
<img src="http://url_para_a_pasta_do_tema/images/logo.png" />
parâmetros:
$name – o nome do arquivo de imagem
$params [opcional] – array com pares de atributos adicionais para a tag img
Exemplo:
theme_image('logo.png', array('class' => 'logo'));
vai imprimir
<img src="http://url_para_a_pasta_do_tema/images/logo.png" class="logo"/>
get_theme_image($name)
Funciona da mesma maneira que a função theme_image, mas ao invés de imprimir a tag html img, apenas retorna a URL para o arquivo de imagem.
post_image([$size, $caption, $post_id, $params, $returnSRC])
Imprime a tag “img” para uma imagem de um post dado. Esta função pode ser usada dentro ou fora do Loop, e vai imprimir a primeira imagem do post utilizando a propriedade “ordem” das imagens. Todos os parâmetros são opcionais quando se utiliza a função dentro do Loop. Fora do Loop é necessário passar pelo menos os paramentros $size, $caption e $post_id.
parâmetros:
$size
(string)(opcional) tamanho da imagem a ser impresso
padrão – “thumbnail”
$caption
(boolean)(opcional) imprime ou não a legenda da imagem
padrão – false
$post_id
(integer)(opcional) Quando usada fora do Loop, use este parametro para passar o ID do post
padrão – null
$params
(array)(opcional) array de pares com parametros adicionais para serem impressos na tag img
padrão – null
$returnSRC
(boolean)(opcional) se true, apenas retorna o src da imagem e não imprime a tag img (se quiser isso, use a função get_post_image() )
padrão – false
get_post_image([$size, $post_id])
Retorna a URL para uma imagem de um post dado. Esta função pode ser usada dentro ou fora do Loop, e vai retornar a primeira imagem do post utilizando a propriedade “ordem” das imagens. Todos os parâmetros são opcionais quando se utiliza a função dentro do Loop.
parâmetros:
$size
(string)(opcional) tamanho da imagem a ser impresso
padrão – “thumbnail”
$post_id
(integer)(opcional) Quando usada fora do Loop, use este parametro para passar o ID do post
padrão – null
