短代码参考

5 min read

共有三个短代码可用。大多数用户只需使用 [mementor-tts],其余两个适用于进阶场景。

[mementor-tts]

主音频短代码。包裹需要朗读的文本,并在文本上方插入播放器。

基本用法

[mementor-tts]在此输入您的文本。[/mementor-tts]

带属性用法

[mementor-tts voice="IKne3meq5aSn9XLyUdCD" model="eleven_flash_v2_5" label="收听" autoplay="no" download="yes" loop="no" time_display="yes" speed_control="yes" volume_control="yes" information="no"]
在此输入您的文本。
[/mementor-tts]

属性说明

属性 默认值 描述
voice 声音 ID 站点默认 覆盖此短代码的声音
model eleven_flash_v2_5 站点默认 覆盖 ElevenLabs 模型
label 任意文本 显示在播放器上方
autoplay yes / no no 页面加载时自动播放
download yes / no 站点默认 显示下载按钮
loop yes / no no 循环播放音频
time_display yes / no 站点默认 显示时间和时长
speed_control yes / no 站点默认 显示速度选择器
volume_control yes / no 站点默认 显示音量滑块
information yes / no 站点默认 显示信息图标

示例

简单音频块:

[mementor-tts]你好,这是一段测试。[/mementor-tts]

自定义标签并自动播放:

[mementor-tts label="欢迎语" autoplay="yes"]
欢迎访问我们的网站。
[/mementor-tts]

为特定段落使用不同声音:

[mementor-tts voice="EXAVITQu4vr4xnSDxMaL"]
此段落使用不同的声音。
[/mementor-tts]

[tts_player]

为现有文章已生成的音频渲染播放器。当您需要通过短代码将播放器放置在非默认位置时使用。

基本用法

[tts_player]

放置在文章或页面内时,会引用该文章的音频。通过 do_shortcode() 在模板中使用时,请明确传入文章 ID。

属性说明

属性 描述
id 文章 ID 引用特定文章的音频
lang 语言代码 多语言站点可指定语言

示例

默认(使用当前文章的音频):

[tts_player]

指定文章:

[tts_player id="123"]

指定语言(WPML/Weglot):

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

[mementor_raw]

将原始文本直接传递给 ElevenLabs,跳过 TTSWP 的标准清理流程(不进行 CSS 选择器过滤,不进行短代码转义)。仅适用于进阶场景。

用法

[mementor_raw]
您的原始文本,绕过所有 TTSWP 过滤器。
[/mementor_raw]

当您需要精确控制传入合成引擎的内容时,可将 [mementor_raw] 嵌套在 [mementor-tts] 块内:

[mementor-tts]
开头句子。
[mementor_raw]<phoneme alphabet="ipa" ph="təˈmeɪtoʊ">tomato</phoneme>[/mementor_raw]
其余文本内容。
[/mementor-tts]

在主题模板中使用

在 PHP 模板中使用任意短代码:

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

相关页面