Audio Folder Suite – Reproductor de álbumes, Compartir, SEO y Sitemap de pistas en un solo plugin

Con Audio Folder Suite ya no necesitas un paquete de plugins: obtienes un reproductor rápido de álbumes/listas de reproducción, hermosas páginas para compartir pistas individuales, metadatos OG/Twitter limpios (incluyendo favicon por pista) y un sitemap de pistas propio – todo ligero, amigable para rastreadores y compatible con Rank Math (Free).

---

Características destacadas

• Reproductor rápido de álbumes/listas de reproducción (SSR + JS): Búsqueda, clasificación, atajos de teclado, deslizamiento móvil.

• Mejor UX: Carátula, título y favicon se establecen inmediatamente – el audio carga después.

• Páginas para compartir por pista (/share/?track=…), perfectas para Facebook, X/Twitter, WhatsApp y Google.

• Lógica de imagen OG/Twitter: siempre primero la carátula de la pista, de lo contrario, la predeterminada del álbum (1200×630).

• Descripción inteligente (≈160 caracteres):
  ©Año, Compositor, Artista – Título / mm:ss / Género / Álbum
  Si hay espacio: , mp3, , wav, , descarga, , escuchar.

• Favicons por pista (16–512px), prácticos en dispositivos móviles y accesos directos.

• Integración con Rank Math: Título/Descripción/OG/Canónica sobrescritos limpiamente.

• Sitemap de pistas propio: …/afs-tracks-sitemap.xml incluyendo <lastmod>; entrada opcional en el índice de Rank Math.

• Sin bloqueo de tema (Divi, Block-Themes, Classic) y compatible con caché/CDN.

---

Inicio rápido (en 5 minutos)

1. Crear carpeta de álbum (ej.):

2. Rellenar musicData.json (ver ejemplo más abajo).

3. Insertar este shortcode en tu página/entrada:

4. Guardar permalinks (Ajustes → Permalinks → "Guardar cambios"), para que:

• URLs de compartir bonitas y

• https://tu-sitio.tld/afs-tracks-sitemap.xml
  funcionen.

Listo – el reproductor más la magia de SEO/OG están activos. 🙂

---

Convención de carpetas y carátulas

• Carátulas de pistas: Solo introduces la ruta base en cover dentro de musicData.json.
  El plugin añade automáticamente los sufijos necesarios:

  • -48.jpg, -512.jpg, -1080.jpg, -1200x630.jpg

• Si falta una carátula de pista, el plugin utiliza los valores predeterminados del álbum en covers/default-cover-*.jpg.

---

musicData.json – Referencia de campos (Ejemplo)

Importante

• duration en segundos (visualización como mm:ss).

• cover sin sufijos – el plugin añade los tamaños.

• file/wav opcional → los botones de descarga se muestran automáticamente.

---

Shortcodes

Reproductor de álbumes/listas de reproducción (recomendado)

Compatibilidad (si está disponible)

---

Compartir pistas individuales

• URL para compartir (recomendado):
  https://tu-sitio.tld/tu-pagina-de-album/share/?track=<NombreDeArchivo.mp3>

• Enlace directo al reproductor:
  https://tu-sitio.tld/tu-pagina-de-album/?track=<NombreDeArchivo.mp3>

En el reproductor hay un botón "Compartir ahora" que copia la URL /share al portapapeles.

---

SEO y Social: así se construyen los metadatos

• Título
  Título – Nombre de la página | Libre de licencia … (ej. "Fanfarria de Alphorn, Resonet in laudibus – nuonu | Música navideña libre de licencia")

• Descripción (≈160 caracteres, dinámica)
  ©Año, Compositor, Artista – Título / mm:ss / Género / Álbum
  Si aún hay espacio: , mp3, , wav, , descarga, , escuchar

• OG/Twitter

  • Imagen: Carátula de pista -1200x630.jpg, alternativa predeterminada del álbum

  • Tipo: music.song

  • Alt: Artista – Título

  • URL/Canónica: URL correcta para compartir o del reproductor

