phpmailer_gmail_oauth2

تهدف هذه الوحدة إلى أن تكون مكونًا إضافيًا يعمل مع وحدة PHPMailer SMTP، مما يوفر مصادقة لـ Google Workspace Gmail عبر OAuth2. وهو مستوحى من phpmailer_oauth2، الذي كتبه إيان ماكلين (غير نظيف). لو لم أجد وحدة إيان، فمن غير المحتمل أن أحاول العمل على واحدة لـ Google Gmail.

هام: تتطلب هذه الوحدة وحدة Google league/oauth2-google، المتوفرة على https://oauth2-client.thephpleague.com/providers/league/. يجب أن يتم تثبيته في دليل البائع الخاص بك.

قبل استخدام هذه الوحدة، من الضروري إعداد معرف العميل وسر العميل على Google. إليك كيفية القيام بذلك اعتبارًا من أبريل 2024 وتكوين هذه الوحدة:

1. قم بتسجيل الدخول إلى حسابك على Google Workspace.

2. انتقل إلى https://console.cloud.google.com/.

3. في الجزء العلوي الأيسر من الصفحة بجوار "Google Cloud"، يجب أن تكون هناك قائمة منسدلة للمشاريع. انقر عليها.

4. إذا لم يكن لديك أي مشاريع مدرجة في مربع الحوار "تحديد مورد"، فقم بإنشاء واحد، ثم حدده كمشروعك الحالي.

5. انقر على "واجهات برمجة التطبيقات والخدمات"، وهو زر كبير في مكان ما في وسط الصفحة.

6. انقر فوق بيانات الاعتماد في القائمة التي تظهر على الجانب الأيسر من الصفحة.

7. انقر فوق "إنشاء بيانات الاعتماد"، ثم حدد "معرف عميل OAuth".

8. حدد "تطبيق الويب" لنوع التطبيق.

9. قم بتسمية بيانات الاعتماد الخاصة بك، ولاحظ معرف العميل وسر العميل. سوف تحتاج إلى إدخال هذه القيم في (11) أدناه.

10. بمجرد تثبيت هذه الوحدة، يمكنك العثور على "URI لإعادة التوجيه المعتمد" لموقعك من خلال الانتقال إلى Configuration->System->PHPMailer Gmail OAuth2 (/admin/config/system/phpmailer-gmail-oauth2). أظهر تلك الصفحة في نافذة متصفح منفصلة، ​​وستجد عنوان URI لإعادة التوجيه الذي يطلبه Google بالقرب من أعلى الصفحة. انسخ عنوان URI وأدخله في مربع "عناوين URI لإعادة التوجيه المعتمدة" في صفحة Google. اضغط على حفظ.

11. بالعودة إلى صفحة دروبال، أدخل عنوان بريدك الإلكتروني في Google، ومعرف العميل، وسر العميل، ثم اضغط على الزر "حفظ التكوين".

12. بعد حفظ بيانات اعتماد Google الخاصة بك، سيظهر زر "الحصول على رمز التحديث". اضغط على هذا الزر لإعادة التوجيه من موقعك إلى Google، ثم اتبع الإرشادات الموجودة على Google.
    عند الانتهاء، يجب على Google إصدار رمز التحديث وإعادة التوجيه مرة أخرى إلى صفحة Drupal التي غادرتها للتو. إذا نجح كل شيء، فسيكون لديك رمز التحديث الخاص بك وستكون جاهزًا لإرسال البريد الإلكتروني.

13. إذا واجهت مشاكل في إعادة التوجيه إلى Google عند الضغط على زر "الحصول على رمز التحديث"، فقد تحتاج إلى إضافة ما يلي إلى ملف settings.php الخاص بك:

    $ settings [ ' trusted_host_patterns ' ] = [ ' ^accounts.google.com$ ' ];

 If you have other trusted_host_patterns, add '^accounts.google.com$' to the array.

بعض عناصر الإعداد الأخرى:

1. لا تنس الانتقال إلى وحدة البريد لتحديد "PHPMailer SMTP" كمنسق ومرسل البريد (/admin/config/system/mailsystem).

2. إذا كان لديك وحدات نمطية أخرى مثل Commerce 2 التي ترسل البريد، فقد تحتاج إلى إضافتها في أسفل نفس الصفحة في (1) أعلاه.

3. في صفحة إعدادات نقل PHPMailer SMTP، حدد "Gmail OAuth2" كطريقة مصادقة SMTP (/admin/config/system/phpmailer-smtp). اضبط منفذ SMTP على 587، ثم حدد TLS باعتباره البروتوكول الآمن.

يمكنك استخدام خدمة "اختبار التكوين" في صفحة إعدادات النقل PHPMailer SMTP للتحقق من أن التكوين الجديد يعمل عن طريق إرسال بريد إلكتروني تجريبي.