Plugin do WordPress: como configurar o LabelGrid Tools

Atualizado em setembro de 2026.

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. Ele é um dos dois caminhos para ter a experiência de smart link da LabelGrid: cada lançamento já tem uma landing page hospedada e um link curto no domínio da LabelGrid (consulte Release Landing Pages), e este plugin leva essas mesmas páginas por lançamento (links de lojas, botões de pré-save do Spotify e download gates) para um domínio WordPress com a sua marca, junto com o catálogo inteiro e os perfis de artista.

Visão geral

O que você pode fazer

Você pode colocar qualquer um desses recursos no seu site como shortcode, como bloco nativo do Gutenberg ou pelo Elementor: veja Blocks (Gutenberg) e Elementor.

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 todas as principais 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 no Spotify
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 7.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

Chaves criadas para versões anteriores do plugin não funcionam mais

O LabelGrid não aceita mais chaves de API criadas para versões anteriores do plugin. Se os seus download gates, pré-saves ou a sincronização do catálogo pararam de funcionar, crie uma chave nova com os passos abaixo e cole no plugin. Nada mais precisa mudar: os seus gates e pré-saves continuam com a configuração que já tinham.

Enquanto a chave estiver recusada, a aba Download Gate some das configurações do plugin. O recurso não foi removido: a aba volta assim que você salvar uma chave válida.

Quem faz essa verificação é o LabelGrid, não o plugin, então todas as versões são afetadas. Sites que ainda usam a 1.5.0 ou a 1.6.0 não ficam sem aviso: eles mostram um único banner mais antigo e menos específico, LabelGrid API DISABLED: Verify the API Token is correct and that your account is enabled for LabelGrid API Services., que descreve o mesmo problema. Na seção de solução de problemas você encontra todas as mensagens e o que cada uma quer dizer.

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

Abra LabelGrid Tools → General Settings no painel do WordPress — é um item de menu de primeiro nível, não fica dentro de Settings do WordPress — para chegar a LabelGrid Tools Settings. A página de configurações tem seis abas:

Connection · Release Pages · Artist Pages · Links & Services · Download Gate · System

Download Gate só aparece quando o download gate está ativo. Enquanto o plugin não tiver uma chave de API válida, a aba fica totalmente oculta, então se ela sumiu, veja a seção de solução de problemas mais abaixo.

Connection

Setting	Description
LabelGrid API Token	Cole o token de acesso que você copiou do LabelGrid. Desde a 1.6.1 é um campo de uma linha só, no tamanho das chaves mais curtas que o LabelGrid emite agora
Automatic LabelGrid API Content Sync	Habilite ou desabilite a sincronização automática do catálogo

Release Pages

Setting	Description
Show unreleased releases	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
Spotify Pre-Save - Collect Email	No / Yes (obligatory) / Yes (optional): coleta e-mails durante o pré-save
iTunes / Apple Music / Beatport / Juno / Amazon Music Pre-Order	Habilita links de pré-venda para iTunes, Apple Music, Beatport, Juno e Amazon
Show Spotify Web Player	Mostra o player do Spotify incorporado nas páginas de lançamento
Show press release	Exibe as seções de press release
Show featured artists	Mostra os artistas convidados nas páginas de lançamento
Show similar releases	Exibe lançamentos semelhantes
Field below Artwork	Escolha o que exibir abaixo da capa: código do lançamento ou selo

Artist Pages

Setting	Description
Show Twitter feed	Mostra o feed do Twitter nas páginas de artista
Show Bandsintown feed	Mostrar um feed do Bandsintown nas páginas de artista

Links & Services

Setting	Description
Release services / Artist services	Ordenar e mostrar ou ocultar os links de streaming e lojas nas páginas de lançamento e de artista
Custom Services	Adicionar serviços próprios para exibir nas páginas de lançamento e de artista
Apple Performance Partner Program Token	Seu token de afiliado do iTunes para ganhar comissão sobre compras

Download Gate

Setting	Description
Show press release	Configurações de visibilidade da imprensa
Show featured artists	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
Gate button label	Texto do botão do assistente de gate

System

Setting	Description
Error log level	Defina o nível de detalhe do log para solução de problemas
Log Retention Days	Por quanto tempo manter os logs do sistema
View System Logs	Abrir os logs de sistema salvos
System Information	Dados do ambiente para enviar junto ao falar com o suporte
Uninstall	Apenas informativo, sem botão nem configuração. Explica que excluir o plugin pela tela Plugins remove as configurações, incluindo o token da API, e as tabelas de logs e de inscrições do gate, enquanto seus lançamentos, artistas, download gates e seus campos continuam no banco de dados

---

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. Cada shortcode também tem um bloco do Gutenberg correspondente com as mesmas opções: veja Blocks (Gutenberg).

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 “Spotify Pre-Save - Collect Email” na aba de configurações Release Pages para coletar endereços de e-mail durante o fluxo de pré-save.

