WordPress 連携

Rankturn は記事を WordPress へ直接公開します。サインインにはアプリケーションパスワードを安全に使用します。記事はライブ公開・下書き保存のどちらも選べ、画像を WordPress メディアライブラリへアップロードし、タグやカテゴリを割り当て、さらに任意で編集内容を双方向に同期できます。

この連携は、アプリケーションパスワードに対応したセルフホスト型 WordPress および WordPress.com プランで利用できます。

前提条件

接続する前に、以下を準備してください。

• WordPress 5.6 以降で動作するサイト（このバージョン以降、アプリケーションパスワードが標準で利用できます）。
• https://your-site.com/wp-json/ にアクセスできること。セキュリティプラグインやホスティング側でこのアドレスがブロックされている場合は、先に有効化してください。
• 記事を作成できる権限を持つ WordPress ユーザー（投稿者・編集者・管理者）。
• そのユーザーのアプリケーションパスワード（通常のログインパスワードではありません）。

アプリケーションパスワードの作成

1. WordPress 管理画面（/wp-admin）にログインします。
2. ユーザー → プロフィール（または ユーザー → ユーザー一覧から対象ユーザーを編集）を開きます。
3. アプリケーションパスワードのセクションまでスクロールします。
4. わかりやすい名前（例：Rankturn）を入力し、新しいアプリケーションパスワードを追加をクリックします。
5. 生成されたパスワードをコピーします。表示は一度きりで、abcd EFGH 1234 wxyz 5678 9012 のような形式です（スペースもパスワードの一部です。表示どおりそのまま貼り付けてください）。

接続方法

1. Rankturn で 設定 → 連携を開きます。
2. WordPress カードを見つけて 接続をクリックします。
3. フォームに入力します。

4. 接続をクリックします。

Rankturn は保存前に接続テストを行います。成功すると接続したユーザー名を含む確認メッセージが表示されます。失敗した場合は WordPress 側のエラーメッセージが表示されるので、URL・ユーザー名・パスワードを確認してください。

接続時には、サイトが提供している投稿タイプも自動的に検出されます（後述のマルチ公開先プロファイルで使用します）。既存の接続設定を変更するにはカードの 設定を編集を使用します。アプリケーションパスワードを空欄のままにすると、保存済みのものが維持されます。

公開フォーマット

接続時に、記事本文を WordPress 投稿へどのように追加するかを選択します。

Gutenberg ブロック（既定・推奨）。 Rankturn は投稿をネイティブの Gutenberg ブロックとして作成するため、WordPress ブロックエディタで編集可能なブロックとして開きます。まれにブロックを作成できない場合も、公開を失敗させずに自動的にプレーンな HTML へ切り替えます。

HTML。 本文をプレーンな HTML としてそのまま投稿します。これは従来からの挙動で、テーマやワークフローがクラシックエディタの HTML を前提としている場合に便利です。

どちらの形式を選んでも、Rankturn は公開前に次の処理を行います。

• 記事のサムネイルと本文内画像を WordPress メディアライブラリへアップロードし、本文を新しい WordPress の画像に差し替えます。
• サムネイルを投稿のアイキャッチ画像に設定し、重複を避けるため本文からは削除します。
• 本文先頭の最上位見出しを削除します（WordPress は投稿タイトルを別に表示するため）。
• インライン画像がレイアウトからはみ出さないよう収めます。
• 構造化データ（Schema.org）を追加し、検索エンジンが記事を理解できるようにします。
• 正規 URL が設定されている場合、Yoast SEO と Rank Math 両方のフィールドに書き込みます（値を反映させるには該当プラグインが有効である必要があります）。

公開と下書き。 接続（または公開先プロファイル）で選んだ公開フォーマットによって、各投稿がそのままライブ公開（公開済み）になるか、下書きとして保存されるかが決まります。下書きはレビュー待ちの状態で WordPress に表示され、そこで手動公開できます。

双方向同期

既定では同期は一方向で、Rankturn から WordPress へ記事を送るのみです。双方向同期をオンにすると、WordPress 側で行った編集が Rankturn にも反映されるようになります。有効にすると、次の 2 つの方法で内容が最新に保たれます。

1. 1 時間ごとのチェック。 Rankturn が 1 時間に 1 回程度、前回チェック以降に更新された投稿を WordPress に問い合わせて取り込みます。追加設定なしですべてのサイトで動作します。
2. 即時更新（任意）。 サイトに小さな PHP スニペットを追加すると、投稿保存の瞬間に Rankturn へ通知が届き、次の 1 時間ごとのチェックを待たず数秒で変更が反映されます。

照合やコンフリクト処理などの全体的な考え方については、双方向同期を参照してください。

即時更新を有効にする

