Ce widget posséde les mêmes fonctionnalités que le widget Pxxo_Widget_RSS mise à part que celui-ci encapsule le résultat dans une fenêtre volante. Elle peut être réduite, positionnée, déplacée à volonté. La partie paramétrage est par défaut cacher et un bouton permet de l'afficher ou de la masquer.
Les paramètres communs, hérités de Pxxo_Widget_RSS :
| Nom | Type | Valeur par défaut | Description |
|---|---|---|---|
url | String | Aucune | Chaîne de caractères contenant l'url de votre flux rss ( paramètre obligatoire ) |
nbItems | Integer | 10 | Le nombre de news à afficher |
updateDelay | Integer | 60 | L'intervalle de temps en seconde entre deux mises à jour du flux RSS ; si vous ne souhaitez pas qu'il se rafraichisse automatiquement, mettez cette variable à 0 |
activeParams | Boolean | true | Active ou désactive l'affichage de l'interface de gestion du paramétrage du flux : nombre d'items à afficher |
showChannelDescription | Boolean | false | Si à true affiche la description du channel RSS, si il est renseigné dans le flux |
showChannelImage | Boolean | false | Si à true affiche le logo associé au channel RSS, si il en existe une |
output_encoding | String | 'UTF-8' | L'encodage à utiliser pour l'affichage du flux. À régler suivant l'encoding de votre page web. |
httpproxy_host | String | null | L'adresse du serveur de proxy http à utiliser. |
httpproxy_port | Integer | null | Le port du serveur de proxy http à utiliser. |
Les paramètres spécifiques à ce widget :
| Nom | Type | Valeur par défaut | Description |
|---|---|---|---|
width | String | 350px | Largeur de la fenêtre volante ; Attention, l'unité doit être spécifiée |
height | String | null | Hauteur de la fenêtre volante ; Attention, l'unité doit être spécifiée ; par défaut la hauteur s'adapte au contenu |
label | String | null | Titre de la fenêtre volante ; si ce paramètre n'est pas renseigné le widget utilisera le titre du channel du flux |
top | Integer | null | Position Y en pixel de la fenêtre volante par rapport au coin supérieur gauche de de la zone cliente du navigateur web (ne pas spécifier d'unité) |
left | Integer | false | Position X en pixel de la fenêtre volante par rapport au coin supérieur gauche de de la zone cliente du navigateur web (ne pas spécifier d'unité) |
minimized | Boolean | false | Si à true, la fenêtre est réduite lors de son initialisation |
zIndex | Integer | null | Permet de spécifier un z-index |
oid | String | null | Si ce paramètre n'est pas renseigner le ClassID du widget sera utilisé, permet de fixer l'id de la div de zone associé (partie paramètrage) avec le bouton (clef à molette) de la fenêtre volante (pour 99% des besoins, ce paramètre est à ignorer) |
Voila un exemple simple permettant d'afficher un des flux RSS du site Lequipe.fr (l'illustration du début de cet article correspond à cet exemple) :
require_once 'Pxxo/Widget/RSS/Flybox.php'; $params = array( 'url' => 'http://www.lequipe.fr/Xml/Formule1/Titres/actu_rss_Rallye.xml', 'showChannelImage' => true, ); $obj1 = new Pxxo_Widget_RSS_Flybox($params); $obj1->main(); $obj1->dump();