ダッシュボードに戻る

ドキュメント

Asyntaiの使い方を学ぶ

ExpressionEngineにAsyntai AIチャットボットを追加する方法

ExpressionEngine CMSのためのステップバイステップガイド

埋め込みコードの取得

ステップ1:埋め込みコードを取得する

まず、Asyntaiダッシュボードに移動し、「埋め込みコード」セクションまでスクロールしてください。次のような固有の埋め込みコードをコピーしてください:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

注記: 上記のコードは一例です。個人のウィジェットIDが含まれているため、ダッシュボードから固有の埋め込みコードをコピーしてください。

ステップ2:テンプレートレイアウトに追加(推奨)

すべてのページにチャットボットを追加する最も簡単な方法は、ExpressionEngineコントロールパネルでメインレイアウトテンプレートを編集することです:

  1. EEコントロールパネルで、Developer > Templates > Template Groupsに移動します
  2. メインテンプレートグループ(通常「site」)を開き、レイアウトテンプレート(またはすべてのページをラップするテンプレート)を編集してください
  3. </body>閉じタグを見つけます
  4. Asyntaiの埋め込みコードを</body>タグの直前に貼り付けます:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. テンプレートを保存します

ヒント: </body>閉じタグの前にスクリプトを追加することで、ページコンテンツの後に読み込まれます。これはチャットウィジェットに推奨される方法で、ページの読み込みを遅くしません。

代替方法1:EEテンプレートパーシャルを使用する

ExpressionEngineのテンプレートパーシャルを使用すると、テンプレート全体にインクルードできる再利用可能なスニペットを作成できます:

  1. Developer > Templates > Template Partialsに移動します
  2. 「新規」をクリックして_asyntai_widgetという新しいパーシャルを作成してください
  3. パーシャルのコンテンツにAsyntaiの埋め込みコードを貼り付けます:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. パーシャルを保存します
  5. </body>の閉じタグの直前にレイアウトテンプレートにインクルードします:
    {embed="_asyntai_widget"} </body>

注記: テンプレートパーシャルを使用すると、コードが整理され、サイト全体で1箇所でチャットボットの埋め込みコードを更新できるようになります。

代替方法2:EEのHTMLヘッダー/フッターを使用する

一部のExpressionEngineのセットアップでは、スクリプトを追加するためのグローバルフッターセクションが提供されています:

  1. Settings > Content & Design > Global Template Preferencesに移動します
  2. EEのセットアップにグローバルフッターセクションがある場合、そこにAsyntaiの埋め込みコードを貼り付けます
  3. グローバルフッターセクションが利用できない場合は、メインレイアウトテンプレートを直接編集し、</body>の閉じタグの前に埋め込みコードを追加します:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. 変更を保存します

代替方法3:config.phpを使用する

上級者向けに、ExpressionEngineの設定またはカスタムアドオンの作成を通じてチャットボットスクリプトをインジェクトできます:

  1. FTP、SSH、またはコードエディターを使用してExpressionEngineのプロジェクトファイルにアクセスします
  2. system/user/config/ディレクトリに移動し、config.phpを開きます
  3. カスタムJavaScriptインジェクションの場合、template_post_parseフックにフックしてページレンダリング時にスクリプトをインジェクトするシンプルなEEアドオン/エクステンションの作成を検討してください:
    // In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; }
  4. YOUR_WIDGET_IDをダッシュボードから取得した実際のウィジェットIDに置き換えてください

重要: config.phpとアドオン方式は、ExpressionEngine開発に精通した上級者を対象としています。ほとんどのユーザーには、テンプレートレイアウト方式(ステップ2)またはテンプレートパーシャル方式(代替方法1)が推奨されます。

ステップ3:インストールの確認

変更を保存した後、新しいブラウザタブまたはシークレットウィンドウでExpressionEngineウェブサイトにアクセスしてください。右下にチャットウィジェットボタンが表示されます。クリックして正しく開いて動作することを確認してください。

ウィジェットが表示されませんか? テンプレートを保存したこと、およびページで使用されている正しいレイアウトテンプレートを編集していることを確認してください。ブラウザのキャッシュをクリアするか、シークレットウィンドウで表示してください。ExpressionEngineのテンプレートキャッシュが有効な場合は、コントロールパネルのDeveloper > Utilities > Cache Managerからキャッシュをクリアしてください。