---

Ações de gate e pré-save

Um download gate pede que o fã conecte o Spotify e conclua uma ou mais ações antes de liberar o download. Um pré-save sempre salva o lançamento em si e pode somar ações de seguir.

As ações do Spotify disponíveis são:

• Salvar o lançamento: sempre incluído em um pré-save
• Seguir um artista
• Seguir uma playlist
• Seguir um perfil do Spotify: novidade da 1.6.0

Os alvos de seguir não ficam mais restritos aos artistas do seu próprio catálogo, então dá para apontar um gate para um parceiro ou um artista convidado.

As ações de SoundCloud e Twitter estão pausadas

Desde a versão 1.6.0, as ações dos download gates são só do Spotify. As de SoundCloud e Twitter estão pausadas enquanto são refeitas: não rodam mais nem aparecem para os fãs, e o gate continua funcionando com as ações do Spotify.

Se algum gate seu pedia para conectar mais de um serviço, agora o plugin pede só os que continuam disponíveis, senão o gate nunca poderia ser concluído. A sua configuração salva não foi alterada e volta a valer quando os outros serviços retornarem. Revise qualquer gate que antes exigia mais de uma conta e confira se as ações do Spotify que sobraram ainda pedem o que você quer.

Um gate cujas ações eram apenas SoundCloud ou Twitter não tem mais nada a pedir e não funciona de jeito nenhum até você adicionar uma ação do Spotify.

Como os limites de ações são contados

Os gates aceitam muito mais ações do Spotify do que antes, e o editor de gate mostra quantas você já usou enquanto edita.

Cada link conta como uma ação. Uma linha de ação com três links de playlist conta como três, não como uma. É aí que a conta costuma escapar quando um gate chega perto do limite.

Buscar playlists durante um pré-save

Quando um pré-save oferece adicionar o lançamento a uma playlist do fã, ele pode buscar entre as próprias playlists em vez de rolar a lista inteira.

---

Blocks (Gutenberg)

A partir da versão 1.5.0, o LabelGrid Tools traz blocos nativos do editor de blocos para todos os recursos. No editor do WordPress, clique no inseridor de blocos (o botão +) e procure pela categoria LabelGrid Tools, ou pesquise um bloco pelo nome. Defina as opções de cada bloco na barra lateral do bloco: as mesmas opções aceitas pelo shortcode correspondente.

São 11 blocos, um para cada shortcode:

Bloco	Shortcode equivalente	O que faz
LabelGrid Release List	[labelgrid-release-list]	Grade responsiva dos seus lançamentos (colunas, itens por página, selo, paginação, opções de título)
LabelGrid Release List Filter	[labelgrid-release-list-filter]	Filtro por gênero (mais um filtro por selo quando há um selo configurado); combine com uma lista de lançamentos na mesma tela
LabelGrid Release Banner	[labelgrid-release-banner]	Banner em largura total destacando um lançamento, ideal para páginas iniciais
LabelGrid Release Links	[labelgrid-release-links]	Links de streaming e de loja do lançamento atual
LabelGrid Release Detail	[labelgrid-release-detail]	O corpo completo do lançamento; use em um template single de Releases
LabelGrid Artist List	[labelgrid-artist-list]	Grade responsiva dos seus artistas
LabelGrid Artist Detail	[labelgrid-artist-detail]	O corpo completo do artista; use em um template single de Artists
LabelGrid Gate Button	[labelgrid-gate-button]	Botão de download gate; renderiza somente quando a conexão com o LabelGrid está ativa
LabelGrid Gate Download List	[labelgrid-gate-download-list]	Grade de downloads com gate; somente quando a conexão está ativa
LabelGrid Gate Download Detail	[labelgrid-gate-download-detail]	O corpo completo do download com gate; somente quando a conexão está ativa
LabelGrid Presave Button	[labelgrid-presave-button]	Botão de pré-save do Spotify; renderiza somente quando a conexão está ativa e a data de lançamento ainda não passou

Blocos e shortcodes são intercambiáveis

Cada bloco usa o mesmo renderizador do shortcode correspondente, então uma página feita com blocos e uma página feita com shortcodes produzem a mesma saída. Os blocos são puramente aditivos: adicionar um bloco nunca altera uma página onde você não o adicionou, e os seus templates atuais de lançamento e artista continuam iguais quando você atualiza o plugin. Prefere shortcodes? Eles continuam totalmente suportados e funcionam em qualquer tema.

Evite renderizar o detalhe duas vezes

Em um template de item único no Site Editor (temas de blocos), use o bloco Release Detail / Artist Detail ou o bloco Post Content (“Content”) do WordPress, não os dois. Usar os dois renderiza o lançamento ou o artista duas vezes.

