[GP]247
インストールをお任せしますか？
お客様のサーバーに導入・設定します。簡単な見積もりの後、固定価格でお受けします。
🌐 言語: 🇻🇳 Tiếng Việt · 🇬🇧 English · 🇯🇵 日本語（現在）
このプラグインは、Google reCAPTCHA v2 —「私はロボットではありません」（おなじみのチェックボックス）を使って、GP247 サイトをスパム（偽の会員登録、フォームの自動送信）から守ります。本書は技術に詳しくないショップオーナー・管理者向けです。読み終えれば、業者に頼まなくてもご自身で Google のキーを登録し、プラグインをインストールして、会員登録・パスワード再設定・決済などのページで CAPTCHA を有効にできます。最後に、自作フォームに CAPTCHA を組み込みたい開発者向けの章があります。
⚠️ 重要： バージョン 2.0 以降、このプラグインは reCAPTCHA v2（「私はロボットではありません」チェックボックス） を使用しており、reCAPTCHA v3 ではありません。Google でキーを登録する際は必ず v2 を選んでください（ステップ 1 参照）。誤って v3 を選ぶと、チェックボックスが表示されず、フォームは常に CAPTCHA エラーになります。
CAPTCHA の欄は、以下の条件をすべて満たした場合にのみ表示されます。どれか 1 つでも欠けていると CAPTCHA は表示されません。
グループ A — 管理画面でご自身が有効にする項目（必須）：
グループ B — そのページに CAPTCHA の「設置場所」があること： 4. CAPTCHA を表示できるのは、GP247 が標準でサポートしているページだけです。現在は 会員登録、パスワード再設定、お問い合わせ、決済 の 4 ページです。この一覧にないページ（またはステップ 3 でチェックしていないページ）には CAPTCHA は表示されません。 5. **自分で編集したテーマ（テンプレート）**を使っている場合は、そのページのフォームに GP247 が用意した CAPTCHA 表示用の行が残っている必要があります。GP247 の標準テーマには最初から含まれているので、テンプレートを自分で編集する場合にだけ注意してください（「開発者向け」の章を参照）。
💡 簡単に言うと、グループ A は「正しく有効にしたか」、グループ B は「そのページが CAPTCHA に対応しているか」です。両方を満たして初めてチェックボックスが表示されます。
ブラウザを開き、キー作成ページにアクセスします：https://www.google.com/recaptcha/admin/create
Google アカウントでログインします（まだログインしていない場合）。
Label（ラベル）欄に、覚えやすい名前を入力します。例：サイト名 my-shop。
reCAPTCHA type（reCAPTCHA の種類）で Challenge (reCAPTCHA v2) を選び、続けて "I'm not a robot" Checkbox（日本語表示：「私はロボットではありません」チェックボックス）を選びます。
⚠️ ここが最も間違えやすいステップです。必ず v2 → チェックボックスを選び、v3 は選ばないでください。
Domains（ドメイン）欄に、サイトのドメインを 1 行に 1 つずつ、https:// を付けずに追加します。例：
my-shop.com
www.my-shop.com
ご自身のパソコンで試験運用している場合は、localhost も追加してください。
利用規約への同意欄（Accept the reCAPTCHA Terms of Service）にチェックを入れ、Submit（送信）をクリックします。
成功すると、Google が 2 つのキーを表示します：
6L... で始まる文字列6L... で始まります後でコピーできるようにこのページを開いたままにするか、2 つのキーを一時的な場所（メモ帳など）にコピーしておいてください。
上記の管理画面での 4 つの操作の代わりになる方法です。gp247 3.x 以降では、管理画面を開かずに、GoogleCaptcha を GP247 ライブラリからダウンロードしてコマンドラインでそのままインストールできます。このプラグインは、サイトに gp247/front パッケージがインストールされている必要があります。サイトのルートフォルダーでターミナルを開き、次を実行します：
# 1) ウェブサイトごとに 1 回だけ：GP247 ライブラリに接続するための API License（無料）を登録
php artisan gp247:ext-register-license
# 2) ライブラリからプラグインをダウンロードしてインストール
php artisan gp247:ext-install --type=plugin --key=GoogleCaptcha
.env の APP_URL がサイトの実際のドメインになっていること（http://localhost のままでないこと）を確認してください。ライセンスはこのドメインに紐付けられます。gp247.json に宣言された条件（core のバージョン、composer パッケージ、依存プラグイン）を自動で確認します。不足があればコマンドは停止し、何が足りないかを明確に表示します（例：サイトに gp247/front がない）。app/GP247/Plugins/GoogleCaptcha フォルダーがすでにサーバー上にある場合（手動でコピーした、またはインストーラーに同梱されていた場合）、コマンドは再ダウンロードせずにその場でインストールします。php artisan gp247:ext-update --type=plugin --key=GoogleCaptcha を実行してください。--json を付けると、機械で読み取れる形式で結果を受け取れます（スクリプト／CI 用）。バージョン 2.0 以降、idForm / idButtonForm を使う旧方式は廃止されました（新しいテーマには存在しない固定 ID に依存していたためです）。新しい方式では ID は不要です。ウィジェットを <form> タグの内側に置くだけで、Google がそのフォームに認証データを自動で挿入します。
標準の方法（GP247 の標準フォームと同じ）：ページのコントローラーで CAPTCHA 部分を用意し、ビューに渡します：
// コントローラー内：'register' はページ名で、手順 4 でチェックしたページと一致させる必要があります
$viewCaptcha = gp247_captcha_processview('register', '会員登録');
// ... $viewCaptcha をビューに渡す
ビューファイルでは、<form> タグの内側、送信ボタンの上に出力します：
<form method="POST" action="...">
@csrf
{{-- ...入力欄... --}}
{!! $viewCaptcha ?? '' !!}
<button type="submit">送信</button>
</form>
有効なページ名（ステップ 4 のチェック項目と一致）：register、forgot、contact、checkout。
localhost を追加してください。admin_config の行に保存されるため、設定済みの値はアップグレード後もそのまま保持されます。Q1：プラグインは reCAPTCHA v2 と v3 のどちらを使いますか？ バージョン 2.0 は v2 チェックボックス（「私はロボットではありません」のチェック欄）を使います。Google でキーを登録する際は、必ずこの種類を選んでください。
Q2：以前取得した reCAPTCHA v3 のキーを再利用できますか？ できません。v3 と v2 のキーは別物です。ステップ 1 に従って、新しい v2 チェックボックスのキーペアを登録し直してください。
Q3：すべて有効にしたのに、会員登録ページに CAPTCHA 欄が表示されません。 動作条件を再確認してください。最も多い原因は、Shop Config → Captcha で**「会員登録」ページにチェックを入れていない**、または Site Key を入力していないことです。
Q4：CAPTCHA が一部のページにしか表示されず、他のページにはありません。 仕様どおりです。CAPTCHA は、ステップ 4 でチェックを入れたページにのみ、かつ GP247 がサポートするページ（会員登録、パスワード再設定、お問い合わせ、決済）の範囲でのみ表示されます。
Q5：reCAPTCHA は有料ですか？ いいえ。Google reCAPTCHA v2 は通常の用途であれば無料です。
Q6：サイトのドメインを変更したら何をすればよいですか？ Google reCAPTCHA の管理画面で、使用中のキーの Domains 欄に新しいドメインを追加してください（新しいキーを作る必要はありません）。
Q7：自分で作ったフォームに CAPTCHA を追加したい場合は？
「開発者向け」の章を参照してください。{!! $viewCaptcha !!} を <form> タグの内側に置き、コントローラーで gp247_captcha_processview(...) を呼び出します。旧バージョンのようにフォーム／ボタンの ID を宣言する必要はありません。
Q8：Secret Key を間違えて入力した場合、何か通知されますか？ CAPTCHA 欄は通常どおり表示されますが、フォームを送信すると常に認証エラーになります。プラグインの設定画面に戻り、正しい Secret Key を入力し直してください。
Q9：プラグインをアンインストールすると、入力した Site Key／Secret Key は失われますか？ Disable は一時的に無効にするだけで、キーは保持されます。Uninstall はキー設定を完全に削除するため、再度使う場合は入力し直す必要があります。
Q10：1.x から 2.0 にアップグレードする場合、キーを入力し直す必要がありますか？ いいえ。キーは以前と同じ場所に保存されているため、そのまま保持されます。使用中のキーが v2 チェックボックス型であることだけ確認してください。以前 v3 を使っていた場合は、ステップ 1 に従って登録し直す必要があります。
📅 最終更新: 2026-10-22 · ✍️ 作成者 (Author): GP247
Please sign in to write a review.
ログインNo reviews yet. Be the first to review this product.
![[InOut] 入荷・返品・入出金管理プラグイン](https://static.gp247.net/product/in-out.png)