Referência de shortcodes

5 min read

Três shortcodes estão disponíveis. A maioria dos usuários só precisa do [mementor-tts]. Os outros dois são para casos avançados.

[mementor-tts]

O shortcode de áudio principal. Envolve o texto que deve ser narrado e exibe um player acima do texto.

Uso básico

[mementor-tts]Seu texto vai aqui.[/mementor-tts]

Com atributos

[mementor-tts voice="IKne3meq5aSn9XLyUdCD" model="eleven_flash_v2_5" label="Ouça isto" autoplay="no" download="yes" loop="no" time_display="yes" speed_control="yes" volume_control="yes" information="no"]
Seu texto vai aqui.
[/mementor-tts]

Atributos

Atributo Valores Padrão Descrição
voice ID de voz padrão do site Substitui a voz para este shortcode
model eleven_flash_v2_5, etc. padrão do site Substitui o modelo do ElevenLabs
label Qualquer texto vazio Exibido acima do player
autoplay yes / no no Inicia a reprodução ao carregar a página
download yes / no padrão do site Exibe o botão de download
loop yes / no no Reproduz o áudio em loop
time_display yes / no padrão do site Exibe o tempo e a duração
speed_control yes / no padrão do site Exibe o seletor de velocidade
volume_control yes / no padrão do site Exibe o controle de volume
information yes / no padrão do site Exibe o ícone de informações

Exemplos

Bloco de áudio simples:

[mementor-tts]Olá, isto é um teste.[/mementor-tts]

Label personalizado e autoplay:

[mementor-tts label="Mensagem de boas-vindas" autoplay="yes"]
Bem-vindo ao nosso site.
[/mementor-tts]

Voz diferente para uma seção específica:

[mementor-tts voice="EXAVITQu4vr4xnSDxMaL"]
Este parágrafo usa uma voz diferente.
[/mementor-tts]

[tts_player]

Renderiza o player de áudio para o áudio gerado de um post existente. Use quando quiser posicionar o player em um local fora do padrão via shortcode.

Uso básico

[tts_player]

Quando inserido em um post ou página, referencia o áudio daquele post. Quando usado em um template via do_shortcode(), passe o ID do post explicitamente.

Atributos

Atributo Valores Descrição
id ID do post Referencia o áudio de um post específico
lang código de idioma Para sites multilíngues, seleciona um idioma

Exemplos

Padrão (usa o áudio do post atual):

[tts_player]

Post específico:

[tts_player id="123"]

Idioma específico (WPML/Weglot):

[tts_player id="123" lang="es"]

[mementor_raw]

Envia texto bruto diretamente ao ElevenLabs sem o processamento padrão do TTSWP (sem remoção de seletores CSS, sem escape de shortcodes). Apenas para uso avançado.

Uso

[mementor_raw]
Seu texto bruto que ignora todos os filtros do TTSWP.
[/mementor_raw]

Use [mementor_raw] dentro de um bloco [mementor-tts] quando precisar de controle preciso sobre o que é enviado para a síntese:

[mementor-tts]
Frase de introdução.
[mementor_raw]<phoneme alphabet="ipa" ph="təˈmeɪtoʊ">tomato</phoneme>[/mementor_raw]
Resto do texto.
[/mementor-tts]

Em templates de tema

Para usar qualquer shortcode em um template PHP:

<?php echo do_shortcode('[tts_player id="' . get_the_ID() . '"]'); ?>

Páginas relacionadas