Créer un widget Avancé

Portaneo utilise le standard de développement de Widgets Google pour créer des widgets intégrable dans un portail Internet personnalisable tel que POSH.

Résumé

Créer un widget avancé consiste pour l'essentiel à créer un fichier XML respectant le format imposé par l'API.
Votre widget doit donc contenir au minimum les tags suivant: Il est possible de créer des widget plus complexes avec les tags suivants intégrés dans le tag ModulePrefs:

Pour les widgets RSS, il suffit d'importer l'url du flux RSS dans votre portail POSH, à travers l'interface tutorial ou dans le menu d'options de votre portail personnel.
Vous pouvez ajouter des widgets en provenance de la plate-forme Igoogle ou de la plate-forme Netvibes, ou encore des widgets créés spécialement par Portaneo.

Sommaire

Votre widget se présente sous la forme d'un fichier XML :



Il se découpe en 3 parties principales que nous allons détailler dans la suite du document:

Les propriétés du widget

la balise ModulePrefs sert à définir les propriétés du widget:

Les pré-requis du widget

Certains tags permettent de signaler à l'API que votre widget comprend certains options obligatoires.

Avec POSH, vous pouver ajouter un pré-requis spécifique qui va signaler à l'API que les fichiers d'internationalisation de votre widget sont sur votre portail. Vous pourrez donc mettre des url relatives.

De la même façon, si vous téléchargez un widget propre à Portaneo, le widget contiendra le pré-requis suivant.

Certains widgets Portaneo peuvent être pré-intégrés au portail par l'administrateur. Dans ce cas, les urls seront relatifs à votre portail. Le widget contiendra le pré-requis suivant.

Les options du widget

Les balises UserPref servent à définir les options du widget, qui vous permettent d'offrir une personnalisation du widget aux utilisateurs.
Ce sont les options qui s'affichent quand on clique sur "configurer" sur le bandeau du haut du widget.


Le contenu du widget

La balise Content indique le type du widget et contient le code HTML et javascript du widget.
Avec la nouvelle version de Posh, vous pouvez définir plusieurs content, qui correspondront à des vues différentes du widget, la vue classique et la vue plein écran.

Attribut view, différentes possibilités :


Vue par défaut: home


Deux vues et un contenu identique


Deux vues et deux contenus


Modèles



Exemples de widgets


Pour un aperçu des exemples, copiez le code dans l'outil de test de widgets

Hello World !


Boite multicolore


Interaction du widget avec des fichiers : lecture et traitement d'un fichier HTML


Interaction du widget avec des fichiers : lecture et traitement d'un fichier XML


Testez votre widget


Aprés chaque modification, testez votre widget avant de le publier grâce à l'outil de test (disponible sur la page de création d'un widget Avancé).