wp weixinダウンロード - wp weixinソースコードのダウンロード

WP Weixin - WordPress WeChat の統合

概要
- コンパニオンプラグイン
- 重要な注意事項
- 公式アカウントのバックエンドにドメインを登録する
- 概要
- オブジェクトキャッシュに関する考慮事項
設定
- 主な設定
- マルチサイト設定
- WeChat レスポンダーの設定
- WeChat の支払い設定
- プロキシ設定
- その他の設定
マルチサイト
WeChat SDK
機能
フック - アクションとフィルター
- アクション
- フィルター
テンプレート
JavaScript

概要

WP Weixin は、WordPress と WeChat 間の統合を提供します。 WeChat ブラウザでユーザーを自動的に登録または認証したり、WeChat を使用してアカウントを作成したり、WeChat で QR コードをスキャンしてコンピュータで認証したり、WeChat モーメントや会話で投稿を共有したり、プラグインを拡張してさらに多くの機能を使用したりできます。

コンパニオンプラグイン

Woo WeChatPay: WooCommerce の支払いゲートウェイ。
WP Weixin Pay: 公式アカウントへの送金を可能にする拡張機能。

開発者は、公開されている機能、アクション、フィルターを活用して、WP Weixin をコアとして WeChat に統合されたプラグインやテーマを構築するか、提供されている SDK を直接利用することが推奨されます。

あなたのプラグインをこのリストに追加したい場合は、作成者に連絡してください。

重要な注意事項

中国本土の WeChat 公式アカウントが必要です (サブスクリプションまたはサービス - 支払いを処理するコンパニオンプラグインと一緒に使用する場合はサービスが必要です)。
WordPress で使用するドメインは公式アカウントのバックエンドに登録する必要があります
プラグイン自体はプログラミングの知識を必要とせず、すぐに使える非常に便利な機能を提供します。しかし、この機能が真価を発揮するのは、開発者がその機能を拡張するために使用する場合です (主に、事前に初期化された JS SDK、WeChat レスポンダー、および提供されているさまざまな機能、アクション、フィルターを通じて)。

公式アカウントのバックエンドにドメインを登録する

ドメインを登録し、そのドメインと WeChat API (フロントエンド JS およびサーバー側) の間の通信を承認するには、まずドメインを ICP ライセンスにリンクする必要があります。次に、https://mp.weixin.qq.com で次のようにします。

公式アカウントのバックエンドに接続する
「インターフェース権限」メニュー項目をクリックします
リストで「Web ページ認証」を検索し、「変更」リンクをクリックします。
「JS インターフェイスセキュリティドメイン名」と「Web ページ認証ドメイン名」の両方のセクションの [セットアップ] リンクをクリックして (プロトコルhttpまたはhttpsを除く) 両方にドメインを追加します。MP_verify_ MP_verify_[some_code].txtファイルを、指示に従って登録されたドメインに対応する Web サイトのルートにコピーし、一般にアクセスできるようにします。

概要

このプラグインは、WordPress に次の主要な機能を追加します。

WP Weixin 設定ページ:英語または中国語で公式アカウント (またはマルチサイトで必要な数) を使用してプラグインを設定し、各オプションの手順をすぐに使用できます。
WeChat 認証: WeChat ブラウザーの WordPress でユーザーを自動的に作成して認証するか、従来のブラウザーを使用しているときにユーザーが WeChat で QR コードをスキャンできるようにします (ソーシャルログイン)。
WeChat アカウントのバインド:ユーザーが既存の WordPress アカウントを WeChat アカウントにバインド/バインド解除できるようにします。 WooCommerce および Ultimate Member アカウントページと統合されており、メンバーシップ/アカウント/プロフィールプラグインと簡単に統合できます。
WeChat 共有:モーメントで投稿やページを共有したり、チャットに送信したりできます。成功時と失敗時に開発者向けに JavaScript イベントをトリガーします。
WeChat モバイルを強制する:ユーザーが WeChat ブラウザー以外で Web サイトを閲覧できないようにします。従来のブラウザでアクセスすると、ページには QR コードが表示されます。
公式アカウントの強制フォロー: WeChat フォロワーを収集し、コンテンツにアクセスする前にユーザーに公式アカウントのフォローを強制します。
WordPress ユーザー画面のオーバーライド:ユーザー画面のデフォルト値の代わりに、WeChat 名と WeChat アバターが存在する場合はそれらを表示します。
WP Weixin QR コードジェネレーター:カスタムコードを作成します。
メニュー統合: WeChat レスポンダーが有効な場合、WordPress で公式アカウントメニューを設定できます。
ウェルカムメッセージ:ユーザーが公式アカウントをフォローすると、WeChat でウェルカムメッセージを送信します。 WeChat レスポンダーが有効になっている場合、WordPress でこれを行うことができます。
開発者 - WeChat レスポンダー:開発者が WeChat の API による呼び出しを受信して応答するため。
開発者 - WeChat JS_SDK: wx JavaScript グローバル変数は、WordPress テーマで WeChat の JavaScript SDK をより簡単に利用できるように、署名付きパッケージで事前構成されています。

WooCommerce、WooCommerce Multilingual、WPML、Ultimate Member、WordPress Multisite、および多くのキャッシュプラグインと互換性があります。

オブジェクトキャッシュに関する考慮事項

このプラグインは WordPress WP_Object_Cache使用してデータベースクエリの数を最適化し、各ページの読み込み時に適切な量のみが実行されるようにします。 WP_Object_Cacheオブジェクトはサードパーティのプラグインの影響を受ける可能性があるため、副作用を避けるためにそのようなプラグインはwp_cache_add_non_persistent_groups関数を実装する必要があります。

WP Weixin と互換性のある一般的なキャッシュプラグインの例を以下に示します。

W3 合計キャッシュ
APC オブジェクトキャッシュ / APCu オブジェクトキャッシュ
Redis オブジェクトキャッシュ

設定

WP Weixin 設定ページでは次の設定が可能です。

主な設定

以下の必須設定は、プラグインが効果を発揮するために必要な最小限の構成です。

名前	必須	タイプ	説明
有効にする	はい	チェックボックス	WP Weixin を有効にする - 有効な構成が必要です。
WeChatアプリID	はい	文章	`https://mp.weixin.qq.com/`のバックエンドの AppId (開発 > 基本構成)。
WeChatアプリの秘密	はい	文章	`https://mp.weixin.qq.com/`のバックエンドの AppSecret ([開発] > [基本構成])。
WeChat OA 名	いいえ	文章	公式アカウントの名前 (実際の名前を入力することをお勧めします)。
WeChat OA ロゴ URL	いいえ	文章	公式アカウントのロゴの URL - (実際のロゴの写真の URL を入力することをお勧めします)。
WeChat認証を有効にする	いいえ	チェックボックス	有効にすると、ユーザーは WeChat ブラウザでサイトにアクセスするときに WordPress の WeChat アカウントで認証されます (有効にしない場合は、キー`'wx_openId-' . apply_filters( 'wp_weixin_ms_auth_blog_id', 1 )`を持つセッション Cookie が設定されます)。
WeChatモバイルを強制する	いいえ	チェックボックス	WeChat ブラウザ経由でのみ Web サイトにアクセスできるようにします。他のブラウザでアクセスするとQRコードが表示されます。
強制フォロー（任意のページ）	いいえ	チェックボックス	WeChat ブラウザでサイトにアクセスする前に、ユーザーに公式アカウントをフォローするよう要求します。

