How-tos
Coloca un widget personalizado (reproductor) en el pie de página, la barra lateral o cualquier otro lugar del diseño.
A Ubicación personalizada de widgets te permite colocar un reproductor completo / botón / círculo en cualquier lugar que tu diseño lo permita (pie de página, barra lateral, tira de encabezado o un bloque HTML personalizado) mientras sigues controlando Lo que se narra. Dos campos realizan el mapeo: Elemento de renderizado (donde aparece el jugador) y Selector de contenido (qué texto se lee).
- ¿Por qué es útil? — La interfaz de usuario puede ubicarse fuera del cuerpo del artículo (pie de página fijo, botón de llamada a la acción en la barra lateral) sin cambiar la forma en que se selecciona el contenido.
- Elemento de renderizado — Selector CSS para el soporte/contenedor donde se inyecta la interfaz de usuario del jugador.
- Selector de contenido — Selector CSS (o parent_class / self_class) para el texto que se convierte en audio.
- La misma idea se aplica a HTML y constructores. — Los soportes HTML personalizados en HTML / Wix / Shopify / Squarespace utilizan el mismo par de campos.
Consola de Open Cloud
Guía de conexión HTML
Todos los tutoriales
Relacionado:
Llamada desde HTML
Texto de contenido independiente
Widget de varias páginas
códigos cortos predeterminados
Global frente a personalizado
El reproductor no se muestra
Crear reproductor completo
Crear reproductor de botones
Mapeo
Elemento de renderizado vs. Selector de contenido
- Elemento de renderizado = lugar. Ejemplos de montajes: .gsp_full_player, .gsp_button_player, .gsp_circle_player — o un nodo de diseño como #footer-listen.
- Selector de contenido = qué leer. Uno o varios objetivos, separados por comas — p. ej. #main or #intro,.product-description,#specs.
- clase_padre — leer el elemento principal del montaje (útil cuando el montaje se encuentra dentro del bloque de contenido).
- auto_clase — lee el mismo contenedor en el que se encuentra el soporte.
- Lista de exclusión — también separados por comas; omitir navegación, anuncios y comentarios dentro del contenido seleccionado (por ejemplo #comments,.ads,.share-buttons).
Regla de oro: El selector de contenido apunta al texto que usted controla; el elemento de renderizado apunta al soporte (o contenedor) vacío donde debe aparecer el jugador.
Valores HTML
Cómo escribir id, clase y comas
No necesitas conocer HTML a fondo; recuerda dos prefijos y luego ensambla o recorta con comas:
- id → # - id="footer-listen" → #footer-listen.
- clase → . - class="gsp_button_player" → .gsp_button_player.
- Solo etiqueta - article, section, h1 (sin prefijo).
- Reúne las piezas — El selector de contenido puede listar varios contenedores: #intro,.body,#cta-note.
- Recortar piezas — La lista de exclusión utiliza el mismo # / . + comas. Ver Lista de exclusión y sin discurso y la guía de llamadas HTML Valores HTML .
- Encuéntralos — Haz clic con el botón derecho en el bloque de la página en vivo → Inspeccionar → Copiar id / class en la consola con el prefijo correcto.
La voz, el idioma y la mayoría de las opciones de Chrome del reproductor siguen siendo las mismas que las del sitio web. Configuración cuando el campo del widget dice Utilice Global — La ubicación no obliga a usar una voz personalizada. Ver Configuración global frente a configuración personalizada.
Configuración
Cómo colocar un widget personalizado
- Asegúrese de que el código de conexión del sitio (o la integración con WordPress/CMS) esté activo.
- Agregue un soporte vacío donde debería aparecer el jugador, por ejemplo <div class="gsp_button_player"></div> En el pie de página o en la barra lateral, HTML personalizado.
- En la consola de Cloud, abra (o cree) el widget Full / Button / Circle correspondiente y Publicar él.
- Establecer Elemento de renderizado a la clase de montaje (por ejemplo .gsp_button_player).
- Establecer Selector de contenido al envoltorio del artículo/producto (o varias piezas con comas, por ejemplo) #intro,.entry-content). Mantener parent_class cuando el soporte se encuentra dentro de ese contenido. Recuerda: id → #, class → ..
- Opcional: Lista de exclusión (separados por comas, lo mismo) # / . reglas) y URL permitidas/bloqueadas para que el reproductor solo aparezca donde usted desee.
- Guarda los cambios, vuelve a cargar la página en directo y confirma que el reproductor aparece en la ubicación personalizada mientras lee el contenido correcto.
Ejemplos
Diseños comunes
- Botón de escucha en la barra lateral — Elemento de renderizado .gsp_button_player en la barra lateral; Selector de contenido article or .entry-content.
- Franja de pie de página — montaje en la plantilla del pie de página; Content Selector sigue apuntando al artículo principal, por lo que no se menciona el elemento de la página de página.
- Constructor de HTML personalizado — mismos soportes en Wix / Shopify / Squarespace Código personalizado / bloques HTML; clases de mapeo exactamente como en el Guía HTML.
Preguntas Frecuentes
Preguntas frecuentes sobre widgets personalizados
-
Primero, verifica el elemento de renderizado: la clase de montaje debe existir en esa página y coincidir con el widget. Confirma también que el widget esté publicado y que las reglas de permitir/bloquear URL no lo estén ocultando.
-
Sí. Un widget publicado puede ocupar todos los puntos de montaje de Render Element compatibles permitidos por tus reglas de URL. Crea widgets adicionales solo cuando la voz, el diseño o los selectores deban ser diferentes.