Manual de shortcodes — SDS Content

1. Introducción

SDS Content 1.5.1 registra cinco shortcodes públicos:

[sds_artistas]
[sds_featured_release]
[sds_lanzamientos]
[sds_catalogo]
[sds_discografia_artista]

Cada uno representa una vista distinta del contenido SDS:

Shortcode	Función principal
`[sds_artistas]`	Listado o roster de artistas
`[sds_featured_release]`	Muestra un único lanzamiento destacado o seleccionado
`[sds_lanzamientos]`	Muestra novedades/lanzamientos recientes
`[sds_catalogo]`	Catálogo paginado y filtrable de lanzamientos
`[sds_discografia_artista]`	Discografía de un artista concreto

El plugin trabaja con estos tipos de contenido:

sds_artistasds_lanzamiento

Y estas taxonomías:

sds_tipo_artistasds_tipo_lanzamientosds_genero

Los shortcodes heredan sus valores predeterminados de:

WordPress → Ajustes → SDS Content

Cuando un atributo se especifica directamente en el shortcode, normalmente prevalece sobre el valor configurado globalmente.

2. Requisitos de funcionamiento

El plugin espera que el theme proporcione Bootstrap 5.3.

SDS Content no carga Bootstrap por sí mismo.

También necesita que el theme ejecute correctamente:

wp_footer();

Esto es especialmente importante para el reproductor global de demos.

El frontend utiliza:

PHP para el primer renderizado.
Bootstrap 5.3 para presentación.
JavaScript nativo para filtros AJAX.
REST API para actualizar listados.
parámetros GET para mantener filtros y paginación en la URL.

No depende de:

jQueryACFreproductores externosCSS frontend propio del plugin

3. Resumen rápido de los cinco shortcodes

Artistas

[sds_artistas]

Adecuado para:

roster completo;
página de artistas;
artistas destacados;
home;
listados por género;
listados por tipo de artista;
grid o filas;
listados paginados.

Lanzamiento destacado

[sds_featured_release]

Adecuado para:

hero musical;
lanzamiento destacado;
último lanzamiento;
lanzamiento concreto;
último lanzamiento de un artista;
último lanzamiento de un tipo determinado;
combinación artista + tipo.

Siempre muestra como máximo un lanzamiento.

Novedades

[sds_lanzamientos]

Adecuado para:

últimos lanzamientos;
sección de novedades;
cuatro discos recientes en una home;
lanzamientos destacados;
novedades de un artista;
grid o filas.

No tiene filtros interactivos ni paginador.

Catálogo

[sds_catalogo]

Adecuado para:

catálogo completo;
página /musica/;
exploración por tipo;
exploración por género;
búsqueda exacta de artista;
catálogo paginado;
grid o filas.

Discografía

[sds_discografia_artista]

Adecuado para:

ficha de artista;
página independiente de discografía;
discografía de un artista por ID;
discografía por slug;
discografía por nombre exacto;
filtros por tipo y género;
paginación.

4. Atributos generales

Los siguientes atributos forman parte del comportamiento común de una o varias vistas.

`cantidad`

Controla cuántos elementos se solicitan por página.

Ejemplo:

[sds_catalogo cantidad="24"]

Rango admitido:

1–200

Sin embargo existe además una configuración global:

Máximo por página

Su valor predeterminado es:

Por tanto:

[sds_catalogo cantidad="100"]

con máximo global de 48 equivale realmente a:

48 elementos por página

Defaults por vista:

Vista	Default
Artistas	12
Lanzamientos	4
Catálogo	12
Discografía	12
Featured	siempre 1

Ejemplo:

[sds_artistas cantidad="6"]

[sds_lanzamientos cantidad="8"]

[sds_catalogo cantidad="18"]

[sds_discografia_artista artista="123" cantidad="20"]

En [sds_featured_release], cantidad no es operativo: esa vista fuerza una cantidad de 1.

5. `destacados`

Permite limitar una consulta a contenido marcado como destacado.

Valores:

Ejemplo:

[sds_artistas destacados="1"]

Muestra únicamente artistas con:

_sds_destacado = 1

También puede emplearse en:

[sds_lanzamientos destacados="1"]
[sds_catalogo destacados="1"]
[sds_discografia_artista destacados="1"]

Ejemplo de artistas destacados para portada:

[sds_artistas destacados="1" cantidad="3" filtros="0"]

Ejemplo de catálogo exclusivamente destacado:

[sds_catalogo destacados="1" cantidad="12"]

Importante

En:

[sds_featured_release]

destacados="1" no controla la selección final.

Para esa vista debe utilizarse:

criterio="destacado"

6. `titulo`

Modifica el <h2> principal de la sección.

Ejemplo:

[sds_artistas titulo="Nuestro roster"]

Resultado conceptual:

<h2>Nuestro roster</h2>

Funciona en las cinco vistas:

[sds_artistas titulo="Artistas"]
[sds_lanzamientos titulo="Novedades"]
[sds_catalogo titulo="Todos los discos"]
[sds_discografia_artista titulo="Discografía completa"]
[sds_featured_release titulo="Nuevo lanzamiento"]

Los títulos predeterminados son:

Vista	Título
Artistas	`Artistas SDS`
Featured	`Último lanzamiento`
Lanzamientos	`Lo nuevo.`
Catálogo	`Explora el catálogo.`
Discografía	`Discografía`

7. `etiqueta`

Controla el pequeño texto que aparece encima del título.

Ejemplo:

[sds_artistas etiqueta="SDS Records"]

Predeterminados:

Vista	Etiqueta
Artistas	`02 / Roster`
Featured	`02 / Featured release`
Lanzamientos	`03 / Lanzamientos`
Catálogo	`05 / Catálogo`
Discografía	vacío

Ejemplo:

[sds_lanzamientos    etiqueta="Novedades"    titulo="Últimos lanzamientos"]

También puede dejarse explícitamente vacío:

[sds_artistas etiqueta=""]

8. `mensaje_vacio`

Permite personalizar el texto mostrado cuando la consulta no devuelve resultados.

Default:

No hay resultados para esta selección.

Ejemplo:

[sds_catalogo mensaje_vacio="No hay discos disponibles."]

Otro ejemplo:

[sds_discografia_artista    artista="123"    mensaje_vacio="Este artista todavía no tiene lanzamientos publicados."]

Featured:

[sds_featured_release    criterio="id"    lanzamiento_id="123"    mensaje_vacio="El lanzamiento seleccionado no está disponible."]

9. `layout`

Valores admitidos:

gridrow

Ejemplo:

[sds_artistas layout="grid"]

[sds_artistas layout="row"]

[sds_catalogo layout="grid"]

[sds_catalogo layout="row"]

Comportamiento por vista

Artistas + `grid`

Cards distribuidas en columnas.

[sds_artistas layout="grid"]

Artistas + `row`

Cada artista ocupa todo el ancho disponible.

[sds_artistas layout="row"]

Lanzamientos + `grid`

Cards cuadradas de lanzamiento.

[sds_lanzamientos layout="grid"]

Lanzamientos + `row`

Formato horizontal.

[sds_lanzamientos layout="row"]

Catálogo + `grid`

[sds_catalogo layout="grid"]

Catálogo + `row`

[sds_catalogo layout="row"]

Discografía + `grid`

[sds_discografia_artista artista="123" layout="grid"]

Discografía + `row`

Es el comportamiento predeterminado:

[sds_discografia_artista artista="123" layout="row"]

Featured + `row`

Es el default.

Imagen y contenido se presentan en dos columnas en pantallas grandes:

[sds_featured_release layout="row"]

Featured + `grid`

La portada y el contenido quedan apilados:

[sds_featured_release layout="grid"]

10. `variante`

Valores:

completacompacta

Default:

completa

Ejemplo:

[sds_catalogo variante="compacta"]

`completa`

Muestra información secundaria disponible.

Dependiendo del componente puede incluir:

tipo;
género;
año;
artista;
extracto;
metadatos secundarios.

Ejemplo:

[sds_artistas variante="completa"]

`compacta`

Elimina información secundaria, conservando los elementos esenciales.

Ejemplo:

[sds_artistas variante="compacta"]

En una card de artista siguen apareciendo, entre otros:

imagen;
nombre;
botón de ficha;
demo si existe;
enlace de plataforma disponible.

Se eliminan elementos secundarios como:

badges de tipo/género;
extracto.

En lanzamientos:

[sds_catalogo variante="compacta"]

se simplifican los metadatos visuales.

11. Columnas

Los atributos son:

columnascolumnas_tabletcolumnas_movil

Valores permitidos:

Ejemplo:

[sds_catalogo    layout="grid"    columnas="4"    columnas_tablet="2"    columnas_movil="1"]

El plugin genera clases Bootstrap equivalentes.

Por ejemplo:

columnas="4"columnas_tablet="2"columnas_movil="1"

produce conceptualmente:

col-12 col-md-6 col-xl-3

Defaults

Artistas

columnas="3"columnas_tablet="2"columnas_movil="1"

Lanzamientos, catálogo y discografía

columnas="4"columnas_tablet="2"columnas_movil="1"

Con `layout="row"`

Los valores de columnas dejan de alterar la anchura de las cards, ya que cada elemento utiliza:

col-12

Por tanto:

[sds_catalogo layout="row" columnas="6"]

es válido sintácticamente, pero columnas="6" no produce una cuadrícula de seis columnas.

