Installation
Utilisation dans l’espace privé
Le plugin ajoute un bloc d’informations sur les pages d’édition d’articles de l’espace privé.
Pour rechercher un article à lier, il faut entrer les termes à rechercher dans le champ prévu à cet effet. Ce champ vous permet d’effectuer une recherche libre dans le titre ou le contenu de l’article que vous désirez lier.
Remarque : une recherche sur artXX permet d’afficher directement l’article numéro XX.
Après avoir validé une recherche, les résultats de celle-ci s’affichent sous le champ de recherche. Il suffit de cliquer sur «Lier» pour attacher l’article correspondant à celui en cours d’édition.
Depuis la version 0.4 du plugin, il est possible de lier les articles de façon bidirectionnelle en cliquant sur «Lier des deux côtés».
Depuis la version 2.0 du plugin, il est possible de typer les relations entres articles : ceci fait l’objet d’un article spécifique : Typage des relations entre articles avec A2A.
Il est aussi possible de gérer l’ordre ou le rang des articles liés en cliquant sur «Monter» et «Descendre».
Utilisation dans vos squelettes
Pour récupérer la liste des articles liés à l’article de l’environnement :
<B_les_articles_lies>
<ul>
<BOUCLE_les_articles_lies(ARTICLES_LIES){id_article}{par rang}>
<li>
<BOUCLE_article_lie(ARTICLES){id_article = #ID_ARTICLE_LIE}>
<a href="[(#URL_ARTICLE)]">#TITRE</a>
</BOUCLE_article_lie>
</li>
</BOUCLE_les_articles_lies>
</ul>
</B_les_articles_lies>
On peut raccourcir cette écriture à l’aide de la balise #ARTICLES_LIES
qui renvoie un tableau contenant les #ID_ARTICLE
des articles liés à l’article de l’environnement. Par défaut, le tableau renvoyé par la balise est classé par rang. Il est possible d’inverser le tri des articles du tableau avec l’écriture #ARTICLES_LIES{inverse}
.
<B_articles_lies>
<ul>
<BOUCLE_articles_lies(ARTICLES){id_article IN #ARTICLES_LIES}>
<li><a href="[(#URL_ARTICLE)]">#TITRE</a></li>
</BOUCLE_articles_lies>
<ul>
</B_articles_lies>
Pour récupérer la liste des articles liant l’article de l’environnement :
<BOUCLE_liant(ARTICLES_LIES){id_article_lie=#ID_ARTICLE}{par rang}>
<BOUCLE_lesArticlesLiants(ARTICLES){id_article}>
<a href="[(#URL_ARTICLE)]">#TITRE</a>
</BOUCLE_lesArticlesLiants>
</BOUCLE_liant>
Depuis la version 2.1.0 du plugin, on peut simplifier à l’aider de la balise #ARTICLES_LIANT
:
<BOUCLE_lesArticlesLiants(ARTICLES){id_article IN #ARTICLES_LIANT}>
<a href="[(#URL_ARTICLE)]">#TITRE</a>
</BOUCLE_lesArticlesLiants>
Par défaut, la balise retourne les articles liant dans l’ordre de rang. Elle peut prendre un argument optionnel {inverse}
. Cependant, ce tri n’en général pas pertinent, on pourra préférer un tri à l’aide d’un critère de boucle «classique», par exemple par titre :
<BOUCLE_lesArticlesLiants(ARTICLES){id_article IN #ARTICLES_LIANT}{par titre}>
<a href="[(#URL_ARTICLE)]">#TITRE</a>
</BOUCLE_lesArticlesLiants>
Typage des relations entre articles
À partir de la version 2.x, le plugin permet de typer les relations entre articles. Voir l’article consacré à ce sujet.
Discussions par date d’activité
Une discussion
Depuis une mise à jour, les articles s’affichent mal (problèmes sur plusieurs sites)
Salut, j’ai du mal à voir le rapport avec a2a là...
Responder a este mensaje
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Seguir los comentarios: |