1.开发背景
基于php7.3、laravel8框架开发
2.运行环境
linux(centOS)+ nginx + php7.3以上+mysql5.6
3.安装步骤
以宝塔演示安装步骤
- 独立私有化部署版本需上传源码到站点根目录
- 微擎版本需在微擎后台更新应用到最新版本
3.1 安装前检查工作
环境安装（有7.3环境的请注意删除禁用函数，和安装扩展）
- php环境安装，到软件商店找到php7.3环境点击安选，择装编译安装急速都可以
- 安装完成选择php7.3设置，到禁用函数栏目，找到禁用函数选择删除
- 扩展安装，选择php7.3设置，到安装扩展选择安装 fileinfo 和exif
- 删除
symlink、proc_open、putenv的禁用函数
3.2.nginx配置
独立私有化部署版本需配置修改站点配置文件，新增如下配置：
location /
{
try_files $uri $uri/ /index.php?$query_string;
}
修改网站运行目录设置为public，并且关闭防跨站攻击（取消打勾）
3.3.数据库配置
独立私有化部署版本需设置数据库配置文件， 修改.env文件，如不存在.env文件则复制.env.example文件，重命名为.env
打开.env文件 填写数据库账号密码
3.4.license录入
打开站点域名进入管理后台，默认账号密码分别为：
admin@admin.com 12345678
如为以上页面，请联系客服授权license。授权成功以后可正常登录
3.5 新建平台
3.5.1 https配置
请检查站点https访问是否正常，宝塔https开启请前往站点配置申请ssl证书即可，也可以申请ali或腾讯免费证书上传
微擎版本用户请检查对应平台页面域名设置是否为https，否则通过微擎发布小程序，会导致异常
3.5.2 合法域名配置
检查微信小程序后台是否配置了您的站点域名
注：如果启用了远程附件，远程附件域名也应配置到服务器域名里面
云打印需配置固定域名：wss://print.clipimg.com 到socket合法域名
3.5.3 配置平台小程序信息
1.独立版
- 登录进入系统，点击添加，依次录入表单对应信息，并提交
- 点击列表中刚刚添加的小程序即可进入后台
2.微擎版本
- 检查微擎系统是否是最新版本
- 进入站点后台，点击控制台
- 进入应用列表，查看未安装列表，点击安装
- 进入平台列表
- 新增小程序
- 设置微信小程序信息
- 新增版本
不同版本添加应用如下：
证件照基础版：
证件照入门版：
证件照专业版：
云打印：
微擎平台配置可参考微擎文档设置https://wiki.w7.com/document/1344/3948
点击应用->管理后台即可进入后台，操作流程如下图
证件照基础版：
证件照专业版
云打印进入后台：
3.5.4 API秘钥设置
进入可立图官网：clipimg.com 个人中心页面 复制我的密钥
填写上面复制的密钥到后台
3.5.5 小程序发布审核
发布微信小程序【独立版】
（1）登录微信小程序后台—》点击 开发管理–》点击开发设置 找到小程序代码上传，生成小程序代码上传密钥并保存 ，同时设置ip白名单： 139.196.28.244
（2）进入管理后台
打开域名，登录账号密码
点击右上角平台管理
点击发布按钮
正确填写小程序上传密钥：即（1）生成的密钥 。
填写接口地址,地址格式：
https://【您的域名】/api
注：如果是微擎端发布接口地址填如下图地址（设置小程序URL），具体地址参考如下
基础版： https://【您的域名】/addons/madong_zjz/public/index.php/api 入门版：https://【您的域名】/addons/madong_zjz_m/public/index.php/api 专业版： https://【您的域名】/addons/madong_zjz_pro/public/index.php/api 云打印： https://【您的域名】/addons/madong_zjz_plugin_chongyin/public/index.php/api
版本号和版本说明自行组织
填写完成后点击发布即可，如果发布未成功，或者没反应，可多次尝试 发布后进入微信小程序后台，查看 版本管理。扫码体验，体验后即可提交审核
发布微信小程序【微擎版】
方式1.参考独立版发布方式
方式1.进入微擎发布配置，如下图所示
- 配置小程序域名
如果你的域名是www.abc.com 请按如下设置小程序URL：
基础版：https://www.abc.com/addons/madong_zjz/public/index.php/api 入门版：https://www.abc.com/addons/madong_zjz_m/public/index.php/api 专业版： https://www.abc.com/addons/madong_zjz_pro/public/index.php/api 云打印： https://www.abc.com/addons/madong_zjz_plugin_chongyin/public/index.php/api
- 扫码预览
- 微信小程序后台提审
发布头条程序
进入平台管理
下载头条小程序包并解压，用字节跳动开发者工具打开
修改siteinfo.js中对应的uniacid和siteroot为自己的平台的uniacid和站点域名
uniacid如下图获取
siteroot为：https://【您的域名】/api
注：如果是微擎端版则siteroot填如下图地址，具体地址参考如下
基础版：https://【您的域名】/addons/madong_zjz/public/index.php/api 入门版：https://【您的域名】/addons/madong_zjz_m/public/index.php/api 专业版： https://【您的域名】/addons/madong_zjz_pro/public/index.php/api 云打印： https://【您的域名】/addons/madong_zjz_plugin_chongyin/public/index.php/api
发布支付宝小程序
下载支付宝小程序包并解压，用支付宝开发者工具()打开
支付宝发布可参考头条发布教程
发布头条小程序
注：发布前请开通“图片内容安全”能力
支付宝小程序siteinfo.js 文件需增加一项pid参数
pid获取方式：合作者身份 ID。即商家与支付宝签约后，商家获得的支付宝商家唯一识别码。
3.5.7 支付设置
微信小程序支付设置
后台支付配置【注：请使用微信支付，服务商支付暂时不支持】
订单退款设置请上传以下证书：
头条小程序支付设置
头条支付请正确填写如下信息
进入字节跳动小程序后台，开通担保支付。获取SALT和ToKen：
支付宝小程序支付设置
支付宝小程序支付请正确填写如下信息，并上传3个相关证书。
请前往https://open.alipay.com/支付宝小程序后台->开发设置获取证书，如没有注册应用，请先注册应用，证书创建步骤如下所示：
4.后台使用说明
4.1 系统设置
1.邮箱设置
使用qq邮箱smtp服务
填写发送邮箱的smtp用户名、密码
填写接收邮箱
云打印订单邮箱提醒：
冲印订单邮箱提醒：
2.系统升级
点击升级系统按钮，进入升级页面，系统会自动检测是否有新版本升级，点击安装升级会开始自动升级系统（如无特殊升级说明，升级系统后需重新发布小程序）。升级后可检查下面插件是否有更新按钮，如有，可点击更新插件
升级系统后，建议清理缓存再使用小程序
4.2 证件照
1.同步类型
点击同步类型按钮，同步可立图官方证件照类型数据
2. 广告设置
设置各个模块流量主广告，累计用户大于等于1000，即可开通流量主
3.冲印设置
开启冲印插件，并设置价格。设置提醒邮箱，可接受到冲印订单提醒邮件
4. 团体照设置
开启团体照插件，并设置团体照单价
5. 机构报名设置
开启机构报名入口，选择照片规格
小程序添加机构报名入口
可通过diy或者默认布局，diy设置如下
4.3 云打印(主门店设置教程)
1.客户端安装
请下载客户端，安装在windows系统中，电脑需要安装WPS Office(建议安装wps office专业版更稳定，https://platform.wps.cn/)。(如果提示需要安装.NET Framework，则需要安装.NET Framework4.5以上版本，下载链接：https://clipimg.com/NDP461-KB3102436-x86-x64-AllOS-ENU.exe）
2.客户端登录
首次运行客户端需输入SN授权码
您的授权码为您授权的小程序的APPID，如提示sn码错误，请联系客服（微信号：maryxzy）授权
使用appid和通讯码登录客户端。
当客户端状态显示已连接，登录成功。appid：为您的微信小程序appid，通讯码：主商户通讯码由客服提供。
客户端默认操作密码为123456
3.配置打印机
点击上方打印机菜单，进入打印机配置页面。点击”修改”开始配置 选择打印机→共享状态打✔→选择纸张大小→选择纸盒→选择打印类型→点击“确认“→设置剩余纸量（注：如果是图片打印或者是证件照打印，建议点击打印机右边属性按钮，选择照片纸，设置纸张质量为高） 此处可以设置多个打印配置，可以根据不同打印类型设置多个配置，也可根据不同纸张大小，不同打印机设置多个打印配置。 配置完成点击确认
4.设置消息提醒
- 订单语音提醒
点击右上角设置按钮，订单通知打✔，当有新订单时，可听到语音通知
- 打印异常邮件提醒
当打印机出现故障时，纸张不足，或者卡纸等不正常状态时，可通过此处设置的邮箱，第一时间提醒您，以便于您及时处理
5.设置显屏
打开设置页面设置显屏二维码
6.纸张设置
管理后台新增纸张设置，可设置可否支持彩色打印，双面打印。
注：管理后台打印机类型必须和客户端打印类型相对应，管理后台尺寸名需和客户端纸张大小名字一致，请务必在客户端“复制”纸张大小到管理后台尺寸名填写处。
请勿手动填写，请使用复制！！！请勿手动填写，请使用复制！！！请勿手动填写，请使用复制！！！
证件照或者照片打印请设置高质量纸张，设置流程如下图所示。
7.商户信息设置
根据下图正确设置商户信息，以及打印参数设置。注：关闭自动打印后，系统将不会自动出纸，需从后台订单下载手动打印，关闭自动打印后不会扣除打印API点数
8.一机一码设置
设置一机一码可获取打印机单独二维码，扫码即可自动选择打印机
请从客户端复制打印机名称至后台一机一码 打印机名称填写处
请勿手动填写，请使用复制！！！请勿手动填写，请使用复制！！！请勿手动填写，请使用复制！！！
9.电脑自助打印
配置native支付能力
价格设置：需在管理后台配置相应纸张价格
php安装imagick扩展
客服授权pc自助功能后可进行pc自助打印
4.4 多门店
1.建立可立图子账户
联系客服进行多门店授权以后，登录可立图官网www.clipimg.com，进入可立图官网个人中心新建子账号作为云打印子商户在可立图的授权账号。（注：需联系客服授权新建子账号权限。），在下面的步骤中配置多门店需要用到相关信息
2.注册门店后台账号
微擎用户请使用微擎系统的账号体系注册账号
微擎站点可通过新建子账号作为商户账号，注册账号后需要授权该账号的使用权限（请参考微擎平台文档设置），或者参照独立版注册方式
3.新增子商户
登录主账号，新增子商户
注意
微擎站点的账号需要登录微擎系统并进入本系统后台，方可在新增时商户账号下拉中选取到该账号的信息。
录入子商户相关信息
4.提现设置
设置提现方式和提现渠道
（1）企业付款到零钱：微信商户需开通企业付款到零钱功能才可进行商户提现，如果商户没有”企业付款到零钱”权限，则续开通商户转账到零钱功能，如（2）
（2）商户转账到零钱：开通商户转账到零钱用于商户提现需要设置以下几点
宝塔设置V3接口：打开项目根目录中的.env文件添加语句：WECHAT_PAYMENT_API = v3
管理后台设置序列号和平台证书
序列号获取方式如下图所示：
平台证书获取方式如下所示：
使用证书下载工具，下载证书工具地址：https://github.com/wechatpay-apiv3/CertificateDownloader/releases/download/v1.2.0/CertificateDownloader-1.2.0-jar-with-dependencies.jar
下载后，命名CertificateDownloader.jar。安装java环境(下载地址：https://download.oracle.com/java/18/latest/jdk-18_windows-x64_bin.exe)，执行 java -jar CertificateDownloader.jar -h ，查看帮助：
运行如下完整命令：
商户私钥文件即apiclient_key.pem , 证书解密密钥即APIv3密钥
java -jar CertificateDownloader.jar -k ${apiV3key} -m ${mchId} -f ${mchPrivateKeyFilePath} -s ${mchSerialNo} -o ${outputFilePath}运行例子如下：
4.5 DIY首页
基础设置可设置页面内容、链接、文字等，样式设置可设置模块颜色、图标、内容等
如果不使用DIY，可选择关闭首页DIY，使用页面数据配置，可自定义部分模块
4.6 团体照
1.开启团体照插件
2.设置团体照入口
可通过diy或者页面数据配置，设置团体照入口
4.7 余额充值
1.开启余额充值插件
开启余额充值插件，并设置充值赠送金额。设置后可在小程序个人中心页面看到相关信息。注：余额只可用于自助打印使用
可通过给某个用户赠送余额，实现某些用户免费使用自助打印功能
4.8 分销
1.设置证件照分销
开启分销插件，并设置分销比例。分销比例为分销员获得的抽佣比例。
2.分销入口设置
可通过diy或者页面数据配置，设置分销入口。
3.云打印分销设置
分销员通过小程序注册以后，管理员可通过后台将分销员和店铺绑定。绑定后，该店铺的自助打印收益，分销员将获得提成。