Featured

No utiliza columnas, columnas_tablet ni columnas_movil.

12. Ordenación: `ordenar_por`

Artistas

Valores:

manualtitulofecha_publicaciondestacado

Default:

manual

Ejemplo:

[sds_artistas ordenar_por="titulo"]

Lanzamientos, catálogo y discografía

Valores:

titulofecha_publicacionfecha_lanzamientodestacado

Default:

fecha_lanzamiento

Ejemplo:

[sds_catalogo ordenar_por="titulo"]

13. Dirección: `orden`

Valores admitidos:

ASCDESC

Defaults:

Artistas: ASCLanzamientos: DESCCatálogo: DESCDiscografía: DESC

Ejemplo:

[sds_artistas ordenar_por="titulo" orden="ASC"]

Para mostrar títulos en orden inverso:

[sds_artistas ordenar_por="titulo" orden="DESC"]

Catálogo del más antiguo al más reciente:

[sds_catalogo    ordenar_por="fecha_lanzamiento"    orden="ASC"]

14. Orden manual de artistas

El orden manual utiliza el metadato:

_sds_orden_artista

Shortcode:

[sds_artistas ordenar_por="manual" orden="ASC"]

Los valores menores aparecen primero.

Los artistas que no tengan ese metadato se comportan como si su valor fuera:

Los desempates se resuelven por:

título ASCID ASC

Ejemplo conceptual:

Artista A → orden 10Artista B → orden 20Artista C → orden 30

Con:

[sds_artistas ordenar_por="manual" orden="ASC"]

aparecen:

ABC

15. Ordenar por destacado

Puede utilizarse:

ordenar_por="destacado"

Ejemplo:

[sds_artistas ordenar_por="destacado" orden="DESC"]

Esto ordena según la marca de destacado.

No debe confundirse con:

destacados="1"

que filtra y elimina los no destacados.

Por ejemplo:

[sds_artistas    ordenar_por="destacado"    orden="DESC"]

incluye destacados y no destacados, pero coloca primero los marcados.

Mientras:

[sds_artistas destacados="1"]

solo devuelve los destacados.

También pueden combinarse:

[sds_artistas    destacados="1"    ordenar_por="titulo"    orden="ASC"]

16. Filtros

El sistema interactivo de filtros existe en:

[sds_artistas]
[sds_catalogo]
[sds_discografia_artista]

No existe en:

[sds_lanzamientos]
[sds_featured_release]

17. `filtros`

Valores:

Default:

Ejemplo:

[sds_artistas filtros="0"]

Oculta todos los controles de filtros.

Ejemplo típico para una home:

[sds_artistas    destacados="1"    cantidad="3"    filtros="0"]

Importante

filtros="0" oculta los controles visuales, pero no elimina filtros que ya estén presentes en la URL.

Por ejemplo, si la URL contiene:

?sds_genero=rock

este shortcode:

[sds_artistas filtros="0"]

puede seguir consultando el género rock.

Simplemente no mostrará los controles al usuario.

18. `filtro_tipo`

Valores:

Default:

Disponible en:

[sds_artistas]
[sds_catalogo]
[sds_discografia_artista]

Ejemplo:

[sds_artistas filtro_tipo="0"]

Oculta el selector por tipo de artista.

Mantener solo el tipo:

[sds_artistas    filtro_tipo="1"    filtro_genero="0"]

19. `filtro_genero`

Valores:

Default:

Ejemplo:

[sds_catalogo filtro_genero="0"]

Solo género:

[sds_catalogo    filtro_tipo="0"    filtro_genero="1"    filtro_artista="0"]

20. `filtro_artista`

Disponible en:

[sds_catalogo]
[sds_discografia_artista]

Valores:

Defaults:

Catálogo: 1Discografía: 0

Ejemplo:

[sds_catalogo filtro_artista="1"]

El filtro utiliza un campo de búsqueda textual.

Debe introducirse:

nombre exacto

slug exacto

Ejemplo:

ana-torres

Ana Torres

No es una búsqueda parcial.

21. Artista fijo vs filtro de artista

Puede fijarse un artista mediante:

artista="..."

Ejemplo:

[sds_catalogo artista="123"]

En ese caso el listado queda restringido a ese artista.

Si simultáneamente:

filtro_artista="1"

el plugin suprime el selector de artista porque resultaría redundante.

Ejemplo:

[sds_catalogo    artista="123"    filtro_artista="1"]

No muestra el campo de artista.

22. Parámetros GET utilizados por los filtros

Con el prefijo predeterminado:

sds

se utilizan:

sds_tiposds_generosds_artistasds_page

Ejemplos:

/artistas/?sds_tipo=productor

/artistas/?sds_genero=rock

/artistas/?sds_tipo=productor&sds_genero=rock

Catálogo:

/musica/?sds_tipo=single

/musica/?sds_genero=pop

/musica/?sds_artista=ana-torres

/musica/?sds_tipo=single&sds_artista=ana-torres&sds_page=2

Los distintos filtros se combinan mediante condiciones equivalentes a un:

AND

23. `prefijo`

El atributo:

prefijo

permite cambiar el nombre de los parámetros GET asociados a una instancia.

Default:

sds

Ejemplo:

[sds_artistas prefijo="roster"]

produce parámetros:

roster_tiporoster_generoroster_artistaroster_page

Aunque en artistas roster_artista normalmente no se utiliza como control.

24. Dos listados en la misma página

Si existen varias instancias dinámicas, es recomendable utilizar prefijos diferentes.

Ejemplo:

[sds_artistas prefijo="roster"]
[sds_catalogo prefijo="catalogo"]

Así una URL podría contener:

?roster_genero=rock&catalogo_tipo=album&catalogo_page=2

Cada bloque mantiene su propio estado.

25. Qué ocurre si dos bloques tienen el mismo prefijo

Ejemplo:

[sds_artistas prefijo="sds"]
[sds_catalogo prefijo="sds"]

Ambos leen el mismo conjunto de parámetros:

sds_tiposds_generosds_artistasds_page

Por ello compartirán estado.

Esto puede ser deliberado, pero normalmente no es recomendable para listados independientes.

26. Normalización de `prefijo`

El prefijo:

se convierte a minúsculas;
elimina caracteres que no sean letras a-z, números o _;
se limita a 32 caracteres;
si queda vacío, vuelve a sds.

Ejemplo:

prefijo="Mi Catálogo!"

se normaliza conceptualmente a:

micatlogo

dependiendo de los caracteres eliminados tras la normalización.

Es preferible usar directamente formatos seguros:

catalogorosterhome_musicartist_music

27. Paginación

Disponible solamente en:

[sds_artistas]
[sds_catalogo]
[sds_discografia_artista]

No aparece en:

[sds_lanzamientos]
[sds_featured_release]

Los atributos son:

paginador_adyacentespaginador_primerapaginador_ultimapaginador_anteriorpaginador_siguiente

28. `paginador_adyacentes`

Rango:

0–10

Default:

Controla cuántas páginas alrededor de la página actual aparecen.

Ejemplo:

[sds_catalogo paginador_adyacentes="1"]

Si la página actual es la 5, el rango central será aproximadamente:

4 5 6

más los extremos configurados.

Con:

paginador_adyacentes="2"

sería:

3 4 5 6 7

29. `paginador_primera`

Valores:

Default:

Incluye la primera página fuera del rango adyacente.

[sds_catalogo paginador_primera="0"]

30. `paginador_ultima`

Valores:

Default:

Ejemplo:

[sds_catalogo paginador_ultima="0"]

31. `paginador_anterior`

Valores:

Default:

Ejemplo:

[sds_catalogo paginador_anterior="1"]

Añade un enlace:

Anterior

cuando procede.

32. `paginador_siguiente`

Valores:

Default:

Ejemplo:

[sds_catalogo paginador_siguiente="1"]

Añade:

Siguiente

33. Paginador completo tradicional

[sds_catalogo    paginador_adyacentes="2"    paginador_primera="1"    paginador_ultima="1"    paginador_anterior="1"    paginador_siguiente="1"]

34. Paginador mínimo

[sds_catalogo    paginador_adyacentes="1"    paginador_primera="0"    paginador_ultima="0"    paginador_anterior="1"    paginador_siguiente="1"]

35. Límite de página

El plugin limita la página solicitada a:

de forma predeterminada.

Este límite es independiente de cantidad.

Por ejemplo:

?sds_page=99999

se normaliza al máximo permitido por el servidor.

Existe además el filtro PHP:

sds_content_max_page

pero no puede modificarse mediante shortcode.

36. CTA de artista: `texto_ver_artista`

Disponible en:

[sds_artistas]

Default:

Ver artista

Ejemplo:

[sds_artistas texto_ver_artista="Conocer artista"]

Otros ejemplos:

[sds_artistas texto_ver_artista="Ver perfil"]

[sds_artistas texto_ver_artista="Descubrir"]

37. CTA de lanzamiento: `texto_ver_lanzamiento`

Disponible en:

[sds_lanzamientos]
[sds_catalogo]
[sds_discografia_artista]

Default:

Ver lanzamiento

Ejemplo:

[sds_catalogo texto_ver_lanzamiento="Abrir disco"]

[sds_lanzamientos texto_ver_lanzamiento="Escuchar lanzamiento"]

[sds_discografia_artista    artista="123"    texto_ver_lanzamiento="Ver ficha"]

