インストールとセットアップ

WordPressプラグインを使用してPushlyをインストールする手順

お使いのWebサイトでWordPressを利用している場合は、手動の手順を省略して、WordPressプラグインディレクトリからPushlyをインストールできます。

ステップ1: WordPress APIキーを作成する

WordPressプラグインから直接通知を送信したい場合は、プラットフォーム内でWordPress APIキーを作成する必要があります。WordPressから直接通知を作成したくない場合は、このセクションをスキップできます。

へ移動します ドメイン設定 Pushlyプラットフォームのセクションを開き、連携タブをクリックします。このタブ内に、 コンテンツ管理システム WordPressカードを含むセクションが表示されます。

をクリックします 新しいAPIキー ボタンをクリックし、キーが画面に表示されるまで待ちます。表示されたら、キーをクリックしてクリップボードにコピーし、ステップ3で使用できるように保存します。

ステップ2: プラグインをインストールする

新しいプラグインをインストールする権限を持つユーザーでWordPress管理画面にログインし、プラグインディレクトリに移動します。 新規追加 ボタンをクリックすると、インストール可能なプラグインの一覧が表示されます。

で プラグインを追加 ページで Pushly を検索ボックスに入力してから、 今すぐインストール Pushlyプラグインカードのボタンをクリックします。

プラグインがインストールされると、 今すぐインストール ボタンは 有効化 ボタンに変わります。このボタンをもう一度クリックしてインストール手順を完了し、その後ステップ2に進んでプラグインのセットアップを完了します。

ステップ3: プラグインを設定する

ステップ1を完了してプラグインを有効化すると、サイドバーメニューに Pushly という新しいメニュー項目が表示されます。このメニュー項目をクリックしてPushlyの設定ページを開き、プラグインの動作を設定します。

次の設定オプションが利用できます:

SDKキー: プラットフォームの ドメイン設定 セクションからSDKキーを取得し、このテキストボックスに入力してください。アカウントマネージャーからSDKキーを提供してもらうこともできます。
新しい投稿の通知を送信: このスイッチをオンにすると、新しい投稿が作成されたときにWordPressから直接通知を作成できます。このスイッチを有効にすると、新しい Pushly セクションが投稿エディターのサイドバーに表示され、通知送信に関するオプションが含まれます。
自動送信: このスイッチをオンにすると、WordPressで新しい投稿を作成する際に 通知を送信 チェックボックスが自動的にオンになります。 通知を送信 ボックスにチェックが入っていると、投稿が公開されたときにその投稿の通知が作成されます。
APIキー: ステップ1で生成したWordPress APIキーをこのテキストボックスに入力してください。
詳細設定:
- SDKの初期化を無効にする: このボックスにチェックが入っていると、Pushly SDKは 自動的に実行されません 。既存の購読者は引き続き通知を受け取ることができます。

設定オプションを設定した後、フォームを保存してください。フォームが保存されると、サイトの訪問者に通知許可ダイアログが表示され始めます。通知送信を設定している場合、WordPress の投稿を作成する際に、WordPress ユーザーにも通知送信オプションが表示されます。

これらの手順を完了した後に通知のオプトインを求められない場合は、 Prompts Pushly プラットフォームのセクション内に少なくとも 1 つのアクティブなプロンプトがあることを確認してください。

トラブルシューティング

サービスワーカーがブロックされている（403 Forbidden）

一部の WordPress ホスティング環境では、NGINX が wp-content/plugins/ ディレクトリ内で PHP の実行をブロックする形で使用されています。これが発生すると、Pushly のサービスワーカーは 403 Forbidden エラーを返し、プッシュ通知は機能しません。

確認方法

ブラウザーで次の URL にアクセスしてください（ yourdomain.com をサイトのドメインに置き換えてください）：

https://yourdomain.com/wp-content/plugins/pushly/assets/js/pushly-sdk-worker.js.php

JavaScript コンテンツではなく 403 エラーまたは空白ページが表示される場合、サーバーがこのファイルの PHP 実行をブロックしています。

これが発生する理由

WordPress サイトは一般的に、いくつかの構成で NGINX の背後で動作しています：

リバースプロキシとしての NGINX Apache の前段 — NGINX が静的ファイルを処理し、プラグインディレクトリ内の PHP をブロックすることがあります
PHP-FPM を使用する NGINX （Apache なし）— Kinsta、Flywheel、WP Engine、Cloudways などのマネージドホストで一般的です。セキュリティルールにより、PHP の実行が特定のパスに制限されていることがよくあります
NGINX のキャッシュレイヤーまたは CDN — へのリクエストをブロックすることがあります .php 予期しないパス内のファイル

修正: NGINX の例外を追加する

NGINX の設定にアクセスできる場合は、サイトの server ブロック内に次を追加してください：

location = /wp-content/plugins/pushly/assets/js/pushly-sdk-worker.js.php {
    include fastcgi_params;
    fastcgi_pass unix:/var/run/php/php-fpm.sock;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

この fastcgi_pass パスは、PHP のバージョンやホストによって異なる場合があります。一般的な代替例：

unix:/var/run/php/php8.1-fpm.sock
127.0.0.1:9000

ルールを追加した後、NGINX をリロードしてください：

sudo nginx -t && sudo systemctl reload nginx

修正: ホスティングプロバイダーに連絡する

NGINX の設定に直接アクセスできない場合（マネージド WordPress ホストでは一般的）、ホスティングプロバイダーに連絡して次のように依頼してください：

次の場所にあるファイルの PHP 実行を許可する /wp-content/plugins/pushly/assets/js/pushly-sdk-worker.js.php。このファイルは Pushly のプッシュ通知サービスワーカーを提供しており、正しいヘッダー付きで JavaScript コンテンツを返す必要があります。

ほとんどのマネージドホストは、セキュリティルールを損なうことなく、このパスに対して特定の例外を追加できます。

修正の確認

修正を適用した後、サービスワーカーの URL に再度アクセスしてください。次で始まる 1 行の JavaScript が表示されるはずです importScripts(. これが表示されている場合、サービスワーカーは正しく動作しています。

前へWordPressプラグイン次へアクティビティログ

最終更新 1 か月前