1. 接続済みの WordPress カードで双方向同期をオンにします。
2. 即時更新のセクションでスニペットを表示をクリックします。
3. 表示された Webhook URL と PHP スニペットをコピーします。
4. スニペットをサイトに追加します（例：テーマの functions.php、またはコードスニペット系プラグイン経由）。

スニペットはあくまで通知を送るだけです。通知が届くと、Rankturn は反映前に最新の投稿内容を WordPress から直接取得するため、実際の内容は常に WordPress 側が正となります。

変更の照合方法

Rankturn が投稿を取り込む際、既存の記事との照合は、まずその WordPress 投稿、次に保存済みの参照、最後にスラッグの順で行われます。同じ記事が両方で変更されている場合は WordPress 優先となります。

• 投稿が Rankturn による最後の送信以降変わっていなければ、自分自身の変更のエコーと見なしてスキップします。
• 前回の同期以降コンテンツが変わっていなければスキップします。
• 前回の同期以降に記事が Rankturn 側でも編集されていた場合でも、WordPress 版を適用します（この差異はコンフリクトとして記録されます）。

WordPress で作成した投稿の取り込み

WordPress 由来の投稿を取り込む方法は 2 つあります。

• 新規取り込み（自動）。 双方向同期がオンのとき、追加で 新規取り込みトグルが表示されます。これをオンにすると、Rankturn 側に該当記事がない WordPress 直作成の投稿が、同期時に下書きとして自動作成されます。取り込みは記事の生成枠を消費しません。
• 取り込み（手動・一度きり）。 カードの取り込みボタンでダイアログが開き、WordPress の投稿を一覧表示し、ステータスで絞り込み、すべて、または選択したものだけを取り込めます。接続直後に既存コンテンツを取り込むのに最も簡単な方法です。

マルチ公開先プロファイル

1 つの WordPress 接続から、公開プロファイルを使ってサイト内の複数の公開先へ投稿できます。各プロファイルは投稿タイプに、既定の公開フォーマットと任意の既定カテゴリを組み合わせたものです。通常のブログ記事はある場所へ、ニュースやカスタム投稿タイプは別の場所へ、といった使い分けに便利です。

接続済みカードの公開先エリアでは、次の操作ができます。

• プロファイルを追加 — 名前を付け、投稿タイプ（例：投稿、固定ページ、サイトで検出された任意のカスタムタイプ）を選び、公開または下書きを選択し、必要に応じて既定カテゴリをカンマ区切りで指定します。
• 既定に設定 — 星マークの付いたプロファイルが、指定なしで公開したときに使われます。既定は常に 1 つだけ存在します。
• プロファイルの編集・削除。（最後の 1 つは削除できません。）
• 投稿タイプを再検出 — 後から WordPress にカスタム投稿タイプを追加した場合、再検出をクリックして利用可能な一覧を更新します。

プロファイル経由で公開すると、Rankturn はそのプロファイルの投稿タイプへ投稿し、プロファイルの既定カテゴリと記事のカテゴリを組み合わせます。タグとカテゴリは名前で照合され、存在しないものは作成されます。WordPress の上限である 200 文字を超えるスラッグは自動的に切り詰められます。

トラブルシューティング

「接続テストに失敗」「認証情報が無効」 — サイト URL・ユーザー名・アプリケーションパスワードを確認してください。表示名やメールではなく WordPress のユーザー名を使い、アプリケーションパスワードはスペースも含めてそのまま貼り付けます。不安な場合はアプリケーションパスワードを再生成してください。

接続テストや公開でサイトに到達できない — https://your-site.com/wp-json/ がブラウザで開けるか確認してください。セキュリティプラグイン・ファイアウォール・ホスティング設定がアクセスやアプリケーションパスワードでのサインインをブロックしている場合があります。再度有効にしてください。なお Rankturn は、内部アドレスや到達不能なアドレスを弾くためにサイト URL の確認も行います。

画像が表示されない／本文にサムネイルが残る — 公開ユーザーがメディアをアップロードできること（投稿者以上の権限）を確認してください。Rankturn は画像をメディアライブラリにアップロードし、サムネイルをアイキャッチ画像に設定します。権限不足だと画像が欠落することがあります。

正規 URL が反映されない — 正規 URL は Yoast SEO と Rank Math のメタフィールドに書き込まれます。いずれかの SEO プラグインをインストール・有効化すると値が反映されます。

タグやカテゴリが付かない — 名前で照合し、なければ作成されます。解決に失敗したタグ・カテゴリは公開をブロックせずスキップされます。公開ユーザーがタームを管理できる権限を持っているか確認してください。

WordPress の編集が同期されない — 双方向同期がオンか確認してください。WordPress での変更は 1 時間ごとのチェックで反映され、PHP スニペットを追加していればほぼ即時に反映されます。WordPress で新規作成した投稿は 新規取り込みが有効なときのみ自動同期されます。それ以外は手動の取り込みボタンを使用してください。