====== Pxxo_Widget_TagCloud ======
Ce widget permet d’afficher un nuage de tags.

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

__Copies d'écran :__ 

{{fr:doc:tagcloud.png|}} {{fr:doc:tagcloud3.png|}}

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

^ Nom          ^ Valeur  ^ Description                                                 ^
| title | - | Chaîne de caractères affichée au-dessus du nuage de tags |
| tags | array() | Liste des tags avec leurs noms, associés à une url et une fréquence |
| number | 0 | Restriction sur le nombre de tags à afficher (0 : aucune limitation) |
| sort_by  | alphabetical | Méthode de classement de tags lors de l’affichage |
| display_frequency  | false | Affichage des fréquences à côté de chaque tag |
| display_menu  | false | Affichage d'un menu contenant un filtre de saisie sur les tags |
| font_size | - | Taille de la police de base du conteneur du nuage de tags|
| method | logarithmic | Type d’échelle à utiliser pour la répartition des classes CSS (niveaux) |





===== Exemples =====
__Exemple 1__ :
En utilisant seulement les paramètres obligatoires du widget :
<code php>
$params = array();

// Ajout de tags par le tableau de paramètres
$params['tags'][] = array('name'      => 'Maps',
                          'frequency' => 100,
                          'url'       => 'maps.google.com'
                          );

$o = new Pxxo_Widget_TagCloud($params);

// Ajout de tags par la méthode addTag()
$o -> addTag('Mail', 150, 'http://www.mail.google.com');  
                                           
$o -> main();
</code>
__Exemple 2__ :
En utilisant les différents paramètres du widget :
<code php>
$params['title']   = 'Nuage de tags';		
$params['number']  = 15; // 0 : affichage de tous les tags
$params['sort_by'] = 'alphabetical'; // alphabeticalDesc | frequency | frequencyDesc
$params['method']  = 'logarithmic'; // linear
$params['display_frequency'] = true;
$params['display_menu'] = true;
$params['theme'] = 'green'; // blue, pyramidBlue

// Valeurs possibles pour font-size : valeur numérique seule 
// valeur numérique + em ou ex, px, pt, pc, in, cm, mm 
// xx-small | x-small | small | medium | large | x-large | xx-large | larger | smaller 
$params['font_size'] = '0.7em';

$o = new Pxxo_Widget_TagCloud($params);

// Ajout d'un tag 
$o -> addTag('Mail', 150, 'http://www.mail.google.com');

// Ajout d'un widget                                       
require_once "Pxxo/Widget/Htmler.php"; 
$htmler = new Pxxo_Widget_Htmler(array('element'=>'a', 'content'=>'Pxxo', 'href' => 'http://www.pxxo.net'));  
$tagCloud -> addTag('Pxxo', 43, $htmler); 
$o -> main();
</code>

**Remarques :**
  * Lors de l'insertion d'un widget au sein du nuage de tags, la chaîne de caractère passée en paramètre ne sert que pour le tri (alphabétique) des tags et ne sera pas affichée.
  * La mise en forme des tags ne fonctionne que dans le cas où ceux-ci sont sous forme de liens HTML, lors de l'insertion de widgets ayant un code HTML spécifique la prise en compte d'autres balises passera par une modification du fichier de thème.