إكمال العنوان تلقائيًا لنماذج جرافتي

كيف يمكنني تفعيل البرنامج المساعد؟

بعد شراء ميزة إكمال العناوين التلقائي لـ Gravity Forms، ستحتاج إلى:

1. قم بتثبيت الإضافة على موقعك الإلكتروني على ووردبريس.
2. قم بإنشاء مفتاح Google API الخاص بك وأدخله.
3. تفعيل خاصية الإكمال التلقائي في العنوان أو حقل نصي من سطر واحد.

ستوضح لك التعليمات أدناه كيفية تثبيت المكون الإضافي الخاص بك، وإنشاء مفتاح Google API للإكمال التلقائي للعناوين وتمكينه في حقل العنوان أو حقل نص السطر الواحد.

قم بتسجيل الإضافة لدى Plugin Brewery

	قم بتسجيل الدخول إلى موقع ووردبريس الخاص بك وانتقل إلى الإضافات > إضافة إضافة > تحميل إضافة > قم بتثبيت ملف zip وقم بتفعيله. بمجرد تفعيلها، يظهر الملحق في النماذج > الإضافات > المثبتة، وتوجد إعداداته ضمن النماذج > الإعدادات > الإكمال التلقائي للعناوين.
	في قائمة التنقل على اليسار، انتقل إلى النماذج > الإعدادات > الإكمال التلقائي للعناوين > الترخيص. أدخل مفتاح الترخيص الخاص بك وقم بتفعيله. ثم انتقل إلى إعدادات إنشاء مفتاح واجهة برمجة تطبيقات جوجل (Google API) الموضحة أدناه.

قم بإنشاء مفتاح Google API وإدخاله

قبل أن تتمكن من استخدام ميزة الإكمال التلقائي للعناوين، ستحتاج إلى إنشاء مفتاح API في وحدة تحكم Google Cloud Platform.

	تفعيل جوجل واجهة برمجة تطبيقات الأماكن (جديدة) وجوجل واجهة برمجة تطبيقات جافا سكريبت للخرائط. راجع التعليمات
	إنشاء مفتاح Google API وتقييده. راجع التعليمات
	أدخل مفتاح واجهة برمجة تطبيقات جوجل (Google API Key).

تفعيل في حقول العنوان

	أضف حقل العنوان إلى النموذج الخاص بك.
	افتح إعدادات الحقل، وانتقل إلى متقدم القسم، وقم بتمكين إكمال العنوان تلقائيًا مربع اختيار.

تفعيل حقول النص ذي السطر الواحد

	أضف حقل نص من سطر واحد إلى النموذج الخاص بك.
	افتح إعدادات الحقل، وانتقل إلى متقدم القسم، وقم بتمكين إكمال العنوان تلقائيًا مربع اختيار.

إنشاء مفتاح واجهة برمجة تطبيقات جوجل

إنشاء مشروع Google Cloud أو تحديد مشروع موجود

قبل أن تتمكن من الحصول على مفتاح Google API الخاص بك، عليك أن يُنشئ جديد مشروع Google Cloud Platform (أو اختر مشروعًا موجودًا إذا كان لديك واحد).

ملاحظة: إذا كنت تقوم بإنشاء مشروع GCP جديد، فنوصي بتحديد نطاقه للموقع الإلكتروني الذي تعمل عليه، وذلك تحسباً لاحتياجك إلى خدمات Google API أخرى لنفس الموقع الإلكتروني.

تفعيل واجهات برمجة التطبيقات المطلوبة

بعد إنشاء مشروع Google Cloud أو تحديده، انتقل إلى واجهات برمجة التطبيقات والخدمات > مكتبة واجهات برمجة التطبيقات وقم بتمكين واجهات برمجة التطبيقات التالية:

ملاحظة: تتطلب جوجل ربط حساب فوترة بمشروعك قبل تفعيل واجهة برمجة تطبيقات الأماكن. بالنسبة لمعظم المواقع، يندرج الاستخدام ضمن المستوى المجاني لجوجل، ولكن لا يزال يلزم توفير طريقة دفع.

واجهة برمجة تطبيقات الأماكن (جديدة)

رابط سريع

قد تلاحظ وجود "Places API" و "Places API (New)" - تم تصميم المكون الإضافي الخاص بنا ليكون متوافقًا مع "Places API (New)".“

واجهة برمجة تطبيقات جافا سكريبت للخرائط

رابط سريع

إنشاء مفتاح

الآن بعد أن قمت بتفعيل كلا واجهتي برمجة التطبيقات (APIs) داخل مشروعك، يمكنك إنشاء مفتاح واجهة برمجة التطبيقات (API Key) الخاص بك.

انتقل إلى واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد, ثم انقر فوق "+ إنشاء بيانات الاعتماد" وأخيراً انقر فوق "مفتاح API".“

ستظهر نافذة حوار جانبية حيث يمكنك تسمية مفتاحك.

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

ملاحظة: هذا مهم للغاية! المفاتيح مرئية، لذا لا تريد أن يستغل أي شخص سيء استخدامك المجاني.

