Gadget des fils de syndication - nschonni/wet-boew GitHub Wiki
Ce composant est un gadget logiciel permettant de regrouper et d’afficher des données d'un ou plusieurs fils de syndication. Les formats soutenus sont Atom, RSS et Media RSS. Ce composant aussi permet d'affiché des fils de syndication de Twitter et le météo d'Environnement Canada.
Chef du projet : Mario Bonito (@masterbee)
- Affichage des données d'un ou plusiers fils Atom, RSS ou Media RSS dans une page Web sans agrégateur de fil Web
- Récupération dynamique des cinq derniers éléments de n’importe quel fil public d'Atom, RSS ou Media RSS
- Fonctionnalité de promotion croisée et de partage d’information entre sites Web
- Conformes à WCAG 2.0 AA
- Recours aux WAI-ARIA pour accroître l’accessibilité
- Approche d'amélioration progressive
- Promotion et partage de données provenant de fils de syndication dans une page Web
- Ajouter un élément div; avec class="wet-boew-webwidget" dans la page Web. À l'intérieur de cet élément div, ajouter un autre élément div avec class="widget-container"
- À l'intérieur de l'élément div avec class="widget-container", ajouter un élément section
- À l'intérieur de l'élément section, ajouter un élément d'en-tête (h1-h6) avec une des classes suivantes : widget-title-attention, widget-title-dark ou widget-title-attention
- Ajouter une liste non ordonnée (ul) après l'élément d'en-tête de l'étape suivante.
- Pour chaque fil de syndication, ajouter un élément de liste avec un lien au fil de syndication :
<li><a href="http://canada.gc.ca/exemple.atom">Exemple d'un fils d'Atom</a>
<div class="wet-boew-webwidget limit-5 span-4"><div class="widget-container"> <section> <h3 class="widget-title-dark">Fil de RSS</h3> <ul class="widget-content"> <li>"http://www.tc.gc.ca/medias/rss/routier.xml">Communiqués de presse routière (Tous)</a></li> <li><a href="http://wwwapps.tc.gc.ca/Saf-Sec-Sur/7/VRDB-BDRV/Search/Rss-Search.aspx?lang=fra">Rappels de la Sécurité Routière</a></li> </ul> </section> </div></div>
Le gadget des fils de syndication soutien le paramètre suivant : limit
Chaque gadget des fils de syndication peut limité les éléments à afficher. Utiliser ce paramètre en ajoutant un classe limite a l'élément supérieur (l'élément div avec class="wet-boew-webwidget"). La classe doit commencé avec limit, puis un trait d'union et finalement le nombre d'éléments de limite. Pour une limite de 5 éléments, utiliser la class limit-5. Il n'y aura pas une limite si une classe limite n'est pas utilisée.
Le gadget des fils de syndication est dépendent sur Google Feed API (Conditions de service).
Le code pour le gadget des fils de syndication se trouve à plusieurs endroits dans le répertoire source de la BOEW :
- js/workers/webwidget.js - contient le code JavaScript pour le gadget des fils de syndication
- js/sass/includes/_webwidget.scss - contient le CSS pour le gadget des fils de syndication
- js/images/webfeeds/ - contient les images pour le gadget des fils de syndication
- Par défaut, les données sont actualisées toutes les cinq minutes, ce qui risque de créer un délai notable avant que le gadget ne publie la mise à jour d’un fil de syndication.
- Il y a un risque de ralentissement lorsque le trafic sur le serveur est important.