Plugin do WordPress

O LabelGrid Tools é o plugin oficial do WordPress que sincroniza automaticamente o seu catálogo de lançamentos, os perfis de artista e os download gates do LabelGrid para o seu site WordPress. O LabelGrid é a fonte da verdade: o plugin importa seus dados a cada 6 horas, então o seu site reflete sempre o catálogo mais recente.

Disponível em qualquer plano

O LabelGrid Tools está disponível para todas as contas LabelGrid sem custo adicional: não é necessário um plano com API. No momento, é a forma de adicionar o pré-save do Spotify ao seu site em qualquer plano. Uma página de pré-save dentro do próprio app (sem plugin) está planejada para o futuro.

Visão geral

O que você pode fazer

Recurso	Descrição
Sincronização automática do catálogo	Lançamentos, artistas e download gates são sincronizados do LabelGrid a cada 6 horas
Páginas de lançamento	Páginas de destino com capa e links para mais de 25 plataformas de streaming e lojas
Perfis de artista	Páginas de artista com biografia, links sociais e discografia
Grades de lançamentos	Grades filtráveis do seu catálogo por gênero, selo ou artista
Banners de lançamento	Banners na página inicial destacando seus lançamentos mais recentes ou em destaque
Pré-save do Spotify	Botões de pré-save com ações de seguir playlist e artista
Pré-vendas	Suporte a pré-vendas no iTunes, Apple Music, Beatport, Juno e Amazon
Download gates	Gates de captura de e-mail com ações de seguir nas redes sociais (Spotify, Twitter, SoundCloud)
Spotify Web Player	Player do Spotify incorporado nas páginas de lançamento
Press releases	Seções dedicadas a press releases nas páginas de lançamento
Links de afiliado do iTunes	Ganhe comissão sobre compras no iTunes feitas pelo seu site
Integração com Yoast SEO	Metadados Open Graph para compartilhamento nas redes sociais

Requisitos

• WordPress 5.0 ou superior
• PHP 8.0 ou superior
• Uma conta LabelGrid ativa (não é necessário um plano com API)

---

Instalação

Pelo painel do WordPress

1. Vá em Plugins → Add New
2. Pesquise por “LabelGrid Tools”
3. Clique em Install Now
4. Clique em Activate

Instalação manual

1. Baixe o plugin no LabelGrid
2. Vá em Plugins → Add New → Upload Plugin
3. Selecione o arquivo ZIP baixado
4. Clique em Install Now
5. Clique em Activate

---

Configuração

Como obter sua chave de API

Antes de configurar o plugin, crie uma chave de autorização no LabelGrid:

1. Faça login no LabelGrid
2. Clique no seu menu de usuário (seu nome/avatar no canto superior direito)
3. Clique em Wordpress no menu suspenso
4. Clique no botão Configure Plugin
5. Em Step 1: Create Key, selecione quais selos incluir:
   • Escolha All My Labels para sincronizar todo o seu catálogo
   • Ou selecione selos específicos para limitar o que aparece no seu site
