홈페이지>프로그래밍 관련>AI 소스 코드
다운로드

WP Weixin - WordPress WeChat 통합

  • 일반 설명
    • 동반 플러그인
    • 중요 사항
    • 공식 계정 백엔드에 도메인 등록
    • 개요
    • 개체 캐시 고려 사항
  • 설정
    • 주요 설정
    • 다중 사이트 설정
    • WeChat 응답자 설정
    • 위챗페이 설정
    • 프록시 설정
    • 기타 설정
  • 멀티사이트
  • 위챗 SDK
  • 기능
  • 후크 - 작업 및 필터
    • 행위
    • 필터
  • 템플릿
  • 자바스크립트

일반 설명

WP Weixin은 WordPress와 WeChat 간의 통합을 제공합니다. WeChat 브라우저에서 자동으로 사용자를 등록 또는 인증하고, WeChat을 사용하여 QR 코드를 스캔하여 컴퓨터에서 계정을 생성하거나 인증하고, WeChat Moments 및 대화에서 게시물을 공유하거나, 더 많은 기능을 위해 플러그인을 확장하세요!

동반 플러그인

  • Woo WeChatPay: WooCommerce용 결제 게이트웨이입니다.
  • WP Weixin Pay: 공식 계좌로 자금을 이체할 수 있는 확장 프로그램입니다.

개발자는 공개적으로 사용 가능한 기능, 작업 및 필터를 활용하여 WP Weixin을 핵심으로 WeChat과 통합된 플러그인 및 테마를 구축하거나 제공된 SDK를 직접 활용하는 것이 좋습니다.

이 목록에 귀하의 플러그인을 추가하려면 작성자에게 문의하세요.

중요 사항

  • 중국 본토 WeChat 공식 계정이 필요합니다(구독 또는 서비스 - 결제를 처리하는 컴패니언 플러그인과 함께 사용하는 경우 서비스가 필요합니다).
  • WordPress에서 사용하는 도메인은 공식 계정의 백엔드에 등록되어 있어야 합니다 .
  • 플러그인 자체에는 프로그래밍 지식이 필요하지 않으며 기본적으로 매우 유용한 기능을 제공합니다. 하지만 실제로 빛나는 부분은 개발자가 기능을 확장하기 위해 사용할 때입니다(주로 사전 초기화된 JS SDK, WeChat 응답자 및 제공되는 다양한 기능, 작업 및 필터를 통해).

공식 계정 백엔드에 도메인 등록

도메인을 등록하고 해당 도메인과 WeChat API(프런트엔드 JS 및 서버측) 간의 통신을 승인하려면 먼저 도메인을 ICP 라이선스와 연결 해야 합니다 . 그런 다음 https://mp.weixin.qq.com에서 다음을 수행하세요.

  • 공식 계정의 백엔드에 연결
  • "인터페이스 권한" 메뉴 항목을 클릭합니다.
  • 목록에서 "웹 페이지 인증"을 검색하고 "수정" 링크를 클릭하세요.
  • 두 섹션 모두에 대해 "설정" 링크를 클릭하여 "JS 인터페이스 보안 도메인 이름"과 "웹 페이지 인증 도메인 이름"에 도메인을 추가합니다(프로토콜 http 또는 https 제외). MP_verify_[some_code].txt 파일을 지침에 따라 등록된 도메인에 해당하는 웹사이트의 루트에 복사하고 공개적으로 액세스할 수 있습니다.

개요

