La présente rubrique décrit les différentes options de publication possibles pour un gadget.
Vous pouvez placer vos gadgets aux emplacements suivants :
Tous les gadgets ne sont pas adaptés à tous les environnements. Le tableau suivant répertorie les conditions requises par chaque environnement :
| Environnement cible | Conditions requises |
|---|---|
| Page iGoogle | Aucune condition ni contrainte particulière ne s'applique aux utilisateurs souhaitant ajouter des gadgets à leur page iGoogle. |
| Autres services Google, tels que Google Page Creator et Google Desktop | Le contenu des gadgets ne peut pas être du type html-inline. Pour certains services, la zone d'édition des préférences utilisateur n'est pas visible pour les utilisateurs. Dans ces cas-là, la fonctionnalité du gadget ne doit pas être dépendante des préférences que chaque utilisateur indique dans la zone d'édition prévue à cet effet. |
| Annuaire de contenu de Google | Les développeurs qui optent pour l'envoi des gadgets dans l'annuaire de contenu doivent suivre la procédure détaillée à la rubrique Publication dans l'annuaire de contenu. |
| Syndication | Le contenu des gadgets ne peut pas être du type html-inline. Les fonctions de hauteur dynamique et Setprefs ne fonctionnent pas en syndication. La zone d'édition des préférences utilisateur n'étant pas visible pour les utilisateurs, la fonctionnalité du gadget ne doit pas être dépendante des préférences que chaque utilisateur indique dans la zone d'édition prévue à cet effet. |
Avant de publier votre gadget, testez-le en ayant toujours à l'esprit les conditions requises et les contraintes propres à l'environnement dans lequel il sera exécuté.
Soumettez tous vos gadgets aux tests suivants :
Si vous utilisez la méthode _IG_FetchContent(), essayez de connaître les réactions de votre gadget lorsque la source de données est inaccessible ou renvoie une erreur. Cette simulation peut se faire en remplaçant temporairement l'URL actuelle par une autre.
La taille d'un gadget dépend en grande partie de son environnement d'exécution. Lorsque des gadgets sont exécutés en syndication, leur hauteur et leur largeur ne constituent que des indications pour les propriétaires de sites, qui peuvent alors les modifier à leur gré. Dans les pages iGoogle, les paramètres de largeur sont ignorés et la largeur du gadget est automatiquement définie sur 32 %.
La hauteur dynamique ne fonctionne que dans les pages iGoogle. Il est donc conseillé de tester un gadget dans ses différentes tailles lorsqu'il est en syndication. Dans la page de création de syndication, vous pouvez tester votre gadget à l'aide d'une URL au format suivant :
http://gmodules.com/ig/creator?synd=open&url=[gadget-url]
Lorsque vous concevez et testez vos gadgets, n'oubliez pas que la largeur est arbitraire et peut aller de 200 à 600 pixels. Pour certains gadgets, la largeur peut parfois même être supérieure à 600 pixels. Essayez toujours de concevoir votre gadget de sorte qu'il s'affiche correctement, quel que soit l'espace disponible. Par exemple, les gadgets de cartes doivent remplir toute la zone prévue, les gadgets d'images doivent être centrés dans le cadre et les gadgets de texte doivent être alignés vers le haut. En particulier, les liens de type "Pour plus de détails, cliquez ici" situés en bas de la fenêtre du gadget doivent rester le plus près possible du contenu plutôt que d'apparaître isolément, tout en bas de la fenêtre.
L'un des grands avantages des gadgets Google est que vous pouvez les programmer et les tester sur votre propre page iGoogle avant de les utiliser dans d'autres services de Google, tels que Google Desktop ou Google Page Creator. Éventuellement, vous pouvez utiliser le procédé de syndication pour déployer des gadgets sur Blogger ou sur vos propres pages HTML. Pour plus de détails à ce sujet, reportez-vous à la rubrique Publication par syndication.
Vous pouvez utiliser presque tous les gadgets dans Google Desktop et Google Page Creator. Néanmoins, les gadgets ne sont pas systématiquement interchangeables entre Desktop et Page Creator. Voici les limites de compatibilité existantes :
Pour ajouter un gadget dans Google Desktop via la barre latérale Desktop :
Pour ajouter un gadget dans Google Page Creator :
Lorsque vous avez conçu, mis en œuvre et testé votre gadget, vous pouvez l'envoyer à Google afin qu'il soit publié dans l'annuaire de contenu. Le processus d'envoi est le même lorsque vous souhaitez que votre gadget soit répertorié dans l'annuaire de syndication. Pour plus d'informations, consultez la rubrique Gadgets utilisés en syndication. Cette section regroupe la procédure générale à respecter pour préparer un gadget à la publication.
Dans les Références, vous trouverez une liste de tous les attributs du paramètre <ModulePrefs> que vous pouvez utiliser pour indiquer les informations de type META relatives à votre gadget. Voici les informations à inclure dans les spécifications de votre gadget :
Si vous voulez être répertorié dans la page des auteurs, ajoutez les champs suivants :
Vous trouverez des informations complémentaires en cliquant ici ainsi qu'un exemple en cliquant ici.
Assurez-vous que vous avez programmé un gadget de façon à réduire le plus possible les risques pouvant affecter sa sécurité.
Les gadgets ne fonctionnent pas tous dans n'importe quel environnement. Certains gadgets nécessitent d'utiliser un navigateur ou un logiciel particulier. Vous pouvez indiquer certaines informations relatives aux contraintes spécifiques à votre gadget entre les balises <MayRequire>, sous <ModulePrefs>. Pour de plus amples informations, reportez-vous à la rubrique Définition des paramètres de compatibilité.
Vous pouvez utiliser des balises <Locale> sous <ModulePrefs> pour définir les paramètres régionaux pris en charge par votre gadget. Pour plus d'informations, consultez la rubrique Définition de paramètres régionaux.
Pour mettre votre gadget en valeur, pensez à y insérer un bouton Ajouter à Google.
Soumettez votre gadget à Google en cliquant sur ce lien. Pour des explications sur la manière de retrouver votre gadget et sur les éléments qui en déterminent la position dans l'annuaire, consultez la FAQ correspondante. Pour des instructions sur la préparation de votre gadget au procédé de syndication qui va lui permettre d'être exécuté sur les pages de sites Web tiers, consultez la rubrique Gadgets utilisés en syndication.
Si vous avez envoyé plusieurs versions d'un gadget à différentes URL et que vous souhaitiez en indiquer une en particulier comme étant la version officielle, vous pouvez vous servir de la page Submit an Alias Request (Envoyer une demande d'alias).
La syndication est un procédé qui permet de déployer des gadgets Google sur des pages de sites Web tiers. Par exemple, voici un gadget parfaitement fonctionnel qui s'exécute dans cette page-ci :
Comment cela a-t-il été possible ? Il a suffi d'ajouter l'instruction <script src ="http://gadget-URL..." </script> au code HTML de cette page. Vous trouverez ci-après une explication détaillée.
Ouvrez ce gadget dans Creator Page en cliquant sur ce lien.
Aucune préparation particulière n'est requise pour le gadget qui va être utilisé en syndication. Cependant, ce dernier doit remplir les conditions suivantes :
Actuellement, les utilisateurs ne disposent d'aucun moyen aisé de modifier leurs préférences dans un gadget en syndication. Les propriétaires de sites Web peuvent modifier les préférences utilisateur avant de déployer un gadget sur une page Web, mais une fois le gadget déployé, de telles modifications ne sont plus possibles. Supposons que votre gadget affiche des informations en fonction de la ville que chaque utilisateur entre dans ses préférences. Il vous faudrait pouvoir fournir aux utilisateurs un moyen d'entrer cette information en passant par l'interface utilisateur du gadget, et non par les préférences.
La présente rubrique s'appuie sur l'exemple de gadget suivant. Il s'agit d'un gadget affichant un profil utilisateur avec photo, âge et passe-temps. Il permet également de définir une couleur d'arrière-plan :
<?xml version="1.0" encoding="UTF-8" ?>
<Module>
<ModulePrefs title="Card for __UP_myname__" height="400" />
<UserPref name="myname" display_name="Name" default_value="Touki" />
<UserPref name="myphoto" display_name="Photo" default_value="http://doc.examples.googlepages.com/touki.jpg" />
<UserPref name="myage" display_name="Age" default_value="4" />
<UserPref name="myhobby" display_name="Hobbies" default_value="agility, swimming" />
<UserPref name="mycolor" display_name="Color" default_value="Pink" datatype="enum" >
<EnumValue value="Pink" />
<EnumValue value="Red" />
<EnumValue value="Aqua" />
<EnumValue value="Lime" />
<EnumValue value="Yellow" />
<EnumValue value="Orange" />
<EnumValue value="White" />
</UserPref>
<Content type="html">
<![CDATA[
<div id="content_div" style="font-size:12pt; font-family:Arial, Helvetica; text-align:center; padding:5px;">
<script type="text/javascript">
// Get userprefs
var prefs = new _IG_Prefs(__MODULE_ID__);
showCard();
// Display the card showing the user profile
function showCard (){
// Apply userpref-specified background color to the div
var element = document.getElementById('content_div');
element.style.backgroundColor = prefs.getString("mycolor");
// Build HTML string used to display content
var html = "";
html += '<img src="' + prefs.getString("myphoto") + '">';
html += "<br><b>Age: </b>" + prefs.getString("myage");
html += "<br><b>Hobbies: </b>" + prefs.getString("myhobby");
// render HTML string in the div
_gel("content_div").innerHTML = html;
}
</script>
]]>
</Content>
</Module>
Pour tester un gadget en syndication :
http://gmodules.com/ig/creator?synd=open&url=[gadget-url]
Dans une page de création, vous pouvez afficher l'exemple de gadget à l'aide de l'URL suivante :
http://gmodules.com/ig/creator?synd=open&url=http://doc.examples.googlepages.com/baseball-card.xml
Si, pour effectuer un test, vous souhaitez désactiver la fonction de mise en cache, vous pouvez ajouter le paramètre &nocache=1 à votre URL. Toutefois, n'utilisez pas le paramètre &nocache=1 pour déployer des gadgets finalisés, car les performances peuvent s'en trouver réduites.
http://gmodules.com/ig/creator?synd=open&nocache=1&url=http://doc.examples.googlepages.com/baseball-card.xml
Creator Page est l'outil dont les propriétaires de sites Web peuvent se servir pour :
Lorsque vous utilisez l'URL ci-dessus pour ouvrir Creator Page pour l'exemple de gadget, voici ce qui s'affiche :
Remarque :
<script src="http://gmodules.com/ig/ifr?url=http://doc.examples.googlepages.com/baseball-card.xml&up_myname=Touki
&up_myphoto=&up_myage=&up_myhobby=&up_mycolor=Pink&synd=open&w=320&h=400&title=Card+for+__UP_myname__
&border=%23ffffff%7C3px%2C1px+solid+%23999999&output=js"></script>
Cette URL inclut les paramètres suivants :
Testez votre gadget en syndication. Pour cela, créez une page dans Google Page Creator, puis passez en mode "Modifier le code HTML". Dans la page de création, copiez la chaîne générée et collez-la dans le code HTML de la page Web ouverte dans Google Page Creator. Lorsque vous publierez la page, elle contiendra le gadget finalisé et configuré tel que vous l'avez spécifié dans Creator Page.
Vous pouvez également tester votre gadget dans Blogger. Pour afficher un gadget en syndication dans Blogger, vous devez l'ajouter au modèle et non pas au code HTML d'une page. Dans Blogger, le gadget est susceptible d'apparaître tronqué ; il est donc préférable d'y utiliser des gadgets de taille réduite.
Si votre gadget comprend des éléments <Locale>, comme décrit à la rubrique Internationalisation, la page de création inclut un menu Langue contenant toutes les langues prises en charge par votre gadget. Lorsque vous choisissez une langue, elle est ajoutée à l'URL de syndication du gadget via le paramètre &lang. Un paramètre &country est également disponible. Par défaut, il est défini sur ALL :
<script src="http://gmodules.com/ig/ifr?url=http://examples.com/hello-i18n.xml...&lang=zh-CN&country=ALL...</script>
Pour changer la valeur définie pour &country, modifiez manuellement l'URL. Si vous essayez d'indiquer une langue ou un pays pour lesquels votre gadget ne comprend aucun élément de type <Locale>, la modification de l'URL est sans effet.
Pour connaître la liste des pays et des langues pris en charge par la page iGoogle, reportez-vous à la rubrique Pays et langues pris en charge.
Dans Creator Page, vous pouvez sélectionner la bordure à placer autour du gadget sur la page Web cible. Deux types de bordures sont possibles : les bordures image et les bordures CSS.
Une bordure de type image est référencée par une URL au format http://hostname/some/path/ (barre oblique finale obligatoire). Ce type de bordure utilise un ensemble de 9 images :
Les dimensions (largeur x hauteur) correspondant aux images sont les suivantes :
Les ensembles par défaut de ces images se trouvent sous des URL de type http://www.google.com/ig/images/... (ex. : http://www.google.com/ig/images/br.gif).
Certaines des bordures fournies dans la page de création sont élaborées à partir de définitions CSS. Ces bordures correspondent à un ensemble de lignes décrites par des paramètres CSS et dont le format est le suivant :
<bgcolor>|<n>px, <n>px <linetype> <color>|<n>px, <n>px <linetype> <color>|...
où les couleurs sont désignées par leur nom courant ("black" pour noir) ou par leur valeur RVB ("#000000" par exemple) et où les types de ligne sont des standards CSS, comme expliqué dans cette page.
L'exemple de bordure suivant correspond à deux lignes noires sur fond blanc (notez les caractères d'échappement URL) :
&border=%23ffffff%7C1px%2C1px+solid+black%7C1px%2C1px+solid+black%7C0px%2C1px+black
Envoyez un gadget à l'annuaire de syndication de la même manière que vous enverriez un gadget à l'annuaire de contenu habituel, comme décrit dans cette rubrique. N'oubliez pas qu'un gadget utilisé en syndication ne peut pas être un gadget intégré, pas plus qu'il ne peut stocker d'états.
©2007 Google - Règles de confidentialité - Conditions générales - À propos de Google
Mis à jour le
