يوفر WP Weixin التكامل بين WordPress وWeChat. قم بتسجيل المستخدمين أو المصادقة عليهم تلقائيًا في متصفح WeChat، واستخدم WeChat لإنشاء حساب أو المصادقة على أجهزة الكمبيوتر عن طريق مسح رمز الاستجابة السريعة باستخدام WeChat، أو مشاركة المنشورات في WeChat Moments والمحادثات، أو توسيع المكون الإضافي للحصول على المزيد من الميزات!
يتم تشجيع المطورين على إنشاء مكونات إضافية وموضوعات مدمجة مع WeChat مع WP Weixin كنواة، والاستفادة من وظائفها وإجراءاتها ومرشحاتها المتاحة للعامة، أو الاستفادة بشكل مباشر من SDK المتوفرة.
إذا كنت ترغب في رؤية البرنامج المساعد الخاص بك يضاف إلى هذه القائمة، يرجى الاتصال بالمؤلف.
لتسجيل مجال والسماح بالاتصال بينه وبين واجهات برمجة تطبيقات WeChat (JS للواجهة الأمامية وجانب الخادم)، يجب ربط المجال بترخيص ICP أولاً. ثم على https://mp.weixin.qq.com:
http
أو https
) - مع التأكد من تضمين MP_verify_[some_code].txt
إلى جذر موقع الويب المطابق للنطاق المسجل وفقًا للتعليمات، ويمكن الوصول إليه بشكل عام.يضيف هذا البرنامج المساعد الميزات الرئيسية التالية إلى WordPress:
wx
JavaScript مسبقًا باستخدام حزمة موقعة للاستفادة من JavaScript SDK الخاص بـ WeChat في سمات WordPress بسهولة أكبر.متوافق مع WooCommerce، وWooCommerce Multilingual، وWPML، وUltimate Member، وWordPress Multisite، والعديد من المكونات الإضافية للتخزين المؤقت.
يستخدم هذا البرنامج المساعد WordPress WP_Object_Cache
لتحسين عدد استعلامات قاعدة البيانات، مما يضمن تشغيل المقدار المناسب فقط عند كل تحميل للصفحة. نظرًا لأن كائن WP_Object_Cache
يمكن أن يتأثر بمكونات إضافية تابعة لجهات خارجية، فمن الضروري أن تقوم هذه المكونات الإضافية بتنفيذ وظيفة wp_cache_add_non_persistent_groups
لتجنب الآثار الجانبية.
انظر أدناه أمثلة على المكونات الإضافية الشائعة لذاكرة التخزين المؤقت المتوافقة مع WP Weixin:
الإعدادات التالية متاحة على صفحة إعدادات WP Weixin.
الإعدادات المطلوبة أدناه هي الحد الأدنى من التكوين اللازم للمكون الإضافي ليكون له أي تأثير.
اسم | مطلوب | يكتب | وصف |
---|---|---|---|
يُمكَِن | نعم | خانة الاختيار | تمكين WP Weixin - يتطلب تكوينًا صالحًا. |
معرف تطبيق WeChat | نعم | نص | معرف التطبيق في الواجهة الخلفية على https://mp.weixin.qq.com/ ضمن التطوير > التكوين الأساسي. |
سر تطبيق WeChat | نعم | نص | AppSecret في الواجهة الخلفية على https://mp.weixin.qq.com/ ضمن التطوير > التكوين الأساسي. |
اسم WeChat OA | لا | نص | اسم الحساب الرسمي (يوصى بإدخال الاسم الفعلي). |
عنوان URL لشعار WeChat OA | لا | نص | عنوان URL لشعار الحساب الرسمي - (يوصى بإدخال عنوان URL لصورة الشعار الفعلي). |
تمكين مصادقة WeChat | لا | خانة الاختيار | في حالة التمكين، ستتم مصادقة المستخدمين من خلال حساب WeChat الخاص بهم في WordPress عند زيارة الموقع باستخدام متصفح WeChat (إذا لم يكن الأمر كذلك، فسيتم تعيين ملف تعريف ارتباط الجلسة مع المفتاح 'wx_openId-' . apply_filters( 'wp_weixin_ms_auth_blog_id', 1 ) ). |
فرض WeChat المحمول | لا | خانة الاختيار | جعل الوصول إلى موقع الويب متاحًا فقط من خلال متصفح WeChat. إذا تم الوصول إليها باستخدام متصفح آخر، فستعرض الصفحة رمز الاستجابة السريعة. |
فرض المتابعة (أي صفحة) | لا | خانة الاختيار | مطالبة المستخدم بمتابعة الحساب الرسمي قبل الوصول إلى الموقع باستخدام متصفح WeChat. |
تكون هذه الإعدادات مخفية افتراضيًا ولا تتوفر إلا عندما:
manage_network_options
أنها تؤثر على الشبكة متعددة المواقع بأكملها.
اسم | يكتب | وصف |
---|---|---|
فرض مدونة للمصادقة | يختار | يتم استبداله بنص معلومات إذا تم ربط رد الاتصال بـ wp_weixin_ms_auth_blog_id. مدونة لاستخدامها كوكيل عند مصادقة المستخدمين. |
فرض مدونة لمدفوعات WeChat | يختار | يتم استبداله بنص معلومات إذا تم ربط رد الاتصال بـ wp_weixin_ms_pay_blog_id. يظل مخفيًا إذا لم يتم تحديد خيار "استخدام منصة التاجر" (يتطلب دفع WeChat مدمجًا في مكون إضافي مصاحب). مدونة لاستخدامها كوكيل عند معالجة المدفوعات. إذا كان الأمر افتراضيًا، فيجب إدخال عناوين URL لتفويض الدفع JSAPI لجميع مدونات الشبكة التي تقوم بالدفع، ويجب أن يكون عنوان URL لرد اتصال الدفع QR قادرًا على التعامل مع جميع الإشعارات الواردة من WeChat Pay API. |
اسم | يكتب | وصف |
---|---|---|
استخدم مستجيب WeChat | خانة الاختيار | السماح لموقع الويب بتلقي الرسائل من WeChat والرد عليها. يجب تمكين تكوين الخادم وتكوينه في https://mp.weixin.qq.com/ ضمن التطوير > التكوين الأساسي. مطلوب في حالة استخدام خيار "فرض المتابعة" في الإعدادات الرئيسية أو إعدادات WeChat Pay. |
رمز WeChat | نص | الرمز المميز في الواجهة الخلفية على https://mp.weixin.qq.com/ ضمن التطوير > التكوين الأساسي. |
تشفير الرسائل | خانة الاختيار | قم بتشفير الاتصال بين موقع الويب وWeChat API (مستحسن). |
مفتاح WeChat AES | نص | EncodingAESKey في الواجهة الخلفية على https://mp.weixin.qq.com/ تحتالتطوير > التكوين الأساسي. |
إرسال رسالة ترحيب | خانة الاختيار | أرسل رسالة ترحيب عندما يتابع المستخدم الحساب الرسمي. يمكن استخدام عوامل التصفية التالية لتغيير القيم الافتراضية للرسالة:
|
عنوان URL لصورة رسالة الترحيب | نص | عنوان URL للصورة المستخدمة لرسالة الترحيب المرسلة بعد متابعة المستخدم للحساب الرسمي (خارجي أو من مكتبة الوسائط). الصورة الافتراضية موجودة في /wp-weixin/images/default-welcome.png . |
تكون هذه الإعدادات مخفية افتراضيًا ولا تتوفر إلا في حالة تثبيت وتنشيط مكون إضافي لتكامل WeChat Pay مثل WP Weixin Pay أو Woo WeChatPay (قد يتم تغيير هذا السلوك باستخدام مرشح wp_weixin_show_settings_section).
اسم | يكتب | وصف |
---|---|---|
استخدم منصة التاجر | خانة الاختيار | السماح للمستخدمين بإرسال الأموال إلى حساب الخدمة باستخدام WeChat - من الضروري وجود حساب على https://pay.weixin.qq.com/ . هذا الإعداد غير قابل للتكوين (يُجبر على التحديد والإخفاء) في حالة تنشيط المكون الإضافي Woo WeChatPay. |
معرف تطبيق WeChat Merchant | نص | يمكن أن يختلف معرف التطبيق الموجود في الواجهة الخلفية على https://pay.weixin.qq.com/ عن معرف تطبيق WeChat حيث قد يكون حساب WeChat Pay مرتبطًا بمعرف تطبيق مختلف. اتركه فارغًا لاستخدام معرف تطبيق WeChat. |
معرف تاجر WeChat | نص | معرف التاجر في الواجهة الخلفية على https://pay.weixin.qq.com/index.php/extend/pay_setting . |
بادئة شهادة PEM | نص | بادئة ملفات الشهادات التي تم تنزيلها من https://pay.weixin.qq.com/index.php/core/cert/api_cert .البادئة الافتراضية لملفات الشهادات هي apiclient (لملفات apiclient_cert.pem و apiclient_key.pem ).مطلوب بشكل خاص للتعامل مع المبالغ المستردة من خلال WeChat Pay. |
مسار ملفات شهادة PEM | نص | المسار المطلق للمجلد الذي يحتوي على ملفات الشهادات التي تم تنزيلها من https://pay.weixin.qq.com/index.php/core/cert/api_cert على نظام الملفات الحالي.مثال: /home/user/wechat-certificates .يجب أن يكون لديه أذونات القراءة للمستخدم الذي يقوم بتشغيل PHP، وأن يكون موجودًا خارج جذر الويب. مطلوب بشكل خاص للتعامل مع المبالغ المستردة من خلال WeChat Pay. |
بالإضافة إلى هذه الإعدادات، يوفر البرنامج الإضافي مساعدة على الشاشة بشأن القيم التي سيتم إدخالها لعناوين URL المختلفة في شاشة تكوين واجهة برمجة التطبيقات الخاصة بحساب التاجر.
اسم | يكتب | وصف |
---|---|---|
استخدم الوكيل | خانة الاختيار | تمكين الوكيل. |
مضيف الوكيل | نص | عنوان IP أو URI للمضيف الوكيل. |
منفذ الوكيل | نص | المنفذ الذي سيتم استخدامه للاتصال بالمضيف الوكيل. |
اعتمادًا على تكوين الخادم الخاص بك، قد تكون هناك حاجة إلى وكيل إذا كان WordPress خلف جدار حماية أو داخل شبكة الشركة.
اسم | يكتب | وصف |
---|---|---|
إظهار اسم WeChat والصورة في صفحة قائمة المستخدمين | خانة الاختيار | تجاوز عرض أسماء حسابات WordPress والصور الرمزية. |
عرض معلومات WeChat العامة | خانة الاختيار | إظهار معلومات WeChat العامة على صفحات ملف تعريف المستخدم. يتكامل مع WooCommece والعضو النهائي. |
إظهار رابط ربط حساب WeChat | خانة الاختيار | أظهر رابطًا لربط أو إلغاء ربط حساب WordPress بحساب WeChat على صفحات ملف تعريف المستخدم. يتكامل مع WooCommece والعضو النهائي. |
إظهار رابط مصادقة حساب WeChat | خانة الاختيار | أظهر رابطًا للمصادقة عبر رمز الاستجابة السريعة باستخدام حساب WeChat في نموذج تسجيل الدخول إلى WordPress. |
الوعي بلغة قائمة الحساب الرسمي | خانة الاختيار | قم بتخصيص قائمة الحساب الرسمي حسب لغة المستخدم. افتراضيًا، يتم استخدام لغة القائمة المقابلة للغة الافتراضية لموقع الويب. يتوفر هذا الإعداد فقط في حالة تنشيط WPML. |
استخدم الثبات المخصص لـ access_token | خانة الاختيار | استخدم طريقة استمرارية مخصصة للحساب الرسمي Access_token والطابع الزمني لانتهاء صلاحيته. تحذير - يتطلب تنفيذ:
$access_info عبارة عن مصفوفة تحتوي على المفاتيح token expiry .أضف الخطافات أعلاه في إجراء plugins_loaded بأولوية 5 أو أقل.مفيد لتجنب حالة السباق إذا كانت معلومات Access_token بحاجة إلى المشاركة بين منصات متعددة. عند إلغاء التحديد، يتم تخزين Access_token والطابع الزمني لانتهاء الصلاحية في جدول خيارات WordPress في قاعدة البيانات. |
يدعم WP Weixin عمليات التثبيت المتعددة المواقع لـ WordPress، سواء باستخدام النطاق/النطاقات الفرعية أو الدلائل الفرعية. يحتاج WP Weixin إلى التهيئة بنفس الإعدادات وتمكينه على جميع المدونات التي تتطلب المصادقة لحساب رسمي معين.
مع تمكين مصادقة WeChat للجوال، يتم تسجيل المستخدمين الذين يزورون إحدى المدونات تلقائيًا على الشبكة، ويتم إضافتهم إلى المدونة التي تمت زيارتها باستخدام دور المستخدم الافتراضي للمدونة. تتم أيضًا إضافة المستخدمين تلقائيًا إلى مدونات الشبكة الأخرى عند الزيارة عندما يكونون مسجلين بالفعل في إحدى المدونات. يمكن تغيير هذا السلوك باستخدام مرشح wp_weixin_ms_auto_add_to_blog، على سبيل المثال، إذا كانت بعض المدونات لا تقبل مستخدمي WeChat الذين تمت مصادقتهم مسبقًا.
عند استخدام شبكة مدونات قائمة على المجال/النطاق الفرعي، يتم استخدام المجال/النطاق الفرعي للمدونة الرئيسية للمصادقة عبر النطاق. يمكن تغيير السلوك من خلال الإعداد "فرض مصادقة مدونة" في قسم إعدادات المواقع المتعددة في صفحة المكون الإضافي.
يمكن أن تدعم مكونات WeChat Pay الإضافية أيضًا عمليات تثبيت الشبكة القائمة على المجال/النطاق الفرعي لـ WordPress Multisite من خلال الاستفادة من الوظائف والإجراءات والمرشحات التي توفرها WP Weixin. يمكن فرض المدونة المستخدمة للدفع من خلال "فرض مدونة لدفعات WeChat" في قسم إعدادات المواقع المتعددة في صفحة المكون الإضافي.
يعد WP Weixin Pay وWoo WeChatPay أمثلة على المكونات الإضافية المدمجة مع WeChat Pay، والتي تعمل بغض النظر عن نوع التثبيت متعدد المواقع (دليل فرعي أو مجال/نطاق فرعي).
على عكس بعض المكونات الإضافية (التجارية والمبهمة وذات معايير الأمان المشكوك فيها)، لا يعتمد WP Weixin ولن يعتمد على برنامج نصي عبر النطاقات تم إلقاؤه في جذر WordPress، ولكنه يفضل الاستفادة من إجراءات ومرشحات WordPress.
من الممكن استخدام المكوّن الإضافي مع حسابات رسمية متعددة على نفس الشبكة، طالما أن المطور يستفيد من عوامل التصفية wp_weixin_ms_auth_blog_id وwp_weixin_ms_pay_blog_id لحساب السيناريوهات المحتملة المختلفة (راجع مثال بسيط للمكون الإضافي هنا).
واحدة من أقوى الأدوات التي تقدمها WP Weixin هي مجموعة أدوات تطوير برامج PHP Wechat. للحصول على مثيل WeChat SDK، يمكن للمطورين استخدام المقتطف التالي:
$ wechat_sdk = wp_weixin_get_wechat ();
القيمة التي تم إرجاعها هي مثيل لـ WP_Weixin_Wechat
، وهي فئة مجمعة لـ Wechat_SDK
: فهي تضمن صحة جميع الإعدادات والرموز المميزة وتهيئتها. لا يُنصح المطورون باستخدام فئة Wechat_SDK
مباشرة.
جميع الأساليب العامة لـ Wechat_SDK
قابلة للاستدعاء من خلال كائن WP_Weixin_Wechat
ويجب استخدامها فقط للأغراض المتقدمة. هذه أساليب منخفضة المستوى مقارنة بالوظائف المتوفرة: يجب استخدام الأخيرة حيثما أمكن، ويجب على المطورين استخدام SDK فقط في حالة عدم وجود وظيفة تحقق النتيجة المقصودة.
للتعرف على الطرق العامة المتاحة، يرجى الرجوع مباشرة إلى كود مصدر Wechat_SDK
.
مثال سريع وغير محسّن للاستخدام المتقدم - افعل شيئًا ما مع قائمة المعرفات المفتوحة للمتابعين، مع معالجة الأخطاء:
$ wechat = wp_weixin_get_wechat ();
$ next_openid = true ;
$ result = $ wechat -> users ();
$ error = $ wechat -> getError ();
// Warning - will loop until WeChat stops providing results ; do not use in production
while ( false !== $ next_openid && ! $ error ) {
if ( is_array ( $ result ) ) {
$ next_openid = ( ! empty ( $ result [ ' next_openid ' ] ) ) ? $ result [ ' next_openid ' ] : false ;
// Do something with the returned data
do_something ( $ result [ ' data ' ] );
} else {
$ next_openid = false ;
}
if ( $ next_openid ) {
$ result = $ wechat -> users ( $ next_openid );
$ error = $ wechat -> getError ();
}
}
if ( $ error ) {
// Handle the error with the array containing the error information
handle_error ( $ error );
}
يتم توفير الوظائف المذكورة أدناه للعامة بواسطة البرنامج الإضافي لمطوري القوالب والمكونات الإضافية. على الرغم من أنه يمكن نظريًا إنشاء الفئات الرئيسية للمكون الإضافي دون آثار جانبية إذا تم تعيين المعلمة $hook_init
على false
، فمن المستحسن استخدام الوظائف التالية فقط حيث لا يوجد ضمان بأن التحديثات المستقبلية لن تقدم تغييرات في السلوكيات.
مؤشر الوظائف:
wp_weixin_is_wechat ();
وصف
سواء كان الزائر يستخدم متصفح WeChat.
قيمة الإرجاع
(منطقي) سواء كان الزائر يستخدم متصفح WeChat.
wp_weixin_ajax_safe ();
وصف
قم باستدعاء هذه الوظيفة في إجراء WordPress ajax. السماح بالتفاعلات مع WeChat API أثناء طلب ajax.
wp_weixin_get_user_by_openid ( string $ openid );
وصف
احصل على مستخدم WordPress عبر WeChat openID.
حدود
$openid
(سلسلة) معرف WeChat openID.
قيمة الإرجاع
(مختلط)
WP_User
في حالة وجود مستخدم WordPress مرتبط بمعرف WeChat openID المطابق، وإلا يكونfalse
.
wp_weixin_get_user_by_unionid ( string $ unionid , int $ blog_id = false );
وصف
احصل على مستخدم WordPress بواسطة WeChat unionID، أو مجموعة من مستخدمي WordPress في حالة وجود عدة مطابقات (ممكن فقط في حالة Multisite مع حسابات رسمية متعددة).
حدود
$unionid
(سلسلة) معرف اتحاد WeChat.
قيمة الإرجاع
(مختلط) كائن
WP_User
في حالة وجود مستخدم WordPress بمعرف WeChat unionID المطابق، ومصفوفة من كائناتWP_User
في حالة وجود عدة تطابقات، وإلا فإنfalse
.
wp_weixin_get_wechat ();
وصف
احصل على مثيل لـ WP_Weixin_Wechat
(كائن مجمّع لـ Wechat_SDK
- راجع WeChat SDK).
قيمة الإرجاع
(WP_Weixin_Wechat) مثيل لكائن الغلاف لـ
Wechat_SDK
.
wp_weixin_get_options ();
وصف
احصل على جميع الخيارات المستخدمة لتكوين البرنامج المساعد.
قيمة الإرجاع
(مصفوفة) مصفوفة ترابطية تحتوي على جميع الخيارات المستخدمة لتكوين المكون الإضافي.
wp_weixin_get_option ( $ key );
وصف
احصل على قيمة خيار محددة تستخدم لتكوين البرنامج المساعد.
حدود
مفتاح $
(سلسلة) مفتاح الخيار.
قيمة الإرجاع
(مختلط) سلسلة أو منطقية أو عدد صحيح إذا كان الخيار يحتوي على قيمة، وإلا
null
.
wp_weixin_wpml_switch_lang ( $ force = true );
وصف
إذا كان WPML نشطًا وكانت لغة WeChat الخاصة بالمستخدم الحالي معروفة، فقم بتبديل اللغة إلى القيمة المقدمة من حساب WeChat الخاص بالمستخدم.
يستخدم SitePress::switch_lang( $code = null, $cookie_lang = false )
- الأمر متروك للمطور للتعرف على قاعدة كود WMPL ووثائقه.
حدود
$ القوة
(bool) إذا تم ضبطه على
true
، فسيتم تبديل اللغة دائمًا؛ إذا كانfalse
، فسيتم تبديل اللغة فقط إذا تم تمكين "إعادة توجيه لغة المتصفح" في WPML -true
افتراضيًا.
قيمة الإرجاع
(bool) تم استدعاء Wether
SitePress::switch_lang( $code = null, $cookie_lang = false )
.
wp_weixin_get_signed_package ();
وصف
احصل على حزمة WeChat موقعة لاستخدامها مع WeChat JSAPI.
ملاحظة: تم بالفعل توقيع المتغير العام لـ JavaScript wx
بشكل صحيح وتهيئته باستخدام jsApiList
الكامل إذا كان wp-weixin-main-script
مدرجًا بالفعل في قائمة الانتظار.
راجع قسم "JavaScript" في الوثائق لمزيد من التفاصيل.
قيمة الإرجاع
(صفيف) الحزمة الموقعة لتمريرها إلى برنامج نصي عبر
wp_localize_script( $handle, $object_name, $l10n )
.
wp_weixin_get_user_wechat_info ( int $ user_id = false , bool $ output = false );
وصف
احصل على معلومات WeChat الخاصة بالمستخدم. يحصل على المستخدم الحالي إذا تم حذف معرف المستخدم.
حدود
$user_id
(int) معرف المستخدم الافتراضي
false
.
$ الإخراج
(منطقي) ما إذا كان سيتم إخراج المعلومات (باستخدام قالب wp-weixin-public-info) -
false
افتراضي.
قيمة الإرجاع
(مختلط) مجموعة من معلومات WeChat إذا كانت موجودة، وإلا فهي
false
.
wp_weixin_get_user_wechat_openid ( int $ user_id = false );
وصف
احصل على WeChat openID الخاص بالمستخدم. يحصل على المستخدم الحالي إذا تم حذف معرف المستخدم.
حدود
$user_id
(int) معرف المستخدم الافتراضي
false
.
قيمة الإرجاع
(مختلط) معرف WeChat openID إذا كان موجودًا، وإلا فسيكون
false
.
wp_weixin_get_auth_link ( bool $ output = false , string $ target = '' , $ class = '' );
وصف
احصل على رابط لصفحة مصادقة WeChat.
هذه الوظيفة ليس لها أي تأثير في متصفح WeChat.
حدود
$ الإخراج
(منطقي) لإخراج الرابط.
$الهدف
(سلسلة) هدف الارتباط.
$الهدف
(سلسلة) فئة CSS للارتباط.
قيمة الإرجاع
(مختلط) إذا تم تعيين
$output
علىtrue
، فإن علامة الرابط -false
بخلاف ذلك.
wp_weixin_get_bind_link ( bool $ output = false , string $ target = ' _blank ' );
وصف
احصل على رابط لصفحة ربط حساب WeChat.
هذه الوظيفة ليس لها أي تأثير في متصفح WeChat.
حدود
$ الإخراج
(منطقي) لإخراج الرابط.
$الهدف
(سلسلة) هدف الارتباط.
قيمة الإرجاع
(مختلط) إذا تم تعيين
$output
علىtrue
، فإن علامة الرابط -false
بخلاف ذلك.
wp_weixin_unbind ( int $ user_id , string $ open_id = '' );
وصف
قم بإلغاء ربط حساب مستخدم WordPress المرتبط مسبقًا بـ WeChat، مما يؤدي بشكل فعال إلى حذف جميع المعلومات المسجلة المتعلقة بحساب WeChat المرتبط.
ملاحظة: حساب مستخدم WeChat-only WordPress هو حساب WordPress تم إنشاؤه تلقائيًا بواسطة WP Weixin عند فتح موقع الويب في متصفح WeChat (اسم المستخدم يتبع نمط wx-[openid]
).
إذا تم توفير user_id
المطابق لحساب مستخدم WeChat فقط في WordPress والذي قد يكون أو لا يكون مرتبطًا مسبقًا (اسم المستخدم يتبع نمط wx-[openid]
أو wx-bound-[openid]
)، فسيتم تحديث اسم المستخدم بـ wx-unbound-[openid]
نمط wx-unbound-[openid]
.
حدود
$user_id
(int) معرف المستخدم.
$open_id
(سلسلة) المعرف المفتوح لحساب WeChat - إذا ترك فارغًا، فاضبطه على القيمة المسجلة للمستخدم الحالي.
قيمة الإرجاع
(منطقي) سواء كان الحساب غير منضم.
wp_weixin_bind ( int $ user_id , string $ openid );
وصف
قم بربط حساب مستخدم WordPress مع WeChat، مما يؤدي بشكل فعال إلى استبدال جميع المعلومات المسجلة المتعلقة بحساب WeChat المرتبط إذا كان موجودًا.
ملاحظة: حساب مستخدم WeChat-only WordPress هو حساب WordPress تم إنشاؤه تلقائيًا بواسطة WP Weixin عند فتح موقع الويب في متصفح WeChat (اسم المستخدم يتبع نمط wx-[openid]
).
يجب أن يكون هناك حساب مستخدم WeChat-only WordPress مع $openid
المسجل.
إذا تم توفير قيمة $user_id
المقابلة لحساب مستخدم WeChat فقط في WordPress والذي ربما تم أو لم يكن غير مرتبط مسبقًا (اسم المستخدم يتبع نمط wx-[openid]
أو wx-unbound-[openid]
)، فسيتم تحديث اسم المستخدم مع نمط wx-bound-[openid]
.
لا يمكن استخدام معرف مفتوح معين لربط WeChat بحسابات مستخدم WordPress متعددة.
حدود
$user_id
(int) معرف المستخدم.
$open_id
(سلسلة) openID المطابق لحساب مستخدم WeChat WordPress فقط.
قيمة الإرجاع
(منطقي) سواء كان الحساب مرتبطًا.
wp_weixin_is_follower ( int $ user_id );
وصف
تحقق مما إذا كان المستخدم الذي يحمل المعرف $user_id
تابعًا لحساب WeChat الرسمي.
حدود
$user_id
(int) معرف المستخدم.
قيمة الإرجاع
(منطقي) سواء كان المستخدم يتبع حساب WeChat الرسمي.
يمنح WP Weixin للمطورين إمكانية تخصيص سلوكهم من خلال سلسلة من الإجراءات والمرشحات المخصصة.
فهرس الإجراءات:
do_action ( ' wp_weixin_extensions ' , mixed $ wechat , mixed $ wp_weixin_settings , mixed $ wp_weixin , mixed $ wp_weixin_auth , mixed $ wp_weixin_responder , mixed $ wp_weixin_menu );
وصف
يتم تشغيله عندما يتم تحميل WP Weixin بالكامل وإذا تم تحديد "ممكّن" في إعدادات WP Weixin الرئيسية. يُستخدم عادةً لبناء المكونات الإضافية باستخدام WP Weixin كنواة.
ملاحظة: يوصى باستخدام الوظائف المتوفرة حيثما أمكن بدلاً من أساليب معلمات هذا الإجراء، حيث لا يوجد ضمان بأن التحديثات المستقبلية لن تؤدي إلى تغييرات في السلوكيات.
حدود
$ويتشات
(مختلط) كائن
WP_Weixin_Wechat
.
$wp_weixin_settings
(مختلط) كائن
WP_Weixin_Settings
.
$wp_weixin
(مختلط) كائن
WP_Weixin
.
$wp_weixin_auth
(مختلط) كائن
WP_Weixin_Auth
.
$wp_weixin_responder
(مختلط) كائن
WP_Weixin_Responder
إذا تم تمكين WeChat Responder، وإلا فسيكونfalse
.
$wp_weixin_menu
(مختلط) كائن
WP_Weixin_Menu
إذا تم تمكين WeChat Responder، وإلا فسيكونfalse
.
do_action ( ' wp_weixin_responder ' , array $ request_data );
وصف
تم إطلاقه بعد تلقي طلب من WeChat.
حدود
$request_data
(مصفوفة) البيانات المرسلة في الطلب من WeChat.
do_action ( ' wp_weixin_save_access_info ' , array $ access_info );
وصف
يتم إطلاقه بعد تجديد الحساب الرسمي access_token في حالة استخدام الثبات المخصص. يُستخدم لحفظ معلومات الوصول - وهو مفيد بشكل خاص لتجنب حالة السباق إذا كانت هناك حاجة إلى مشاركة Access_token بين منصات متعددة.
حدود
$access_info
(مصفوفة) معلومات الوصول في مصفوفة ترابطية. المفاتيح هي
token
expiry
.
do_action ( ' wp_weixin_before_user_profile_wechat_info ' , mixed $ wechat_info , mixed $ user );
وصف
يتم تشغيله قبل عرض معلومات WeChat العامة في ملف تعريف المستخدم.
حدود
$wechat_info
(مختلط) مجموعة من معلومات WeChat العامة لعرضها في ملف تعريف المستخدم إذا كانت موجودة، وإلا فهي
false
.
$user
(مختلط) كائن
WP_User
إذا كان المستخدم موجودًا، وإلا فسيكونfalse
.
do_action ( ' wp_weixin_after_user_profile_wechat_info ' , mixed $ wechat_info , mixed $ user );
وصف
تم إطلاقه بعد عرض معلومات WeChat العامة في ملف تعريف المستخدم.
حدود
$wechat_info
(مختلط) مجموعة من معلومات WeChat العامة المعروضة في الملف الشخصي للمستخدم، وإلا
false
.
$user
(مختلط) كائن
WP_User
إذا كان المستخدم موجودًا، وإلا فسيكونfalse
.
do_action ( ' wp_weixin_before_bind_account ' , int $ user_id , int $ wechat_user_id , array $ wechat_user_blog_ids , int $ current_blog_id );
وصف
تم إطلاقه قبل ربط حساب مستخدم WordPress مع WeChat.
حدود
$user_id
(كثافة العمليات) معرف المستخدم.
$wechat_user_id
(int) معرف حساب مستخدم WeChat فقط في WordPress (اسم المستخدم يتبع نمط
wx-[openid]
).
$wechat_user_blog_ids
(صفيف) قائمة معرفات المدونة التي ينتمي إليها حساب مستخدم WeChat-only WordPress.
$current_blog_id
(int) معرف المدونة للمدونة الحالية.
do_action ( ' wp_weixin_after_bind_account ' , bool $ bound , int $ user_id , int $ wechat_user_id , array $ wechat_user_blog_ids , int $ current_blog_id );
وصف
تم إطلاقه بعد ربط حساب مستخدم WordPress مع WeChat.
حدود
$ منضم
(bool) في حالة ربط حساب مستخدم WordPress بنجاح مع WeChat.
$user_id
(كثافة العمليات) معرف المستخدم.
$wechat_user_id
(int) معرف حساب مستخدم WeChat فقط في WordPress (اسم المستخدم يتبع نمط
wx-[openid]
).
$wechat_user_blog_ids
(صفيف) قائمة معرفات المدونة التي ينتمي إليها حساب مستخدم WeChat-only WordPress.
$current_blog_id
(int) معرف المدونة للمدونة الحالية.
do_action ( ' wp_weixin_before_unbind_account ' , int $ user_id , string $ openid );
وصف
أطلق النار قبل إلغاء ربط حساب مستخدم WordPress من WeChat.
حدود
$user_id
(كثافة العمليات) معرف المستخدم.
$openid
(سلسلة) معرف WeChat المفتوح.
do_action ( ' wp_weixin_after_unbind_account ' , bool $ unbound , int $ user_id , string $ openid );
وصف
أطلق النار بعد إلغاء ربط حساب مستخدم WordPress من WeChat.
حدود
$ غير منضم
(bool) في حالة إلغاء ربط حساب مستخدم WordPress بنجاح من WeChat.
$user_id
(كثافة العمليات) معرف المستخدم.
$openid
(سلسلة) معرف WeChat المفتوح.
do_action ( ' wp_weixin_before_tabs_settings ' );
الوصف تم إطلاقه قبل إخراج علامات التبويب الخاصة بصفحة WP Weixin.
do_action ( ' wp_weixin_before_main_tab_settings ' );
الوصف تم إطلاقه قبل إخراج علامة تبويب الإعدادات الرئيسية لصفحة WP Weixin.
do_action ( ' wp_weixin_before_main_settings_inner ' );
الوصف تم إطلاقه قبل إخراج محتوى الإعدادات الرئيسية على صفحة WP Weixin.
do_action ( ' wp_weixin_after_main_settings_inner ' );
الوصف يتم إطلاقه بعد إخراج محتوى الإعدادات الرئيسية على صفحة WP Weixin.
do_action ( ' wp_weixin_after_main_tab_settings ' );
الوصف تم إطلاقه بعد إخراج علامة تبويب الإعدادات الرئيسية لصفحة WP Weixin.
do_action ( ' wp_weixin_before_qr_tab_settings ' );
الوصف تم إطلاقه قبل إخراج علامة تبويب منشئ رمز الاستجابة السريعة لصفحة WP Weixin.
do_action ( ' wp_weixin_after_qr_tab_settings ' );
الوصف تم إطلاقه بعد إخراج علامة تبويب منشئ رمز الاستجابة السريعة لصفحة WP Weixin.
do_action ( ' wp_weixin_after_tabs_settings ' );
الوصف تم إطلاقه بعد إخراج علامات التبويب الخاصة بصفحة WP Weixin.
do_action ( ' wp_weixin_before_settings ' );
الوصف تم إطلاقه قبل إخراج الإعدادات على صفحة WP Weixin.
do_action ( ' wp_weixin_before_main_settings ' );
الوصف تم إطلاقه قبل إخراج مربع الإعدادات الرئيسي على صفحة WP Weixin.
do_action ( ' wp_weixin_after_main_settings ' );
الوصف يتم إطلاقه بعد إخراج مربع الإعدادات الرئيسي على صفحة WP Weixin.
do_action ( ' wp_weixin_before_qr_settings ' );
الوصف تم إطلاقه قبل إخراج منشئ رمز الاستجابة السريعة على صفحة WP Weixin.
do_action ( ' wp_weixin_before_qr_settings_inner ' );
الوصف تم إطلاقه قبل إخراج مربع مولد رمز الاستجابة السريعة على صفحة WP Weixin.
do_action ( ' wp_weixin_after_qr_settings_inner ' );
الوصف تم إطلاقه بعد إخراج مربع مولد رمز QR على صفحة WP Weixin.
do_action ( ' wp_weixin_after_qr_settings ' );
الوصف تم إطلاقه بعد إخراج منشئ رمز الاستجابة السريعة على صفحة WP Weixin.
do_action ( ' wp_weixin_after_settings ' );
الوصف يتم إطلاقه بعد إخراج الإعدادات على صفحة WP Weixin.
do_action ( ' wp_weixin_endpoints ' );
وصف
تم إطلاقه عند إضافة قواعد إعادة كتابة WP Weixin. من المفيد للمكونات الإضافية المصاحبة إضافة مكوناتها الخاصة، والتأكد من تسجيلها بشكل صحيح (يتم مسح القواعد عند حفظ إعدادات WP Weixin).
do_action ( ' wp_weixin_handle_payment_notification ' );
وصف
يتم تشغيله عند التعامل مع إشعار معاملة WeChat Pay.
تم إطلاقه أخيرًا بواسطة WP Weixin ( PHP_INT_MIN
) ; يجب أن يتم تشغيلها مبكرًا بواسطة المكونات الإضافية المصاحبة التي تتكامل مع WeChat Pay.
راجع الهيكل الإضافي لتكامل WeChat Pay للتعرف على كيفية التعامل مع إشعارات WeChat Pay.
do_action ( ' wp_weixin_handle_auto_refund ' , mixed $ refund_result , array $ payment_result );
وصف
يتم إطلاقه بعد محاولة استرداد الأموال تلقائيًا لمعاملة فاشلة.
راجع الهيكل الإضافي لتكامل WeChat Pay للتعرف على كيفية التعامل مع نتائج استرداد الأموال التلقائية لـ WP Weixin.
حدود
$refund_result
(مختلط) مصفوفة تحتوي على استجابة WeChat Pay API في حالة نجاح استرداد الأموال، وإلا فإنها
false
.
$ Payment_result
(مصفوفة) نتيجة إشعار الدفع. هيكل النتيجة:
array (
' success ' => false , // optional - (bool) wether the transaction to handle was found ; default false
' data ' => $ data , // required - (array) return value of WP_Weixin_Wechat::getNotify()
' refund ' => false , // optional - (mixed) false if no refund needed, true or an refund message for the user otherwise ; default false
' notify_error ' => false , // optional - (mixed) false if no error, true or an error message otherwise ; if truthy and pay_handler set to true, WeChat Pay API will continue to send notifications for the transaction ; default false
' blog_id ' => $ blog_id , // required for multisite, optional otherwise - (int) the ID of the blog where the original transaction was made ; default the return value of get_current_blog_id()
' pay_handler ' => false , // optional - (bool) wether the result is for the callback registered in the WeChat Pay backend ; default false
/* More custom items can safely be added to the array */
);
مؤشر المرشحات:
apply_filters ( ' wp_weixin_browser_page_qr_src ' , string $ src );
وصف
قم بتصفية مصدر رمز الاستجابة السريعة لإظهاره على المتصفحات الكلاسيكية لصفحة يمكن الوصول إليها فقط من خلال متصفح WeChat.
حدود
$src
(سلسلة) مصدر رمز QR الذي سيتم عرضه على المتصفحات الكلاسيكية.
apply_filters ( ' wp_weixin_subscribe_src ' , string $ src );
وصف
قم بتصفية مصدر رمز الاستجابة السريعة المستخدم لمتابعة الحساب الرسمي.
حدود
$src
(سلسلة) مصدر رمز الاستجابة السريعة.
apply_filters ( ' wp_weixin_follower_notice_title ' , string $ title );
وصف
قم بتصفية عنوان الصفحة التي تعرض رمز الاستجابة السريعة لمتابعة الحساب الرسمي.
حدود
عنوان $
(سلسلة) عنوان الصفحة - الافتراضي "تابعنا!".
apply_filters ( ' wp_weixin_follower_notice ' , string $ notice );
وصف
تصفية الرسالة المعروضة على الصفحة التي تعرض رمز الاستجابة السريعة لمتابعة الحساب الرسمي.
حدود
إشعار $
(سلسلة) الرسالة المعروضة - الافتراضية "يُرجى مسح رمز الاستجابة السريعة هذا لمتابعتنا قبل الوصول إلى هذا المحتوى.".
apply_filters ( ' wp_weixin_auth_needed ' , bool $ needs_auth );
وصف
سواء كان عنوان URL يحتاج إلى مصادقة المستخدم باستخدام WeChat. عند تحديد "تمكين مصادقة WeChat" في الإعدادات، تحتاج عناوين URL التي تقوم بتشغيل ربط إجراء init
الخاص بـ WordPress إلى المصادقة افتراضيًا، ما لم يتم إدراجها في القائمة البيضاء باستخدام هذا الفلتر. افتراضيًا، يتم إدراج جميع صفحات الإدارة، وصفحة مصادقة المتصفح الكلاسيكية WP Weixin، ونقطة نهاية WordPress ajax، ونقطة نهاية مستجيب WeChat، ونقاط نهاية WooCommerce API في القائمة البيضاء ويمكن الوصول إليها خارج WeChat.
حدود
$needs_auth
(bool) هناك حاجة إلى مصادقة الطقس لزيارة عنوان URL.
apply_filters ( ' wp_weixin_debug ' , bool $ debug );
وصف
قم بتصفية الطقس لتنشيط وضع التصحيح (سجلات أخطاء PHP، ورسائل وحدة تحكم JavaScript، وتنبيهات JavaScript).
حدود
$تصحيح
(منطقي) تم تنشيط وضع تصحيح الأخطاء - القيمة الثابتة الافتراضية
WP_DEBUG
.
apply_filters ( ' wp_weixin_follower_welcome_title ' , string $ title , mixed $ before_subscription );
وصف
قم بتصفية عنوان الرسالة التي يتلقاها المستخدم عند متابعة الحساب الرسمي.
حدود
عنوان $
(سلسلة) العنوان - الافتراضي ""مرحبًا
user_name
!"" حيث يكونuser_name
هو اسم WeChat الخاص بالمستخدم.
$before_subscription
(مختلط) إذا كان رقميًا، فإن معرف
WP_Post
للصفحة الأخيرة التي كان المستخدم يزورها؛ إذا كانت السلسلة، عنوان URL للصفحة الأخيرة التي كان المستخدم يزورها -home_url()
الافتراضي.
apply_filters ( ' wp_weixin_follower_welcome_description ' , string $ description , mixed $ before_subscription );
وصف
قم بتصفية وصف الرسالة التي يتلقاها المستخدم عند متابعة الحساب الرسمي.
حدود
وصف $
(سلسلة) الوصف - الافتراضي "شكرًا لك على الاشتراك في حسابنا الرسمي!".
$before_subscription
(مختلط) إذا كان رقميًا، فإن معرف
WP_Post
للصفحة الأخيرة التي كان المستخدم يزورها؛ إذا كانت السلسلة، عنوان URL للصفحة الأخيرة التي كان المستخدم يزورها -home_url()
الافتراضي.
apply_filters ( ' wp_weixin_follower_welcome_url ' , string $ url , mixed $ before_subscription );
وصف
قم بتصفية عنوان URL الذي سيتم إعادة توجيه المستخدم إليه عند التفاعل مع الرسالة المستلمة عند متابعة الحساب الرسمي.
حدود
$url
(سلسلة) عنوان URL الذي سيتم إعادة توجيه المستخدم إليه -
home_url()
الافتراضي إذا لم يتم تسجيل عنوان URL قبل إرسال الرسالة النموذجية.
$before_subscription
(مختلط) إذا كان رقميًا، فإن معرف
WP_Post
للصفحة الأخيرة التي كان المستخدم يزورها؛ إذا كانت السلسلة، عنوان URL للصفحة الأخيرة التي كان المستخدم يزورها -home_url()
الافتراضي.
apply_filters ( ' wp_weixin_follower_welcome_pic_url ' , string $ pic_url , mixed $ before_subscription );
وصف
قم بتصفية عنوان URL للصورة المعروضة في الرسالة التي يتلقاها المستخدم عند اتباع الحساب الرسمي.
حدود
$ pic_url
(سلسلة) عنوان URL للصورة - الافتراضي
WP_PLUGIN_URL . '/wp-weixin/images/default-welcome.png'
.
$ قبل _subscription
(مختلط) إذا كان الرقم ، معرف
WP_Post
للصفحة الأخيرة التي كان المستخدم يزورها ؛ إذا كانت السلسلة ، عنوان URL للصفحة الأخيرة كان المستخدم يزوره - الافتراضيhome_url()
.
apply_filters ( ' wp_weixin_get_access_info ' , array $ access_info );
وصف
قم بتصفية الرمز المميز للوصول والرمز المميز عند طلب كائن WP_Weixin_WeChat
(غلاف كائن Wechat_SDK
) إذا تم استخدام ثبات مخصص - مفيد بشكل خاص لتجنب حالة السباق إذا احتاج رمز الوصول إلى مشاركة بين منصات متعددة.
حدود
$ Access_info
(صفيف) معلومات الوصول في مجموعة نقاطية. أنواع القيمة والمفاتيح: (سلسلة)
token
، (int)expiry
.
apply_filters ( ' wp_weixin_jsapi_urls ' , array $ jsapi_urls );
وصف
قم بتصفية عناوين URL اللازمة للتسجيل على شاشة تكوين API الخاصة بحساب WeChat Merchant - المستخدمة عندما يقوم مكون إضافي آخر بتنفيذ تكامل WeChat Pay.
حدود
$ JSAPI_URLS
(صفيف) عناوين URL للتسجيل على شاشة تكوين API الخاصة بحساب WeChat Merchant.
apply_filters ( ' wp_weixin_pay_callback_endpoint ' , string $ endpoint );
وصف
قم بتصفية نقطة نهاية عنوان URL لدفع QR اللازمة للتسجيل على شاشة تكوين API الخاصة بحساب WeChat Merchant - المستخدمة عند تنفيذ تكامل WeChat Pay.
حدود
$ callback_url
(سلسلة) نقطة نهاية عنوان URL لدفع QR للتسجيل على شاشة تكوين API الخاصة بحساب WeChat Merchant (مثال:
/my_plugin/notify
).
apply_filter ( ' wp_weixin_settings ' , $ settings );
وصف
تصفية الإعدادات المستخدمة لتكوين البرنامج المساعد. يجب إضافة وظائف أو طرق مدمن مخدرات إلى هذا الفلتر في خطاف إجراء plugins_loaded
من أولوية 5
أو أقل.
حدود
إعدادات $
(صفيف) الإعدادات المستخدمة لتكوين البرنامج المساعد.
apply_filters ( ' wp_weixin_show_settings_section ' , bool $ show_section , string $ section_name , array $ section );
وصف
تصفية Wether لإظهار قسم الإعدادات في صفحة إعدادات WP Weixin.
حدود
$ show_section
(Bool) Wether لإظهار قسم الإعدادات في صفحة إعدادات WP Weixin.
$ section_name
(سلسلة) اسم قسم الإعدادات.
قسم $
(صفيف) إعدادات القسم.
apply_filters ( ' wp_weixin_show_setting ' , bool $ show_setting , string $ section_name , int $ index , array $ value );
وصف
تصفية Wether لإظهار إعداد على صفحة إعدادات WP Weixin.
حدود
$ show_setting
(Bool) Wether لإظهار الإعداد على صفحة إعدادات WP Weixin.
$ section_name
(سلسلة) اسم القسم ينتمي إليه الإعداد.
$ index
(int) فهرس الإعداد في القسم.
قيمة $
(صفيف) الإعداد.
apply_filters ( ' wp_weixin_settings_fields ' , array $ settings_fields );
وصف
قم بتصفية حقول الإعدادات المعروضة على صفحة إعدادات WP Weixin.
حدود
$ include_section
(صفيف) حقول الإعدادات المعروضة على صفحة إعدادات WP Weixin.
apply_filters ( ' wp_weixin_auth_redirect ' , mixed $ redirect , bool $ auth , bool $ has_error );
وصف
قم بتصفية عنوان URL لإعادة توجيهه إلى متى يتم تنفيذ مصادقة رمز الاستجابة السريعة في المتصفحات الكلاسيكية.
حدود
$ إعادة توجيه
(مختلط) عنوان URL لإعادة توجيهه إلى متى يتم تنفيذ المصادقة ، أو
false
إذا لم يتم إعادة التوجيه. الافتراضي هوhome_url()
في حالة المصادقة الناجحة.
$ Auth
(Bool) كان المصادقة تم تنفيذه -
true
إذا نجحت ،false
في حالة حدوث خطأ.
$ has_error
(Bool) حدث خطأ.
apply_filters ( ' wp_weixin_scan_heartbeat_frequency ' , int $ frequency );
وصف
قم بتصفية تردد الشيكات عند انتظار تأكيد مسح رمز الاستجابة السريعة في المتصفحات الكلاسيكية.
حدود
تردد $
(int) التردد في مللي ثانية. الافتراضي
1000
.
apply_filters ( ' wp_weixin_qr_cleanup_frequency ' , string $ frequency );
وصف
قم بتصفية التردد لتنظيف بيانات رمز الاستجابة السريعة منتهية الصلاحية.
حدود
تردد $
(سلسلة) التردد. الافتراضي
'hourly'
.
apply_filters ( ' wp_weixin_qr_lifetime ' , int $ lifetime );
وصف
قم بتصفية عمر رمز QR يحتمل أن يكون حساسًا ، مثل مصادقة WeChat أو ربط حساب WeChat.
حدود
$ مدى الحياة
(int) العمر في ثوان. الافتراضي
600
.
apply_filters ( ' wp_weixin_user_wechat_info ' , mixed $ wechat_info , int $ user_id );
وصف
تصفية معلومات المستخدم WeChat.
حدود
$ WeChat_Info
(مختلط) مجموعة من معلومات WeChat إذا كانت موجودة ،
false
خلاف ذلك.
$ مدى الحياة
(int) معرف المستخدم - الافتراضي
0
.
apply_filters ( ' wp_weixin_ms_auto_add_to_blog ' , bool $ auto_add_to_blog , int $ blog_id , int $ user_id );
وصف
تصفية Wether لإضافة المستخدم تلقائيًا إلى المدونة التي تمت زيارتها على الشبكة عند المصادقة مع WeChat.
حدود
$ auto_add_to_blog
(Bool) Wether لإضافة المستخدم تلقائيًا إلى المدونة التي تمت زيارتها على الشبكة عند المصادقة مع WeChat - Default
true
.
$ blog_id
(int) معرف المدونة التي تمت زيارتها.
$user_id
(int) معرف المستخدم الذي يزور المدونة.
apply_filters ( ' wp_weixin_ms_auth_blog_id ' , int $ auth_blog_id );
وصف
تصفية معرف المدونة المستخدمة للمصادقة - افتراضيًا ، يُفترض أن اسم المجال للمدونة الافتراضية مسجلة في WeChat الخلفية.
تحذير: للتأكد من أن WP Weixin يدعم حسابات رسمية متعددة ، يتم تخزين OpenIDs للحسابات المرتبطة باستخدام سجل META للمستخدم الذي يحتوي على قيمة $auth_blog_id
في مفتاح META الخاص به ( 'wx_openid-' . $auth_blog_id
).
إذا كان مستخدمو WordPress المتجهين WeChat موجودين بالفعل (ملزمون يدويًا أو تم إنشاؤه تلقائيًا عند زيارة الموقع مع متصفح WeChat) ، فإن تطبيق هذا المرشح وإرجاع القيمة المعدلة لـ $auth_blog_id
سيؤدي إلى كسر العلاقة بين المستخدم والمفتح المسجل أثناء وقت التشغيل.
الأمر متروك للمطور لتحديث قاعدة البيانات مباشرة ، أو تشغيل مقتطف رمز الاستخدام لمرة واحدة كما هو موضح أدناه.
مثال على SNIPPET CODE لتشغيله بعد تغيير معرف المدونة المستخدمة للمصادقة في حالة ربط مستخدمي WordPress بالفعل بـ WeChat:
global $ wpdb ;
$ old_auth_blog_id = 1 ;
$ new_auth_blog_id = 2 ;
$ wpdb -> query (
$ wpdb -> prepare (
" UPDATE $ wpdb -> usermeta SET `meta_key` = 'wx_openid-%d' WHERE `meta_key` = 'wx_openid-%d'; " ,
$ new_auth_blog_id ,
$ old_auth_blog_id
)
);
حدود
$ auth_blog_id
(int) معرف المدونة لاستخدامه عند القيام بمصادقة WeChat. الافتراضي
1
.
apply_filters ( ' wp_weixin_ms_pay_blog_id ' , int $ pay_blog_id );
وصف
قم بتصفية معرف المدونة المستخدمة لإنشاء عناوين URL المسموح بها بالاتصال وتلقي إشعارات الدفع من واجهة برمجة تطبيقات WeChat Pay - افتراضيًا ، يُفترض أن المجال (أو النطاق الفرعي) المقابل لمعرف المدونة الحالية مسجلة في WeChat الخلفية. مفيدة في حالة تشغيل عدة مثيلات من WooCommerce على نفس الشبكة ، أو في حالة شبكة متصلة بعدة حسابات رسمية.
حدود
$ pay_blog_id
(int) معرف المدونة المستخدمة لإنشاء عنوان URL رد الاتصال على QR. الافتراضي
get_current_blog_id()
.
apply_filters ( ' wp_weixin_locate_template_paths ' , array $ paths , string $ plugin_name );
وصف
تصفية المسارات المحتملة للقوالب التي تضمنت WP Weixin و Companion Plugins.
حدود
مسارات $
(صفيف) المسارات الممكنة. افتراضي (حيث
$template_name
هو اسم ملف القالب):array ( ' plugins/wp-weixin/ ' . $ plugin_name . $ template_name , ' wp-weixin/ ' . $ plugin_name . $ template_name , ' plugins/ ' . $ plugin_name . $ template_name , $ plugin_name . $ template_name , ' wp-weixin/ ' . $ template_name , $ template_name , );
$ plugin_name
(سلسلة) اسم المكون الإضافي ينتمي إليه القالب.
apply_filters ( ' wp_weixin_get_user_by_openid ' , $ user , $ openid );
وصف
تصفية نتيجة استعلام الحصول على مستخدم WordPress مرتبط بـ WeChat OpenID مسجل.
حدود
مستخدم $
(مختلط) كائن
WP_User
إذا تم العثور على المستخدم ،false
خلاف ذلك.
$ OpenID
(سلسلة) OpenID المستخدمة للبحث عن المستخدم
apply_filters ( ' wp_weixin_pay_notify_results ' , ( array ) $ results );
وصف
تصفية نتائج التعامل مع إشعار الدفع.
لم يتم تطبيقه بالفعل بواسطة WP Weixin نفسه مباشرة ، ولكن فقط بعد أن قام مكون إضافي مصاحب بإطلاق WP_WEIXIN_HANDLE_Payment_Notification.
راجع هيكل عظمي لـ WeChat Pay Integration للحصول على نتائج إخطار الدفع.
حدود
نتائج $
(صفيف) مجموعة من نتائج إشعار الدفع. هيكل النتيجة:
array (
' success ' => false , // optional - (bool) wether the transaction to handle was found ; default false
' data ' => $ data , // required - (array) return value of WP_Weixin_Wechat::getNotify()
' refund ' => false , // optional - (mixed) false if no refund needed, true or an refund message for the user otherwise ; default false
' notify_error ' => false , // optional - (mixed) false if no error, true or an error message otherwise ; if truthy and pay_handler set to true, WeChat Pay API will continue to send notifications for the transaction ; default false
' blog_id ' => $ blog_id , // required for multisite, optional otherwise - (int) the ID of the blog where the original transaction was made ; default the return value of get_current_blog_id()
' pay_handler ' => false , // optional - (bool) wether the result is for the callback registered in the WeChat Pay backend ; default false
/* More custom items can safely be added to the array */
);
apply_filters ( ' wp_weixin_ecommerce_description ' , $ ecommerce_description );
وصف
تصفية وصف إعدادات الدفع WeChat.
حدود
$ ecommerce_description
(سلسلة) وصف إعدادات الدفع WeChat (HTML).
apply_filters ( ' wp_weixin_subscribe_qr_url ' , $ wp_weixin_subscribe_qr_url );
وصف
قم بتصفية عنوان URL لرمز QR الرسمي لـ WeChat الرسمي.
حدود
$ wp_weixin_subscribe_qr_url
(سلسلة) عنوان URL لرمز QR الاشتراك في الحساب الرسمي WeChat.
يتم تحديد ملفات القالب التالية باستخدام locate_template()
وإدراجها مع وظائف load_template()
التي توفرها WordPress. هذا يعني أنه يمكن زيادة تحميله في موضوع WordPress النشط. قد يضع المطورون ملفاتهم المخصصة في الدلائل التالية ضمن مجلد السمة (حسب ترتيب أولوية الاختيار):
plugins/wp-weixin/
wp-weixin/
plugins/
قد يتم تخصيص المسارات المتاحة للقوالب مع تصفية WP_WEIXIN_LOCTING_TEMPHIT_PATHS. يتم تطبيق النمط المطبقة على جميع القوالب أدناه على أنه 'wp-weixin-main-style'
.
فهرس القوالب:
wp-weixin-subscribe.php
وصف
قالب الصفحة الذي يعرض رمز الاستجابة السريعة لمتابعة الحساب الرسمي. يستخدم عندما يتم تمكين "Force Follow" في الإعدادات.
عنوان $
(سلسلة) عنوان الشاشة المقدمة للمستخدم.
رسالة $
(سلسلة) الرسالة التي تصف سبب رؤية المستخدم هذه الشاشة.
$ QR_SRC
(سلسلة) مصدر صورة رمز الاستجابة السريعة.
wp-weixin-browser-qr.php
وصف
قالب الصفحة الذي يعرض رمز الاستجابة السريعة عندما يكون موقع الويب متاحًا فقط من خلال متصفح WeChat.
المتغيرات
$ page_qr_src
(سلسلة) مصدر صورة رمز الاستجابة السريعة.
wp-weixin-auth-form-link.php
وصف
قالب رابط مصادقة WeChat.
المتغيرات
فئة $
(سلسلة) سمة الفئة للرابط.
الهدف $
(سلسلة) السمة الهدف للرابط.
wp-weixin-auth-page.php
وصف
قالب شاشة WeChat المعروضة لمصادقة رمز الاستجابة السريعة في المتصفحات الكلاسيكية.
wp-weixin-mobile-auth-check.php
وصف
قالب شاشة WeChat Mobile Browser المعروضة عند المصادقة عبر مصادقة رمز الاستجابة السريعة في المتصفحات الكلاسيكية.
المتغيرات
$ auth_qr_data
(صفيف) البيانات المتعلقة بالمصادقة. أنواع القيمة والمفاتيح: (Bool)
auth
، (int)user_id
، (Array)error
، (Bool | String)redirect
. لا يتم استخدام قيمةredirect
فعليًا لإعادة التوجيه افتراضيًا على الهاتف المحمول (المستخدمة بعد المصادقة على سطح المكتب).
wp-weixin-bind-form-link.php
وصف
قالب رابط ربط حساب WeChat.
المتغيرات
$ link_text
(سلسلة) نص الرابط.
$ WeChat_Info
(مختلط) مجموعة من معلومات WeChat إذا كانت موجودة ،
false
خلاف ذلك.
فئة $
(سلسلة) سمة الفئة للرابط.
الهدف $
(سلسلة) السمة الهدف للرابط.
wp-weixin-bind-page.php
وصف
قالب شاشة WeChat المعروضة لحساب WeChat في المتصفحات الكلاسيكية.
المتغيرات
$user_id
(int) معرف المستخدم لربط حساب WeChat.
$ WeChat_Info
(مختلط) مجموعة من معلومات WeChat إذا كانت موجودة ،
false
خلاف ذلك.
wp-weixin-mobile-bind-check.php
وصف
قال قالب شاشة WeChat Mobile Browser عند محاولة حساب WeChat عبر رمز الاستجابة السريعة في المتصفحات الكلاسيكية.
المتغيرات
$ bind_qr_data
(صفيف) البيانات المتعلقة بربط الحساب. أنواع القيمة والمفاتيح: (Bool)
bind
، (int)user_id
، (Array)error
، (Bool | String)redirect
. تكون القيمةredirect
false
دائمًا على الأجهزة المحمولة (مأهولة بالسكان واستخدامها بعد ربط الحساب على سطح المكتب).
wp-weixin-public-info.php
وصف
قالب إخراج معلومات WeChat العامة - لا سيما عند استدعاء wp_weixin_get_user_wechat_info باستخدام معلمة $output
المعة إلى false
.
المتغيرات
$ WeChat_Info
(صفيف) المعلومات العامة WeChat. القيمة كلها من النوع (سلسلة) ، مع مفاتيح:
nickname
،headimgurl
،sex
،language
،city
،province
،country
،unionid
.
wp-weixin-account-form-password-notice.php
وصف
قالب الإشعار ليتم عرضه ضمن النموذج لتغيير كلمة مرور حساب المستخدم.
تم توقيع المتغير العالمي wx
بالفعل وتهيئته مع jsApiList
الكامل.
لاستخدامه بشكل صحيح ، يجب على المطورين:
wp_enqueue_scripts
بأولوية 6
أو أكثر ،wp-weixin-main-script
كميتةبالإضافة إلى ذلك ، قد يتم الاشتراك في قائمة المقدمة من المستمعين.
فهرس مستمع جافا سكريبت:
مثال على كيفية الاشتراك في مستمع wpWeixinShareTimelineSuccessListener
:
window . wpWeixinShareTimelineSuccessListener ( handleShareTimelineSuccess ) ;
function handleShareTimelineSuccess ( shareInfo ) {
// do something with the data
do_something ( shareInfo ) ;
}
window . wpWeixinShareTimelineSuccessListener ( callback ) ;
سيقوم الاشتراك في هذا المستمع بتنفيذ وظيفة callback
بعد مشاركة المنشور على لحظات WeChat.
تم تمرير المعلمات إلى رد الاتصال
ShareInfo
(كائن) معلومات المشاركة المرسلة إلى WeChat JS_SDK. السمات هي
title
،desc
،link
،imgUrl
.
window . wpWeixinShareTimelineFailureListener ( callback ) ;
سيقوم الاشتراك في هذا المستمع بتنفيذ وظيفة callback
بعد مشاركة المنشور على لحظات WeChat.
تم تمرير المعلمات إلى رد الاتصال
ShareInfo
(كائن) معلومات المشاركة المرسلة إلى WeChat JS_SDK. السمات هي
title
،desc
،link
،imgUrl
.
window . wpWeixinShareAppMessageSuccessListener ( callback ) ; `
سيقوم الاشتراك في هذا المستمع بتنفيذ وظيفة callback
بعد مشاركة المنشور مع نجاح WeChat "إرسال إلى الدردشة".
تم تمرير المعلمات إلى رد الاتصال
ShareInfo
(كائن) معلومات المشاركة المرسلة إلى WeChat JS_SDK. السمات هي
title
،desc
،link
،imgUrl
.
window . wpWeixinShareAppMessageFailureListener ( callback ) ;
سيقوم الاشتراك في هذا المستمع بتنفيذ وظيفة callback
بعد مشاركة المنشور مع فشل WeChat "إرسال إلى الدردشة".
تم تمرير المعلمات إلى رد الاتصال
ShareInfo
(كائن) معلومات المشاركة المرسلة إلى WeChat JS_SDK. السمات هي
title
،desc
،link
،imgUrl
.