Table of contents

  • Preface
  • Config.ini file
  • Attention

Candbox shopping cart software manual

本文为Candbox购物车官方文档. 随时会保持更新或变更细节. 为保障用户权益, 禁止第三方网站全文引用. 转载须注明原文出处.

版权声明: 文档中所描述的图片或文字logo,商标及软件所有权为原主体所有.

本文档以在线方式提供给最终授权用户. 仅适用于Candbox购物车软件使用参考用途.

责任声明: 文档中所描述的使用方法或涉及第三方软件不兼容问题或由第三方软件潜在技术问题,版权及其他问题.Candbox购物车不负任何责任.

特别提示: 文档中尽可能详尽地描述电商网络应用中关联的基础技术以帮助入门用户作额外参考,用户仍可基于互联网搜索查询相关问题获得更多帮助.

由于Candbox购物车是基于N年外贸+电商经验而开发, 文档中会含有技术和外贸业务相关的描述. 所描述观点或见解也仅供参考.

文档所述用语词法及第三方引用内容仅作参考.

Candbox购物车开发过程未曾受任何临时工,投资方或政策支持. Candbox购物车完全由深圳赛格宝贸易有限公司创始人独立开发完成. 基于全球信用价值观和N年的技术积累,公司有独立的技术实力保障最终用户能够可持续使用Candbox购物车的能力.

Preface

Candbox配置文件的全名称是config.ini。 保存在网站根目录的config文件夹内。 参考路径例如: /home/www/config/config.ini

配置文件是网站运行的重要文件。 按需设置配置文件列表的每项参数才能让网站运行。

Candbox配置文件与其他网站程序的配置的差异

传统的软件,或其他开源购物车软件是使用了多种配置方式设置网站。 有些网站的配置参数存储在数据库中，而有些网站的配置参数存在文件中。

使用数据库存储配置参数的优点是：方便在线设置，而缺点是影响网站性能。

使用文件存储配置参数的优点是：性能高，稳定。而缺点是不方便在线设置。

Candbox购物车软件仅使用了一个文件存储网站的所有配置参数。优点是：性能高，稳定，方便备份。参考本页教程就可直接设置。上传到对应的配置文件夹即可使用。

作为网站管理员，应优先了解Candbox购物车软件的配置参数的用途以及使用说明。

Config.ini file summary

Candbox shopping cart software has only one configuration file and saved on folderconfig, fixed name config.ini.

Notice

Do not use window os inner software notepad to edit file config.ini. You can try to use software as "Notepad++" to open / edit config.ini.

1) modifying the config.ini, should be careful to avoid unnecessary spaces and capital letters. Incorrect parameters can cause software errors.

2) Do not delete the parameter name, assuming that it is not used, the name still needs to be retained.

[basic]
domain = https://www.candbox.site

#The main domain name of the website must start with "https" and have no "/" at the end. 
with the suffix "cn" are not supported.

cdnres = https://www.candbox.site

#Website static resource domain name, used to load js, css, website template pictures. If 
no cdn domain name is configured, fill in the main domain name.

cdnimg = https://www.candbox.site

#Website product picture domain name, used to load all product pictures. If no cdn 
domain name is configured, fill in the main domain name.

onstore = true

#The e-commerce website mode: true, and the business or marketing website: false. 
Whenonstore = false, the customer login and shopping cart function are invalid.

enstats = true

#Turn on visitor statistics. Whenenstats = false, the latest statistics of visits 
will not be displayed on the backend homepage.

enmult = true

#Turn on multiple function. Whenenmult = false, there is no multiple limit 
for adding items to the shopping cart.

enrange = true

#开启订购物品最小和最大范围功能.设置enrange = false时,后添加物品到购物车的数量无限制. 但物品超过库存则不允许.

analysis = true

#开启产品筛选统计功能,设置analysis = false时,后端首页不会显示最新用户筛选分析数据.

language = en

#网站默认加载语言,仅支持内置的16种语言:cn,de,en,es,fr,hi,id,ja,ko,lo,ms,pt,ru,th,tl,vi. 错误设置将使用内置默认的cn语言.

