A grande maioria dos usuários que utilizam as versões mais recentes de seus navegadores favoritos ( Firefox 2 e 3 e Internet Explorer 7 e 8 ) conhecem e usam a famosa barra de buscas que normalmente fica situada na parte superior direita do navegador, que provê acesso rápido a vários mecanismos de buscas em um único formulário, de uma forma simples e rápida.

Por padrão, os principais mecanismos de busca já se encontram incluídos neste formulário, como Google, Yahoo e Live Search, além de algumas buscas extras, como Wikipédia, Buscapé e Mercado Livre.

Se o navegador não julga o meu site como importante o suficiente para ser incluído como busca padrão em sua barra, como eu posso adicionar a busca do meu site neste mecanismo?

Simples, basta criar um adicionador usando o padrão OpenSearch e disponibilizá-lo para que os visitantes possam adicionar a minha busca entre seus provedores de busca favoritos. O padrão OpenSearch normaliza os padrões de sintaxe usados na criação de sistemas de buscas, tornando-os compatíveis com a maioria dos navegadores, para que os pobres desenvolvedores não precisem criar uma busca diferente para cada navegador utilizado pelo usuário. Padrões abertos são importantes e facilitam a vida! Certo, Microsoft?

1. Definindo o Sistema de Busca: Para se criar um provedor de buscas, o site em questão deve possuir um sistema de buscas interno que possa receber parâmetros pelo método GET, ou seja, receber o conteúdo que deseja ser buscado através de uma URL.

Exemplo: Blogs baseados no sistema Wordpress, possuem um mecanismo de buscas interno onde a expressão buscada, no caso a palavra Linux, é passada para o arquivo responsável pela busca (index.php) através da variável "s", onde a busca é feita e retornada ao usuário. O mesmo exemplo é facilmente observado no Google.

http://pliniotorres.wordpress.com/index.php?s=linux

http://www.google.com.br/search?q=linux

2. Montando o Arquivo de Adição: Após definir a busca, vamos montar o arquivo XML responsável por adicionar a sua busca ao sistema de buscas da barra do navegador. Abra um arquivo em branco no bloco de notas e adicione os seguintes comandos:

<?xml version="1.0" encoding="iso-8859-1"?>
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
<ShortName>Blog do Plínio Torres</ShortName>
<LongName>Blog do Plínio Torres - O equilíbrio que mantém os sistemas funcioando</LongName>
<Description>Blog sobre informática e tecnologia</Description>
<Url type="text/html" template="http://pliniotorres.wordpress.com/index.php?s={searchTerms}"/>
<Image height="64" width="64" type="image/png">http://pliniotorres.wordpress.com/imagens/icone64.png</Image>
<Image height="16" width="16" type="image/png">http://pliniotorres.wordpress.com/imagens/icone16.png</Image>
<Language>pt-br</Language>
<OutputEncoding>iso-8859-1</OutputEncoding>
<InputEncoding>iso-8859-1</InputEncoding>
</OpenSearchDescription>

Salve o arquivo com a extensão XML, usando um nome minúsculo e sem espaços: busca.xml

Download do exemplo aqui.

Explicando:

Este é o cabeçalho do arquivo OpenSearch. O padrão para o encoding deste documento é UTF-8, mas para evitarmos problemas com acentuação, definiremos a encoding iso-8859-1.

<?xml version="1.0" encoding="iso-8859-1"?>
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">

Em ShortName, LongName e Description, preencha as tags com o nome e a descrição do seu site ou blog, como no exemplo abaixo. Este nome aparecerá na hora de selecionar o provedor na barra de buscas.

<ShortName>Blog do Plínio Torres</ShortName>
<LongName>Blog do Plínio Torres - O equilíbrio que mantém os sistemas funcioando</LongName>
<Description>Blog sobre informática e tecnologia</Description>

A tag template é a mais importante do arquivo. Aqui é definido o endereço que será usado pela busca interna do seu site. Basta adicionar o endereço da busca, mais o local onde o termo pesquisado deve ser encaixado no endereço. O local onde o termo será adicionado é representado pela variável {searchTerms} e não deve ser modificado.

<Url type="text/html" template="http://pliniotorres.wordpress.com/index.php?s={searchTerms}"/>

Outro exemplo:
<Url type="text/html" template="http://www.seusite.com.br/busca.php?termo={searchTerms}"/>