Nota

Os blocos Gate Button, Gate Download List, Gate Download Detail e Presave Button só são renderizados em sites conectados a uma conta LabelGrid em um plano ativo.

---

Elementor

Todos os recursos do LabelGrid Tools também estão disponíveis como shortcode, e o widget nativo Shortcode do Elementor — incluído na versão gratuita do Elementor — coloca qualquer recurso em uma página sem nenhum add-on extra. O fluxo com o Theme Builder descrito abaixo é diferente: templates single, condições de exibição e o widget Post Content são recursos do Elementor Pro. Na versão gratuita do Elementor, use um widget Shortcode em qualquer página — e as páginas de lançamento e artista nativas do plugin já renderizam sozinhas, sem nenhum template do Elementor.

Para criar páginas de lançamento e artista com o Theme Builder do Elementor Pro:

1. Crie um template Theme Builder → Single e defina a condição de exibição como Releases (e/ou Artists).
2. Para o corpo do lançamento ou do artista, use um widget Shortcode contendo [labelgrid-release-detail] / [labelgrid-artist-detail] — esse método sempre renderiza o detalhe. O widget Post Content também renderiza o detalhe na maioria das configurações. Use um dos dois, nunca os dois juntos, ou o detalhe é renderizado duas vezes.
3. Adicione grades de lançamentos, banners, listas de artistas, botões de smart link, pré-saves e download gates em qualquer outro ponto do seu layout com o widget Shortcode.

Nota

Os recursos de download gate e pré-save só são renderizados em sites conectados a uma conta LabelGrid em um plano ativo.

---

Usando o template do seu próprio tema para páginas de lançamento e artista

Por padrão, o plugin renderiza as páginas single de lançamento e artista injetando o próprio layout no conteúdo da página, então elas funcionam sem nenhuma alteração no tema. Se você preferir montar essas páginas no seu tema, o plugin pode dar um passo atrás e deixar um template PHP clássico renderizá-las.

Para assumir a renderização em um tema clássico:

1. Adicione add_theme_support( 'labelgrid-tools-templates' ); ao functions.php do seu tema.
2. Adicione um template clássico single-release.php e/ou single-artist.php ao seu tema.

Quando um tema faz o opt-in e fornece o template correspondente, o plugin detecta que o seu template assumiu a renderização e suprime a própria injeção de conteúdo, então a página é renderizada uma única vez a partir do seu template, sem layout duplicado. Coloque o corpo do lançamento ou do artista onde quiser usando os blocos Release Detail / Artist Detail ou os shortcodes [labelgrid-release-detail] / [labelgrid-artist-detail] dentro do seu template.

Você também pode alternar o opt-in por requisição com o filtro lgt_use_theme_templates. Ele recebe o valor atual do opt-in e o post atual, e retorna true ou false, para que você possa habilitar o template do seu tema apenas para alguns lançamentos ou artistas.

Nota

Essa substituição vale apenas para templates PHP clássicos. Assumir as páginas de lançamento e artista a partir do Site Editor de um tema de blocos ainda não é suportado e é uma adição planejada. Sites que não fazem o opt-in não são afetados: o layout nativo é renderizado exatamente como antes.

---

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

Os shortcodes funcionam em qualquer tema e page builder. Os mesmos recursos também estão disponíveis como blocos nativos do Gutenberg e pelo Elementor: veja Blocks (Gutenberg) e Elementor acima.

---

Solução de problemas

Gates, pré-saves e sincronização do catálogo pararam de funcionar

O LabelGrid não aceita mais chaves de API criadas para versões anteriores do plugin. Se os download gates, os pré-saves do Spotify ou a sincronização do catálogo pararam sem que você mudasse nada, quase sempre é por isso.

A solução: crie uma chave nova e cole no plugin. Os passos são os mesmos da primeira vez e estão acima, na seção de configuração. Os seus gates e pré-saves continuam com a configuração que já tinham, então não há nada para refazer.

Como isso aparece:

• Os download gates, os pré-saves e a sincronização do catálogo param de funcionar.
• A aba Download Gate não aparece nas configurações do plugin. O recurso não foi removido: a aba fica oculta enquanto não houver uma chave válida e volta assim que você salvar uma nova.
• A versão 1.6.1 mostra um de três avisos específicos no painel do WordPress. As versões anteriores, incluindo a 1.5.0 e a 1.6.0, mostram apenas um aviso mais antigo e menos específico — LabelGrid API DISABLED: Verify the API Token is correct and that your account is enabled for LabelGrid API Services., com um link Set API in General Settings — mas são afetadas do mesmo jeito, porque a verificação acontece no LabelGrid e não no plugin.

O que os avisos do plugin querem dizer