マルチサイト設定

これらの設定はデフォルトでは非表示になっており、次の場合にのみ使用できます。

WordPressマルチサイトがインストールされている
現在のユーザーはmanage_network_options機能を持っています

これらはマルチサイトネットワーク全体に影響します。

名前	タイプ	説明
ブログに認証を強制する	選択する	コールバックが wp_weixin_ms_auth_blog_id にフックされている場合は、情報テキストに置き換えられます。ユーザー認証時にプロキシとして使用するブログ。
ブログにWeChat支払いを強制する	選択する	コールバックが wp_weixin_ms_pay_blog_id にフックされている場合は、情報テキストに置き換えられます。 [販売者プラットフォームを使用する] オプションがチェックされていない場合は非表示のままになります (コンパニオンプラグインに WeChat 支払いが統合されている必要があります)。支払い処理時に代理として使用するブログ。デフォルトの場合、支払いを行うネットワークのすべてのブログに対して JSAPI 支払い承認 URL を入力する必要があり、QR 支払いコールバック URL は WeChat Pay API からのすべての通知を処理できる必要があります。

WeChat レスポンダーの設定

名前	タイプ	説明
WeChat レスポンダーを使用する	チェックボックス	Web サイトが WeChat からメッセージを受信し、それに応答できるようにします。サーバー構成を有効にし、 `https://mp.weixin.qq.com/`の [開発] > [基本構成] で構成する必要があります。メイン設定または WeChat Pay 設定で「強制フォロー」オプションを使用する場合は必須です。
WeChatトークン	文章	`https://mp.weixin.qq.com/`の [開発] > [基本構成] にあるバックエンドのトークン。
メッセージをエンコードする	チェックボックス	Web サイトと WeChat API 間の通信をエンコードします (推奨)。
WeChat AES キー	文章	`https://mp.weixin.qq.com/`にあるバックエンドの EncodingAESKey 「開発」>「基本構成」。
ウェルカムメッセージを送信する	チェックボックス	ユーザーが公式アカウントをフォローするときにウェルカムメッセージを送信します。次のフィルターを使用して、メッセージのデフォルト値を変更できます。 wp_weixin_follower_welcome_title wp_weixin_follower_welcome_description wp_weixin_follower_welcome_url wp_weixin_follower_welcome_pic_url
ウェルカムメッセージ画像のURL	文章	ユーザーが公式アカウント (外部またはメディアライブラリから) をフォローした後に送信されるウェルカムメッセージに使用される画像への URL。デフォルトの画像は`/wp-weixin/images/default-welcome.png`にあります。

WeChat の支払い設定

これらの設定はデフォルトでは非表示になっており、WP Weixin Pay や Woo WeChatPay などの WeChat Pay 統合プラグインがインストールされアクティブ化されている場合にのみ使用できます (この動作は、wp_weixin_show_settings_section フィルターを使用して変更できます)。

