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: "[email protected]"},
  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.

One thought on “Como fazer um comando ou plugin para o firefox ubiquity

  1. 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

Your email address will not be published. Required fields are marked *