No es un atributo operativo de:

[sds_featured_release]

38. `[sds_artistas]`

Uso básico

[sds_artistas]

Default efectivo:

cantidad="12"layout="grid"variante="completa"ordenar_por="manual"orden="ASC"columnas="3"columnas_tablet="2"columnas_movil="1"filtros="1"filtro_tipo="1"filtro_genero="1"paginador_adyacentes="2"paginador_primera="1"paginador_ultima="1"paginador_anterior="0"paginador_siguiente="0"mensaje_vacio="No hay resultados para esta selección."

39. Todos los atributos útiles de `[sds_artistas]`

cantidaddestacadosfiltrosfiltro_tipofiltro_generotituloetiquetaprefijomensaje_vaciolayoutvariantecolumnascolumnas_tabletcolumnas_movilordenar_porordenpaginador_adyacentespaginador_primerapaginador_ultimapaginador_anteriorpaginador_siguientetexto_ver_artista

40. Ejemplo: roster normal

[sds_artistas]

41. Ejemplo: roster alfabético

[sds_artistas    ordenar_por="titulo"    orden="ASC"]

42. Ejemplo: roster horizontal

[sds_artistas    layout="row"    ordenar_por="titulo"    orden="ASC"]

43. Ejemplo: roster compacto

[sds_artistas    variante="compacta"]

44. Ejemplo: cuatro columnas

[sds_artistas    layout="grid"    columnas="4"    columnas_tablet="2"    columnas_movil="1"]

45. Ejemplo: solo artistas destacados

[sds_artistas    destacados="1"]

46. Ejemplo: artistas destacados para home

[sds_artistas    destacados="1"    cantidad="3"    filtros="0"    titulo="Artistas destacados"    etiqueta="SDS"]

47. Ejemplo: solo filtro de género

[sds_artistas    filtro_tipo="0"    filtro_genero="1"]

48. Ejemplo: sin filtros

[sds_artistas    filtros="0"]

49. Ejemplo: paginador completo

[sds_artistas    cantidad="12"    paginador_anterior="1"    paginador_siguiente="1"]

50. Particularidades de `[sds_artistas]`

El atributo genérico:

artista

puede ser reconocido por la infraestructura del shortcode, pero no restringe la consulta de artistas.

Esto:

[sds_artistas artista="123"]

no significa «mostrar únicamente el artista 123».

Para obtener un subconjunto de artistas deben utilizarse:

destacados;
filtros por tipo;
filtros por género;
cantidad;
ordenación.

51. `[sds_lanzamientos]`

Uso básico

[sds_lanzamientos]

Está diseñado como bloque de novedades y no como catálogo interactivo.

Defaults:

cantidad="4"layout="grid"variante="completa"ordenar_por="fecha_lanzamiento"orden="DESC"columnas="4"columnas_tablet="2"columnas_movil="1"mensaje_vacio="No hay resultados para esta selección."

No incorpora:

filtros interactivos;
paginación.

52. Todos los atributos útiles de `[sds_lanzamientos]`

cantidaddestacadosartistatituloetiquetamensaje_vaciolayoutvariantecolumnascolumnas_tabletcolumnas_movilordenar_porordentexto_ver_lanzamiento

53. Ejemplo básico

[sds_lanzamientos cantidad="4"]

54. Últimos ocho lanzamientos

[sds_lanzamientos cantidad="8"]

55. Novedades en filas

[sds_lanzamientos    cantidad="6"    layout="row"]

56. Novedades compactas

[sds_lanzamientos    variante="compacta"]

57. Lanzamientos destacados

[sds_lanzamientos    destacados="1"    cantidad="4"]

58. Novedades de un artista

[sds_lanzamientos    artista="123"    cantidad="4"]

También puede utilizarse un slug exacto:

[sds_lanzamientos    artista="nombre-del-artista"]

O el título exacto:

[sds_lanzamientos    artista="Nombre del Artista"]

La relación contempla:

artista principal;
artistas colaboradores.

59. Lanzamientos de artista destacado

[sds_lanzamientos    artista="123"    destacados="1"]

La consulta exige simultáneamente:

artista relacionadoANDdestacado

60. Novedades para home

[sds_lanzamientos    destacados="1"    cantidad="4"    titulo="Música destacada"    etiqueta="SDS"]

61. Orden alfabético de lanzamientos

[sds_lanzamientos    ordenar_por="titulo"    orden="ASC"]

62. Por fecha de publicación

[sds_lanzamientos    ordenar_por="fecha_publicacion"    orden="DESC"]

63. Por fecha real de lanzamiento

[sds_lanzamientos    ordenar_por="fecha_lanzamiento"    orden="DESC"]

Es el comportamiento predeterminado.

64. Atributos sin efecto práctico en `[sds_lanzamientos]`

No tiene navegación dinámica, por lo que atributos como:

prefijofiltrosfiltro_tipofiltro_generofiltro_artistapaginador_*

no proporcionan la funcionalidad equivalente a catálogo.

Para esos casos debe utilizarse:

[sds_catalogo]

65. `[sds_catalogo]`

Uso básico

[sds_catalogo]

Defaults:

cantidad="12"layout="row"variante="completa"ordenar_por="fecha_lanzamiento"orden="DESC"columnas="4"columnas_tablet="2"columnas_movil="1"filtros="1"filtro_tipo="1"filtro_genero="1"filtro_artista="1"paginador_adyacentes="2"paginador_primera="1"paginador_ultima="1"paginador_anterior="0"paginador_siguiente="0"

66. Todos los atributos útiles de `[sds_catalogo]`

cantidaddestacadosartistaprefijofiltrosfiltro_tipofiltro_generofiltro_artistatituloetiquetamensaje_vaciolayoutvariantecolumnascolumnas_tabletcolumnas_movilordenar_porordenpaginador_adyacentespaginador_primerapaginador_ultimapaginador_anteriorpaginador_siguientetexto_ver_lanzamiento

67. Catálogo completo

[sds_catalogo cantidad="12"]

68. Catálogo en grid

[sds_catalogo    layout="grid"]

69. Catálogo de tres columnas

[sds_catalogo    layout="grid"    columnas="3"    columnas_tablet="2"    columnas_movil="1"]

70. Catálogo compacto

[sds_catalogo    layout="grid"    variante="compacta"]

71. Catálogo sin filtros

[sds_catalogo    filtros="0"]

72. Catálogo con género y artista únicamente

[sds_catalogo    filtro_tipo="0"    filtro_genero="1"    filtro_artista="1"]

73. Catálogo solo por tipo

[sds_catalogo    filtro_tipo="1"    filtro_genero="0"    filtro_artista="0"]

74. Catálogo restringido a artista

[sds_catalogo    artista="123"]

La relación incluye:

artista principalORartista colaborador

75. Catálogo restringido por slug

[sds_catalogo    artista="nombre-del-artista"]

76. Catálogo restringido por nombre exacto

[sds_catalogo    artista="Nombre del Artista"]

El nombre debe coincidir con el título del CPT del artista.

77. Catálogo destacado

[sds_catalogo    destacados="1"]

78. Catálogo personalizado completo

[sds_catalogo    prefijo="catalogo"    cantidad="18"    filtro_tipo="0"    filtro_genero="1"    filtro_artista="1"    layout="grid"    columnas="3"    columnas_tablet="2"    columnas_movil="1"    variante="compacta"    mensaje_vacio="No hay discos disponibles."    texto_ver_lanzamiento="Abrir disco"]

79. `[sds_discografia_artista]`

Muestra lanzamientos relacionados con un artista.

Uso por ID

[sds_discografia_artista artista="123"]

80. Uso por slug

[sds_discografia_artista artista="nombre-del-artista"]

81. Uso por título exacto

[sds_discografia_artista artista="Nombre del Artista"]

82. Detección automática dentro de una ficha de artista

Dentro de una ficha individual sds_artista puede usarse:

[sds_discografia_artista]

Sin artista.

El shortcode detecta automáticamente:

get_queried_object_id()

cuando la página actual es un artista SDS.

Además, la plantilla individual del plugin ya puede añadir la discografía automáticamente cuando el shortcode no se ha colocado manualmente.

Por ello normalmente no conviene duplicarlo desde otra zona del theme.

83. Defaults de discografía

cantidad="12"layout="row"variante="completa"ordenar_por="fecha_lanzamiento"orden="DESC"columnas="4"columnas_tablet="2"columnas_movil="1"filtros="1"filtro_tipo="1"filtro_genero="1"filtro_artista="0"paginador_adyacentes="2"paginador_primera="1"paginador_ultima="1"paginador_anterior="0"paginador_siguiente="0"

84. Todos los atributos útiles de `[sds_discografia_artista]`

artistacantidaddestacadosprefijofiltrosfiltro_tipofiltro_generofiltro_artistatituloetiquetamensaje_vaciolayoutvariantecolumnascolumnas_tabletcolumnas_movilordenar_porordenpaginador_adyacentespaginador_primerapaginador_ultimapaginador_anteriorpaginador_siguientetexto_ver_lanzamiento

85. Discografía sencilla

[sds_discografia_artista artista="123"]

86. Discografía en grid

[sds_discografia_artista    artista="123"    layout="grid"]

87. Discografía compacta

[sds_discografia_artista    artista="123"    layout="grid"    variante="compacta"]

88. Discografía sin filtros