currency = USD

#网站在线支付货币单位.以及显示在订单价格后面的货币单位. 设置错误或支付渠道不支持的货币将导致订单支付无效. 仅支持大写.

cacheway = redis

#网站缓存数据方式,设置cacheway = file时, 缓存以文件方式保存在缓存目录. 推荐使用redis作为缓存. 使用redis前需安装.

ssionway = redis

#网站session保存方式,设置ssionway = file时, 网站登录数据以文件方式保存. 推荐电商模式使用redis保存session.

pagepath = html

#网站定制菜单中的单页面路径识别后缀. 仅支持字母数字,长度为: 2 ~ 20 字符.

uniqcode = abxCzy

#网站内部唯一字符串. 仅支持字母数字,长度为: 2 ~ 10 字符. 错误设置将使用内置默认值candbox. 该字符串用于编码数据ID为字符串. 避免明文显示相关数据的存量问题.

loglevel = 1

#网站主要日志显示级别. 值范围为: 0 ~ 5. 正式环境以及无需调试支付功能时,可设置为0.

[list]
topnav = false

#网站前端是否加载全目录数据. 设置topnav = true时, 前端所有页面可加载全目录数据. 通过模板布局可显示. 可根据网站模板风格开启.

topcatg = 10

#首页目录推荐显示数量. 值范围为: 1 ~ 20. 错误设置将使用内置默认值5.

topitem = 10

#首页推荐物品显示数量. 值范围为: 1 ~ 100. 错误设置将使用内置默认值10.

itemlist = 10

#产品列表每页显示数量. 值范围为: 1 ~ 50, 错误设置将使用内置默认值10.

searchlist = 30

#搜索列表每页显示数量. 值范围为: 1 ~ 50, 错误设置将使用内置默认值10.

favlist = 30

#顾客收藏夹列表每页显示数量. 值范围为: 1 ~ 100, 错误设置将使用内置默认值10.

infotype = 9

#资讯信息最大类别. 值范围为: 1 ~ 9, 错误设置将使用内置默认值5. 用于后端编辑限制超范围分类. 同时应根据值范围删除模板中的多余类别名称

ticktype = 9

#问答功能最大类别, 值范围为: 1 ~ 9, 错误设置将使用内置默认值5. 用于前端用户选择类别时限制范围. 同时应根据值范围删除模板中的多余类别名称

[mysqlm]

#mysql master 主数据库配置

host = 127.0.0.1

#主数据库服务器ip地址

port = 3306

#主数据库服务器访问端口

username = root

#主数据库服务器登录用户名

password = 1234

#主数据库服务器登录密码

dbname = apps

#主数据库服务器的数据库名称

[mysqls]

#mysql slave 从数据库配置, 如没有使用主从数据服务功能则设置与主数据配置相同参数

host = 127.0.0.1

#从数据库服务器ip地址

port = 3306

#从数据库服务器访问端口

username = root

#从数据库服务器登录用户名

password = 1234

#从数据库服务器登录密码

dbname = apps

#从数据库服务器的数据库名称

[redis]

#缓存数据服务器配置

host = 127.0.0.1

#缓存服务器访问IP

port = 6379

#缓存服务器访问端口

auth = foobared

#缓存服务器访问密码, 必须设置. 该密码为明文. 推荐设置为字母数字,长度为: 5 ~ 20字符.

[queue]

#队列服务器配置

host = 127.0.0.1

#队列服务器访问IP, 队列服务器软件只能安装在本机.

port = 11300

#队列服务器访问端口

[cart]

#购物车配置

gmaxitnum = 100

#匿名用户购物车最大物品数量,值范围为: 1 ~ 100, 错误设置将使用内置默认值5.

umaxitnum = 200

#登录用户购物车最大物品数量,值范围为: 1 ~ 200, 错误设置将使用内置默认值10.

maxpend = 10

#登录用户最大未支付订单数量,值范围为: 1 ~ 10, 错误设置将使用内置默认值2. 如登录用户未支付订单数量超过该值. 将不能完成新订单的在线支付.

