Descrição
O campo Imagem permite que uma imagem seja carregada e seleccionada usando o modal nativo do WordPress media.
Screenshots
Changelog
- Adicionado
Minimum
configuração na versão 5.1.9. - Adicionado
Maximum
configuração na versão 5. 1.9.9. - Adicionado
Allowed File Types
configuração na versão 5.1.9.
>
>
Configurações
-
Formato de Retorno
Especificar o formato dos dados retornados. Escolha entre Object (array), URL (string), ou ID (inteiro). -
Pré-visualizar Tamanho
O tamanho da imagem do WordPress exibida ao editar valores. -
Biblioteca
Limita a seleção de arquivos apenas àqueles que foram enviados para este post, ou para toda a biblioteca. - >
Mínimo
Adiciona validação do upload para largura mínima em pixels (inteiro), altura em pixels (inteiro) e tamanho dos arquivos em MB (inteiro). O tamanho do ficheiro também pode ser introduzido como uma string contendo a unidade. ex.'400KB'
. -
Máximo
Adiciona validação de upload para largura máxima, altura e tamanho do ficheiro. -
Tipos de ficheiro permitidos
Adiciona validação de upload para tipos de ficheiro específicos. Digite uma lista separada por vírgulas para especificar quais tipos de arquivo são permitidos ou deixe em branco para aceitar todos os tipos.
Utilização de Template
O campo Image retornará ou um array, uma string ou um valor inteiro dependendo do conjunto de valores de retorno.
Exibir imagem (ID)
Este exemplo demonstra como exibir a imagem selecionada ao usar o tipo de retorno Image ID
. Este exemplo usa a função wp_get_attachment_image() para gerar a imagem HTML.
Exibir imagem (array)
Este exemplo demonstra como exibir a imagem selecionada quando se usa o tipo de retorno Image Object
. Este tipo de retorno fornece dados extras da imagem, como texto alt, legenda e tamanhos.
<?php $image = get_field('image');if( !empty( $image ) ): ?> <img src="https://www.advancedcustomfields.com/resources/image/<?php echo esc_url($image); ?>" alt="<?php echo esc_attr($image); ?>" /><?php endif; ?>
Representação personalizada (array)
Este exemplo demonstra como exibir um tamanho personalizado da imagem selecionada ao usar o tipo de retorno Image Object
. Este tipo de retorno nos permite acessar dados extras da imagem, como tamanhos, largura, altura e mais.
Exibir imagem (URL)
Este exemplo demonstra como exibir a imagem selecionada ao usar o tipo de retorno Image URL
. Este tipo de retorno nos permite exibir eficientemente uma imagem básica mas nos impede de carregar quaisquer dados extras sobre a imagem.
<?php if( get_field('image') ): ?> <img src="https://www.advancedcustomfields.com/resources/image/<?php the_field('image'); ?>" /><?php endif; ?>