[sds_discografia_artista    artista="123"    filtros="0"]

89. Solo singles destacados del artista mediante interfaz

El shortcode no tiene un atributo directo tipo="single" para discografía.

Para aplicar tipo mediante el estado dinámico se utiliza la URL:

?sds_tipo=single

junto con:

[sds_discografia_artista artista="123"]

Si además se quieren únicamente lanzamientos destacados:

[sds_discografia_artista    artista="123"    destacados="1"]

y URL:

?sds_tipo=single

90. Discografía con paginador extendido

[sds_discografia_artista    artista="45"    paginador_adyacentes="1"    paginador_anterior="1"    paginador_siguiente="1"]

91. Discografía sin artista válido

Fuera de una ficha individual:

[sds_discografia_artista]

no debe entenderse como «todos los lanzamientos».

Si no hay un artista resoluble, la consulta se fuerza a no devolver resultados.

También ocurre con:

[sds_discografia_artista artista="artista-inexistente"]

Esto evita que una referencia incorrecta amplíe accidentalmente la consulta a todo el catálogo.

92. `[sds_featured_release]`

Muestra exactamente un lanzamiento.

Uso básico:

[sds_featured_release]

Default:

criterio="destacado"layout="row"variante="completa"mensaje_vacio="No hay resultados para esta selección."

93. Todos los atributos útiles de `[sds_featured_release]`

criteriolanzamiento_idartistatipotituloetiquetamensaje_vaciolayoutvariante

cantidad no cambia el resultado: siempre devuelve como máximo un lanzamiento.

94. `criterio`

Valores admitidos:

destacadorecienteidartistatipo

Default:

destacado

95. `criterio="destacado"`

[sds_featured_release criterio="destacado"]

Busca el lanzamiento:

destacadopublicadosin contraseñafecha de lanzamiento <= hoymás reciente

Si no existe ningún lanzamiento marcado como destacado, realiza un fallback al lanzamiento reciente que cumpla el resto de restricciones.

Por tanto:

[sds_featured_release]

equivale por defecto a:

[sds_featured_release criterio="destacado"]

96. Featured restringido a artista

[sds_featured_release    criterio="destacado"    artista="45"]

Busca primero:

lanzamiento destacadoANDrelacionado con artista 45

Si no existe, busca:

lanzamiento más recienteANDrelacionado con artista 45

97. `criterio="reciente"`

[sds_featured_release criterio="reciente"]

Devuelve el lanzamiento válido más reciente.

No exige la marca:

_sds_destacado = 1

98. Último lanzamiento de un artista

Puede hacerse:

[sds_featured_release    criterio="reciente"    artista="45"]

También:

[sds_featured_release    criterio="artista"    artista="45"]

La diferencia contractual es que criterio="artista" exige que exista un artista válido.

99. `criterio="id"`

Permite elegir un lanzamiento concreto.

[sds_featured_release    criterio="id"    lanzamiento_id="123"]

lanzamiento_id debe corresponder a un lanzamiento:

existente;
publicado;
sin contraseña.

Además debe cumplir el resto de restricciones del featured.

Si el lanzamiento:

es futuro;
no está publicado;
no existe;
no coincide con artista;
no coincide con tipo;

no se sustituye automáticamente por otro.

Se muestra mensaje_vacio.

Ejemplo:

[sds_featured_release    criterio="id"    lanzamiento_id="123"    mensaje_vacio="Sin lanzamiento seleccionado."]

100. `criterio="artista"`

[sds_featured_release    criterio="artista"    artista="45"]

Requiere un artista válido.

Devuelve el lanzamiento más reciente relacionado con ese artista.

Las relaciones contempladas son:

artista principalORartista colaborador

101. Artista por slug en featured

[sds_featured_release    criterio="artista"    artista="nombre-del-artista"]

102. Artista por título exacto

[sds_featured_release    criterio="artista"    artista="Nombre del Artista"]

103. `criterio="tipo"`

[sds_featured_release    criterio="tipo"    tipo="single"]

tipo debe corresponder a un slug existente de:

sds_tipo_lanzamiento

Los tipos creados inicialmente por el plugin incluyen:

singleepalbumcolaboracion

pero pueden existir otros términos personalizados.

104. `tipo`

Puede combinarse también con otros criterios.

Por ejemplo:

[sds_featured_release    criterio="reciente"    tipo="single"]

Devuelve el single más reciente.

105. Artista + tipo

[sds_featured_release    criterio="reciente"    artista="45"    tipo="single"]

Significa conceptualmente:

fecha válidaANDartista relacionado = 45ANDtipo = single

ordenado del más reciente al más antiguo, tomando uno.

106. Destacado + artista + tipo

[sds_featured_release    criterio="destacado"    artista="45"    tipo="single"]

Busca primero el single destacado más reciente de ese artista.

Si no existe destacado, cae al single reciente del mismo artista.

107. ID + artista

[sds_featured_release    criterio="id"    lanzamiento_id="123"    artista="45"]

El lanzamiento 123 debe estar relacionado con el artista 45.

Si no lo está, el resultado queda vacío.

108. ID + tipo

[sds_featured_release    criterio="id"    lanzamiento_id="123"    tipo="album"]

El lanzamiento concreto debe pertenecer al tipo album.

109. ID + artista + tipo

[sds_featured_release    criterio="id"    lanzamiento_id="123"    artista="45"    tipo="album"]

Las tres restricciones deben cumplirse simultáneamente.

110. Featured apilado

[sds_featured_release    layout="grid"]

La portada queda encima del contenido.

111. Featured horizontal

[sds_featured_release    layout="row"]

Es el diseño predeterminado.

112. Featured compacto

[sds_featured_release    variante="compacta"]

Conserva:

artista;
título;
controles;
plataformas disponibles.

Reduce información secundaria como:

badges;
año;
extracto.

113. Featured personalizado para portada

[sds_featured_release    criterio="destacado"    titulo="Último lanzamiento"    etiqueta="SDS Records"    layout="row"    variante="completa"]

114. Resolución del atributo `artista`

En los shortcodes de lanzamientos puede utilizarse:

artista="123"

artista="slug-del-artista"

artista="Nombre Exacto"

ID

Ejemplo:

artista="123"

Debe ser un sds_artista publicado y sin contraseña.

Slug exacto

Ejemplo:

artista="juan-perez"

El plugin intenta resolverlo como slug exacto.

Nombre exacto

Ejemplo:

artista="Juan Pérez"

Busca un artista cuyo título sea exactamente ese valor.

No es una búsqueda aproximada.

Por tanto:

artista="Juan"

no garantiza encontrar:

Juan Pérez

115. Artista principal y colaboradores

Las consultas de lanzamientos consideran tanto:

_sds_artista_principal_id

como:

_sds_artista_colaborador_id

Por tanto:

[sds_catalogo artista="123"]

incluye un lanzamiento cuando el artista 123 es:

artista principal; o
colaborador.

Lo mismo se aplica a:

[sds_lanzamientos artista="123"]
[sds_discografia_artista artista="123"]
[sds_featured_release artista="123"]

116. Fechas de lanzamiento

Los listados de lanzamientos solo muestran elementos con:

_sds_fecha_lanzamiento

dentro del intervalo:

1000-01-01hastafecha actual de WordPress

Por tanto, un lanzamiento con fecha futura no aparece en:

[sds_lanzamientos]
[sds_catalogo]
[sds_discografia_artista]
[sds_featured_release]

aunque su post esté publicado.

117. Importante sobre fichas individuales futuras

La regla anterior se aplica a los listados.

Un sds_lanzamiento publicado con fecha futura puede seguir teniendo una ficha individual accesible.

Si se quiere impedir también el acceso a la ficha antes del lanzamiento, debe utilizarse un estado WordPress adecuado, por ejemplo:

borradorprogramado

118. Contenido protegido con contraseña

Los listados usan:

has_password = false

Por tanto los contenidos protegidos no aparecen en las consultas de los shortcodes.

119. Contenido no publicado

Los listados únicamente utilizan:

post_status = publish

No muestran:

draftprivatependingtrash

120. Demo de audio en cards de lanzamiento

Cuando un lanzamiento dispone de un archivo de audio válido:

_sds_demo_audio_id

puede aparecer el botón:

Escuchar

El plugin comprueba que:

el lanzamiento sea público;
ya esté lanzado;
el attachment siga existiendo;
el attachment sea audio;
no esté en la papelera.

121. Demo en cards de artista

La card de artista intenta localizar una demo mediante este orden.

Primero:

_sds_lanzamiento_destacado_id

si:

pertenece al artista;
tiene audio válido.

Si no resulta válido, entra en juego el fallback global.

122. Fallback de demo del artista

Configuración global:

General → Demo del artista: fallback

Valores:

ultimo_con_demoultimodestacadoninguno

Default:

ultimo_con_demo

123. `ultimo_con_demo`

Busca el lanzamiento relacionado más reciente que posea una demo válida.

124. `ultimo`

Selecciona el lanzamiento relacionado más reciente.

Si ese lanzamiento no tiene demo, no aparece botón de reproducción.

No sigue buscando otro lanzamiento con audio.

125. `destacado`

Busca el lanzamiento relacionado marcado como destacado.

Si carece de audio, no aparece botón.

126. `ninguno`

Desactiva el fallback automático.

La selección manual del lanzamiento destacado del artista continúa pudiendo funcionar.