名前	タイプ	説明
販売者プラットフォームを使用する	チェックボックス	ユーザーが WeChat を使用してサービスアカウントに送金できるようにします - `https://pay.weixin.qq.com/`のアカウントが必要です。 Woo WeChatPay プラグインが有効化されている場合、この設定は構成できません (強制的にチェックされて非表示になります)。
WeChat マーチャントアプリ ID	文章	`https://pay.weixin.qq.com/`のバックエンドの AppID は、WeChat Pay アカウントが別の AppID にリンクされている可能性があるため、WeChat アプリ ID とは異なる場合があります。 WeChat アプリ ID を使用するには、空のままにしておきます。
WeChat 販売者 ID	文章	バックエンドの販売者 ID ( `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 を実行し、Web ルートの外部にあるユーザーには読み取り権限が必要です。特に WeChat Pay を通じて返金を処理するために必要です。

これらの設定に加えて、プラグインは、販売アカウントの API 設定画面でさまざまな URL にどのような値を入力するかについての画面上のヘルプを提供します。

プロキシ設定

名前	タイプ	説明
プロキシを使用する	チェックボックス	プロキシを有効にします。
プロキシホスト	文章	プロキシホストの IP アドレスまたは URI。
プロキシポート	文章	プロキシホストへの接続に使用するポート。

WordPress がファイアウォールの内側または企業ネットワーク内にある場合、サーバー構成によってはプロキシが必要になる場合があります。

その他の設定

名前	タイプ	説明
ユーザーリストページにWeChatの名前と写真を表示する	チェックボックス	WordPress アカウント名とアバターの表示をオーバーライドします。
WeChat の公開情報を表示する	チェックボックス	ユーザープロフィールページに WeChat 公開情報を表示します。 WooCommece および Ultimate Member と統合されます。
WeChat アカウントのバインドリンクを表示する	チェックボックス	ユーザープロフィールページに、WordPress アカウントを WeChat アカウントにバインドまたはバインド解除するためのリンクを表示します。 WooCommece および Ultimate Member と統合されます。
WeChatアカウント認証リンクを表示	チェックボックス	WordPress ログインフォームに WeChat アカウントを使用して QR コード経由で認証するためのリンクを表示します。
公式アカウントメニューの言語認識	チェックボックス	ユーザーの言語に応じて公式アカウントのメニューをカスタマイズします。デフォルトでは、Web サイトのデフォルト言語に対応するメニューの言語が使用されます。この設定は、WPML がアクティブ化されている場合にのみ使用できます。
access_token にカスタム永続性を使用する	チェックボックス	公式アカウントの access_token とその有効期限タイムスタンプにカスタム永続化メソッドを使用します。警告- 以下の実装が必要です。 wp_weixin_get_access_info wp_weixin_save_access_info パラメータ`$access_info` 、キー`token`と`expiry`を含む配列です。上記のフックを、優先度`5`以下の`plugins_loaded`アクションに追加します。 access_token 情報を複数のプラットフォーム間で共有する必要がある場合に、競合状態を回避するのに役立ちます。チェックを外すと、access_token と有効期限のタイムスタンプがデータベースの WordPress オプションテーブルに保存されます。

マルチサイト

WP Weixin は、ドメイン/サブドメインまたはサブディレクトリのいずれを使用しても、WordPress のマルチサイトインストールをサポートしています。 WP Weixin は同じ設定で構成し、特定の公式アカウントに認証が必要なすべてのブログで有効にする必要があります。

WeChat モバイル認証を有効にすると、いずれかのブログにアクセスしたユーザーは自動的にネットワークに登録され、ブログのデフォルトのユーザーロールで訪問したブログに追加されます。ユーザーは、ネットワークの他のブログにすでに登録されている場合、訪問時に自動的にそのブログに追加されます。この動作は、wp_weixin_ms_auto_add_to_blog フィルターを使用して変更できます。たとえば、一部のブログが事前認証された WeChat ユーザーを受け入れない場合などです。

ブログのドメイン/サブドメインベースのネットワークを使用する場合、メインブログのドメイン/サブドメインがクロスドメイン認証に使用されます。この動作は、プラグインのページの「マルチサイト設定」セクションにある「認証のためにブログを強制する」設定を使用して変更できます。

WeChat Pay 統合プラグインは、WP Weixin が提供する機能、アクション、フィルターを活用することで、WordPress マルチサイトのドメイン/サブドメインベースのネットワークインストールもサポートできます。支払いに使用されるブログは、プラグインのページのマルチサイト設定セクションにある「WeChat 支払い用にブログを強制する」を使用して強制できます。
WP Weixin Pay および Woo WeChatPay は、WeChat Pay と統合されたプラグインの例であり、マルチサイトインストールのタイプ (サブディレクトリまたはドメイン/サブドメイン) に関係なく機能します。

一部のプラグイン (商用、難読化され、セキュリティ標準が疑わしい) とは異なり、WP Weixin は WordPress のルートにダンプされたクロスドメインスクリプトに依存せず、今後も依存しませんが、WordPress のアクションとフィルターを活用することを好みます。

開発者が wp_weixin_ms_auth_blog_id フィルターフックと wp_weixin_ms_pay_blog_id フィルターフックを活用して、さまざまな考えられるシナリオを考慮している限り、同じネットワーク上の複数の公式アカウントでプラグインを使用することができます (ここで簡単なプラグインの例を参照してください)。

WeChat SDK

WP Weixin が提供する最も強力なツールの 1 つは、PHP Wechat ソフトウェア開発キットです。 WeChat SDK のインスタンスを取得するには、開発者は次のスニペットを使用できます。

 $ wechat_sdk = wp_weixin_get_wechat ();

戻り値は、 Wechat_SDKのラッパークラスであるWP_Weixin_Wechatのインスタンスです。これにより、すべての設定とトークンが有効で初期化されていることを確認します。開発者はWechat_SDKクラスを直接使用しないことをお勧めします。

Wechat_SDKのすべてのパブリックメソッドは、 WP_Weixin_Wechatオブジェクトを通じて呼び出すことができ、高度な目的でのみ使用する必要があります。これらは、提供されている関数と比較すると低レベルのメソッドです。後者は可能な限り使用する必要があり、開発者は、意図した結果を達成する関数が存在しない場合にのみ SDK を使用する必要があります。
利用可能なパブリックメソッドについては、 Wechat_SDKのソースコードを直接参照してください。

最適化されていない高度な使用法の簡単な例 - エラー処理を使用して、フォロワーの openID のリストを処理します。

 $ 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
wp_weixin_ajax_safe
wp_weixin_get_user_by_openid
wp_weixin_get_user_by_unionid
wp_weixin_get_wechat
wp_weixin_get_options
wp_weixin_get_option
wp_weixin_wpml_switch_lang
wp_weixin_get_signed_package
wp_weixin_get_user_wechat_info
wp_weixin_get_user_wechat_openid
wp_weixin_get_auth_link
wp_weixin_get_bind_link
wp_weixin_unbind
wp_weixin_bind
wp_weixin_is_フォロワー

wp_weixin_is_wechat

 wp_weixin_is_wechat ();

説明
訪問者が WeChat ブラウザを使用しているかどうか。

戻り値

(bool) 訪問者が WeChat ブラウザを使用しているかどうか。

wp_weixin_ajax_safe

 wp_weixin_ajax_safe ();

説明
WordPress ajax アクションでこの関数を呼び出します。 ajax リクエスト中に WeChat API との対話を許可します。

wp_weixin_get_user_by_openid

 wp_weixin_get_user_by_openid ( string $ openid );

説明
WeChat openID で WordPress ユーザーを取得します。

パラメータ
$openid

(文字列) WeChat のオープン ID。

戻り値

(混合) 対応する WeChat openID にバインドされた WordPress ユーザーが存在する場合はWP_User 、それ以外の場合はfalse 。

wp_weixin_get_user_by_unionid

 wp_weixin_get_user_by_unionid ( string $ unionid , int $ blog_id = false );

説明
WeChat UnionID で WordPress ユーザーを取得するか、複数の一致が存在する場合は WordPress ユーザーのコレクションを取得します (複数の公式アカウントを持つマルチサイトの場合のみ可能)。

パラメータ
$ユニオンID

(文字列) WeChat の UnionID。

戻り値

(混合) 対応する WeChat UnionID を持つ WordPress ユーザーが存在する場合はWP_Userオブジェクト、複数の一致が存在する場合はWP_Userオブジェクトの配列、それ以外の場合はfalse 。

wp_weixin_get_wechat

 wp_weixin_get_wechat ();

説明
WP_Weixin_Wechatのインスタンスを取得します ( Wechat_SDKのラッパーオブジェクト - WeChat SDK を参照)。

戻り値

(WP_Weixin_Wechat) Wechat_SDKのラッパーオブジェクトのインスタンス。

wp_weixin_get_options

 wp_weixin_get_options ();

説明
プラグインの構成に使用されるすべてのオプションを取得します。

戻り値

(配列) プラグインの構成に使用されるすべてのオプションを含む連想配列。

wp_weixin_get_option

 wp_weixin_get_option ( $ key );

説明
プラグインの構成に使用される特定のオプション値を取得します。

パラメータ
$key

(文字列) オプションキー。

戻り値

(混合) オプションに値がある場合は文字列、ブール値、または整数、それ以外の場合はnull 。

wp_weixin_wpml_switch_lang

 wp_weixin_wpml_switch_lang ( $ force = true );

説明
WPML がアクティブで、現在のユーザーの WeChat 言語がわかっている場合は、言語をユーザーの WeChat アカウントによって提供された値に切り替えます。
SitePress::switch_lang( $code = null, $cookie_lang = false )を使用します。WMPL コードベースとドキュメントを理解できるかどうかは開発者の責任です。

パラメータ
$force

(bool) trueに設定すると、常に言語が切り替わります。 falseの場合、言語は WPML で「ブラウザ言語リダイレクト」が有効になっている場合にのみ切り替えられます (デフォルトはtrue 。

戻り値

(bool) SitePress::switch_lang( $code = null, $cookie_lang = false )が呼び出されたかどうか。

wp_weixin_get_signed_package

 wp_weixin_get_signed_package ();

説明
WeChat JSAPI で使用する WeChat 署名済みパッケージを取得します。
注: wp-weixin-main-scriptがすでにキューに入れられている場合、JavaScript グローバル変数wxはすでに適切に署名され、完全なjsApiListで初期化されています。
詳細については、ドキュメントの「JavaScript」セクションを参照してください。

戻り値

(配列) wp_localize_script( $handle, $object_name, $l10n )経由でスクリプトに渡す署名付きパッケージ。

wp_weixin_get_user_wechat_info

 wp_weixin_get_user_wechat_info ( int $ user_id = false , bool $ output = false );

説明
ユーザーの WeChat 情報を取得します。ユーザーIDが省略された場合は、現在のユーザーを取得します。

パラメータ
$user_id

(int) ユーザーの ID - デフォルトはfalse 。

$output

(bool) 情報を出力するかどうか (wp-weixin-public-info テンプレートを使用) - デフォルトはfalse 。

戻り値

(混合) WeChat 情報が存在する場合は配列、存在しない場合はfalse 。

wp_weixin_get_user_wechat_openid

 wp_weixin_get_user_wechat_openid ( int $ user_id = false );

説明
ユーザーの WeChat openID を取得します。ユーザーIDが省略された場合は、現在のユーザーを取得します。

パラメータ
$user_id

(int) ユーザーの ID - デフォルトはfalse 。

戻り値

(混合) 存在する場合は WeChat openID、存在しない場合はfalse 。

wp_weixin_get_auth_link

 wp_weixin_get_auth_link ( bool $ output = false , string $ target = '' , $ class = '' );

説明
WeChat 認証ページへのリンクを取得します。
この機能は WeChat ブラウザでは効果がありません。

パラメータ
$output

(bool) リンクを出力するかどうか。

$target

(文字列) リンクのターゲット。

$target

(文字列) リンクの CSS クラス。

戻り値

(混合) $outputがtrueに設定されている場合、リンクのマークアップは、それ以外の場合はfalse 。

wp_weixin_get_bind_link

 wp_weixin_get_bind_link ( bool $ output = false , string $ target = ' _blank ' );

説明
WeChat アカウントバインディングページへのリンクを取得します。
この機能は WeChat ブラウザでは効果がありません。

パラメータ
$output

(bool) リンクを出力するかどうか。

$target

(文字列) リンクのターゲット。

戻り値

(混合) $outputがtrueに設定されている場合、リンクのマークアップは、それ以外の場合はfalse 。

wp_weixin_unbind

 wp_weixin_unbind ( int $ user_id , string $ open_id = '' );

説明
以前に WeChat にバインドされていた WordPress ユーザーアカウントのバインドを解除し、関連付けられた WeChat アカウントに関連して記録されたすべての情報を効果的に削除します。
注: WeChat 専用 WordPress ユーザーアカウントは、WeChat ブラウザーで Web サイトを開いたときに WP Weixin によって自動的に作成された WordPress アカウントです ( wx-[openid]パターンに従うユーザー名)。
以前にバインドされているかどうかにかかわらず、WeChat 専用 WordPress ユーザーアカウントに対応するuser_id提供される場合 ( wx-[openid]またはwx-bound-[openid]パターンに従うユーザー名)、ユーザー名はwx-unbound-[openid]で更新されます。 wx-unbound-[openid]パターン。

パラメータ
$user_id

(int) ユーザーの ID。

$open_id

(文字列) WeChat アカウントの openID - 空のままにした場合、現在のユーザーの記録値に設定されます。

戻り値

(bool) アカウントがバインドされていなかったかどうか。

wp_weixin_bind

 wp_weixin_bind ( int $ user_id , string $ openid );

説明
WordPress ユーザーアカウントを WeChat にバインドし、関連付けられた WeChat アカウントに関連する記録された情報がすべて事実上上書きされます (存在する場合)。
注: WeChat 専用 WordPress ユーザーアカウントは、WeChat ブラウザーで Web サイトを開いたときに WP Weixin によって自動的に作成された WordPress アカウントです ( wx-[openid]パターンに従うユーザー名)。
指定された$openidが記録された WeChat 専用 WordPress ユーザーアカウントが存在する必要があります。
以前にバインドされていない可能性がある WeChat 専用 WordPress ユーザーアカウントに対応する$user_idの値が指定された場合 ( wx-[openid]またはwx-unbound-[openid]パターンに従うユーザー名)、ユーザー名が更新されますwx-bound-[openid]パターンを使用します。
特定の openID を使用して WeChat を複数の WordPress ユーザーアカウントにバインドすることはできません。

パラメータ
$user_id

(int) ユーザーの ID。

$open_id

(文字列) WeChat 専用の WordPress ユーザーアカウントに対応する openID。

戻り値

(bool) アカウントがバインドされているかどうか。

wp_weixin_is_フォロワー

 wp_weixin_is_follower ( int $ user_id );

説明
ID $user_idのユーザーが WeChat 公式アカウントのフォロワーであるかどうかを確認します。

パラメータ
$user_id

(int) ユーザーの ID。

戻り値

(bool) ユーザーが WeChat 公式アカウントをフォローしているかどうか。

フック - アクションとフィルター

WP Weixin を使用すると、開発者は一連のカスタムアクションとフィルターを使用してその動作をカスタマイズできます。

アクション

アクションのインデックス:

wp_weixin_extensions
wp_weixin_responder
wp_weixin_save_access_info
wp_weixin_before_user_profile_wechat_info
wp_weixin_after_user_profile_wechat_info
wp_weixin_before_bind_account
wp_weixin_after_bind_account
wp_weixin_before_unbind_account
wp_weixin_after_unbind_account
wp_weixin_before_tabs_settings
wp_weixin_before_main_tab_settings
wp_weixin_before_main_settings_inner
wp_weixin_after_main_settings_inner
wp_weixin_after_main_tab_settings
wp_weixin_before_qr_tab_settings
wp_weixin_after_qr_tab_settings
wp_weixin_after_tabs_settings
wp_weixin_before_settings
wp_weixin_before_main_settings
wp_weixin_after_main_settings
wp_weixin_before_qr_settings
wp_weixin_before_qr_settings_inner
wp_weixin_after_qr_settings_inner
wp_weixin_after_qr_settings
wp_weixin_after_settings
wp_weixin_handle_payment_notification
wp_weixin_endpoints
wp_weixin_handle_auto_refund
wp_weixin_pay_refund_failed

wp_weixin_extensions

 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

(混合) WeChat レスポンダーが有効な場合はWP_Weixin_Responderオブジェクト、それ以外の場合はfalse 。

$wp_weixin_menu

(混合) WeChat レスポンダーが有効な場合はWP_Weixin_Menuオブジェクト、それ以外の場合はfalse 。

wp_weixin_responder

 do_action ( ' wp_weixin_responder ' , array $ request_data );

説明
WeChat からリクエストを受信した後に起動されます。

パラメータ
$request_data

(配列) WeChat からのリクエストで送信されたデータ。

wp_weixin_save_access_info

 do_action ( ' wp_weixin_save_access_info ' , array $ access_info );

説明
カスタム永続性が使用されている場合、公式アカウントの access_token を更新した後に発生します。アクセス情報を保存するために使用されます。特に、access_token を複数のプラットフォーム間で共有する必要がある場合に競合状態を回避するのに役立ちます。

パラメータ
$access_info

(配列) 連想配列のアクセス情報。キーはtokenとexpiryです。

wp_weixin_before_user_profile_wechat_info

 do_action ( ' wp_weixin_before_user_profile_wechat_info ' , mixed $ wechat_info , mixed $ user );

説明
ユーザープロフィールに WeChat 公開情報を表示する前に発生します。

パラメータ
$wechat_info

(混合) ユーザープロフィールに表示する WeChat 公開情報の配列 (存在する場合)、存在しない場合はfalse 。

$user

(混合) ユーザーが存在する場合はWP_Userオブジェクト、存在しない場合はfalse 。

wp_weixin_after_user_profile_wechat_info

 do_action ( ' wp_weixin_after_user_profile_wechat_info ' , mixed $ wechat_info , mixed $ user );

説明
ユーザープロフィールに WeChat 公開情報を表示した後に発生します。

パラメータ
$wechat_info

(混合) ユーザープロファイルに表示される WeChat 公開情報の配列。それ以外の場合はfalse 。

$user

(混合) ユーザーが存在する場合はWP_Userオブジェクト、存在しない場合はfalse 。

wp_weixin_before_bind_account

 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

(int) ユーザー ID。

$wechat_user_id

(int) WeChat 専用 WordPress ユーザーアカウントの ID ( wx-[openid]パターンに従ったユーザー名)。

$wechat_user_blog_ids

(配列) WeChat 専用 WordPress ユーザーアカウントが属するブログ ID のリスト。

$current_blog_id

(int) 現在のブログのブログ ID。

wp_weixin_after_bind_account

 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

(int) ユーザー ID。

$wechat_user_id

(int) WeChat 専用 WordPress ユーザーアカウントの ID ( wx-[openid]パターンに従ったユーザー名)。

$wechat_user_blog_ids

(配列) WeChat 専用 WordPress ユーザーアカウントが属するブログ ID のリスト。

$current_blog_id

(int) 現在のブログのブログ ID。

wp_weixin_before_unbind_account

 do_action ( ' wp_weixin_before_unbind_account ' , int $ user_id , string $ openid );

説明
WeChat から WordPress ユーザーアカウントのバインドを解除する前に起動します。

パラメータ
$user_id

(int) ユーザー ID。

$openid

(文字列) WeChat の openID。

wp_weixin_after_unbind_account

 do_action ( ' wp_weixin_after_unbind_account ' , bool $ unbound , int $ user_id , string $ openid );

説明
WeChat から WordPress ユーザーアカウントのバインドを解除した後に発生します。

パラメータ
$unbound

(bool) WordPress ユーザーアカウントが WeChat から正常にバインド解除されたかどうか。

$user_id

(int) ユーザー ID。

$openid

(文字列) WeChat の openID。

wp_weixin_before_tabs_settings

 do_action ( ' wp_weixin_before_tabs_settings ' );

説明WP Weixin ページのタブを出力する前に発生します。

wp_weixin_before_main_tab_settings

 do_action ( ' wp_weixin_before_main_tab_settings ' );

説明WP Weixin ページのメイン設定タブを出力する前に発生します。

wp_weixin_before_main_settings_inner

 do_action ( ' wp_weixin_before_main_settings_inner ' );

説明WP Weixin ページの主な設定内容を出力する前に発生します。

wp_weixin_after_main_settings_inner

 do_action ( ' wp_weixin_after_main_settings_inner ' );

説明WP Weixin ページの主な設定内容を出力した後に発生します。

wp_weixin_after_main_tab_settings

 do_action ( ' wp_weixin_after_main_tab_settings ' );

説明WP Weixin ページのメイン設定タブを出力した後に発生します。

wp_weixin_before_qr_tab_settings

 do_action ( ' wp_weixin_before_qr_tab_settings ' );

説明WP Weixin ページの QR コード生成タブを出力する前に発生します。

wp_weixin_after_qr_tab_settings

 do_action ( ' wp_weixin_after_qr_tab_settings ' );

説明WP Weixin ページの QR コード生成タブを出力した後に発生します。

wp_weixin_after_tabs_settings

 do_action ( ' wp_weixin_after_tabs_settings ' );

説明WP Weixin ページのタブを出力した後に発生します。

wp_weixin_before_settings

 do_action ( ' wp_weixin_before_settings ' );

説明WP Weixin ページの設定を出力する前に発生します。

wp_weixin_before_main_settings

 do_action ( ' wp_weixin_before_main_settings ' );

説明WP Weixin ページのメイン設定ボックスを出力する前に発生します。

wp_weixin_after_main_settings

 do_action ( ' wp_weixin_after_main_settings ' );

説明WP Weixin ページのメイン設定ボックスを出力した後に発生します。

wp_weixin_before_qr_settings

 do_action ( ' wp_weixin_before_qr_settings ' );

説明WP Weixin ページで QR コードジェネレーターを出力する前に発生します。

wp_weixin_before_qr_settings_inner

 do_action ( ' wp_weixin_before_qr_settings_inner ' );

説明WP Weixin ページの QR コード生成ボックスを出力する前に発生します。

wp_weixin_after_qr_settings_inner

 do_action ( ' wp_weixin_after_qr_settings_inner ' );

説明WP Weixin ページで QR コード生成ボックスを出力した後に発生します。

wp_weixin_after_qr_settings

 do_action ( ' wp_weixin_after_qr_settings ' );

説明WP Weixin ページで QR コードジェネレーターを出力した後に発生します。

wp_weixin_after_settings

 do_action ( ' wp_weixin_after_settings ' );

説明WP Weixin ページの設定を出力した後に発生します。

wp_weixin_endpoints

 do_action ( ' wp_weixin_endpoints ' );

説明
WP Weixin 書き換えルールを追加するときに発生します。コンパニオンプラグインが独自のプラグインを追加し、それらが適切に登録されていることを確認するのに役立ちます (ルールは WP Weixin 設定が保存されるときにフラッシュされます)。

wp_weixin_handle_payment_notification

 do_action ( ' wp_weixin_handle_payment_notification ' );

説明
WeChat Pay トランザクション通知を処理するときに発生します。

WP Weixin ( PHP_INT_MIN ) によって最後に起動されました。 WeChat Pay と統合するコンパニオンプラグインによって、より早く起動される必要があります。
WeChat Pay 通知の処理方法については、WeChat Pay 統合プラグインのスケルトンを参照してください。

wp_weixin_handle_auto_refund

 do_action ( ' wp_weixin_handle_auto_refund ' , mixed $ refund_result , array $ payment_result );

説明
失敗したトランザクションの自動返金が試行された後に発生します。

WP Weixin の自動返金結果の処理方法については、WeChat Pay 統合プラグインのスケルトンを参照してください。

パラメータ
$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 */
);

フィルター

フィルターインデックス:

wp_weixin_browser_page_qr_src
wp_weixin_subscribe_src
wp_weixin_follower_notice_title
wp_weixin_follower_notice
wp_weixin_auth_needed
wp_weixin_debug
wp_weixin_follower_welcome_title
wp_weixin_follower_welcome_description
wp_weixin_follower_welcome_url
wp_weixin_follower_welcome_pic_url
wp_weixin_get_access_info
wp_weixin_jsapi_urls
wp_weixin_pay_callback_url
wp_weixin_settings
wp_weixin_show_settings_section
wp_weixin_show_setting
wp_weixin_settings_fields
wp_weixin_auth_redirect
wp_weixin_scan_heartbeat_frequency
wp_weixin_qr_cleanup_frequency
wp_weixin_qr_lifetime
wp_weixin_user_wechat_info
wp_weixin_ms_auto_add_to_blog
wp_weixin_ms_auth_blog_id
wp_weixin_ms_pay_blog_id
wp_weixin_locate_template_paths
wp_weixin_get_user_by_openid
wp_weixin_pay_notify_results
wp_weixin_ecommerce_description
wp_weixin_subscribe_qr_url

wp_weixin_browser_page_qr_src

 apply_filters ( ' wp_weixin_browser_page_qr_src ' , string $ src );

説明
QR コードのソースをフィルタリングして、WeChat ブラウザからのみアクセスできるページをクラシックブラウザで表示します。

パラメータ
$src

(文字列) 従来のブラウザで表示する QR コードのソース。

wp_weixin_subscribe_src

 apply_filters ( ' wp_weixin_subscribe_src ' , string $ src );

説明
公式アカウントのフォローに使用するQRコードのソースをフィルタリングします。

パラメータ
$src

(文字列) QR コードのソース。

wp_weixin_follower_notice_title

 apply_filters ( ' wp_weixin_follower_notice_title ' , string $ title );

説明
公式アカウントをフォローするには、QRコードが表示されているページのタイトルをフィルタリングします。

パラメータ
$title

(文字列) ページのタイトル - デフォルトは「Follow Us!」です。

wp_weixin_follower_notice

 apply_filters ( ' wp_weixin_follower_notice ' , string $ notice );

説明
QRコードを表示したページに表示されるメッセージをフィルタリングして、公式アカウントをフォローしてください。

パラメータ
$notice

(文字列) 表示されるメッセージ - デフォルトは「このコンテンツにアクセスする前に、この QR コードをスキャンしてフォローしてください。」。

wp_weixin_auth_needed

 apply_filters ( ' wp_weixin_auth_needed ' , bool $ needs_auth );

説明
URL が WeChat を使用してユーザーを認証する必要があるかどうか。設定で「WeChat 認証を有効にする」がチェックされている場合、WordPress のinitアクションフックをトリガーする URL は、このフィルターを使用してホワイトリストに登録されていない限り、デフォルトで認証が必要になります。デフォルトでは、すべての管理ページ、WP Weixin クラシックブラウザー認証ページ、WordPress ajax エンドポイント、WeChat レスポンダーエンドポイント、および WooCommerce API エンドポイントはホワイトリストに登録されており、WeChat の外部からアクセスできます。

パラメータ
$needs_auth

(bool) URL にアクセスするために認証が必要かどうか。

wp_weixin_debug

 apply_filters ( ' wp_weixin_debug ' , bool $ debug );

説明
デバッグモード (PHP エラーログ、JavaScript コンソールメッセージ、JavaScript アラート) をアクティブにするかどうかをフィルターします。

パラメータ
$デバッグ

(bool) デバッグモードがアクティブ化されているかどうか - デフォルトのWP_DEBUG定数値。

wp_weixin_follower_welcome_title

 apply_filters ( ' wp_weixin_follower_welcome_title ' , string $ title , mixed $ before_subscription );

説明
公式アカウントをフォローしたときにユーザーが受け取るメッセージのタイトルをフィルターします。

パラメータ
$title

(文字列) タイトル - デフォルトは「'Welcome user_name !'」。 user_nameはユーザーの WeChat 名です。

$before_subscription

(混合) 数値の場合は、ユーザーが最後にアクセスしていたページのWP_Post ID。文字列の場合、ユーザーが最後にアクセスしていたページの URL - デフォルトのhome_url() 。

wp_weixin_follower_welcome_description

 apply_filters ( ' wp_weixin_follower_welcome_description ' , string $ description , mixed $ before_subscription );

説明
公式アカウントをフォローするときにユーザーが受け取るメッセージの説明をフィルターします。

パラメータ
$説明

(文字列) 説明 - デフォルトは「公式アカウントをご購読いただきありがとうございます!」。

$before_subscription

(混合) 数値の場合は、ユーザーが最後にアクセスしていたページのWP_Post ID。文字列の場合、ユーザーが最後にアクセスしていたページの URL - デフォルトのhome_url() 。

wp_weixin_follower_welcome_url

 apply_filters ( ' wp_weixin_follower_welcome_url ' , string $ url , mixed $ before_subscription );

説明
公式アカウントをフォローするときに受信したメッセージを操作するときにユーザーがリダイレクトされる URL をフィルターします。

パラメータ
$url

(文字列) ユーザーがリダイレクトされる URL - テンプレート化されたメッセージを送信する前に URL が記録されていない場合は、デフォルトのhome_url() 。

$before_subscription

(混合) 数値の場合は、ユーザーが最後にアクセスしていたページのWP_Post ID。文字列の場合、ユーザーが最後にアクセスしていたページの URL - デフォルトのhome_url() 。

wp_weixin_follower_welcome_pic_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' 。

$before_subscription

（混合）数値の場合、ユーザーがアクセスしていた最後のページのWP_Post ID。文字列の場合、ユーザーがアクセスしていた最後のページのURL -default home_url() 。

wp_weixin_get_access_info

 apply_filters ( ' wp_weixin_get_access_info ' , array $ access_info );

説明
WP_Weixin_WeChatオブジェクト（ Wechat_SDKオブジェクトのラッパー）を要求するときにアクセストークンとトークンの有効期限をフィルタリングします。カスタム永続性が使用されている場合 - アクセストークンを複数のプラットフォーム間で共有する必要がある場合は、レース状態を回避するのに特に役立ちます。

パラメータ
$ access_info

（配列）連想配列内のアクセス情報。値の種類とキー：（文字列） token 、（int） expiry 。

wp_weixin_jsapi_urls

 apply_filters ( ' wp_weixin_jsapi_urls ' , array $ jsapi_urls );

説明
WeChat MerchantアカウントのAPI構成画面に登録するために必要なURLをフィルタリングします - 別のプラグインがWeChat Pay Integrationを実装したときに使用します。

パラメータ
$ jsapi_urls

（配列）WeChat MerchantアカウントのAPI構成画面に登録するURL。

wp_weixin_pay_callback_endpoint

 apply_filters ( ' wp_weixin_pay_callback_endpoint ' , string $ endpoint );

説明
WeChat MerchantアカウントのAPI構成画面に登録するために必要なQR支払いURLのエンドポイントをフィルタリングします - WeChat Pay Integrationを実装するときに使用します。

パラメータ
$ callback_url

（文字列）WeChat MerchantアカウントのAPI構成画面に登録するQR支払いURLのエンドポイント（例： /my_plugin/notify ）。

wp_weixin_settings

 apply_filter ( ' wp_weixin_settings ' , $ settings );

説明
プラグインの構成に使用される設定をフィルタリングします。フック機能またはメソッドは、 5以下の優先度のplugins_loadedアクションフックにこのフィルターに追加する必要があります。

パラメータ
$設定

（配列）プラグインの構成に使用される設定。

wp_weixin_show_settings_section

 apply_filters ( ' wp_weixin_show_settings_section ' , bool $ show_section , string $ section_name , array $ section );

説明
WP Weixin Settingsページに設定セクションを表示するには、フィルターを使用してください。

パラメータ
$ show_section

（bool）WP Weixin Settingsページに設定セクションを表示します。

$ section_name

（文字列）設定セクションの名前。

$セクション

（配列）セクションの設定。

wp_weixin_show_setting

 apply_filters ( ' wp_weixin_show_setting ' , bool $ show_setting , string $ section_name , int $ index , array $ value );

説明
WP Weixin Settingsページに設定を表示するには、フィルターを絞ります。

パラメータ
$ show_setting

（bool）WP Weixin Settingsページに設定を表示します。

$ section_name

（文字列）設定が属するセクションの名前。

$インデックス

（int）セクションの設定のインデックス。

$値

（配列）設定。

wp_weixin_settings_fields

 apply_filters ( ' wp_weixin_settings_fields ' , array $ settings_fields );

説明
WP Weixin設定ページに表示されている設定フィールドをフィルタリングします。

パラメータ
$ include_section

（配列）WP Weixin Settingsページに表示される設定フィールド。

wp_weixin_auth_redirect

 apply_filters ( ' wp_weixin_auth_redirect ' , mixed $ redirect , bool $ auth , bool $ has_error );

説明
URLをフィルタリングして、クラシックブラウザーのQRコード認証が実行されるときにリダイレクトします。

パラメータ
$ redirect

（混合）認証が実行されたときにリダイレクトするURL、またはリダイレクトがない場合はfalse 。デフォルトは、認証が成功した場合のhome_url()です。

$ auth

（bool）認証が実行された場合 - エラーが発生した場合は、成功した場合はtrue false 。

$ has_error

（ブール）エラーが発生しました。

wp_weixin_scan_heartbeat_frequency

 apply_filters ( ' wp_weixin_scan_heartbeat_frequency ' , int $ frequency );

説明
QRコードスキャン確認をクラシックブラウザーで待っているときに、チェックの頻度をフィルタリングします。

パラメータ
$頻度

（int）ミリ秒単位の頻度。デフォルト1000 。

wp_weixin_qr_cleanup_frequency

 apply_filters ( ' wp_weixin_qr_cleanup_frequency ' , string $ frequency );

説明
周波数をフィルタリングして、期限切れのQRコードデータをクリーンアップします。

パラメータ
$頻度

（文字列）周波数。デフォルト'hourly' 。

wp_weixin_qr_lifetime

 apply_filters ( ' wp_weixin_qr_lifetime ' , int $ lifetime );

説明
WeChat認証やWeChatアカウントバインディングなど、潜在的に敏感なQRコードの寿命をフィルタリングします。

パラメータ
$ lifetime

（int）数秒での寿命。デフォルト600 。

wp_weixin_user_wechat_info

 apply_filters ( ' wp_weixin_user_wechat_info ' , mixed $ wechat_info , int $ user_id );

説明
ユーザーWeChat情報をフィルタリングします。

パラメータ
$ wechat_info

（混合）存在する場合はweChat情報の配列、別の場合はfalse 。

$ lifetime

（int）ユーザーID-デフォルト0 。

wp_weixin_ms_auto_add_to_blog

 apply_filters ( ' wp_weixin_ms_auto_add_to_blog ' , bool $ auto_add_to_blog , int $ blog_id , int $ user_id );

説明
WeChatで認証されたときに、ユーザーをネットワーク上の訪問したブログに自動的に追加するためにフィルターをかけます。

パラメータ
$ auto_add_to_blog

（bool）WeChatで認証された場合、ユーザーをネットワーク上の訪問したブログに自動的に追加します - デフォルトtrue 。

$ blog_id

（int）訪問したブログのID。

$ user_id

（int）ブログにアクセスしているユーザーのID。

wp_weixin_ms_auth_blog_id

 apply_filters ( ' wp_weixin_ms_auth_blog_id ' , int $ auth_blog_id );

説明
認証に使用されるブログIDをフィルタリング - デフォルトでは、デフォルトのブログのドメイン名がWeChat BackEndに登録されていると想定されています。

警告： WP Weixinが複数の公式アカウントをサポートすることを確認するために、バインドされたアカウントのOpenIDは、そのメタキー（ 'wx_openid-' . $auth_blog_id ）に$auth_blog_idの値を含むユーザーメタレコードを使用して保存されます。
WeChatにバインドされたWordPressユーザーが既に存在する場合（WeChatブラウザーを使用してサイトにアクセスするときに手動でバインドまたは自動的に作成された場合）、このフィルターを適用し、 $auth_blog_idの変更された値を返します。
データベースを直接更新するか、以下のように1回限りの使用コードスニペットを実行するのは開発者次第です。

WordPressユーザーが既にWeChatにバインドされている場合、認証に使用されるブログIDを変更した後に実行するコードスニペットの例：

 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認証を行うときに使用するブログのID。デフォルト1 。

wp_weixin_ms_pay_blog_id

 apply_filters ( ' wp_weixin_ms_pay_blog_id ' , int $ pay_blog_id );

説明
WeChat Pay APIからの支払い通知を呼び出して受信できるURLを構築するために使用されるブログIDをフィルタリングします。デフォルトでは、現在のブログのIDに対応するドメイン（またはサブドメイン）がWeChatバックエンドに登録されていると想定されています。 WooCommerceのいくつかのインスタンスが同じネットワークで実行されている場合、または複数の公式アカウントに接続されたネットワークの場合に役立ちます。

パラメータ
$ pay_blog_id

（int）QR支払いコールバックURLの構築に使用されるブログのID。デフォルトget_current_blog_id() 。

wp_weixin_locate_template_paths

 apply_filters ( ' wp_weixin_locate_template_paths ' , array $ paths , string $ plugin_name );

説明
WP Weixinおよびコンパニオンプラグインに含まれるテンプレートの可能なパスをフィルタリングします。

パラメータ
$パス

（配列）可能なパス。デフォルト（ $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

（文字列）テンプレートが属するプラグインの名前。

wp_weixin_get_user_by_openid

 apply_filters ( ' wp_weixin_get_user_by_openid ' , $ user , $ openid );

説明
記録されたWeChat OpenIDに関連付けられたWordPressユーザーを取得するクエリの結果をフィルタリングします。

パラメータ
$ユーザー

（混合） WP_Userオブジェクトユーザーが見つかった場合、それ以外の場合はfalse 。

$ openid

（文字列）ユーザーの検索に使用されるOpenID

wp_weixin_pay_notify_results

 apply_filters ( ' wp_weixin_pay_notify_results ' , ( array ) $ results );

説明
支払い通知の処理結果をフィルタリングします。

実際にはWP Weixin自体では適用されませんが、コンパニオンプラグインがWP_Weixin_Handle_Payment_Notificationを起動した後にのみです。
支払い通知の結果を追加する方法については、WeChat Pay Integration Plugin Skeletonを参照してください。

パラメータ
$結果

（配列）一連の支払い通知結果。結果の構造：

 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 */
);

wp_weixin_ecommerce_description

 apply_filters ( ' wp_weixin_ecommerce_description ' , $ ecommerce_description );

説明
WeChat Pay設定の説明をフィルタリングします。

パラメータ
$ ecommerce_description

（文字列）WeChat Pay Settings（HTML）の説明。

wp_weixin_subscribe_qr_url

 apply_filters ( ' wp_weixin_subscribe_qr_url ' , $ wp_weixin_subscribe_qr_url );

説明
WECHAT公式アカウントサブスクリプションQRコードのURLをフィルタリングします。

パラメータ
$ wp_weixin_subscribe_qr_url

（文字列）WECHAT公式アカウントサブスクリプションQRコードのURL。

テンプレート

次のテンプレートファイルは、 locate_template()使用して選択され、wordpressが提供するload_template()関数に含まれています。これは、アクティブなWordPressテーマで過負荷にすることができることを意味します。開発者は、テーマのフォルダーの下に次のディレクトリにカスタムテンプレートファイルを配置できます（選択の優先順位の順に）：

plugins/wp-weixin/
wp-weixin/
plugins/
テーマのフォルダーのルート

テンプレートの使用可能なパスは、wp_weixin_locate_template_pathsフィルターでカスタマイズできます。以下のすべてのテンプレートに適用されるスタイルは'wp-weixin-main-style'としています。

テンプレートインデックス：

wp-weixin-subscribe
wp-weixin-browser-qr
wp-weixin-auth-form-link
wp-weixin-auth-page
wp-weixin-mobile-auth-check
wp-weixin-bind-form-link
wp-weixin-bind-page
wp-weixin-mobile-bind-check
wp-weixin-public-info
wp-weixin-account-form-password-notice

wp-weixin-subscribe

 wp-weixin-subscribe.php

説明
QRコードを表示するページのテンプレートは、公式アカウントに従うようにします。設定で「強制フォロー」が有効になったときに使用されます。

$title

（文字列）ユーザーに提示された画面のタイトル。

$メッセージ

（文字列）ユーザーがこの画面を表示する理由を説明するメッセージ。

$ QR_SRC

（文字列）QRコード画像のソース。

wp-weixin-browser-qr

 wp-weixin-browser-qr.php

説明
WebサイトにWeChatブラウザーからのみアクセスできるときにQRコードを表示するページのテンプレート。

変数
$ page_qr_src

（文字列）QRコード画像のソース。

wp-weixin-auth-form-link

 wp-weixin-auth-form-link.php

説明
WeChat認証リンクのテンプレート。

変数
$クラス

（文字列）リンクのクラス属性。

$ターゲット

（文字列）リンクのターゲット属性。

wp-weixin-auth-page

 wp-weixin-auth-page.php

説明
クラシックブラウザーのQRコード認証用に表示されるWeChat画面のテンプレート。

wp-weixin-mobile-auth-check

 wp-weixin-mobile-auth-check.php

説明
クラシックブラウザーのQRコード認証を介して認証するときに表示されるWeChatモバイルブラウザー画面のテンプレート。

変数
$ auth_qr_data

（配列）認証に関連するデータ。値の種類とキー：（bool） auth 、（int） user_id 、（array） error 、（bool | string） redirect 。 redirect値は、実際にはモバイルでデフォルトでリダイレクトに使用されません（デスクトップで認証後に使用）。

wp-weixin-bind-form-link

 wp-weixin-bind-form-link.php

説明
WeChatアカウントバインディングリンクのテンプレート。

変数
$ link_text

（文字列）リンクのテキスト。

$ wechat_info

（混合）存在する場合はweChat情報の配列、別の場合はfalse 。

$クラス

（文字列）リンクのクラス属性。

$ターゲット

（文字列）リンクのターゲット属性。

wp-weixin-bind-page

 wp-weixin-bind-page.php

説明
WeChatアカウントのために表示されるWeChat画面のテンプレートは、クラシックブラウザーでBindindにbindindに表示されます。

変数
$ user_id

（int）WeChatアカウントにバインドするユーザーのID。

$ wechat_info

（混合）存在する場合はweChat情報の配列、別の場合はfalse 。

wp-weixin-mobile-bind-check

 wp-weixin-mobile-bind-check.php

説明
Classic BrowserのQRコードを介してWeChatアカウントを試すときに表示されるWeChatモバイルブラウザ画面のテンプレート。

変数
$ bind_qr_data

（配列）アカウントバインディングに関連するデータ。値の種類とキー：（bool） bind 、（int） user_id 、（array） error 、（bool | string） redirect 。 redirect値は常にモバイルでfalseです（デスクトップのアカウントバインディング後に使用され、使用されます）。

wp-weixin-public-info

 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

 wp-weixin-account-form-password-notice.php

説明
フォームの下に表示する通知のテンプレートは、ユーザーアカウントのパスワードを変更します。

JavaScript

グローバル変数wx 、すでに完全に署名され、完全なjsApiListで初期化されています。
適切に使用するには、開発者が必要です。

wp_enqueue_scriptsアクションフックに6以上の優先順位を持つアクションフックを含むスクリプトを含めます。
依存関係としてwp-weixin-main-scriptを必ず設定してください
「有効」がWP Weixinメイン設定でチェックされていることを確認してください

さらに、提供されたリスナーのリストはサブスクライブする場合があります。

JavaScriptリスナーインデックス：

wpweixinsharetimelinesuccesslistener
wpweixinsharetimelinefailurelistener
wpweixinshareapmessagesuccesslistener
wpweixinshareapmessagefailurelistener

wpWeixinShareTimelineSuccessListenerリスナーを購読する方法の例：

 window . wpWeixinShareTimelineSuccessListener ( handleShareTimelineSuccess ) ;

function handleShareTimelineSuccess ( shareInfo ) {
	// do something with the data
	do_something ( shareInfo ) ;
}

wpweixinsharetimelinesuccesslistener

 window . wpWeixinShareTimelineSuccessListener ( callback ) ;

このリスナーを購読すると、WeChat Momentsが成功した投稿を共有した後、 callback関数が実行されます。

パラメーターはコールバックに渡されました
shareinfo

（オブジェクト）WeChat JS_SDKに送信された共有情報。属性は、 title 、 desc 、 link 、 imgUrlです。

wpweixinsharetimelinefailurelistener

 window . wpWeixinShareTimelineFailureListener ( callback ) ;

このリスナーを購読すると、WeChatの瞬間が失敗した場合に投稿を共有した後、 callback関数が実行されます。

パラメーターはコールバックに渡されました
shareinfo

（オブジェクト）WeChat JS_SDKに送信された共有情報。属性は、 title 、 desc 、 link 、 imgUrlです。

wpweixinshareapmessagesuccesslistener

 window . wpWeixinShareAppMessageSuccessListener ( callback ) ; `

このリスナーを購読すると、WeChatの「送信チャット」と共有した後、 callback関数が実行されます。

パラメーターはコールバックに渡されました
shareinfo

（オブジェクト）WeChat JS_SDKに送信された共有情報。属性は、 title 、 desc 、 link 、 imgUrlです。

wpweixinshareapmessagefailurelistener

 window . wpWeixinShareAppMessageFailureListener ( callback ) ;

このリスナーを購読すると、WeChatの「送信チャット」と投稿を共有した後、 callback関数が実行されます。失敗しました。

パラメーターはコールバックに渡されました
shareinfo

（オブジェクト）WeChat JS_SDKに送信された共有情報。属性は、 title 、 desc 、 link 、 imgUrlです。

拡大する

wp weixin

WP Weixin - WordPress WeChat の統合

概要

コンパニオンプラグイン

重要な注意事項

公式アカウントのバックエンドにドメインを登録する

概要

オブジェクトキャッシュに関する考慮事項

設定

主な設定

マルチサイト設定

WeChat レスポンダーの設定

WeChat の支払い設定

プロキシ設定

その他の設定

マルチサイト

WeChat SDK

機能

wp_weixin_is_wechat

wp_weixin_ajax_safe

wp_weixin_get_user_by_openid

wp_weixin_get_user_by_unionid

wp_weixin_get_wechat

wp_weixin_get_options

wp_weixin_get_option

wp_weixin_wpml_switch_lang

wp_weixin_get_signed_pa​​ckage

wp_weixin_get_user_wechat_info

wp_weixin_get_user_wechat_openid

wp_weixin_get_auth_link

wp_weixin_get_bind_link

wp_weixin_unbind

wp_weixin_bind

wp_weixin_is_フォロワー

フック - アクションとフィルター

アクション

wp_weixin_extensions

wp_weixin_responder

wp_weixin_save_access_info

wp_weixin_before_user_profile_wechat_info

wp_weixin_after_user_profile_wechat_info

wp_weixin_before_bind_account

wp_weixin_after_bind_account

wp_weixin_before_unbind_account

wp_weixin_after_unbind_account

wp_weixin_before_tabs_settings

wp_weixin_before_main_tab_settings

wp_weixin_before_main_settings_inner

wp_weixin_after_main_settings_inner

wp_weixin_after_main_tab_settings

wp_weixin_before_qr_tab_settings

wp_weixin_after_qr_tab_settings

wp_weixin_after_tabs_settings

wp_weixin_before_settings

wp_weixin_before_main_settings

wp_weixin_after_main_settings

wp_weixin_before_qr_settings

wp_weixin_before_qr_settings_inner

wp_weixin_after_qr_settings_inner

wp_weixin_after_qr_settings

wp_weixin_after_settings

wp_weixin_endpoints

wp_weixin_handle_payment_notification

wp_weixin_handle_auto_refund

フィルター

wp_weixin_browser_page_qr_src

wp_weixin_subscribe_src

wp_weixin_follower_notice_title

wp_weixin_follower_notice

wp_weixin_auth_needed

wp_weixin_debug

wp_weixin_follower_welcome_title

wp_weixin_follower_welcome_description

wp_weixin_follower_welcome_url

wp_weixin_follower_welcome_pic_url

wp_weixin_get_access_info

wp_weixin_jsapi_urls

wp_weixin_pay_callback_endpoint

wp_weixin_settings

wp_weixin_show_settings_section

wp_weixin_get_signed_package