店舗への接続

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

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

接続画面の概要

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

新しい店舗の追加

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

複数の店舗

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

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

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

店舗ごとの複数ユーザー

各店舗では、複数のユーザーが同時にログインできます。これは次のような場合に役立ちます。

• シフト交代 - 前のレジ担当者がログアウトする前に、新しいレジ担当者がログインできます
• 複数レジ構成 - 異なる端末で別々のレジ担当者が使用できます
• クイック切り替え - ユーザーアカウントを簡単に切り替えられます

ユーザーの追加

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

ユーザーの切り替え

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

ユーザーの削除

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

店舗の削除

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

デモ店舗

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

トラブルシューティング

最初に確認すること: 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 をブロックしています — 上記の注記を参照してください。セキュリティプラグインを一時的に無効化してログインし、その後で再度有効化してください（セッションは約 1 週間有効です）。
• セキュリティプラグイン — Wordfence、Really Simple Security、WPS Hide Login、iThemes/Solid Security、Defender Pro がよくある原因です。完全な一覧と修正方法は プラグインの競合 を参照してください。
• Wordfence 2FA — 2FA コード欄がログイン iframe 内に表示されません。現時点では、POS ユーザーの 2FA を無効化してください。
• カスタムログイン URL（例: WPS Hide Login） — アプリがログインページを見つけられません。標準の /wp-admin/ URL を使用してください。
• キャッシュプラグインにより、原因となるプラグインを無効化した後も、ブロックされたログインフォームが配信され続ける場合があります — キャッシュをクリアするか、アプリのキャッシュをクリア / デスクトップアプリを再インストールしてください。

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

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

修正: セキュリティプラグインを設定して /wp-json/wcpos/ と /wp-json/wc/v3/ への未認証アクセスを許可するか、初回接続が完了するまで一時的に無効化してください。

「Does not appear to be a WordPress site」と表示される（デスクトップアプリ）

デスクトップアプリは HTTP Link ヘッダーを通じて REST API を検出します。プラグイン（一般的には Image Prioritizer やその他のパフォーマンスプラグイン）がそのヘッダーを大量に追加したり切り詰めたりすると、検出に失敗します。修正: 画像最適化プラグインやヘッダーを変更するパフォーマンスプラグインを無効化して、再試行してください。

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

アプリとサーバープラグインのバージョン不一致を確認してください — WCPOS プラグインにはまだ更新が必要な一方で、アプリストアからアプリの更新が配信されている場合があります（またはその逆の場合もあります）。アプリと WCPOS プラグインが同じメジャーバージョンであることを確認してください。WCPOS v1.9.0+ アプリには、WCPOS プラグイン v1.8.0 以上が必要です。

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

これは初回ログイン時の競合状態です。アプリを完全に閉じて、もう一度お試しください — 通常は2回目の試行で成功します。

ユーザー選択画面で停止する（デスクトップアプリ）

ログイン後、ユーザー名は表示されますが、次に進む方法が分かりにくい場合があります。ユーザー名/名前をクリックするとPOSに進みます — 名前自体がボタンです。

接続が繰り返し失敗しますか？

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