Tencent WeChat

The Tencent WeChat module integrates WeChat Official Account Admin Platform
(https://mp.weixin.qq.com/) with Drupal.

This module is under heavy development.

Features are separated into submodules.

Submodules and Features

Tencent WeChat SDK module

Load the SDK/Library https://github.com/overtrue/wechat

Tencent WeChat Binding module

User account binding with WeChat OpenId.

• Binding from Drupal side by scan QR Code.
• Binding form WeChat App by click a custom menu.
• Supports auto login.

Tencent WeChat User module

WeChat Public Platform Account user Management. Batch syncing. Required by Tencent WeChat Binding module.

Tencent WeChat Menu module

Manage and create custom menu for WeChat Official Account.

• Normal custom menu.
• Personalized custom menu.

Tencent WeChat Message module

Request message and response message management.

Cron queue used.

Requirements

• Make sure Multi-byte UTF-8 support is available. The WeChat user may use emoji in Nickname, if Multi-byte UTF-8 was not supported, an error will be thrown when sync/update the WeChat Public Platform user account.

Dependencies

• Entity API
• Date
• EntityReference
• Composer Vendor Autoload

Installation

• Install as you would normally install a contributed Drupal module. Visit:
  https://drupal.org/documentation/install/modules-themes/modules-7
  for further information. And the steps next for loading the WeChat SDK
  have different options. Which steps to follow totally depends on your
  own favor.

Option #1

• If you start project with https://github.com/drupal-composer/drupal-project
  Just run composer require "overtrue/wechat:3.3.9" -vvv
  and enable the Composer Vendor Autoload module.

Option #2

• Install the Tencent WeChat SDK submodule.

Configration/Usage

• Configure Tencent WeChat settings in Administration » Configuration » Tencent WeChat.
• Customize the Tencent WeChat menu settings in Administration » Taxonomy » Tencent WeChat Public Platform Account Menu
• View Tencent WeChat request/response messages in Administration » Content » Tencent WeChatMessage
• Access Tencent WeChat Binding page in My Account » Tencent WeChat Account Binding.

Related Development Documentations

• WeChat Official Account Admin Platform: http://admin.wechat.com/wiki/index.php (English, Not Up To Date compared with the Chinese version)
• WeChat Official Account Admin Platform - 微信 · 公众平台: https://mp.weixin.qq.com/wiki (Chinese)
• EasyWeChat - Overture WeChat: https://easywechat.org/en/docs/(English, Incomplete)
• EasyWeChat - Overture WeChat: https://easywechat.org/zh-cn/docs/(Chinese)

Troubleshooting

If you encounter error with errcode 40164 and error message contains invalid ip x.x.x.x

Are you added your/the server's IP address x.x.x.x in whitelist by logged in https://mp.weixin.qq.com/?

If Newsletter enabled, install Tencent WeChat Menu module will encounter error likes below:

FieldException: Attempt to create an instance of a field field_tencent_wechat_menu that doesn't exist or is currently inactive. in field_create_instance() (line 476 of /var/www/dev/modules/field/field.crud.inc).

Disable the Newsletter module temporarily may fix it or try to apply this patch (Or visit issue #2340511)

Pledges

Drupal 8 version will be developed as soon as possible after the Drupal 7 version becomes stable.

Similar projects

Wechat (Drupal微信模块), Similar features, different WeChat SDK, and different ways to implement.

Sponsorship

Current maintainers:

• Qiangjun Ran (jungle) - https://drupal.org/user/2919723

This module is sponsored by:

• InterGreat.com InterGreat develops products for international students. Visit the website to find out more.
• ITife.com. ITife is a small Drupal Shop in Chongqing, China. Please visit https://www.itife.com/ for more information.