Ce plugin s’installe et s’active comme tous les plugins. Il n’installe aucune table supplémentaire. Il se contente d’appeler l’API Google Feed ainsi qu’un javascript d’activation et d’initialisation. Il propose deux modèles à insérer dans n’importe quel article pour afficher les informations d’un flux Rss donné.
Modèle rssjs
Ce modèle permet d’afficher un flux en donnant directement son url
<rssjs |url=adresse de mon flux |nbre_entrees=... |mode=.... |class=... >
Les paramètres :
- url est l’adresse du flux rss à afficher. Ce paramètre est obligatoire.
- nbre_entrees (facultatif). Indique le nombre d’items du flux à afficher, la valeur par défaut est 12.
- mode (facultatif). Par défaut, le titre avec lien vers l’article original, ainsi que le contenu (balise content, summary ou description des items) sont affichés. Si mode=no_content, comme on peut le deviner seul le titre avec lien sera affiché. Si mode=snippet, c’est le début du contenu tronqué à 200 caractères et sans balises html qui sera affiché.
- class. Le nom d’une class css affectée à la balise dl (voir plus bas).
Modèle rssjs_site
Ce modèle permet d’afficher un flux à partir des informations enregistrées dans les sites syndiqués de Spip (il est nécessaire de renseigner le champ « Adresse du fichier de syndication », mais pas d’activer la syndication).<rssjs_site xx |nbre_entrees=... |mode=... |class=.... >
ou <rssjs_site |id_site=xx |nbre_entrees=... |mode=.... |class=... >
Les paramètres :
- xx est l’identifiant du site enregistré dont on veut afficher le flux. <rssjs_site 4 |>
ou <rssjs_site |id_site=4>
donnera le même résultat.
- les autres paramètres sont identiques à ceux du modèle rssjs.
Pour aller plus loin
J’ai choisi de développer les utilisations en modèles car plus souples à mon sens, mais rien n’empêche d’inclure ces modèles dans un squelette.
Les fonctionnalités sont mises en place par le couple modèle / fonction javascript. Les deux modèles fournis utilisent la même fonction javascript disponible dans le fichier « js/rssjs.js » du dossier du plugin. Il est possible de surcharger l’appel à ce fichier en plaçant un fichier du même nom dans un dossier « js » du dossier « squelettes ». le fichier pourra contenir plusieurs fonctions d’initialisation de l’affichage suivant le modèle désiré. Le mécanisme d’initialisation du plugin est alors conservé.
L’affichage des informations de syndication se fait sur la base de balises dl dt dd. la balise dl a pour classe css « rssjs » par défaut. Il est possible d’ajouter une ou plusieurs classe à cette balise par le paramètre « class ».
Si un fichier « css/rssjs.css » existe dans le dossier squelettes, celui-ci sera appelé automatiquement.
Pour exemple voir le modèle « rssjs_complet » et la fonction javascript associée.
Plugin disponible sur la zone
Révisons
- Construction d’un modèle / fonction javascript avec d’avantage d’informations affichées
- Version spip 3
Aucune discussion
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 : |