Instruções

Passo 1: Baixando e Instalando o BlogAmp.

Para utilizar o BlogAmp você precisa ter o Winamp instalado e acesso a um servidor com FTP. Baixe o arquivo da página de downloads e extraia o conteúdo para o diretório de plugins do Winamp, geralmente localizado em C:\Arquivos de Programas\Winamp\Plugins.

OBS: Se após você instalar o BlogAmp, o seu Winamp parar de funcionar, simplesmente apague o arquivo gen_playlist.dll do diretório de plugins. O mesmo serve para desinstalar o BlogAmp.

Passo 2: Configurando o BlogAmp.

Inicie o Winamp e digite Ctrl+P para abrir a janela de preferências.

Na lista da esquerda, selecione a opção Plugins -> General Purpose. Na lista que vai aparecer na direita, dê dois cliques no item BlogAmp v0.24. A caixa de diálogo abaixo vai se abrir.

Em 'Server', digite o seu servidor de FTP

Em 'Port', deixe o padrão, 21, a não ser que o administrador do seu servidor FTP lhe diga o contrário.

Em 'Username', digite o seu login no servidor FTP

Em 'Password', digite sua senha para acessar o FTP

Marque a opção 'Save Password' se você quiser que o BlogAmp armazene a sua senha. Sua senha é criptografada antes de ser gravada.

OBS: Na versão 0.13 ou anterior, a senha não é criptografada! Se você usa uma destas versões, qualquer usuário experiente pode abrir o registro do Windows o obter sua senha. Portanto, se você usa uma destas versões e compartilha o computador com outras pessoas, você pode querer deixar esta opção desmarcada.

Deixe o campo 'Use PASV Mode' marcado, a não ser que esteja tendo problemas para conectar. Neste caso, você pode tentar desmarcar este campo.

Marque o campo 'Disable Plugin' para desabilitar o plugin. Isso pode ser útil quando você quiser ouvir a última música da Britney Spears e não quiser deixar que todo mundo saiba que você gosta! :o)

Em 'Number of Songs In List', digite o número de músicas que você quer que o BlogAmp envie para a lista. Note que a cada nova música que você ouve, a sua lista inteira é retransimitida para o servidor de FTP. Portanto, se você selecionar um número muito grande neste campo, você pode gastar muito tempo (e muita largura de banda) em cada conexão.

Em 'Log File', digite a localização do arquivo de log do BlogAmp, onde são armazenadas as informações com todas as músicas tocadas. Se mais de um usuário utiliza o mesmo computador, você vai querer armazenar o arquivo em um diretório diferente. O padrão é o diretório de plugins do Winamp.

em 'Remote filename', digite o nome do arquivo a ser armazenado no servidor. O padrão é playlist.js, que é um arquivo fonte em JavaScript que contém a lista das últimas músicas ouvidas. Este arquivo é atualizado cada vez que você toca uma música. O nome de arquivo pode conter diretórios, como em blogamp/playlist.js. Note que, como padrão, o arquivo remoto deve estar no mesmo diretório da página que contém a lista. Portanto, se a sua página fica no diretório de FTP blogamp/mp3.html, por exemplo, o arquivo remoto deve ser blogamp/playlist.js.

Preencha o campo 'On exit, wait...' com o número de segundos que você quer que o WinAMP espere até a transferência via FTP da lista terminar, quando você fechar o WinAMP. Você pode tentar diminuir este valor se estiver experimentando problemas quando fecha o Winamp e tenta abrir outra música logo em seguida.

Marque o campo 'Create debug files' se você estiver experimentando problemas ao executar o BlogAMP e eu lhe pedir para fazer isso. Caso contrário, deixe este campo desmarcado uma vez que esta opção cria arquivos que ocupam espaço em disco.

Passo 3: Alterando sua página

Depois de configurar o BlogAmp, você precisa alterar a sua página para mostrar a lista. Você precisa copiar o arquivo display_playlist.js para o servidor. Este arquivo contém o código JavaScript necessário para formatar a lista de músicas na tela. Use o seu cliente de FTP preferido para copiar este arquivo para o servidor. Coloque-o no mesmo diretório onde se encontra a página que vai contar a lista.

Em seguida, abra a sua página em um editor em modo texto (notepad, etc), e insira as seguintes tags entre as tags <head> e </head> do seu arquivo:

Na seção onde você quer inserir a lista, insira o seguinte comando:

Salve o arquivo no seu servidor e pronto!

Assim que você executar o Winamp, o BlogAmp irá enviar a música atual para o servidor. A cada nova música, a lista será automaticamente atualizada.

Você é encorajado a colocar em algum lugar da sua página (embaixo da lista, por exemplo), um link para a homepage do BlogAmp, em http://www.geocities.com/insanitydrops/blogamp/. No entanto, isso não é obrigatório, faça-o apenas se desejar.

OBS: O arquivo display_playlist.js padrão já coloca a frase powered by BlogAmp no fim da lista. Você pode alterar ou remover esta frase, se desejar.

Passo 4 (opcional): Customizando...

O comando DisplaySongs pode receber alguns parâmetros de configuração.

O primeiro parâmetro é o estilo CSS dos nomes das músicas na lista. Você pode colocar aqui qualquer cadeia de caracteres válida na linguagem CSS. Por exemplo, se você especificar o parâmetro
"font-face: Arial; font-size: 8pt; color: blue; text-decoration: underline;",
os nomes das músicas terão uma fonte arial de 8 pontos, serão azuis e sublinhados.

O segundo parâmetro funciona da mesma forma do primeiro, mas especifica o estilo dos detalhes das músicas.

O terceiro parâmetro é opcional e indica se a linha horizontal entre uma música e outra deve aparecer. Se este parâmetro for 1, a linha não é mostrada. Se for 0, a linha é mostrada.

Para lista aí do lado, por exemplo, eu usei o seguinte comando:

DisplaySongs( "font-family: Arial; font-size: 8pt; color: blue; text-decoration: underline","font-family: Arial; font-size: 8pt", 0 );

Passo 5: E além...

Este é apenas um tutorial básico para a utilização do BlogAmp. Eu encorajo os usuários avançados a abrir os arquivos playlist.js e display_playlist.js e entender seu funcionamento.

Se você criar sua nova versão do script display_playlist.js, envie-me e eu colocarei um link nesta página com os devidos créditos.

Visite meu blog em www.geocities.com/insanitydrops/ :o)