A tag image define os ícones que aparecerão na lista de provedores disponíveis na barra do navegador. Crie dois Favicons, um de tamanho 16X16 e outro 64X64 pixels, ambos em formato PNG e indique o caminho onde eles se encontram hospedados no seu site.

<Image height="64" width="64" type="image/png">http://pliniotorres.wordpress.com/imagens/icone64.png</Image>
<Image height="16" width="16" type="image/png">http://pliniotorres.wordpress.com/imagens/icone16.png</Image>

A tag Language define em qual linguagem o site de buscas se encontra e as tags OutputEncoding e InputEncoding definem em qual padrão o termo de busca deve ser introduzido no formulário e como o resultado da pesquisa deve ser mostrado para o internauta. Como eu citei anteriormente, o padrão aqui é UTF-8, mas devido a alguns problemas na busca de palavras acentuadas, mudei a encoding para iso-8859-1 e o problema foi solucionado.

<Language>pt-br</Language>
<OutputEncoding>iso-8859-1</OutputEncoding>
<InputEncoding>iso-8859-1</InputEncoding>

Finalizando, fechamos o arquivo com a tag </OpenSearchDescription>.

3. Adicionando o Provedor de Buscas: Agora, basta disponibilizar um link onde o usuário possa adicionar o provedor de buscas criado ao seu navegador. Para isso, crie um link em um texto ou em uma figura, através do chamado JavaScript window.external.AddSearchProvider, para o arquivo XML hospedado em sua página.

Exemplo:

<a href="javascript:void(window.external.AddSearchProvider
('http://www.seusite.com.br/busca.xml'));">
Adicionar este site a lista de Provedores de Busca!</a>

Infelizmente, o Wordpress não permite o uso de JavaScript em suas páginas e esta é a única maneira de se adicionar o provedor. Então, para demonstrar o funcionamento do script, criei um link com o adicionador no meu site pessoal, confira:

Clique aqui para adicionar o Blog do Plínio Torres a Lista de Provedores de Busca

Após adicionar o Provedor de Buscas, basta selecioná-lo e digitar o termo a ser pesquisado e pronto! Você tem acesso rápido e direto ao sistema de buscas do seu site.

O adicionador funcionou bem com o Firefox e ao Internet Explorer. Peço aos leitores de plantão que testem o recurso em outros navegadores, com o Opera.

Espero que este post seja útil, dúvidas nos comentários! :)

This entry is bit of self-cross promotion today for one of my projects, BoxSyndication 2.

BoxSyndication 2 is a popular custom tag for the ColdFusion Mark-up compatible range of web servers that enables you to generate web based, syndicated feeds. It allows developers create feeds that support the Atom 1; RSS 2 and Apple iTunes Podcasting namespace standards using query or structure datasets. In addition Box Syndication 2 also supports the Creative Commons License, OpenSearch and the Dublin Core Metadata namespaces for both feed types.

With the new 1.1 version of this software that was released last week, BoxSyndication 2 introduces a new set of features that are not available elsewhere for ColdFusion and compatible servers

·         Full Unicode UTF-8 support
·         High ASCII character to XML safe hexadecimal character conversion
·         Really Simple Syndication 2.0.10 namespace support
·         OpenSearch 1.1 namespace support
·         Dynamic Atom element value encoding

In addition we now include a generous sample of 15 different feed examples which have all been created from scratch for this new release including an OpenSearch implementation. Plus there are extra tips and examples on automatic discovery for your feeds and as well as a guide on saving bandwidth by using HTTP conditional gets. If this all seems too much, the examples folder now has its own index cover page to allow for easy access and navigation to each item.

As always this new release is a free upgrade for all owners of both BoxSyndication and BoxSyndication 2. Otherwise it is a $35US purchase for an unlimited upgrade, single developer license. BoxSyndication 2 is compatible with Adobe ColdFusion 6.1,7,8; New Atlanta BlueDragon 6.2,7 and Railo Technologies Railo 2.

BoxSyndication 2 Website

Esse post irá apresentar um exemplo para facilitar as pesquisas no acervo da Biblioteca da Universidade Federal de Itajubá. Para instalar, vá até a página de << download >> e clique no link BIM UNIFEI.

O resto do post, é uma descrição dos problemas encontrados, então se você não tem interesse pare por aqui.

