Amelia ショートコードの使用方法
Amelia ショートコードを使用すると、WordPress サイトの好きな場所に予約フォーム、イベントレイアウト、およびお客様マイページとスタッフマイページの両方を表示できます。
各ショートコードはそのまま使用することも、特定のサービス、カテゴリー、場所、タグ、または単一のイベントなど、訪問者に表示される内容をフィルタリングするパラメーターで拡張することもできます。Gutenberg、Elementor、Divi などのビルダーがない場合でも、ページや投稿にショートコードを挿入でき、Amelia は選択されたフォームを自動的に読み込みます。
例えば、1つのショートコードだけで完全な「ステップバイステップ予約ウィザード」を表示したり、特定のサービスやスタッフのみを表示するようにフィルタリングしたりできます。
読みたいところをタップ
Amelia ショートコードで使用できるパラメーター
ショートコードには、お客様画面に表示される内容をフィルタリングまたは調整するオプションのパラメーターを含めることができます。複数の値はカンマ区切りのリストとして追加でき、サポートされていない組み合わせは安全に無視されます。一般的なパラメーターは以下の通りです。
- service – 選択したサービスのみを表示します。
- category – フォームを特定のカテゴリーに制限します。
- employee – 特定のスタッフが提供するサービスを表示します。
- location – 1つまたは複数の場所でフィルタリングします。
- tag – 特定のタグを持つサービスまたはイベントを表示します。
- event – ID で特定のイベントを読み込みます。
- recurring – event と一緒に使用すると、繰り返しセッションも表示します。
- show – サービスとコースの両方が有効な場合に、どちらを表示するかを選択します。
値は組み合わせることができます。例： employee=1,3,7 や tag=”{design},{marketing}”
ステップバイステップ予約フォームを埋め込む方法
「ステップバイステップ予約ショートコード」を使用して、ウェブサイトのどこにでもメインの予約ウィザードを表示します。パラメーターなしではすべてのサービスとスタッフが読み込まれます。フィルターを追加することで、訪問者にアクセスさせたい部分のみを表示できます。
例：
カタログ予約フォームを埋め込む方法
「カタログショートコード」は、カテゴリーおよびカードベースのブラウジングを備えたサービスとコースのカタログを表示します。これを使用して完全なカタログを表示したり、カテゴリー、サービス、スタッフ、場所、またはコースでフィルタリングしたりできます。
例：
イベントリスト予約フォームを埋め込む方法
「イベントリストショートコード」は、イベントを簡素化された垂直リストレイアウトで表示します。すべてのイベント、単一のイベントを表示したり、タグでフィルタリングしたりできます。
例：
イベントカレンダー予約フォームを埋め込む方法
「イベントカレンダーショートコード」は、インタラクティブな月間カレンダー内にイベントを表示します。フィルターを使用して、特定のイベントやタグ付けされたグループを表示できます。
例：
お客様マイページを埋め込む方法
「お客様マイページショートコード」を使用して、お客様が予約、イベント、およびコースを管理できるログインエリアを表示します。
例：
スタッフマイページを埋め込む方法
「スタッフマイページショートコード」を使用して、スタッフがスケジュールを管理するために使用するワークスペースを表示します。
例：
高度なショートコードパラメーターの仕組み
Amelia は、より柔軟なお客様画面の動作を可能にするいくつかの高度な属性をサポートしています。
- 複数選択 – 値をカンマ区切りのリストとして追加できます（例： employee=1,4,7 ）。
- タグ – カンマ区切りの値を使用して複数のタグを追加します（例： tag=”{design},{marketing}” ）。
- 繰り返しイベント – event=ID を使用して繰り返しインスタンスを読み込むときに recurring=1 を追加します。
- ポップアップモード – trigger= と trigger_type= (class または id) を使用して、ポップアップでフォームを開きます。 Amelia のダイアログレイアウト内にフォームを表示するには、 in_dialog=1 を追加します。
これらのパラメーターはオプションであり、Amelia はページを壊すことなく、サポートされていない組み合わせを無視します。
URLパラメーターを使用して Amelia ショートコードの値を事前選択する方法
URLパラメーターを渡すことで、Amelia 予約フォームやイベントショートコードで特定のエンティティを事前選択できます。これらのパラメーターを使用すると、ページが読み込まれたときに予約フォームを自動的にフィルタリングしたり、事前入力したりできます。
URL を介してエンティティ ID のリスト（カンマ区切り）または特定の値を渡すことができます。以下のパラメーターがサポートされています。
- ameliaEventId – イベント関連のショートコードを特定のイベント ID で事前フィルタリングします。
- ameliaEventTag – イベント関連のショートコードをイベントタグで事前フィルタリングします。
- ameliaServiceId – 予約ショートコードを特定のサービス ID で事前フィルタリングします。
- ameliaEmployeeId – 予約ショートコードを特定のスタッフ ID で事前フィルタリングします。
- ameliaCategoryId – 予約ショートコードを特定のサービスカテゴリー ID で事前フィルタリングします。
- ameliaLocationId – 予約ショートコードを特定の場所 ID で事前フィルタリングします（イベント予約フォームではなく、サービスベースの予約フォームでのみ利用可能です）。
- ameliaEventPopup – ページが読み込まれたときに、指定されたイベント ID のイベントをポップアップで自動的に開きます。
例：イベントページの URL
https://yourbookingwebsite.com/events/?ameliaEventId=123&ameliaEventPopup=123
この URL は、イベント ID 123 がリストされているページを開き、ポップアップでイベントの詳細を自動的に表示します。
例：予約フォームの URL
https://yourbookingwebsite.com/booking/?ameliaServiceId=5&ameliaEmployeeId=1
この URL は、予約フォームでサービス ID 5 とスタッフ ID 1 を事前選択します。