كيفية استخدام WooCommerce Hooks - دليل كامل

سنناقش في هذه المقالة كيف يمكنك استخدام WooCommerce Hooks لتوسيع متجر WooCommerce وفقًا لمتطلباتك.

هل تساءلت يومًا كيف أصبح WordPress كبيرًا جدًا؟ أكثر من 40٪ من مواقع الويب العالمية تستخدم الآن WordPress كنظام إدارة محتوى خاص بهم. أصبح كل ذلك ممكنًا من خلال الخطافات والمرشحات باستخدام الأشخاص الذين أنشأوا آلاف المكونات الإضافية.

من وقت لآخر ، قد تستمع إلى أشخاص يقولون إن PHP ستموت قريبًا ، ومع ذلك تستمر مشاركة WordPress في النمو ويعتمد WordPress بالكامل على PHP. حسنًا ، فقط الوقت سيخبرنا.

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

ما هي الخطافات؟

من الممكن تعديل أو إضافة كود في WordPress دون تحرير الملفات الأساسية باستخدام الخطافات.

يستخدم WordPress و WooCommerce استخدامًا مكثفًا للخطافات ، وهي وظائف يمكن لمطوري WordPress و WooCommerce تخصيصها. الخطافات من نوعين

1. الإجراءات : تسمح لك هذه الأنواع من الخطافات بتنفيذ تعليمات برمجية مخصصة متى تم تشغيلها.
2. المرشحات : تسمح لك Filter Hooks بمعالجة وإرجاع قيمة (على سبيل المثال ، سعر المنتج) حيث يتم تمريرها عبر وظائف معينة.

WooCommerce هو مكون إضافي لبرنامج WordPress تم إنشاؤه أيضًا باستخدام Actions and Hooks ، ومع ذلك ، يمكن لكل مكون إضافي أيضًا إنشاء Hooks و Filter الخاصة به والتي يمكن لمطوري المكونات الإضافية الآخرين استخدامها لتوسيع وظائف المكون الإضافي بشكل أكبر.

خطاف WooCommerce

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

 <?php /** * Plugin Name: CyberPanel * Plugin URI: https://cyberpanel.net * Description: CyberPanel Tutorial * Version: 1.0.0 * Requires at least: 5.2 * Requires PHP: 7.1 * Author: Usman Nasir * Author URI: https://cyberpanel.net * License: GPL v2 or later * License URI: https://www.gnu.org/licenses/gpl-2.0.html */ if (!defined('WPINC')) { die("Please don't run via command line."); }

مع استمرارنا في البرنامج التعليمي ، سنستمر في إضافة المزيد من التعليمات البرمجية إلى هذا الملف.

المنتج خطاف WooCommerce

سنبدأ أولاً بالخطافات التي يمكنك استخدامها في صفحات المنتج ، وسنقدم لك لاحقًا مثالاً رمزًا لكيفية استخدام woocommerce_before_single_product لعرض شيء ما فوق منتجك.

يتم عرض الخطافات في أعلى وأسفل صفحة المنتج

• woocommerce_before_main_content
• woocommerce_after_main_content

خطافات معروضة أعلى وأسفل وصف المنتج

• woocommerce_before_single_product_summary
• woocommerce_after_single_product_summary

يتم عرض الخطافات في أعلى وأسفل صفحة المنتج

• woocommerce_before_single_product
• woocommerce_after_single_product

الخطافات التي يتم عرضها في وصف المنتج القصير

• woocommerce_single_product_summary
• woocommerce_product_meta_start
• woocommerce_product_meta_end
• woocommerce_share

يتم عرض الخطافات في التعليقات

• woocommerce_review_before
• woocommerce_review_before_comment_meta
• woocommerce_review_meta
• woocommerce_review_before_comment_text
• woocommerce_review_comment_text
• woocommerce_review_after_comment_text

woocommerce_before_single_product

لنفترض الآن أنك تريد عرض شيء ما في أعلى صفحة منتجك الفردية ، يمكنك استخدام WooCommerce Hooks المسماة woocommerce_before_single_product ، بدا الكود الخاص بنا على النحو التالي:

 add_action( 'woocommerce_before_single_product', 'woocommerce_output_all_notices_custom', 10 ); function woocommerce_output_all_notices_custom() { echo "hello world"; }

يمكنك الآن أن ترى في الصورة أدناه أن hello world مطبوع أعلى صورة المنتج

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

 <?php /** * Plugin Name: CyberPanel * Plugin URI: https://cyberwp.cloud * Description: Manage multiple CyberPanel installations via WordPress. * Version: 1.0.0 * Requires at least: 5.2 * Requires PHP: 7.1 * Author: Usman Nasir * Author URI: https://cyberwp.cloud * License: GPL v2 or later * License URI: https://www.gnu.org/licenses/gpl-2.0.html */ if (!defined('WPINC')) { die("Please don't run via command line."); } add_action( 'woocommerce_before_single_product', 'woocommerce_output_all_notices_custom', 10 ); function woocommerce_output_all_notices_custom() { echo "hello world"; }

