mozilla

Revision 281111 of Añadir motores de búsqueda desde páginas web

  • Enlace amigable (slug) de la revisión: Añadir_motores_de_búsqueda_desde_páginas_web
  • Título de la revisión: Añadir motores de búsqueda desde páginas web
  • Id de la revisión: 281111
  • Creada:
  • Creador: Superruzafa
  • ¿Es la revisión actual? No
  • Comentario Quito plantilla de traducción
Etiquetas: 

Contenido de la revisión

Firefox permite que código JavaScript instale plugins de motores de búsqueda, y soporta dos formatos de plugin de motores de búsqueda: OpenSearch, y Sherlock.

Nota: a partir de Firefox 2, OpenSearch es el formato preferido de búsqueda para Firefox.

Cuando código JavaScript intenta instalar un plugin de búsqueda, Firefox presenta una alerta pidiendo permiso al usuario para instalar el plugin.

Instalando plugins de OpenSearch

Para instalar un plugin de OpenSearch, necesita utlilizar el métodowindow.external.AddSearchProvider() DOM . El síntaxis de éste método es:

window.external.AddSearchProvider(engineURL);

Donde engineURL es la URL absoluta del archivo XML para el plugin del motor de búsqueda.

Nota: El soporte de OpenSearch esta sólo disponible en Firefox 2 y posterior.

Instalando plugins de Sherlock

Para instalar un plugin de Sherlock, necesitará llamar window.sidebar.addSearchEngine(), el síntaxis para el mismo es:

window.sidebar.addSearchEngine(engineURL, iconURL, suggestedName, suggestedCategory);
  • El parámetro engineURL es la URL del plugin de Sherlock (un archivo ".src") a instalar.
  • iconURL es la URL a un icono para asociar al plugin.
  • El parámetro suggestedName sólo se usa al pedir permiso al usuario para instalar el plugin, así que un mensaje cómo "Desea instalar suggestedName de engineURL?" podrá mostrarse.
  • El parámetro suggestedCategory no se usa. Debería especificar un valor vacío tipo string ("") o null (nulo).

Para detalles de Sherlock, visite http://developer.apple.com/macosx/sherlock/

Detección de la capacidad del motor de búsqueda del navegador

Debido a que las APIs para añadir motores de búsqueda ha cambiado en el paso de la versión 1.5 a la 2 de firefox y ya que Firefox 1.5 no soporta los ficheros de descripción OpenSearch, los desarrolladores web que quieran añadir motores de búsqueda manteniendo la compatibilidad hacia atrás (p.e. que funcione en Firefox 1.5, Firefox 2.0 o IE 7) deben soportar tanto el formato Sherlock como el OpenSearch y deben detectar las capacidades del navegador de acuerdo a ello. El siguiente fragmento de código es un ejemplo de cómo puede hacerse esto:

function installSearchEngine() {
 if (window.external && ("AddSearchProvider" in window.external)) {
   // Firefox 2 and IE 7, OpenSearch
   window.external.AddSearchProvider("http://example.com/search-plugin.xml");
 } else if (window.sidebar && ("addSearchEngine" in window.sidebar)) {
   // Firefox <= 1.5, Sherlock
   window.sidebar.addSearchEngine("http://example.com/search-plugin.src",
                                  "http://example.com/search-icon.png",
                                  "Search Plugin", "");
 } else {
   // Sin soporte para motores de búsqueda (IE 6, Opera, etc...).
   alert("Sin soporte para motores de búsqueda");
 }
}
{{ wiki.languages( { "en": "en/Adding_search_engines_from_web_pages", "ca": "ca/Addici\u00f3_de_motors_de_cerca_a_les_p\u00e0gines_web", "fr": "fr/Ajout_de_moteurs_de_recherche_depuis_des_pages_Web", "it": "it/Installare_plugin_di_ricerca_dalle_pagine_web", "ja": "ja/Adding_search_engines_from_web_pages", "pl": "pl/Dodawanie_wyszukiwarek_z_poziomu_stron_WWW" } ) }}

Fuente de la revisión

