====== Pxxo_Widget_RSS_Flybox ======

Ce widget posséde les mêmes fonctionnalités que le widget [[http://www.pxxo.net/fr/doc/pxxo_widget_rss|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. 

  * [[http://demo.pxxo.net/RSS_Flybox/|Exemple d'utilisation en ligne]]
  * [[fr:install|Installer]]


{{ fr:doc:pxxo_widget_rss_flybox.png |Copie d'écran du widget en action}}







===== Paramètres =====

**Les paramètres communs, hérités de [[http://www.pxxo.net/fr/doc/pxxo_widget_rss|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) |


===== Exemples =====

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) :

<code php>
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();
</code>