استمر في التمرير إلى "قيود التطبيق" في نافذة الحوار.

ضمن قسم "قيود التطبيق"، اختر "المواقع الإلكترونية".“

ضمن قسم "قيود الموقع الإلكتروني"، أضف مواقعك الإلكترونية التي يجب استخدام مفتاح API فيها. لا تُضِف https.

نوصي بإضافة نطاق عام لضمان عمل المفتاح على نطاقات www والنطاقات غير www على النحو التالي: *.example-website.com/*

انقر على "إنشاء" وسيظهر مفتاحك بعد ذلك.

تم إنشاء مفتاح API الخاص بك الآن! انسخه والصقه في إعدادات الإكمال التلقائي للعناوين في الإضافة، وبذلك تكون قد انتهيت!

تنسيق النطاق: أدخل كل نطاق في سطر منفصل باستخدام التنسيق التالي: example.com/* - لا https://, لا توجد شرطة مائلة في نهاية اسم النطاق نفسه، ولكن يجب تضمين /* في النهاية للسماح بجميع الصفحات. لتغطية جميع النطاقات الفرعية (مثل wwwأضف إدخالاً منفصلاً كـ *.example.com/*. لأغراض التنمية المحلية، استخدم localhost أو localhost:3000/* حسب إعداداتك.

yourdomain.com/*
*.yourdomain.com/*
staging.yourdomain.com/*
localhost:8080/*

شروط خدمة جوجل وسياسة الخصوصية

تُرسل ميزة الإكمال التلقائي للعناوين من Plugin Brewery بيانات النموذج إلى خدمات جوجل لتشغيل عمليات البحث عن العناوين. ووفقًا لإرشادات جوجل، يجب على أي تطبيق يستخدم واجهة برمجة تطبيقات الأماكن (Places API) عرض رابط إلى موقع جوجل. شروط الخدمة وسياسة الخصوصية.

بحسب بلدك أو منطقتك، قد يُطلب منك أيضاً الحصول على موافقة المستخدم قبل جمع بيانات الموقع.

تفاصيل الميزة

أنواع الحقول المدعومة

يعمل على كلا نوعي حقول Gravity Forms:

• حقل العنوان (مدخلات متعددة)
• نص من سطر واحد (إدخال عنوان من سطر واحد)

استخدم حقول العنوان عندما تريد حقولًا فرعية أصلية لعناوين GF، أو استخدم نصًا من سطر واحد عندما تريد تصميم نموذج أبسط.

تحليل تعيين العناوين (جديد)

قم بربط مكونات العنوان المحددة بحقول مخصصة في النموذج الخاص بك:

• العنوان سطر 1
• سطر العنوان 2
• الرمز البريدي
• المدينة / البلدة
• الدولة / الإقليم / المنطقة
• دولة

مثالي للحقول المخفية المستخدمة في عمليات التحقق من مناطق التسليم، وتوجيه إدارة علاقات العملاء، والإشعارات المشروطة، والأتمتة.

البحث عن الرمز البريدي (جديد)

حوّل حقل النص ذي السطر الواحد إلى حقل بحث عن الرمز البريدي. فعّل خاصية الإكمال التلقائي للعناوين، ثم فعّل خاصية البحث عن الرمز البريدي في الإعدادات المتقدمة للحقل.

• تقتصر الاقتراحات على الرموز البريدية/ZIP
• يحتفظ الحقل بالرمز المحدد فقط (وليس العنوان الكامل).
• يتم ملء حقول المدينة والولاية/المنطقة (والبلد/المقاطعة إذا كانت موجودة على الخريطة) تلقائيًا، بما في ذلك الحقول المخفية.
• يعمل في أي دولة لديها رموز بريدية

مثالي لعمليات التحقق من منطقة الخدمة، ومنطق الشحن، وإرسال بيانات الموقع النظيفة إلى نظام إدارة علاقات العملاء الخاص بك.

معالجة البريد/الرمز البريدي (نص من سطر واحد)

بالنسبة لحقول النص ذي السطر الواحد، يستخدم الملحق تنسيق عنوان جوجل ويضيف الرمز البريدي إذا كان متوفرًا ولكنه غير موجود في النص المعروض. إذا لم تُظهر جوجل رمزًا بريديًا لنتيجة البحث، فلا يمكن إضافته.

تم حفظ البيانات الوصفية في بيانات الإدخال الوصفية

عندما يختار المستخدمون اقتراحًا، يقوم البرنامج المساعد بتخزين ما يلي:

• معرف المكان
• خط العرض
• خط الطول
• عنوان منسق

قيود الدول + الدعم الدولي

يمكنك حصر الاقتراحات ببلدان محددة باستخدام رموز ISO alpha-2 (على سبيل المثال: US,CA,GBأو تركها غير مقيدة بالنسبة للنماذج العالمية.

تعتبر التسميات وخيارات الخرائط محايدة من حيث البلد، لذا تظل سير العمل واضحة للفرق الأمريكية وغير الأمريكية.

الأداء + التوافق

مصمم لمواقع الإنتاج الواقعية:

• لا يتم تهيئة البرامج النصية للواجهة الأمامية إلا في حالة وجود حقول ممكّنة.
• يعمل مع تدفقات نماذج Gravity Forms القياسية و AJAX
• متوافق مع إعدادات التخزين المؤقت/شبكات توصيل المحتوى الشائعة في معظم التكوينات.

علامات الدمج

عندما يختار الزائر اقتراحًا من اقتراحات الإكمال التلقائي، يمكن للمكوّن الإضافي تخزين بيانات وصفية على هذا الإدخال. يمكنك إدراج هذه البيانات في رسائل التأكيد والإشعارات وغيرها من الأماكن التي تدعم علامات الدمج في نماذج Gravity Forms.

شكل: {pb_aac:ID:KEY}

استبدل ID بمعرف الحقل الخاص بالعنوان أو حقل النص ذي السطر الواحد الذي تم تمكين الإكمال التلقائي للعنوان فيه (نفس الحقل الذي تظهر فيه الاقتراحات).

المفاتيح المتاحة (KEY):

أمثلة (إذا كان حقل الإكمال التلقائي هو الحقل رقم 12):

• {pb_aac:12:place_id}
• {pb_aac:12:lat}
• {pb_aac:12:lng}
• {pb_aac:12:formatted}
• {pb_aac:12:google_maps_url}

أداة الاختيار: في محرر النموذج، تحصل الحقول الممكّنة أيضًا على هذه العلامات في أداة اختيار علامات الدمج تحت تسميات مثل "إكمال العنوان التلقائي: ...".

ملحوظة: لا توجد قيم إلا للإدخالات التي تم فيها تحديد اقتراح وحفظ البيانات الوصفية؛ وإلا فإن العلامة ستكون فارغة (بحسب التصميم).

الأسئلة الشائعة

هل واجهة برمجة تطبيقات Google Places مجانية؟

تُضيف جوجل تلقائيًا رصيدًا شهريًا بقيمة $200 إلى حسابك، ويُخصم منه تكلفة استخدامك لواجهة برمجة تطبيقات Places. بالنسبة لمعظم المواقع، يُغطي هذا الرصيد جميع التكاليف - وبالأسعار الحالية، يندرج ضمن هذا الرصيد حوالي 10,000 جلسة إكمال تلقائي شهريًا.

مع ذلك، قد تتغير الأسعار، لذا تحقق من ذلك. جدول أسعار منصة خرائط جوجل للحصول على أحدث الأرقام.

هل يمكنني استخدامه مع حقل "نص من سطر واحد"؟

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

هل يعمل مع العناوين الدولية؟

بالتأكيد. يدعم الملحق بيانات العناوين العالمية من جوجل.

هل الإعداد معقد؟

لا على الإطلاق. ما عليك سوى إضافة مفتاح Google API الخاص بك في إعدادات الإضافة، وتفعيل خاصية الإكمال التلقائي في الحقول التي تختارها، وانتهى الأمر. الأمر بهذه البساطة.

هل يمكنني حصر النتائج في بلدان محددة؟

نعم. في إعدادات الحقل، أدخل قائمة مفصولة بفواصل لرموز الدول وفقًا لمعيار ISO 3166-1 alpha-2 (على سبيل المثال،, US,CA,GB).

ما هي واجهة برمجة تطبيقات الأماكن التي يجب تفعيلها في Google Cloud؟

قم بتمكين "Places API (New)" نظرًا لأن "Places API" القديم من المقرر إيقافه و "Maps JavaScript API".

هل يمكنني استخدام بيانات تعريف العنوان في الإشعارات أو عمليات التكامل؟

نعم. تُضيف ميزة الإكمال التلقائي للعناوين علامات دمج لمعرّف المكان، وخط العرض، وخط الطول، والعنوان المنسق، ورابط خرائط جوجل. استخدم أداة اختيار علامات الدمج في Gravity Forms في أي إشعار أو تأكيد أو ربط موجز.

هل يستطيع المطورون تخصيص نتائج بحث جوجل؟

نعم. استخدم pb_aac_request فلتر جافا سكريبت لتعديل الطلب - على سبيل المثال، تحيز النتائج إلى منطقة معينة، أو إضافة مربع محيط، أو التوسع ليشمل الشركات.

هل يمكنني استخدام حقل للبحث عن الرمز البريدي؟

نعم. في حقل نصي من سطر واحد، فعّل خاصية الإكمال التلقائي للعنوان، ثم فعّل خاصية البحث عن الرمز البريدي. سيعرض الحقل اقتراحات للرموز البريدية، وسيؤدي اختيار أحدها إلى ملء حقول المدينة والولاية/المنطقة التي اخترتها (بما في ذلك الحقول المخفية). هذه الخاصية مفيدة جدًا لنماذج "التحقق من منطقتك" وتوجيه الرسائل في أنظمة إدارة علاقات العملاء (CRM).