ショートコードリファレンス

5 min read

利用できるショートコードは3つです。ほとんどのユーザーは [mementor-tts] だけで十分です。残り2つは高度な用途向けです。

[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]

TTSWPの標準クリーンアップ(CSSセレクターの除去、ショートコードエスケープなど)をスキップして、生のテキストをElevenLabsに直接渡します。高度な用途専用です。

使い方

[mementor_raw]
TTSWPの全フィルターをバイパスする生テキスト。
[/mementor_raw]

音声合成に送るテキストを細かく制御したい場合は、[mementor-tts] ブロック内で [mementor_raw] を使います。

[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() . '"]'); ?>

関連ページ