Como fazer um comando ou plugin para o firefox ubiquity

Pra quem instalou o ubiquity, nesse post vou ensinar como se faz um plugin simples de busca num site (no caso nosso blog).

Plugin de Busca no Tidbits para Firefox Ubiquity

E na verdade é bem simples. Abra o ubiquity e digite command-editor.

Copie e colo o código lá. O código todo é esse:

CmdUtils.CreateCommand({
  name: "tidbits",
  author: {name: "Danilo Augusto", email: "contato@daniloaugusto.com.br"},
  description: "Buscar no tidbits.com.br",
  homepage: "http://www.tidbits.com.br/",
  takes: {"Digite o que deseja procurar no www.tidbits.com.br": noun_arb_text},
  preview: function(pblock, q) {
    pblock.style.backgroundColor = '#ff0';
    pblock.style.color = '#000';
    if(q.text==''){
      pblock.innerHTML = 'Digite o que deseja procurar no www.tidbits.com.br';
	} else {
      pblock.innerHTML = 'Procurar por "'+q.text+'" no www.tidbits.com.br';
    }
  },
  execute: function (q) {
    var url = "http://www.tidbits.com.br/?s=" + q.text;
    Utils.openUrlInBrowser (url);
  }
});

Explicando linha a linha :

1 – Cria o comendo
2 – nome do comando (o que vc vai digitar no ubiquity para chamar a função que você está criando).
3, 4 e 5 – Descrição.
6 – O que aparece no ubiquity explicando como o usuário deve usar o comando.
7 a 15 – Abre o preview. O preview é a caixa roxa do ubiquity (nesse caso amarela) onde é escrito algum comentário. Para alterar ele é simples, funciona como um objeto DOM para o javascript ( pblock ), nele vc pode colocar dhtml comum como
pblock.innerHTML = ‘teste’;
pblock.style.minHeight = ’400px’
ou como fiz no exemplo :
pblock.style.backgroundColor = ‘#ff0′;
pblock.style.color = ‘#000′;

e o “q” é o objeto que guarda o valor que o usuário digitou (usando q.text).

16 – abre o bloco de execução do comando (o que vai fazer quando o usuário apertar enter).
17 – declarei uma váriavel dizendo a url que desejo abrir.
18 – abre uma url.
19 – encerra bloco de execução.
20 – encerra o comando.

Para exportar o comando para seu site é simples, coloque o código dentro de um arquivo .js

e dentro do head do seu site coloque o seguinte comando:

<link rel="commands" href="ubiquity.js" name="Busca no meu site" />

Fazendo assim, para adicionar o commando, considerando que já tenha o ubiquity instalado, é claro, é só clicar no botão “Subscribe” a direita dessa barrinha que apareceu no canto superior do seu firefox :

Confirmar instalação do comando

Em seguida é só confirmar na tela abaixo:

Tela de concordo com os termos abaixo

Pronto, reinicie o firefox, aperte ctrl + espaço e digite tidbits (o nome do comando ) para chamar a função.

Além desse, eu já tinha feito anteriormente um comando pra gerar Lorem Ipsum.

Mais documentação sobre como criar comandos para o ubiquity pode ser encontrada aqui.

bookmark bookmark bookmark bookmark bookmark bookmark bookmark

Você pode se interessar também por:

Postado por Danilo em Javascript, Navegadores | 1 Resposta »

One Response to “Como fazer um comando ou plugin para o firefox ubiquity”

  1. 1
    Clênio Luiz Says:
    December 25th, 2008 at 12:59 pm

    Ubiquity é uma excelente ferramenta pena que a comunidade ainda é pequena.

    A propósito, estou o usando o seu gerador de lorem, muito bom.

    Parabéns pelo blog e pela iniciativa. Ganhou um leitor huahau

Leave a Reply