📘 公式リファレンス🔧 リファレンス/フィルター中級
external_video_url フィルター(外部動画の URL を生成)
YouTube や Vimeo などの外部動画メディアについて、プレイヤーパラメータを指定した埋め込み URL を生成するフィルター。`external_video_tag` フィルターと組み合わせて使う。
用途
商品ページに YouTube 動画を埋め込むとき、再生色やループ・ミュート設定などのプレイヤーパラメータを動的に付与して URL を構成したい場合。
設置場所
商品メディアループ内で `{{ media | external_video_url: color: 'white' | external_video_tag }}` のように、メディアオブジェクトに対してパイプで繋ぎ、属性名と値をコロン区切りで指定する。
注意点
YouTube パラメータと Vimeo パラメータは異なるため、`media.host` で動画ホストを判定してから別々のパラメータセットを指定する必要がある。パラメータ値は文字列型で指定し、数値は引用符で囲む(例: `loop: '1'`)。external_video_tag フィルターとセットで初めて HTML 要素が生成されるため、URL のみ取得したい場合でもタグを組み合わせること。
仕様
30 行 / json{
"category": "media",
"deprecated": false,
"deprecation_reason": "",
"description": "",
"parameters": [],
"return_type": [
{
"type": "string",
"name": "",
"description": "",
"array_value": ""
}
],
"examples": [
{
"name": "",
"description": "You can specify [YouTube](https://developers.google.com/youtube/player_parameters#Parameters) and [Vimeo](https://vimeo.zendesk.com/hc/en-us/articles/360001494447-Using-Player-Parameters) video parameters by adding a parameter that matches the parameter name, and the desired value.\n",
"syntax": "",
"path": "/products/potion-beats",
"raw_liquid": "{% for media in product.media %}\n {% if media.media_type == 'external_video' %}\n {% if media.host == 'youtube' %}\n {{ media | external_video_url: color: 'white' | external_video_tag }}\n {% elsif media.host == 'vimeo' %}\n {{ media | external_video_url: loop: '1', muted: '1' | external_video_tag }}\n {% endif %}\n {% endif %}\n{% endfor %}",
"parameter": false,
"display_type": "text",
"show_data_tab": false
}
],
"summary": "Returns the URL for a given external video. Use this filter to specify parameters for the external video player generated\nby the [`external_video_tag` filter](/docs/api/liquid/filters/external_video_tag).",
"syntax": "media | external_video_url: attribute: string",
"name": "external_video_url"
}出典・ライセンス
- Repository:
- https://github.com/Shopify/theme-liquid-docs
- License:
- MIT
このコードは Shopify 著作の MIT ライセンスソースです。 原本の著作権は Shopify が保有します。日本語訳は ALSEL によるものです。
関連項目
📘 公式リファレンス🔧 リファレンス/フィルター初級
avatar フィルター(顧客アバター画像HTML生成)
顧客アバターが存在する場合、それを表示する HTML タグを生成するフィルター。customer オブジェクトに対して使用する。
📁 theme-liquid-docs·MIT·19 行
📘 公式リファレンス🔧 リファレンス/フィルター初級
default_errors フィルター(フォーム送信エラーを日本語化)
form.errors の各エラーコードに対応する既定のエラーメッセージを自動生成するフィルター。フォーム送信時の入力値不正や必須項目空白などのエラーを言語別に出力する。
📁 theme-liquid-docs·MIT·19 行
📘 公式リファレンス🔧 リファレンス/フィルター初級
date フィルター(日付を指定形式でフォーマット)
日付値を指定されたフォーマット文字列に従って整形する。フォーマット文字列が空の場合は元の値がそのまま返される。入力が日付に変換できない場合も元の値が返される。
📁 theme-liquid-docs·MIT·19 行
📘 公式リファレンス🔧 リファレンス/フィルター初級
payment_terms フィルター(Shop Pay分割払いバナーを生成)
product フォームまたは cart フォームに対して使用し、Shop Pay の分割払いオプションを表示するための HTML を生成するフィルター。顧客が購入時に分割払いプランを選択できるようにする。
📁 theme-liquid-docs·MIT·19 行
📘 公式リファレンス🔧 リファレンス/フィルター初級
abs フィルター(数値の絶対値を取得)
負の数を正の数に変換する。数値の絶対値(ゼロからの距離)を返すフィルター。
📁 theme-liquid-docs·MIT·30 行
📘 公式リファレンス🔧 リファレンス/フィルター初級
append フィルター(文字列の末尾に追加)
文字列の末尾に別の文字列を連結するフィルター。URL パスの結合やテキストの接尾辞追加に使う。
📁 theme-liquid-docs·MIT·30 行