<p>Firefox permite que código JavaScript instale plugins de motores de búsqueda, y soporta dos formatos de plugin de motores de búsqueda: <a href="es/Creando_plugins_de_OpenSearch_para_Firefox">OpenSearch</a>, y Sherlock.
</p>
<div class="note"><b>Nota:</b> a partir de Firefox 2, OpenSearch es el formato preferido de búsqueda para Firefox.</div>
<p>Cuando código JavaScript intenta instalar un plugin de búsqueda, Firefox presenta una alerta pidiendo permiso al usuario para instalar el plugin.
</p>
<h2 name="Instalando_plugins_de_OpenSearch">Instalando plugins de OpenSearch</h2>
<p>Para instalar un plugin de OpenSearch, necesita utlilizar el método<code>window.external.AddSearchProvider()</code> DOM .  El síntaxis de éste método es:
</p>
<pre class="eval">window.external.AddSearchProvider(<i>engineURL</i>);
</pre>
<p>Donde <i>engineURL</i> es la URL absoluta del archivo XML para el plugin del motor de búsqueda.
</p>
<div class="note"><b>Nota:</b> El soporte de OpenSearch esta sólo disponible en Firefox 2 y posterior.</div>
<h2 name="Instalando_plugins_de_Sherlock">Instalando plugins de Sherlock</h2>
<p>Para instalar un plugin de Sherlock, necesitará llamar <code>window.sidebar.addSearchEngine()</code>, el síntaxis para el mismo es:
</p>
<pre class="eval">window.sidebar.addSearchEngine(<i>engineURL</i>, <i>iconURL</i>, <i>suggestedName</i>, <i>suggestedCategory</i>);
</pre>
<ul><li> El parámetro <code>engineURL</code> es la URL del plugin de Sherlock (un archivo ".src") a instalar.
</li><li> <code>iconURL</code> es la URL a un icono para asociar al plugin.
</li><li> El parámetro <code>suggestedName</code> sólo se usa al pedir permiso al usuario para instalar el plugin, así que un mensaje cómo "Desea instalar <i>suggestedName</i> de <i>engineURL</i>?" podrá mostrarse.
</li><li> El parámetro <code>suggestedCategory</code> no se usa.  Debería especificar un valor vacío tipo string (<code>""</code>) o <code>null</code> (nulo).
</li></ul>
<p>Para detalles de Sherlock, visite http://developer.apple.com/macosx/sherlock/
</p>
<h2 name="Detecci.C3.B3n_de_la_capacidad_del_motor_de_b.C3.BAsqueda_del_navegador">Detección de la capacidad del motor de búsqueda del navegador</h2>
<p>Debido a que las APIs para añadir motores de búsqueda ha cambiado en el paso de la versión 1.5 a la 2 de firefox y ya que Firefox 1.5 no soporta los ficheros de descripción OpenSearch, los desarrolladores web que quieran añadir motores de búsqueda manteniendo la compatibilidad hacia atrás (p.e. que funcione en Firefox 1.5, Firefox 2.0 o IE 7) deben soportar tanto el formato Sherlock como el OpenSearch y deben detectar las capacidades del navegador de acuerdo a ello. El siguiente fragmento de código es un ejemplo de cómo puede hacerse esto:
</p>
<pre class="eval">function installSearchEngine() {
 if (window.external &amp;&amp; ("AddSearchProvider" in window.external)) {
   // Firefox 2 and IE 7, OpenSearch
   window.external.AddSearchProvider("<span class="plain">http://example.com/search-plugin.xml</span>");
 } else if (window.sidebar &amp;&amp; ("addSearchEngine" in window.sidebar)) {
   // Firefox &lt;= 1.5, Sherlock
   window.sidebar.addSearchEngine("<span class="plain">http://example.com/search-plugin.src</span>",
                                  "<span class="plain">http://example.com/search-icon.png</span>",
                                  "Search Plugin", "");
 } else {
   // Sin soporte para motores de búsqueda (IE 6, Opera, etc...).
   alert("Sin soporte para motores de búsqueda");
 }
}
</pre>{{ wiki.languages( { "en": "en/Adding_search_engines_from_web_pages", "ca": "ca/Addici\u00f3_de_motors_de_cerca_a_les_p\u00e0gines_web", "fr": "fr/Ajout_de_moteurs_de_recherche_depuis_des_pages_Web", "it": "it/Installare_plugin_di_ricerca_dalle_pagine_web", "ja": "ja/Adding_search_engines_from_web_pages", "pl": "pl/Dodawanie_wyszukiwarek_z_poziomu_stron_WWW" } ) }}
Revertir a esta revisión