이 플러그인은 WordPress에 다음과 같은 주요 기능을 추가합니다.

  • WP Weixin 설정 페이지: 각 옵션에 대한 지침과 함께 기본적으로 영어 또는 중국어로 공식 계정(또는 다중 사이트에서 원하는 만큼)으로 플러그인을 구성합니다.
  • WeChat 인증: WeChat 브라우저의 WordPress에서 사용자를 자동으로 생성 및 인증하거나, 클래식 브라우저(소셜 로그인)를 사용할 때 사용자가 WeChat으로 QR 코드를 스캔할 수 있도록 허용합니다.
  • WeChat 계정 바인딩: 사용자가 기존 WordPress 계정을 WeChat 계정과 바인딩/바인딩 해제할 수 있습니다. WooCommerce 및 Ultimate Member 계정 페이지와 통합되며 모든 멤버십/계정/프로필 플러그인과 쉽게 통합될 수 있습니다.
  • WeChat 공유: Moments에서 게시물과 페이지를 예쁜 방식으로 공유하거나 채팅으로 보냅니다. 성공 및 실패 시 개발자를 위한 JavaScript 이벤트를 트리거합니다.
  • 강제 WeChat 모바일: 사용자가 WeChat 브라우저 외부에서 웹사이트를 탐색하는 것을 방지합니다. 클래식 브라우저로 액세스하면 페이지에 QR 코드가 표시됩니다.
  • 공식 계정 강제 팔로우: WeChat 팔로어를 수집하여 사용자가 콘텐츠에 액세스하기 전에 공식 계정을 팔로우하도록 합니다.
  • WordPress 사용자 화면 재정의: 사용자 화면의 기본값 대신 WeChat 이름과 WeChat 아바타가 있는 경우 이를 표시합니다.
  • WP Weixin QR 코드 생성기: 사용자 정의 코드를 생성합니다.
  • 메뉴 통합: WeChat Responder가 활성화되면 WordPress에서 공식 계정 메뉴를 설정할 수 있습니다.
  • 환영 메시지: 사용자가 공식 계정을 팔로우하면 WeChat에서 환영 메시지를 보냅니다. WeChat Responder가 활성화되면 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 활성화 - 유효한 구성이 필요합니다.
위챗 앱 ID 예 텍스트 개발 > 기본 구성 아래 https://mp.weixin.qq.com/ 의 백엔드에 있는 AppId입니다.
위챗 앱 비밀 예 텍스트 개발 > 기본 구성 아래 https://mp.weixin.qq.com/ 의 백엔드에 있는 AppSecret.
위챗 OA 이름 아니요 텍스트 공식 계정 이름(실명 입력 권장)
위챗 OA 로고 URL 아니요 텍스트 공식 계정 로고 URL - (실제 로고 사진 URL 입력 권장)
WeChat 인증 활성화 아니요 체크박스 활성화되면 사용자는 WeChat 브라우저로 사이트를 방문할 때 WordPress의 WeChat 계정으로 인증됩니다(그렇지 않은 경우 'wx_openId-' . apply_filters( 'wp_weixin_ms_auth_blog_id', 1 ) 키가 있는 세션 쿠키가 설정됩니다).
강제 WeChat 모바일 아니요 체크박스 WeChat 브라우저를 통해서만 웹사이트에 액세스할 수 있도록 설정하세요.
다른 브라우저로 접속하면 해당 페이지에 QR 코드가 표시됩니다.
강제 팔로우(모든 페이지) 아니요 체크박스 WeChat 브라우저를 사용하여 사이트에 액세스하기 전에 사용자에게 공식 계정을 팔로우하도록 요구합니다.

다중 사이트 설정

이러한 설정은 기본적으로 숨겨져 있으며 다음과 같은 경우에만 사용할 수 있습니다.

  • 워드프레스 멀티사이트가 설치되었습니다
  • 현재 사용자에게 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 응답기 사용 체크박스 웹사이트가 WeChat의 메시지를 받고 응답할 수 있도록 허용합니다. 서버 구성은 https://mp.weixin.qq.com/ 의 개발 > 기본 구성에서 활성화 및 구성되어야 합니다. 기본 설정 또는 WeChat Pay 설정에서 "강제 팔로우" 옵션을 사용하는 경우 필요합니다.
