platform_menu.md 5.1 KB

平台配置菜单配置说明

功能简介

本功能提供了微信小程序和抖音小程序平台配置的管理界面,包括:

  • 平台基本信息配置(AppID、密钥等)
  • 登录方式配置(自动登录、绑定手机号)
  • 支付方式配置
  • 配置状态管理

菜单配置

1. 添加主菜单

在FastAdmin后台菜单管理中添加以下菜单项:

-- 主菜单
INSERT INTO `fa_auth_rule` (`name`, `title`, `type`, `status`, `condition`, `remark`, `ismenu`, `createtime`, `updatetime`, `weigh`) VALUES
('platform', '平台配置', 'file', 'normal', '', '多平台配置管理', 1, UNIX_TIMESTAMP(), UNIX_TIMESTAMP(), 100);

-- 平台配置列表
INSERT INTO `fa_auth_rule` (`name`, `title`, `type`, `status`, `condition`, `remark`, `ismenu`, `createtime`, `updatetime`, `weigh`) VALUES
('platform/index', '平台列表', 'file', 'normal', '', '查看平台配置列表', 1, UNIX_TIMESTAMP(), UNIX_TIMESTAMP(), 99);

-- 微信小程序配置
INSERT INTO `fa_auth_rule` (`name`, `title`, `type`, `status`, `condition`, `remark`, `ismenu`, `createtime`, `updatetime`, `weigh`) VALUES
('platform/wechat_mini_program', '微信小程序', 'file', 'normal', '', '微信小程序配置', 1, UNIX_TIMESTAMP(), UNIX_TIMESTAMP(), 98);

-- 抖音小程序配置
INSERT INTO `fa_auth_rule` (`name`, `title`, `type`, `status`, `condition`, `remark`, `ismenu`, `createtime`, `updatetime`, `weigh`) VALUES
('platform/douyin_mini_program', '抖音小程序', 'file', 'normal', '', '抖音小程序配置', 1, UNIX_TIMESTAMP(), UNIX_TIMESTAMP(), 97);

2. 设置菜单父子关系

需要将子菜单的pid字段设置为主菜单的id值:

-- 获取主菜单ID
SELECT id FROM `fa_auth_rule` WHERE name = 'platform';

-- 假设主菜单ID为123,更新子菜单的pid
UPDATE `fa_auth_rule` SET `pid` = 123 WHERE `name` IN ('platform/index', 'platform/wechat_mini_program', 'platform/douyin_mini_program');

3. 为管理员分配权限

-- 为超级管理员分配权限(假设管理员组ID为1)
INSERT INTO `fa_auth_group_access` (`uid`, `group_id`) VALUES (1, 1);

配置数据初始化

1. 执行SQL初始化配置项

运行 install_platform_config.sql 文件来初始化配置数据:

mysql -u username -p database_name < install_platform_config.sql

2. 或者使用控制器初始化

访问后台URL:/admin/platform/init_config,通过界面初始化配置数据。

使用说明

1. 访问平台配置

登录FastAdmin后台,在左侧菜单找到"平台配置":

  • 点击"平台列表"查看所有平台配置
  • 点击"微信小程序"配置微信小程序
  • 点击"抖音小程序"配置抖音小程序

2. 配置微信小程序

  1. 在微信公众平台注册小程序账号
  2. 获取小程序的AppID和AppSecret
  3. 在后台填写配置信息:
    • 小程序AppID:必填
    • 小程序密钥:必填
    • 开启状态:是否启用小程序功能
    • 微信自动登录:是否自动授权登录
    • 绑定手机号:是否强制绑定手机号

3. 配置抖音小程序

  1. 在抖音开发者平台注册小程序账号
  2. 获取小程序的AppID和AppSecret
  3. 在后台填写配置信息(同微信小程序)

接口使用

1. 获取平台配置

use app\common\model\Config;

// 获取微信小程序配置
$wechatConfig = Config::getConfigByGroup('shop.platform.WechatMiniProgram');

// 获取抖音小程序配置
$douyinConfig = Config::getConfigByGroup('shop.platform.DouyinMiniProgram');

2. 判断平台状态

use app\common\model\Config;

// 判断微信小程序是否开启
$wechatStatus = Config::getConfigValue('shop.platform.WechatMiniProgram.status');
if ($wechatStatus) {
    // 微信小程序已开启
}

// 判断抖音小程序是否开启
$douyinStatus = Config::getConfigValue('shop.platform.DouyinMiniProgram.status');
if ($douyinStatus) {
    // 抖音小程序已开启
}

3. 获取登录配置

use app\common\model\Config;

// 获取微信小程序登录配置
$autoLogin = Config::getConfigValue('shop.platform.WechatMiniProgram.auto_login');
$bindMobile = Config::getConfigValue('shop.platform.WechatMiniProgram.bind_mobile');

if ($autoLogin) {
    // 启用自动登录
}

if ($bindMobile) {
    // 需要绑定手机号
}

注意事项

  1. 安全性:AppSecret等敏感信息应妥善保管,避免泄露
  2. 缓存:配置修改后会自动清除缓存,确保配置及时生效
  3. 验证:AppID和AppSecret必须从官方平台获取,确保准确性
  4. 测试:配置完成后建议进行接口调用测试
  5. 权限:只有具有相应权限的管理员才能访问配置页面

扩展说明

如需添加更多平台(如支付宝小程序、QQ小程序等),可以:

  1. 在控制器中添加对应的方法
  2. getPlatformConfigData方法中添加对应的配置数据
  3. 创建对应的视图模板
  4. 在菜单中添加对应的菜单项

例如添加支付宝小程序:

public function alipay_mini_program()
{
    $group = 'shop.platform.AlipayMiniProgram';
    return $this->platformConfig($group, '支付宝小程序配置');
}