maxitotal = 500

#在线支付最大额限制. 值范围为: 1 ~ 10000, 错误设置将使用内置默认值100. 如在线支付订单总额(仅物品价值)超过该值则不能完成在线支付.

handingmin = 5

#购物车手续费最小额起始值. 值范围为: 1 ~ 100, 错误设置将使用内置默认值1. 如在线支付订单总额(仅物品价值)小于该值则附加额外的手续费.

handingfee = 2

#在线支付时的手续费, 值范围为: 1 ~ 1000, 错误设置将使用内置默认值3. 仅购物车手续费最小额起始值有效时,该值有效.

minfreeval = 99

#免运费时,物品总价最小额. 值范围为: 1 ~ 1000, 错误设置将使用内置默认值1,且免运费功能无效. 需设置免运费的ISO区域表.

[sitecache]

#网站缓存时间配置

categcache = 120

#目录缓存更新时间,值范围为: 1 ~ 86400, 错误设置将使用内置默认值100秒.

plistcache = 120

#产品列表缓存更新时间,值范围为: 1 ~ 86400, 错误设置将使用内置默认值100秒.

pagescache = 180

#定制单页列表缓存更新时间,值范围为: 1 ~ 86400, 错误设置将使用内置默认值100秒.

detailcache = 180

#产品细节页缓存更新时间,值范围为: 1 ~ 86400, 错误设置将使用内置默认值100秒.


#购物车配置

topcpocache = 360

#子目录展示数据缓存时间,值范围为: 1 ~ 86400, 错误设置将使用内置默认值100秒.

subcpocache = 360

#子目录列表展示数据缓存时间,值范围为: 1 ~ 86400, 错误设置将使用内置默认值100秒.

searchcache = 120

#搜索结果列表数据缓存时间,值范围为: 1 ~ 1800, 错误设置将使用内置默认值100秒. 注意: 为避免过多搜索结果的缓存数据占用内存. 搜索缓存时间不要设置过长.

tickcache = 120

#用户问答列表数据缓存时间,值范围为: 1 ~ 1800, 错误设置将使用内置默认值100秒. 提示: 问答列表缓存时间影响顾客等待问题更新的时长.

topccache = 120

#首页目录数据缓存时间,值范围为: 1 ~ 86400, 错误设置将使用内置默认值100秒.

topicache = 120

#首页物品数据缓存时间,值范围为: 1 ~ 86400, 错误设置将使用内置默认值100秒.

topocache = 120

#首页展示数据缓存时间,值范围为: 1 ~ 86400, 错误设置将使用内置默认值100秒.

toprcache = 120

#首页评论数据缓存时间,值范围为: 1 ~ 86400, 错误设置将使用内置默认值100秒.

pgpocache = 120

#定制单页展示数据缓存时间,值范围为: 1 ~ 86400, 错误设置将使用内置默认值100秒.

[backfeed]

#评论设置

comment = true

#首页是否加载推荐评论数据. 设置comment = false时, 首页评论数据不加载且为空值.

feednum = 100

#首页推荐评论显示数量. 值范围为: 1 ~ 100. 错误设置将使用内置默认值5.

deficon = 1F497

用户默认emoji图标字符串. 仅字母数字, 长度为: 4 ~ 5 字符.

[image]

#产品图片配置

miniature = true

#产品图片缩图开启, 设置miniature = false时, 上传产品图时无缩略图功能.

minwidth = 350

#产品缩略图最小尺寸, 值范围为: 100 ~ 500, 错误设置将使用内置默认值200px.

opacity = 70

#产品图片压缩质量, 值范围为: 10 ~ 100, 错误设置将使用内置默认值70.

[admin]

#管理员配置

logpath = portal

#管理员登录路径, 仅支持字母数字,长度为: 2 ~ 20 字符. 错误设置将使用内置默认值admin.

logrand = ymdh

