En este documento se describen las diferentes opciones para publicar un gadget.
Los gadgets pueden insertarse en cualquiera de los lugares siguientes:
No todos los gadgets son apropiados para cada entorno. En la tabla siguiente se enumeran los requisitos para cada entorno:
| Entorno de destino | Requisitos |
|---|---|
| Página de iGoogle | No existen requisitos ni limitaciones especiales para los usuarios que añaden gadgets a la página de iGoogle. |
| Otros servicios de Google, como Google Page Creator y Google Desktop | Los gadgets no pueden ser del tipo de contenido html-inline. En algunos servicios, el cuadro de edición de las preferencias de usuario no está disponible para los usuarios, de modo que en dichos casos la función del gadget no debería depender de los ajustes en tal cuadro. |
| Directorio de contenido de Google | Los programadores que envían gadgets al directorio de contenido deben seguir las directrices que se indican en Publicación en el directorio de contenido. |
| Distribución | Los gadgets no pueden ser del tipo de contenido html-inline. Las funciones como altura dinámica y preferencias de configuración no funcionan con la distribución. El cuadro de edición de las preferencias de usuario no está disponible para los usuarios, de modo que la función del gadget no debería depender de los ajustes en dicho cuadro. |
Antes de publicar el gadget debes probarlo teniendo en cuenta los requisitos y las limitaciones del entorno de destino en el que se ejecutará.
Debes realizar las pruebas siguientes para todos los gadgets:
Si utilizas _IG_FetchContent(), prueba qué sucede si la fuente de datos está inactiva o devuelve un error. Para simularlo, cambia temporalmente la URL por otra dirección.
La forma en que se determina el tamaño de un gadget depende en gran medida de dónde se ejecuta. Cuando los gadgets se ejecutan bajo distribución, la altura y el ancho especificados son sólo sugerencias de los propietarios del sitio, quienes tienen la libertad de cambiarlos. En el caso de la página de iGoogle, la configuración del ancho se ignora y este valor se ajusta automáticamente en un 32%.
La función de altura dinámica sólo funciona en la página de iGoogle, de modo que es preciso probar el gadget con tamaños diferentes bajo la distribución. Puedes probar el gadget en la página de creación de distribución con una URL que presente este formato:
http://gmodules.com/ig/creator?synd=open&url=[gadget-url]
Cuando diseñes y pruebes tus gadgets, debes estar preparado para anchos arbitrarios que pueden ser desde 200 píxeles hasta un ancho de 600. Para ciertos gadgets, el ancho debería ser mucho mayor. Como regla general, diseña el gadget para que pueda mostrarse correctamente si tuviera espacio adicional. Por ejemplo, los gadgets de mapas deben llenar el espacio en cuestión; los gadgets de imágenes deben centrarse en el marco, y los de texto deben desplazar el texto hacia la parte superior (por ejemplo, los vínculos que te permiten hacer clic para obtener más información y que por lo general aparecen en la parte inferior, deben permanecer cerca del contenido en lugar de desplazarse hacia la parte inferior de la ventana del gadget).
Una de las mejores características de Google Gadgets es que puedes crearlos y probarlos en la página de iGoogle y luego usarlos en otros servicios, como Google Desktop y Google Page Creator. También puedes usar la distribución para instalar gadgets en Blogger o en tus propias páginas HTML. Para obtener más información al respecto, consulta Publicación a través de distribución.
Puedes añadir la mayoría de los gadgets a Google Desktop y a Google Page Creator. Sin embargo, no se pueden intercambiar por completo con los de estos programas. Estas son algunas de las limitaciones que presentan:
Para agregar un gadget a Google Desktop a través de la barra lateral:
Para añadir un gadget a Google Page Creator:
Una vez que hayas diseñado, implementado y probado tu gadget, puedes enviarlo a Google para que se publique en el directorio de contenido. El proceso de envío es el mismo si deseas que el gadget aparezca en el directorio de distribución. Para obtener más información, consulta Gadgets distribuidos. En esta sección se detallan los pasos generales que debes seguir cuando prepares algún gadget para su publicación.
En documentación de referencia se enumeran todos los atributos <ModulePrefs> que puedes usar para brindar información de "metadatos" sobre el gadget. A continuación, te indicamos la información que debes incluir en la especificación del gadget:
Si quieres que tu nombre aparezca en la página del autor, deberás incluir estos campos adicionales:
Para obtener más información al respecto, haz clic aquí, y para ver un ejemplo, haz clic aquí.
Comprueba que hayas codificado el gadget de forma que minimice todos los riesgos de seguridad.
No todos los gadgets pueden ejecutarse en cualquier entorno, pueden requerir un navegador o un software en particular. Utiliza la etiqueta <MayRequire> en <ModulePrefs> para ofrecer información sobre los requisitos especiales del gadget. Para obtener más información al respecto, consulta Especificación de requisitos de compatibilidad.
Puedes utilizar las etiquetas <Locale> de <ModulePrefs> para especificar las configuraciones regionales que admite el gadget. Para obtener más información al respecto, consulta Especificación de configuraciones regionales.
Para promocionar el gadget, puedes incluir en él un botón "Añadir a Google".
Puedes enviar el gadget a Google haciendo clic aquí. Consulta las Preguntas frecuentes para obtener una explicación de cómo encontrar tu gadget en el directorio y qué factores determinan su ubicación. Para conocer las instrucciones sobre cómo preparar un gadget para la distribución, es decir, para que pueda ejecutarse en páginas web de terceros, consulta Gadgets distribuidos.
Si has enviado varias versiones de un gadget en direcciones URL diferentes y deseas designar una versión oficial, deberás usar la página Enviar una solicitud de alias.
La distribución permite implementar Google Gadgets en páginas web de terceros. Por ejemplo, este es un gadget activo que se ejecuta en esta página web:
¿Cómo se ha conseguido? Tan sólo con añadir la instrucción <script src ="http://gadget-URL..." </script> al código HTML de esta página. Continúa leyendo para obtener más información al respecto.
Para abrir este gadget en la página de creación, haz clic aquí.
No tienes que hacer nada especial en el gadget para prepararlo para distribución. Sin embargo, para que pueda distribuirse, es preciso que cumpla con las directrices siguientes:
Por el momento, no existe una forma sencilla que permita a los usuarios editar las preferencias en un gadget distribuido. Los propietarios de un sitio pueden hacerlo antes de implementar el gadget en una página web, pero una vez esté implementado, ya no podrán modificarse. Imaginemos, por ejemplo, que tienes un gadget que muestra información en función del nombre de una ciudad que introduce cada usuario. Tendrías que ofrecer a los usuarios una forma de proporcionar esta información a través de la interfaz del gadget en lugar de las preferencias de usuario.
Este documento incorpora el gadget de muestra siguiente, el cual incluye un perfil de usuario con una fotografía, su edad y pasatiempos. También permite definir el color de fondo:
<?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>
Para probar un gadget bajo distribución:
http://gmodules.com/ig/creator?synd=open&url=[gadget-url]
Por ejemplo, puedes ver el gadget de muestra en la página de creación con esta URL:
http://gmodules.com/ig/creator?synd=open&url=http://doc.examples.googlepages.com/baseball-card.xml
Para fines experimentales, si deseas inhabilitar el almacenamiento en caché, puedes añadir el parámetro &nocache=1 a tu URL. Sin embargo, no debes usar &nocache=1 para implementar gadgets activos, puesto que podría perjudicar el rendimiento.
http://gmodules.com/ig/creator?synd=open&nocache=1&url=http://doc.examples.googlepages.com/baseball-card.xml
La página de creación es la herramienta que utilizan los propietarios de un sitio para:
Si utilizas la URL anterior para abrir la página de creación del gadget de muestra, esto es lo que ves:
Ten en cuenta lo siguiente:
<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>
Esta URL incluye los parámetros siguientes:
Para probar el gadget en distribución debes crear una página en Google Page Creator, pasar al modo de edición en HTML, y pegar la cadena generada de la página de creación al código HTML de la página web de Google Page Creator. Cuando publiques la página, esta contendrá el gadget activo con la configuración que hayas especificado en la página de creación.
Si lo prefieres, puedes probar el gadget en Blogger. Para mostrar un gadget distribuido en Blogger, debes añadirlo a la plantilla, no al código HTML de una página en particular. Es posible que Blogger corte la altura, de modo que los gadgets más pequeños son los más adecuados.
Si el gadget incluye elementos <Locale>, según se describe en Internacionalización, la página de creación mostrará un menú Idioma con todos los idiomas que admite el gadget. Cuando seleccionas un idioma, este se añade a la URL de distribución del gadget con el parámetro &lang. También se incluye un parámetro de país, &country, cuya configuración predeterminada es ALL:
<script src="http://gmodules.com/ig/ifr?url=http://examples.com/hello-i18n.xml...&lang=zh-CN&country=ALL...</script>
Para cambiar la configuración de &country, debes modificar la URL manualmente. Si intentas añadir un idioma o un país para el cual el gadget no tiene el elemento <Locale> correspondiente, cambiar la URL no modificará nada.
Para obtener una lista de los idiomas y países que admite la página de iGoogle, consulta Idiomas y países admitidos.
En la página de creación, puedes seleccionar el borde que deseas que aparezca alrededor del gadget en la página web de destino. Existen dos tipos posibles: basado en imagen y basado en CSS.
Un borde basado en una imagen es aquel al que hace referencia una URL con este formato http://nombrehost/algo/ruta/ (debe terminar con una barra inclinada). Dichos bordes usan un conjunto de nueve imágenes:
Las dimensiones de ancho y altura son las siguientes:
El conjunto predeterminado se encuentra en http://www.google.com/ig/images/..., por ejemplo, http://www.google.com/ig/images/br.gif.
Algunos de los bordes que se proporcionan en la página de creación se basan en definiciones de CSS. Estos constan de un conjunto de líneas descritas por parámetros CSS, cuyo formato es el siguiente:
<bgcolor>|<n>px, <n>px <linetype> <color>|<n>px, <n>px <linetype> <color>|...
donde los colores son nombres simples como "black", es decir, negro, o valores RGB como #000000, y los tipos de línea son CSS estándar, según se explica aquí.
Por ejemplo, este borde imprime dos líneas negras contra un fondo blanco. Observa que utiliza caracteres de escape de la URL:
&border=%23ffffff%7C1px%2C1px+solid+black%7C1px%2C1px+solid+black%7C0px%2C1px+black
Para enviar un gadget al directorio de distribución debes seguir el mismo procedimiento que si lo hicieras al directorio de contenido normal, como se describe aquí. Recuerda que para que pueda realizarse la distribución, el gadget no puede estar inserido ni almacenar el estado.
©2009 Google - Política de privacidad - Términos y condiciones - Acerca de Google
Última actualización:
