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 by date of activity
7 discussions
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à...
Reply to this message
Reply to this message
Bonsoir
Avec Spip 4.0.8 ; A2A 4.0.0 et PHP 7.4.30
Je viens de remarquer que “Lier des deux côtés” ne fonctionne plus. Avant (mais avant quoi, je ne sais pas), cela fonctionnait :
Depuis l’article1 : sélection de “art2”, puis “Lier des deux côtés” affichait bien dans chacun des articles le lien vers l’autre.
Mais maintenant, depuis l’article1, j’ai bien le lien vers l’article2, mais depuis ce dernier, je n’ai pas le lien vers l’article1...
Une idée ?
J’ai testé... chez moi ca marche :p j’avoue ne pas trop voir ce qui pourrait ne pas marcher...
En fait, je corrige mon premier message :
Si pour faire la liaison, je passe par la saisie de “art2” : la liaison se fait bien dans les deux sens.
Mais si je passe par la “Recherche arborescente”, que je navigue dans l’arborescence pour cliquer le titre de l’article2 : la liaison se fait bien de art1 vers art2, mais pas de art2 vers art1.
Ah oui baj c’est le passage en 4.0.0 qui a cassé ceci.
https://git.spip.net/spip-contrib-extensions/a2a/pulls/3
J’ai fait un PR. Reste plus qu’à b_b de vérifier et releaser le cas échéant.
la v4.0.1 corrige ce bug
Super.
Merci !
Reply to this message
Bonjour,
En spip 4, la balise #ARTICLES_LIES ne renvoie plus d’informations.
Comment corriger cela svp ?
La balise retourne bien quelque chose (cf un var_dump) mais le critère IN est plus stricte sur ce qu’il attend à droite.
Je regarde comment corriger.
Et donc la version 3,.0.0 est réellement compatible v4 (alors que la version 2.3.z n’avait pas été testée...)
Reply to this message
Bonsoir,
J’aimerais savoir si ce plugin pourrait intégrer une option de configuration qui proposerait automatiquement les liens A2A de tous les articles cités dans cet article, voire aussi de tous les articles (ou autres objets éditoriaux) pointant sur cet article....
A moins qu’il n’existe déjà :sous quel nom ?
Merci
Alors je ne sais pas si c’est exactement ce que tu cherches mais il y a celui-ci : https://contrib.spip.net/Liens-entre-contenus
dd
Reply to this message
Bonjour
J’ai mis #FORMULAIRE_NAVIGATEUR_A2A#ID_ARTICLE pour pouvoir lier directement en ligne. Comment faire pour avoir aussi la possibilité de DÉLIER?
Reply to this message
Bonjour
j’ai du redescendre de php 7.3 à 7.1
sur php7.3 le plugin ne fonctionne plus mais donne cette alerte :
Warning: count(): Parameter must be an array or an object that implements Countable in /home/clients/a3580510d3989b69fb26134d5ef34fc5/web/ficedl/cartoliste/ecrire/public/aiguiller.php on line 235
Warning: count(): Parameter must be an array or an object that implements Countable in /home/clients/a3580510d3989b69fb26134d5ef34fc5/web/ficedl/cartoliste/ecrire/public/aiguiller.php on line 249
bonne journée
Si c’est en PHP 7.3 je pense que tu es sous SPIP 3.3, car SPIP 3.2 n’est pas compatible avec cette version. De plus, il ne faut pas afficher les warning en production. Mais, j’ai tout de même noté ça dans un ticket afin de régler le problème dès que possible https://git.spip.net/spip-contrib-extensions/a2a/issues/1
PS : peux-tu me donner plus de détails stp, à quel moment le warning est affiché ?
Bonjour,
spip 3.2.8 et 3.2.7 avant aussi
ça arrive lorsque je saisie par exemple art4700 dans le formulaire “chercher un article” et que je clique sur rechercher
ah, je peux quand même lier, je n’avais pas vu que le résultat s’s’affichait quand même
Et oui, c’est pour ça que je disais “Si c’est en PHP 7.3 je pense que tu es sous SPIP 3.3, car SPIP 3.2 n’est pas compatible avec cette version.” :)
ok, j’ai fais du bruit pour rien :)
Reply to this message
Add a comment
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.
Follow the comments: |