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

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

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

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

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

<figure><img src="/files/cbeef67c91e7b048bd88dbaf463924829e41a1cb" alt=""><figcaption></figcaption></figure>

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

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

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

![](/files/29b25df25b4d70b811f4a583f8846dc0e05f3244)

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

![](/files/cdba4a24c26f4169103e2a34c8f0b2a0b8484855)

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

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

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

<figure><img src="/files/8439410b1d017ed173e1ab3c7f294ddb2baea553" alt=""><figcaption></figcaption></figure>

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

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

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

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

## トラブルシューティング

### サービスワーカーがブロックされている（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` ブロック内に次を追加してください：

```nginx
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 をリロードしてください：

```bash
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(`. これが表示されている場合、サービスワーカーは正しく動作しています。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.pushly.com/pushly-ja/integration/webpusshu/wordpresspuraguin/wordpress-plugin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.