127. Plataformas en tarjetas de artista

Las cards de artista inspeccionan, en este orden:

SpotifyApple MusicYouTube

y muestran como máximo el primer enlace disponible de esa lista.

Además pueden mostrar:

botón Ver artista;
demo.

128. Plataformas en featured release

El featured puede mostrar independientemente:

SpotifyApple MusicYouTubeDeezerSmartlink

Es decir, puede presentar varios botones simultáneamente.

129. Reproductor global

El plugin utiliza un único:

<audio>

global.

Esto permite que:

al iniciar una demo se detenga la anterior;
distintos botones del mismo lanzamiento compartan estado;
el audio continúe mientras se actualizan resultados por AJAX.

La navegación completa a otra página sí interrumpe el reproductor.

130. Funcionamiento sin JavaScript

Los filtros se construyen también como enlaces y formularios GET.

Por tanto pueden funcionar sin JavaScript mediante recarga de página.

La paginación también utiliza enlaces normales.

Para demos, dentro de <noscript> se genera un enlace directo al archivo de audio.

131. Funcionamiento con JavaScript

Las vistas dinámicas:

sds_artistassds_catalogosds_discografia_artista

utilizan:

/wp-json/sds/v1/results

para actualizar los resultados.

Al cambiar un filtro:

se reinicia la página a 1;
se consulta REST;
se sustituye el HTML de resultados;
se actualiza la URL;
se conserva historial;
funcionan Atrás y Adelante.

132. Shortcodes dinámicos vs estáticos

Dinámicos

[sds_artistas]
[sds_catalogo]
[sds_discografia_artista]

Tienen:

filtros GET;
paginación;
REST;
actualización AJAX;
historial del navegador.

No dinámicos

[sds_lanzamientos]
[sds_featured_release]

Se renderizan como bloques sin interfaz de filtros ni paginación.

133. Valores permitidos y normalización

El plugin no acepta valores arbitrarios para campos enumerados.

Ejemplo:

layout="slider"

no es válido.

Los únicos layouts admitidos son:

gridrow

Un valor inválido vuelve al valor por defecto correspondiente.

134. Valores de `variante`

Solo:

compactacompleta

Ejemplo inválido:

variante="minimal"

No crea una nueva variante.

135. Valores de columnas

Solo:

Por ejemplo:

columnas="5"

no es un valor admitido.

136. Valores de orden

Solo:

ASCDESC

No se pasan expresiones SQL arbitrarias al WP_Query.

137. Valores inválidos de cantidad

Si el valor no es un entero decimal válido, el plugin vuelve al fallback correspondiente.

Ejemplo:

cantidad="abc"

no se interpreta como cantidad.

Los enteros que superan el máximo se limitan.

138. Textos

Los textos de shortcode pasan por:

sanitize_text_field()

y quedan limitados a aproximadamente:

300 caracteres

Esto afecta, entre otros, a:

tituloetiquetamensaje_vaciotexto_ver_artistatexto_ver_lanzamiento

No están pensados para introducir HTML arbitrario.

139. Tabla completa de atributos por shortcode

Atributo	Artistas	Lanzamientos	Catálogo	Discografía	Featured
`cantidad`	✅	✅	✅	✅	—
`destacados`	✅	✅	✅	✅	—
`artista`	—*	✅	✅	✅	✅
`prefijo`	✅	—	✅	✅	—
`filtros`	✅	—	✅	✅	—
`filtro_tipo`	✅	—	✅	✅	—
`filtro_genero`	✅	—	✅	✅	—
`filtro_artista`	—	—	✅	✅	—
`titulo`	✅	✅	✅	✅	✅
`etiqueta`	✅	✅	✅	✅	✅
`mensaje_vacio`	✅	✅	✅	✅	✅
`layout`	✅	✅	✅	✅	✅
`variante`	✅	✅	✅	✅	✅
`columnas`	✅	✅	✅	✅	—
`columnas_tablet`	✅	✅	✅	✅	—
`columnas_movil`	✅	✅	✅	✅	—
`ordenar_por`	✅	✅	✅	✅	—
`orden`	✅	✅	✅	✅	—
`paginador_adyacentes`	✅	—	✅	✅	—
`paginador_primera`	✅	—	✅	✅	—
`paginador_ultima`	✅	—	✅	✅	—
`paginador_anterior`	✅	—	✅	✅	—
`paginador_siguiente`	✅	—	✅	✅	—
`texto_ver_artista`	✅	—	—	—	—
`texto_ver_lanzamiento`	—	✅	✅	✅	—
`criterio`	—	—	—	—	✅
`lanzamiento_id`	—	—	—	—	✅
`tipo`	—	—	—	—	✅

* El parser común puede recibir artista en [sds_artistas], pero la consulta de roster no lo utiliza como restricción.

140. Defaults completos por shortcode

`[sds_artistas]`

cantidad="12"mensaje_vacio="No hay resultados para esta selección."layout="grid"variante="completa"ordenar_por="manual"orden="ASC"columnas="3"columnas_tablet="2"columnas_movil="1"filtros="1"filtro_tipo="1"filtro_genero="1"paginador_adyacentes="2"paginador_primera="1"paginador_ultima="1"paginador_anterior="0"paginador_siguiente="0"prefijo="sds"destacados="0"

`[sds_lanzamientos]`

cantidad="4"mensaje_vacio="No hay resultados para esta selección."layout="grid"variante="completa"ordenar_por="fecha_lanzamiento"orden="DESC"columnas="4"columnas_tablet="2"columnas_movil="1"destacados="0"

`[sds_catalogo]`

cantidad="12"mensaje_vacio="No hay resultados para esta selección."layout="row"variante="completa"ordenar_por="fecha_lanzamiento"orden="DESC"columnas="4"columnas_tablet="2"columnas_movil="1"filtros="1"filtro_tipo="1"filtro_genero="1"filtro_artista="1"paginador_adyacentes="2"paginador_primera="1"paginador_ultima="1"paginador_anterior="0"paginador_siguiente="0"prefijo="sds"destacados="0"

`[sds_discografia_artista]`

cantidad="12"mensaje_vacio="No hay resultados para esta selección."layout="row"variante="completa"ordenar_por="fecha_lanzamiento"orden="DESC"columnas="4"columnas_tablet="2"columnas_movil="1"filtros="1"filtro_tipo="1"filtro_genero="1"filtro_artista="0"paginador_adyacentes="2"paginador_primera="1"paginador_ultima="1"paginador_anterior="0"paginador_siguiente="0"prefijo="sds"destacados="0"

`[sds_featured_release]`

mensaje_vacio="No hay resultados para esta selección."layout="row"variante="completa"criterio="destacado"lanzamiento_id="0"artista="0"tipo=""

La cantidad se fuerza internamente a:

141. Configuración recomendada para página `/artistas/`

[sds_artistas    cantidad="12"    prefijo="artistas"    filtros="1"    filtro_tipo="1"    filtro_genero="1"    ordenar_por="manual"    orden="ASC"    layout="grid"    columnas="3"    columnas_tablet="2"    columnas_movil="1"]

142. Configuración recomendada para página `/musica/`

[sds_featured_release]

[sds_lanzamientos    cantidad="4"]

[sds_catalogo    prefijo="catalogo"    cantidad="12"]

143. Configuración de home mínima

[sds_artistas    destacados="1"    cantidad="3"    filtros="0"    titulo="Artistas destacados"    etiqueta="SDS"]

[sds_lanzamientos    destacados="1"    cantidad="4"    titulo="Música destacada"    etiqueta="SDS"]

144. Home con featured + artistas + novedades

[sds_featured_release    criterio="destacado"    etiqueta="SDS Records"    titulo="Último lanzamiento"]

[sds_artistas    destacados="1"    cantidad="3"    filtros="0"    etiqueta="Roster"    titulo="Artistas destacados"]

[sds_lanzamientos    cantidad="4"    etiqueta="Novedades"    titulo="Últimos lanzamientos"]

145. Catálogo editorial en grid

[sds_catalogo    prefijo="catalogo"    cantidad="18"    layout="grid"    variante="completa"    columnas="3"    columnas_tablet="2"    columnas_movil="1"    filtro_tipo="1"    filtro_genero="1"    filtro_artista="1"    ordenar_por="fecha_lanzamiento"    orden="DESC"    paginador_adyacentes="2"    paginador_primera="1"    paginador_ultima="1"    paginador_anterior="1"    paginador_siguiente="1"]

146. Catálogo compacto tipo tienda musical

[sds_catalogo    prefijo="music"    cantidad="24"    layout="grid"    variante="compacta"    columnas="4"    columnas_tablet="2"    columnas_movil="1"    filtro_tipo="1"    filtro_genero="1"    filtro_artista="1"    texto_ver_lanzamiento="Abrir"]

147. Roster minimalista

[sds_artistas    cantidad="12"    layout="grid"    variante="compacta"    filtros="0"    ordenar_por="titulo"    orden="ASC"    columnas="4"    columnas_tablet="2"    columnas_movil="1"]

148. Roster editorial horizontal

[sds_artistas    layout="row"    variante="completa"    ordenar_por="manual"    orden="ASC"    filtros="1"]

149. Novedades como lista

[sds_lanzamientos    cantidad="10"    layout="row"    ordenar_por="fecha_lanzamiento"    orden="DESC"    titulo="Novedades"]

