[SPIP] PUBLICA : As tags #LOGO_XXX

SPIP-contrib · Septembre 25, 2024, 8:17

SPIP

Artigo validado

O artigo « As tags #LOGO_XXX (As tags #LOGO_XXX - SPIP) »
acabou de ser publicado por Ricardo Porto.

As tags #LOGO_XXX

quarta-feira 25 de setembro de 2024 , por Ricardo
Porto

Sommaire

Sintaxe da tag
Usar #ID_LOGO_ para exibir os campos título, créditos e descrição
de um ícone
Ícone de mouseOver
O argumento {lien}
O argumento {alignement} (descontinuado)
O critério {logo}
Herança dos ícones de seções
Convenção de nomeação
Tipos de ícones aceitáveis
Veja também

As tags #LOGO_ exibem os ícones de objetos editoriais.

#LOGO_SITE_SPIP : ícone do site
#LOGO_ARTICLE : ícone de uma matéria
#LOGO_RUBRIQUE : ícone de uma seção
#LOGO_AUTEUR ícone do autor
#LOGO_BREVE : ícone de uma nota
… e mais generalizadamente #LOGO_NOM-OBJET-EDITORIAL

Sintaxe da tag|Retour au sommaire

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="">

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 (SPIP) é
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
(SPIP).

**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|Retour au
sommaire

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 |Retour au sommaire

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}`|Retour au sommaire

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)[|Retour au

sommaire](#s-O-argumento-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}`|Retour au sommaire

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[|Retour au

sommaire](#s-Heranca-dos-icones-de-secoes)

– #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
(SPIP).

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|Retour au sommaire

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[|Retour au

sommaire](#s-Tipos-de-icones-aceitaveis)

É 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|Retour au sommaire

#BALISE* et #BALISE**
(SPIP)

Para o desenvolvimento em PHP

API dos ícones (API des logos - Programmer avec SPIP 4)

— Enviado por SPIP (https://www.spip.net/)