1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
---
title: Dodawanie wyszukiwarek z poziomu stron WWW
slug: Dodawanie_wyszukiwarek_z_poziomu_stron_WWW
tags:
- Dodatki
- Wszystkie_kategorie
- Wtyczki_wyszukiwarek
translation_of: Web/OpenSearch
translation_of_original: Web/API/Window/sidebar/Adding_search_engines_from_Web_pages
---
<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 && ("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 && ("addSearchEngine" in window.sidebar)) {
// Firefox <= 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" } ) }}
|