#管理员登录的动态时间路径, 仅支持由指定范围的字母[ymdhi]组合.组合长度为: 3 ~ 8个字符. logrand = ymdhi则表示:两位数的年份 + 两位数的月份 + 月份中的第几天(两位数) + 两位数的小时(12小时制) + 两位数的秒. 完整登录路径例子为: https://www.candbox.site/portal-2002091106


#例如动态时间路径设置为:logrand = ymYM则表示:两位数的年份 + 两位数的月份 + 四位数的年份 + 字母表示的月份. 例如: portal-20032020Dec. 注意: 你需要设置正确的时区在首页文件index.php中. 不同时区会影响登录时间路径的准确性.


#指定范围的字母[ymdhi]大小写有不同的输出结果. 解释如下:


#y:2 位数字表示的年份 例如: 99 或 03


#Y:4 位数字完整表示的年份 例如: 1999 或 2003


#m:数字表示的月份,有前导零 01 到 12


#M:三个字母缩写表示的月份 Jan 到 Dec


#d:月份中的第几天,有前导零的 2 位数字 01 到 31


#D:星期中的第几天,文本表示,3 个字母 Mon 到 Sun


#h:小时, 12 小时格式,有前导零 01 到 12 


#H:小时, 24 小时格式,有前导零 00 到 23


#i:有前导零的分钟数 00 到 59, 注: i只有小写.

manager = portal

#管理员登录后的后端路径名称.仅支持字母数字,长度为: 2 ~ 20 字符. 错误设置将不能访问后端管理功能. 提示: 登录路径与登录后的路径应不相同.

seccode = abc

#管理员的OTP码,值为16为的字母数字且为大写. 必须使用管理员工具设置并同步更新数据库有效.

logstns = true

#管理员是否允许登录.设置logstns = false时, 管理员不能登录.

master = admin@candbox.site

#管理员邮箱, 用于接收登录错误提示以及测试邮箱用途.

[member]

#顾客参数配置

maxaddr = 3

#登录顾客最大地址簿数量,值范围为: 1 ~ 10, 错误设置将使用内置默认值3.

maxkeep = 100

#登录顾客的收藏夹物品的最大数量,值范围为: 1 ~ 1000, 错误设置将使用内置默认值10.

regrate = 60

#新用户注册间隔时间, 值范围为: 1 ~ 86400. 错误设置将使用内置默认值100.

fograte = 600

#密码找回间隔时间, 值范围为: 1 ~ 86400, 错误设置将使用内置默认值100.

emscycle = 120

#邮箱验证码间隔时间, 值范围为: 1 ~ 3600, 错误设置将使用内置默认值100.

emccycle = 120

#邮箱修改间隔时间, 值范围为: 1 ~ 86400, 错误设置将使用内置默认值100.

amazon = true

#amazon登录是否有效,设置amazon = false时, amazon功能无效.需手工删除或添加到模板.

facebook = true

#facebook登录是否有效,设置facebook = false时, facebook功能无效. 需手工删除或添加到模板.

google = true

#google登录是否有效,设置google = false时, google功能无效.需手工删除或添加到模板.

instagram = true

#instagram登录是否有效,设置instagram = false时, instagram功能无效.需手工删除或添加到模板.

linkedin = true

#linkedin登录是否有效,设置linkedin = false时, linkedin功能无效.需手工删除或添加到模板.

wechat = true

#wechat登录是否有效,设置wechat = false时, wechat功能无效.需手工删除或添加到模板.

vkontakte = true

#yandex登录是否有效,设置vkontakte = false时, vkontakte功能无效.需手工删除或添加到模板.

[email]

#订单邮件服务器配置, 注: candbox购物车不支持aliyun解析的任何域名邮箱,以及cn后缀的邮箱.

emhost = mail.candbox.site

#订单邮件服务器主机名称

emport = 25

#订单邮件服务器范围端口, 该值仅为数字.

secure = false

#订单邮件服务器是否使用安全认证

emauth = ssl

#订单邮件服务器安全认证方式,值为ssl或tls

emuser = noreply@candbox.site

#订单邮件服务器登录帐户名称

empass = a1c0B1

#订单邮件服务器登录帐户密码,密码必须含有字母数字