• Favicon por pista
  Para pestañas/accesos directos, el plugin establece favicons basándose en la carátula de 512px.

Todo se genera en el lado del servidor – los bots ven inmediatamente las etiquetas finales (compatible con caché, no se necesita JS).

---

Sitemap de pistas

• Acceso:
  https://tu-sitio.tld/afs-tracks-sitemap.xml
  (alternativamente funcionan /afs-tracks-sitemap y /?afs_tracks_sitemap=1)

• Contenido: Todos los enlaces para compartir pistas individuales, incluyendo <lastmod> (del timestamp o mtime de musicData.json).

• Índice de Rank Math: Puede incluirse automáticamente en …/sitemap_index.xml – alternativamente, enviarlo por separado en Search Console.

Nota: Después de (des)activar, guardar permalinks para que la URL amigable funcione.

---

Funcionamiento y UX

• Búsqueda por título/artista/álbum/género/comentario.

• Clasificación: Más recientes/Antiguas, Duración ↑/↓, Título A–Z/Z–A.

• Teclado: ←/→ cambiar pista, Espacio Reproducir/Pausar.

• Deslizar (móvil) en la carátula: adelante/atrás.

• Barra de progreso: actual / total / -restante.

• Descargas ZIP: Los tamaños se determinan mediante HEAD y se muestran en línea.

---

Rendimiento

• First Paint optimizado: Primero datos visuales (carátula/título/favicon), luego carga de audio.

• Lista de reproducción SSR: Sin JS, la página sigue siendo utilizable y rastreable.

• loading="lazy" y alternativas de carátula incluidas.

---

Solución de problemas

¿La imagen OG es del álbum en lugar de la pista?
Verifica cover y los archivos -1200x630.jpg, -512.jpg, -1080.jpg. Vacía la caché/CDN. La página /share muestra lo que ven los bots.

¿/afs-tracks-sitemap.xml devuelve 404?
Ajustes → Permalinks → "Guardar cambios". Si es necesario: vacía la caché de reescritura del servidor/hosting.

¿El tema (ej. Divi) escribe sus propias etiquetas OG?
Audio Folder Suite elimina las salidas conflictivas y proporciona OG a través del filtro de Rank Math. Asegúrate de que ningún otro plugin también establezca OG/Twitter.

---

Requisitos del sistema

• WordPress 6.x

• PHP 8.0+ recomendado

• Rank Math (Gratis) opcional, compatible – no es obligatorio.

---

Preguntas frecuentes

¿Tengo que mantener musicData.json manualmente?
Puedes hacerlo – o usar el generador integrado (si está activado). Ambas opciones son posibles.

¿Cómo se obtiene la visualización mm:ss?
duration en segundos → el plugin renderiza automáticamente mm:ss.

¿Otros tamaños de imagen?
Puedes proporcionar tamaños adicionales; los sufijos importantes son -48/-512/-1080/-1200x630.

¿Por qué /share a veces difiere del reproductor?
/share es una metapágina optimizada para bots (OG/Twitter, datos estructurados). El reproductor utiliza la misma lógica, pero con URL del reproductor e interfaz de usuario interactiva.

---

Registro de cambios (Breve)

1.0.2

• Consolidación: Reproductor, SEO/OG, Favicons, Compartir, Sitemap en un solo plugin.

• UI/UX: Datos visuales antes de la carga de audio; Deslizamiento/Teclado; Tamaños ZIP.

• SEO: Ajuste de Título/Descripción (coma después del Compositor, mm:ss, Álbum, mp3/wav/descarga/escuchar).

• Sitemap: afs-tracks-sitemap.xml + entrada opcional en el índice de Rank Math.

---

Ejemplos

Shortcode

URL para compartir

Sitemap

---

Si lo deseas, puedo adaptar el texto a tu tono (más corto/más orientado al marketing) o añadir capturas de pantalla y resaltados de código.