Pxxo_Widget_BrowserFilter

Ce widget permet d'afficher une message d'avertissement lorsque le client utilise certains navigateur Web et/ou certaines versions. Ce widget est un décorateur.

Ce widget n'est pas maintenu officiellement.

Paramètres

Nom	Valeur par défaut	Description
`unsupported_browser`	array()	Contient la liste des navigateurs (chaînes de caractères) que l'application Web ne supporte pas. Et donc pour lesquels on souhaite afficher le message d'avertissement. La liste que le widget gère en natif est décrite dans la section suivante.
`unsupported_browser_version`	array()	Contient la liste des versions non supportées des navigateurs. Ce paramètre doit s'utiliser conjointement au paramètre `unsupported_browser`. Regardez les exemples pour comprendre le format attendu.
`suggested_browser_message`	…	Contient le message d'avertissement à afficher lorsque le client n'utilise pas le bon navigateur
`browser_pattern`	…	Contient les expressions régulières qui sont utilisées pour détecter les navigateurs et leur versions. (le format attendu n'est pas documenté)
`force_useragent`	null	Permet de simuler l'utilisation d'un navigateur Web. Ce paramètre est utilisé en interne à des fins de tests

Liste des navigateurs

Ceci est la liste des codes des navigateurs gérés par ce widget :

IE
Konqueror
Firefox
Safari
Opera
Chrome

Attention : veillez à bien respecter les minuscules et les majuscules

Exemples

Exemple qui montre comment décorer le widget HelloWorld et filtrer les navigateurs IE.

require_once "Pxxo/Widget/HelloWorld.php";
$o = new Pxxo_Widget_HelloWorld();
 
$params = array();
$params['unsupported_browser'] = array('IE');
$params['suggested_browser_message'] = "IE n'est pas supporté par cette application. Veuillez utiliser un navigateur respectueux des normes du Web. Par exemple : Firefox ou Safari.";
$o->addDecorator('Pxxo_Widget_BrowserFilter', $params);
 
$o->addDecorator('Pxxo_Widget_Decorator_Core');
$o->main();
$o->dump();

Exemple qui montre comment filtrer les navigateurs Firefox dont la version est inférieur à 3.0 et les navigateurs IE donc la version est égale à 6.

require_once 'Pxxo/Widget/BrowserFilter.php';
$params = array();
$params['unsupported_browser'] = array('Firefox', 'IE');
$params['unsupported_browser_version'] = array('IE'      => array('==', '6.0')
                                               'Firefox' => array('<','3.0'));
$params['suggested_browser_message'] = "Firefox < 3.0 et IE 6.0 ne sont pas des navigateurs supportés par cette application.";
$o = new Pxxo_Widget_BrowserFilter($params);
 
$o->addDecorator('Pxxo_Widget_Decorator_Core');
$o->main();
$o->dump();

fr/doc/pxxo_widget_browserfilter.txt · Dernière modification: 2012/01/14 00:12 (édition externe)