1 Star 0 Fork 56

Admin / tt-app-mall

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
Apache-2.0

头条/抖音小程序商城

头条/抖音小程序商城,头条/抖音小程序微店,长期维护版本,欢迎大家踊跃提交贡献代码;

使用说明和常见问题,可参阅下面的说明,如还有疑问,可访问工厂官网 https://www.it120.cc/ 寻求帮助!

QQ交流群

812019488

特别鸣谢

本项目是基于 “EastWorld” 的 “wechat-app-mall” 的微信小程序商城进行改造,且同步更新,详细功能请参阅微信小程序的版本:

https://github.com/EastWorld/wechat-app-mall

联系作者

微信好友 支付宝好友

欢迎打赏,让我们有动力更加完善!

接口 & 后台声明

本项目未有开发配套的后台系统,而是直接使用了 api 工厂 提供的免费接口和后台,可以完全满足本项目的所有功能需求。

初始化测试数据

登录后台,左侧菜单 “工厂设置” --> “数据克隆” --> “将别人的数据克隆给我”

对方商户ID填写 951

点击 “立即克隆” ,然后退出后台重新登录

你将立即享有初始化测试数据,方便你进行测试

编译说明

请时刻保证你的开发工具是最新版,如果不是最新版,请先升级你的开发工具

使用说明

1、申请后台账号/获取专属域名

2、开通商城模块

3、修改根目录下 config.js 文件

module.exports = {
  version: "5.0",
  note: "优化接口调用流程",
  subDomain: "tz", // 根据教程 https://www.yuque.com/apifm/doc/qr6l4m 查看你自己的 subDomain
  appid: "wxa46b09d413fbcaff", // 您的小程序的appid,购物单功能需要使用
  shareProfile: "百款精品商品,总有一款适合您" // 首页转发的时候话术
};
/*
根据自己需要修改下单时候的模板消息内容设置,可增加关闭订单、收货时候模板消息提醒;
1、/pages/to-pay-order/index.js 中已添加关闭订单、商家发货后提醒消费者;
2、/pages/order-details/index.js 中已添加用户确认收货后提供用户参与评价;评价后提醒消费者好评奖励积分已到账;
3、请自行修改上面几处的模板消息ID,参数为您自己的变量设置即可。  
*/

4、设置小程序合法服务器域名

5、重启您的小程序开发工具,完成

6、如何在后台管理小程序启动图和首页头部的轮播 banner 图片

这两个功能都是使用后台 “系统设置” --> “banner” 管理功能来实现的;
后台发布banner的时候,自定义类型请分别填写  app  和  new
小程序会自动读取类型为 app 的banner图片作为启动展示图片;
小程序会自动读取类型为 new 的banner图片作为首页分类下的轮播图;

系统参数设置

登录后台,左侧菜单“系统设置” --> “系统参数” 菜单;如果你找不到该菜单,那是因为你还没启用 “系统参数设置” 的模块,左侧菜单“系统设置” --> “模块管理”,启用 “系统参数设置” 模块,然后F5刷新网页即可

  • RECHARGE_OPEN (开关类型)

    微信审核的时候,如果你的小程序有充值功能会导致审核不通过,所以默认情况下,小程序将隐藏充值提现功能,通过该参数可开启充值提现的显示

  • ROLE_FOR_SHOP (开关类型)

    如果你有多店铺功能,改功能将开启店铺管理员功能,届时,每个店铺管理员将只能管理自己店铺下的商品和订单,而无法查看并管理其他店铺的订单

  • ALLOW_SELF_COLLECTION (开关类型)

    是否开启到店自提功能(快递和到店自提客户自己可以选择)

  • WITHDRAW_FEE_PERCENT (文本参数)

    提现手续费比例,填1为 1%

  • free_shipping_for_purchases (文本参数)

    下单金额满多少后实现包邮

  • mallName (文本参数)

    小程序名称(商城名称)

  • REGISTER_OPEN_SELLER (开关类型)

    新注册用户是否自动成为分销商,如果不开启该参数,分销商需要自己申请,你进行审核

    《api工厂三级分销插件使用教程》