Caso esteja no GNU/Linux, o plugin será instalado no diretório padrão do seu usuário, normalmente definido em: ~/.mozilla/firefox/9ymqvxal.default/searchplugins (a parte em vermelho provavelmente será diferente). O codigo-fonte encontra-se no arquivo bim-unifei.xml, um arquivo XML, fácil de entender. Já no Microsoft Windows: C:\Documents and Settings\<usuario>\Dados de aplicativos\Mozilla\Firefox\Profiles\<sowsjqep>.default\searchplugin. Caso você não encontre nenhum desses diretórios procure pelo nome do arquivo (bim-unifei.xml). Se você quiser testar, brincar com o script: edite, salve e reinicie o Firefox, se não aparecer nada na barra é porque há algum erro, então é preciso abrir o arquivo (pelo Firefox mesmo) e ver a saída.

Bugs conhecidos

• Após fazer algumas buscas, percebe-se que ele oculta o texto dos radiobutton e do button do formulário HTML. (Agradecimentos: Fabio Ricotta, que viu que eu não estava passando todos os parâmetros no arquivo XML)
• A página da BIM funciona com frames, ainda não descobri como carregar esses frames no resultado.

Basicamente estou utilizando a documentação do OpenSearch para estudar. Se você tem alguma dica ou sugestão, não exite em comentar aqui no blog ou enviar fax, carta, e-mail, etc; Ainda considero uma versão de desenvolvimento, pois faltam algumas funcionalidades que acredito serem importantes, de qualquer forma estou compartilhando para quem quiser. O código-fonte é GPL, então não se preocupe com restrições a sua liberdade em executar, estudar e adaptar, redistribuir, distribuir modificações.

Propaganda ;-)

Também há como fazer as buscas por livros na Unicamp, com search plugin SBU UNICAMP. (adicionado pelo comentário do capi)

O repositório (Mycroft) do Search Plugin BIM UNIFEI é projeto da comunidade

To offer a search plug-in to your page visitors, you simply have to include a reference to your OpenSearch xml file in the head of your html. There are various methdods to create a file, but here I will only show the most basic.

Creating the XML

OK, let's say your search page has following URL: http://www.your-page.org/search.aspx?q=any+search+query

Your OpenSearch file would then look something like this:

<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/" xmlns:moz="http://www.mozilla.org/2006/browser/search/">
<ShortName>your-page.org</ShortName>
<Description>Your exciting descriptive text</Description>
<Image height="16" width="16" type="image/x-icon">http://www.your-page.org/favicon.ico</Image>
<Url type="text/html" method="get" template="http://www.your-page.org/search.aspx?q={searchTerms}"/>
</OpenSearchDescription>

Don't forget the namespace, otherwise there will be errors when you try and include the search in Firefox.

In this example the icon used for the search would be your favicon, but you could just as well reference any other icon. Don't use larger icons, stick with 16x16. Using any other size will muddle the list in Firefox.

You can also embed the icon directly in the xml usinge base 64 encoding. You can easily encode an image at The data: URI kitchen. Then include the image like this: <Image height="16" width="16">data:image/x-icon,%00 ...</Image>

The placeholder {searchTerms} will be replaced by user input in the search field.

Referenceing OpenSearch

All you need to do now is to reference the xml file in the head of your html.

<link rel="search" type="application/opensearchdescription+xml" href="http://now-in-org.preview.complexx.com/opensearch.xml" title="preview now-in.org" />

That's it. Now anybody can include your page in their browser search.

El plugin sirve para agregar el buscador del Menéame a la barra de búsquedas del Firefox2 o IE7. Como es un estándar abierto --y muy simple-- supongo que lo adoptarán los demás navegadores.

Para activarlo basta con visitar el Menéame, desplegar el menú y "agregar" el plugin del Menéame.

Una vez que está en la lista se lo puede seleccionar para buscar en el Menéame.

Sí, pijaditas, pero no cuesta nada hacerlas y quizás a algunos les sea útil (aunque sea para mirar el código y usarlo de ejemplo) :-)

Come funziona??
Basta andare sul sito desiderato, tipo you tube.
Cliccare con il destro sopra la casella di ricerca e scegliere:
Add OpenSearch plugin.

Settare i vari parametri (titolo, descrizione e icona).
Fine.