הוקים של WooCommerce: מדריך ויזואלי אינטראקטיבי לכל עמוד

אם אי פעם ניסיתם לשנוצ עמוד או תבנית בחנות WooCommerce, כנראה והבנתם שהחלק הקשה ביותר הוא דווקא למצוא את ההוק הנכון. ל-WooCommerce יש למעלה מ-2,500 הוקים (כן, קראתם נכון), הוקים מסוג action ו-filter הפזורים בין templates, classes ו-APIs שונים.

המפה האינטראקטיבית שלמעלה נועדה בדיוק בשביל זה: היא מציגה באופן ויזואלי כל הוק של template, עבור כל אחד מעמודי WooCommerce.

מהם הוקים ב-WooCommerce

הוקים הם נקודות מוגדרות מראש בקוד של WooCommerce, שבהן תוכלו להזריק פונקציונליות משלכם. קיימים שני סוגים:

• הוקים מסוג action מאפשרים לכם להוסיף תוכן או להריץ קוד בנקודה מסוימת. WooCommerce קורא ל-do_action(), והפונקציה שלכם רצה.
• הוקים מסוג filter מאפשרים לכם לשנות מידע לפני ש-WooCommerce משתמש בו. WooCommerce מעביר את אותו מידע דרך apply_filters(), והפונקציה שלכם משנה אותו ומחזירה את התוצאה.

אם אתם רק מתחילים עם הוקים של WooCommerce, אני ממליץ לפתוח עם המדריך המלא שלי להוקים של WooCommerce להיכרות מעמיקה יותר. התחביר עצמו די פשוט, והקוד הבא יסביר זאת טוב ממני (כמובן):

// Action: add content after the product price
add_action( 'woocommerce_single_product_summary', 'my_custom_content', 15 );
function my_custom_content() {
    echo '<p>Custom content here</p>';
}

// Filter: modify the product tabs array
add_filter( 'woocommerce_product_tabs', 'my_custom_tabs' );
function my_custom_tabs( $tabs ) {
    unset( $tabs['reviews'] );
    return $tabs;
}

הפרמטר השלישי ב-add_action() הוא ה-priority (העדיפות). מספרים נמוכים רצים ראשונים. WooCommerce משתמש בקפיצות של 5 או 10 עבור ה-callbacks המובנים שלו, כך שנשאר מקום לקוד שלכם להשתלב ביניהם.

כיצד למצוא הוקים ב-WooCommerce

לפניכם שלוש שיטות מעשיות לגילוי הוקים בכל עמוד של WooCommerce:

1. הקובץ wc-template-hooks.php

קובץ בודד זה, הנמצא בתיקיית includes/ של WooCommerce, רושם את כל 73 ה-callbacks של הוקים מסוג template. זה מקור האמת (source of truth) לגבי מה ש-WooCommerce מחבר כברירת מחדל לכל הוק, ובאיזו priority.

wp-content/plugins/woocommerce/includes/wc-template-hooks.php

פתחו אותו וחפשו את ההוק שאתם צריכים. כל קריאה ל-add_action() ול-add_filter() מראה לכם בדיוק מה WooCommerce עושה עם כל הוק.

2. התוסף Query Monitor

התקינו את Query Monitor וגלשו לעמוד כלשהו של WooCommerce. הפאנל ״Hooks and Actions״ מציג כל הוק שנורה במהלך טעינת אותו עמוד, לפי סדר ההרצה, יחד עם ה-callbacks המחוברים אליו וה-priorities שלהם (אגב).

3. המפה האינטראקטיבית שלמעלה

את המפה הוויזואלית שבראש העמוד בניתי בדיוק בכדי לפתור את אותה בעיה. כל template של עמוד WooCommerce מיוצג כ-wireframe, כשההוקים ממוקמים בדיוק במקום בו הם נורים בתהליך הרינדור (העיבוד).

סדר ההרצה של ההוקים וה-Priorities

כל הוק ב-WooCommerce נורה ב-priority ספציפי. ה-callbacks המובנים של WooCommerce משתמשים בדרך כלל ב-priorities 5, 10, 20, 30, 40 ו-50. הקוד המותאם אישית שלכם משתלב ביניהם, בהתאם ל-priority שתגדירו.

