Plugin de WordPress: configuración de LabelGrid Tools

Actualizado en septiembre de 2026.

LabelGrid Tools es el plugin oficial de WordPress que sincroniza automáticamente su catálogo de lanzamientos, perfiles de artistas y download gates desde LabelGrid a su sitio web de WordPress. LabelGrid es la fuente de verdad — el plugin importa sus datos cada 6 horas, para que su sitio web siempre refleje su catálogo más reciente.

Disponible en cualquier plan

LabelGrid Tools está disponible para todas las cuentas de LabelGrid sin costo adicional y no requiere un plan API. Es una de las dos vías para tener la experiencia de smart link de LabelGrid: cada lanzamiento ya cuenta con una landing page alojada y un enlace corto en el dominio de LabelGrid (consulte Landing Pages de Lanzamiento), y este plugin lleva esas mismas páginas por lanzamiento (enlaces a tiendas, botones de pre-save de Spotify y download gates) a su propio dominio WordPress de marca, junto con su catálogo completo y sus perfiles de artista.

Descripción general

Qué puede hacer

Puede colocar cualquiera de estas funciones en su sitio como shortcode, como bloque nativo de Gutenberg o a través de Elementor. Consulte Blocks (Gutenberg) y Elementor.

Función	Descripción
Sincronización automática del catálogo	Lanzamientos, artistas y download gates se sincronizan desde LabelGrid cada 6 horas
Páginas de lanzamientos	Páginas con artwork y enlaces a todas las principales plataformas de streaming y tiendas
Perfiles de artistas	Páginas de artistas con biografías, enlaces sociales y discografía
Grillas de lanzamientos	Grillas filtrables de su catálogo por género, sello o artista
Banners de lanzamientos	Banners para la página principal destacando sus lanzamientos más recientes
Pre-save en Spotify	Botones de pre-save con acciones de seguir playlist y artista
Preventas	Soporte para preventas en iTunes, Apple Music, Beatport, Juno y Amazon
Download gates	Gates de captura de email con acciones de seguimiento en Spotify
Reproductor web de Spotify	Reproductor de Spotify integrado en páginas de lanzamientos
Notas de prensa	Secciones dedicadas a notas de prensa en páginas de lanzamientos
Enlaces de afiliado de iTunes	Gana comisión por compras en iTunes a través de su sitio
Integración con Yoast SEO	Metadatos Open Graph para compartir en redes sociales

Requisitos

• WordPress 7.0 o superior
• PHP 8.0 o superior
• Una cuenta activa de LabelGrid (no se requiere plan API)

---

Instalación

Desde el admin de WordPress

1. Vaya a Plugins → Añadir nuevo
2. Busque “LabelGrid Tools”
3. Haga clic en Instalar ahora
4. Haga clic en Activar

Instalación manual

1. Descargue el plugin desde LabelGrid
2. Vaya a Plugins → Añadir nuevo → Subir plugin
3. Seleccione el archivo ZIP descargado
4. Haga clic en Instalar ahora
5. Haga clic en Activar

---

Configuración

Obtener su clave de autorización

Las claves creadas para versiones anteriores del plugin ya no funcionan

LabelGrid ya no acepta las claves de API creadas para versiones anteriores del plugin. Si sus download gates, sus pre-saves o la sincronización del catálogo han dejado de funcionar, cree una clave nueva con los pasos de más abajo y péguela en el plugin. No hace falta cambiar nada más: sus gates y pre-saves actuales conservan su configuración.

Mientras la clave esté rechazada, la pestaña Download Gate desaparece de los ajustes del plugin. La función no se ha eliminado: la pestaña vuelve a aparecer en cuanto guarde una clave válida.

Esta comprobación la hace LabelGrid, no el plugin, así que afecta a todas las versiones. Los sitios que siguen con la 1.5.0 o la 1.6.0 no se quedan sin aviso: muestran un único banner antiguo y menos preciso, API de LabelGrid DESACTIVADA: Verifica que el token de la API es correcto y que tu cuenta tiene activados los servicios de la API de LabelGrid., que describe el mismo problema. En la sección de solución de problemas encontrará todos los mensajes y qué significa cada uno.

