taolefan
v2.1.10
淘樂飯是基於PHP的微信公眾號返利項目，支援認證或未認證的訂閱號碼及服務號使用。
注意：因為不可抗因素，本專案停止更新，目前版本可以正常使用，如需商業支援請加QQ764744445諮詢。
您目前檢視的為2.X版本分支，如需未認證公眾號使用，請切換至1.X分支檢視。 1.X於2.X並行開發，僅區分認證和未認證呼叫不同介面。
本專案使用Laravel 作為主架構進行開發，公眾號互動使用EasyWechat 實現，管理後台基於X-admin二次開發。 本專案使用GPLv3協議，允許複製、傳播、修改及商業使用，禁止將修改後及衍生的程式碼做為閉源的商業軟體發布及銷售。
本專案主要使用淘寶聯盟、 大淘客、微信公眾開放平台等平台介面進行開發
1、/config/config.php #本設定檔保存網站/平台基本資訊、淘寶聯盟和大淘客APPKEY等訊息
2、/config/wechat.php #本設定檔保存微信公眾平台APPKEY相關訊息
2、.env #本設定檔保存資料庫相關信息
1.公眾號轉鏈（京東/淘寶），用戶發送原始或其他淘客的淘口令到公眾號，後台轉鏈併計算出返利金額、獲取優惠券信息返回給用戶。
2.註冊功能，關注即可完成註冊，綁定微信openID（微信唯一識別）。使用者可以透過公眾號選單快速補全提現帳戶訊息，也可以綁定淘寶帳號，取得special_id（淘寶會員營運唯一識別）
3、自動取得訂單及綁定訂單，自動儲存所有訂單到資料,有會員營運id的訂單會自動綁定openid(備用方案) ,根據用戶查商品狀況自動追蹤訂單，不同用戶購買相同商品時暫停該商品自動跟單以免跟單錯誤
4.手動發送訂單號碼綁定訂單
5.用戶查詢自己的訂單資訊及提現
6.後台管理面板
7.用戶查詢訂單資訊時自動刷新用戶近一個月訂單狀態，每月自動刷新上兩個月訂單狀態，並對上月確認收貨的訂單進行結算
8.自動跟單、提現、邀請好友等自動訊息通知
更多功能仍在逐漸開發中，也可以自行開發相關功能，大家的Star是我持續開發的動力
注意：
*標更新表示資料庫有輕微變動，更新前請備份資料並使用最新sql檔案重新建構結構，再匯入資料使用。
從1.x版本更新為2.x 的用戶，請務必更新資料庫結果，並重新過一遍文檔，將未處理的內容重新操作，以免出現異常如發現bug請提issues並註明2.x版本每次更新後請在網頁根目錄執行以下命令清空緩存，以免因緩存導致部分業務無法訪問
php artisan cache:clear
php artisan route:cache 2022.5.5 v2.1.12
修復月更新訂單遺留代碼導致無法正常更新的問題
2022.4.19 v2.1.11
修復付款金額/返現金額可能顯示為負數bug
2022.4.18 v2.1.10
將轉鏈結果以連結形式傳回，避免被微信偵測修復自動跟單成功傳送兩個訊息的bug
2022.4.17 v2.1.9
修復了一些不影響使用的bug
邀請二維碼支援產生海報，請自行設計海報後，預留二維碼位置，配置config.php即可
*2022.4.14 v2.1.8
基於1.1.8版本更新，呼叫了部分高級介面支援邀請好友返利活動，可在config中設定相關資訊部分頁面轉為選單直接訪問，網頁授權方式獲得openid
自動跟單，提現回饋等皆更換為範本資訊傳送注意：請在更新此版本後重新傳送「建立選單」指令資料庫資料復原完成後請執行下列SQL語句，以便對邀請功能的資料進行初始化（請務必操作）
UPDATE users SET invite_id = NULL WHERE invite_id = ' 0 ' 環境需求：PHP >= 7.4（支援PHP8） ｜ MySQL/MariaDB ｜ Redis 微信公眾號：已認證服務號碼(訂閱號碼、未認證請使用1.x分支)
下載或clone專案代碼到所需環境
#国外环境
git clone -b master https: //github.com/evendevil66/taolefan.git
#国内环境
git clone -b master https: //gitee.com/cdj8/taolefan.git在專案目錄下執行Composer指令安裝依賴套件及自動載入如在PHP8環境使用，請自行將composer.json中的php版本修改為對應版本
composer install
composer dump-auto複製.env.example檔為.env
cp .env.example .env修改.env中的資料庫配置及Redis配置並導入專案根目錄下的taolefan.sql 到資料庫
DB_CONNECTION=mysql #默认使用mysql请勿修改 可支持MariaDB
DB_HOST=127.0.0.1 #数据库连接地址
DB_PORT=3306 #数据库连接端口
DB_DATABASE=taolefan #数据库名
DB_USERNAME=root #数据库用户名
DB_PASSWORD= #数据库密码
REDIS_HOST=127.0.0.1 #Redis连接地址
REDIS_PASSWORD=null #Redis密码 未设置默认为null
REDIS_PORT=6379 #Redis端口
修改/config/wechat.php配置根據微信公眾平台內容修改
' app_id ' => env ( ' WECHAT_OFFICIAL_ACCOUNT_APPID ' , ' appid ' ),
' secret ' => env ( ' WECHAT_OFFICIAL_ACCOUNT_SECRET ' , ' secret ' ),
' token ' => env ( ' WECHAT_OFFICIAL_ACCOUNT_TOKEN ' , ' token ' ),
' aes_key ' => env ( ' WECHAT_OFFICIAL_ACCOUNT_AES_KEY ' , ' aeskey ' )接下來請先完成以下步驟：
1.淘寶聯盟開放平台創建應用程式（應用程式類型可以選擇網站） 取得AppKey 官網請自行在應用程式頁面申請好"淘寶客【推廣者】推廣訂單及資料查詢"及"淘寶客【公用】物料資訊查詢"(該介面已更換為大淘客介面處理)介面權限，需要申請理由的話，隨便寫個小作文就行了，秒批
2.註冊大淘客開放平台並授權淘寶聯盟取得Appkey 官網3、如需淘寶私域管理功能（自動跟單），請在淘寶聯盟申請好私域權限，申請邀請碼。邀請碼可透過調試官方介面進行快速申請，呼叫介面請確保relation_app參數為common，code_type參數為3
4.註冊京東聯盟並申請APIKey，授權綁定到大淘客
修改/config/config.php配置
' name ' => "淘乐饭" , //产品名称 会反应在用户交互等场景
' url ' => "https: //*.*.*", //站点url 如有饭粒网等网站可添加
' apiUrl ' => "https: //*.*.*", //APIurl 调用本程序使用的url
' dtkAppKey ' => "**** " , //大淘客appKey
'dtkAppSecret' => " **** " , //大淘客AppSecret
'aliAppKey' => " **** " , //淘宝联盟AppKey
'aliAppSecret' => " **** " , //淘宝联盟AppSecret
'pubpid' => 'mm_***_***_***', //公用PID 可与运营ID相同
'specialpid' => ' ******',//会员运营ID
'relationId'=>'****', //渠道ID 代理商使用 暂未开发
'inviter_code'=>'******' //会员私域邀请码
'default_rebate_ratio' => 65, //默认返利比例%,
'eleme_url' => " taoke/pages/shopping-guide/index?scene=****** " ,//饿了么小程序路径(后面会有获取方法)
'unionId' => " ****** " , //京东联盟ID
'jdApiKey' => " ****** " , //京东联盟APIKey
'contactType' => 1, //联系客服类型，为0返回微信号，为1返回二维码图片
'contactId' => " ", //客服微信号
' contactMediaId ' => "", //客服微信二维码图片MediaID（获取方式见Readme文档介绍）
'invite'=> 1 , //是否开启邀请 开启填写1 关闭填写0
'invite_ratio'=> 10 , //邀请返利比例%
'invite_rewards'=> 1 , //邀请奖励金额
'template_id'=>'****** ' , //模板消息ID(后面会有获取方法)
' withdraw_template_id'=>'****** ' //提现模板消息ID(后面会有获取方法)
' invite_template_id'=>'****** ' ,//邀请好友模板消息ID
'createPoster'=> 1 , //是否开启生成海报 开启填写1 关闭填写0 如开启生成海报，请将jpg格式海报模板上传到public下并命名为poster.jpg
'posterx'=>' 206 ', //二维码在海报中x位置
'postery'=>' 1057 ', //二维码在海报中y位置
' posterwh'=>' 200 ', //二维码在海报中宽高
--mediaId取得方法使用微信公眾平台介面調試工具
首先调用获取access_token接口
然后使用取得的token调用多媒体文件上传接口
将获得的MediaId填写到config文件即可
設定好網域名稱與SSL憑證後，公眾平台網址填寫你的網域/wechat
並注意在微信公眾號功能設定中設定好業務網域和授權網域名稱（無需新增/wechat） 例如：
www.***.com/wechat
使用任意帳號寄給公眾號碼"建立選單"即可建立自訂選單如需對選單進行刪改，請修改/app/Http/Controllers/WechatController.php中的$buttons變量
访问管理员注册页面创建超级管理员
````shell script
http://你的域名/adminReg
#该页面仅能创建一次超级管理员，如果后续忘记超级管理员账号密码
#删除站点目录下/storage/app/admin.lock文件后即可重新创建
登陸管理後台後造訪以下位址取得template_id
http://你的域名/setIndustry
#请确保访问该页面前，公众号已配置完成并已认证
#访问提示设置成功后，前往公众号后台->广告与服务->模板消息，获得创建的模板id，并分别填入config.php中若要開通餓了麼小程式返利，請在小程式中關聯餓了麼（APPID：wxece3a9a4c82f58c9）
透過淘寶聯盟APP-吃喝玩樂-餓了麼微信小程式專屬-分享小程序，取得專屬路徑，並配置到config.php中
設定定時器crontab用於查詢並儲存訂單
crontab -e* * * * * curl 你的域名/getOrderList
#每分钟查询一次订单信息并存入数据库
10 1 1 , 10 , 19 , 28 * * curl 你的域名/updateOrderAll
#每个月1、10、19、28日1点10分执行对上月及上上月订单的信息修改及结算等（仅联盟结算日期为上月的才会被结算）至此，淘樂飯工程已經部署完成，可以正常使用了。如果在部署專案前已經關注公眾號，取關再次關注即可自動註冊帳號到資料庫。
