Title: Open Search Document
Author: Matthias Pfefferle
Published: <strong>24. јун 2007.</strong>
Last modified: 20. септембар 2026.

---

Претражи додатке

![](https://ps.w.org/open-search-document/assets/banner-772x250.png?rev=2841764)

![](https://ps.w.org/open-search-document/assets/icon-128x128.png?rev=2841764)

# Open Search Document

 Аутор: [Matthias Pfefferle](https://profiles.wordpress.org/pfefferle/)

[Преузми](https://downloads.wordpress.org/plugin/open-search-document.4.2.0.zip)

 * [Детаљи](https://sr.wordpress.org/plugins/open-search-document/#description)
 * [Рецензије](https://sr.wordpress.org/plugins/open-search-document/#reviews)
 *  [Постављање](https://sr.wordpress.org/plugins/open-search-document/#installation)
 * [Развој](https://sr.wordpress.org/plugins/open-search-document/#developers)

 [Подршка](https://wordpress.org/support/plugin/open-search-document/)

## Опис

Browsers can learn how to search a website if the site tells them. This plugin adds
that information to your WordPress site, in the form of an [OpenSearch](https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md)
description document.

Once activated, visitors can add your site as a search engine in their browser, 
or the browser picks it up on its own. Typing a keyword and a search term into the
address bar then searches your site instead of the web.

There is nothing to configure. Install it, activate it, done.

### What visitors get

 * **Chrome and Edge**: your site shows up under „Site search“ in the browser settings.
   After activating it there, visitors type your domain, hit `Tab` and search your
   site. Chrome calls this [„Tab to Search“](https://www.chromium.org/tab-to-search/).
 * **Firefox**: the address bar offers to add your site as a search engine. Visitors
   can also right click the address bar and pick „Add“ ([OpenSearch in Firefox](https://developer.mozilla.org/en-US/docs/Web/XML/Guides/OpenSearch)).
 * **Safari**: with [„Quick Website Search“](https://developer.apple.com/library/archive/releasenotes/General/WhatsNewInSafari/Articles/Safari_8_0.html)
   enabled, Safari remembers your site after the first search and offers it in the
   address bar.
 * **Search suggestions**: while typing, the browser can show suggestions. The plugin
   uses your tags for that.
 * **Your site icon** is used as the icon of the search engine, if you have one 
   set under _Appearance > Customize > Site Identity_.

### What the plugin adds

 * The OpenSearch description document at `/wp-json/opensearch/1.1/document`
 * A suggestions endpoint at `/wp-json/opensearch/1.1/suggestions?s=…`
 * Autodiscovery links in the [HTML head](https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md#autodiscovery-in-htmlxhtml)
   and in the [Atom and RSS feeds](https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md#autodiscovery-in-rssatom)
 * A search provider entry in the web app manifest, for the [„search_provider“ WebExtension](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_settings_overrides)
   setting
 * Links in [host-meta](https://wordpress.org/plugins/host-meta/) and [WebFinger](https://wordpress.org/plugins/webfinger/),
   if those plugins are installed
 * Search URLs for the [Atom and RSS search responses](https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md#examples-of-opensearch-responses)
   and the [OpenSearch Suggestions extension](https://github.com/dewitt/opensearch/blob/master/mediawiki/Specifications/OpenSearch/Extensions/Suggestions/1.1/Draft%201.wiki)

## Снимци екрана

[⌊Firefox OpenSearch plugins⌉⌊Firefox OpenSearch plugins⌉[

Firefox OpenSearch plugins

[⌊Safari Quick Website Search⌉⌊Safari Quick Website Search⌉[

Safari Quick Website Search

[⌊Chrome Tab to Search⌉⌊Chrome Tab to Search⌉[

Chrome Tab to Search

## Постављање

 1. Install the plugin from the WordPress plugin directory, or upload the `open-search-
    document` folder to `/wp-content/plugins/`
 2. Activate it through the _Plugins_ menu
 3. That’s it, there are no settings

## ЧПП

### How do I check that it works?

Open `https://yoursite.com/wp-json/opensearch/1.1/document` in your browser. You
should see a short XML file with the name of your site and the search URLs.

### Does it change the search on my site?

No. The plugin only describes the search you already have. The browser sends visitors
to your normal search results page.

### Chrome does not offer my site for „Tab to Search“

Chrome no longer adds sites on its own. Go to `chrome://settings/searchEngines`,
look for your site under „Inactive shortcuts“ and activate it. Edge works the same
way under `edge://settings/searchEngines`.

### Where do the suggestions come from?

From your tags. Other plugins can change that with the `open_search_document_suggestions`
filter.

### Can I add query params to the search URLs?

Yes, with the `osd_search_url_template` filter. The second argument tells you which
search URL is filtered: `html`, `atom` or `rss2`.

    ```
    function custom_osd_extend( $url, $type ) {
        return add_query_arg( 'mtm_campaign', 'opensearch', $url );
    }
    add_filter( 'osd_search_url_template', 'custom_osd_extend', 10, 2 );
    ```

### What are the tags in the document?

The `Tags` element lists the ten most used tags of your site, as keywords for the
search engine. Sites without tags get `WordPress blog`. The `osd_tags` filter lets
you change the list.

### Can I add more elements to the document?

Yes. The `osd_xml` action runs inside the document, right before the closing tag.
The `osd_ns` action lets you add namespaces to the root element.

## Рецензије

![](https://secure.gravatar.com/avatar/66abdf8d70430fb4f73b321cb04d7884ab37ab748b2ba2088c182697b941b504?
s=60&d=retro&r=g)

### 󠀁[Works perfectly well (and completely hidden as expected)](https://wordpress.org/support/topic/works-perfectly-well-and-completely-hidden-as-expected/)󠁿

 [Marc Bernard](https://profiles.wordpress.org/luxxor/) 10. април 2020.

Thanks for this nifty plugin! Perfect! You might want to add some documentation 
since it's very hidden how it works. 1) After activating the plugin, a <link rel
="search"> tag is added to the header of your webpages. 2) This link points to https://
domain.com/wp-json/opensearch/1.1/document and produces an XML document. 3) This
document.osdx contains the OpenSearch specification for your website. 4) An additional
use case, is downloading this file to your Windows machine. Then you can double-
click it to install a search connector to Windows. This lets you search your own
website directly from your Windows and Explorer search bars. Just type the first
letters of your website name to get it going! Best, Marc

![](https://secure.gravatar.com/avatar/560dfc09a183c3769b77fc1ba47b779ea0fc5e877e889ad32adf5638b3414241?
s=60&d=retro&r=g)

### 󠀁[thanks for the update, why not used on more webpages?](https://wordpress.org/support/topic/thanks-for-the-update-why-not-used-on-more-webpages/)󠁿

 [Tobias @Saleswonder.biz](https://profiles.wordpress.org/tobias_conrad/) 23. јануар
2018.

Maybe an gif animation for the visitors which is linked to a desccription howto 
use would be nice. i would like to translate to german.

![](https://secure.gravatar.com/avatar/be1b34034f175b87489ac4f8504e5c19cb69ce2d574660e79f6335c963957982?
s=60&d=retro&r=g)

### 󠀁[Perfect](https://wordpress.org/support/topic/perfect-4736/)󠁿

 [ok2vvv](https://profiles.wordpress.org/ok2vvv/) 17. јануар 2018.

Plugin works exactly as it should. I was looking for a plugin that activates on 
the web in google chrome search using the TAB key. Thanks a lot.

![](https://secure.gravatar.com/avatar/d3c6872f75d25bd6e7e4afe7de91beede5a71b8cb38041daa8cb7b1396f80407?
s=60&d=retro&r=g)

### 󠀁[Do what it should](https://wordpress.org/support/topic/do-what-it-should-2/)󠁿

 [rinma](https://profiles.wordpress.org/rinma/) 20. април 2017.

This plugin is easy to use. Install it and it works 🙂

 [ Прочитај све 4 рецензије ](https://wordpress.org/support/plugin/open-search-document/reviews/)

## Сарадници и градитељи

„Open Search Document“ је софтвер отвореног кода. Следећи људи су допринели овом
додатку.

Сарадници

 *   [ Matthias Pfefferle ](https://profiles.wordpress.org/pfefferle/)
 *   [ johnnoone ](https://profiles.wordpress.org/johnnoone/)

„Open Search Document“ је преведен на 1 језик. Хвала [преводиоцима](https://translate.wordpress.org/projects/wp-plugins/open-search-document/contributors)
на њиховим доприносима.

[Преведите „Open Search Document“ на свој језик.](https://translate.wordpress.org/projects/wp-plugins/open-search-document)

### Заинтересовани сте за развој?

[Прегледајте кôд](https://plugins.trac.wordpress.org/browser/open-search-document/),
погледајте [SVN складиште](https://plugins.svn.wordpress.org/open-search-document/)
или се претплатите на [дневник развоја](https://plugins.trac.wordpress.org/log/open-search-document/)
преко [RSS-а](https://plugins.trac.wordpress.org/log/open-search-document/?limit=100&mode=stop_on_copy&format=rss).

## Дневник измена

### 4.2.0

 * The REST controller extends the WordPress `WP_REST_Controller` class
 * Search suggestions keep spaces and upper case letters in the query
 * The document no longer has a stray `null` at the end
 * Site name, description and URLs are escaped for XML
 * The suggestions URL has `rel="suggestions"` and the document links to itself 
   with `rel="self"`
 * Site icons carry their MIME type
 * The `Tags` element lists the most used tags of the site, filterable with `osd_tags`
 * Removed the `Contact` element, the spec expects an email address there
 * Removed the `Developer` element
 * Removed the XRDS-Simple integration, the plugin is closed on WordPress.org
 * `url_template()` and `feed_url_template()` are deprecated, use `get_url_template()`
 * Requires WordPress 6.4 and PHP 7.4
 * Added tests and a new readme

### 4.1.3

 * update plugin structure

### 4.1.1

 * fix PHP deprecated: strstr(): Passing null to parameter

### 4.1.0

 * added [„search_provider“ WebExtension](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_settings_overrides)
   support

### 4.0.1

 * fix broken XML output

### 4.0.0

 * modernize code
 * added filters for the search URLs in the OSD document

### 3.0.3

 * fix missing permission callback

### 3.0.2

 * update requirements

### 3.0.1

 * added screenshots
 * code improvements

### 3.0.0

 * moved to WordPress API

### 2.1.2

 * fixed site icon implementation

### 2.1.1

 * fixed site icon implementation

### 2.1.0

 * fixed XML output
 * encapsulated XML data

### 2.0.0

 * complete refactoring
 * WordPress coding style
 * Site icon support

### 1.3.1

 * Some smaller fixes

### 1.3

 * fixed host-meta link
 * added webfinger support

### 1.2.2

 * Added function to flush rewrite_rules

### 1.2.1

 * Autodiscovery for host-meta

### 1.2

 * OpenSearch Suggestions extension

### 1.1

 * WordPress 2.8.x compatibility
 * Autodiscovery for RSS/Atom and XRDS
 * Profile-Services

### 1.0

 * Почетно издање

## Додатак заједнице

Овај додатак је развијен и подржан од стране заједнице. [Допринеси овом додатку](https://github.com/pfefferle/wordpress-open-search-document)

## Мета

 *  Издање **4.2.0**
 *  Последње ажурирање **пре 3 седмице**
 *  Активних постављања **200+**
 *  Издање Вордпреса ** 6.4 или новије **
 *  Испробано до **7.1.3**
 *  PHP издање ** 7.4 или новије **
 *  Језици
 * [English (US)](https://wordpress.org/plugins/open-search-document/) и [German](https://de.wordpress.org/plugins/open-search-document/).
 *  [Преведите на свој језик](https://translate.wordpress.org/projects/wp-plugins/open-search-document)
 * Ознаке
 * [browser](https://sr.wordpress.org/plugins/tags/browser/)[opensearch](https://sr.wordpress.org/plugins/tags/opensearch/)
   [search](https://sr.wordpress.org/plugins/tags/search/)[suggestions](https://sr.wordpress.org/plugins/tags/suggestions/)
 *  [Напредни преглед](https://sr.wordpress.org/plugins/open-search-document/advanced/)

## Оцене

 5 од 5 звездица.

 *  [  4 рецензије са 5 звездице     ](https://wordpress.org/support/plugin/open-search-document/reviews/?filter=5)
 *  [  0 рецензија са 4 звездица     ](https://wordpress.org/support/plugin/open-search-document/reviews/?filter=4)
 *  [  0 рецензија са 3 звездица     ](https://wordpress.org/support/plugin/open-search-document/reviews/?filter=3)
 *  [  0 рецензија са 2 звездица     ](https://wordpress.org/support/plugin/open-search-document/reviews/?filter=2)
 *  [  0 рецензија са 1 звездица     ](https://wordpress.org/support/plugin/open-search-document/reviews/?filter=1)

[Ваша рецензија](https://wordpress.org/support/plugin/open-search-document/reviews/#new-post)

[Види све рецензије](https://wordpress.org/support/plugin/open-search-document/reviews/)

## Сарадници

 *   [ Matthias Pfefferle ](https://profiles.wordpress.org/pfefferle/)
 *   [ johnnoone ](https://profiles.wordpress.org/johnnoone/)

## Подршка

Имате нешто да кажете? Потребна вам је помоћ?

 [Види форум подршке](https://wordpress.org/support/plugin/open-search-document/)

## Донирај

Желите ли да подржите напредак овог додатка?

 [ Донирај овом додатку ](https://notiz.blog/donate/)