A versão 1.6.1 mostra uma destas três mensagens. Duas começam com LabelGrid API DISABLED:, então leia a frase inteira antes de agir. As mensagens estão citadas em inglês porque o plugin ainda não as traduz.

A chave precisa ser trocada:

LabelGrid API DISABLED: Your API key was rejected. Keys created for older versions of this plugin are no longer accepted — create a new API key in your LabelGrid account and paste it below.

Crie uma chave nova com os passos da seção de configuração e cole no plugin.

Nenhuma chave foi salva ainda:

LabelGrid API DISABLED: No API key is set, so gates, pre-saves and catalog sync are inactive.

Crie uma chave e cole nas configurações do plugin.

Um problema de conexão passageiro, não um problema de chave:

LabelGrid API UNAVAILABLE: We could not reach LabelGrid to check your connection. This is usually temporary and your key is probably fine — the check runs again automatically.

Para refazer a verificação na hora, em qualquer versão, você precisa mudar alguma coisa. O botão Save Settings fica desativado até que algum ajuste realmente mude, e colar a mesma chave de novo não conta como mudança. Mude qualquer ajuste, salve, volte ao valor anterior e salve outra vez. Log Retention Days, na aba System, serve bem porque não afeta mais nada. Cada vez que você salva, uma nova verificação da conexão é disparada, e o seu site fica exatamente como estava.

A partir da versão 1.6.2, a verificação diária em segundo plano também volta a rodar sozinha sempre que houver uma chave salva, então um site cuja instabilidade ou limite de requisições já passou se recupera sem ninguém mexer nele. Em 1.5.0, 1.6.0 e 1.6.1 isso nunca acontecia: depois que o plugin se desativava, a verificação diária pulava o teste de conexão até alguém salvar as configurações na mão.

Isso vale só para problemas de conexão. Uma chave recusada não se resolve sozinha em nenhuma versão; veja mais acima “A chave precisa ser trocada”. Se o problema continuar, consulte mais abaixo a seção sobre erros de conexão com a API.

Os lançamentos não aparecem

1. Vá em LabelGrid Tools → General Settings — item de menu de primeiro nível, não fica dentro de Settings do WordPress — e confira se o seu API token foi inserido corretamente
2. Verifique se a sincronização automática está habilitada na aba Connection
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 LabelGrid Tools → General Settings → System, 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 api.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

---

Perguntas frequentes

”O que é o plugin LabelGrid Tools para WordPress?”

O LabelGrid Tools é o plugin oficial do LabelGrid para WordPress. Ele sincroniza automaticamente o seu catálogo de lançamentos, os perfis de artista e os download gates do LabelGrid para o seu site WordPress a cada 6 horas, e acrescenta páginas de lançamento com smart link, botões de pré-save do Spotify e downloads com gate. Ele está disponível no Diretório de Plugins do WordPress.

”Preciso de um plano pago ou com API para usar o plugin do WordPress?”

Não. O LabelGrid Tools está disponível para todas as contas LabelGrid sem custo adicional, e não exige um plano com API. Os recursos do Gate que ele oferece estão incluídos em todos os planos padrão e com API, e existe um plano Gate avulso para quem quer só a integração com o WordPress, sem distribuição.

”Como instalo e conecto o plugin?”

No WordPress, vá em Plugins e depois em Add New, instale o LabelGrid Tools e ative-o. No LabelGrid, abra o menu do usuário, vá em Wordpress e depois em Configure Plugin, crie uma chave de autorização para o seu domínio e cole o token de acesso na aba de configurações Connection do plugin. Cada chave vale para um único domínio.

”Com que frequência o plugin sincroniza o meu catálogo?”

O plugin sincroniza os seus lançamentos, artistas e download gates do LabelGrid a cada 6 horas. O LabelGrid é a fonte da verdade, então faça todas as edições de catálogo no LabelGrid: alterações feitas direto nos posts sincronizados do WordPress são sobrescritas na sincronização seguinte.

”Dá para adicionar pré-saves do Spotify ao meu site com o plugin?”

Sim. Ative o pré-save do Spotify na aba de configurações Release Pages e coloque o shortcode [labelgrid-presave-button] em um lançamento futuro. Os visitantes podem fazer o pré-save do lançamento e, se quiserem, seguir o artista e uma playlist, e você pode coletar e-mails durante o fluxo de pré-save.

”Posso usar blocos do Gutenberg ou Elementor, ou só shortcodes?”

Os três. A partir da versão 1.5.0, todos os recursos estão disponíveis como shortcode, como bloco nativo do Gutenberg (encontre-os no inseridor de blocos na categoria LabelGrid Tools) e pelo Elementor, por meio do widget Shortcode. Cada bloco renderiza a mesma saída do shortcode correspondente, e os shortcodes continuam funcionando em qualquer tema.

---

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. Veja também Campanhas de Pré-Save.

---

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.