常见问题

  • 如何修改小程序商城的标题?

    请查看上面的系统设置中的 mallName

  • “无法登录” / Token 无效 ?

    1. config.js 里面的 subDomain 改成你自己的,保存;
    2. 登录你的小程序后台(MP 那个地址),Request 域名处增加 api.it120.cc
    3. 确保小程序后台(MP 那个地址) 的 appid,工厂后台填写的 appid ,开发工具右上角 “项目详情” 打开后显示的 appid ,这 3 个 appid 是一模一样的;
    4. 开发工具上点击 “清除缓存” —> “编译”
  • 登录后台发布您自己的商品

  • 如何给 Banner 增加链接,点击打开某个商品?

  • 工厂后台设置 appid、secret、微信支付商户号和秘钥时候的 token 怎么填?

    不要填!

    不要填!

    不要填!

    重要的事情说三遍,这个小程序用不到,是给服务号使用的,所以大家空着不要填

  • 微信支付时候,提示 50000 错误,不能获取到预支付 id

    这个错误是无法获取到微信支付的预支付信息

    • 可能是你没有在后台配置您的微信支付商户号和秘钥,或者配置错误
    • 可能是你配置的微信支付不是当前小程序申请的(微信支付目前无法跨小程序调用)
    • 确保微信开发工具上面登录的 APPID 和你在后台配置的 APPID 是同一个
  • 能否帮我免费添加功能?

    可以!

    1. 点击页面顶部的 Star ,关注后,项目有最新动态 github 会提醒您,不错过重要更新;
    2. 点击页面顶部的 Fork, 将您需要增加的功能完成 小程序 端界面的调整,然后在 github 上请求将您的代码合并
    3. 您的代码合并请求审核通过后,我们将会为您完善配套的后台功能;
    4. 开源项目离不开您的支持和代码共享,我们一起把该项目长期维护下去;
  • 下单的时候没有地方填写收货地址?

    1. 添加一个“物流模板”,只有需要快递的商品才会提示用户填写收货地址
    2. 发布商品的时候,选择刚才添加的“物流模板”
    3. 重新下单,将会需要用户输入收货地址
  • 如何使用退款功能?

    1. 后台支持针对订单指定退款多少金额;
    2. 可选择退款至用户可用余额或者按照用户支付原路退还第三方或者银行卡;
    3. 如果选用原路退还,需要在商户号和秘钥设置的地方上传您的微信支付证书文件(PK12 格式文件)
  • 如何设置满多少包邮?

    1. 后台系统设置 -- 系统参数,增加系统参数;
    2. 参数名 free_shipping_for_purchases (注意不要有空格)
    3. 参数值填写您希望的买满金额即可
  • 如何修改或者关闭订单超过 30 分钟未付款自动关闭?

    1. 创建订单接口增加 expireMinutes 参数;
    2. 代表多少分钟未支付自动关闭本订单,传 0 不自动关闭订单;
  • 我没有那么多分类,首页2行分类能否改成1行?

    打开 /pages/index/index.js 文件,找到下图所示位置,代码

    // 这行代码为显示2行
    const _n = Math.ceil(categories.length / 2)
    // 这行代码为显示1行
    const _n = Math.ceil(categories.length)
  • 更多问题?

如何升级到最新版

  • 小程序程序的修改和您后台的数据是独立的,所以不用担心您会丢失数据
  • 先把你开发工具下的现有版本程序备份
  • 下载最新版的程序,直接覆盖您本地的程序
  • 用开发工具修改域名 tz 为你自己的域名
  • 开发工具里面上传代码提交微信审核
  • 审核通过后,小程序后台去发布新版本即可
  • 用户无需重新扫码,关闭小程序重新打开就是新版本了
Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "{}" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright {yyyy} {name of copyright owner} Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

简介

头条/抖音小程序商城,头条/抖音小程序微店,长期维护版本 展开 收起
JavaScript
Apache-2.0
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
JavaScript
1
https://gitee.com/moocang_MrMChen/tt-app-mall.git
git@gitee.com:moocang_MrMChen/tt-app-mall.git
moocang_MrMChen
tt-app-mall
tt-app-mall
master

搜索帮助