Antes de configurar el plugin, crea una clave de autorización en LabelGrid:

1. Inicie sesión en LabelGrid
2. Haga clic en su menú de usuario (su nombre/avatar en la esquina superior derecha)
3. Haga clic en Wordpress en el menú desplegable
4. Haga clic en el botón Configure Plugin
5. En Step 1: Create Key, selecciona que sellos incluir:
   • Elija All My Labels para sincronizar todo su catálogo
   • O selecciona sellos específicos para limitar lo que aparece en su sitio web
6. Haga clic en Create New Key
7. Ingrese el dominio de su sitio WordPress (ej., https://tusitio.com)
8. Haga clic en OK para generar la clave
9. Copie el token de acceso — lo necesitará para WordPress

Precaución

Cada clave está vinculada a un dominio específico. Si tiene múltiples sitios WordPress, crea una clave separada para cada uno.

Configuración del plugin

Abra LabelGrid Tools → Ajustes generales (General Settings) en su administrador de WordPress: es una entrada de menú de primer nivel, no está dentro de Ajustes de WordPress. Así llega a Ajustes de LabelGrid Tools. La página tiene seis pestañas, aquí con el original en inglés entre paréntesis:

Conexión (Connection) · Páginas de lanzamiento (Release Pages) · Páginas de artista (Artist Pages) · Enlaces y servicios (Links & Services) · Download Gate · Sistema (System)

Download Gate solo aparece cuando el download gate está activo. Mientras el plugin no tenga una clave de API válida, la pestaña queda oculta por completo, así que si no la ve, consulte la sección de solución de problemas más abajo.

Conexión

Setting	Description
Token de la API de LabelGrid	Pega el token de acceso que copió de LabelGrid. Desde la 1.6.1 es un campo de una sola línea, acorde con las claves más cortas que LabelGrid emite ahora
Sincronización automática de contenido con la API de LabelGrid	Activar o desactivar la sincronización automática del catálogo

Páginas de lanzamiento

Setting	Description
Mostrar lanzamientos no publicados	Mostrar lanzamientos próximos en su sitio
Pre-Save de Spotify	Activar botones de pre-save de Spotify en contenido no publicado
Pre-Save de Spotify - Recopilar correo electrónico	No / Si (obligatorio) / Si (opcional) — recopilar emails durante el pre-save
Pre-Order de iTunes / Apple Music / Beatport / Juno / Amazon Music	Activar enlaces de pre-orden para iTunes, Apple Music, Beatport, Juno y Amazon
Mostrar el reproductor web de Spotify	Mostrar reproductor integrado de Spotify en páginas de lanzamientos
Mostrar nota de prensa	Mostrar secciones de notas de prensa
Mostrar artistas destacados	Mostrar artistas destacados en páginas de lanzamientos
Mostrar lanzamientos similares	Mostrar lanzamientos similares
Campo debajo de la portada	Elegir que mostrar debajo del artwork: código de lanzamiento o sello discográfico

Páginas de artista

Setting	Description
Mostrar el feed de Twitter	Mostrar feed de Twitter en páginas de artistas
Mostrar el feed de Bandsintown	Mostrar un feed de Bandsintown en las páginas de artista

Enlaces y servicios

Setting	Description
Servicios de LANZAMIENTOS / Servicios de ARTISTAS	Ordenar y mostrar u ocultar los enlaces de streaming y tiendas en las páginas de lanzamiento y de artista
Servicios personalizados	Añadir sus propios servicios para mostrarlos en las páginas de lanzamiento y de artista
Token del Apple Performance Partner Program	Su token de afiliado de iTunes para ganar comisión por compras

Download Gate

Setting	Description
Mostrar nota de prensa	Ajustes de visibilidad de prensa
Mostrar artistas destacados	Controlar la visualización de artistas en páginas de gates
Texto del botón	Texto personalizado para botones de gates
Título de bienvenida	Título mostrado en la página de destino del gate
Descripción de bienvenida	Texto de descripción para la página de destino del gate
Texto del botón del Gate	Texto para el botón del asistente del gate

Sistema

Setting	Description
Activar el registro de errores	Establece la verbosidad del registro para solución de problemas
Días de retención de los registros	Cuanto tiempo conservar los registros del sistema
Ver los registros del sistema	Abrir los registros del sistema guardados
Información del sistema	Datos del entorno que conviene adjuntar al contactar con soporte
Desinstalar	Solo información, sin botón ni ajuste. Explica que al eliminar el plugin desde la pantalla Plugins se borran sus ajustes, incluido el token de la API, y sus tablas de registros y de entradas del gate, mientras que sus lanzamientos, artistas, download gates y sus campos siguen en la base de datos

---

Sincronización del catálogo

El plugin sincroniza automáticamente su catálogo desde LabelGrid cada 6 horas. Esto incluye lanzamientos, artistas y download gates.

El plugin crea tres tipos de contenido personalizados en WordPress:

Tipo de contenido	Descripción	Estructura de URL
Release	Lanzamientos musicales con artwork, metadatos y enlaces a plataformas	/release/nombre-del-lanzamiento/
Artist	Perfiles de artistas con biografía y enlaces sociales	/artist/nombre-del-artista/
Gate Download	Download gates con captura de email	/free-download/nombre-del-gate/

Los download gates también soportan una taxonomía Gate Category para organizar sus gates en grupos.

Nota

LabelGrid es la fuente de verdad. Los cambios que haga en los posts de lanzamientos o artistas en WordPress se sobrescribiran en la próxima sincronización. Realiza todos los cambios del catálogo en LabelGrid.

---

Shortcodes

El plugin proporciona 11 shortcodes organizados en cuatro categorías: lanzamientos, artistas, download gates y pre-save. Cada shortcode también tiene un bloque de Gutenberg equivalente con las mismas opciones; consulte Blocks (Gutenberg).

Shortcodes de lanzamientos

[labelgrid-release-list]

Muestre sus lanzamientos en una grilla filtrable.

Ejemplo básico:

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

Parametros:

Parámetro	Predeterminado	Descripción
show-title	null	Mostrar títulos de lanzamientos
label	null	Filtrar por sello discográfico
items-page	12	Número de lanzamientos por página
items-row	4	Número de columnas por fila
pagination	null	Activar paginación
showcase-last	null	Activar modo showcase
item-filter	released	Tipo de filtro: released o unreleased
title-below	null	Posicionar título debajo del artwork
filter-artists	null	Filtrar por IDs de artistas
exclude	null	Excluir IDs de lanzamientos específicos
image-quality	lgt_artwork_medium	Preset de tamaño de imagen

Mostrar próximos lanzamientos:

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

[labelgrid-release-list-filter]

Agregue un filtro desplegable sobre su grilla de lanzamientos. Coloca este shortcode antes de [labelgrid-release-list] en la misma página.

Ejemplo básico:

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

Parametros:

Parámetro	Predeterminado	Descripción
record_label	null	Mostrar un filtro desplegable de sello discográfico

[labelgrid-release-banner]

Muestre un banner destacando uno o más lanzamientos — ideal para páginas principales.

Ejemplo básico:

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

Parametros:

Parámetro	Predeterminado	Descripción
label	null	Filtrar por sello discográfico
items-page	1	Número de lanzamientos a mostrar
item-filter	released	Tipo de filtro: released o unreleased
item-order	DESC	Orden: DESC (más recientes primero) o ASC
filter-artists	null	Filtrar por IDs de artistas
exclude	null	Excluir IDs de lanzamientos específicos

[labelgrid-release-links]

Muestre enlaces de streaming y tiendas para un lanzamiento específico. Use este shortcode dentro de plantillas de páginas de lanzamientos o en cualquier página especificando un ID de lanzamiento.

Ejemplo básico:

[labelgrid-release-links]

Con un lanzamiento específico:

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

Parametros:

Parámetro	Predeterminado	Descripción
release-id	ID del post actual	El ID del post de lanzamiento
artists	null	Mostrar información del artista junto a los enlaces

[labelgrid-release-detail]

Renderiza la página completa de detalle del lanzamiento, incluyendo artwork, metadatos, enlaces a plataformas y reproductor integrado. Este shortcode usa el post actual y no acepta parametros.

Ejemplo (en una plantilla de lanzamiento):

[labelgrid-release-detail]

Shortcodes de artistas

[labelgrid-artist-list]

Muestre sus artistas en un diseño de grilla.

Ejemplo básico:

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

Parametros:

Parámetro	Predeterminado	Descripción
show-title	false	Mostrar nombres de artistas debajo de las imágenes
category	null	Filtrar por categoría
items-page	12	Número de artistas por página
items-row	4	Número de columnas por fila
pagination	null	Activar paginación
title-below	null	Posicionar título debajo de la imagen

[labelgrid-artist-detail]

Renderiza la página completa del perfil del artista, incluyendo biografía, enlaces sociales y discografía. Este shortcode usa el post actual y no acepta parametros.

Ejemplo (en una plantilla de artista):

[labelgrid-artist-detail]

Shortcodes de download gates

[labelgrid-gate-button]

Muestre un botón de download gate. Cuando se hace clic, el visitante pasa por el flujo del gate (captura de email y seguimiento opcional en redes sociales) antes de obtener acceso a la descarga.

Ejemplo básico:

[labelgrid-gate-button]

Con texto personalizado:

[labelgrid-gate-button gate-id="45" button-label="Obtener Descarga Gratis" custom-class="mi-boton"]

Parametros:

Parámetro	Predeterminado	Descripción
gate-id	ID del post actual	El ID del post de download gate
post-id	ID del post actual	ID del post de lanzamiento asociado
button-label	null	Texto personalizado del botón
custom-class	null	Clase CSS adicional
download-text	null	Texto personalizado del botón de descarga

[labelgrid-gate-download-list]

Muestre sus download gates en un diseño de grilla.

Ejemplo básico:

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

Parametros:

Parámetro	Predeterminado	Descripción
show-title	false	Mostrar títulos de gates
category	null	Filtrar por categoría de gate
items-page	12	Elementos por página
items-row	4	Columnas por fila
pagination	null	Activar paginación
title-below	null	Posicionar título debajo de la imagen

[labelgrid-gate-download-detail]

Renderiza la página completa de detalle del download gate. Este shortcode usa el post actual y no acepta parametros.

Ejemplo (en una plantilla de gate):

[labelgrid-gate-download-detail]

Shortcode de pre-save

[labelgrid-presave-button]

Muestre un botón de pre-save de Spotify para un lanzamiento próximo. Los visitantes pueden hacer pre-save del lanzamiento y opcionalmente seguir al artista y una playlist en Spotify.

Ejemplo básico:

[labelgrid-presave-button]

Para un lanzamiento específico:

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

Parametros:

Parámetro	Predeterminado	Descripción
release-id	ID del post actual	El ID del post de lanzamiento

Consejo

Active “Spotify Pre-Save - Collect Email” en la pestaña de ajustes de Release Pages para recopilar direcciones de email durante el flujo de pre-save.

---

Acciones de gate y pre-save

Un download gate pide a los fans que conecten Spotify y completen una o varias acciones antes de desbloquear la descarga. Un pre-save siempre guarda el lanzamiento y, además, puede añadir acciones de seguimiento.

Las acciones de Spotify disponibles son:

• Guardar el lanzamiento: siempre incluido en un pre-save
• Seguir a un artista
• Seguir una playlist
• Seguir un perfil de Spotify: novedad de la 1.6.0

Los objetivos de seguimiento ya no se limitan a los artistas de su propio catálogo, así que puede dirigir un gate a un colaborador o a un artista invitado.

Las acciones de SoundCloud y Twitter están en pausa

Desde la versión 1.6.0, las acciones de los download gates son solo de Spotify. Las de SoundCloud y Twitter están en pausa mientras se reconstruyen: ya no se ejecutan ni se muestran a los fans, y el gate sigue funcionando con sus acciones de Spotify.

Si alguno de sus gates pedía conectar más de un servicio, el plugin ahora solo pide los que siguen disponibles, porque de lo contrario el gate nunca podría completarse. Su ajuste guardado no se toca y vuelve a aplicarse cuando los demás servicios regresen. Revise cualquier gate que antes exigiera más de una cuenta y compruebe que las acciones de Spotify que quedan siguen pidiendo lo que usted quiere.

Un gate cuyas acciones eran solo de SoundCloud o Twitter ya no tiene nada que pedir y no funciona en absoluto hasta que le añada una acción de Spotify.

Cómo se cuentan los límites de acciones

Los gates admiten muchas más acciones de Spotify que antes, y el editor de gates muestra cuántas lleva usadas mientras edita.

Cada enlace cuenta como una acción. Una fila de acción con tres enlaces de playlist cuenta como tres, no como una. Ahí es donde suele fallar el cálculo cuando un gate se acerca al límite.

Buscar playlists durante un pre-save

Cuando un pre-save ofrece añadir el lanzamiento a una playlist del fan, este puede buscar entre sus playlists en lugar de recorrer toda la lista.

---

Blocks (Gutenberg)

Desde la versión 1.5.0, LabelGrid Tools incluye bloques nativos del editor de bloques para cada función. En el editor de WordPress, haga clic en el insertador de bloques (el botón +) y busque la categoría LabelGrid Tools, o busque un bloque por su nombre. Configure las opciones de cada bloque en la barra lateral del bloque: son las mismas opciones que acepta su shortcode equivalente.

Hay 11 bloques, uno por cada shortcode:

Bloque	Shortcode equivalente	Qué hace
LabelGrid Release List	[labelgrid-release-list]	Cuadrícula responsiva de sus lanzamientos (columnas, elementos por página, sello, paginación, opciones de título)
LabelGrid Release List Filter	[labelgrid-release-list-filter]	Filtro de género (más un filtro de sello cuando hay un sello configurado); combínelo con una lista de lanzamientos en la misma vista
LabelGrid Release Banner	[labelgrid-release-banner]	Banner a todo el ancho que destaca un lanzamiento, ideal para páginas de inicio
LabelGrid Release Links	[labelgrid-release-links]	Enlaces de streaming y tiendas del lanzamiento actual
LabelGrid Release Detail	[labelgrid-release-detail]	El cuerpo completo del lanzamiento; úselo en una plantilla individual de lanzamientos
LabelGrid Artist List	[labelgrid-artist-list]	Cuadrícula responsiva de sus artistas
LabelGrid Artist Detail	[labelgrid-artist-detail]	El cuerpo completo del artista; úselo en una plantilla individual de artistas
LabelGrid Gate Button	[labelgrid-gate-button]	Botón de download gate; se muestra solo cuando la conexión con LabelGrid está activa
LabelGrid Gate Download List	[labelgrid-gate-download-list]	Cuadrícula de descargas con gate; solo cuando la conexión está activa
LabelGrid Gate Download Detail	[labelgrid-gate-download-detail]	El cuerpo completo de una descarga con gate; solo cuando la conexión está activa
LabelGrid Presave Button	[labelgrid-presave-button]	Botón de pre-save de Spotify; se muestra solo cuando la conexión está activa y no ha pasado la fecha del lanzamiento

Los bloques y los shortcodes son intercambiables

Cada bloque usa el mismo renderizador que su shortcode equivalente, de modo que una página creada con bloques y una creada con shortcodes producen un resultado idéntico. Los bloques son puramente aditivos: añadir un bloque nunca cambia una página en la que no lo haya insertado, y sus plantillas de lanzamientos y artistas no se modifican al actualizar el plugin. ¿Prefiere los shortcodes? Siguen siendo totalmente compatibles y funcionan en cualquier tema.

Evite mostrar el detalle dos veces

En una plantilla individual del editor del sitio (temas de bloques), use o bien el bloque Release Detail / Artist Detail o bien el bloque Post Content (“Content”) de WordPress, no ambos. Si usa los dos, el detalle del lanzamiento o del artista se muestra dos veces.

Nota

Los bloques Gate Button, Gate Download List, Gate Download Detail y Presave Button se muestran solo en sitios conectados a una cuenta de LabelGrid con un plan activo.

---

Elementor

Todas las funciones de LabelGrid Tools también están disponibles como shortcode, y el widget Shortcode integrado de Elementor —parte de la versión gratuita de Elementor— coloca cualquiera de ellas en una página sin ningún complemento adicional. La receta con Theme Builder que se describe a continuación es distinta: las plantillas Single, las condiciones de visualización y el widget Post Content son funciones de Elementor Pro. Con la versión gratuita de Elementor, use en su lugar un widget Shortcode en cualquier página; además, las páginas de lanzamientos y artistas integradas del plugin ya se muestran por sí solas, sin ninguna plantilla de Elementor.

Para crear páginas de lanzamientos y artistas con el Theme Builder de Elementor Pro:

1. Cree una plantilla en Theme Builder → Single y establezca su condición de visualización en Releases (o Artists).
2. Para el cuerpo del lanzamiento o del artista, use un widget Shortcode con [labelgrid-release-detail] / [labelgrid-artist-detail]: esta opción siempre muestra el detalle. El widget Post Content también lo muestra en la mayoría de las configuraciones. Use uno, nunca ambos, o el detalle se mostrará dos veces.
3. Añada cuadrículas de lanzamientos, banners, listas de artistas, botones de smart link, pre-saves y download gates en cualquier otro lugar de su diseño con el widget Shortcode.

Nota

Las funciones de download gate y pre-save se muestran solo en sitios conectados a una cuenta de LabelGrid con un plan activo.

---

Usar su propia plantilla de tema para páginas de lanzamientos y artistas

De forma predeterminada, el plugin muestra las páginas individuales de lanzamientos y artistas inyectando su propio diseño en el contenido de la página, de modo que funcionan sin ningún cambio en el tema. Si prefiere construir estas páginas en su tema, el plugin puede apartarse y dejar que una plantilla PHP clásica las muestre.

Para asumir el renderizado en un tema clásico:

1. Añada add_theme_support( 'labelgrid-tools-templates' ); al archivo functions.php de su tema.
2. Añada una plantilla clásica single-release.php o single-artist.php a su tema.

Cuando un tema tanto lo habilita como proporciona la plantilla correspondiente, el plugin detecta que su plantilla ha tomado el control y suprime su propia inyección de contenido, de modo que la página se muestra una sola vez desde su plantilla, sin diseño duplicado. Coloque el cuerpo del lanzamiento o del artista donde quiera con los bloques Release Detail / Artist Detail o los shortcodes [labelgrid-release-detail] / [labelgrid-artist-detail] dentro de su plantilla.

También puede alternar la habilitación por solicitud con el filtro lgt_use_theme_templates. Recibe el valor de habilitación actual y el post actual y devuelve true o false, de modo que puede activar su plantilla de tema solo para algunos lanzamientos o artistas.

Nota

Esta sustitución se aplica solo a plantillas PHP clásicas. Asumir las páginas de lanzamientos y artistas desde el editor del sitio de un tema de bloques todavía no está cubierto y es una incorporación prevista. Los sitios que no lo habilitan no se ven afectados: el diseño integrado se muestra exactamente como antes.

---

Referencia de clases CSS

El plugin usa estos prefijos de clases CSS para estilos:

Clase	Elemento
.lgsquarelist	Contenedor de grilla para listas de lanzamientos y artistas
.releaseelement	Tarjeta individual de lanzamiento o artista
.elementrow1 a .elementrow8	Diseño específico por columna (coincide con el ajuste items-row)
.elementrowx	Variante de diseño flexible
.spotify, .twitter, .youtube, .soundcloud, .facebook	Estilos específicos por servicio en enlaces de plataformas
.banner-*	Elementos de banner de lanzamientos
.gate, .gateimage, .freedownload	Elementos de download gate

Nota

Los shortcodes funcionan en cualquier tema y maquetador de páginas. Las mismas funciones también están disponibles como bloques nativos de Gutenberg y a través de Elementor; consulte Blocks (Gutenberg) y Elementor más arriba.

---

Solución de problemas

Los gates, los pre-saves y la sincronización del catálogo dejaron de funcionar

LabelGrid ya no acepta las claves de API creadas para versiones anteriores del plugin. Si los download gates, los pre-saves de Spotify o la sincronización del catálogo dejaron de funcionar sin que usted cambiara nada, casi siempre es por esto.

La solución: cree una clave nueva y péguela en el plugin. Los pasos son los mismos que la primera vez y están más arriba, en la sección de configuración. Sus gates y pre-saves actuales conservan su configuración, así que no hay nada que rehacer.

Cómo se manifiesta:

• Los download gates, los pre-saves y la sincronización del catálogo dejan de funcionar.
• La pestaña Download Gate no aparece en los ajustes del plugin. La función no se ha eliminado: la pestaña queda oculta mientras no haya una clave válida y vuelve en cuanto guarde una nueva.
• La versión 1.6.1 muestra uno de tres avisos concretos en el administrador de WordPress. Las versiones anteriores, incluidas la 1.5.0 y la 1.6.0, muestran en su lugar uno solo, más antiguo y menos preciso — API de LabelGrid DESACTIVADA: Verifica que el token de la API es correcto y que tu cuenta tiene activados los servicios de la API de LabelGrid., con un enlace Configurar la API en Ajustes generales —, pero están afectadas igual, porque la comprobación ocurre en LabelGrid y no en el plugin.

Qué significan los avisos del plugin

La versión 1.6.1 muestra uno de estos tres mensajes. Dos empiezan por API de LabelGrid DESACTIVADA:, así que lea la frase entera antes de actuar. Esa primera parte aparece traducida al español; la frase que la sigue se muestra por ahora en inglés, y por eso está citada aquí en inglés.

Hay que sustituir la clave:

API de LabelGrid DESACTIVADA: 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.

Cree una clave nueva con los pasos de la sección de configuración y péguela en el plugin.

Todavía no se ha guardado ninguna clave:

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

Cree una clave y péguela en los ajustes del plugin.

Un problema de conexión pasajero, no un problema de clave:

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 forzar una comprobación inmediata en cualquier versión, tiene que cambiar algo. El botón Guardar ajustes permanece atenuado hasta que un ajuste cambia de verdad, y volver a pegar la misma clave no cuenta como cambio. Cambie cualquier ajuste, guarde, devuélvalo a su valor anterior y guarde otra vez. Días de retención de los registros, en la pestaña Sistema, es una buena opción porque no afecta a nada más. Cada vez que guarda se ejecuta una nueva comprobación de la conexión, y su sitio queda exactamente como estaba.

A partir de la versión 1.6.2, la comprobación diaria en segundo plano también vuelve a ejecutarse sola siempre que haya una clave guardada, de modo que un sitio cuya caída o limitación de peticiones ya ha pasado se recupera sin que nadie tenga que tocarlo. En 1.5.0, 1.6.0 y 1.6.1 nunca fue así: cuando el plugin se había desactivado solo, la comprobación diaria se saltaba la prueba de conexión hasta que alguien guardaba los ajustes a mano.

Esto vale solo para los problemas de conexión. Una clave rechazada no se arregla sola en ninguna versión; consulte más arriba «Hay que sustituir la clave». Si el problema continúa, consulte más abajo la sección sobre errores de conexión con la API.

Los lanzamientos no aparecen

1. Vaya a LabelGrid Tools → Ajustes generales (General Settings), una entrada de menú de primer nivel y no dentro de Ajustes de WordPress, y verifique que su token de API esté introducido correctamente
2. Compruebe que auto-sync este activado en la pestaña Connection
3. Espere hasta 6 horas para el próximo ciclo de sincronización, o desactiva y reactiva el plugin para activar una sincronización inmediata
4. Verifique que los lanzamientos estén publicados en LabelGrid (no en estado borrador)
5. Vaya a LabelGrid Tools → Ajustes generales → Sistema y aumente el nivel de depuración, luego revise los registros

Los shortcodes aparecen como texto plano

1. Asegúrese de que el plugin este activado en Plugins
2. Verifique que este usando guiones en los nombres de shortcodes (ej., [labelgrid-release-list]), no guiones bajos
3. Revise si hay errores tipográficos en el nombre del shortcode

Problemas de estilo

1. Verifique conflictos de CSS con su tema
2. Use las herramientas de desarrollador de su navegador para inspeccionar las clases de elementos
3. Agregue sobreescrituras de CSS personalizadas apuntando a los nombres de clases del plugin (ver la referencia de clases CSS arriba)
4. Pruebe con un tema predeterminado de WordPress para aislar conflictos del tema

Errores de conexión API

1. Verifique que su token API sea válido y no haya expirado
2. Confirme que su cuenta de LabelGrid esté activa
3. Compruebe que su servidor pueda hacer solicitudes salientes a api.labelgrid.com
4. Revise los registros del plugin para mensajes de error específicos

Entradas de gates y exportaciones

Las entradas de download gates (direcciones de email recopiladas) se pueden exportar como CSV desde el admin de WordPress. Vaya al post del download gate y busca la opción de exportación.

---

Actualizaciones

Actualizaciones automáticas

1. Vaya a Plugins en su administrador de WordPress
2. Encuentre “LabelGrid Tools”
3. Haga clic en Activar actualizaciones automáticas

Actualizaciones manuales

1. Descargue la última versión desde LabelGrid
2. Vaya a Plugins → Añadir nuevo → Subir plugin
3. Suba el nuevo archivo ZIP
4. WordPress le pedirá que reemplaces la versión existente
5. Haga clic en Reemplazar actual con subido

---

Preguntas frecuentes

”¿Qué es el plugin de WordPress LabelGrid Tools?”

LabelGrid Tools es el plugin oficial de WordPress de LabelGrid. Sincroniza automáticamente su catálogo de lanzamientos, sus perfiles de artista y sus download gates desde LabelGrid a su sitio de WordPress cada 6 horas, y añade páginas de lanzamiento tipo smart link, botones de pre-save de Spotify y descargas con registro. Está disponible en el directorio de plugins de WordPress.

”¿Necesito un plan de pago o un plan API para usar el plugin de WordPress?”

No. LabelGrid Tools está disponible para todas las cuentas de LabelGrid sin coste adicional y no requiere un plan API. Las funciones de Gate que ofrece están incluidas en todos los planes estándar y API, y existe un plan Gate independiente para quienes solo quieren la integración con WordPress, sin distribución.

”¿Cómo instalo y conectó el plugin?”

Instale LabelGrid Tools desde Plugins > Añadir nuevo en WordPress y actívelo. En LabelGrid, abra su menú de usuario > Wordpress > Configurar plugin, cree una clave de autorización para su dominio y pegue el token de acceso en la pestaña de ajustes Connection del plugin. Cada clave queda vinculada a un único dominio.

”¿Con qué frecuencia sincroniza el plugin mi catálogo?”

El plugin sincroniza sus lanzamientos, artistas y download gates desde LabelGrid cada 6 horas. LabelGrid es la fuente de verdad, así que haga todas las ediciones del catálogo en LabelGrid: los cambios hechos directamente en las entradas sincronizadas de WordPress se sobrescriben en la siguiente sincronización.

”¿Puedo añadir pre-saves de Spotify a mi sitio con el plugin?”

Sí. Active el pre-save de Spotify en la pestaña de ajustes Release Pages y coloque el shortcode [labelgrid-presave-button] en un lanzamiento próximo. Los visitantes pueden hacer el pre-save del lanzamiento y, de forma opcional, seguir al artista y a una playlist, y usted puede recopilar sus correos durante el proceso de pre-save.

”¿Puedo usar bloques de Gutenberg o Elementor, o solo shortcodes?”

Las tres opciones. Desde la versión 1.5.0, cada función está disponible como shortcode, como bloque nativo de Gutenberg (los encontrará en el insertador de bloques, bajo la categoría LabelGrid Tools) y a través de Elementor mediante su widget Shortcode. Cada bloque genera el mismo resultado que su shortcode equivalente, y los shortcodes siguen funcionando en cualquier tema.

---

Relacionado

Obtenga más información sobre el plugin de WordPress LabelGrid Tools —páginas smart-link, campañas de pre-save de Spotify y descargas con registro— en nuestro sitio web. Consulte también Campañas de Pre-Save.

---

¿Necesita ayuda?

Si necesita asistencia con el plugin de WordPress, contacte a nuestro equipo de soporte con detalles sobre su versión de WordPress, versión de PHP y cualquier mensaje de error de los registros del plugin.