150. Lanzamientos antiguos primero

[sds_catalogo    ordenar_por="fecha_lanzamiento"    orden="ASC"]

151. Catálogo alfabético

[sds_catalogo    ordenar_por="titulo"    orden="ASC"]

152. Catálogo por publicación de WordPress

[sds_catalogo    ordenar_por="fecha_publicacion"    orden="DESC"]

Esto utiliza la fecha del post de WordPress, no _sds_fecha_lanzamiento.

153. Discografía integrada en página personalizada

[sds_discografia_artista    artista="nombre-del-artista"    cantidad="12"    prefijo="discografia"    layout="grid"    columnas="4"    columnas_tablet="2"    columnas_movil="1"]

154. Discografía destacada

[sds_discografia_artista    artista="123"    destacados="1"]

Esto devuelve exclusivamente lanzamientos relacionados con ese artista que estén marcados como destacados.

155. Featured por tipo: último álbum

[sds_featured_release    criterio="tipo"    tipo="album"    titulo="Último álbum"]

156. Featured por tipo: último single

[sds_featured_release    criterio="tipo"    tipo="single"    titulo="Último single"]

157. Último single de un artista

[sds_featured_release    criterio="reciente"    artista="nombre-del-artista"    tipo="single"]

158. Lanzamiento concreto destacado visualmente

[sds_featured_release    criterio="id"    lanzamiento_id="458"    layout="row"    variante="completa"]

159. Featured seleccionado por ID con fallback visual propio

[sds_featured_release    criterio="id"    lanzamiento_id="458"    mensaje_vacio="Este lanzamiento ya no está disponible."]

No selecciona otro disco automáticamente si el ID no resulta válido.

160. Diferencia entre novedades y catálogo

Utiliza:

[sds_lanzamientos]

cuando quieres un bloque finito de novedades.

Por ejemplo:

4 últimos lanzamientos

Utiliza:

[sds_catalogo]

cuando necesitas:

filtros;
paginación;
navegación AJAX;
URL compartible;
búsqueda exacta por artista;
exploración completa.

161. Diferencia entre catálogo y discografía

Esto:

[sds_catalogo artista="123"]

y esto:

[sds_discografia_artista artista="123"]

pueden devolver consultas de lanzamientos similares porque ambos restringen por relación con el artista.

Sin embargo, su configuración predeterminada y semántica son diferentes:

Catálogo

Default:

filtro_artista="1"

Está diseñado para exploración general.

Discografía

Default:

filtro_artista="0"

Está diseñado para representar la obra de un artista concreto.

Además puede detectar automáticamente el artista actual dentro de su ficha.

162. Dos catálogos independientes en la misma página

[sds_catalogo    prefijo="catalogo_principal"    cantidad="12"]

[sds_catalogo    prefijo="catalogo_secundario"    cantidad="6"    destacados="1"]

Cada listado tendrá sus propios parámetros:

catalogo_principal_tipocatalogo_principal_generocatalogo_principal_artistacatalogo_principal_page

catalogo_secundario_tipocatalogo_secundario_generocatalogo_secundario_artistacatalogo_secundario_page

163. Roster y catálogo en una misma página

[sds_artistas    prefijo="roster"]

[sds_catalogo    prefijo="catalogo"]

Es una de las configuraciones más recomendables cuando ambos componentes son interactivos.

164. Filtros precargados mediante URL

Supongamos:

[sds_catalogo prefijo="catalogo"]

Puede enlazarse directamente a:

/musica/?catalogo_tipo=album

/musica/?catalogo_genero=rock

/musica/?catalogo_artista=nombre-del-artista

o una combinación:

/musica/?catalogo_tipo=single&catalogo_genero=pop&catalogo_artista=nombre-del-artista

165. URLs compartibles

Como los filtros quedan reflejados en GET, un usuario puede copiar una URL como:

/musica/?catalogo_tipo=album&catalogo_genero=rock&catalogo_page=3

y otro visitante puede abrir directamente ese estado.

166. Cambio de filtro y página

Cuando se modifica un filtro, el plugin reinicia:

page = 1

Esto evita permanecer, por ejemplo, en la página 8 de un catálogo después de aplicar un filtro que solo contiene dos páginas.

167. Página solicitada fuera del rango real

Si:

?sds_page=15

pero después del filtro solo existen tres páginas, el servidor corrige la página al máximo válido.

En ese ejemplo:

168. Taxonomías iniciales de artista

El plugin crea inicialmente estos tipos de artista si no existen:

artistabandacompositorproductorproyecto

Por ejemplo:

/artistas/?sds_tipo=productor

169. Tipos iniciales de lanzamiento

El plugin crea inicialmente:

singleepalbumcolaboracion

Ejemplos:

/musica/?sds_tipo=single

/musica/?sds_tipo=album

Y para featured:

[sds_featured_release tipo="album"]

170. Géneros

La taxonomía:

sds_genero

se comparte entre:

sds_artistasds_lanzamiento

Pero la asignación es independiente.

Que un artista tenga género rock no añade automáticamente rock a todos sus lanzamientos.

Por tanto:

[sds_catalogo]

filtrado por género consulta el género asignado al lanzamiento.

Mientras:

[sds_artistas]

consulta el género asignado al artista.

171. Valores globales vs atributos locales

Supongamos que en Ajustes → SDS Content se configura:

Catálogo:cantidad = 24layout = gridcolumnas = 3

Entonces:

[sds_catalogo]

utilizará esos valores.

Pero:

[sds_catalogo cantidad="12"]

sobrescribe localmente cantidad.

[sds_catalogo    cantidad="12"    layout="row"]

sobrescribe ambos atributos.

172. Máximo global

Aunque se configure localmente:

[sds_catalogo cantidad="200"]

si:

General → Máximo por página = 48

se utilizarán:

Por tanto el techo efectivo es:

min(cantidad solicitada, máximo global)

con límite absoluto del sistema de:

173. Texto global vs texto local del CTA

Si globalmente:

Ver lanzamiento = Ver disco

entonces:

[sds_catalogo]

mostrará:

Ver disco

Pero:

[sds_catalogo texto_ver_lanzamiento="Abrir ficha"]

utilizará localmente:

Abrir ficha

174. Texto local del CTA de artistas

[sds_artistas    texto_ver_artista="Explorar artista"]

Solo afecta a esa instancia.

175. Textos que no son atributos locales de shortcode

El plugin contiene muchos textos globales configurables, por ejemplo:

TodosTodos los artistasFiltrarLimpiar filtrosExplorar discografíaExplorar catálogoVer plataformasEscucharEscuchar demoCerrarPróximo lanzamientoConEl artistaBiografíaMúsica y redesLa músicaSobre el lanzamientoEn las plataformasFicha del lanzamientoPausarCargando…Resultados actualizados.No se pudieron cargar los resultados.

No todos disponen de un atributo directo de shortcode.

Los overrides locales específicos que sí están previstos son:

texto_ver_artistatexto_ver_lanzamiento

El resto se administra mediante la configuración global de textos del plugin.

176. Atributos desconocidos

WordPress pasa los atributos al shortcode, pero el plugin utiliza una lista controlada.

Ejemplo:

[sds_catalogo color="red"]

color no forma parte del contrato y no modifica la consulta ni el template.

Igualmente:

[sds_artistas slider="1"]

no activa ningún slider.

177. El plugin no incorpora estos atributos

No existen, entre otros:

offsetidsexcludesearchkeywordcategoriatagautoplayslidercarouselorderby_metameta_keyinfinite_scrollload_more

Si se necesitan, requerirían modificación del plugin.

178. No existe filtro directo por género como atributo

No existe:

[sds_catalogo genero="rock"]

como atributo de consulta inicial.

El género se controla mediante el estado GET:

?sds_genero=rock

o mediante un prefijo personalizado:

?catalogo_genero=rock

179. No existe filtro directo por tipo en catálogo como atributo

En [sds_catalogo] no existe un atributo operativo:

tipo="album"

El tipo se establece mediante:

?sds_tipo=album

tipo como atributo forma parte específicamente de:

[sds_featured_release]

180. Preseleccionar un catálogo por tipo mediante enlace

Shortcode:

[sds_catalogo prefijo="music"]

URL:

/musica/?music_tipo=album

181. Preseleccionar género

/musica/?music_genero=electronic

182. Preseleccionar artista

/musica/?music_artista=nombre-del-artista

183. Combinar filtros iniciales

/musica/?music_tipo=single&music_genero=pop&music_artista=nombre-del-artista

184. Filtrar artistas por género y tipo

Shortcode:

[sds_artistas prefijo="roster"]

URL:

/artistas/?roster_tipo=productor&roster_genero=electronic

185. Consulta de destacados vs orden de destacados

Caso A:

[sds_catalogo destacados="1"]

Solo contenidos destacados.

Caso B:

[sds_catalogo ordenar_por="destacado" orden="DESC"]

Todos los contenidos, colocando primero los de mayor valor de destacado.

Caso C:

[sds_catalogo    destacados="1"    ordenar_por="fecha_lanzamiento"    orden="DESC"]

Solo destacados, ordenados por fecha.

186. Combinaciones válidas especialmente útiles

Home: tres artistas destacados

[sds_artistas    destacados="1"    cantidad="3"    filtros="0"]

Home: cuatro novedades

[sds_lanzamientos    cantidad="4"]

Página completa de música

