Utilité et fonctionnalités du plugin
Ce plugin est utilisé en sur-couche du plugin Accès Restreint. Ce dernier permet de définir des zones à accès restreint et d’attribuer des droits d’accès aux visiteurs et rédacteurs. Sur ce dernier point cela ne change pas.
Alors quelles sont les différences ?
Avec le plugin Accès Restreint, tout le contenu est occulté. Et même plus, puisque les articles concernés ne sortent même plus des résultats des boucles, sauf si le visiteur possède les droits d’accès à la zone restreinte, bien évidemment.
Avec le plugin Accès Restreint Partiel, tous les articles sortent dans les résultats de la boucle, mais c’est le contenu affiché par la balise #TEXTE
de l’article protégé qui sera partiellement occulté, en fonction des filtres que vous aurez sélectionnés et configurés.
Par exemple, il est possible d’afficher seulement N mots, un certain pourcentage de l’article, couper juste avant le Nième intertitre, rien du tout, etc.
Il est également possible de configurer ce qui doit être affiché avant et après un texte qui a subit un filtrage.
Pour voir ce que cela donne, voici un exemple avec un guide de construction partiellement occulté : https://cabane.bilp.fr/guide-constr...
I. Installation du plugin
Le plugin s’installe comme tout autre plugin. Cependant, le plugin Accès Restreint 3.x doit être préalablement installé. Les zone doivent aussi être définies.
Il faut ensuite passer à la configuration du plugin. Si vous omettez de le faire, tous les articles des zones restreintes seront listés mais le #TEXTE
sera complètement occulté à l’affichage.
II. Définir les règles de filtrage
Les règles de filtrage indiquent comment on souhaite occulter le texte des articles.
Il est possible de configurer jusqu’à 8 règles de filtrage, à choisir parmi un choix de filtre.
On peut choisir la règle qui est appliquée par défaut. Ainsi on peut rapidement choisir une règle de filtrage pour l’ensemble du site, puis choisir une règle spécifique pour chaque zone, ou pour chaque article.
Pour chaque règle, on choisit un filtre et on indique les paramètres du filtre.
Le paramètre « Nombre de caractère minimum » n’est pas encore implémenté.
Dans l’exemple ci-dessous, la règle #2 consiste à filtrer 50% du texte :
Les filtres
Diminutif | Description | Paramètre xxx | Remarque |
---|---|---|---|
arp_filtre_ncar | Couper à xxx caractères | Nombre de caractères à conserver dans l’article | Les modéles, balises html, raccourcis typographiques, comptent pour 1 caractère |
arp_filtre_pourcentage | Ne conserver que xxx % de l’article | Définit le % de caractères à afficher | idem |
arp_filtre_nintertitre | Couper juste avant le xxx ième intertitre | Exemple : si xxx=3, on affiche uniquement les 2 premiers intertitres avec leur texte | Si xxx est supérieur au nombre d’intertitres présents dans l’article, alors tout l’article est affiché |
arp_filtre_que_intertitre | Ne laisser que les intertitres et remplacer le texte par xxx | ATTENTION, pas encore implémenté | |
arp_filtre_tout | Tout le texte est filtré (aucun affichage) | non utilisé | |
arp_filtre_rien | Rien n’est filtré, le texte est affiché tel que | non utilisé | Utile pour désactiver ponctuellement le filtrage partiel |
III. Configurer chaque zone
Pour chaque zone, on peut indiquer la règle de filtrage à appliquer.
On peut également définir les textes AVANT et APRES : si le texte de l’article a subi un filtrage, il est possible d’insérer un bout de texte AVANT et APRES le texte de l’article.
On peut définir ces textes AVANT/APRES pour l’ensemble des zones par défaut. Mais on peut aussi le définir spécifiquement pour chaque zone. Dans ce cas, ce sont les textes spécifiques qui sont prioritaires sur les textes définis globalement.
Les textes AVANT/APRES sont au standard typographique SPIP. On peut même ajouter des modèles, des balises HTML, etc.
Deux modèles pour donner envie
Occulter une partie du texte pour susciter la curiosité, c’est une chose. Mais dévoiler subtilement, c’est encore mieux.
Alors voici deux modèles à insérer dans les textes AVANT ou APRES.
- <liste_intertitre>
: liste tous les intertitres de l’article
- <liste_doc>
: liste tous les documents de l’article sous forme de mini-vignette non cliquables. Avec deux paramètres :
- width : largeur de la vignette en px,
- raz : nombre de vignette sur une seule ligne. Juste après la Nième(raz) vignette, un
<br class='nettoyeur'>
est inséré.
Définir des règles spécifiques à certains articles
Comme nous l’avons vu, on définit des règles de filtrage globalement pour tout le site, ou zone par zone.
Mais il est également possible d’agir localement au niveau d’un article. Par exemple, on peut choisir d’afficher 80% du texte pour tous les articles d’une zone donnée. Et pour un article précis de cette zone, on choisit de tout afficher.
Pour cela, il suffit de décider quelle règle à on souhaite affecter à un article, en lui attribuant un mot-clé de la forme arp_regle# ou # est le numéro de la règle.
Choisir précisément l’endroit de la coupe
Enfin, on peut être encore plus précis en choisissant l’endroit exact où on souhaite que le texte soit coupé. Il suffit d’insérer la balise <couper_ici>
à l’endroit exact dans le texte.
Cette disposition est la plus prioritaire de toutes les règles.
Pour éviter de tourner en rond
Avant de crier à l’aide, je ne peux que vous encourager à lire la doc ci-dessus et à appliquer.
En particulier :
- vous devez définir au moins règle, c’est-à-dire définir un filtrage.
- vous devez définir au moins une zone en accès restreint.
- vous devez indiquer quelle règle doit-être appliquée à cette zone, ou alors au moins déclarer la règle par défaut.
Discussions par date d’activité
Une discussion
Petite erreur dans la doc qui s’avère pénalisante pour les utilisateurs :
Le nom du mot clé ne doit pas être « arp_regle# » mais « arp_regle_# » (avec un underscore).
Répondre à ce message
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.
Suivre les commentaires : |