Plugin de WordPress

LabelGrid Tools es el plugin oficial de WordPress que sincroniza automaticamente su catalogo 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 catalogo mas reciente.

Disponible en cualquier plan

LabelGrid Tools esta disponible para todas las cuentas de LabelGrid sin costo adicional — no se requiere un plan API. Actualmente es la forma de agregar el pre-save de Spotify a su sitio web en cualquier plan. Esta planeada para el futuro una pagina de pre-save integrada en la aplicacion (sin necesidad de plugin).

Descripcion general

Que puede hacer

Funcion	Descripcion
Sincronizacion automatica del catalogo	Lanzamientos, artistas y download gates se sincronizan desde LabelGrid cada 6 horas
Paginas de lanzamientos	Paginas con artwork y enlaces a mas de 25 plataformas de streaming y tiendas
Perfiles de artistas	Paginas de artistas con biografias, enlaces sociales y discografia
Grillas de lanzamientos	Grillas filtrables de su catalogo por genero, sello o artista
Banners de lanzamientos	Banners para la pagina principal destacando sus lanzamientos mas recientes
Pre-save en Spotify	Botones de pre-save con acciones de seguir playlist y artista
Pre-ordenes	Soporte para pre-ordenes en iTunes, Apple Music, Beatport, Juno y Amazon
Download gates	Gates de captura de email con acciones de seguir en redes sociales (Spotify, Twitter, SoundCloud)
Reproductor web de Spotify	Reproductor de Spotify integrado en paginas de lanzamientos
Notas de prensa	Secciones dedicadas a notas de prensa en paginas de lanzamientos
Enlaces de afiliado de iTunes	Gana comision por compras en iTunes a traves de su sitio
Integracion con Yoast SEO	Metadatos Open Graph para compartir en redes sociales

Requisitos

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

---

Instalacion

Desde el admin de WordPress

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

Instalacion manual

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

---

Configuracion

Obtener su clave de autorizacion

Antes de configurar el plugin, crea una clave de autorizacion en LabelGrid:

1. Inicie sesion en LabelGrid
2. Haga clic en su menu de usuario (su nombre/avatar en la esquina superior derecha)
3. Haga clic en Wordpress en el menu desplegable
4. Haga clic en el boton Configure Plugin
5. En Step 1: Create Key, selecciona que sellos incluir:
   • Elija All My Labels para sincronizar todo su catalogo
   • O selecciona sellos especificos 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 necesitara para WordPress

Precaución

Cada clave esta vinculada a un dominio especifico. Si tiene multiples sitios WordPress, crea una clave separada para cada uno.

Configuracion del plugin

Vaya a Ajustes → LabelGrid Tools en su administrador de WordPress. La pagina de ajustes tiene cuatro pestanas:

Pestana LabelGrid GATE

Ajuste	Descripcion
API Token	Pega el token de acceso que copió de LabelGrid

Pestana General Options

Ajuste	Descripcion
Debug level	Establece la verbosidad del registro para solucion de problemas
Log retention	Cuanto tiempo conservar los registros del sistema
Auto-sync	Activar o desactivar la sincronizacion automatica del catalogo
iTunes Affiliate Token	Su token de afiliado de iTunes para ganar comision por compras

Pestana Releases

Ajuste	Descripcion
Show unreleased	Mostrar lanzamientos proximos en su sitio
Spotify pre-save	Activar botones de pre-save de Spotify en contenido no publicado
Pre-save email collection	No / Si (obligatorio) / Si (opcional) — recopilar emails durante el pre-save
Pre-orders	Activar enlaces de pre-orden para iTunes, Apple Music, Beatport, Juno y Amazon
Spotify Web Player	Mostrar reproductor integrado de Spotify en paginas de lanzamientos
Press release	Mostrar secciones de notas de prensa
Featured artists	Mostrar artistas destacados en paginas de lanzamientos
Similar releases	Mostrar lanzamientos similares
Show below artwork	Elegir que mostrar debajo del artwork: codigo de lanzamiento o sello discografico
Twitter feed on artists	Mostrar feed de Twitter en paginas de artistas

Pestana Download Gate

Ajuste	Descripcion
Press	Ajustes de visibilidad de prensa
Artists visibility	Controlar la visualizacion de artistas en paginas de gates
Button label	Texto personalizado para botones de gates
Welcome title	Titulo mostrado en la pagina de destino del gate
Welcome description	Texto de descripcion para la pagina de destino del gate
Wizard button label	Texto para el boton del asistente del gate

---

Sincronizacion del catalogo

El plugin sincroniza automaticamente su catalogo 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	Descripcion	Estructura de URL
Release	Lanzamientos musicales con artwork, metadatos y enlaces a plataformas	/release/nombre-del-lanzamiento/
Artist	Perfiles de artistas con biografia y enlaces sociales	/artist/nombre-del-artista/
Gate Download	Download gates con captura de email	/free-download/nombre-del-gate/

Los download gates tambien soportan una taxonomia 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 proxima sincronizacion. Realiza todos los cambios del catalogo en LabelGrid.

---

Shortcodes

El plugin proporciona 11 shortcodes organizados en cuatro categorias: lanzamientos, artistas, download gates y pre-save.

Shortcodes de lanzamientos

[labelgrid-release-list]

Muestre sus lanzamientos en una grilla filtrable.

Ejemplo basico:

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

Parametros:

