wechat_gate
1.0.0
Biblioteca de desarrollo de plataforma pública WeChat
Interfaces compatibles:
Características:
Videotutorial de uso: desarrollo de cuentas públicas de WeChat
Agregue esta línea al Gemfile de su aplicación:
gem 'wechat-gate'Y luego ejecuta:
$ bundle
O instálelo usted mismo como:
$ gem install wechat-gate
Antes de comenzar a trabajar, debe realizar las siguientes configuraciones en la plataforma de cuenta pública WeChat:
Cree el archivo wechat.yml en el directorio de configuración del proyecto Rails y configure la información de su cuenta oficial.
# 区分不同的环境
eggman:
development:
host: http://wechat-test1.eggman.tv
wechat_id: xxxxxxxxxx
app_id: xxxxxxxxxx
app_secret: xxxxxxxxxx
oauth2_redirect_uri: "http://wechat-test1.eggman.tv/wechat/users/callback"
push_url: "http://wechat-test1.eggman.tv/wechat/push"
push_token: xxxxxxxxxxxxxxxxxxxx
production:
host: https://eggman.tv
wechat_id: xxxxxxxxxx
app_id: xxxxxxxxxxxxxxxxxxxx
app_secret: xxxxxxxxxxxxxxxxxxxxxxxxxx
# 如果不需要多环境支持，也可以这样
app_name:
app_id: <%= ENV['WECHAT_APP_NAME_APP_ID'] %>
app_secret: <%= ENV['WECHAT_APP_NAME_APP_SECRET'] %>
oauth2_redirect_uri: <%= ENV['WECHAT_APP_NAME_OAUTH2_REDIRECT_URI'] %>
Luego especifique el nombre de la cuenta oficial que se leerá en ApplicationController:
self.wechat_gate_app_name = 'eggman'
Operaciones API en segundo plano (como la adquisición de información de usuarios de WeChat, etc.).
De forma predeterminada, la configuración se ha inicializado en el controlador, el método es wechat_gate_config , solo úselo directamente.
wechat_gate_config . users # 获取用户列表
wechat_gate_config . user ( 'ONE_OPEN_ID' ) # 获取一个用户的详细信息
wechat_gate_config . access_token # 获取当前access_token
# OAuth 2
wechat_gate_config . oauth2_entrance_url ( scope : "snsapi_userinfo" , state : "CURENT_STATE" ) # 获取当前OAuth2授权入口URL
wechat_gate_config . oauth2_access_token ( "TOKEN" ) # 根据OAuth2返回的TOKEN获取access_token
wechat_gate_config . oauth2_user ( "ACCESS_TOKEN" , "ONE_OPEN_ID" ) # 获取一个用户的信息
wechat_gate_config . medias # 获取素材列表, 参数type: image | video | voice | news (图文)
wechat_gate_config . menu_get # 获取菜单
wechat_gate_config . menu_create ( MENU_HASH ) # 创建菜单
wechat_gate_config . generate_js_request_params ( REFERER_URL ) # 返回JS-SDK的验证参数，供前端JS-SDK使用Por supuesto, también puedes inicializar la configuración manualmente, o incluso especificar la ruta al archivo de configuración:
config = WechatGate::Config.new('eggman', '/path/to/what/ever/you/want.yml')
Tanto el token de acceso como los tickets en JS_SDK tienen un tiempo de vencimiento y un límite de tiempo de actualización, que se han considerado aquí. No necesita preocuparse por eso. Si desea actualizar manualmente, puede hacer esto:
config.refresh_access_token
config.refresh_jsapi_ticket
El archivo de configuración admite erb
Para obtener más interfaces y documentación, consulte directamente el código fuente, que está escrito con gran detalle.
def ticket
url = CGI . unescape ( params [ :url ] ) # 微信中用户访问的页面
@data = wechat_gate_config . generate_js_request_params ( url ) # 生成微信JS-SDK所需的jsapi_ticket，signature等等参数供前段js使用
render content_type : "application/javascript"
endbillete.js.erb:
var wxServerConfig = <%= @data.to_json.html_safe %>;
<%= params[:callback] %>();
Luego introduzca el siguiente código en la página de WeChat:
( function ( ) {
var ticket = document . createElement ( "script" ) ;
ticket . src = "http://localhost/api/wechat_ticket/ticket.js?url=" + encodeURIComponent ( window . location . href . split ( '#' ) [ 0 ] ) + "&callback=wxCallback" ;
var s = document . getElementsByTagName ( "script" ) [ 0 ] ;
s . parentNode . insertBefore ( ticket , s ) ;
} ) ( ) ; Primero configure el archivo de configuración del menú, config/wechat_menu.yml, que admite erb. Para conocer el formato, consulte el documento del menú personalizado de WeChat:
button:
- type: view
name: 我的2
url: <%= @config.oauth2_entrance_url(scope: 'snsapi_userinfo', state: 'profile') %>
- type: view
name: 课程
sub_button:
- type: view
name: 免费课程
url: <%= @config.oauth2_entrance_url(scope: 'snsapi_userinfo', state: 'free') %>
- type: view
name: 付费课程
url: <%= @config.oauth2_entrance_url(scope: 'snsapi_userinfo', state: 'paid') %>
La variable **@config** es la instancia actual de la cuenta pública de WeChat. No la modifique y úsela directamente.
Luego ejecute la tarea de rake:
$rails wechat_gate:create_menu APP_NAME=eggman CONFIG=/path/to/wechat.yml MENU=/path/to/wechat_menu.ymlEntre ellos, CONFIG tiene como valor predeterminado config/wechat.yml, MENÚ tiene como valor predeterminado config/wechat_menu.yml y se debe especificar APP_NAME.
Agregar prueba
