Manual de Uso - ZKaraokê
Guia completo para usuários e administradores
Guia do Usuário
O ZKaraokê é um catálogo digital de músicas para karaokê. Este manual explica como buscar, salvar favoritos e participar da comunidade.
Buscar Músicas
A busca é a forma principal de encontrar músicas no catálogo.
1Acesse a página inicial do ZKaraokê
2Use a barra de busca no topo para procurar:
- Por artista: Digite o nome do cantor (ex: "Bruno Mars")
- Por música: Digite o título (ex: "Imagine")
- Por trecho: Digite parte da letra ou tema (ex: "Vem dançar")
- Por código: Se conhecer o código, digite números (ex: "12345")
3Pressione Enter ou clique em para buscar
4Os resultados aparecem em uma tabela com artista, música e código
Dica: A busca ignora acentos e maiúsculas. Digite "joao" para encontrar "João" ou "JOÃO".
Filtrar por Letra
Abaixo da busca, há botões para filtrar por letra do artista (A-Z) ou visualizar todos.
Identificar-se e Salvar Favoritos
Para que seus favoritos sejam salvos mesmo após fechar o navegador, identifique-se com um nome único.
1Clique no botão "Identificar-me" no canto superior direito
2Digite um nome ou apelido único (ex: "Mari2024", "Mesa5", "PedroVoz")
3Clique em "Entrar no catálogo"
Dicas para escolher um nome:
- Use algo memorável e único — se alguém escolher o mesmo nome, assumirá seus favoritos
- Pode ser apelido, nome da mesa, família, etc.
- Evite nomes muito genéricos como "João" ou "Ana" (alguém pode já estar usando)
Gerenciar Favoritos
Salve as músicas que mais ama para acesso rápido.
Adicionar um Favorito
1Encontre a música na busca
2Clique no ícone de estrela ao lado da música
3A estrela ficará preenchida e um aviso aparecerá confirmando
Visualizar Favoritos
1Clique em "Favoritos" no menu superior
2Veja todas as suas músicas salvas em ordem alfabética
3Use a barra de busca para filtrar por artista ou música
Remover um Favorito
1Clique na estrela preenchida da música (em Favoritos ou na busca)
2A música será removida da sua lista de favoritos
Rankings
Veja as estatísticas mais interessantes do catálogo.
As 10 músicas que mais usuários adicionaram aos favoritos.
Os artistas cujas músicas foram mais favoritadas no total.
Os 10 usuários que mais adicionaram músicas aos favoritos. Seu nome aparecerá aqui quando tiver muitos favoritos!
Fatos interessantes sobre o catálogo, como artista com mais músicas, total de pedidos pendentes, e muito mais.
Sugerir uma Música
Não encontrou a música que queria? Sugira-a para ser adicionada ao catálogo!
1Pesquise a música na barra de busca. Se não existir no catálogo, a mensagem "Nenhuma música encontrada para..." aparecerá junto com o botão "Sugerir esta música" — clique nele
2Preencha os dados:
- Artista: Nome do cantor/banda (obrigatório)
- Música: Título da música (obrigatório)
- Seu nome: Como você quer ser identificado (opcional)
Dica: Os administradores reveem os pedidos e adicionam as músicas quando possível. Seus pedidos aparecem no painel de admin!
Instalar como App no seu Celular (PWA)
O ZKaraokê pode ser instalado como um app no seu celular, sem ocupar espaço da Play Store.
iOS (iPhone/iPad)
1Abra o ZKaraokê no Safari
2Clique no ícone de compartilhamento (seta para cima)
3Selecione "Adicionar à Tela de Início"
4Escolha um nome e clique "Adicionar"
Android
1Abra o ZKaraokê no Chrome (recomendado)
2Role até o rodapé da página — aparecerá o botão "Instalar app no celular". Clique nele!
3Confirme clicando em "Instalar" na janela que aparecer
Alternativa (Android): Se o botão não aparecer, clique nos 3 pontos no canto superior do Chrome e escolha "Adicionar à Tela de Início".
Benefícios do App:
- Acesso rápido sem abrir o navegador
- Ícone na tela de início do celular
- Funciona em modo tela cheia
- Acesso offline a alguns recursos (em breve)
Guia do Administrador
Este guia explica como gerenciar o catálogo de músicas, usuários e configurações do ZKaraokê.
Fazer Login no Painel Admin
1Acesse /admin/login.php no seu servidor
Segurança: A senha é criptografada com bcrypt. Após o primeiro login, a senha pode ser alterada no painel de admin.
Gerenciar Músicas
Ver Lista de Músicas
1No painel, clique em "Lista de Músicas"
2Use a barra de busca para filtrar por nome ou artista
3Navigate entre páginas usando os botões de paginação
Adicionar uma Música
1Clique em "Adicionar Música" na barra lateral
2Preencha os campos:
- Artista: Nome do cantor/banda (obrigatório)
- Música: Título da música (obrigatório)
- Início: Trecho/tema da música (opcional)
- Arquivo: Nome do arquivo de vídeo (opcional)
- Código: Deixe em branco para auto-gerar o próximo código
3Clique em "Salvar Música"
Editar uma Música
1Na lista, clique no ícone de edição da música
2Modifique os campos desejados
3Clique em "Atualizar Música"
Deletar uma Música
1Na lista, clique no ícone de lixeira da música
2Confirme a exclusão na janela de confirmação
Atenção: A exclusão é permanente e não pode ser desfeita!
Importar e Exportar BD.ini
Importar um Arquivo BD.ini
O formato BD.ini é o padrão para catálogos de karaokê. Use esta opção para carregar muitas músicas de uma vez.
1Clique em "Importar BD.ini" na barra lateral
2Clique em "Escolher arquivo" e selecione o BD.ini do seu computador
4Se o arquivo já foi importado antes, o sistema avisará. Clique "Forçar Reimportação" para reimportar
Dica: O sistema detecta automaticamente arquivos duplicados pelo hash, evitando importações acidentais repetidas.
Exportar o Banco de Dados como BD.ini
1Clique em "Exportar BD.ini" na barra lateral
2O arquivo será baixado automaticamente para seu computador
3Use esse arquivo como backup ou para compartilhar com outros sistemas
Gerenciar Usuários
Veja informações sobre usuários identificados, edite seus dados e gerencie a lista.
1Clique em "Usuários" na barra lateral
2Veja a lista de usuários com:
- Nome de Acesso: ID único que o usuário usa para entrar
- Nome no Ranking: Nome público exibido nos rankings
- Data de Cadastro: Quando se identificou primeiro
- Último Acesso: Quando acessou por último
- Favoritos: Quantas músicas ele favoritou
3Use a barra de busca para filtrar por nome
4Clique no ícone de edição para alterar o nome de acesso ou o nome no ranking de um usuário
5Clique na lixeira para remover um usuário e todos os seus favoritos
Gerenciar Pedidos de Música
Visualize e processe pedidos de usuários que sugerem novas músicas.
1Clique em "Pedidos" na barra lateral (aparece um badge com o número de pedidos pendentes)
2Veja a tabela de pedidos com:
- Artista e Música: Informações do pedido
- Solicitante: Quem sugeriu (se fornecido)
- Data: Quando o pedido foi feito
3Para adicionar a música ao catálogo:
- Clique em "Adicionar Música"
- Preencha os dados do pedido
- Clique em "Salvar Música"
4Clique na lixeira para remover o pedido (se não quiser adicionar)
Trocar Senha de Admin
Altere sua senha de administrador a qualquer momento.
1Clique em "Trocar Senha" na barra lateral
2Preencha os campos:
- Senha Atual: Sua senha atual (para segurança)
- Nova Senha: Sua nova senha (mínimo 6 caracteres)
- Confirmar Nova Senha: Digite novamente para confirmar
3Clique em "Alterar Senha"
Segurança:
- Use uma senha forte (mínimo 6 caracteres, combinação de letras e números)
- Não compartilhe sua senha com ninguém
- A senha é criptografada com bcrypt
- Se perder a senha, será necessário acesso direto ao servidor para resetar
Boas Práticas de Administração
Exporte o BD.ini regularmente (semanal ou mensal) para ter backups seguros do seu catálogo.
Verifique os pedidos de música frequentemente e adicione as sugestões mais populares para manter os usuários satisfeitos.
Ao adicionar músicas manualmente ou via import, verifique se os dados estão corretos (artista, título, código único).
Periodicamente, você pode remover usuários inativos para manter o banco de dados limpo.