6. Clique em Create New Key
7. Informe o domínio do seu site WordPress (ex.: https://seusite.com)
8. Clique em OK para gerar a chave
9. Copie o token de acesso, que você vai precisar no WordPress

Cuidado

Cada chave está vinculada a um domínio específico. Se você tem vários sites WordPress, crie uma chave separada para cada um.

Configurações do plugin

Vá em Settings → LabelGrid Tools no painel do WordPress. A página de configurações tem quatro abas:

Aba LabelGrid GATE

Configuração	Descrição
API Token	Cole o token de acesso que você copiou do LabelGrid

Aba General Options

Configuração	Descrição
Debug level	Defina o nível de detalhe do log para solução de problemas
Log retention	Por quanto tempo manter os logs do sistema
Auto-sync	Habilite ou desabilite a sincronização automática do catálogo
iTunes Affiliate Token	Seu token de afiliado do iTunes para ganhar comissão sobre compras

Aba Releases

Configuração	Descrição
Show unreleased	Exibe os próximos lançamentos no seu site
Spotify pre-save	Habilita os botões de pré-save do Spotify em conteúdo ainda não lançado
Pre-save email collection	No / Yes (obligatory) / Yes (optional): coleta e-mails durante o pré-save
Pre-orders	Habilita links de pré-venda para iTunes, Apple Music, Beatport, Juno e Amazon
Spotify Web Player	Mostra o player do Spotify incorporado nas páginas de lançamento
Press release	Exibe as seções de press release
Featured artists	Mostra os artistas convidados nas páginas de lançamento
Similar releases	Exibe lançamentos semelhantes
Show below artwork	Escolha o que exibir abaixo da capa: código do lançamento ou selo
Twitter feed on artists	Mostra o feed do Twitter nas páginas de artista

Aba Download Gate

Configuração	Descrição
Press	Configurações de visibilidade da imprensa
Artists visibility	Controla a exibição de artistas nas páginas de gate
Button label	Texto personalizado para os botões do gate
Welcome title	Título exibido na página de destino do gate
Welcome description	Texto de descrição da página de destino do gate
Wizard button label	Texto do botão do assistente de gate

---

Sincronização do catálogo

O plugin sincroniza automaticamente o seu catálogo do LabelGrid a cada 6 horas. Isso inclui lançamentos, artistas e download gates.

O plugin cria três tipos de post personalizados no WordPress:

Tipo de post	Descrição	Estrutura da URL
Release	Lançamentos musicais com capa, metadados e links de plataforma	/release/release-name/
Artist	Perfis de artista com biografia e links sociais	/artist/artist-name/
Gate Download	Download gates com captura de e-mail	/free-download/gate-name/

Os download gates também oferecem a taxonomia Gate Category para organizar seus gates em grupos.

Nota

O LabelGrid é a fonte da verdade. As edições que você fizer nos posts de lançamento ou artista no WordPress serão sobrescritas na próxima sincronização. Faça todas as alterações de catálogo no LabelGrid.

---

Shortcodes

O plugin oferece 11 shortcodes organizados em quatro categorias: lançamentos, artistas, download gates e pré-save.

Shortcodes de lançamento

[labelgrid-release-list]

Exibe seus lançamentos em uma grade filtrável.

Exemplo básico:

[labelgrid-release-list items-page="12" items-row="4"]

Parâmetros:

Parâmetro	Padrão	Descrição
show-title	null	Mostra os títulos dos lançamentos
label	null	Filtra por selo
items-page	12	Número de lançamentos por página
items-row	4	Número de colunas por linha
pagination	null	Habilita a paginação
showcase-last	null	Habilita o modo de destaque
item-filter	released	Tipo de filtro: released ou unreleased
title-below	null	Posiciona o título abaixo da capa
filter-artists	null	Filtra por IDs de artista
exclude	null	Exclui IDs de lançamento específicos
image-quality	lgt_artwork_medium	Preset de tamanho de imagem

Mostrar próximos lançamentos:

[labelgrid-release-list item-filter="unreleased" items-row="3"]

[labelgrid-release-list-filter]

Adiciona um filtro suspenso acima da sua grade de lançamentos. Coloque este shortcode antes de [labelgrid-release-list] na mesma página.

Exemplo básico:

[labelgrid-release-list-filter]
[labelgrid-release-list items-page="12"]

Parâmetros:

Parâmetro	Padrão	Descrição
record_label	null	Mostra um filtro suspenso de selo

[labelgrid-release-banner]

Exibe um banner destacando um ou mais lançamentos, ideal para páginas iniciais.

Exemplo básico:

[labelgrid-release-banner items-page="1"]

Parâmetros:

Parâmetro	Padrão	Descrição
label	null	Filtra por selo
items-page	1	Número de lançamentos a exibir
item-filter	released	Tipo de filtro: released ou unreleased
item-order	DESC	Ordem de classificação: DESC (mais recentes primeiro) ou ASC
filter-artists	null	Filtra por IDs de artista
exclude	null	Exclui IDs de lançamento específicos

[labelgrid-release-links]

Mostra os links de streaming e de loja de um lançamento específico. Use dentro dos templates de página de lançamento ou em qualquer página, indicando um ID de lançamento.

Exemplo básico:

[labelgrid-release-links]

Com um lançamento específico:

[labelgrid-release-links release-id="123" artists="true"]

Parâmetros:

Parâmetro	Padrão	Descrição
release-id	ID do post atual	O ID do post do lançamento
artists	null	Mostra as informações de artista junto aos links

[labelgrid-release-detail]

Renderiza a página completa de detalhe do lançamento, incluindo capa, metadados, links de plataforma e player incorporado. Este shortcode usa o post atual e não recebe parâmetros.

Exemplo (em um template de lançamento):

[labelgrid-release-detail]

Shortcodes de artista

[labelgrid-artist-list]

Exibe seus artistas em um layout de grade.

Exemplo básico:

[labelgrid-artist-list items-page="8" items-row="4"]

Parâmetros:

Parâmetro	Padrão	Descrição
show-title	false	Mostra os nomes dos artistas abaixo das imagens
category	null	Filtra por categoria
items-page	12	Número de artistas por página
items-row	4	Número de colunas por linha
pagination	null	Habilita a paginação
title-below	null	Posiciona o título abaixo da imagem

[labelgrid-artist-detail]

Renderiza a página completa de perfil do artista, incluindo biografia, links sociais e discografia. Este shortcode usa o post atual e não recebe parâmetros.

Exemplo (em um template de artista):

[labelgrid-artist-detail]

Shortcodes de download gate

[labelgrid-gate-button]

Exibe um botão de download gate. Ao clicar, o visitante passa pelo fluxo do gate (captura de e-mail e ações opcionais de seguir nas redes sociais) antes de ter acesso ao download.

Exemplo básico:

[labelgrid-gate-button]

Com texto personalizado:

[labelgrid-gate-button gate-id="45" button-label="Get Free Download" custom-class="my-button"]

Parâmetros:

Parâmetro	Padrão	Descrição
gate-id	ID do post atual	O ID do post do gate download
post-id	ID do post atual	O ID do post de lançamento associado
button-label	null	Texto personalizado do botão
custom-class	null	Classe CSS adicional
download-text	null	Texto personalizado do botão de download

[labelgrid-gate-download-list]

Exibe seus download gates em um layout de grade.

Exemplo básico:

[labelgrid-gate-download-list items-page="6" items-row="3"]

Parâmetros:

Parâmetro	Padrão	Descrição
show-title	false	Mostra os títulos dos gates
category	null	Filtra por categoria de gate
items-page	12	Itens por página
items-row	4	Colunas por linha
pagination	null	Habilita a paginação
title-below	null	Posiciona o título abaixo da imagem

[labelgrid-gate-download-detail]

Renderiza a página completa de detalhe do download gate. Este shortcode usa o post atual e não recebe parâmetros.

Exemplo (em um template de gate):

[labelgrid-gate-download-detail]

Shortcode de pré-save

[labelgrid-presave-button]

Exibe um botão de pré-save do Spotify para um lançamento futuro. Os visitantes podem fazer o pré-save do lançamento e, opcionalmente, seguir o artista e uma playlist no Spotify.

Exemplo básico:

[labelgrid-presave-button]

Para um lançamento específico:

[labelgrid-presave-button release-id="123"]

Parâmetros:

Parâmetro	Padrão	Descrição
release-id	ID do post atual	O ID do post do lançamento

Dica

Habilite “Pre-save email collection” na aba de configurações Releases para coletar endereços de e-mail durante o fluxo de pré-save.

---

Referência de classes CSS

O plugin usa estes prefixos de classe CSS para estilização:

Classe	Elemento
.lgsquarelist	Container de grade para listas de lançamentos e artistas
.releaseelement	Card individual de lançamento ou artista
.elementrow1 a .elementrow8	Layout específico por coluna (corresponde à configuração items-row)
.elementrowx	Variante de layout flexível
.spotify, .twitter, .youtube, .soundcloud, .facebook	Estilização específica por serviço nos links de plataforma
.banner-*	Elementos do banner de lançamento
.gate, .gateimage, .freedownload	Elementos do download gate

Nota

O plugin não inclui blocos do Gutenberg, widgets do Elementor nem widgets de barra lateral. Use shortcodes para inserir conteúdo nas suas páginas e templates.

---

Solução de problemas

Os lançamentos não aparecem

1. Vá em Settings → LabelGrid Tools e confira se o seu API token foi inserido corretamente
2. Verifique se a sincronização automática está habilitada na aba General Options
3. Aguarde até 6 horas pelo próximo ciclo de sincronização ou desative e reative o plugin para acionar uma sincronização imediata
4. Confira se os lançamentos estão publicados no LabelGrid (não em status de rascunho)
5. Acesse Settings → LabelGrid Tools → General Options, aumente o debug level e depois consulte os logs

Os shortcodes aparecem como texto puro

1. Confira se o plugin está ativado em Plugins
2. Verifique se você está usando hifens nos nomes dos shortcodes (ex.: [labelgrid-release-list]), e não underscores
3. Confira se há erros de digitação no nome do shortcode

Problemas de estilização

1. Verifique se há conflitos de CSS com o seu tema
2. Use as ferramentas de desenvolvedor do navegador para inspecionar as classes dos elementos
3. Adicione sobreposições de CSS personalizadas mirando os nomes de classe do plugin (consulte a referência de classes CSS acima)
4. Teste com um tema padrão do WordPress para isolar conflitos de tema

Erros de conexão com a API

1. Confira se o seu API token é válido e não expirou
2. Confirme se a sua conta LabelGrid está ativa
3. Verifique se o seu servidor consegue fazer requisições de saída para gate.labelgrid.com
4. Consulte os logs do plugin em busca de mensagens de erro específicas

Entradas e exportações do gate

As entradas dos download gates (endereços de e-mail coletados) podem ser exportadas em CSV pelo painel do WordPress. Acesse o post do gate download e procure a opção de exportação.

---

Atualizações

Atualizações automáticas

1. Vá em Plugins no painel do WordPress
2. Encontre “LabelGrid Tools”
3. Clique em Enable auto-updates

Atualizações manuais

1. Baixe a versão mais recente no LabelGrid
2. Vá em Plugins → Add New → Upload Plugin
3. Envie o novo arquivo ZIP
4. O WordPress vai perguntar se você quer substituir a versão existente
5. Clique em Replace current with uploaded

---

Relacionados

Saiba mais sobre o plugin do WordPress LabelGrid Tools no nosso site: páginas de destino com smart links, campanhas de pré-save do Spotify e downloads com gate.

---

Precisa de ajuda?

Se precisar de ajuda com o plugin do WordPress, fale com nossa equipe de suporte com detalhes sobre a sua versão do WordPress, a versão do PHP e quaisquer mensagens de erro dos logs do plugin.