emords = order@candbox.site

#订单邮箱,接收订单通知用途.

emname = Candbox

#订单类邮件发送者名称

emfrom = info@candbox.site

#订单邮件发送者邮箱

[bmail]

#商务邮件服务器配置, 注: candbox购物车不支持aliyun解析的任何域名邮箱,以及cn后缀的邮箱.

emhost = mail.candbox.site

#商务邮件服务器主机名称

emport = 25

#商务邮件服务器范围端口, 该值仅为数字.

secure = false

#商务邮件服务器是否使用安全认证

emauth = ssl

#商务邮件服务器安全认证方式,值为ssl或tls

emuser = noreply@candbox.site

#商务邮件服务器登录帐户名称

empass = a1c0B1

#商务邮件服务器登录帐户密码,密码必须含有字母数字

emname = Candbox

#商务邮件发送者名称

emfrom = info@candbox.site

#商务邮件发送者邮箱

[payment]

#支付发送配置

bank = true

#银行支付方式,此方式属于线下支付.仅用于登录顾客下单选择. 由人工确认支付状态. 通常用于预订产品或未开头在线支付时使用.

cod = true

#货到付款支付方式,此方式属于线下支付.仅用于登录顾客下单选择. 由人工确认支付状态. 通常用于预订产品或未开头在线支付时使用.

paypal = true

#使用paypal最新支付接口. 支持用户不登录,不输入任何信息完成订单支付.设置paypal = false时将不能完成在线支付.

stripe = true

#该支付接口未实现. 暂时不能使用。

[paypal]

#paypal支付参数配置

clientid = abc

#paypal支付用户id

clientsecret = abc

#paypal支付用户密钥

hookpath = abc

#paypal支付后端通知路径, 仅支持字母数字,长度为: 2 ~ 20 字符. 错误设置将不能完成订单生成数据. 必须同步设置paypal端保持相同路径.

hookcode = abc

#paypal支付用户密钥

mode = sandbox

#paypal支付模式,设置mode = live时为正式支付模式, 设置mode = sandbox表示测试支付模式.

[stripe]

#该支付暂时未实现,暂时不能使用

clientid = abc
clientsecret = abc
hookpath = abc
hookcode = abc
mode = sandbox
[shipping]

#该内置运输方式及报价配置

dhl = true

#设置dhl = false时,该运输方式无效.

ems = true

#设置ems = false时,该运输方式无效.

eub = true

#设置eub = false时,该运输方式无效.

fedex = true

#设置fedex = false时,该运输方式无效.

free = true

#设置free = false时,该运输方式无效.

hke = true

#设置hke = false时,该运输方式无效.

oth = true

#设置oth = false时,该运输方式无效.

pik = true

#设置pik = false时,该运输方式无效.

sfe = true

#设置sfe = false时,该运输方式无效.

ups = true

#设置ups = false时,该运输方式无效.

[amazon]

#amazon登录API配置

appid = abc
secret = abc
[facebook]

#facebook登录API配置

appid = abc
secret = abc
[google]

#google登录API配置

appid = abc
secret = abc
[instagram]

#instagram登录API配置

appid = abc
secret = abc
[linkedin]

#linkedin登录API配置

appid = abc
secret = abc
[wechat]

#wechat登录API配置

appid = abc
secret = abc
[yandex]

#yandex登录API配置

appid = abc
secret = abc
注意事项

配置文件参数内容中含有字符: on, off, !, #, %, - 时需要使用单引号或双引号进行标注. 否则网站不能访问.

Candbox配置文件注意事项

Candbox配置文件是网站唯一需要配置的文件。应该在本地电脑做好备份。例如以时间命名的文件夹进行保存。

配置文件中的参数列表顺序不要轻易调整，否则网站不能运行。同时还应注意以下问题：

  • 不要分享你的配置文件，防止他人利用配置文件的参数。
  • 不要把配置文件的备份保存在服务器端，避免意外丢失而不能找回。
  • 修改配置文件时，应严格参考参数说明进行设置。

查看管理手册