As tags #LOGO_XXX

Sintaxe da tag

Para exibir o ícone

#LOGO_ARTICLE

produz o código HTML a seguir:

<img
	src="IMG/logo/por-do-sol.jpg?1661940083"
	class="spip_logo"	
	width="600" 
	height="400"
        alt=""
>

Para exibir o ícone com um link para o objeto

#LOGO_ARTICLE*

produz o código HTML a seguir:

<a href="mon-super-article"><img src="IMG/logo/por-do-sol.jpg?1661940083" class="spip_logo" width="600" height="400" alt=""></a>

Retornar o nome do ficheiro do ícone

#LOGO_ARTICLE**

produz o código HTML a seguir:
por-do-sol.jpg

Retornar o caminho do ficheiro do ícone

[(#LOGO_ARTICLE|extraire_attribut{src})]

produz o código HTML a seguir:
IMG/logo/por-do-sol.jpg?1661940083

Um timestamp é apensado automaticamente os endereço. Ele corresponde à última alteração do ícone. Para não o exibir, pode ser usado:

[(#LOGO_ARTICLE|extraire_attribut{src}|supprimer_timestamp)]

Manipular graficamento os ícones
Para manipular os ícones, pode-se usar os filtros de imagens.

Exemplo: exibir um ícone com a largura reduzida para 220 pixels

[(#LOGO_ARTICLE|image_reduire{220,*})]

Usar #ID_LOGO_ para exibir os campos título, créditos e descrição de um ícone

A partir do SPIP 4.2, os ícones são imagens como as outras. Pode-se portanto atribuir-lhes um título, descrição, créditos, alt, ....

Para aceder a estes dados, pode-se usar a tag #ID_LOGO_ (por exemplo, #ID_LOGO_ARTICLE) que retorna o identificador do documento usado pelo ícone de um objeto.

Por exemple: exibir o título e o crédito de um ícone:

<BOUCLE_logometas(DOCUMENTS){id_document=#ID_LOGO_ARTICLE}{tout}>
[<div class="logo-titre">(#TITRE)</div>]
[<div class="logo-credits">(#CREDITS)</div>]
</BOUCLE_logometas>

Nota: deve-se usar o critério {tout} para recuperar a imagem

Ícone de mouseOver

Historicamente, se a opção "ícone de mouseOver" estiver ativado na configuração do site, o SPIP permite incluir um segundo ícone para se obter um efeito de mouseOver no ícone (efeito "rollover").

Neste caso,
-  #LOGO_ARTICLE exibe o ícone com o efeito de mouseOver

Adicionalmente, duas tags permitem recuperar apenas um dos dois ícones:
-  #LOGO_ARTICLE_NORMAL exibe o ícone normal;
-  #LOGO_ARTICLE_SURVOL exibe o ícone de mouseOver.

O argumento {lien}

Pode-se incluir um argumento à tag para especificar um link.

Exemplo:

[(#LOGO_ARTICLE{#URL_RUBRIQUE})]

produz o código HTML a seguir:
<a href="actualites"><img src="IMG/logo/por-do-sol.jpg?1661940083" class="spip_logo" width="600" height="400" alt=""></a>

O argumento {alignement} (descontinuado)

Em vez de um link, você pode também especificar um alinhamento para o ícone. Os valores possíveis são left, center ou right

Exemplo:

[(#LOGO_ARTICLE{right})]

produz o código HTML a seguir:
<a href="mon-super-article"><img src="IMG/logo/por-do-sol.jpg?1661940083" class="spip_logo spip_logo_right" width="600" height="400" alt=""></a>

Recomenda-se fortemente o uso de #INSERT_HEAD_CSS para fornecer a folha de estilo que gere as classes CSS de alinhamento .spip_logo_left e .spip_logo_right

O critério {logo}

No nível dos loops, o critério {logo} permite selecionar apenas as matérias (ou seções etc.) que possuam um ícone. Ele também funciona no loop (HIERARCHIE). O critério inverso {!logo} lista os objetos que não possuem ícone.

<BOUCLE_rub_logo(RUBRIQUES){racine}{logo}{par num_titre}>
#LOGO_RUBRIQUE
</BOUCLE_rub_logo>

Retorna os ícones das seções na raiz que possuem um ícone.

Herança dos ícones de seções

-  #LOGO_ARTICLE_RUBRIQUE exibe o ícone da matéria, eventualmente substituído pelo ícone da seção, se não houver um ícone especificado na matéria.

Por padrão, a tag #LOGO_RUBRIQUE exibe o ícone da seção corrente e, se este não estiver definido, irá automaticamente verificar se existe um ícone na seção superior de forma recursiva.

Para desativar esta função de herança, pode-se definir a constante _LOGO_RUBRIQUE_DESACTIVER_HERITAGE.

Para definir o ícone padrão de seções, acesse o menu "Edição > Seções" (http://meusite.org/ecrire?exec=rubriques).

Convenção de nomeação

A partir do SPIP-4.0, os ícones são tratados como documentos. Eles são armazenados no diretório IMG/logo/ conservando o seu nome original ligeiramente corrigido, caso contenha caracteres interditos, como acentos, espaços, ..., ou se já existe um ficheiro com o mesmo nome.

Por exemplo: /IMG/logo/por-do-sol.jpg

Até o SPIP 3.2, os ícones eram renomeados pelo SPIP no momento do upload com a seguinte convenção: IMG/tipo-estadotX.ext onde:

• tipo é o tipo de objeto editorial vinculado ao ícone: art (matéria), rub (seção) ...
• estado on, off é o estado do ícone normal ou de mouseOver
• X é o id do objeto editorial
• ext é a extensão do ficheiro (jpg, png ou gif)

Por exemplo:

• /IMG/arton4.jpg é o ícone da matéria n°4
• /IMG/artoff4.jpg é o logo de mouseOver da matéria n°4

Tipos de ícones aceitáveis

É possível especificar os tipos de imagens usáveis como ícone por meio da variável de personalização $GLOBALS['formats_logos'].

Por exemplo, para só aceitar ficheiros SVG :
$GLOBALS['formats_logos'] = array('svg');

Veja também

• #BALISE* et #BALISE**

Para o desenvolvimento em PHP

• API dos ícones