위챗 토큰 텍스트 개발 > 기본 구성 아래 https://mp.weixin.qq.com/ 의 백엔드에 있는 토큰.
메시지 인코딩 체크박스 웹사이트와 WeChat API 간의 통신을 인코딩합니다(권장).
위챗 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 에 있습니다.

위챗페이 설정

이러한 설정은 기본적으로 숨겨져 있으며 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를 사용하려면 비워두세요.
위챗 판매자 ID 텍스트 https://pay.weixin.qq.com/index.php/extend/pay_setting 의 백엔드에 있는 판매자 ID입니다.
PEM 인증서 접두사 텍스트 https://pay.weixin.qq.com/index.php/core/cert/api_cert 에서 다운로드한 인증서 파일의 접두사입니다.
인증서 파일의 기본 접두사는 apiclient 입니다( apiclient_cert.pem 및 apiclient_key.pem 파일의 경우).
특히 WeChat Pay를 통해 환불을 처리하는 데 필요합니다.
PEM 인증서 파일 경로 텍스트 현재 파일 시스템의 https://pay.weixin.qq.com/index.php/core/cert/api_cert 에서 다운로드한 인증서 파일이 포함된 폴더의 절대 경로입니다.
예: /home/user/wechat-certificates .
PHP를 실행하는 사용자에 대한 읽기 권한이 있어야 하며 웹 루트 외부에 위치해야 합니다.
특히 WeChat Pay를 통해 환불을 처리하는 데 필요합니다.

이러한 설정 외에도 플러그인은 판매자 계정의 API 구성 화면에서 다양한 URL에 입력할 값에 대한 화면 도움말을 제공합니다.

프록시 설정

이름 유형 설명
프록시 사용 체크박스 프록시를 활성화합니다.
프록시 호스트 텍스트 프록시 호스트의 IP 주소 또는 URI입니다.
프록시 포트 텍스트 프록시 호스트에 연결하는 데 사용할 포트입니다.

서버 구성에 따라 WordPress가 방화벽 뒤에 있거나 회사 네트워크 내에 있는 경우 프록시가 필요할 수 있습니다.

기타 설정

이름 유형 설명
사용자 목록 페이지에 WeChat 이름 및 사진 표시 체크박스 WordPress 계정 이름 및 아바타 표시를 재정의합니다.
WeChat 공개 정보 표시 체크박스 사용자 프로필 페이지에 WeChat 공개 정보를 표시합니다. WooCommece 및 Ultimate Member와 통합됩니다.
WeChat 계정 바인딩 링크 표시 체크박스 사용자 프로필 페이지에 WordPress 계정을 WeChat 계정과 연결하거나 연결 해제하는 링크를 표시합니다. WooCommece 및 Ultimate Member와 통합됩니다.
WeChat 계정 인증 링크 표시 체크박스 WordPress 로그인 양식에 WeChat 계정을 사용하여 QR 코드를 통해 인증할 수 있는 링크를 표시합니다.
공식 계정 메뉴 언어 인식 체크박스 사용자의 언어에 따라 공식 계정 메뉴를 맞춤설정하세요. 기본적으로 웹사이트의 기본 언어에 해당하는 메뉴 언어가 사용됩니다.
이 설정은 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 Multisite의 도메인/하위 도메인 기반 네트워크 설치도 지원할 수 있습니다. 결제에 사용되는 블로그는 플러그인 페이지의 다중 사이트 설정 섹션에 있는 "WeChat 결제를 위한 블로그 강제 적용"을 통해 강제할 수 있습니다.
WP Weixin Pay 및 Woo WeChatPay는 WeChat Pay와 통합된 플러그인의 예이며 다중 사이트 설치 유형(하위 디렉터리 또는 도메인/하위 도메인)에 관계없이 작동합니다.

일부 플러그인(상업적이고 난독화되었으며 보안 표준이 모호함)과 달리 WP Weixin은 WordPress 루트에 덤프된 도메인 간 스크립트에 의존하지 않으며 앞으로도 의존하지 않지만 WordPress 작업 및 필터를 활용하는 것을 선호합니다.

