فعال‌سازی ورود و ثبت‌نام با گوگل

ورود با گوگل به کاربر اجازه می‌دهد بدون واردکردن رمز سایت، با حساب گوگل خود احراز هویت کند. برای راه‌اندازی، باید یک اتصال متعلق به سایت خودتان در Google Cloud بسازید؛ صرف روشن کردن کلید گوگل کافی نیست.

ساخت اتصال در گوگل

1. وارد Google Cloud شوید و پروژه مناسب سایت را انتخاب یا ایجاد کنید.
2. در Google Auth Platform اطلاعات نام برنامه، مخاطبان و اطلاعات تماس لازم را تکمیل کنید.
3. در بخش Clients یک OAuth Client از نوع Web application بسازید.
4. در تنظیمات افزونه، بخش گوگل، نشانی بازگشت نمایش‌داده‌شده را کپی و در Authorized redirect URIs همان Client ثبت کنید.
5. Client ID و Client Secret را از گوگل در فیلدهای متناظر افزونه وارد کنید.

نام بخش‌های کنسول ممکن است تغییر کند. مرجع رسمی مراحل اتصال، راهنمای OAuth برنامه‌های وب گوگل است.

نشانی بازگشت را دقیق کپی کنید

نمونه برای سایتی در ریشه دامنه به شکل https://example.com/wp-admin/admin-ajax.php?action=asanwp_google_callback است. این فقط نمونه است؛ نشانی نمایش‌داده‌شده در افزونه خودتان را ثبت کنید. HTTPS، www، زیرپوشه، حروف و بخش انتهایی نشانی باید با مقدار واقعی یکسان باشند. نشانی صفحه ورود را به جای Callback وارد نکنید.

فعال‌سازی و اولین آزمایش

1. ورود با گوگل را روشن کنید و درباره ثبت‌نام خودکار کاربران جدید تصمیم بگیرید.
2. تنظیمات را ذخیره و فرم ورود را در پنجره خصوصی باز کنید.
3. دکمه ورود با گوگل را بزنید و رفت‌وبرگشت به سایت را در همان مرورگر کامل کنید.
4. اگر برنامه در حالت Testing است، حساب آزمایشی باید در فهرست کاربران آزمایشی مجاز باشد. برای استفاده عمومی، وضعیت انتشار و الزامات همان پروژه را بررسی کنید.

حساب کاربر چگونه پیدا می‌شود؟

افزونه شناسه حساب گوگل و ایمیل تأییدشده آن را بررسی می‌کند. حسابی که قبلاً به همان گوگل متصل شده، شناسایی می‌شود؛ در غیر این صورت، حساب دارای همان ایمیل بررسی می‌شود. اگر کاربر جدید باشد و ثبت‌نام خودکار گوگل روشن باشد، حساب ساخته می‌شود. خاموش بودن ثبت‌نام خودکار، ورود کاربران موجود را حذف نمی‌کند.

این روش شماره موبایل را از گوگل دریافت و تأیید نمی‌کند. حساب موبایلی بدون ایمیل، صرفاً به دلیل شباهت نام به حساب گوگل متصل نمی‌شود. نام نمایشی و نام کاربر می‌تواند از اطلاعات گوگل به‌روز شود.

خطاهای رایج

برای redirect_uri_mismatch نشانی بازگشت را اصلاح کنید. خطای کاربر مجاز نیست معمولاً به وضعیت مخاطبان یا کاربران آزمایشی پروژه مربوط است. اگر درخواست نامعتبر یا منقضی شد، ورود را از ابتدا و در همان مرورگر آغاز کنید؛ مسیر بازگشت نباید کش شود. Client Secret را در محتوای عمومی، عکس راهنما یا گزارش پشتیبانی منتشر نکنید.