wp weixin
v1.3.11
WP Weixin bietet Integration zwischen WordPress und WeChat. Registrieren oder authentifizieren Sie Benutzer automatisch im WeChat-Browser, erstellen Sie mit WeChat ein Konto oder authentifizieren Sie sich auf Computern durch Scannen eines QR-Codes mit WeChat, teilen Sie Beiträge in WeChat-Momenten und Konversationen oder erweitern Sie das Plugin für weitere Funktionen!
Entwicklern wird empfohlen, in WeChat integrierte Plugins und Themes mit WP Weixin als Kern zu erstellen und dabei die öffentlich verfügbaren Funktionen, Aktionen und Filter zu nutzen oder direkt das bereitgestellte SDK zu nutzen.
Wenn Sie möchten, dass Ihr Plugin zu dieser Liste hinzugefügt wird, wenden Sie sich bitte an den Autor.
Um eine Domain zu registrieren und die Kommunikation zwischen ihr und den WeChat-APIs (Frontend-JS und Serverseite) zu autorisieren, muss die Domain zunächst mit einer ICP-Lizenz verknüpft werden. Dann auf https://mp.weixin.qq.com:
http oder https ). Achten Sie darauf, MP_verify_[some_code].txt Dateien im Stammverzeichnis der Website, die der gemäß den Anweisungen registrierten Domain entspricht, öffentlich zugänglich.Dieses Plugin fügt WordPress die folgenden Hauptfunktionen hinzu:
wx ist mit einem signierten Paket vorkonfiguriert, um das JavaScript SDK von WeChat in WordPress-Themes einfacher zu nutzen.Kompatibel mit WooCommerce, WooCommerce Multilingual, WPML, Ultimate Member, WordPress Multisite und vielen Caching-Plugins.
Dieses Plugin verwendet WordPress WP_Object_Cache , um die Anzahl der Datenbankabfragen zu optimieren und sicherzustellen, dass bei jedem Seitenladevorgang nur die richtige Menge ausgelöst wird. Da das WP_Object_Cache Objekt durch Plugins von Drittanbietern beeinträchtigt werden kann, ist es erforderlich, dass solche Plugins die Funktion wp_cache_add_non_persistent_groups implementieren, um Nebenwirkungen zu vermeiden.
Nachfolgend finden Sie Beispiele beliebter Cache-Plugins, die mit WP Weixin kompatibel sind:
Die folgenden Einstellungen sind auf der Einstellungsseite von WP Weixin verfügbar.
Bei den unten aufgeführten erforderlichen Einstellungen handelt es sich um die Mindestkonfiguration, die erforderlich ist, damit das Plugin wirksam ist.
| Name | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| Aktivieren | Ja | Kontrollkästchen | WP Weixin aktivieren – erfordert eine gültige Konfiguration. |
| WeChat-App-ID | Ja | Text | Die AppId im Backend unter https://mp.weixin.qq.com/ unter Entwicklung > Grundkonfiguration. |
| Geheimnis der WeChat-App | Ja | Text | Das AppSecret im Backend unter https://mp.weixin.qq.com/ unter Entwicklung > Grundkonfiguration. |
| WeChat OA-Name | NEIN | Text | Der Name des offiziellen Kontos (es wird empfohlen, den tatsächlichen Namen einzugeben). |
| URL des WeChat OA-Logos | NEIN | Text | Eine URL zum Logo des offiziellen Kontos – (empfohlen wird die Eingabe der URL eines Bildes des tatsächlichen Logos). |
| Aktivieren Sie die WeChat-Authentifizierung | NEIN | Kontrollkästchen | Wenn aktiviert, werden Benutzer mit ihrem WeChat-Konto in WordPress authentifiziert, wenn sie die Website mit dem WeChat-Browser besuchen (andernfalls wird ein Sitzungscookie mit dem Schlüssel 'wx_openId-' . apply_filters( 'wp_weixin_ms_auth_blog_id', 1 ) gesetzt). |
| WeChat für Mobilgeräte erzwingen | NEIN | Kontrollkästchen | Machen Sie die Website nur über den WeChat-Browser zugänglich. Beim Zugriff mit einem anderen Browser zeigt die Seite einen QR-Code an. |
| Folge erzwingen (jede Seite) | NEIN | Kontrollkästchen | Fordern Sie den Benutzer auf, dem offiziellen Konto zu folgen, bevor er mit dem WeChat-Browser auf die Website zugreift. |
Diese Einstellungen sind standardmäßig ausgeblendet und nur verfügbar, wenn:
manage_network_optionsSie betreffen das gesamte Multisite-Netzwerk.
| Name | Typ | Beschreibung |
|---|---|---|
| Erzwingen Sie ein Blog zur Authentifizierung | wählen | Wird durch einen Infotext ersetzt, wenn ein Rückruf an wp_weixin_ms_auth_blog_id gehakt ist. Blog zur Verwendung als Proxy bei der Authentifizierung von Benutzern. |
| Erzwingen Sie einen Blog für WeChat-Zahlungen | wählen | Wird durch einen Infotext ersetzt, wenn ein Rückruf an wp_weixin_ms_pay_blog_id gehakt ist. Bleibt ausgeblendet, wenn die Option „Händlerplattform verwenden“ nicht aktiviert ist (WeChat-Zahlung muss in ein Begleit-Plugin integriert sein). Blog zur Verwendung als Proxy bei der Zahlungsabwicklung. Bei der Standardeinstellung müssen die JSAPI-Zahlungsautorisierungs-URLs für alle Blogs des Netzwerks eingegeben werden, die Zahlungen durchführen, und die QR-Zahlungsrückruf-URL muss in der Lage sein, alle Benachrichtigungen zu verarbeiten, die von der WeChat Pay API kommen. |
| Name | Typ | Beschreibung |
|---|---|---|
| Verwenden Sie den WeChat-Responder | Kontrollkästchen | Erlauben Sie der Website, Nachrichten von WeChat zu empfangen und darauf zu antworten. Die Serverkonfiguration muss in https://mp.weixin.qq.com/ unter Entwicklung > Grundkonfiguration aktiviert und konfiguriert werden. Erforderlich, wenn die Option „Folgen erzwingen“ in den Haupteinstellungen oder den WeChat Pay-Einstellungen verwendet wird. |
| WeChat-Token | Text | Das Token im Backend unter https://mp.weixin.qq.com/ unter Entwicklung > Grundkonfiguration. |
| Nachrichten verschlüsseln | Kontrollkästchen | Kodieren Sie die Kommunikation zwischen der Website und der WeChat-API (empfohlen). |
| WeChat AES-Schlüssel | Text | Den EncodingAESKey im Backend unter https://mp.weixin.qq.com/Entwicklung > Grundkonfiguration. |
| Willkommensnachricht senden | Kontrollkästchen | Senden Sie eine Willkommensnachricht, wenn ein Benutzer dem offiziellen Konto folgt. Die folgenden Filter können verwendet werden, um die Standardwerte der Nachricht zu ändern:
|
| Bild-URL der Willkommensnachricht | Text | Eine URL zum Bild, das für die Willkommensnachricht verwendet wird, die gesendet wird, nachdem ein Benutzer dem offiziellen Konto folgt (extern oder aus der Medienbibliothek). Das Standardbild befindet sich in /wp-weixin/images/default-welcome.png . |
Diese Einstellungen sind standardmäßig ausgeblendet und nur verfügbar, wenn ein WeChat Pay-Integrations-Plugin wie WP Weixin Pay oder Woo WeChatPay installiert und aktiviert ist (dieses Verhalten kann mit dem Filter wp_weixin_show_settings_section geändert werden).
| Name | Typ | Beschreibung |
|---|---|---|
| Nutzen Sie die Händlerplattform | Kontrollkästchen | Erlauben Sie Benutzern, mit WeChat Geld an das Dienstkonto zu senden – ein Konto unter https://pay.weixin.qq.com/ ist erforderlich. Diese Einstellung ist nicht konfigurierbar (erzwungen aktiviert und ausgeblendet), wenn das Woo WeChatPay-Plugin aktiviert ist. |
| WeChat-Händler-App-ID | Text | Die AppID im Backend unter https://pay.weixin.qq.com/ – kann sich von der WeChat App ID unterscheiden, da das WeChat Pay-Konto möglicherweise mit einer anderen AppID verknüpft ist. Lassen Sie das Feld leer, um die WeChat-App-ID zu verwenden. |
| WeChat-Händler-ID | Text | Die Händler-ID im Backend unter https://pay.weixin.qq.com/index.php/extend/pay_setting . |
| Präfix des PEM-Zertifikats | Text | Das Präfix der Zertifikatsdateien, die von https://pay.weixin.qq.com/index.php/core/cert/api_cert heruntergeladen wurden.Das Standardpräfix für Zertifikatsdateien ist apiclient (für die Dateien apiclient_cert.pem und apiclient_key.pem ).Erforderlich insbesondere für die Abwicklung von Rückerstattungen über WeChat Pay. |
| Pfad der PEM-Zertifikatdateien | Text | Der absolute Pfad zum Ordner, der die von https://pay.weixin.qq.com/index.php/core/cert/api_cert heruntergeladenen Zertifikatsdateien im aktuellen Dateisystem enthält.Beispiel: /home/user/wechat-certificates .Der Benutzer, der PHP ausführt, muss über Leseberechtigungen verfügen und sich außerhalb des Webstammverzeichnisses befinden. Erforderlich insbesondere für die Abwicklung von Rückerstattungen über WeChat Pay. |
Zusätzlich zu diesen Einstellungen bietet das Plugin eine Bildschirmhilfe dazu, welche Werte für die verschiedenen URLs im API-Konfigurationsbildschirm des Händlerkontos eingegeben werden müssen.
| Name | Typ | Beschreibung |
|---|---|---|
| Verwenden Sie einen Proxy | Kontrollkästchen | Proxy aktivieren. |
| Proxy-Host | Text | IP-Adresse oder URI des Proxy-Hosts. |
| Proxy-Port | Text | Port, der für die Verbindung mit dem Proxy-Host verwendet werden soll. |
Abhängig von Ihrer Serverkonfiguration ist möglicherweise ein Proxy erforderlich, wenn sich WordPress hinter einer Firewall oder innerhalb eines Unternehmensnetzwerks befindet.
| Name | Typ | Beschreibung |
|---|---|---|
| WeChat-Namen und -Bild auf der Seite „Benutzerliste“ anzeigen | Kontrollkästchen | Überschreiben Sie die Anzeige der WordPress-Kontonamen und Avatare. |
| Öffentliche WeChat-Informationen anzeigen | Kontrollkästchen | Zeigen Sie die öffentlichen WeChat-Informationen auf Benutzerprofilseiten an. Integriert sich in WooCommece und Ultimate Member. |
| Link zur Bindung des WeChat-Kontos anzeigen | Kontrollkästchen | Zeigen Sie auf Benutzerprofilseiten einen Link zum Verknüpfen oder Lösen eines WordPress-Kontos mit einem WeChat-Konto an. Integriert sich in WooCommece und Ultimate Member. |
| Link zur Authentifizierung des WeChat-Kontos anzeigen | Kontrollkästchen | Zeigen Sie im WordPress-Anmeldeformular einen Link zur Authentifizierung per QR-Code mit einem WeChat-Konto an. |
| Bekanntheit der Sprache des offiziellen Kontomenüs | Kontrollkästchen | Passen Sie das Menü des offiziellen Kontos je nach Sprache des Benutzers an. Standardmäßig wird die Sprache des Menüs verwendet, die der Standardsprache der Website entspricht. Diese Einstellung ist nur verfügbar, wenn WPML aktiviert ist. |
| Verwenden Sie benutzerdefinierte Persistenz für access_token | Kontrollkästchen | Verwenden Sie eine benutzerdefinierte Persistenzmethode für das offizielle Konto access_token und seinen Ablaufzeitstempel. Warnung – erfordert die Implementierung von:
$access_info ist ein Array mit den Schlüsseln token und expiry .Fügen Sie die oben genannten Hooks in einer Aktion plugins_loaded mit einer Priorität von 5 oder weniger hinzu.Nützlich, um eine Race-Bedingung zu vermeiden, wenn die access_token-Informationen von mehreren Plattformen gemeinsam genutzt werden müssen. Wenn diese Option deaktiviert ist, werden Zugriffstoken und Ablaufzeitstempel in der WordPress-Optionstabelle in der Datenbank gespeichert. |
WP Weixin unterstützt Multisite-Installationen von WordPress, unabhängig davon, ob Domains/Subdomains oder Unterverzeichnisse verwendet werden. WP Weixin muss mit denselben Einstellungen konfiguriert und auf allen Blogs aktiviert werden, in denen eine Authentifizierung für ein bestimmtes offizielles Konto erforderlich ist.
Wenn die mobile WeChat-Authentifizierung aktiviert ist, werden Benutzer, die einen der Blogs besuchen, automatisch im Netzwerk registriert und mit der Standardbenutzerrolle des Blogs zum besuchten Blog hinzugefügt. Benutzer werden beim Besuch auch automatisch zu anderen Blogs des Netzwerks hinzugefügt, wenn sie bereits in einem der Blogs registriert sind. Dieses Verhalten kann mit dem Filter wp_weixin_ms_auto_add_to_blog geändert werden, beispielsweise wenn einige der Blogs keine vorauthentifizierten WeChat-Benutzer akzeptieren sollen.
Bei Verwendung eines domänen-/subdomänenbasierten Netzwerks von Blogs wird die Domäne/Subdomain des Hauptblogs für die domänenübergreifende Authentifizierung verwendet. Das Verhalten kann mit der Einstellung „Blog zur Authentifizierung erzwingen“ im Abschnitt „Multisite-Einstellungen“ der Plugin-Seite geändert werden.
Die integrierten WeChat Pay-Plugins können auch domänen-/subdomänenbasierte Netzwerkinstallationen von WordPress Multisite unterstützen, indem sie die von WP Weixin bereitgestellten Funktionen, Aktionen und Filter nutzen. Das für die Zahlung verwendete Blog kann mit der Option „Blog für WeChat-Zahlungen erzwingen“ im Abschnitt „Multisite-Einstellungen“ der Plugin-Seite erzwungen werden.
WP Weixin Pay und Woo WeChatPay sind Beispiele für in WeChat Pay integrierte Plugins, die unabhängig von der Art der Multisite-Installation (Unterverzeichnis oder Domain/Subdomain) funktionieren.
Im Gegensatz zu einigen Plugins (kommerziell, verschleiert und mit zweifelhaften Sicherheitsstandards) verlässt sich WP Weixin nicht auf ein domänenübergreifendes Skript, das im Stammverzeichnis von WordPress abgelegt wird, sondern nutzt lieber die WordPress-Aktionen und -Filter.
Es ist möglich, das Plugin mit mehreren offiziellen Konten im selben Netzwerk zu verwenden, solange der Entwickler die Filter-Hooks wp_weixin_ms_auth_blog_id und wp_weixin_ms_pay_blog_id nutzt, um die verschiedenen möglichen Szenarien zu berücksichtigen (ein einfaches Beispiel-Plugin finden Sie hier).
Eines der leistungsstärksten Tools von WP Weixin ist das PHP Wechat Software Development Kit. Um eine Instanz des WeChat SDK zu erhalten, können Entwickler das folgende Snippet verwenden:
$ wechat_sdk = wp_weixin_get_wechat (); Der zurückgegebene Wert ist eine Instanz von WP_Weixin_Wechat , einer Wrapper-Klasse für Wechat_SDK : Sie stellt sicher, dass alle Einstellungen und Token gültig und initialisiert sind. Entwicklern wird davon abgeraten, die Klasse Wechat_SDK direkt zu verwenden.
Alle öffentlichen Methoden von Wechat_SDK sind über das WP_Weixin_Wechat Objekt aufrufbar und sollten nur für fortgeschrittene Zwecke verwendet werden. Im Vergleich zu den bereitgestellten Funktionen handelt es sich um Methoden auf niedriger Ebene: Letztere sollten nach Möglichkeit verwendet werden, und Entwickler sollten das SDK nur verwenden, wenn keine Funktion vorhanden ist, die das beabsichtigte Ergebnis erzielt.
Informationen zu den verfügbaren öffentlichen Methoden finden Sie direkt im Quellcode von Wechat_SDK .
Kurzes, nicht optimiertes Beispiel für eine erweiterte Verwendung – machen Sie etwas mit der Liste der openIDs der Follower, mit Fehlerbehandlung:
$ 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 );
} Die unten aufgeführten Funktionen werden durch das Plugin für Theme- und Plugin-Entwickler öffentlich zugänglich gemacht. Obwohl die Hauptklassen des Plugins theoretisch ohne Nebenwirkungen instanziiert werden können, wenn der Parameter $hook_init auf false gesetzt ist, wird empfohlen, nur die folgenden Funktionen zu verwenden, da es keine Garantie dafür gibt, dass zukünftige Updates keine Verhaltensänderungen mit sich bringen.
Funktionsindex:
wp_weixin_is_wechat (); Beschreibung
Ob der Besucher den WeChat-Browser verwendet.
Rückgabewert
(bool) Ob der Besucher den WeChat-Browser verwendet.
wp_weixin_ajax_safe (); Beschreibung
Rufen Sie diese Funktion in einer WordPress-Ajax-Aktion auf. Erlauben Sie Interaktionen mit der WeChat-API während einer Ajax-Anfrage.
wp_weixin_get_user_by_openid ( string $ openid ); Beschreibung
Holen Sie sich einen WordPress-Benutzer über WeChat openID.
Parameter
$openid
(string) Eine WeChat openID.
Rückgabewert
(gemischt) Ein
WP_User, wenn ein WordPress-Benutzer mit einer entsprechenden WeChat-OpenID vorhanden ist, andernfallsfalse.
wp_weixin_get_user_by_unionid ( string $ unionid , int $ blog_id = false ); Beschreibung
Holen Sie sich einen WordPress-Benutzer über die WeChat-UnionID oder eine Sammlung von WordPress-Benutzern, wenn mehrere Übereinstimmungen vorhanden sind (nur möglich im Fall von Multisite mit mehreren offiziellen Konten).
Parameter
$unionid
(string) Eine WeChat-UnionID.
Rückgabewert
(gemischt) Ein
WP_User-Objekt, wenn ein WordPress-Benutzer mit einer entsprechenden WeChat-UnionID vorhanden ist, ein Array vonWP_User-Objekten, wenn mehrere Übereinstimmungen vorhanden sind, andernfallsfalse.
wp_weixin_get_wechat (); Beschreibung
Holen Sie sich eine Instanz von WP_Weixin_Wechat (Wrapper-Objekt für Wechat_SDK – siehe WeChat SDK).
Rückgabewert
(WP_Weixin_Wechat) Eine Instanz des Wrapper-Objekts für
Wechat_SDK.
wp_weixin_get_options (); Beschreibung
Erhalten Sie alle Optionen, die zum Konfigurieren des Plugins verwendet werden.
Rückgabewert
(Array) Ein assoziatives Array mit allen Optionen, die zum Konfigurieren des Plugins verwendet werden.
wp_weixin_get_option ( $ key ); Beschreibung
Rufen Sie einen bestimmten Optionswert ab, der zum Konfigurieren des Plugins verwendet wird.
Parameter
$key
(string) Der Optionsschlüssel.
Rückgabewert
(gemischt) Eine Zeichenfolge, ein boolescher Wert oder eine Ganzzahl, wenn die Option einen Wert hat, andernfalls
null.
wp_weixin_wpml_switch_lang ( $ force = true ); Beschreibung
Wenn WPML aktiv ist und die WeChat-Sprache des aktuellen Benutzers bekannt ist, stellen Sie die Sprache auf den vom WeChat-Konto des Benutzers bereitgestellten Wert um.
Verwendet SitePress::switch_lang( $code = null, $cookie_lang = false ) – es liegt am Entwickler, sich mit der WMPL-Codebasis und -Dokumentation vertraut zu machen.
Parameter
$force
(bool) Wenn auf
truegesetzt, wird die Sprache immer umgeschaltet; Beifalsewird die Sprache nur umgeschaltet, wenn „Browser-Sprachumleitung“ in WPML aktiviert ist – Standardwerttrue.
Rückgabewert
(bool) Ob
SitePress::switch_lang( $code = null, $cookie_lang = false )aufgerufen wurde.
wp_weixin_get_signed_package (); Beschreibung
Holen Sie sich ein von WeChat signiertes Paket zur Verwendung mit der WeChat JSAPI.
Hinweis: Die globale JavaScript-Variable wx ist bereits ordnungsgemäß signiert und mit der vollständigen jsApiList initialisiert, wenn das wp-weixin-main-script bereits in der Warteschlange steht.
Weitere Einzelheiten finden Sie im Abschnitt „JavaScript“ der Dokumentation.
Rückgabewert
(Array) Das signierte Paket, das über
wp_localize_script( $handle, $object_name, $l10n )an ein Skript übergeben werden soll.
wp_weixin_get_user_wechat_info ( int $ user_id = false , bool $ output = false ); Beschreibung
Rufen Sie die WeChat-Informationen eines Benutzers ab. Ruft die aktuelle Benutzer-ID ab, wenn die Benutzer-ID weggelassen wird.
Parameter
$user_id
(int) Die ID des Benutzers – Standardwert
false.
$Ausgabe
(bool) Gibt an, ob die Informationen ausgegeben werden sollen (unter Verwendung der Vorlage „wp-weixin-public-info“) – Standardwert:
false.
Rückgabewert
(gemischt) Ein Array von WeChat-Informationen, falls vorhanden, andernfalls
false.
wp_weixin_get_user_wechat_openid ( int $ user_id = false ); Beschreibung
Rufen Sie die WeChat openID eines Benutzers ab. Ruft die aktuelle Benutzer-ID ab, wenn die Benutzer-ID weggelassen wird.
Parameter
$user_id
(int) Die ID des Benutzers – Standardwert
false.
Rückgabewert
(gemischt) Eine WeChat-OpenID, falls vorhanden, andernfalls
false.
wp_weixin_get_auth_link ( bool $ output = false , string $ target = '' , $ class = '' ); Beschreibung
Erhalten Sie einen Link zur WeChat-Authentifizierungsseite.
Diese Funktion hat im WeChat-Browser keine Auswirkung.
Parameter
$Ausgabe
(bool) Gibt an, ob der Link ausgegeben werden soll.
$target
(string) Das Ziel des Links.
$target
(string) Die CSS-Klasse des Links.
Rückgabewert
(gemischt) Wenn
$outputauftruegesetzt ist, ist das Markup des Links andernfallsfalse.
wp_weixin_get_bind_link ( bool $ output = false , string $ target = ' _blank ' ); Beschreibung
Erhalten Sie einen Link zur WeChat-Kontobindungsseite.
Diese Funktion hat im WeChat-Browser keine Auswirkung.
Parameter
$Ausgabe
(bool) Gibt an, ob der Link ausgegeben werden soll.
$target
(string) Das Ziel des Links.
Rückgabewert
(gemischt) Wenn
$outputauftruegesetzt ist, ist das Markup des Links andernfallsfalse.
wp_weixin_unbind ( int $ user_id , string $ open_id = '' ); Beschreibung
Lösen Sie die Bindung eines WordPress-Benutzerkontos, das zuvor mit WeChat verknüpft war, und löschen Sie so alle aufgezeichneten Informationen im Zusammenhang mit dem zugehörigen WeChat-Konto.
Hinweis: Ein reines WeChat-WordPress-Benutzerkonto ist ein WordPress-Konto, das automatisch von WP Weixin beim Öffnen der Website im WeChat-Browser erstellt wurde (Benutzername folgt dem Muster wx-[openid] ).
Wenn eine user_id bereitgestellt wird, die einem Nur-WeChat-WordPress-Benutzerkonto entspricht, das möglicherweise zuvor gebunden wurde oder nicht (Benutzername nach dem Muster wx-[openid] oder wx-bound-[openid] ), wird der Benutzername mit dem wx-unbound-[openid] aktualisiert wx-unbound-[openid] Muster.
Parameter
$user_id
(int) Die ID des Benutzers.
$open_id
(string) Die openID des WeChat-Kontos – wenn leer, wird sie auf den aufgezeichneten Wert des aktuellen Benutzers gesetzt.
Rückgabewert
(bool) Ob die Bindung des Kontos aufgehoben wurde.
wp_weixin_bind ( int $ user_id , string $ openid ); Beschreibung
Verknüpfen Sie ein WordPress-Benutzerkonto mit WeChat und überschreiben Sie so effektiv alle aufgezeichneten Informationen zu einem verknüpften WeChat-Konto, falls vorhanden.
Hinweis: Ein reines WeChat-WordPress-Benutzerkonto ist ein WordPress-Konto, das automatisch von WP Weixin beim Öffnen der Website im WeChat-Browser erstellt wurde (Benutzername folgt dem Muster wx-[openid] ).
Es muss ein reines WeChat-WordPress-Benutzerkonto mit der bereitgestellten $openid vorhanden sein.
Wenn ein Wert für $user_id angegeben wird, der einem reinen WeChat-WordPress-Benutzerkonto entspricht, das möglicherweise zuvor nicht gebunden war (Benutzername folgt dem Muster wx-[openid] oder wx-unbound-[openid] ), wird der Benutzername aktualisiert mit dem Muster wx-bound-[openid] .
Eine bestimmte openID kann nicht verwendet werden, um WeChat mit mehreren WordPress-Benutzerkonten zu verbinden.
Parameter
$user_id
(int) Die ID des Benutzers.
$open_id
(string) Die openID, die einem Nur-WeChat-WordPress-Benutzerkonto entspricht.
Rückgabewert
(bool) Ob das Konto gebunden war.
wp_weixin_is_follower ( int $ user_id ); Beschreibung
Überprüfen Sie, ob der Benutzer mit der ID $user_id ein Follower des offiziellen WeChat-Kontos ist.
Parameter
$user_id
(int) Die ID des Benutzers.
Rückgabewert
(bool) Ob der Benutzer dem offiziellen WeChat-Konto folgt.
WP Weixin bietet Entwicklern die Möglichkeit, sein Verhalten mit einer Reihe benutzerdefinierter Aktionen und Filter anzupassen.
Aktionsindex:
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 ); Beschreibung
Wird ausgelöst, wenn WP Weixin vollständig geladen ist und in den WP Weixin-Haupteinstellungen „Aktiviert“ aktiviert ist. Wird normalerweise zum Erstellen von Plugins mit WP Weixin als Kern verwendet.
Hinweis: Es wird empfohlen, nach Möglichkeit die bereitgestellten Funktionen anstelle der Methoden der Parameter dieser Aktion zu verwenden, da es keine Garantie dafür gibt, dass zukünftige Updates keine Verhaltensänderungen mit sich bringen.
Parameter
$wechat
(gemischt) Ein
WP_Weixin_Wechat-Objekt.
$wp_weixin_settings
(gemischt) Ein
WP_Weixin_Settings-Objekt.
$wp_weixin
(gemischt) Ein
WP_Weixin-Objekt.
$wp_weixin_auth
(gemischt) Ein
WP_Weixin_Auth-Objekt.
$wp_weixin_responder
(gemischt) Ein
WP_Weixin_ResponderObjekt, wenn der WeChat-Responder aktiviert ist, andernfallsfalse.
$wp_weixin_menu
(gemischt) Ein
WP_Weixin_Menu-Objekt, wenn der WeChat-Responder aktiviert ist, andernfallsfalse.
do_action ( ' wp_weixin_responder ' , array $ request_data ); Beschreibung
Gefeuert, nachdem eine Anfrage von WeChat erhalten wurde.
Parameter
$request_data
(Array) Die in der Anfrage von WeChat gesendeten Daten.
do_action ( ' wp_weixin_save_access_info ' , array $ access_info ); Beschreibung
Wird nach der Erneuerung des offiziellen Kontozugriffstokens ausgelöst, wenn benutzerdefinierte Persistenz verwendet wird. Wird zum Speichern der Zugriffsinformationen verwendet – besonders nützlich, um eine Race-Bedingung zu vermeiden, wenn das access_token von mehreren Plattformen gemeinsam genutzt werden muss.
Parameter
$access_info
(Array) Die Zugriffsinformationen in einem assoziativen Array. Schlüssel sind
tokenundexpiry.
do_action ( ' wp_weixin_before_user_profile_wechat_info ' , mixed $ wechat_info , mixed $ user ); Beschreibung
Wird ausgelöst, bevor öffentliche WeChat-Informationen im Benutzerprofil angezeigt werden.
Parameter
$wechat_info
(gemischt) Ein Array öffentlicher WeChat-Informationen, die im Benutzerprofil angezeigt werden, sofern vorhanden, andernfalls
false.
$Benutzer
(gemischt) Ein
WP_UserObjekt, wenn der Benutzer vorhanden ist, andernfallsfalse.
do_action ( ' wp_weixin_after_user_profile_wechat_info ' , mixed $ wechat_info , mixed $ user ); Beschreibung
Wird ausgelöst, nachdem öffentliche WeChat-Informationen im Benutzerprofil angezeigt wurden.
Parameter
$wechat_info
(gemischt) Ein Array öffentlicher WeChat-Informationen, die im Benutzerprofil angezeigt werden, andernfalls
false.
$Benutzer
(gemischt) Ein
WP_UserObjekt, wenn der Benutzer vorhanden ist, andernfallsfalse.
do_action ( ' wp_weixin_before_bind_account ' , int $ user_id , int $ wechat_user_id , array $ wechat_user_blog_ids , int $ current_blog_id ); Beschreibung
Wird vor der Bindung eines WordPress-Benutzerkontos an WeChat ausgelöst.
Parameter
$user_id
(int) Die Benutzer-ID.
$wechat_user_id
(int) ID eines Nur-WeChat-WordPress-Benutzerkontos (Benutzername nach dem Muster
wx-[openid]).
$wechat_user_blog_ids
(Array) Liste der Blog-IDs, zu denen das Nur-WeChat-WordPress-Benutzerkonto gehört.
$current_blog_id
(int) Die Blog-ID des aktuellen Blogs.
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 ); Beschreibung
Wird ausgelöst, nachdem ein WordPress-Benutzerkonto mit WeChat verknüpft wurde.
Parameter
$gebunden
(bool) Ob das WordPress-Benutzerkonto erfolgreich mit WeChat verknüpft wurde.
$user_id
(int) Die Benutzer-ID.
$wechat_user_id
(int) ID eines Nur-WeChat-WordPress-Benutzerkontos (Benutzername nach dem Muster
wx-[openid]).
$wechat_user_blog_ids
(Array) Liste der Blog-IDs, zu denen das Nur-WeChat-WordPress-Benutzerkonto gehört.
$current_blog_id
(int) Die Blog-ID des aktuellen Blogs.
do_action ( ' wp_weixin_before_unbind_account ' , int $ user_id , string $ openid ); Beschreibung
Feuern Sie, bevor Sie ein WordPress-Benutzerkonto von WeChat trennen.
Parameter
$user_id
(int) Die Benutzer-ID.
$openid
(string) Die WeChat openID.
do_action ( ' wp_weixin_after_unbind_account ' , bool $ unbound , int $ user_id , string $ openid ); Beschreibung
Wird ausgelöst, nachdem die Bindung eines WordPress-Benutzerkontos von WeChat aufgehoben wurde.
Parameter
$ungebunden
(bool) Ob die Bindung des WordPress-Benutzerkontos erfolgreich von WeChat gelöst wurde.
$user_id
(int) Die Benutzer-ID.
$openid
(string) Die WeChat openID.
do_action ( ' wp_weixin_before_tabs_settings ' );Beschreibung Wird vor der Ausgabe der Registerkarten der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_before_main_tab_settings ' );Beschreibung Wird vor der Ausgabe der Registerkarte „Haupteinstellungen“ der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_before_main_settings_inner ' );Beschreibung Wird vor der Ausgabe des Haupteinstellungsinhalts auf der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_after_main_settings_inner ' );Beschreibung Wird nach der Ausgabe des Haupteinstellungsinhalts auf der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_after_main_tab_settings ' );Beschreibung Wird nach der Ausgabe der Registerkarte „Haupteinstellungen“ der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_before_qr_tab_settings ' );Beschreibung Wird vor der Ausgabe der Registerkarte „QR-Code-Generator“ der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_after_qr_tab_settings ' );Beschreibung Wird nach der Ausgabe des QR-Code-Generator-Tabs der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_after_tabs_settings ' );Beschreibung Wird nach der Ausgabe der Registerkarten der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_before_settings ' );Beschreibung Wird vor der Ausgabe der Einstellungen auf der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_before_main_settings ' );Beschreibung Wird vor der Ausgabe des Haupteinstellungsfelds auf der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_after_main_settings ' );Beschreibung Wird nach der Ausgabe des Haupteinstellungsfelds auf der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_before_qr_settings ' );Beschreibung Wird vor der Ausgabe des QR-Code-Generators auf der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_before_qr_settings_inner ' );Beschreibung Wird vor der Ausgabe des QR-Code-Generatorfelds auf der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_after_qr_settings_inner ' );Beschreibung Wird nach der Ausgabe des QR-Code-Generatorfelds auf der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_after_qr_settings ' );Beschreibung Wird nach der Ausgabe des QR-Code-Generators auf der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_after_settings ' );Beschreibung Wird nach der Ausgabe der Einstellungen auf der WP Weixin-Seite ausgelöst.
do_action ( ' wp_weixin_endpoints ' ); Beschreibung
Wird beim Hinzufügen von WP Weixin-Umschreibungsregeln ausgelöst. Nützlich für Begleit-Plugins, um ihre eigenen hinzuzufügen und sicherzustellen, dass sie ordnungsgemäß registriert sind (Regeln werden geleert, wenn die WP Weixin-Einstellungen gespeichert werden).
do_action ( ' wp_weixin_handle_payment_notification ' ); Beschreibung
Wird bei der Bearbeitung einer WeChat Pay-Transaktionsbenachrichtigung ausgelöst.
Zuletzt von WP Weixin ( PHP_INT_MIN ) ausgelöst; sollte früher durch Companion-Plugins ausgelöst werden, die in WeChat Pay integriert sind.
Sehen Sie sich das Gerüst des WeChat Pay-Integrations-Plugins an, um zu erfahren, wie Sie mit WeChat Pay-Benachrichtigungen umgehen.
do_action ( ' wp_weixin_handle_auto_refund ' , mixed $ refund_result , array $ payment_result ); Beschreibung
Wird ausgelöst, nachdem versucht wurde, eine automatische Rückerstattung für eine fehlgeschlagene Transaktion durchzuführen.
Sehen Sie sich das Grundgerüst des WeChat Pay-Integrations-Plugins an, um zu erfahren, wie Sie mit den automatischen Rückerstattungsergebnissen von WP Weixin umgehen.
Parameter
$refund_result
(gemischt) Ein Array, das die Antwort der WeChat Pay API enthält, falls die Rückerstattung erfolgreich war, andernfalls
false.
$zahlungsergebnis
(Array) Ein Zahlungsbenachrichtigungsergebnis. Struktur eines Ergebnisses:
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 */
);Filterindex:
apply_filters ( ' wp_weixin_browser_page_qr_src ' , string $ src ); Beschreibung
Filtern Sie die Quelle des QR-Codes, um ihn in klassischen Browsern für eine Seite anzuzeigen, die nur über den WeChat-Browser zugänglich ist.
Parameter
$src
(string) Die Quelle des QR-Codes, der in klassischen Browsern angezeigt werden soll.
apply_filters ( ' wp_weixin_subscribe_src ' , string $ src ); Beschreibung
Filtern Sie die Quelle des QR-Codes, der zum Verfolgen des offiziellen Kontos verwendet wird.
Parameter
$src
(string) Die Quelle des QR-Codes.
apply_filters ( ' wp_weixin_follower_notice_title ' , string $ title ); Beschreibung
Filtern Sie den Titel der Seite, auf der der QR-Code angezeigt wird, um dem offiziellen Konto zu folgen.
Parameter
$title
(string) Der Titel der Seite – standardmäßig „Follow Us!“.
apply_filters ( ' wp_weixin_follower_notice ' , string $ notice ); Beschreibung
Filtern Sie die auf der Seite mit dem QR-Code angezeigte Nachricht, um dem offiziellen Konto zu folgen.
Parameter
$Hinweis
(string) Die angezeigte Nachricht – Standardeinstellung: „Bitte scannen Sie diesen QR-Code, um uns zu folgen, bevor Sie auf diesen Inhalt zugreifen.“
apply_filters ( ' wp_weixin_auth_needed ' , bool $ needs_auth ); Beschreibung
Ob die URL erfordert, dass der Benutzer mit WeChat authentifiziert werden muss. Wenn „WeChat-Authentifizierung aktivieren“ in den Einstellungen aktiviert ist, benötigen URLs, die init Aktions-Hook von WordPress auslösen, standardmäßig eine Authentifizierung, es sei denn, sie werden mithilfe dieses Filters auf die Whitelist gesetzt. Standardmäßig sind alle Admin-Seiten, die klassische Browser-Authentifizierungsseite von WP Weixin, der WordPress-Ajax-Endpunkt, der WeChat-Responder-Endpunkt und die WooCommerce-API-Endpunkte auf der Whitelist und außerhalb von WeChat zugänglich.
Parameter
$needs_auth
(bool) Gibt an, ob eine Authentifizierung erforderlich ist, um die URL zu besuchen.
apply_filters ( ' wp_weixin_debug ' , bool $ debug ); Beschreibung
Filtern Sie, ob der Debug-Modus aktiviert werden soll (PHP-Fehlerprotokolle, JavaScript-Konsolenmeldungen, JavaScript-Warnungen).
Parameter
$debug
(bool) Ob der Debug-Modus aktiviert ist – Standardwert
WP_DEBUGKonstante.
apply_filters ( ' wp_weixin_follower_welcome_title ' , string $ title , mixed $ before_subscription ); Beschreibung
Filtern Sie den Titel der Nachricht, die der Benutzer erhält, wenn er dem offiziellen Konto folgt.
Parameter
$title
(Zeichenfolge) Der Titel – Standard „‚Willkommen
user_name!‘“, wobeiuser_nameder WeChat-Name des Benutzers ist.
$before_subscription
(gemischt) Wenn numerisch, die
WP_PostID der letzten Seite, die der Benutzer besucht hat; if string, die URL der letzten Seite, die der Benutzer besucht hat – Standardhome_url().
apply_filters ( ' wp_weixin_follower_welcome_description ' , string $ description , mixed $ before_subscription ); Beschreibung
Filtern Sie die Beschreibung der Nachricht, die der Benutzer erhält, wenn er dem offiziellen Konto folgt.
Parameter
$beschreibung
(string) Die Beschreibung – Standard „Vielen Dank, dass Sie unser offizielles Konto abonniert haben!“.
$before_subscription
(gemischt) Wenn numerisch, die
WP_PostID der letzten Seite, die der Benutzer besucht hat; if string, die URL der letzten Seite, die der Benutzer besucht hat – Standardhome_url().
apply_filters ( ' wp_weixin_follower_welcome_url ' , string $ url , mixed $ before_subscription ); Beschreibung
Filtern Sie die URL, zu der der Benutzer weitergeleitet wird, wenn er mit der Nachricht interagiert, die er erhält, wenn er dem offiziellen Konto folgt.
Parameter
$url
(string) Die URL, zu der der Benutzer umgeleitet wird – standardmäßig
home_url()wenn vor dem Senden der Nachrichtenvorlage keine URL aufgezeichnet wurde.
$before_subscription
(gemischt) Wenn numerisch, war die
WP_Post-ID der letzten Seite, die der Benutzer besuchte; Wenn String, die URL der letzten Seite, die der Benutzer besuchte - standardmäßighome_url().
apply_filters ( ' wp_weixin_follower_welcome_pic_url ' , string $ pic_url , mixed $ before_subscription ); Beschreibung
Filtern Sie die URL des auf der Nachricht angezeigten Bilds, das der Benutzer empfängt, wenn sie dem offiziellen Konto folgen.
Parameter
$ pic_url
(String) Die URL des Bildes - Standard
WP_PLUGIN_URL . '/wp-weixin/images/default-welcome.png'.
$ vor_subscription
(gemischt) Wenn numerisch, war die
WP_Post-ID der letzten Seite, die der Benutzer besuchte; Wenn String, die URL der letzten Seite, die der Benutzer besuchte - standardmäßighome_url().
apply_filters ( ' wp_weixin_get_access_info ' , array $ access_info ); Beschreibung
Filtern Sie das Access -Token und die Token -Ablauf, wenn Sie das Objekt WP_Weixin_WeChat (Wrapper eines Wechat_SDK -Objekts) anfordern, wenn benutzerdefinierte Persistenz verwendet wird - besonders nützlich, um eine Rennbedingung zu vermeiden, wenn der Zugriffstoken zwischen mehreren Plattformen geteilt werden muss.
Parameter
$ access_info
(Array) Die Zugriffsinformationen in einem assoziativen Array. Werttypen und Tasten: (String)
token, (int)expiry.
apply_filters ( ' wp_weixin_jsapi_urls ' , array $ jsapi_urls ); Beschreibung
Filtern Sie die URLs, die erforderlich sind, um sich auf dem API -Konfigurationsbildschirm des WeChat Merchant -Kontos zu registrieren - verwendet, wenn ein anderes Plugin WeChat Pay -Integration implementiert.
Parameter
$ jsapi_urls
(Array) Die URLs, die sich auf dem API -Konfigurationsbildschirm des WeChat Merchant -Kontos registrieren können.
apply_filters ( ' wp_weixin_pay_callback_endpoint ' , string $ endpoint ); Beschreibung
Filtern Sie den Endpunkt der QR -Zahlungs -URL, die erforderlich ist, um sich auf dem API -Konfigurationsbildschirm des WeChat Merchant -Kontos zu registrieren - verwendet bei der Implementierung der WeChat -Pay -Integration.
Parameter
$ callback_url
(String) Der Endpunkt der QR -Zahlungs -URL, um sich im API -Konfigurationsbildschirm des WeChat -Merchant -Kontos zu registrieren (Beispiel:
/my_plugin/notify).
apply_filter ( ' wp_weixin_settings ' , $ settings ); Beschreibung
Filtern Sie die zum Konfigurieren des Plugins verwendeten Einstellungen. In einem plugins_loaded -Action -Hook mit Priorität von 5 oder weniger müssen Hakenfunktionen oder Methoden zu diesem Filter hinzugefügt werden.
Parameter
$ Einstellungen
(Array) Die zum Konfigurieren des Plugins verwendeten Einstellungen.
apply_filters ( ' wp_weixin_show_settings_section ' , bool $ show_section , string $ section_name , array $ section ); Beschreibung
Filter Wether, um einen Einstellungsabschnitt auf der Seite WP Weixin Einstellungen anzuzeigen.
Parameter
$ show_section
(BOOL) Wether, um den Abschnitt "Einstellungen" auf der Seite WP Wixin Einstellungen anzuzeigen.
$ Section_Name
(Zeichenfolge) Der Name des Abschnitts Einstellungen.
$ Abschnitt
(Array) Die Einstellungen des Abschnitts.
apply_filters ( ' wp_weixin_show_setting ' , bool $ show_setting , string $ section_name , int $ index , array $ value ); Beschreibung
Filter Wether, um eine Einstellung auf der Seite WP Wexin Einstellungen anzuzeigen.
Parameter
$ show_seting
(BOOL) Wether, um die Einstellung auf der Seite WP Weixin Einstellungen anzuzeigen.
$ Section_Name
(Zeichenfolge) Der Name des Abschnitts, zu dem die Einstellung gehört.
$ index
(int) Der Index der Einstellung im Abschnitt.
$ Wert
(Array) Die Einstellung.
apply_filters ( ' wp_weixin_settings_fields ' , array $ settings_fields ); Beschreibung
Filtern Sie die Einstellungsfelder auf der Seite WP Weixin Einstellungen.
Parameter
$ include_section
(Array) Die Einstellungsfelder, die auf der Seite WP Wixin Einstellungen angezeigt werden.
apply_filters ( ' wp_weixin_auth_redirect ' , mixed $ redirect , bool $ auth , bool $ has_error ); Beschreibung
Filtern Sie die URL so, dass die QR -Code -Authentifizierung in klassischen Browsern durchgeführt wird.
Parameter
$ redirect
(gemischt) Die URL zur Umleitung zu dem Zeitpunkt, an dem die Authentifizierung durchgeführt wird, oder
false, wenn keine Weiterleitung. Standard isthome_url()im Falle einer erfolgreichen Authentifizierung.
$ auth
(bool) Was die Authentifizierung durchgeführt wurde -
true, wenn er erfolgreich ist,false, wenn ein Fehler aufgetreten ist.
$ has_error
(bool) Was ein Fehler aufgetreten ist.
apply_filters ( ' wp_weixin_scan_heartbeat_frequency ' , int $ frequency ); Beschreibung
Filtern Sie die Häufigkeit der Schecks, wenn Sie auf die Bestätigung der QR -Code -Scan in klassischen Browsern warten.
Parameter
$ Frequenz
(int) Die Frequenz in Millisekunden. Standard
1000.
apply_filters ( ' wp_weixin_qr_cleanup_frequency ' , string $ frequency ); Beschreibung
Filtern Sie die Frequenz, um abgelaufene QR -Codedaten zu beseitigen.
Parameter
$ Frequenz
(Zeichenfolge) Die Frequenz. Standard
'hourly'.
apply_filters ( ' wp_weixin_qr_lifetime ' , int $ lifetime ); Beschreibung
Filtern Sie die Lebensdauer eines potenziell empfindlichen QR -Codes wie WeChat -Authentifizierung oder WeChat -Kontobindung.
Parameter
$ Lifetime
(int) die Lebensdauer in Sekunden. Standard
600.
apply_filters ( ' wp_weixin_user_wechat_info ' , mixed $ wechat_info , int $ user_id ); Beschreibung
Filtern Sie die Benutzerwechat -Informationen.
Parameter
$ wechat_info
(gemischt) Eine Reihe von WeChat -Informationen, falls vorhanden, ansonsten
false.
$ Lifetime
(int) Die Benutzer -ID - Standard
0.
apply_filters ( ' wp_weixin_ms_auto_add_to_blog ' , bool $ auto_add_to_blog , int $ blog_id , int $ user_id ); Beschreibung
Filtern Sie, um den Benutzer automatisch zum besuchten Blog im Netzwerk hinzuzufügen, wenn Sie mit WeChat authentifiziert werden.
Parameter
$ auto_add_to_blog
(BOOL) Wether, um den Benutzer automatisch dem besuchten Blog im Netzwerk hinzuzufügen, wenn sie mit WeChat authentifiziert werden - Standard
true.
$ blog_id
(int) Die ID des besuchten Blogs.
$ user_id
(int) Die ID des Benutzers, der das Blog besucht.
apply_filters ( ' wp_weixin_ms_auth_blog_id ' , int $ auth_blog_id ); Beschreibung
Filtern Sie die für die Authentifizierung verwendete Blog -ID - standardmäßig wird angenommen, dass der Domänenname des Standardblogs im WeChat -Backend registriert ist.
Warnung: Um sicherzustellen, dass WP Weixin mehrere offizielle Konten unterstützt, werden die OpenIDs von gebundenen Konten mit einem Benutzer-Meta-Datensatz gespeichert, der den Wert von $auth_blog_id in seinem Meta-Schlüssel enthält ( 'wx_openid-' . $auth_blog_id ).
Wenn bereits WeChat-gebundene WordPress-Benutzer vorhanden sind (manuell gebunden oder automatisch erstellt, wenn Sie die Site mit dem WeChat-Browser besuchen), wird die Beziehung zwischen dem Benutzer und der aufgezeichneten $auth_blog_id während der Laufzeit die Beziehung zwischen dem Benutzer und dem aufgezeichneten OpenID zurückgegeben.
Es liegt an dem Entwickler, die Datenbank direkt zu aktualisieren oder einen einmaligen Gebrauchs-Code-Snippet wie unten auszuführen.
Beispiel für das Code -Snippet, das nach dem Ändern der für die Authentifizierung verwendeten Blog -ID ausgeführt werden soll, falls WordPress -Benutzer bereits mit WeChat gebunden sind:
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
)
); Parameter
$ auth_blog_id
(int) Die ID des Blogs, die bei der WeChat -Authentifizierung verwendet werden soll. Standard
1.
apply_filters ( ' wp_weixin_ms_pay_blog_id ' , int $ pay_blog_id ); Beschreibung
Filtern Sie die Blog -ID, mit der die URLs erstellt werden können, und erhalten Sie Zahlungsbenachrichtigungen von der WeChat Pay -API - standardmäßig wird angenommen, dass die Domäne (oder Subdomain), die der ID des aktuellen Blogs entspricht, in WeChat Backend registriert ist. Nützlich, falls mehrere Fälle von WooCommerce im selben Netzwerk oder bei einem Netzwerk, das mit mehreren offiziellen Konten verbunden ist, ausgeführt werden.
Parameter
$ pay_blog_id
(INT) Die ID des Blogs, mit der die QR -Zahlungsrückruf -URL erstellt wurde. Standard
get_current_blog_id().
apply_filters ( ' wp_weixin_locate_template_paths ' , array $ paths , string $ plugin_name ); Beschreibung
Filtern Sie die möglichen Wege der Vorlagen, die von WP Wexin und Companion -Plugins enthalten sind.
Parameter
$ Pfade
(Array) Die möglichen Pfade. Standard (wobei
$template_nameder Dateiname der Vorlage ist):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
(String) Der Name des Plugins Die Vorlage gehört zu.
apply_filters ( ' wp_weixin_get_user_by_openid ' , $ user , $ openid ); Beschreibung
Filtern Sie das Ergebnis einer Abfrage, die einen WordPress -Benutzer erhalten, der einem aufgezeichneten WeChat OpenID zugeordnet ist.
Parameter
$ Benutzer
(gemischt) Das
WP_User-Objekt, wenn der Benutzer gefunden wurde, sonstfalse.
$ openID
(String) Die OpenID, die zur Suche nach dem Benutzer verwendet wird
apply_filters ( ' wp_weixin_pay_notify_results ' , ( array ) $ results ); Beschreibung
Filtern Sie die Ergebnisse der Bearbeitung einer Zahlungsbenachrichtigung.
Nicht tatsächlich von WP Wexin selbst angewendet, sondern erst nach einem Begleit -Plugin WP_Weixin_handle_Payment_Notification.
In einem WeChat Pay Integration -Plugin -Skelett finden Sie, wie die Ergebnisse der Zahlungsbenachrichtigung hinzugefügt werden.
Parameter
$ Ergebnisse
(Array) Eine Reihe von Zahlungsbenachrichtigungsgebnissen. Struktur eines Ergebnisses:
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 ); Beschreibung
Filtern Sie die Beschreibung der WeChat -Lohneinstellungen.
Parameter
$ eCommerce_description
(Zeichenfolge) Die Beschreibung der Wechat -Lohneinstellungen (HTML).
apply_filters ( ' wp_weixin_subscribe_qr_url ' , $ wp_weixin_subscribe_qr_url ); Beschreibung
Filtern Sie die URL für den QR -Code des WeChat Official Account Abonnements.
Parameter
$ wp_weixin_subscribe_qr_url
(String) Die URL für den QR -Code des WeChat Official Account Abonnements.
Die folgenden Vorlagendateien werden unter Verwendung der von WordPress bereitgestellten Funktionen von locate_template() ausgewählt und mit load_template() enthalten. Dies bedeutet, dass sie im aktiven WordPress -Thema überladen werden können. Entwickler können ihre benutzerdefinierten Vorlagendateien in den folgenden Verzeichnissen unter dem Ordner des Themas (in der Reihenfolge der Auswahlpriorität) platzieren:
plugins/wp-weixin/wp-weixin/plugins/ Die verfügbaren Pfade der Vorlagen können mit dem Filter WP_Weixin_Locate_Template_Paths angepasst werden. Der auf alle folgende Vorlagen angewendete Stil ist als 'wp-weixin-main-style' eingesetzt.
Vorlagenindex:
wp-weixin-subscribe.php
Beschreibung
Die Vorlage der Seite, in der der QR -Code angezeigt wird, um dem offiziellen Konto zu folgen. Wird verwendet, wenn "Kraft folgen" in den Einstellungen aktiviert ist.
$ titel
(String) Der Titel des Bildschirms, der dem Benutzer präsentiert wird.
$ meldung
(Zeichenfolge) Die Nachricht, in der beschrieben wird, warum der Benutzer diesen Bildschirm sieht.
$ qr_src
(String) Die Quelle des QR -Codebildes.
wp-weixin-browser-qr.php
Beschreibung
Die Vorlage der Seite, auf der der QR -Code angezeigt wird, wenn die Website nur über den WeChat -Browser zugänglich ist.
Variablen
$ page_qr_src
(String) Die Quelle des QR -Codebildes.
wp-weixin-auth-form-link.php
Beschreibung
Die Vorlage des WeChat -Authentifizierungs -Links.
Variablen
$ Klasse
(String) Das Klassenattribut des Links.
$ Ziel
(Zeichenfolge) Das Zielattribut des Links.
wp-weixin-auth-page.php
Beschreibung
Die Vorlage des WeChat -Bildschirms für die QR -Code -Authentifizierung in klassischen Browsern.
wp-weixin-mobile-auth-check.php
Beschreibung
Die Vorlage des WeChat -Bildschirms Mobile Browser wird beim Authentifizieren über die QR -Code -Authentifizierung in klassischen Browsern angezeigt.
Variablen
$ auth_qr_data
(Array) Daten in Bezug auf die Authentifizierung. Werttypen und Tasten: (bool)
auth, (int)user_id, (array)error, (bool | string)redirect. Derredirectwird standardmäßig nicht für die Umleitung auf Mobilgeräte verwendet (verwendet nach der Authentifizierung auf dem Desktop).
wp-weixin-bind-form-link.php
Beschreibung
Die Vorlage des WeChat Account -Bindungsverbindungsverbindung.
Variablen
$ link_text
(Zeichenfolge) Der Text des Links.
$ wechat_info
(gemischt) Eine Reihe von WeChat -Informationen, falls vorhanden, ansonsten
false.
$ Klasse
(String) Das Klassenattribut des Links.
$ Ziel
(Zeichenfolge) Das Zielattribut des Links.
wp-weixin-bind-page.php
Beschreibung
Die Vorlage des WeChat -Bildschirms für WeChat -Konto Bindind in klassischen Browsern.
Variablen
$ user_id
(INT) Die ID des Benutzers, an ein WeChat -Konto zu binden.
$ wechat_info
(gemischt) Eine Reihe von WeChat -Informationen, falls vorhanden, ansonsten
false.
wp-weixin-mobile-bind-check.php
Beschreibung
Die Vorlage des WeChat Mobile Browser -Bildschirms wird beim Versuch eines WeChat -Kontos über QR -Code in klassischen Browsern angezeigt.
Variablen
$ bind_qr_data
(Array) Daten im Zusammenhang mit der Kontobindung. Werttypen und Tasten: (bool)
bind, (int)user_id, (array)error, (bool | String)redirect. Derredirectist auf Mobilgeräten immerfalse(besiedelt und nach der Kontobindung auf dem Desktop verwendet).
wp-weixin-public-info.php
Beschreibung
Die Vorlage zur Ausgabe der öffentlichen Informationen von WeChat - insbesondere beim Aufrufen von wp_weixin_get_user_wechat_info mit dem auf false festgelegten Parameter $output .
Variablen
$ wechat_info
(Array) Die WeChat öffentlichen Informationen. Wert sind alle Typen (Zeichenfolge) mit Schlüsseln:
nickname,headimgurl,sex,language,city,province,country,unionid.
wp-weixin-account-form-password-notice.php
Beschreibung
Die Vorlage der Mitteilung, die im Formular angezeigt werden soll, um das Benutzerkonto -Passwort zu ändern.
Die globale Variable wx ist bereits ordnungsgemäß signiert und mit dem vollständigen jsApiList initialisiert.
Um es richtig zu verwenden, müssen Entwickler:
wp_enqueue_scripts -Aktionshaken mit einer Priorität von 6 oder mehr hinzu.wp-weixin-main-script Sie sicherDarüber hinaus kann eine bereitgestellte Liste von Zuhörern abonniert werden.
JavaScript Listeners Index:
Beispiel für den Abonnieren des wpWeixinShareTimelineSuccessListener -Listeners:
window . wpWeixinShareTimelineSuccessListener ( handleShareTimelineSuccess ) ;
function handleShareTimelineSuccess ( shareInfo ) {
// do something with the data
do_something ( shareInfo ) ;
} window . wpWeixinShareTimelineSuccessListener ( callback ) ; Das Abonnieren dieses Hörers wird die callback ausführen, nachdem der Beitrag über WeChat -Momente geteilt wurde.
Parameter, die an den Rückruf übergeben wurden
ShareInfo
(Objekt) Die an den WeChat JS_SDK gesendeten Informationen. Attribute sind
title,desc,link,imgUrl.
window . wpWeixinShareTimelineFailureListener ( callback ) ; Wenn Sie diesen Hörer abonnieren, wird die callback ausgeführt, nachdem der Beitrag in WeChat -Momenten geteilt wurde.
Parameter, die an den Rückruf übergeben wurden
ShareInfo
(Objekt) Die an den WeChat JS_SDK gesendeten Informationen. Attribute sind
title,desc,link,imgUrl.
window . wpWeixinShareAppMessageSuccessListener ( callback ) ; ` Das Abonnieren dieses Hörers wird die callback ausführen, nachdem Sie den Beitrag mit WeChat "Senden nach Chat" geteilt haben.
Parameter, die an den Rückruf übergeben wurden
ShareInfo
(Objekt) Die an den WeChat JS_SDK gesendeten Informationen. Attribute sind
title,desc,link,imgUrl.
window . wpWeixinShareAppMessageFailureListener ( callback ) ; Das Abonnieren dieses Hörers wird die callback ausführen, nachdem der Beitrag mit WeChat "An Chat senden" geteilt wird.
Parameter, die an den Rückruf übergeben wurden
ShareInfo
(Objekt) Die an den WeChat JS_SDK gesendeten Informationen. Attribute sind
title,desc,link,imgUrl.
