domingo, 11 de janeiro de 2009

Mantis Bugtracker plugins - parte 2

ATENÇÃO: Post atualizado!
O Plugin Manager apresentado abaixo é uma ferramenta de terceiros e não é mais suportado por versões superiores a 1.2.0
Podemos evidenciar isso pelos links abaixo
http://www.mantisbt.org/forums/viewtopic.php?f=3&t=19935
http://www.mantisbt.org/bugs/view.php?id=12183

Porém...
Alternativamente alguns plugins da nova estrutura de plugins do Mantis podem ser visualizados em
https://github.com/mantisbt-plugins

----

Nesse post veremos o funcionamento o plugin BBCode.

Se esta é a primeira vez que você visualiza este post ou não tem o PluginManager instalado no Mantis, por favor, leia o post Mantis Bugtracker plugins - parte 1

Instalando o plugin
Nessa instalação, vou optar por baixar o arquivo .pkg e submete-lo via interface de administração do Plugin Manager.
Para isso você precisa estar logado no Mantis como Administrador e possuir o plugin Plugin Manager instalado.

O download do plugin pode ser feito na página de download dos plugins ou diretamente neste link. A versão do plugin utilizada agora é a 0.0.5
Com o plugin baixado, vá até o link Plugins no Mantis e clique no botão Browse, selecionando o plugin BBCode.

Clique para ampliar

Feito isso clique no botão Submit. A tela com os detalhes da instalação do plugins é apresentada:


Clique para ampliar

Clique no link Return to Plugin Manager. Noque que na lista de plugins instalados o BBCode será listado.

Para habilitá-lo, é necessário entrar nas configurações do plugins e marcar a checkbox Enable. Basicamente existem três propriedades:
  • Enable: habilita ou desabilita o plugin
  • Editor Type: especifica o tipo de editor: Simples ou WYSIWYG
  • Custon Tags: adicionar tags especificar para o editor
Tipos de Editor
Como há nas configrações, existem dois tipos de editor: o Simples e o WYSIWYG
Eles aparecerão em todos os campos que forem do tipo texto livre.

A diferença básica entre eles (confesso que não sei a diferença total) é que o editor WYSIWYG já aplica as alterações diretamente no componente, e o editor Simples insere tags tipo BBCode.
Abaixo a imagem de cada um deles:

Editor WYSIWYG em modo de edição (clique para ampliar)

Editor Simples em mode de edição (clique para ampliar)

Visualização da aplicação do editor (Simples ou WYSIWYG)

Importante
Se você desabilitar ou remover o plugin os caracteres BBCode continuarão no banco de dados e serão exibidos na issue.

Clique para ampliar

Ainda não descobri como remover os BBCodes do banco, mas assim que eu conseguir, atualizo este post.

Por agora era isso... A maioria dos plugins são fáceis de instalar e traz uns benefícios legais, como o BBCode.
Logo trarei mais plugins aqui.
Abraços!

sábado, 10 de janeiro de 2009

Mantis Bugtracker plugins - parte 1

ATENÇÃO: Post atualizado!
O Plugin Manager apresentado abaixo é uma ferramenta de terceiros e não é mais suportado por versões superiores a 1.2.0
Podemos evidenciar isso pelos links abaixo
http://www.mantisbt.org/forums/viewtopic.php?f=3&t=19935
http://www.mantisbt.org/bugs/view.php?id=12183

Porém...
Alternativamente alguns plugins da nova estrutura de plugins do Mantis podem ser visualizados em
https://github.com/mantisbt-plugins

----

Poucos sabem, mas o Mantis pode ser entendido por diversos plugins.
Um dos desenvolvedores do Mantis criou a maioria do plugins disponíveis no site http://deboutv.free.fr/mantis/
A intenção neste post é apresentar o que faz cada plugin, onde dividiremos em séries apresentando estes plugin, para que você possa tirar mais proveito dessa ferramenta de BugTracker

O inicio de tudo: Plugin Manager
O Plugin Manager é o “plugin pai”, é com ele que gerenciamos os outros plugins. Segundo sua própria página ele é responsável por:
  • Gerenciar a instalação, atualização e remoção de plugins
  • Possibilidade de criar o seu próprio plugin e compartilhá-lo com a comunidade
  • Fácil de instalar
  • Gerenciar tradução (se o plugin suportar)
IMPORTANTE: para poder utilizar todos os plugins, é necessário ter instalado, no mínimo, o Mantis 1.0.5.
Neste post a versão do Mantis que está sendo utilizado é a 1.1.6

O donwload do plugin pode ser feito diretamente na página de downloads do site. Procure sempre baixar a ultima versão.
Como estamos fazendo a instalação "do zero", não será o intuito aqui apresentar como se faz a atualização dos plugins, mas a mesma pode ser encontrada na página de cada um.

A versão que utilizaremos aqui do Plugin Manager é a 0.40

Depois de baixar o plugin (arquivo .tar.gz que pode ser aberto com qualquer software de compressão de arquivos), descompacte-o na pasta raiz do Mantis. No meu caso a pasta raiz do Mantis aqui é C:/wamp/www/mantisbt-1.1.6
Serão descompactadas uma pasta chamada plugins e e oito arquivos .php com o prefixo plugins_