Parametro	Predeterminado	Descripcion
show-title	null	Mostrar titulos de lanzamientos
label	null	Filtrar por sello discografico
items-page	12	Numero de lanzamientos por pagina
items-row	4	Numero de columnas por fila
pagination	null	Activar paginacion
showcase-last	null	Activar modo showcase
item-filter	released	Tipo de filtro: released o unreleased
title-below	null	Posicionar titulo debajo del artwork
filter-artists	null	Filtrar por IDs de artistas
exclude	null	Excluir IDs de lanzamientos especificos
image-quality	lgt_artwork_medium	Preset de tamano de imagen

Mostrar proximos 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 pagina.

Ejemplo basico:

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

Parametros:

Parametro	Predeterminado	Descripcion
record_label	null	Mostrar un filtro desplegable de sello discografico

[labelgrid-release-banner]

Muestre un banner destacando uno o mas lanzamientos — ideal para paginas principales.

Ejemplo basico:

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

Parametros:

Parametro	Predeterminado	Descripcion
label	null	Filtrar por sello discografico
items-page	1	Numero de lanzamientos a mostrar
item-filter	released	Tipo de filtro: released o unreleased
item-order	DESC	Orden: DESC (mas recientes primero) o ASC
filter-artists	null	Filtrar por IDs de artistas
exclude	null	Excluir IDs de lanzamientos especificos

[labelgrid-release-links]

Muestre enlaces de streaming y tiendas para un lanzamiento especifico. Use este shortcode dentro de plantillas de paginas de lanzamientos o en cualquier pagina especificando un ID de lanzamiento.

Ejemplo basico:

[labelgrid-release-links]

Con un lanzamiento especifico:

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

Parametros:

Parametro	Predeterminado	Descripcion
release-id	ID del post actual	El ID del post de lanzamiento
artists	null	Mostrar informacion del artista junto a los enlaces

[labelgrid-release-detail]

Renderiza la pagina 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 diseno de grilla.

Ejemplo basico:

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

Parametros:

Parametro	Predeterminado	Descripcion
show-title	false	Mostrar nombres de artistas debajo de las imagenes
category	null	Filtrar por categoria
items-page	12	Numero de artistas por pagina
items-row	4	Numero de columnas por fila
pagination	null	Activar paginacion
title-below	null	Posicionar titulo debajo de la imagen

[labelgrid-artist-detail]

Renderiza la pagina completa del perfil del artista, incluyendo biografia, enlaces sociales y discografia. 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 boton 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 basico:

[labelgrid-gate-button]

Con texto personalizado:

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

Parametros:

Parametro	Predeterminado	Descripcion
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 boton
custom-class	null	Clase CSS adicional
download-text	null	Texto personalizado del boton de descarga

[labelgrid-gate-download-list]

Muestre sus download gates en un diseno de grilla.

Ejemplo basico:

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

Parametros:

Parametro	Predeterminado	Descripcion
show-title	false	Mostrar titulos de gates
category	null	Filtrar por categoria de gate
items-page	12	Elementos por pagina
items-row	4	Columnas por fila
pagination	null	Activar paginacion
title-below	null	Posicionar titulo debajo de la imagen

[labelgrid-gate-download-detail]

Renderiza la pagina 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 boton de pre-save de Spotify para un lanzamiento proximo. Los visitantes pueden hacer pre-save del lanzamiento y opcionalmente seguir al artista y una playlist en Spotify.

Ejemplo basico:

[labelgrid-presave-button]

Para un lanzamiento especifico:

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

Parametros:

Parametro	Predeterminado	Descripcion
release-id	ID del post actual	El ID del post de lanzamiento

Consejo

Active “Pre-save email collection” en la pestana de ajustes de Releases para recopilar direcciones de email durante el flujo de pre-save.

---

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	Diseno especifico por columna (coincide con el ajuste items-row)
.elementrowx	Variante de diseno flexible
.spotify, .twitter, .youtube, .soundcloud, .facebook	Estilos especificos por servicio en enlaces de plataformas
.banner-*	Elementos de banner de lanzamientos
.gate, .gateimage, .freedownload	Elementos de download gate

Nota

El plugin no incluye bloques Gutenberg, widgets de Elementor ni widgets de barra lateral. Use shortcodes para colocar contenido en sus paginas y plantillas.

---

Solucion de problemas

Los lanzamientos no aparecen

1. Vaya a Ajustes → LabelGrid Tools y verifique que su token API este ingresado correctamente
2. Compruebe que auto-sync este activado en la pestana General Options
3. Espere hasta 6 horas para el proximo ciclo de sincronizacion, o desactiva y reactiva el plugin para activar una sincronizacion inmediata
4. Verifique que los lanzamientos esten publicados en LabelGrid (no en estado borrador)
5. Vaya a Ajustes → LabelGrid Tools → General Options y aumenta el nivel de depuracion, luego revisa 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 tipograficos 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 conexion API

1. Verifique que su token API sea valido y no haya expirado
2. Confirme que su cuenta de LabelGrid este activa
3. Compruebe que su servidor pueda hacer solicitudes salientes a gate.labelgrid.com
4. Revise los registros del plugin para mensajes de error especificos

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 opcion de exportacion.

---

Actualizaciones

Actualizaciones automaticas

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

Actualizaciones manuales

1. Descargue la ultima version desde LabelGrid
2. Vaya a Plugins → Anadir nuevo → Subir plugin
3. Suba el nuevo archivo ZIP
4. WordPress le pedira que reemplaces la version existente
5. Haga clic en Reemplazar actual con subido

---

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.

---

Necesita ayuda?

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