サポート
ドキュメンテーション
ホーム サポート 統合 Joomla!サイトとSuperSaaSの統合

Joomla! サイトを SuperSaaS と統合する

このページでは、SuperSaaS スケジュールを Joomla! ベースのウェブサイトに統合する方法を説明します。これにより、ユーザーはウェブサイトとその中の SuperSaaS スケジュールにアクセスするために一度だけサインインすれば済みます。 これを使用するには、まず（無料の）SuperSaaS アカウントにサインアップする必要があります。

自社のウェブサイトでユーザーにログインを求めていない場合、または Joomla! のユーザー登録システムを使用していない場合は、ウェブサイトへの スケジュールの統合方法 の一般的な手順に従ってください。 ここで提供されるプラグインは、ユーザーがすでに自社の Joomla! サイトにログインしている場合にのみ動作します。

SuperSaaS スケジュールに Joomla! ログイン名を使用する

SuperSaaS Joomla! プラグインは、ユーザーの Joomla! ユーザー名を使用して SuperSaaS スケジュールに自動的にログインする 今すぐ予約 ボタンを表示します。

プラグインが生成するボタンは、Joomla! ユーザーデータベースの情報を SuperSaaS に渡し、必要に応じて SuperSaaS データベースでユーザーを作成または情報を更新します。 これにより、ユーザーは予約システム用に別々のログインを作成する必要がなくなり、2回ログインする手間が省けます。

Joomla! でのプラグインのインストールと設定

Joomla! でモジュールを設定するための手順に従ってください：
  1. プラグインをインストール。Joomla! 管理者ページで システム>インストール：拡張機能 に移動します。プラグインは別途ダウンロードせずにインストールできます：
    • Joomla! 6+ の場合は、Web からインストール オプションを選択し、「SuperSaaS」を検索します
    • 古い Joomla! バージョンとの互換性のために、GitHub リリース ページからリリースをダウンロードします
    モジュールを変更したい場合は、GitHub リポジトリからダウンロードすることもできます。
  2. プラグインを設定。システム>管理：プラグイン 画面で SuperSaaS を検索し、ステータスを「有効」に変更して有効にします。 次に、プラグインをクリックして設定します。右側の「アクセス」設定で「公開」が選択されていることを確認してください。 次に SuperSaaS プラグイン設定 セクションを記入します：
    • SuperSaaS アカウント名* – アカウント名（メールアドレスではありません！）
    • SuperSaaS API キー * – SuperSaaS アカウントの API キーは、アカウント情報 ページの下部にあります。
    • カスタムドメイン名 – カスタムドメイン名 を作成してスケジュールにポイントした場合は、ここに記入してユーザーを正しく誘導します
    • スケジュール名または URL – スケジュール名を入力するか、特定のビューにユーザーを誘導するためのパラメータ付きの完全な URL を指定できます
    (* – 必須項目）
Joomla! SuperSaaS 予約プラグイン

Joomla! と連携するための SuperSaaS アカウント設定を変更する

Joomla! ユーザーデータベースが主な情報源なので、Joomla! サイトでのユーザー情報変更は SuperSaaS に反映されますが、逆はされません。 したがって、ユーザーが SuperSaaS でユーザー情報を変更できないようにすることを推奨します。これを許可すると混乱を招く可能性があります。 たとえば、SuperSaaS でパスワード変更を許可すると、ユーザーは Joomla! のパスワードが同じままであることに気づかない可能性があります。

不整合を避けるために、SuperSaaS アカウントで以下の変更を行ってください：
  1. アクセスコントロール ページで、 ログインと登録をサイトで管理する を選択します
  2. アクセスコントロール ページで、 ユーザーが自身の情報を更新できないようにする を選択します
  3. レイアウト設定 ページで、あなたの URL ボックスにユーザーがログインできるサイトのページの URL を記入します

次に、Joomla! のデータベースフィールドが SuperSaaS ユーザーデータベースと一致するようにします。アクセスコントロール ページで以下の変更を行ってください：

  1. メールアドレスをログイン名として使用 を選択解除します
  2. 表示される メールアドレス ラジオボタンを オプション（または 必須）に切り替えます
  3. 他のすべてのフィールドを 尋ねない に切り替えます（ ログインはここでは処理しない を選択した場合は パスワード フィールドもオフにできます）
SuperSaaS アクセスコントロール

SuperSaaS を設定する

この画像は、上記で説明した設定を行った後の SuperSaaS アカウントの アクセスコントロール ページを示しています。

ページにボタンを追加する

ボタンを表示したいページのどこにでもショートコード [supersaas] を配置します。 ショートコードは、設定画面の値を上書きするために after、label、image のオプション パラメータを受け取ることができます。

これにより、異なるスケジュールに複数のボタンを追加する際に便利です。たとえば：
[supersaas after="schedule1" label="スケジュール 1 で予約"]
[supersaas after="schedule2" label="スケジュール 2 で予約" image="https://example.com/book_now.gif"]
Joomla! アティクルに複数の予約ボタンを入力
複数のボタン付きアティクルの表示

試してみる

これでサイト上のボタンを試すことができます。 管理者としては、メインの SuperSaaS ログインページ経由でログインする必要があるため、一般ユーザーになりすまして試してみてください。 SuperSaaS で スーパーユーザー を定義する場合は、ユーザーマネジメント ページで役割を変更する前に、ボタンを使用して少なくとも一度ログインしていることを確認してください。

トラブルシューティングのヒント

  • ボタンは、Joomlaサイトにログインしているユーザーにのみ表示されることに注意してください。
  • 「Email is not a valid email address（メールアドレスが有効ではありません）」というエラーが表示された場合は、「SuperSaaSアカウント設定を変更してJoomlaと連携する」セクションをもう一度確認し、SuperSaaSアカウントの設定が正しく行われているか確認してください。
  • 「Login name is a reserved word（ログイン名は予約語です）」というエラーが表示された場合は、そのユーザー名がSuperSaaSで予約されている単語です。別のユーザー名でログインを試してください。
  • ボタンがユーザーをリダイレクトするものの、実際にはログインされない場合で、Schedule name or URL フィールドにURLを使用している場合は、そのURLのドメインが Custom Domain Name フィールドに入力されていることを確認してください。