Agora entre no Mantis como administrador. Feito isso substitua a pagina my_view_page.php por plugins_page.php na barra de URL do seu navegador. No meu caso a barra de URL ficou http://localhost/mantisbt-1.1.6/plugins_install_page.php

A página de confirmação do plugin será apresentada, conforme a imagem abaixo:
Clique na imagem para ampliar

Atualizando a página você vai notar que um link chamado Plugins será habilitado. Clicando nesse link você será redirecionado para a página do Plugin Manager.

Clique na imagem para ampliar


Existe três maneiras de instalar um plugin:
  1. Adicionando a URL do plugin
  2. Carregar o plugin pela página
  3. Selecionando um plugin na lista d eplugins disponíveis
Isso tudo é feito pela tela do Plugin Manager

Clique na imagem para ampliar

Todos os plugins disponíveis na página de download tem a extensão .pkg. Basta colar a URL do plugin, se você não quiser baixá-lo (Plugin URL (FTP, HTTP or File) ) , procurar o plugin se você baixou ele ( Upload file (*.mantis-pkg only) ) ou instalar pela lista de plugins disponíveis (Available plugin list).

A lista de plugins disponíveis apresenta os plugins por nome, descrição, autor, data e versão. Basta clicar no link Install que ele será instalado no Mantis. A mesma coisa serve para remover os plugins já instalados.

As três maneiras que você tem para instalar um plugin, levarão para a mesma tela de informações da instalação do plugin, mesma tela de quando instalamos o Plugin Manager.

Após ter procedido com a instalação do plugin ele aparecerá na lista de plugins

Clique na imagem para ampliar


Na lista de plugins temos as seguintes ações:
  • Alterar as configurações do plugin clicando em seu nome na coluna Plugins
  • Visitar seu website clicando no link www da coluna Website
  • Verificar a versão do plugin na coluna em Installed/Current version
  • Remover um plugin clicando no link Unistall na coluna Unistall a plugin
As propriedades do plugin Plugin Manager são as seguintes:
  • Check Version: verifica a versão instalada
  • Check Development Version: verifica a versão de desenvolvimento
  • Display Website URL: exibir a URL de aceso do plugin
  • URL list of site providing plugins: URL para a lista de plugin disponíveis (Available plugins)
  • Threshold to see Plugins link: Limiar para ver o link de plugins. O perfil que visualizar esse link só poderá ver os plugins instalados
  • Install/Uninstall/Package: Limiar para gerenciar os plugins
  • Configuration threshold (Plugin Manager): que perfil poderá configurar as propriedades do Plugin Manager
Clique na imagem para ampliar

Para a remoção de plugins basta clicar no link Uninstall. Antes da remoção efetiva uma tela de confimação aparecerá:
Clique na imagem para ampliar

Removendo o plugin, uma tela informando todas as ações executadas para a remoção do mesmo aparecerá.

Bem. Este post mostrou como instalar o "plugin pai". Da mesma forma instalaremos os outros plugins. No proximo post já inciaremos a instalação e utilização dos plugins disponíveis.

Abraços!

quinta-feira, 8 de janeiro de 2009

Nem os grandes portais se livram dos pequenos bugs

Pois é, estava eu a navegar pelo site do Terra, que inclusive mudou seu visual, e uma coisa me chamou a atenção: uma sidebar de anúncios publicitários. O funcionamento é bem simples, ele aparece somente com os icones do produto, quando você deixa o mouse sobre ele a sidebar é expandida e o detalhe do produto em que o foco do mouse está é apresentado.
O problema é que vi umas caixinhas cor de laranja, e ainda por cima com um monte de "m" no local onde deveria ser o texto do produto. Acessem o portal ou vejam as figuras abaixo:
Na primeira imagem temos a sidebar com somente o quadrado laranja (hado-a-hado....), na segunda vemos a sidebar expandida e os "m" e na terceira vemos o detalhe do "produto" quadrado laraja...

Isso me faz lembrar os tempos em que tudo na empresa era feito as pressas com um espaço mais curto que uma corrida de 100m rasos para testar.

Mas não adianta só falar de problemas né? Eu logo pensei no que poderia ter acontecido e como sanar este problema, então aí vão minhas considerações (to tentando fazer uma engenharia reversa dos requisitos, rsrsrsrs):
  • Provavelmente a sidebar deve ter um número fixo de icones
  • O gerenciamento destes icones (produtos) devem (não sei) ser gerenciados por ordem de colocação
  • Produtos não inseridos geram espaços vazios, que devem ser manter a ordem dos produtos
O que poderia ser feito com este e possíveis sujestões:
  • Espaço sobrando nos produtos deveria não apresentar nada (fazer um push/pop nos itens da sidebar)
  • Caso o requisito seja apresentar um "produto vazio", colocar uma mensagem de "sem produto" (ou algo assim), para indicar que não existe produto ali
  • Remover os links de espaços que não possuem produtos (se você clicar sobre o link vao ver que ele está como 'undefined' e o resultado é uma busca no portal pelo termo "portal")

Acho que era isso, pelo menos por enquanto... Mas segue o pensamento, de que nem todos os grandes portais estão livres de bugs :)