O que é a página Top Músicas?
A página Top Músicas permite gerenciar o ranking de músicas exibido no site da rádio. É possível cadastrar músicas de forma manual ou de forma automática através da integração com o iTunes, além de habilitar ou desabilitar o sistema de votação dos ouvintes.
Sistema de Votação
No topo da página, o painel Sistema de Votação permite ligar ou desligar a votação dos ouvintes através de um toggle (chave):
- Ativado: botões 👍 / 👎 aparecem no frontend para os ouvintes votarem nas músicas do ranking.
- Desativado: o ranking é exibido sem opção de voto, mantendo o resultado fixo.
O botão Limpar Votos apaga todos os votos registrados, reiniciando a contagem do ranking.
Modo Manual — Gerenciando o Ranking
A seção Modo Manual exibe um painel de estatísticas com cinco cards: Votos Totais, Votos Hoje, Votantes Únicos, Positivos e Negativos. Abaixo, a tabela lista todas as músicas cadastradas com as colunas: # (posição), Música / Artista (com capa do álbum), Votos (com placar 👍 / 👎), Data e Ações.
Os botões disponíveis na listagem são:
- + Adicionar Música: Abre o formulário para cadastrar uma nova música.
- Atualizar Ranking: Reordena as músicas conforme a quantidade de votos atual.
- Ícone de lápis: Edita os dados de uma música existente.
- Ícone de lixeira: Remove a música do ranking.
Adicionando uma Nova Música
Clique em + Adicionar Música para abrir o formulário de cadastro. Ele possui duas formas de preenchimento: manual ou automática via iTunes.
Cadastro Manual
Na seção Configurações da Música, preencha os campos:
- Nome do artista: Digite o nome do artista ou banda.
- Nome da música: Digite o título da faixa.
- Link do vídeo (YouTube): Cole a URL do vídeo no YouTube (opcional).
- Imagem destacada: Faça upload manual da capa do álbum ou selecione da biblioteca de mídia.
Busca Automática via iTunes
A seção Buscar no iTunes (opcional) permite preencher os dados da música automaticamente. Digite o nome da música ou artista no campo de busca e aguarde os resultados:
Uma lista de resultados será exibida com a capa do álbum, o nome da música e o artista. Cada resultado possui um botão ▶ para pré-ouvir a faixa antes de selecioná-la.
Ao clicar em um resultado, o sistema preenche automaticamente os campos Nome do artista, Nome da música, carrega a capa do álbum como imagem destacada e adiciona uma Prévia (iTunes) — um player de áudio com a prévia da faixa. A mensagem “Dados preenchidos do iTunes!” confirma o preenchimento automático.
Após conferir os dados, clique em Publicar para adicionar a música ao ranking.
Dicas importantes
- Use a busca do iTunes para agilizar o cadastro: nome do artista, título da música e capa do álbum são preenchidos em um único clique.
- Após vários votos, clique em Atualizar Ranking para reordenar as músicas pela votação atual.
- Com o Sistema de Votação desativado, o ranking fica estático — ideal para rankings editoriais definidos manualmente pela equipe.
- Use Limpar Votos para reiniciar a contagem e começar um novo ciclo de votação (por exemplo, mensalmente).
- O campo Link do vídeo (YouTube) permite exibir o clipe oficial da música diretamente no site da rádio.