[sds_featured_release]
[sds_lanzamientos cantidad="4"]
[sds_catalogo cantidad="12" prefijo="catalogo"]

Artistas ordenados alfabéticamente

[sds_artistas    ordenar_por="titulo"    orden="ASC"]

Catálogo por orden alfabético

[sds_catalogo    ordenar_por="titulo"    orden="ASC"]

Discografía en cuadrícula

[sds_discografia_artista    artista="123"    layout="grid"]

Último álbum

[sds_featured_release    criterio="tipo"    tipo="album"]

Último single de un artista

[sds_featured_release    criterio="reciente"    artista="123"    tipo="single"]

187. Combinaciones redundantes o poco útiles

`columnas` + `layout="row"`

[sds_catalogo    layout="row"    columnas="6"]

columnas deja de tener efecto visual porque cada fila ocupa col-12.

`filtro_artista="1"` + artista fijo

[sds_catalogo    artista="123"    filtro_artista="1"]

El selector de artista se oculta porque ya existe una restricción fija.

`cantidad` en featured

[sds_featured_release cantidad="10"]

No produce diez lanzamientos.

Featured fuerza:

cantidad = 1

`destacados` en featured

[sds_featured_release destacados="1"]

No es el mecanismo correcto.

Debe utilizarse:

[sds_featured_release criterio="destacado"]

188. Shortcode de artistas «todo terreno»

[sds_artistas    cantidad="12"    destacados="0"    prefijo="roster"    filtros="1"    filtro_tipo="1"    filtro_genero="1"    titulo="Artistas"    etiqueta="Roster"    mensaje_vacio="No encontramos artistas."    layout="grid"    variante="completa"    columnas="3"    columnas_tablet="2"    columnas_movil="1"    ordenar_por="manual"    orden="ASC"    paginador_adyacentes="2"    paginador_primera="1"    paginador_ultima="1"    paginador_anterior="1"    paginador_siguiente="1"    texto_ver_artista="Ver artista"]

189. Shortcode de catálogo «todo terreno»

[sds_catalogo    cantidad="18"    destacados="0"    prefijo="catalogo"    filtros="1"    filtro_tipo="1"    filtro_genero="1"    filtro_artista="1"    titulo="Catálogo"    etiqueta="SDS Records"    mensaje_vacio="No hay lanzamientos para estos filtros."    layout="grid"    variante="completa"    columnas="3"    columnas_tablet="2"    columnas_movil="1"    ordenar_por="fecha_lanzamiento"    orden="DESC"    paginador_adyacentes="2"    paginador_primera="1"    paginador_ultima="1"    paginador_anterior="1"    paginador_siguiente="1"    texto_ver_lanzamiento="Ver lanzamiento"]

190. Shortcode de novedades «todo terreno»

[sds_lanzamientos    cantidad="8"    destacados="0"    titulo="Últimos lanzamientos"    etiqueta="Novedades"    mensaje_vacio="Todavía no hay novedades."    layout="grid"    variante="completa"    columnas="4"    columnas_tablet="2"    columnas_movil="1"    ordenar_por="fecha_lanzamiento"    orden="DESC"    texto_ver_lanzamiento="Ver lanzamiento"]

Opcionalmente:

artista="123"

191. Shortcode de discografía «todo terreno»

[sds_discografia_artista    artista="123"    cantidad="12"    destacados="0"    prefijo="discografia"    filtros="1"    filtro_tipo="1"    filtro_genero="1"    filtro_artista="0"    titulo="Discografía"    etiqueta=""    mensaje_vacio="Todavía no hay lanzamientos."    layout="row"    variante="completa"    columnas="4"    columnas_tablet="2"    columnas_movil="1"    ordenar_por="fecha_lanzamiento"    orden="DESC"    paginador_adyacentes="2"    paginador_primera="1"    paginador_ultima="1"    paginador_anterior="1"    paginador_siguiente="1"    texto_ver_lanzamiento="Ver lanzamiento"]

192. Shortcode featured «todo terreno»

[sds_featured_release    criterio="destacado"    artista="123"    tipo="single"    titulo="Lanzamiento destacado"    etiqueta="SDS Records"    mensaje_vacio="No hay un lanzamiento disponible."    layout="row"    variante="completa"]

Para un ID concreto:

[sds_featured_release    criterio="id"    lanzamiento_id="456"    titulo="Selección especial"]

193. Tabla de valores permitidos

Atributo	Valores
`cantidad`	entero `1–200`, limitado además por máximo global
`destacados`	`0`, `1`
`filtros`	`0`, `1`
`filtro_tipo`	`0`, `1`
`filtro_genero`	`0`, `1`
`filtro_artista`	`0`, `1`
`layout`	`grid`, `row`
`variante`	`compacta`, `completa`
`columnas`	`1`, `2`, `3`, `4`, `6`
`columnas_tablet`	`1`, `2`, `3`, `4`, `6`
`columnas_movil`	`1`, `2`, `3`, `4`, `6`
`orden`	`ASC`, `DESC`
`paginador_adyacentes`	entero `0–10`
`paginador_primera`	`0`, `1`
`paginador_ultima`	`0`, `1`
`paginador_anterior`	`0`, `1`
`paginador_siguiente`	`0`, `1`
`criterio`	`destacado`, `reciente`, `id`, `artista`, `tipo`

194. Valores de `ordenar_por`

`[sds_artistas]`

manualtitulofecha_publicaciondestacado

Lanzamientos, catálogo y discografía

titulofecha_publicacionfecha_lanzamientodestacado

Featured no expone ordenar_por.

195. Comportamiento de `fecha_lanzamiento`

Cuando se ordenan lanzamientos por:

fecha_lanzamiento

el plugin emplea el metadato:

_sds_fecha_lanzamiento

y utiliza el ID como desempate.

Ejemplo:

[sds_catalogo    ordenar_por="fecha_lanzamiento"    orden="DESC"]

Resultado:

más reciente↓más antiguo

196. Desempates

Para ordenaciones normales por:

título;
fecha de publicación;
fecha de lanzamiento;

el ID utiliza la misma dirección elegida.

Para orden manual o destacado en artistas, el plugin añade como desempate:

post_title ASCID ASC

197. REST y seguridad de las vistas dinámicas

El endpoint utilizado es:

sds/v1/results

Solo admite estas vistas:

artistascatalogodiscografia_artista

El servidor vuelve a normalizar la configuración recibida.

No convierte los atributos del visitante directamente en parámetros SQL arbitrarios.

198. Caché REST

La respuesta del endpoint utiliza aproximadamente:

Cache-Control: private, max-age=30, stale-while-revalidate=30

Además existe caché interna de aproximadamente 30 segundos para resultados equivalentes.

199. Cachés completas de página y CDN

Si se utiliza una caché HTML completa o CDN, debe comprobarse que varíe por parámetros como:

sds_tiposds_generosds_artistasds_page

o los equivalentes según prefijo.

De lo contrario un estado filtrado podría servirse incorrectamente para otras URLs.

200. Purga de caché y fechas futuras

Si un lanzamiento debe aparecer automáticamente cuando llegue su fecha de lanzamiento, una caché HTML externa puede seguir mostrando una versión antigua.

Por tanto conviene purgar la caché:

al publicar;
al editar;
cuando llegue una fecha programada relevante.

201. Qué shortcode usar según el objetivo

Necesidad	Shortcode recomendado
Página de artistas	`[sds_artistas]`
Tres artistas destacados en home	`[sds_artistas destacados="1" cantidad="3" filtros="0"]`
Último lanzamiento destacado	`[sds_featured_release]`
Último lanzamiento de un artista	`[sds_featured_release criterio="artista" artista="ID"]`
Un lanzamiento concreto	`[sds_featured_release criterio="id" lanzamiento_id="ID"]`
Último single	`[sds_featured_release criterio="tipo" tipo="single"]`
Últimas cuatro novedades	`[sds_lanzamientos cantidad="4"]`
Catálogo completo	`[sds_catalogo]`
Catálogo con filtros	`[sds_catalogo filtros="1"]`
Discografía de artista	`[sds_discografia_artista artista="ID"]`
Discografía dentro de la ficha	`[sds_discografia_artista]`

202. Recetas prácticas

Página `/artistas/`

[sds_artistas    prefijo="roster"    cantidad="12"    layout="grid"    columnas="3"    columnas_tablet="2"    columnas_movil="1"    ordenar_por="manual"    orden="ASC"    filtros="1"]

Página `/musica/`

[sds_featured_release    criterio="destacado"]

[sds_lanzamientos    cantidad="4"]

[sds_catalogo    prefijo="catalogo"    cantidad="12"    filtros="1"]

Home

[sds_featured_release    criterio="destacado"]

[sds_artistas    destacados="1"    cantidad="3"    filtros="0"    titulo="Artistas destacados"    etiqueta="SDS"]

[sds_lanzamientos    cantidad="4"    titulo="Novedades"    etiqueta="SDS"]

Página personalizada de artista

[sds_featured_release    criterio="reciente"    artista="123"    titulo="Último lanzamiento"]

[sds_discografia_artista    artista="123"    prefijo="discografia"]

203. Errores frecuentes

Error: intentar filtrar catálogo con atributo `tipo`

Incorrecto:

[sds_catalogo tipo="album"]

Para catálogo utiliza:

?sds_tipo=album

o el prefijo correspondiente.

