مرشح فئات اياكس ورد الاستضافة

المقدمة

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

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

اياكس على الجانب الإدارة

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

يستخدم هذا المثال قصيرة PHP لكتابة جافا سكريبت في تذييل الصفحة. هذا السيناريو ثم بتشغيل طلب AJAX عندما يتم تحميل الصفحة بالكامل:

ملاحظة: منذ النسخة 2.8. جافا سكريبت ajaxurl متغير عالمي يمكن استخدامها في حال كنت ترغب في فصل شفرة جافا سكريبت الخاصة بك من ملفات PHP إلى جافا سكريبت الملفات فقط. وهذا ينطبق على الجانب الإداري فقط. إذا كنت تستخدم AJAX على الواجهة الأمامية، تحتاج إلى إجراء جافا سكريبت على بينة من رابط-المشرف ajax.php. تم توثيقه وأفضل الممارسات في المثال الرابع، أدناه باستخدام wp_localize_script ().

ثم، وإنشاء وظيفة PHP على التعامل مع الطلب AJAX.

لاحظ كيف أن 'العمل' مفتاح لقيمة 'my_action "، الذي يعرف في جافا سكريبت أعلاه، مباريات النصف الأخير من العمل" wp_ajax_my_action "في منطقتنا معالج AJAX أدناه. هذا هو لأنه يستخدم لاستدعاء الدالة PHP جانب الخادم من خلال المشرف-ajax.php. إذا لم يتم تحديد هذا العمل، والمشرف-ajax.php الخروج، والعودة 0 في العملية.

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

لاحظ استخدام wp_die (). بدلا من يموت () أو خروج (). معظم الوقت الذي يجب أن تستخدم wp_die () في وظيفة رد اياكس الخاص بك. وهذا يوفر تكامل أفضل مع وورد ويجعل من الاسهل لاختبار التعليمات البرمجية.

ملف جافا سكريبت منفصل

نفس سبيل المثال كما في السابق، إلا مع جافا سكريبت على ملف خارجي مستقل وسوف ندعو شبيبة / my_query.js. الأمثلة قريبة إلى مجلد البرنامج المساعد.

مع ملفات JavaScript الخارجية، يجب علينا أولا wp_enqueue_script () بحيث يتم تضمينها على الصفحة. بالإضافة إلى ذلك، يجب علينا أن نستخدم wp_localize_script () لتمرير القيم إلى خصائص الكائن جافا سكريبت، منذ PHP لا يمكن القيم صدى مباشرة في ملف جافا سكريبت. وظيفة معالج هو نفس المثال السابق.

اياكس على الجانب مواجهة عارض

منذ وورد 2.8، هناك ربط مماثلة لwp_ajax_ (العمل).

لذا، إذا كنت تريد أن إطلاق النار على الواجهة الأمامية لكل من الزوار والمستخدمين المسجلين، يمكنك القيام بذلك:

ملاحظة: خلافا على الجانب المشرف، لا يحصل تعريف ajaxurl جافا سكريبت العالمية تلقائيا بالنسبة لك، إلا إذا كان لديك BuddyPress أو إضافة أخرى اياكس تعتمد تثبيت. وذلك بدلا من الاعتماد على متغير جافا سكريبت العالمي، أن يعلن كائن مساحة جافا سكريبت مع الملكية الخاصة، ajaxurl. هل يمكن أيضا استخدام wp_localize_script () لجعل URL المتاحة لالسيناريو الخاص بك، وتوليد باستخدام هذا التعبير: ADMIN_URL ( 'مشرف-ajax.php')

ملاحظة 2: كلا الأمامية وطلبات اياكس الخلفية تستخدم المشرف-ajax.php ذلك is_admin () سيعود دائما صحيحا في العمل الخاص بك التعامل مع التعليمات البرمجية. عند تحميل بشكل انتقائي الخاص معالجات النصي اياكس لالأمامية والخلفية، واستخدام وظيفة is_admin ()، wp_ajax_ الخاص بك (العمل) وwp_ajax_nopriv_ (العمل) السنانير يجب أن تكون داخل is_admin () === جزء صحيح.

يتم تنفيذ طلبات اياكس بد أن الإجراءات إما wp_ajax_ أو wp_ajax_nopriv_ في سياق WP المسؤول. النظر بعناية في الإجراءات التي تقوم بتنفيذ في التعليمات البرمجية منذ المستخدمين المحرومين أو الزوار سوف تكون قادرة على تحريك طلبات مع أذونات مرتفعة أنهم قد لا يؤذن لل.

هنا العمل my_frontend_action اياكس من شأنه أن يؤدي وظيفة my_frontend_action_callback PHP () لجميع المستخدمين. فإن العمل my_backend_action اياكس تؤدي الى PHP وظيفة my_backend_action_callback () للمستخدمين بتسجيل الدخول في فقط.

ما بعد الحمل جافا سكريبت الحدث

الإضافات والموضوعات التي إدراج المحتوى عبر اياكس يجب أن تؤدي إلى حالة ما بعد الحمل على document.body بعد إدراج المحتوى. النصوص الأخرى التي تعتمد على التفاعل جافا سكريبت بعد الإدراج المحتوى، مثل AddToAny أو برنامج نصي مسج البناء، والاستماع لهذا الحدث ما بعد الحمل لتهيئة جافا سكريبت المطلوبة لديهم. عندما يتم تشغيل الحدث بعد التحميل من اللانهائي انتقل من Jetpack ل. على سبيل المثال، يعرض AddToAny أزرار سهم لكل وظيفة، ومسج البناء المواقف العناصر على الصفحة.

جافا سكريبت مما اثار حالة ما بعد الحمل بعد أن تم إدخال المحتوى عبر اياكس:

جافا سكريبت الاستماع إلى الحدث ما بعد الحمل:

ملاحظة على مسج: حذار من استخدام الأسلوب تحميل مسج مع تعبير محدد لإدراج المحتوى لأنه سيتسبب