Dokumentacja shortcode'ów

5 min read

Dostępne są trzy shortcode'y. Większość użytkowników potrzebuje tylko [mementor-tts]. Pozostałe dwa służą do zaawansowanych przypadków.

[mementor-tts]

Główny shortcode audio. Opakowuje tekst, który ma być narrated, i umieszcza odtwarzacz nad tym tekstem.

Podstawowe użycie

[mementor-tts]Twój tekst tutaj.[/mementor-tts]

Z atrybutami

[mementor-tts voice="IKne3meq5aSn9XLyUdCD" model="eleven_flash_v2_5" label="Posłuchaj tego" autoplay="no" download="yes" loop="no" time_display="yes" speed_control="yes" volume_control="yes" information="no"]
Twój tekst tutaj.
[/mementor-tts]

Atrybuty

Atrybut Wartości Domyślna Opis
voice ID głosu domyślna witryny Zastępuje głos dla tego shortcode'a
model eleven_flash_v2_5 itp. domyślna witryny Zastępuje model ElevenLabs
label Dowolny tekst puste Wyświetla się nad odtwarzaczem
autoplay yes / no no Odtwarza automatycznie po załadowaniu strony
download yes / no domyślna witryny Pokazuje przycisk pobierania
loop yes / no no Zapętla audio
time_display yes / no domyślna witryny Pokazuje czas i czas trwania
speed_control yes / no domyślna witryny Pokazuje selektor prędkości
volume_control yes / no domyślna witryny Pokazuje suwak głośności
information yes / no domyślna witryny Pokazuje ikonę informacji

Przykłady

Prosty blok audio:

[mementor-tts]Cześć, to jest test.[/mementor-tts]

Niestandardowa etykieta i autoodtwarzanie:

[mementor-tts label="Wiadomość powitalna" autoplay="yes"]
Witamy na naszej stronie.
[/mementor-tts]

Inny głos dla konkretnej sekcji:

[mementor-tts voice="EXAVITQu4vr4xnSDxMaL"]
Ten akapit używa innego głosu.
[/mementor-tts]

[tts_player]

Wyświetla odtwarzacz audio dla wygenerowanego audio istniejącego wpisu. Użyj go, gdy chcesz umieścić odtwarzacz w niestandardowym miejscu za pomocą shortcode'a.

Podstawowe użycie

[tts_player]

Umieszczony wewnątrz wpisu lub strony, odwołuje się do audio tego wpisu. Umieszczony w szablonie (przez do_shortcode()), przekaż ID wpisu jawnie.

Atrybuty

Atrybut Wartości Opis
id ID wpisu Odwołuje się do audio konkretnego wpisu
lang kod języka Dla witryn wielojęzycznych - wybiera język

Przykłady

Domyślnie (używa audio bieżącego wpisu):

[tts_player]

Konkretny wpis:

[tts_player id="123"]

Konkretny język (WPML/Weglot):

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

[mementor_raw]

Przekazuje surowy tekst do ElevenLabs z pominięciem standardowego czyszczenia TTSWP (bez usuwania selektorów CSS, bez escapowania shortcode'ów). Tylko do zaawansowanego użytku.

Użycie

[mementor_raw]
Twój surowy tekst omijający wszystkie filtry TTSWP.
[/mementor_raw]

Użyj [mementor_raw] wewnątrz bloku [mementor-tts], gdy potrzebujesz precyzyjnej kontroli nad tym, co trafia do syntezy:

[mementor-tts]
Zdanie wprowadzające.
[mementor_raw]<phoneme alphabet="ipa" ph="təˈmeɪtoʊ">tomato</phoneme>[/mementor_raw]
Reszta tekstu.
[/mementor-tts]

W szablonach motywu

Aby użyć dowolnego shortcode'a z szablonu PHP:

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

Powiązane strony