Error: usar `cantidad` con featured

[sds_featured_release cantidad="4"]

Featured siempre devuelve uno.

Error: esperar paginación en novedades

[sds_lanzamientos cantidad="20"]

puede mostrar 20 elementos, pero no genera paginador.

Si se necesita paginación:

[sds_catalogo]

Error: usar búsqueda parcial de artista

?sds_artista=juan

no necesariamente encuentra:

Juan Pérez

Debe utilizarse nombre exacto o slug exacto.

Error: dos listados dinámicos con el mismo prefijo

[sds_artistas]
[sds_catalogo]

Ambos usan sds y pueden compartir estado.

Mejor:

[sds_artistas prefijo="roster"]
[sds_catalogo prefijo="catalogo"]

Error: esperar seis columnas con `layout="row"`

[sds_catalogo layout="row" columnas="6"]

row fuerza cada entrada a ocupar una fila.

204. Referencia ultrarrápida

Artistas

[sds_artistas    cantidad=""    destacados=""    prefijo=""    filtros=""    filtro_tipo=""    filtro_genero=""    titulo=""    etiqueta=""    mensaje_vacio=""    layout=""    variante=""    columnas=""    columnas_tablet=""    columnas_movil=""    ordenar_por=""    orden=""    paginador_adyacentes=""    paginador_primera=""    paginador_ultima=""    paginador_anterior=""    paginador_siguiente=""    texto_ver_artista=""]

Lanzamientos

[sds_lanzamientos    cantidad=""    destacados=""    artista=""    titulo=""    etiqueta=""    mensaje_vacio=""    layout=""    variante=""    columnas=""    columnas_tablet=""    columnas_movil=""    ordenar_por=""    orden=""    texto_ver_lanzamiento=""]

Catálogo

[sds_catalogo    cantidad=""    destacados=""    artista=""    prefijo=""    filtros=""    filtro_tipo=""    filtro_genero=""    filtro_artista=""    titulo=""    etiqueta=""    mensaje_vacio=""    layout=""    variante=""    columnas=""    columnas_tablet=""    columnas_movil=""    ordenar_por=""    orden=""    paginador_adyacentes=""    paginador_primera=""    paginador_ultima=""    paginador_anterior=""    paginador_siguiente=""    texto_ver_lanzamiento=""]

Discografía

[sds_discografia_artista    artista=""    cantidad=""    destacados=""    prefijo=""    filtros=""    filtro_tipo=""    filtro_genero=""    filtro_artista=""    titulo=""    etiqueta=""    mensaje_vacio=""    layout=""    variante=""    columnas=""    columnas_tablet=""    columnas_movil=""    ordenar_por=""    orden=""    paginador_adyacentes=""    paginador_primera=""    paginador_ultima=""    paginador_anterior=""    paginador_siguiente=""    texto_ver_lanzamiento=""]

Featured

[sds_featured_release    criterio=""    lanzamiento_id=""    artista=""    tipo=""    titulo=""    etiqueta=""    mensaje_vacio=""    layout=""    variante=""]

205. Cheat sheet final

Artistas estándar

[sds_artistas]

Artistas destacados

[sds_artistas destacados="1" cantidad="3" filtros="0"]

Artistas alfabéticos

[sds_artistas ordenar_por="titulo" orden="ASC"]

Último destacado

[sds_featured_release]

Último lanzamiento

[sds_featured_release criterio="reciente"]

Lanzamiento por ID

[sds_featured_release criterio="id" lanzamiento_id="123"]

Último lanzamiento de artista

[sds_featured_release criterio="artista" artista="123"]

Último single

[sds_featured_release criterio="tipo" tipo="single"]

Último single de artista

[sds_featured_release criterio="reciente" artista="123" tipo="single"]

Novedades

[sds_lanzamientos cantidad="4"]

Novedades destacadas

[sds_lanzamientos destacados="1" cantidad="4"]

Novedades de artista

[sds_lanzamientos artista="123" cantidad="4"]

Catálogo

[sds_catalogo]

Catálogo grid

[sds_catalogo layout="grid" columnas="4"]

Catálogo sin filtros

[sds_catalogo filtros="0"]

Catálogo de artista

[sds_catalogo artista="123"]

Discografía por ID

[sds_discografia_artista artista="123"]

Discografía por slug

[sds_discografia_artista artista="slug-del-artista"]

Discografía automática en ficha

[sds_discografia_artista]

206. Conclusión

SDS Content 1.5.1 tiene cinco shortcodes, pero se pueden cubrir cuatro patrones principales:

Roster: [sds_artistas]
Elemento musical protagonista: [sds_featured_release]
Novedades finitas: [sds_lanzamientos]
Exploración completa: [sds_catalogo]
Obra de un artista: [sds_discografia_artista]

La principal diferencia arquitectónica está entre las vistas dinámicas:

sds_artistassds_catalogosds_discografia_artista

y las estáticas:

sds_lanzamientossds_featured_release

Las primeras admiten estado mediante URL, REST, filtros y/o paginación. Las segundas están concebidas como bloques editoriales finitos.

Para varias instancias dinámicas en una página, la regla más importante es utilizar prefijo diferente:

[sds_artistas prefijo="roster"]
[sds_catalogo prefijo="catalogo"]

Y para seleccionar un artista, puede utilizarse:

IDslug exactonombre exacto

mientras que los filtros por tipo y género de los listados dinámicos se expresan mediante parámetros GET, no mediante atributos tipo o genero.

Fin del manual.

Manual de shortcodes — SDS Content

1. Introducción

2. Requisitos de funcionamiento

3. Resumen rápido de los cinco shortcodes

Artistas

Lanzamiento destacado

Novedades

Catálogo

Discografía

4. Atributos generales

cantidad

5. destacados

Importante

6. titulo

7. etiqueta

8. mensaje_vacio

9. layout

Comportamiento por vista

Artistas + grid

Artistas + row

Lanzamientos + grid

Lanzamientos + row

Catálogo + grid

Catálogo + row

Discografía + grid

Discografía + row

Featured + row

Featured + grid

10. variante

completa

compacta

11. Columnas

Defaults

Artistas

Lanzamientos, catálogo y discografía

Con layout="row"

Featured

12. Ordenación: ordenar_por

Artistas

Lanzamientos, catálogo y discografía

13. Dirección: orden

14. Orden manual de artistas

15. Ordenar por destacado

16. Filtros

17. filtros

Importante

18. filtro_tipo

19. filtro_genero

20. filtro_artista

21. Artista fijo vs filtro de artista

22. Parámetros GET utilizados por los filtros

23. prefijo

24. Dos listados en la misma página

25. Qué ocurre si dos bloques tienen el mismo prefijo

26. Normalización de prefijo

27. Paginación

28. paginador_adyacentes

29. paginador_primera

30. paginador_ultima

31. paginador_anterior

32. paginador_siguiente

33. Paginador completo tradicional

34. Paginador mínimo

35. Límite de página

36. CTA de artista: texto_ver_artista

37. CTA de lanzamiento: texto_ver_lanzamiento

38. [sds_artistas]

Uso básico

39. Todos los atributos útiles de [sds_artistas]

40. Ejemplo: roster normal

41. Ejemplo: roster alfabético

42. Ejemplo: roster horizontal

43. Ejemplo: roster compacto

44. Ejemplo: cuatro columnas

45. Ejemplo: solo artistas destacados

46. Ejemplo: artistas destacados para home

47. Ejemplo: solo filtro de género

48. Ejemplo: sin filtros

49. Ejemplo: paginador completo

50. Particularidades de [sds_artistas]

`cantidad`

5. `destacados`

6. `titulo`

7. `etiqueta`

8. `mensaje_vacio`

9. `layout`

Artistas + `grid`

Artistas + `row`

Lanzamientos + `grid`

Lanzamientos + `row`

Catálogo + `grid`

Catálogo + `row`

Discografía + `grid`

Discografía + `row`

Featured + `row`

Featured + `grid`

10. `variante`

`completa`

`compacta`

Con `layout="row"`

12. Ordenación: `ordenar_por`

13. Dirección: `orden`

17. `filtros`

18. `filtro_tipo`

19. `filtro_genero`

20. `filtro_artista`

23. `prefijo`

26. Normalización de `prefijo`

28. `paginador_adyacentes`

29. `paginador_primera`

30. `paginador_ultima`

31. `paginador_anterior`

32. `paginador_siguiente`

36. CTA de artista: `texto_ver_artista`

37. CTA de lanzamiento: `texto_ver_lanzamiento`

38. `[sds_artistas]`

39. Todos los atributos útiles de `[sds_artistas]`

50. Particularidades de `[sds_artistas]`

51. `[sds_lanzamientos]`

52. Todos los atributos útiles de `[sds_lanzamientos]`

64. Atributos sin efecto práctico en `[sds_lanzamientos]`

65. `[sds_catalogo]`

66. Todos los atributos útiles de `[sds_catalogo]`

79. `[sds_discografia_artista]`

84. Todos los atributos útiles de `[sds_discografia_artista]`

92. `[sds_featured_release]`

93. Todos los atributos útiles de `[sds_featured_release]`

94. `criterio`

95. `criterio="destacado"`

97. `criterio="reciente"`

99. `criterio="id"`

100. `criterio="artista"`

103. `criterio="tipo"`

104. `tipo`

114. Resolución del atributo `artista`