개발자가 wp_weixin_ms_auth_blog_id 및 wp_weixin_ms_pay_blog_id 필터 후크를 활용하여 다양한 가능한 시나리오를 설명하는 한 동일한 네트워크에서 여러 공식 계정으로 플러그인을 사용할 수 있습니다(여기에서 간단한 예제 플러그인 참조).

위챗 SDK

WP Weixin이 제공하는 가장 강력한 도구 중 하나는 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_follower

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 사용자 모음을 가져옵니다(여러 공식 계정이 있는 Multisite의 경우에만 가능).

매개변수
$unionid

(문자열) 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 );

설명
플러그인을 구성하는 데 사용되는 특정 옵션 값을 가져옵니다.

매개변수
$키

(문자열) 옵션 키입니다.

반환 값

(혼합) 옵션에 값이 있으면 문자열, 부울 또는 정수이고, 그렇지 않으면 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) Wether 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 .

$출력

(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 브라우저에는 적용되지 않습니다.

매개변수
$출력

(bool) 링크를 출력할 Wether입니다.

$target

(문자열) 링크의 대상입니다.

$target

(문자열) 링크의 CSS 클래스입니다.

반환 값

(혼합) $output true 로 설정되면 링크의 마크업은 false 입니다.

wp_weixin_get_bind_link 

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

설명
WeChat 계정 바인딩 페이지에 대한 링크를 받으세요.
이 기능은 WeChat 브라우저에는 적용되지 않습니다.

매개변수
$출력

(bool) 링크를 출력할 Wether입니다.

$target

(문자열) 링크의 대상입니다.

반환 값

(혼합) $output true 로 설정되면 링크의 마크업은 false 입니다.

wp_weixin_unbind 

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

설명
이전에 WeChat과 바인딩된 WordPress 사용자 계정을 바인딩 해제하여 연결된 WeChat 계정과 관련하여 기록된 모든 정보를 효과적으로 삭제합니다.
참고: WeChat 전용 WordPress 사용자 계정은 WeChat 브라우저에서 웹사이트를 열 때 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 브라우저에서 웹사이트를 열 때 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_follower 

 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_지불_통지
  • 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을 코어로 사용하여 플러그인을 빌드하는 데 사용됩니다.
참고: 향후 업데이트로 인해 동작이 변경되지 않을 것이라는 보장은 없으므로 가능한 경우 이 작업의 매개변수 메서드 대신 제공된 함수를 사용하는 것이 좋습니다.

매개변수
$wechat

(혼합) WP_Weixin_Wechat 개체입니다.

$wp_weixin_settings

(혼합) WP_Weixin_Settings 개체입니다.

$wp_weixin

(혼합) WP_Weixin 개체입니다.

$wp_weixin_auth

(혼합) WP_Weixin_Auth 개체입니다.

$wp_weixin_responder

(혼합) WeChat Responder가 활성화된 경우 WP_Weixin_Responder 개체, 그렇지 않으면 false .

$wp_weixin_menu

(혼합) WeChat Responder가 활성화된 경우 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과 바인딩한 후 실행됩니다.

매개변수
$bound

(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 사용자 계정 바인딩을 해제한 후 실행됩니다.

매개변수
$언바운드

(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_지불_통지 

 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 .

$지불_결과

(배열) 결제 알림 결과입니다. 결과의 구조: 

 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_주파수
  • wp_weixin_qr_cleanup_주파수
  • 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 );

설명
WeChat 브라우저를 통해서만 액세스할 수 있는 페이지에 대해 클래식 브라우저에 표시되도록 QR 코드 소스를 필터링합니다.

매개변수
$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 코드가 표시된 페이지의 제목을 필터링하세요.

매개변수
$제목

(문자열) 페이지 제목 - 기본값은 "Follow Us!"입니다.

wp_weixin_follower_notice 

 apply_filters ( ' wp_weixin_follower_notice ' , string $ notice );

설명
공식 계정을 팔로우하려면 QR 코드가 표시된 페이지에 표시되는 메시지를 필터링하세요.

매개변수
$공지

(문자열) 표시되는 메시지 - 기본값은 "이 콘텐츠에 액세스하기 전에 이 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을 방문하려면 Wether 인증이 필요합니다.

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

설명
공식 계정을 팔로우할 때 사용자가 받는 메시지의 제목을 필터링합니다.

매개변수
$제목

(문자열) 제목 - 기본값 "'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 판매자 계정의 API 구성 화면에 등록하는 데 필요한 URL을 필터링합니다. 다른 플러그인이 WeChat Pay Integration을 구현할 때 사용됩니다.

매개변수
$ jsapi_urls

(배열) URL은 WeChat 판매자 계정의 API 구성 화면에 등록합니다.

wp_weixin_pay_callback_endpoint 

 apply_filters ( ' wp_weixin_pay_callback_endpoint ' , string $ endpoint );

설명
WeChat Merchant 계정의 API 구성 화면에 등록하는 데 필요한 QR 결제 URL의 엔드 포인트를 필터링하십시오.

매개변수
$ callback_url

(문자열) QR 결제 URL의 끝점은 WeChat 판매자 계정의 API 구성 화면에 등록 할 QR 지불 URL (예 : /my_plugin/notify ).

wp_weixin_settings 

 apply_filter ( ' wp_weixin_settings ' , $ settings );

설명
플러그인을 구성하는 데 사용되는 설정을 필터링하십시오. plugins_loaded 의 우선 순위가 5 이하의 플러그로드 액션 후크에서 고리 함수 또는 메소드를 추가해야합니다.

매개변수
$ 설정

(배열) 플러그인을 구성하는 데 사용되는 설정.

wp_weixin_show_settings_section 

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

설명
WETHETS 설정 페이지에 설정 섹션을 표시하려면 Wether를 필터링하십시오.

매개변수
$ show_section

(BOOL) WETHER는 WP Weixin 설정 페이지의 설정 섹션을 표시합니다.

$ section_name

(문자열) 설정 섹션의 이름입니다.

$ 섹션

(배열) 섹션의 설정.

wp_weixin_show_setting 

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

설명
WP Weixin 설정 페이지의 설정을 표시하려면 Wether를 필터링하십시오.

매개변수
$ show_setting

(bool) WETHET는 WP Weixin 설정 페이지의 설정을 표시합니다.

$ section_name

(문자열) 설정이 속한 섹션의 이름입니다.

$ index

(int) 섹션의 설정 색인.

$ 값

(배열) 설정.

wp_weixin_settings_fields 

 apply_filters ( ' wp_weixin_settings_fields ' , array $ settings_fields );

설명
WP Weixin 설정 페이지에 표시된 설정 필드를 필터링하십시오.

매개변수
$ include_section

(배열) WP Weixin 설정 페이지에 표시되는 설정 필드.

wp_weixin_auth_redirect 

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

설명
클래식 브라우저에서 QR 코드 인증이 수행 될 때 URL을 리디렉션하도록 필터링하십시오.

매개변수
$ 리디렉션

(혼합) 인증이 수행 될 때 리디렉션 할 URL 또는 리디렉션이없는 경우 false . 기본값은 home_url() 성공적인 인증의 경우입니다.

$ 인증

(BOOL) 인증이 수행되었습니다. true 하면 오류가 발생하면 false 발생했습니다.

$ has_error

(bool) 오류가 발생했습니다.

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 코드의 수명을 필터링하십시오.

매개변수
$ 수명

(int) 초의 수명. 기본 600 .

wp_weixin_user_wechat_info 

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

설명
사용자 정보를 필터링하십시오.

매개변수
$ wechat_info

(혼합) 존재하는 경우 wechat 정보의 배열, 그렇지 않으면 false .

$ 수명

(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) WETHER WECHAT -DEFAULT 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 백엔드에 등록 된 것으로 가정합니다.

경고 : WP Weixin이 여러 공식 계정을 지원하는지 확인하기 위해 Meta Key ( 'wx_openid-' . $auth_blog_id )에 $auth_blog_id 의 값이 포함 된 사용자 메타 레코드를 사용하여 바운드 계정의 OpenID가 저장됩니다.
WeChat-bound WordPress 사용자가 이미 존재하는 경우 (WeChat 브라우저를 사용하여 사이트를 방문 할 때 수동으로 바인딩 또는 자동으로 생성)이 필터를 적용하고 $auth_blog_id 의 변경된 값을 반환하면 런타임 동안 사용자와 기록 된 OpenID 간의 관계가 중단됩니다.
데이터베이스를 직접 업데이트하거나 아래와 같이 일회성 사용 코드 스 니펫을 실행하는 것은 개발자에게 달려 있습니다.

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

설명
필터 필기 블로그 ID는 WeChat Pay API로부터 전화를 걸고 지불 알림을받을 수있는 URL을 구축하는 데 사용되는 블로그 ID를 기본적으로, 현재 블로그의 ID에 해당하는 도메인 (또는 하위 도메인)이 WeChat 백엔드에 등록 된 것으로 가정합니다. WooCommerce의 여러 인스턴스가 동일한 네트워크 또는 여러 공식 계정에 연결된 네트워크의 경우 실행중인 경우 유용합니다.

매개변수
$ pay_blog_id

(int) 블로그의 ID는 QR 결제 콜백 URL을 구축하는 데 사용됩니다. 기본 get_current_blog_id() .

wp_weixin_locate_template_paths 

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

설명
WP Weixin 및 Companion 플러그인에 포함 된 가능한 템플릿 경로를 필터링하십시오.

매개변수
$ 경로

(배열) 가능한 경로. default (여기서 $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 급여 설정에 대한 설명을 필터링하십시오.

매개변수
$ ecommerce_description

(문자열) WeChat 급여 설정 (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- 형식 링크
  • WP-Weixin-Auth-Page
  • WP-Weixin-Mobile-Auth-Check
  • WP-Weixin-bind- 양식 링크
  • 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 코드를 표시하는 페이지의 템플릿은 공식 계정을 따릅니다. 설정에서 "Force Follow"가 활성화 될 때 사용됩니다.

$ 제목

(문자열) 화면 제목이 사용자에게 제시됩니다.

$ 메시지

(문자열) 사용자 가이 화면을 보는 이유를 설명하는 메시지.

$ qr_src

(문자열) QR 코드 이미지의 소스.

WP-Weixin-Browser-QR 

 wp-weixin-browser-qr.php

설명
웹 사이트가 WeChat 브라우저를 통해서만 액세스 할 수있을 때 QR 코드를 표시하는 페이지의 템플릿.

변수
$ page_qr_src

(문자열) QR 코드 이미지의 소스.

WP-Weixin-Auth- 형식 링크 

 wp-weixin-auth-form-link.php

설명
WeChat 인증 링크의 템플릿.

변수
$ 클래스

(문자열) 링크의 클래스 속성.

$target

(문자열) 링크의 대상 속성.

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 , (배열) error , (bool | String) redirect . redirect 값은 실제로 모바일에서 기본적으로 리디렉션에 사용되지 않습니다 (데스크탑에서 인증 후 사용).

WP-Weixin-bind- 양식 링크 

 wp-weixin-bind-form-link.php

설명
WeChat 계정 바인딩 링크의 템플릿.

변수
$ link_text

(문자열) 링크의 텍스트.

$ wechat_info

(혼합) WeChat 정보 배열이 존재하는 경우, 그렇지 않으면 false .

$ 클래스

(문자열) 링크의 클래스 속성.

$target

(문자열) 링크의 대상 속성.

WP-Weixin-bind-page 

 wp-weixin-bind-page.php

설명
WeChat 계정에 표시된 WeChat 화면의 템플릿은 클래식 브라우저에서 Bindind입니다.

변수
$user_id

(int) 사용자의 ID가 WeChat 계정에 바인딩됩니다.

$ wechat_info

(혼합) WeChat 정보 배열이 존재하는 경우, 그렇지 않으면 false .

WP-Weixin-Mobile-Bind-Check 

 wp-weixin-mobile-bind-check.php

설명
클래식 브라우저의 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

설명
WP_WEIXIN_GET_USER_WECHAT_INFO를 false 할 때 WECHAT 공개 정보를 $output 하는 템플릿.

변수
$ wechat_info

(배열) Wechat 공개 정보. 값은 모두 nickname , headimgurl , sex , language , city , province , country , unionid 와 같은 모든 유형 (문자열)입니다.

WP-Weixin-Account-Form-Password-Notice 

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

설명
사용자 계정 비밀번호를 변경하기 위해 양식에 표시되는 통지 템플릿.

자바스크립트

글로벌 변수 wx 는 이미 완전한 jsApiList 와 함께 제대로 서명하고 초기화되었습니다.
제대로 사용하려면 개발자가 다음을 수행해야합니다.

  • wp_enqueue_scripts Action Hook에 스크립트를 6 개 이상 포함시킵니다.
  • wp-weixin-main-script 종속성으로 설정하십시오
  • "활성화"가 WP Weixin 메인 설정에서 체크인 확인하십시오.

또한 제공된 청취자 목록이 구독 될 수 있습니다.

자바 스크립트 리스너 인덱스 :

  • wpweixinsharetimelinesuccesslistener
  • wpweixinsharetimelinefailurelistener
  • wpweixinshareappmessagesuccesslistener
  • wpweixinshareappmessagefailurelistener

wpWeixinShareTimelineSuccessListener 리스너를 구독하는 방법에 대한 예 : 

 window . wpWeixinShareTimelineSuccessListener ( handleShareTimelineSuccess ) ;

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

wpweixinsharetimelinesuccesslistener 

 window . wpWeixinShareTimelineSuccessListener ( callback ) ;

이 리스너를 구독하면 WeChat Moments의 게시물을 공유 한 후 callback 함수가 실행됩니다.

매개 변수는 콜백으로 전달되었습니다
ShareInfo

(Object) WeChat JS_SDK에 전송 된 공유 정보. 속성은 title , desc , link , imgUrl 입니다.

wpweixinsharetimelinefailurelistener 

 window . wpWeixinShareTimelineFailureListener ( callback ) ;

이 리스너를 구독하면 WeChat Moments의 게시물을 공유 한 후 callback 기능이 실패했습니다.

매개 변수는 콜백으로 전달되었습니다
ShareInfo

(Object) WeChat JS_SDK에 전송 된 공유 정보. 속성은 title , desc , link , imgUrl 입니다.

wpweixinshareappmessagesuccesslistener 

 window . wpWeixinShareAppMessageSuccessListener ( callback ) ; `

이 리스너를 구독하면 WeChat "Send to Chat"과 함께 게시물을 공유 한 후 callback 함수가 실행됩니다.

매개 변수는 콜백으로 전달되었습니다
ShareInfo

(Object) WeChat JS_SDK에 전송 된 공유 정보. 속성은 title , desc , link , imgUrl 입니다.

wpweixinshareappmessagefailurelistener 

 window . wpWeixinShareAppMessageFailureListener ( callback ) ;

이 리스너를 구독하면 WeChat "Send to Chat"과 함께 게시물을 공유 한 후 callback 함수가 실패합니다.

매개 변수는 콜백으로 전달되었습니다
ShareInfo

(Object) WeChat JS_SDK에 전송 된 공유 정보. 속성은 title , desc , link , imgUrl 입니다.

확장하다
추가 정보
관련 애플리케이션
추천
관련 정보 전체