מדריך Hooks ו-Filters
מדריך Hooks ו-Filters
מסמך זה מספק תיעוד מקיף של כל hooks ו-filters של WordPress בהם משתמש ומספק WooAI Chatbot Pro. הבנת נקודות הרחבה אלו מאפשרת למפתחים להתאים אישית את התנהגות התוסף, לשלב עם מערכות חיצוניות ולבנות פונקציונליות מותאמת.
1. Hooks של WordPress בשימוש
WooAI Chatbot Pro משתלב עם hooks ליבה של WordPress לאתחול, פונקציונליות מנהל ורינדור בצד לקוח.
plugins_loaded
מאתחל את התוסף לאחר שכל התוספים נטענו. זוהי נקודת הכניסה הראשית.
// includes/class-plugin.php
add_action( 'plugins_loaded', 'woo_ai_chatbot_init' );
// i18n initialization
$this->loader->add_action( 'plugins_loaded', $i18n, 'load_plugin_textdomain' );
השתמשו בזה כדי:
– לאמת תלויות תוסף לפני אתחול
– לשנות התנהגות תוסף מוקדם במחזור החיים
add_action( 'plugins_loaded', function() {
// Check if WooAI Chatbot is active
if ( class_exists( 'WooAIChatbotPlugin' ) ) {
// Your initialization code
}
}, 20 ); // Priority 20 runs after plugin init (priority 10)
admin_menu
רושם את עמודי תפריט המנהל של התוסף.
$this->loader->add_action( 'admin_menu', $admin, 'add_admin_menu' );
פרמטרים: אין
admin_init
רושם הגדרות תוסף עם WordPress Settings API.
$this->loader->add_action( 'admin_init', $settings, 'register_settings' );
מקרה שימוש: רישום שדות הגדרות נוספים או שינוי הגדרות קיימות.
admin_notices
מציג התראות מנהל עבור סטטוס רישיון ובריאות מערכת RAG.
$this->loader->add_action( 'admin_notices', $admin, 'display_rag_status_notices' );
$this->loader->add_action( 'admin_notices', $admin, 'display_license_notices' );
admin_enqueue_scripts
טוען נכסי JavaScript ו-CSS של מנהל.
$this->loader->add_action( 'admin_enqueue_scripts', $admin, 'enqueue_scripts' );
Hook Priority: 10 (ברירת מחדל)
wp_enqueue_scripts
טוען נכסי widget בצד לקוח (JavaScript, CSS, תרגומים).
$this->loader->add_action( 'wp_enqueue_scripts', $widget, 'enqueue_scripts' );
$this->loader->add_action( 'wp_enqueue_scripts', $analytics, 'enqueue_tracking_script' );
wp_footer
מרנדר את markup של widget הצ’אט ב-footer.
$this->loader->add_action( 'wp_footer', $widget, 'render_widget' );
רינדור מותנה: רינדור Widget מכבד החרגות עמודים, הגדרות מכשיר ומסנני תצוגה.
wp_head
מזריק קוד מעקב אנליטיקה (GA4, Meta Pixel, Mixpanel).
add_action( 'wp_head', array( $this, 'inject_tracking_code' ), 1 );
Priority: 1 (הזרקה מוקדמת למעקב מדויק)
rest_api_init
רושם את כל נקודות הקצה של REST API עבור התוסף.
$this->loader->add_action( 'rest_api_init', $chat_api, 'register_routes' );
$this->loader->add_action( 'rest_api_init', $settings, 'register_rest_routes' );
$this->loader->add_action( 'rest_api_init', $analytics_api, 'register_routes' );
$this->loader->add_action( 'rest_api_init', $playbooks_api, 'register_routes' );
$this->loader->add_action( 'rest_api_init', $topics_api, 'register_routes' );
$this->loader->add_action( 'rest_api_init', $rag_api, 'register_routes' );
$this->loader->add_action( 'rest_api_init', $promotion_api, 'register_routes' );
$this->loader->add_action( 'rest_api_init', $license_api, 'register_routes' );
REST Namespace: woo-ai-chatbot/v1
2. Hooks של WooCommerce בשימוש
התוסף ממנף hooks של WooCommerce לאינדוקס מוצרים ומעקב אחר התנהגות משתמש.
woocommerce_update_product / woocommerce_new_product
מפעיל אינדוקס מוצרים אוטומטי כאשר מוצרים נוצרים או מתעדכנים.
$this->loader->add_action( 'woocommerce_update_product', $this, 'index_product_on_save', 10, 1 );
$this->loader->add_action( 'woocommerce_new_product', $this, 'index_product_on_save', 10, 1 );
פרמטרים:
– $product_id (int) – מזהה המוצר שנשמר
התנהגות: מתזמן אינדוקס ברקע דרך אירוע cron woo_ai_chatbot_index_product.
woocommerce_delete_product
מסיר מוצרים שנמחקו מאינדקס הוקטורים.
add_action( 'woocommerce_delete_product', array( $this, 'hook_delete_product_index' ), 10, 1 );
woocommerce_before_single_product
עוקב אחר צפיות בדף מוצר להעשרת הקשר AI.
add_action( 'woocommerce_before_single_product', array( $this, 'track_product_view' ), 10 );
אירוע מתועד: product_view עם פרטי מוצר ומקור הפניה
woocommerce_add_to_cart
עוקב כאשר משתמשים מוסיפים מוצרים לעגלה.
add_action( 'woocommerce_add_to_cart', array( $this, 'track_cart_add' ), 10, 6 );
פרמטרים:
– $cart_item_key (string) – מפתח פריט עגלה
– $product_id (int) – מזהה מוצר
– $quantity (int) – כמות שהתווספה
– $variation_id (int) – מזהה וריאציה (0 אם מוצר פשוט)
– $variation (array) – תכונות וריאציה
– $cart_item_data (array) – נתוני פריט עגלה נוספים
woocommerce_cart_item_removed
עוקב אחר הסרות פריטים מעגלה לניתוח עגלות נטושות.
add_action( 'woocommerce_cart_item_removed', array( $this, 'track_cart_remove' ), 10, 2 );
woocommerce_before_checkout_form
עוקב אחר התחלת checkout לניתוח משפך המרה.
add_action( 'woocommerce_before_checkout_form', array( $this, 'track_checkout_start' ), 10 );
woocommerce_thankyou
עוקב אחר רכישות שהושלמו עם פרטי הזמנה.
add_action( 'woocommerce_thankyou', array( $this, 'track_purchase' ), 10, 1 );
פרמטרים:
– $order_id (int) – מזהה ההזמנה שהושלמה
pre_get_posts
מיירט שאילתות חיפוש מוצרים למעקב אחר התנהגות חיפוש.
add_action( 'pre_get_posts', array( $this, 'track_product_search' ), 10, 1 );
פרמטרים:
– $query (WP_Query) – אובייקט השאילתה
3. Actions מותאמים שמסופקים
hooks של do_action() אלו מאפשרים למפתחים להרחיב פונקציונליות תוסף בנקודות ביצוע מפתח.
woo_ai_chatbot_rtl_detected
מופעל כאשר שפת RTL (מימין לשמאל) מזוהה במהלך אתחול התוסף.
do_action( 'woo_ai_chatbot_rtl_detected' );
מקרה שימוש: טעינת stylesheets ספציפיים ל-RTL או שינוי התנהגות UI.
add_action( 'woo_ai_chatbot_rtl_detected', function() {
// Load RTL stylesheet
wp_enqueue_style(
'woo-ai-chatbot-rtl',
plugin_dir_url( __FILE__ ) . 'assets/css/rtl.css',
array( 'woo-ai-chatbot' ),
'1.0.0'
);
// Add RTL body class
add_filter( 'body_class', function( $classes ) {
$classes[] = 'woo-ai-chatbot-rtl';
return $classes;
});
});
woo_ai_product_search
מופעל לאחר ביצוע חיפוש מוצרים, שימושי לאנליטיקה ו-debugging.
do_action( 'woo_ai_product_search', $search_term, $search_method, count( $products ) );
פרמטרים:
– $search_term (string) – שאילתת החיפוש
– $search_method (string) – שיטת חיפוש שנעשה בה שימוש (semantic, keyword, hybrid)
– $count (int) – מספר תוצאות שהוחזרו
דוגמה:
add_action( 'woo_ai_product_search', function( $term, $method, $count ) {
// Log to external analytics
error_log( sprintf(
'WooAI Search: "%s" via %s returned %d results',
$term,
$method,
$count
));
// Track in custom analytics
if ( class_exists( 'My_Analytics' ) ) {
My_Analytics::track( 'chatbot_search', [
'query' => $term,
'method' => $method,
'results' => $count,
]);
}
}, 10, 3 );
4. Filters מותאמים שמסופקים
hooks של apply_filters() אלו מאפשרים שינוי נתונים והתנהגות של התוסף.
woo_ai_chatbot_should_display
שולט בנראות widget בצד לקוח.
$should_display = apply_filters( 'woo_ai_chatbot_should_display', true );
פרמטרים:
– $should_display (bool) – האם widget צריך להיות מרונדר
מחזיר: bool
דוגמה:
add_filter( 'woo_ai_chatbot_should_display', function( $display ) {
// Hide on specific product categories
if ( is_product() ) {
global $product;
if ( has_term( 'restricted', 'product_cat', $product->get_id() ) ) {
return false;
}
}
// Hide for specific user roles
if ( current_user_can( 'administrator' ) ) {
return false; // Admins use direct support
}
return $display;
});
woo_ai_chatbot_format_response
משנה את התגובה המפורמטת לפני החזרה לצד לקוח.
$response = apply_filters( 'woo_ai_chatbot_format_response', $response, $ai_response, $intent );
פרמטרים:
– $response (array) – תגובה מפורמטת עם text, type, data, quickReplies
– $ai_response (array) – תגובת AI גולמית
– $intent (string) – Intent שזוהה (product_search, cart_help וכו’)
מחזיר: array
דוגמה:
add_filter( 'woo_ai_chatbot_format_response', function( $response, $ai_response, $intent ) {
// Add custom branding to all responses
$response['data']['branding'] = [
'logo' => get_site_icon_url(),
'name' => get_bloginfo( 'name' ),
];
// Add promotion banner for product searches
if ( $intent === 'product_search' ) {
$response['data']['promotion'] = [
'text' => 'Free shipping on orders over $50!',
'code' => 'FREESHIP50',
];
}
return $response;
}, 10, 3 );
woo_ai_chatbot_quick_replies
מתאים אישית הצעות תגובה מהירה בהתבסס על intent.
$quick_replies = apply_filters( 'woo_ai_chatbot_quick_replies', $quick_replies, $intent );
פרמטרים:
– $quick_replies (array) – מערך של ['label' => string, 'value' => string]
– $intent (string) – Intent שזוהה
מחזיר: array
דוגמה:
add_filter( 'woo_ai_chatbot_quick_replies', function( $replies, $intent ) {
// Add custom quick replies for product search
if ( $intent === 'product_search' ) {
$replies[] = [
'label' => __( 'View all on sale', 'my-plugin' ),
'value' => 'show_sale_products',
];
$replies[] = [
'label' => __( 'New arrivals', 'my-plugin' ),
'value' => 'show_new_arrivals',
];
}
return $replies;
}, 10, 2 );
woo_ai_chatbot_topics
משנה הגדרות נושאים זמינות עבור מזהה הנושאים.
$topics = apply_filters( 'woo_ai_chatbot_topics', $topics );
פרמטרים:
– $topics (array) – מערך אסוציאטיבי של הגדרות נושאים
מחזיר: array
דוגמה:
add_filter( 'woo_ai_chatbot_topics', function( $topics ) {
// Add custom topic for warranty inquiries
$topics['warranty'] = [
'slug' => 'warranty',
'name' => 'Warranty Support',
'keywords' => ['warranty', 'guarantee', 'repair', 'broken', 'defect'],
'patterns' => ['/warrantys+(claim|policy|period)/i'],
'priority' => 80,
'handler' => 'WarrantyHandler',
'description' => 'Product warranty and repair inquiries',
];
return $topics;
});
woo_ai_chatbot_detected_topics
משנה תוצאות זיהוי נושאים לפני שהן משמשות לניתוב.
$result = apply_filters( 'woo_ai_chatbot_detected_topics', $result, $message, $context );
פרמטרים:
– $result (array) – תוצאת זיהוי עם primary, secondary, confidence, keywords_matched
– $message (string) – הודעת משתמש מקורית
– $context (array) – הקשר session
מחזיר: array
דוגמה:
add_filter( 'woo_ai_chatbot_detected_topics', function( $result, $message, $context ) {
// Override topic based on user segment
$user_id = get_current_user_id();
if ( $user_id && get_user_meta( $user_id, 'vip_customer', true ) ) {
// VIP customers always get priority support topic
if ( $result['confidence'] < 0.5 ) {
$result['primary'] = 'vip_support';
$result['confidence'] = 0.9;
}
}
return $result;
}, 10, 3 );
woo_ai_chatbot_trending_topics
מסנן סטטיסטיקות נושאים מגמתיים לתצוגת אנליטיקה.
$topic_stats = apply_filters( 'woo_ai_chatbot_trending_topics', $topic_stats, $days );
פרמטרים:
– $topic_stats (array) – סטטיסטיקות שימוש בנושאים
– $days (int) – מספר ימים שנותחו
מחזיר: array
woo_ai_chatbot_topic_handlers
רושם handlers מותאמים לניתוב נושאים.
$handlers = apply_filters( 'woo_ai_chatbot_topic_handlers', $handlers );
פרמטרים:
– $handlers (array) – מיפויי class handler ['topic_slug' => 'HandlerClass']
מחזיר: array
דוגמה:
add_filter( 'woo_ai_chatbot_topic_handlers', function( $handlers ) {
$handlers['warranty'] = 'MyPluginHandlersWarrantyHandler';
$handlers['appointments'] = 'MyPluginHandlersAppointmentHandler';
return $handlers;
});
woo_ai_chatbot_match_playbook
דורס או משנה לוגיקת התאמת playbook.
$playbook = apply_filters( 'woo_ai_chatbot_match_playbook', $best_match, $message, $context );
פרמטרים:
– $best_match (array|null) – Playbook שהותאם או null
– $message (string) – הודעת משתמש
– $context (array) – הקשר session
מחזיר: array|null
דוגמה:
add_filter( 'woo_ai_chatbot_match_playbook', function( $playbook, $message, $context ) {
// Force specific playbook for returning customers
if ( is_user_logged_in() && empty( $playbook ) ) {
$order_count = wc_get_customer_order_count( get_current_user_id() );
if ( $order_count > 5 && stripos( $message, 'help' ) !== false ) {
// Return VIP support playbook for loyal customers
return [
'slug' => 'vip_support',
'name' => 'VIP Customer Support',
'priority' => 100,
];
}
}
return $playbook;
}, 10, 3 );
woo_ai_chatbot_playbook_response
משנה תגובות ביצוע playbook.
$response = apply_filters( 'woo_ai_chatbot_playbook_response', $response, $playbook, $context );
פרמטרים:
– $response (array) – תגובת Playbook עם text, type, quickReplies
– $playbook (array) – נתוני Playbook שבוצע
– $context (array) – הקשר session
מחזיר: array
דוגמה:
add_filter( 'woo_ai_chatbot_playbook_response', function( $response, $playbook, $context ) {
// Add playbook tracking data
$response['data']['playbook_id'] = $playbook['slug'];
$response['data']['step'] = $context['current_step'] ?? 0;
// Add escalation option for support playbooks
if ( strpos( $playbook['slug'], 'support' ) !== false ) {
$response['quickReplies'][] = [
'label' => __( 'Talk to human', 'my-plugin' ),
'value' => 'escalate_to_human',
];
}
return $response;
}, 10, 3 );
woo_ai_chatbot_shipping_info
מתאים אישית את תגובת מידע משלוח.
$message = apply_filters( 'woo_ai_chatbot_shipping_info', $message );
פרמטרים:
– $message (string) – הודעת משלוח ברירת מחדל
מחזיר: string
דוגמה:
add_filter( 'woo_ai_chatbot_shipping_info', function( $message ) {
return sprintf(
__( 'We ship worldwide! Standard delivery: 5-7 days ($%d). Express: 2-3 days ($%d). Free shipping on orders over $%d.', 'my-store' ),
8,
25,
75
);
});
woo_ai_chatbot_return_policy
מתאים אישית את תגובת מדיניות החזרות.
$message = apply_filters( 'woo_ai_chatbot_return_policy', $message );
פרמטרים:
– $message (string) – הודעת מדיניות החזרות ברירת מחדל
מחזיר: string
דוגמה:
add_filter( 'woo_ai_chatbot_return_policy', function( $message ) {
$policy_page = get_permalink( wc_get_page_id( 'refund_returns' ) );
return sprintf(
__( '30-day hassle-free returns. Items must be unworn with tags. View full policy: %s', 'my-store' ),
$policy_page
);
});
waa_search_results_before_boost / waa_search_results_after_boost
משנה תוצאות חיפוש לפני ואחרי שהגברת מבצע מוחלת.
$results = apply_filters( 'waa_search_results_before_boost', $results, $query );
// ... promotion boost applied ...
$results = apply_filters( 'waa_search_results_after_boost', $results, $query );
פרמטרים:
– $results (array) – תוצאות חיפוש עם product_id, similarity, metadata
– $query (string) – שאילתת חיפוש
מחזיר: array
דוגמה:
// Exclude out-of-stock products before boosting
add_filter( 'waa_search_results_before_boost', function( $results, $query ) {
return array_filter( $results, function( $item ) {
$product = wc_get_product( $item['product_id'] );
return $product && $product->is_in_stock();
});
}, 10, 2 );
// Add custom scoring after boost
add_filter( 'waa_search_results_after_boost', function( $results, $query ) {
foreach ( $results as &$item ) {
$product = wc_get_product( $item['product_id'] );
if ( $product && $product->is_on_sale() ) {
$item['similarity'] *= 1.1; // 10% boost for sale items
$item['on_sale'] = true;
}
}
return $results;
}, 10, 2 );
5. משימות Cron
התוסף מתזמן מספר משימות רקע דרך WordPress cron.
woo_ai_chatbot_daily_index
רץ יומית לאינדוקס כל המוצרים לחיפוש סמנטי.
// Scheduled on plugin activation
if ( ! wp_next_scheduled( 'woo_ai_chatbot_daily_index' ) ) {
wp_schedule_event( time(), 'daily', 'woo_ai_chatbot_daily_index' );
}
// Handler
add_action( 'woo_ai_chatbot_daily_index', [ $plugin, 'run_daily_indexing' ] );
תדירות: יומית
woo_ai_chatbot_index_product
מאנדקס מוצר בודד (מופעל לאחר שמירת מוצר).
wp_schedule_single_event( time() + 10, 'woo_ai_chatbot_index_product', [ $product_id ] );
פרמטרים:
– $product_id (int) – מזהה מוצר לאינדוקס
השהיה: 10 שניות אחרי שמירת מוצר
woo_ai_chatbot_cleanup
מבצע משימות תחזוקה שבועיות (ניקוי sessions ישנים, רוטציית לוגים).
if ( ! wp_next_scheduled( 'woo_ai_chatbot_cleanup' ) ) {
wp_schedule_event( time(), 'weekly', 'woo_ai_chatbot_cleanup' );
}
תדירות: שבועית
woo_ai_chatbot_batch_index
מאנדקס מוצרים באצוות עבור קטלוגים גדולים.
add_action( 'woo_ai_chatbot_batch_index', [ $plugin, 'run_batch_index' ], 10, 2 );
פרמטרים:
– $offset (int) – offset התחלה
– $limit (int) – גודל אצווה
waa_cleanup_playbook_sessions
מנקה sessions של playbook שפג תוקפם.
if ( ! wp_next_scheduled( 'waa_cleanup_playbook_sessions' ) ) {
wp_schedule_event( time(), 'hourly', 'waa_cleanup_playbook_sessions' );
}
תדירות: שעתית
woo_ai_supabase_keepalive
מונע מ-Supabase free tier להיכנס להשהיה עקב חוסר פעילות.
if ( ! wp_next_scheduled( 'woo_ai_supabase_keepalive' ) ) {
wp_schedule_event( time(), 'daily', 'woo_ai_supabase_keepalive' );
}
תדירות: יומית
6. דוגמאות הרחבה
הוספת כלי AI מותאם
יצירת כלי מותאם ש-AI יכול להפעיל במהלך שיחות:
/**
* Register custom AI tool for appointment booking
*/
add_filter( 'woo_ai_chatbot_ai_tools', function( $tools ) {
$tools['book_appointment'] = [
'name' => 'book_appointment',
'description' => 'Books a consultation appointment for the customer',
'parameters' => [
'date' => [
'type' => 'string',
'description' => 'Preferred date (YYYY-MM-DD format)',
'required' => true,
],
'time' => [
'type' => 'string',
'description' => 'Preferred time slot',
'required' => true,
],
'service' => [
'type' => 'string',
'description' => 'Type of consultation',
'required' => false,
],
],
'handler' => 'MyPluginToolsAppointmentTool::handle',
];
return $tools;
});
/**
* Tool handler class
*/
namespace MyPluginTools;
class AppointmentTool {
public static function handle( $params, $context ) {
$date = sanitize_text_field( $params['date'] );
$time = sanitize_text_field( $params['time'] );
// Check availability
$available = self::check_availability( $date, $time );
if ( ! $available ) {
return [
'success' => false,
'message' => sprintf(
__( 'Sorry, %s at %s is not available. Would you like me to suggest alternatives?', 'my-plugin' ),
$date,
$time
),
];
}
// Book the appointment
$booking_id = self::create_booking( $date, $time, $context['session_id'] );
return [
'success' => true,
'booking_id' => $booking_id,
'message' => sprintf(
__( 'Great! I've booked your consultation for %s at %s. Confirmation #%s', 'my-plugin' ),
$date,
$time,
$booking_id
),
];
}
}
שינוי הקשר צ’אט
הזרקת נתונים מותאמים להקשר AI לתגובות משופרות:
/**
* Add customer loyalty data to chat context
*/
add_filter( 'woo_ai_chatbot_session_context', function( $context, $session_id ) {
$user_id = get_current_user_id();
if ( $user_id ) {
// Add loyalty tier
$context['customer'] = [
'id' => $user_id,
'loyalty_tier' => get_user_meta( $user_id, 'loyalty_tier', true ) ?: 'standard',
'total_spent' => wc_get_customer_total_spent( $user_id ),
'order_count' => wc_get_customer_order_count( $user_id ),
'member_since' => get_userdata( $user_id )->user_registered,
];
// Add recent orders
$orders = wc_get_orders([
'customer_id' => $user_id,
'limit' => 3,
'orderby' => 'date',
'order' => 'DESC',
]);
$context['recent_orders'] = array_map( function( $order ) {
return [
'id' => $order->get_id(),
'date' => $order->get_date_created()->format( 'Y-m-d' ),
'status' => $order->get_status(),
'total' => $order->get_total(),
];
}, $orders );
}
return $context;
}, 10, 2 );
הוספת צעד Playbook מותאם
יצירת סוגי צעדים מותאמים לאוטומציית playbook:
/**
* Register custom playbook step type for sending emails
*/
add_filter( 'woo_ai_chatbot_playbook_step_types', function( $types ) {
$types['send_email'] = [
'name' => 'Send Email',
'description' => 'Sends an email to the customer or support team',
'handler' => 'MyPluginPlaybookEmailStep::execute',
'parameters' => [
'to' => [ 'type' => 'string', 'required' => true ],
'subject' => [ 'type' => 'string', 'required' => true ],
'template' => [ 'type' => 'string', 'required' => true ],
],
];
return $types;
});
/**
* Step handler
*/
namespace MyPluginPlaybook;
class EmailStep {
public static function execute( $step, $context ) {
$to = self::resolve_recipient( $step['to'], $context );
$subject = self::replace_variables( $step['subject'], $context );
$body = self::render_template( $step['template'], $context );
$sent = wp_mail( $to, $subject, $body, [
'Content-Type: text/html; charset=UTF-8',
]);
return [
'success' => $sent,
'message' => $sent
? __( 'Email sent successfully!', 'my-plugin' )
: __( 'Failed to send email.', 'my-plugin' ),
'data' => [ 'email_sent' => $sent ],
];
}
}
הוספת אירועי אנליטיקה מותאמים
מעקב אחר אירועים מותאמים במערכת האנליטיקה של הצ’אטבוט:
/**
* Track custom events from playbook executions
*/
add_action( 'woo_ai_chatbot_playbook_step_completed', function( $playbook_slug, $step_index, $result, $context ) {
// Track in WooAI analytics
do_action( 'woo_ai_chatbot_track_event', 'playbook_step', [
'playbook' => $playbook_slug,
'step' => $step_index,
'success' => $result['success'] ?? false,
'session_id' => $context['session_id'],
]);
// Track in external analytics
if ( function_exists( 'gtag' ) ) {
wp_add_inline_script( 'google-gtag', sprintf(
"gtag('event', 'chatbot_playbook_step', %s);",
wp_json_encode([
'playbook_slug' => $playbook_slug,
'step_index' => $step_index,
'success' => $result['success'] ?? false,
])
));
}
}, 10, 4 );
/**
* Custom event tracking helper
*/
function woo_ai_track_custom_event( $event_name, $params = [] ) {
global $wpdb;
$wpdb->insert(
$wpdb->prefix . 'waa_events',
[
'session_id' => $params['session_id'] ?? '',
'event_type' => $event_name,
'event_data' => wp_json_encode( $params ),
'created_at' => current_time( 'mysql' ),
],
[ '%s', '%s', '%s', '%s' ]
);
}
שיטות עבודה מומלצות
- ניהול Priority: השתמשו ב-hook priorities מתאימים כדי להבטיח שהקוד שלכם רץ בזמן הנכון
- ביצועים: הימנעו מפעולות יקרות ב-filters שנקראים לעתים קרובות כמו
woo_ai_chatbot_format_response - תאימות: תמיד בדקו אם התוסף פעיל לפני hook לתוך ה-filters שלו
- אימות נתונים: סננו ואמתו את כל הנתונים ב-filter callbacks
- תיעוד: תעדו hooks מותאמים בהרחבה שלכם עבור מפתחים אחרים
// Always check plugin availability
if ( ! class_exists( 'WooAIChatbotPlugin' ) ) {
return;
}
// Use namespaced functions to avoid conflicts
add_filter( 'woo_ai_chatbot_topics', 'MyPluginTopicsadd_custom_topics' );
תאימות גרסאות
| Hook | מאז גרסה | הערות |
|---|---|---|
woo_ai_chatbot_should_display |
0.1.0 | Filter ליבה |
woo_ai_chatbot_format_response |
0.1.0 | Filter ליבה |
woo_ai_chatbot_topics |
0.2.0 | מערכת נושאים |
woo_ai_chatbot_match_playbook |
0.3.0 | מערכת Playbook |
waa_search_results_before_boost |
0.4.0 | הגברת מבצעים |
woo_ai_supabase_keepalive |
0.4.5 | אינטגרציית Supabase |
לתמיכה נוספת, עיינו בתיעוד ארכיטקטורת תוסף או צרו קשר עם צוות הפיתוח.