ניקח את עמוד המוצר הבודד (single product) כדוגמה. ההוק woocommerce_single_product_summary הוא מעין container שאליו WooCommerce מחבר מספר callbacks ב-priorities שונים:

בכדי להוסיף תוכן מותאם אישית בין המחיר לתיאור הקצר, השתמשו ב-priority 15:

add_action( 'woocommerce_single_product_summary', 'my_custom_text_after_price', 15 );
function my_custom_text_after_price() {
    echo '<p class="custom-notice">Free shipping on orders over $50</p>';
}

בכדי להסיר אלמנט שמגיע כברירת מחדל, השתמשו ב-remove_action() עם אותו שם פונקציה ואותה priority בדיוק:

// Remove the product meta (SKU, categories, tags)
remove_action( 'woocommerce_single_product_summary', 'woocommerce_template_single_meta', 40 );

הוקים של WooCommerce ותשלום מבוסס בלוקים (Block Checkout)

WooCommerce מעביר בהדרגה את עמודי העגלה והתשלום שלו לארכיטקטורה מבוססת בלוקים (blocks). מהלך זה יוצר שתי מערכות מקבילות שכל מפתח צריך להכיר.

האימוץ [של ה-Block Checkout] נמוך מהצפוי – צוות WooCommerce, אפריל 2025

נכון לתחילת 2026, כ-87% מחנויות WooCommerce עדיין משתמשות בעמוד התשלום הקלאסי, המבוסס על shortcode. רק 35 הוקים קלאסיים הועברו רשמית לעבוד עם ה-Block Checkout: 24 מסוג filter ו-11 מסוג action.

הוקים קלאסיים של PHP פשוט אינם נורים כשה-checkout מבוסס הבלוקים עולה. WooCommerce מציע שלושה מסלולים להתאמה אישית של הגרסה מבוססת הבלוקים (בשלב זה):

1. הוקים שהועברו – 35 הוקים שעובדים גם בהקשר הקלאסי וגם בבלוקים, כמו הוקים לחישוב משלוח ומס והוקים של טפסי החיוב והמשלוח.
2. Checkout Extensibility API – filters מבוססי JavaScript ורכיבי Slot/Fill עבור ה-Block Checkout. דורש ידע ב-webpack וב-React.
3. Additional Checkout Fields API – הוצג ב-WooCommerce 8.6 ומעלה, ומחליף את ה-filter woocommerce_checkout_fields להוספת שדות מותאמים ב-Block Checkout.

בשלב זה, אני ממליץ לכוון להוקים הקלאסיים ברוב הפרויקטים. כשאימוץ ה-Block Checkout יגדל, אני מבטיח לעדכן את מדריך זה עם לשונית ייעודית להוקים של בלוקים.

משימות נפוצות – באיזה הוק להשתמש

במקום לחפש בין שמות ההוקים, מצאו את המשימה שאתם צריכים והשתמשו בהוק המומלץ:

שאלות נפוצות

שאלות נפוצות לגבי הוקים ב-WooCommerce:

לסיכום

יותר מ-2,500 הוקים של WooCommerce נותנים לכם שליטה מלאה בכל עמוד, אבל רק אם אתם יודעים באיזה הוק להשתמש והיכן הוא נורה. מפה ויזואלית זו מכסה את חמשת ה-templates המרכזיים של WooCommerce: מוצר בודד, ארכיון החנות, עגלה, תשלום ו״החשבון שלי״. כל הוק ממוקם בדיוק במקום בו הוא רץ במהלך הרינדור (הצגת העמוד), כאשר הסוג שלו, ה-priority וה-callbacks המובנים גלויים בלחיצה.

השתמשו במפה האינטראקטיבית כנקודת ייחוס בכל פעם שאתם בונים התאמות ל-WooCommerce. הוסיפו עמוד זה למועדפים – אדאג לשמור אותו מעודכן עם התפתחות מערכת ההוקים של WooCommerce, ובמיוחד ככל שיגדל אימוץ התשלום מבוסס הבלוקים.