How-tos
Insira um widget personalizado — o player — no rodapé, na barra lateral ou em qualquer outro local do layout.
A posicionamento de widget personalizado Permite inserir um player Full/Button/Circle em qualquer lugar que seu layout permita — rodapé, barra lateral, cabeçalho ou bloco HTML personalizado — mantendo o controle. o que é narrado. Dois campos fazem o mapeamento: Elemento de renderização (onde o jogador aparece) e Seletor de conteúdo (Qual texto foi lido).
- Por que é útil? — A interface de usuário do Listen pode ficar fora do corpo do artigo (rodapé fixo, CTA na barra lateral) sem alterar a forma como o conteúdo é selecionado.
- Elemento de renderização — Seletor CSS para o ponto de montagem/container onde a interface do player é injetada.
- Seletor de conteúdo — Seletor CSS (ou parent_class / self_class) para o texto que se transforma em áudio.
- A mesma ideia se aplica ao HTML e aos construtores. — Os elementos HTML personalizados em HTML / Wix / Shopify / Squarespace usam o mesmo par de campos.
Abra o console do Cloud.
Guia de conexão HTML
Todos os tutoriais
Relacionado
Chamada a partir de HTML
Texto de conteúdo independente
Widget de várias páginas
Códigos curtos padrão
Global vs. personalizado
Jogador não aparece
Criar jogador completo
Criar jogador de botões
Mapeamento
Elemento de renderização vs. Seletor de conteúdo
- Elemento de renderização = local. Exemplos de montagens: .gsp_full_player, .gsp_button_player, .gsp_circle_player — ou um nó de layout como #footer-listen.
- Seletor de conteúdo = o que ler. Um ou vários alvos, separados por vírgula — por exemplo #main or #intro,.product-description,#specs.
- classe_pai — ler o elemento pai da montagem (útil quando a montagem está dentro do bloco de conteúdo).
- self_class — leia a mesma embalagem em que o suporte está inserido.
- Excluir lista — também separado por vírgulas; ignore a navegação, anúncios e comentários dentro do conteúdo selecionado (ex: #comments,.ads,.share-buttons).
Regra prática: O seletor de conteúdo aponta para o texto que você controla; o elemento de renderização aponta para o espaço vazio (ou contêiner) onde o reprodutor deve aparecer.
Valores HTML
Como escrever id, classe e vírgulas
Você não precisa ter um conhecimento profundo de HTML — lembre-se de dois prefixos e, em seguida, monte ou remova as vírgulas para separar os elementos:
- id → # - id="footer-listen" → #footer-listen.
- classe → . - class="gsp_button_player" → .gsp_button_player.
- Somente etiqueta - article, section, h1 (sem prefixo).
- Reúna as peças — O Seletor de Conteúdo pode listar vários contêineres: #intro,.body,#cta-note.
- Aparar peças — A lista de exclusão usa o mesmo # / . + vírgulas. Veja Lista de Exclusão e Sem Fala e o guia de chamadas HTML Valores HTML seção.
- Encontrá-los — Clique com o botão direito do mouse no bloco na página ativa → Inspecionar → copiar id / class no console com o prefixo correto.
Voz, idioma e a maioria dos players do Chrome ainda seguem o site. Configurações quando o campo do widget diz Usar global — O posicionamento não força uma voz personalizada. Veja Configurações globais versus configurações personalizadas.
instalação
Como inserir um widget personalizado
- Certifique-se de que o código de conexão do site (ou a integração com o WordPress/CMS) esteja ativo.
- Adicione uma montaria vazia onde o jogador deve aparecer — por exemplo <div class="gsp_button_player"></div> No rodapé ou na barra lateral, HTML personalizado.
- No Console da Nuvem, abra (ou crie) o widget correspondente (Full / Button / Circle) e Publicar .
- Conjunto Elemento de renderização para a classe de montagem (por exemplo, .gsp_button_player).
- Conjunto Seletor de conteúdo para a embalagem do artigo/produto (ou várias partes separadas por vírgulas, por exemplo) #intro,.entry-content). Manter parent_class quando o suporte estiver dentro desse conteúdo. Lembre-se: id → #, class → ..
- Opcional: Excluir lista (separados por vírgulas, iguais) # / . regras) e URLs permitidas/bloqueadas para que o player apareça apenas onde você deseja.
- Salve, atualize a página ao vivo e confirme se o player aparece no local personalizado enquanto lê o conteúdo correto.
Exemplos
Layouts comuns
- Botão de escuta na barra lateral — Elemento de renderização .gsp_button_player na barra lateral; Seletor de conteúdo article or .entry-content.
- Faixa de rodapé — montar no modelo de rodapé; o Seletor de Conteúdo ainda tem como alvo o artigo principal, portanto, o rodapé não é exibido.
- Construtor HTML personalizado — mesmas montagens em blocos de código personalizado/HTML do Wix/Shopify/Squarespace; mapeia classes exatamente como no Guia HTML.
Perguntas frequentes
Perguntas frequentes sobre widgets personalizados
-
Verifique primeiro o elemento de renderização — a classe de montagem deve existir nessa página e corresponder ao widget. Confirme também se o widget está publicado e se as regras de permissão/bloqueio de URL não o estão ocultando.
-
Sim. Um widget publicado pode preencher todos os espaços de renderização (Render Element) permitidos pelas suas regras de URL. Crie widgets adicionais somente quando o texto, o design ou os seletores precisarem ser diferentes.