店舗への接続

デスクトップ版・モバイル版のみ

この画面はデスクトップ版とモバイル版のアプリにのみ表示されます。Web版では、yourdomain.com/posからPOSに直接アクセスし、WordPressの認証情報でログインします。

接続画面の概要

WCPOSのデスクトップ版またはモバイル版アプリを開くと、接続画面が表示されます。この画面で店舗への接続とユーザーログインを管理します。

店舗を新規追加する

1. テキストフィールドにWooCommerce店舗のURLを入力します（例：https://mystore.com）。
2. 接続をクリックします。
3. WordPressの認証情報でログインする画面に移動します。
4. ログインに成功すると、アプリに戻ります。

複数の店舗

必要な数だけWooCommerce店舗に接続できます。接続画面では各店舗が個別のカードとして表示され、次の情報を確認できます。

• 店舗名とファビコン
• 店舗のURL
• その店舗にログイン中のユーザー

複数の拠点や事業を管理する場合に便利です。

店舗ごとの複数ユーザー

各店舗には複数のユーザーが同時にログインできます。次のような場合に便利です。

• シフト交代 - 前のレジ係がログアウトする前に、新しいレジ係がログインできます。
• 複数レジの構成 - 別々の端末で異なるレジ係が操作できます。
• すばやい切り替え - ユーザーアカウントを簡単に切り替えられます。

ユーザーを追加する

「ログイン中のユーザー」の横にある ボタンをクリックすると、その店舗に別のユーザーを追加できます。

ユーザーを切り替える

ユーザーバッジ（例：「Brenda」）をクリックすると、そのユーザーとしてPOSが開きます。

ユーザーを削除する

ユーザーバッジの**×**をクリックすると、そのユーザーは店舗からログアウトします。

店舗を削除する

店舗カードの赤い**×**ボタンをクリックすると、一覧から店舗を削除できます。すべてのユーザーがログアウトし、アプリから店舗への接続が削除されます。

デモ店舗

画面下部に「デモ店舗に入る」リンクが表示される場合があります。このリンクからデモ用のWooCommerce店舗に接続し、自分の店舗データに影響を与えずにWCPOSの機能を試せます。

トラブルシューティング

最初に確認する項目：X-Frame-Options

デスクトップ版とモバイル版のアプリは、ログイン、支払い、レシート表示にiframeを使用します。X-Frame-Options: DENYまたはSAMEORIGINを送信するサーバーヘッダーやプラグインが一つでもあると、ログインできません。これはアプリのログイン失敗で最もよくある原因です。まず、ログインページのレスポンスヘッダーを確認してください（ブラウザーの開発者ツール、またはcurl -I https://yourstore.com/wp-login.php）。

店舗に接続できませんか？

• WordPressサイトにWCPOSプラグインがインストールされ、有効化されていることを確認します。
• 正しいURLを使用していることを確認します（https://を含めてください。WooCommerce REST APIにはSSLが必要です）。
• まずWebブラウザーでyourdomain.com/posを開き、プラグインが動作することを確認します。
• WooCommerce REST APIにアクセスできることを確認します。
• ユーザーアカウントにPOSへのアクセス権限があることを確認します。

デスクトップ版またはモバイル版アプリでログインできません

アプリのログイン失敗の多くは、セキュリティプラグインやキャッシュプラグインがログイン用iframeをブロックすることが原因です。

• X-Frame-Optionsヘッダー（セキュリティプラグインまたはサーバーが設定）がログイン用iframeをブロックしています。上記の注意事項を参照してください。セキュリティプラグインを一時的に無効にしてログインし、その後再び有効にします（セッションは約一週間有効です）。
• セキュリティプラグイン — Wordfence、Really Simple Security、WPS Hide Login、iThemes/Solid Security、Defender Proなどがよく原因になります。詳しい一覧と対処方法はプラグインの競合を参照してください。
• Wordfence 2FA — ログイン用iframeに2FAコード欄が表示されません。現時点ではPOSユーザーの2FAを無効にしてください。
• カスタムログインURL（例：WPS Hide Login）— アプリがログインページを見つけられません。標準の/wp-admin/ URLを使用してください。
• キャッシュプラグインは、問題のプラグインを無効にした後もブロックされたログインフォームを返し続けることがあります。キャッシュをクリアするか、アプリのキャッシュを消去するか、デスクトップ版アプリを再インストールしてください。

接続画面に「REST APIには認証が必要です」またはセキュリティプラグインのエラーが表示される

プラグイン（Force LoginやJWT認証プラグインなど）がすべてのREST APIリクエストに認証を要求しているため、アプリがサイトの公開情報を読み取れません。現在、サイトの種類を誤って判定する代わりに、サーバーからの実際のメッセージ（例：「認証済みユーザーのみがREST APIにアクセスできます」）を表示します。

**対処方法：**セキュリティプラグインを設定し、/wp-json/wcpos/と/wp-json/wc/v3/への未認証アクセスを許可するか、初回接続が完了するまで一時的に無効にします。

「WordPressサイトではないようです」と表示される（デスクトップ版アプリ）

デスクトップ版アプリはHTTPのLinkヘッダーを使ってREST APIを検出します。プラグイン（よくある例はImage Prioritizerやその他のパフォーマンスプラグイン）がこのヘッダーを大量の情報で埋めたり、切り詰めたりすると、検出に失敗します。**対処方法：**画像最適化プラグインやヘッダーを変更するパフォーマンスプラグインを無効にして、再試行してください。

アプリが更新を求める／更新後にクラッシュする

アプリとサーバープラグインのバージョンが一致しているか確認してください。アプリストアでアプリが更新されても、WCPOSプラグインの更新が必要な場合があります（またはその逆もあります）。v1.10では、アプリがプラグインのv2同期APIを使用するため、アプリとWCPOSプラグインの両方をv1.10リリース系列にする必要があります。片方だけを更新してリクエストがrest_no_routeで失敗する場合は、もう片方も更新してください。

「高速店舗データベースを作成できません」エラー

初回ログイン時の競合状態が原因です。アプリを完全に終了してから、もう一度試してください。通常、二回目は成功します。

ユーザー選択画面から先に進めない（デスクトップ版アプリ）

ログイン後、ユーザー名が表示されても次に進む方法が見つからない場合があります。ユーザー名／名前をクリックするとPOSに進めます。表示名自体がボタンです。

接続に何度も失敗しますか？

• まずWebブラウザーでyourdomain.com/posにアクセスし、プラグインが動作していることを確認してください。
• サイトのエラーログに問題が記録されていないか確認してください。
• ホストがREST APIをブロックしていないことを確認してください — ホスティング固有の注意事項を参照してください
• サーバーが最小要件を満たしていることを確認してください