خطافات عربة WooCommerce

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

يتم عرض الخطافات قبل قائمة المنتجات في عربة التسوق

• woocommerce_before_cart
• woocommerce_before_cart_table
• woocommerce_before_cart_contents
• woocommerce_cart_contents
• woocommerce_after_cart_contents

يتم عرض الخطافات بعد قائمة المنتجات في عربة التسوق

• woocommerce_cart_coupon
• woocommerce_cart_actions
• woocommerce_after_cart_table
• woocommerce_cart_collaterals
• woocommerce_before_cart_totals

يتم عرض الخطافات في نهاية الأمر

• woocommerce_cart_totals_before_shipping
• woocommerce_cart_totals_after_shipping
• woocommerce_cart_totals_before_order_total
• woocommerce_cart_totals_after_order_total
• woocommerce_after_shipping_rate
• woocommerce_before_shipping_calculator
• woocommerce_proceed_to_checkout
• woocommerce_after_cart_totals
• woocommerce_after_cart

وإذا لم تكن هناك منتجات في العربة ، فسيتم استخدام الخطاف التالي

woocommerce_cart_is_empty

woocommerce_before_cart

دعنا نرى كيف يمكننا استخدام خطاف woocommerce_before_cart لعرض شيء ما قبل طاولة عربة التسوق

ومقتطف الشفرة لهذا هو

 add_action( 'woocommerce_before_cart', 'woocommerce_before_cart_custom', 10, 0 ); function woocommerce_before_cart_custom() { echo "before cart content"; }

وسيبدو الرمز النهائي هكذا

 <?php /** * Plugin Name: CyberPanel * Plugin URI: https://cyberpanel.net * Description: CyberPanel Tutorial * Version: 1.0.0 * Requires at least: 5.2 * Requires PHP: 7.1 * Author: Usman Nasir * Author URI: https://cyberpanel.net * License: GPL v2 or later * License URI: https://www.gnu.org/licenses/gpl-2.0.html */ if (!defined('WPINC')) { die("Please don't run via command line."); } add_action( 'woocommerce_before_single_product', 'woocommerce_output_all_notices_custom', 10 ); function woocommerce_output_all_notices_custom() { echo "hello world"; } add_action( 'woocommerce_before_cart', 'woocommerce_before_cart_custom', 10, 0 ); function woocommerce_before_cart_custom() { echo "before cart content"; }

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

تسجيل الخروج - خطافات WooCommerce

صفحة الخروج هي صفحة مهمة للغاية وعملية في متجر WooCommerce. فئات متعددة من الخطافات المستخدمة في صفحات الخروج مذكورة أدناه.

الخطافات المستخدمة قبل شكل من أشكال معلومات الاتصال بالمستخدم

• woocommerce_before_checkout_form
• woocommerce_checkout_before_customer_details
• woocommerce_checkout_billing
• woocommerce_before_checkout_billing_form

الخطافات المستخدمة لإعداد ترميز تفاصيل الفواتير

• woocommerce_after_checkout_billing_form
• woocommerce_checkout_shipping
• woocommerce_before_order_notes
• woocommerce_after_order_notes

الخطافات المستخدمة قبل ملخص المنتج بالترتيب

• woocommerce_checkout_after_customer_details
• woocommerce_checkout_before_order_review
• woocommerce_review_order_before_cart_contents
• woocommerce_review_order_after_cart_contents
• woocommerce_review_order_before_shipping
• woocommerce_review_order_after_shipping
• woocommerce_review_order_before_order_total
• woocommerce_review_order_after_order_total

يتم عرض الخطافات أسفل نموذج الطلب

• woocommerce_checkout_order_review
• woocommerce_review_order_before_payment
• woocommerce_review_order_before_submit
• woocommerce_review_order_after_submit
• woocommerce_review_order_after_payment
• woocommerce_after_checkout_form

خطافات فئة WooCommerce

عرض عنوان الفئة

woocommerce_archive_description

woocommerce_shop_loop

يتم عرضها قبل بطاقة المنتج في القائمة.

woocommerce_before_shop_loop

يتم عرضه فوق قائمة المنتجات في الفئة.

woocommerce_after_shop_loop

يتم عرضه أسفل قائمة المنتجات في الفئة.

woocommerce_after_shop_loop_item

يتم عرضه في نهاية كل وصف لبطاقة المنتج.

الخطافات التي تحدد بالإضافة إلى ذلك بطاقة المنتج في القائمة.

• woocommerce_after_shop_loop_item_title
• woocommerce_shop_loop_item_title
• woocommerce_before_shop_loop_item_title

استنتاج

لقد بذلنا قصارى جهدنا لنقدم لك تمثيلًا مرئيًا لجميع أدوات الاستيراد تقريبًا التي يمكنك استخدامها لتوسيع متجر WooCommerce الخاص بك.

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

هناك احتمالات غير محدودة بين يديك ، إذا كان لا يزال لديك أي أسئلة فلا تتردد في طرحها في مربع التعليقات أدناه.