---
title: Dodawanie wyszukiwarek z poziomu stron WWW
slug: conflicting/Web/OpenSearch
tags:
  - Dodatki
  - Wszystkie_kategorie
  - Wtyczki_wyszukiwarek
translation_of: Web/OpenSearch
translation_of_original: Web/API/Window/sidebar/Adding_search_engines_from_Web_pages
original_slug: Dodawanie_wyszukiwarek_z_poziomu_stron_WWW
---
<p>
</p><p>Firefox zezwala, aby kod JavaScript instalował wtyczki wyszukiwarek, i obsługuje dwa formaty wtyczek: <a href="pl/Tworzenie_wtyczek_OpenSearch_dla_Firefoksa">OpenSearch</a> i Sherlock.
</p>
<div class="note"><b>Uwaga:</b> Od Firefoksa 2 OpenSearch jest preferowanym formatem wyszukiwania.</div>
<p>Gdy kod JavaScript próbuje zainstalować wtyczkę wyszukiwarki, Firefox wyświetla komunikat z pytaniem o zgodę na instalację wtyczki.
</p>
<h2 id="Instalowanie_wtyczek_OpenSearch">Instalowanie wtyczek OpenSearch</h2>
<p>Aby zainstalować wtyczkę OpenSearch, należy skorzystać z metody DOM <code>window.external.AddSearchProvider()</code>. Składnię tej metody przedstawiono poniżej:
</p>
<pre class="eval">window.external.AddSearchProvider(<i>adresURLWtyczki</i>);
</pre>
<p>Gdzie: <i>adresURLWtyczki</i> jest pełnym adresem URL do pliku XML wtyczki wyszukiwarki.
</p>
<div class="note"><b>Uwaga:</b> Obsługa OpenSearch jest dostępna tylko w Firefoksie 2 i wyższych.</div>
<h2 id="Instalowanie_wtyczek_Sherlock">Instalowanie wtyczek Sherlock</h2>
<p>Aby zainstalować wtyczkę Sherlock, należy użyć metody <code>window.sidebar.addSearchEngine()</code>, składnia jest następująca:
</p>
<pre class="eval">window.sidebar.addSearchEngine(<i>adresURLWtyczki</i>, <i>adresURLIkony</i>, <i>sugerowanaNazwa</i>, <i>sugerowanaKategoria</i>);
</pre>
<ul><li> Parametr <code>adresURLWtyczki</code> to adres URL wtyczki Sherlock (plik ".src"), która ma zostać zainstalowana.
</li><li> <code>adresURLIkony</code> to adres URL ikony, która ma być powiązana z wtyczką.
</li><li> Parametr <code>sugerowanaNazwa</code> jest używany tylko podczas monitowania użytkownika o dopuszczenie do instalacji wtyczki, aby mógł zostać wyświetlony komunikat w stylu "Czy chcesz zainstalować <i>sugerowanaNazwa</i> z <i>adresURLWtyczki</i>?".
</li><li> Parametr <code>sugerowanaKategoria</code> nie jest używany. Powinno się pozostawić go jako pusty łańcuch znaków (<code>""</code>) lub wartość <code>null</code>.
</li></ul>
<p>Więcej informacji na temat formatu Sherlock można znaleźć na stronie <a class=" external" href="http://developer.apple.com/macosx/sherlock/">http://developer.apple.com/macosx/sherlock/</a>
</p>
<h2 id="Wykrywanie_mo.C5.BCliwo.C5.9Bci_przegl.C4.85darki_z_poziomu_silnika_wyszukiwarki">Wykrywanie możliwości przeglądarki z poziomu silnika wyszukiwarki</h2>
<p>Ponieważ uzupełniające API wyszukiwarki zmieniło się między Firefoksem 1.5 a Firefoksem 2.0 oraz ponieważ Firefox 1.5 nie wspiera plików opisu OpenSearch, autorzy stron internetowych, którzy chcą dodać silnik wyszukiwarki w sposób kompatybilny wstecznie (to znaczy tak, żeby działała ona w Firefoksie 1.5, Firefoksie 2.0 lub IE 7), muszą obsługiwać zarówno format Sherlock jak i OpenSearch oraz muszą odpowiednio wykryć możliwości przeglądarki. Poniższy fragment kodu jest przykładem w jaki sposób może to być osiągnięte:
</p><p><br>
</p>
<pre class="eval">function installSearchEngine() {
 if (window.external &amp;&amp; ("AddSearchProvider" in window.external)) {
   // Firefox 2 i IE 7, OpenSearch
   window.external.AddSearchProvider("<span>http://przyklad.com/search-plugin.xml</span>");
 } else if (window.sidebar &amp;&amp; ("addSearchEngine" in window.sidebar)) {
   // Firefox &lt;= 1.5, Sherlock
   window.sidebar.addSearchEngine("<span>http://przyklad.com/search-plugin.src</span>",
                                  "<span>http://przyklad.com/search-icon.png</span>",
                                  "Search Plugin", "");
 } else {
   // Brak obsługi wyszukiwarki (IE 6, Opera, itd.).
   alert("Brak obsługi wyszukiwarki");
 }
}
</pre>
<div class="noinclude">
</div>
{{ languages( { "ca": "ca/Addici\u00f3_de_motors_de_cerca_a_les_p\u00e0gines_web", "en": "en/Adding_search_engines_from_web_pages", "es": "es/A\u00f1adir_motores_de_b\u00fasqueda_desde_p\u00e1ginas_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", "zh-tw": "zh_tw/\u81ea\u7db2\u9801\u6dfb\u52a0\u641c\u5c0b\u5f15\u64ce" } ) }}