osCommerce大中华版安装指南

作者:徐文达<maxidea@maxidea.org>

最后更新:2007610

osCommerce大中华版网址:www.MaxCapture.com/business/oscommerce.html

本文基于《GNU 自由文档许可证》发布,可自由地原封不动地拷贝,许可证内容详见http://fsf.cosoft.org.cn/licenses/fdl.cn.txt

本文的文字部分的最新更新后的版本以www.maxidea.org为准。


引言:

osCommerce是自由软件社区最受欢迎的网络商店系统之一,海外和台湾地区都有大量的自愿者在进行开发和贡献,唯中国国内只有少量的和基于早期版本osCommerce开发的简体中文版本的源代码公开,而且都缺少目前最流行的STSAddImage功能。为此,我们发布了公开源代码的osCommerce大中华版,希望更多的软件开发者、爱好者、企业的软件工作人员能更进一步了解自由软件的文化,甚至能利用自由软件来提高生产效益。

osCommerce大中华版(最新版本是2006)是在osCommerce 2.2 Milestone 2基础上,加入简体中文、繁体中文和日文语言支持,同时加入的功能还有:后台管理密码保护功能、产品介绍页的多图片功能、简单模板系统(STSSimple Template System,使用户可以方便快速地自行定制页面效果)和MaxCapture的两套标准STS模板。

osCommerce大中华版是目前最开放、性价比最高的网络商店系统,能帮助您更快速地开发或开展业务。


目录:

osCommerce大中华版安装指南 1

osCommerce简介 2

一、osCommerce是什么? 2

二、osCommerce有哪些功能? 2

三、osCommerce大中华版有哪些额外功能? 3

四、哪里能看到osCommerceDemo呢? 4

五、怎样才能获得osCommerce呢? 4

osCommerce大中华版安装过程 5

一、系统要求 5

二、快速安装(使用安装向导) 5

三、手动安装 10

四、升级安装 10

五、STS的模板设置 11

常见问题解答 15

一、前台设置问题 15

二、后台设置问题 16

三、服务器设置相关问题 17

程序更新及BUG修正 20

感 谢 22


osCommerce简介

一、osCommerce是什么?

osCommerce Open Source e-Commerce 的缩写,就字面意义看,很清楚可以知道它是一个架构在开放源代码的购物系统。

osCommerce 融入了开放源代码解决方案(open source solutions),使用强大的 PHP 网页描述语言、稳定的 Apache 网页主机(web server)以及快速的MySQL数据库主机(database server)为基础,提供一个完全免费和开放的购物开发平台

虽然如此, osCommerce 的运作却没有太多限制或特殊需求,它可以安装在任何 PHP3PHP4 的网页主机,或是任何支持 PHP MySQL 的环境,其中包括 LinuxSolarisBSDMicrosoft Windows 等环境,并且让商店拥有人以用最少的人力及最低的成本设立、营运以及维护自己的线上购物商店。


二、osCommerce有哪些功能?

标准功能

PHP3/PHP4 兼容

安装容易、可立即使用

模块化

多国语系:英文、德文、西班牙文以及世界各国自制的语系。


前台

客户会员功能

客户通讯簿

订单纪录

提供暂存(未登入时)和永久(登入时)的购物车

产品及制造商搜寻功能

提供客户评论商品

电子邮件通知功能(可用于交易处理,客户沟通及发广告信,期刊)

简洁的结帐手续

可使用 SSL 安全网上交易

可显示每一商品目录内的商品数量

支持多国货币及自动汇率计算

最受欢迎产品统计

可以显示其它客户购买商品(建议购买清单) 等等


后台

每日24小时,随时登入管理产品目录

随时浏览交易及详细客户资料

友善的操作接口

可新增/编辑/移除 商品分类、商品、制造商、客户和商品评论

无限层的产品目录结构

多项商品和客户统计资料

动态商品属性

提供税区、税别及税率设定

可远程编辑数据库内之设定参数值

前后台可分开置于不同主机

提供付款及运送模块

做为跨国商店时,可连结到 oanda.com 交换汇率

可自订商品排序及列表方式

提供可控制的备份工具 等等

三、osCommerce大中华版有哪些额外功能?

osCommerce大中华版2006是基于osCommerce 2.2 Milestone 2开发的,完全兼容osCommerce所有插件,并比osCommerce2.2 Milestone 2多出以下功能:


后台管理密码保护功能

大中华区语言支持(包含简体中文、繁体中文和英语)

预设人民币和港币自动换算(用户可自行添加其他货币)

产品介绍页的多图片显示功能(后台已增加相应的控制项目)

预装简单模板系统(Simple Template System,使用户可以方便快速地自行定制页面效果)

MaxCapture的两套标准STS模板

专用版PayPal IPN付费接口程序


osCommerce大中华版2006本身都可以作为OsCommerce的模版使用,使您的购物站点能因应商品特色而更换设计和主题。目前国外已经有大量的专业公司为OsCommerce生产商用的页面模版,如http://www.oscoders.bizhttp://www.algozone.com,售价一般从50美金到250美金不等,它们都可以使用在osCommerce大中华版上。当然,STS也使您可以自行设计模板用作商业或个人使用。

总的来说,所有版本的osCommerce大中华版2006都提供了大量额外功能,这使用户能方便地建设网络商店而无须要面对修改源代码困难;而高级用户或开发者更能利用osCommerce大中华版快速开发更强大的网络商店系统或更漂亮的网页模板,而无须投入大量时间重复底层开发,节省大量开支。这也正是我们一直努力推广自由软件,促进软件业快速发展的原因。

四、哪里能看到osCommerceDemo呢?

目前国外、香港、台湾都已经有大量的网络商店基于osCommerce来建造,真实的例子:

远望Eshop(简体中文,版本不明,没有STSAddImage):

http://shop.pcshow.net/

爱派乐购(简体中文,版本不明,有AddImage,没有STS):

http://www.ipodrock.com/

玩具狂人(简体中文,版本不明,有STSAddImage,以及一套自行开发的模板):

http://www.cstoyz.com/


DEMO

osCommerce 2.2 Milestone 2原版官方站点DEMO(英文):

http://www.oscommerce.com/osCommerce22ms2/


osCommerce大中华版2006(简/繁体中文/英文/日文,有AddImageSTS功能和MaxCapture的两套标准STS模板,便于即装即用):

http://www.maxcapture.com/store4/catalog


浏览另一个STS外观模板请访问这个地址

http://www.maxcapture.com/store5/

五、怎样才能获得osCommerce呢?

osCommerce英文原版是自由软件,我们可以从其官方网站下载:http://www.oscommerce.com

osCommerce大中华版2006也以自由软件发布,但目前未能提供FTP下载,用户可以通过www.MaxCapture.com ,以极其低廉的价格购买到含完整的源代码光盘。


osCommerce大中华版安装过程

一、系统要求

这里我们以osCommerce大中华版2006为例(含简/繁体中文/英文/日文,有AddImageSTSMaxCapture的两套标准STS模板),介绍osCommerce大中华版的安装过程。

osCommerce大中华版默认设置是以GNU/LinuxUnix系统的路径及权限为标准的,当然,您只需稍作修改,也可以把它安装到Windows+PHP+ApacheIIS的环境中。

如果您想在LinuxUnix主机上安装osCommerce大中华版,请必须确认您的Apachehttpd)、PHPPerlMySQL都已经安装并运行起来了。至于这几个软件的安装方法,您可以很容易在网上找到。


二、快速安装(使用安装向导)

快速安装是针对第一次使用osCommerce大中华版的用户而设,用户可以通过简单的步骤完成安装过程,而无需过多地对主机进行设置。

1、解压文件包

A) 直接在Linux主机上解压:

运行命令:

unzip OSC-2.2ms2-GreaterChina2006.zip (对于zip文件)

tar -xzf OSC-2.2ms2-GreaterChina2006.tar.gz (对于tar.gz文件)

B) windows下解压,请使用最新版本的winzipwinrar.


2、拷贝目录catalog到您的站点WWW根目录下

A) Linux下:

cd OSC-2.2ms2-GreaterChina2006

cp -R catalog /usr/local/apache/htdocs/

(高级话题:在这个例子里,我们以WWW的站点根目录/usr/local/apache/htdocs/为例,但用户的WWW站点根目录由您的主机实际设置情况所决定,具体请查阅Apache的设置文件/etc/httpd/httpd.conf,或咨询您的主机管理人员;如果您使用的虚拟主机无法使用命令行操作,请先把文件在Windows下解压,然后再用FTP上传到您的站点WWW根目录下。)

B) Windows下:

通过FTPcatalog目录上传到您的站点WWW根目录下。


3、修改文件和目录访问权限

Linux系统环境下,必须正确设置部分文件和目录权限,以便正确进行安装。当然,如果您忘记预先进行设置,在安装过程中我们的程序还是会提醒您的。

把以下文件的权限设为666

./catalog/include/configure.php

./catalog/admin/include/configure.php

把以下文件的权限设为777,以用于写入文件:

./catalog/admin/backups/.

./catalog/images

如果你把osCommerce大中华版安装于MS Windows上,则无须做此步。


以命令行方式修改:

cd /usr/local/apache/htdocs/

chmod 666 ./catalog/include/configure.php

chmod 666 ./catalog/admin/include/configure.php

chmod 777 ./catalog/admin/backups/

chmod 777 ./catalog/images

此步骤也可以用FTP软件完成,Linux上的权限设置问题,请参阅网上相关的文章。


4MySQL的设置

您必须在运行安装向导程序之前在MySQL中创建一个空的数据库,名字不限,可以设置为“OSC_GreaterChina”或其他。

如果您对命令行下的MySQL管理不熟悉,建议您在Linux服务器上安装一个MySQL的网页管理界面工具phpMyAdmin,使用十分简单方便,详细使用和安装方式请联系您的主机管理员或参阅http://www.phpmyadmin.net


5、运行安装向导程序

A) 打开网页浏览器,并输入如下地址:

http://[your site]/catalog/install

[your site]”以您主机的真实域名替换,例如localhost, http://lcalhost/catalog/install

请注意,安装向导界面将统一使用简体中文版本。

您将见到如下的安装欢迎页面:

B) 点击Install图标,进行第一次安装(请注意,旧版本的osCommerce大中华版标准版本提供的“升级向导”功能,在osCommerce大中华版2006中将不再提供,原因是由于大中华版2006加入了STS功能并修改大量的页面,除部分数据库结构外,其他均与旧版本有较大区别,直接使用升级向导升级可能会导致小部分页面出错,所以只提供了第一次安装模式。但如果使用清洁的第一次安装,均不会出现任何问题。)

为免安装出错,请先备份旧系统,并把旧系统文件夹改名。如果使用osCommerce大中华版2006升级旧版本的osCommerce大中华版STS-baseSTS-MAX,也应先进行备份再作覆盖安装。

C) 选择“导入数据库”和“自动设定”两项,并点击“继续”:

D) 根据您的主机实际情况,或根据主机管理员为您做的数据库设定资料,填写对应的数据库主机名、数据库访问用户名、数据库访问密码、数据库名称等项目。如果您的主机非独立的主机,最好不选择保持连接,因为这样会使主机的负荷增加。Session(对话,PHP中保持用户登陆状态的信息)可以选择保存在数据库上(如使用Windows主机必须选择保存在数据库上):

E) 提示即将自动导入对应的MySQL数据库表(所有osCommerce大中华版2006已提供正确的数据库表,在./catalog/install/下面,安装程式已预设该路径),请确认:

F) 导入成功:

G) 确认安装目录资料,此次将写入另一个配置文件,请在此步确认是否使用SSL(安全的网页信息加密,但您的主机必须已安装SSL。使用SSL后,访问您的网上购物站点必须使用https):

H) 再次确认数据库资料:

如果您的./catalog/include/configure.php./catalog/admin/include/configure.php读写权限设置不当,您将获得一个警告页面:

按照提示修改读写权限后,按“重试”即可安装成功:

I) 点击“前台”将看到已经安装后的网络商店主页,点击右下角的中国国旗标志,可切换到简体中文界面;点击香港特区区旗,可得到繁体中文界面;英国国旗则是英文界面;日本国旗就是日文界面。页面上的红色区域是提示您./catalog/include/configure.php./catalog/admin/include/configure.php读写权限需改回644的只读模式,修改正确后红色区域将自动消失。

J) 点击“后台管理工具”将进入管理界面,由于osCommerce大中华版增加了后台管理密码保护功能,这里需要有管理员密码才能登陆。如果您是第一次使用后台管理模式,管理界面将根据您的浏览器语言版本自动选择语言,您有可能见到英文版本的后台登陆界面。不用担心,当您成功登陆并选择后台管理语言后,以后的登陆界面都会按照您的习惯自动进行修正。

osCommerce大中华版2006默认的管理员邮箱是support@maxcapture.com,管理员密码是admin在修改管理员邮箱前,请不要使用忘记密码功能,否则您的新密码将寄到support@maxcapture.com去了:)

后台管理的功能十分强大,请用户在您的网络购物站点投入正式使用前必须要做测试,以免出现操作错误。

由于我们预设的部分数据库资料是以简体中文为标准,所以如果您正在使用英文、繁体中文或日文的后台界面,部分页面可能会出错或乱码。


K) 如果您获得的是osCommerce大中华版2006(或STS-base,或STS-MAX),简单模板系统将在安装向导过程中自动安装成功。您会获得一个预设的页面模板:./catalog/includes/sts_template.html。更多关于STS的知识请见以下文件:./catalog/includes/sts_templates/README.txt。对于STS的进一步修改和设定,我们将在后文中介绍。


三、手动安装

手动安装适合高级用户使用,便于开发用户进行测试。

1、创建数据库并导入数据库表

用户可根据实际情况,直接使用MySQL命令或phpMyadmin进行操作。命令行下的操作如下,例如我们要建立的数据库名字为OSC_CreaterChina

mysqladmin create OSC_CreaterChina

mysql OSC_GreaterChina < ./install/OSC-2.2ms2-GreaterChina-AddImages.sql

如果您需要检查数据表是否成功被导入,您可以使用mysqlshow把它们给列出来:

mysqlshow OSC_CreaterChina


2、修改配置文件

手工修改以下两个配置文件,具体的设置方式在文件里面有注释说明:

./catalog/includes/configure.php

./ catalog/admin/includes/configure.php


四、升级安装

1、从osCommerce2.0以前版本升级到osCommerce大中华版标准版本

请直接使用osCommerce大中华版标准版本安装向导中的升级功能完成,该升级向导为英文界面。(建议:为避免升级过程中出错,用户应在升级前备份原始版本的文件和数据库)


2、从osCommerce大中华版标准版本升级到osCommerce大中华版STS-base版本

A) osCommerce大中华版STS-base./catalog/includes/目录复制以下文件,并替换原来的标准版./catalog/includes/下的文件(请注意,别错误地把文件拷进./catalog/admin/includes/):

application_top.php

header.php

column_left.php

column_right.php

footer.php

application_bottom.php

sts_start_capture.php

sts_stop_capture.php

sts_restart_capture.php

sts_display_output.php

sts_user_code.php

sts_template.html


B) 标准版./catalog/includes/configure.php文件中的最后一行“?>”前加入以下程序:

// STS: ADD: Define Simple Template System files

define('STS_START_CAPTURE', DIR_WS_INCLUDES . 'sts_start_capture.php');

define('STS_STOP_CAPTURE', DIR_WS_INCLUDES . 'sts_stop_capture.php');

define('STS_RESTART_CAPTURE', DIR_WS_INCLUDES . 'sts_restart_capture.php');

define('STS_TEMPLATE_DIR', DIR_WS_INCLUDES . 'sts_templates/');

define('STS_DEFAULT_TEMPLATE', DIR_WS_INCLUDES . 'sts_template.html');

define('STS_DISPLAY_OUTPUT', DIR_WS_INCLUDES . 'sts_display_output.php');

define('STS_USER_CODE', DIR_WS_INCLUDES . 'sts_user_code.php');

define('STS_PRODUCT_INFO', DIR_WS_INCLUDES . 'sts_product_info.php');

// STS: EOADD


3、从osCommerce大中华版STS-base版本升级到osCommerce大中华版STS-MAX版本

  1. 拷贝STS-MAX版本的./catalog/stylesheet.css文件,并覆盖STS-base的对应文件。

B) STS-MAX./catalog/includes/目录复制以下文件,并覆盖STS-base的对应文件:

footer.php

header.php

sts_display_output.php

application_top.php

sts_template.html


C) 复制并替换./catalog/includes/languages/english/images/整个文件夹。

D) 复制并替换./catalog/includes/classes/boxes.php文件。

E) 复制并替换./catalog/includes/boxes/categories.php文件。

F) 复制并替换./catalog/images/整个文件夹。


4、从osCommerce大中华版的各种版本升级到osCommerce大中华版2006

备份原系统数据和页面文件后进行覆盖安装,同时在后台启用日文语言包及PayPal IPN


五、STS的模板设置

osCommerce大中华版2006,以及以往的STS-base版本和STS-MAX版本均集成了简单模版系统(STS),这不但免除用户自行安装STS时出现的困难和问题,同时也使开发者和高级用户快速修改整个站点风格或开发网页模板成为可能。原版的英文说明书在./catalog/includes/sts_templates/README.txt


1STS的作用

STS的主要功能是使站点管理人员能够通过修改简单的模板文件,而对osCommerce的外观进行高质量的修改。使用STS后,我们只需要修改模板文件上的placeholders(占位符),就能使站点产生与别人不同的外观。如配合图片使用,那效果将更加出色。

例如,您需要修改购物车显示位置,只需要移动 “$cartbox” ;当您要把主页上的消息放在醒目的位置,只需要移动“$content”,等等。

安装好osCommerce大中华版的STS-base版本和STS-MAX版本后,您会看到STS-baseSTS的默认配置状态,页面上除了用STS重新做排版外,未做任何人工修饰,这利于二次开发;而STS-MAX以及osCommerce大中华版2006就是经过细心修饰的STS产品,便于用户立即投入使用。

STS-base有很明显的表格组成,便于开发者或高级用户修改)


STS-MAX使用修改过的模板,便于立即投入使用和参考开发)


2STS的模板

STS能支持多重模板,功能如下:

A) 默认的站点模板./catalog/includes/sts_template.html

B) 默认的类别(category)模板:. /catalog/includes/sts_templates/index.php.html

C) 主目录页面(cPath=0)的模板:. /catalog/includes/sts_templates/index.php_0.html

D) 其他目录页面(cPath=XX_YY)的模板:. /catalog/includes/sts_templates/index.php_XX-YY.html (这里的XX_YY是指cPath=XX_YY,其数据根据目录的网址URL确定)

E) 商品信息模板./catalog/includes/sts_templates/product_info.php.html,您可以利用product_info模板的变量(将在下文列出)来对您的product_info页面进行排版。但osCommerce大中华版的用户需要注意,由于AddImage(多图显示功能)的product_info页面与STSproduct_info模板变量不兼容,使用product_info模板后将无法使用AddImage

另外,STS-MAXSTS-base目前只使用了sts_template.html,其他模板用户可以自行编写或在网上寻找。


3、最简单的修改STS方式

只需修改./catalog/includes/sts_template.html文件,定制各表格和位置分布即可得到不同的显示效果,配合stylesheetCSS)使用会更加出色。


4、使用多重模板文件

您可以根据被执行的scriptPHP文件)来创建一些多重模板文件。例如,我们为“index.php”定制一个模板应为:./catalog/includes/sts_templates/index.php.html。如果定制的模板文件不是为当前的script所定义的,它将以STS_DEFAULT_TEMPLATE文件替代。


5、使用多重目录模板

您可以为单个或全部目录定制模板,如果选择适当的文件,请参阅“五-3”


6、使用product_info模板

您可以为您的产品信息页面定制$CONTENT区域的模板,设计出漂亮排版,只需要创建文件./catalog/includes/sts_templates/product_info.php.html,我们为您准备了一个例子在./catalog/includes/sts_templates/里面。但请您注意,使用product_info模板后将无法使用AddImage(请参阅“五-3”)。


7、支持的模板标签(TAGS

$headcontent: 把这行加入到您的源代码的<head>区域,它能插入动态的网页头内容(the dynamic head content)和javascript。(如果需要在页头加一些注释而不显示在页面上,可以这样写:<!--$headcontent-->;但不要把<title>...</title>放入页头,否则它会变成$headcontent变量的一部分;

$cataloglogo: logo标志和链接;

$urlcataloglogo: $cataloglogo所对应的URL

$myaccountlogo: “我的帐号”图片和链接;

$urlmyaccountlogo: “我的帐号”的功能链接;

$cartlogo: “购物车”图片和链接;

$urlcartlogo: “购物车”的功能链接;

$checkoutlogo: “结算” 图片和链接;

$urlcheckoutlogo: “结算”的功能链接;

$breadcrumbs: 页顶的"Top > Catalog > whatever..."路径显示文字和链接;

$myaccount: 文字格式的“我的帐号”和链接. 如果已经登陆,将会变成"Logoff"

$urlmyaccount: “我的帐号”的URL

$logoff: “Logoff”的文字和链接;

$urllogoff: “Logoff”URL

$myaccountlogoff: 如果已经登陆,显示“我的帐号 | Logoff”,如果未登陆,则显示“我的帐号”;

$cartcontents: “购物车内容”文字显示;

$urlcartcontents: “购物车内容”的URL

$checkout: 文字格式的“结算”;

$urlcheckout: “结算”的URL

$categorybox: 显示类别的方格;

$manufacturerbox: 显示厂商的方格;

$whatsnewbox: 显示新品上架的方格;

$searchbox: 显示搜索工具的方格;

$informationbox: 显示信息的方格;

$cartbox: 显示购物车的方格;

$maninfobox: 显示厂商信息的方格 (如果为空就不显示在页面上)

$orderhistorybox: 定单历史的方格 (如果为空就不显示在页面上,例如用户未登陆)

$bestsellersbox: 显示畅销商品的方格;

$specialfriendbox: 其他专门的方格或“推荐给朋友”方格 (根据页面视图而定)

$reviewsbox: 显示评论的方格;

$languagebox: 显示语言选择的方格;

$currenciesbox: 显示流通货币选择的方格;

$content: 页面的主内容 (在页面中间)

$date: 当前时间;

$numrequests: 显示从建站起的浏览次数;

$counter: 页面浏览计数器;

$footer: footer.php的页脚输出;

$banner: footer.phpbanner广告条;

$sid: Session IDstring "SessionIdVarName=WhateverTheSessionIdIs"格式显示;

$urlcat_Category_Name: 商品目录的URL链接,商品目录名中的空格必须以下划线替代。例如,目录“Video Cards”的链接您所使用模板变量是 $urlcat_Video_cards,由于变量名不分大小写,您可以随便使用大写或小写字母;

$urlcat_x_y_z:使用cPath stringURL和目录链接起来;

$cat_Category_Name: $urlcat_Category_Name一样;

$cat_x_y_z: $urlcat_x_y_z一样;

$catmenu: 一个下拉型的目录菜单 (使用sts_user_code.php进行定义)


8、支持的PRODUCT_INFO模板标签

如果你使用了Product_Info模板,这些标签能用来代替. /catalog/includes/sts_templates/product_info.php.html文件中的$content变量。

$startform: 目录中的第一个项目;

$endform: 目录中的最后一个项目;

$productname: 商品名字;

$productmodel: 商品型号或空格;

$productdesc: 商品描述;

$imagesmall: 商品的缩图,大小由后台管理定制;

$imagelarge: 商品的大图(图片真实尺寸);

$optionheader: “可用到的选项”的文字,如果没有设置则留空;

$optionames: 选项列表,名字,以换行符分隔 ("<br>"),如果没有设置则留空;

$optionchoices: 选项列表下拉菜单,以换行符分隔,如果没有设置则留空;

$moreinfolabel: TEXT_MORE_INFORMATION的值,链接到一个详细介绍页面;

$moreinfourl: 更多信息的URL

$productdatelabel: 包含上架日期和可用日期等信息的指定语言;

$productdate: 上架日期或可用日期;

$reviews: 对商品的评论数目;

$reviewsbutton: 发表评论的按钮;

$reviewsurl: 发表评论的URL


9、页头LOGO的修改

A) 对于osCommerce大中华版标准版本logo文件于./catalog/images/oscommerce.gif,文字描述和图片地址在./catalog/includes/header.php文件中,修改下面粗体字部分即可,“oscommerce.gif是文件名,“osCommerce是文字描述:

<td valign="middle"><?php echo '<a href="' . tep_href_link(FILENAME_DEFAULT) . '">' . tep_image(DIR_WS_IMAGES . ' oscommerce.gif', 'osCommerce') . '</a>'; ?></td>


B) 对于osCommerce大中华版STS-baseSTS-MAX2006logo文件于./catalog/images/logo.jpg,文字描述和图片地址在./catalog/includes/sts_display_output.php文件中,修改下面粗体字部分即可,“logo.jpg”是文件名,“osCommerce Greater China Version是文字描述:

$template['catalog '] = '<a href="' . tep_href_link(FILENAME_DEFAULT) . '">' . tep_image(DIR_WS_IMAGES . 'logo.jpg', 'osCommerce Greater China Version') . '</a>';


常见问题解答

一、前台设置问题


Q:如何使页面在1024x800的分辨率下以居中显示呢?

A:对于STS-baseSTS-MAX版本的osCommerce大中华版,可以修改为居中页面显示,您可以修改模板文件./catalog/includes/sts_template.html的页面设计而改变整个表格的显示方式,基本做法是把构成页面的表格居中。


Q:如何修改“服务台”栏目中的各信息项目的内容?

A:对于osCommerce中“服务台”栏目中的各信息项目的内容修改,用户可根据下面的资料修改对应的PHP文件内容,然后通过FTP覆盖愿文件;也可以直接使用“后台管理”中的“系统工具”->“语系定义”来直接在线修改对应的文件,但必须预先设定这些文件权限为666

“退换货事项”:./catalog/includes/languages/schinese/shipping.php

“隐私权保护声明”:./catalog/includes/languages/schinese/privacy.php

“会员权益及须知”:./catalog/includes/languages/schinese/conditions.php

“联络我们”:./catalog/includes/languages/schinese/contact_us.php


Q:如何修改页面下方的版权信息?

A:只需修改每种语言下对应的schinese.phptchinese.phpenglish.php即可,全部页面都会自动更新;例如简体中文版我们可以修改修改文件./catalog/includes/languages/schinese.php;对于osCommerce大中华版STS-MAX,该文件第345行就是版权信息的定义代码。但如果您需要把页脚改得更花俏,最好就使用IFRAME页面连接,把对应的PHP文字部分替换掉,您也需要额外设计一个页面用于套入IFRAME中,下次您要修改页脚,只需修改该页面就可以了。


Q:如何修改首页的文字信息?

A:关于修改OSC首页的问题,请用PHP编辑器修改如下文件:./catalog/includes/languages/schinese/index.php。对应不同语言的首页,也要修改对应语言包下的index.php

用户也可以直接使用后台管理中的“系统工具”->“语系定义”来直接在线修改对应的文件,但必须预先设定这些文件权限为666


Q:默认语言是繁体中文的情况下,添加商品后,最后显示的上架日期竟然是中英文结合的,怎么解决?例如:本商品上架日期:2006September13Wednesday.

A:修改catalog/includes/languages/tchinese.php,把第24行,改为:

@setlocale(LC_TIME, 'zh_TW');

即可。


二、后台设置问题


Q:如何调整汇率?

A:港币的汇率已预设定好了,用户可在后台管理中“本地化设定”->“货币设定”中进行修改。


Q:如何修改默认的语言和货币类型?

A:修改默认的语言和货币,请在“系统设定”->“模组选项”里修改。


Q:为什么不能直接选择相应国旗后自动调整相应货币?

A:目前系统不能随意指定一个货品的各种货币价格的,只能通过汇率进行自动换算;暂时也无法实现在切换语言时自动切换货币类型,但我们会在以后继续开发这一功能。


Q:后台管理员密码修改后不能进入怎么办?

A:密码是有区分大小写的,在后台“我的帐号”里可以修改的,记得修改前把管理员的email地址改成您自己的,同时密码应大于5位;每次修改后您都会收到一封EMAIL通知,同时您可以用后台登陆页面上的“忘记密码”功能找回密码。


Q:在哪里增加更多图片?图片的大小有规定吗?多大的规格和比例会比较好?

AAddImage功能就在进入物品的详细编辑画面前的选中状态的右下方,点击“增加”图片即可。AddImage的预览图片(新图片)要求以150x120px(大于或小于也没有关系,系统会自动缩放),弹出图片会显示完整的图片大小,弹出图片和预览图可以是两张不一样的图片。


Q:如何修改用户注册自动确认信的内容?

A:用户需要修改自动确认信的内容,只需修改对应语言包内的文件:./catalog/includes/languages/schinese/create_account_process.php。或这直接使用“后台管理”中的“系统工具”->“语系定义”来在线修改对应的文件,但必须预先设定这些文件权限为666

同时,你需要在“系统设定”->“我的商店”填写对应的寄件人名称、商店名称、电子邮件等项目,那么EMAIL里的邮件地址就会自动变成您指定的了。


Q:如何修改后台管理admin文件夹的路径?把admin改名后不能使用?

AosCommerce大中华版的后台使用了密码保护功能,但如果修改后台管理登陆的路径就会更加安全,修改方法如下:

先修改./catalog/admin/includes/configure.php中的对应的admin路径,例如原文件:

define('DIR_WS_ADMIN', '/catalog/admin/'); // absolute path required

define('DIR_FS_ADMIN', '/home/httpd/www/catalog/admin/'); // absolute pate required

admin文件夹的名字为您需要的,例如admin2

define('DIR_WS_ADMIN', '/catalog/admin2/'); // absolute path required

define('DIR_FS_ADMIN', '/home/httpd/www/catalog/admin2/'); // absolute pate required

最后通过FTP或终端把admin文件夹改名为admin2即可。


三、服务器设置相关问题


Q:运行osCommerce大中华版页面出现“Warning: session_save_path(): SAFE MODE Restriction in effect. The script whose uid is XXX is not allowed to access owned by uid 0 in /XXX/catalog/includes/functions/sessions.php on line 118”,需要如何处理?

A:这是由于服务器的PHP4的设置中把“safe_mode”的“Local Value”和“Master Value”设为“ON”了。我们需要通过以下方式修改:

修改文件./catalog/includes/functions/sessions.php,把tep_session_save_path的功能关闭(注意要保留“function tep_seesion_save_path($path = “) {}”):

function tep_session_save_path($path = '') {

/* ##disable for PHP safe_mode ON

if (!empty($path)) {

return session_save_path($path);

} else {

return session_save_path();

}

*/

}

(使用该修改方法建议您同时使用MYSQL来保存Session。)


Q:修改configure.php权限为644后,页面上仍然出现红色警告信息,该如何处理?

A:这是由于用户的服务器的PHP编译时没有加入部分功能支持所造成,但不影响osCommerce的运行。

对于configure.php的权限判断,其实来源于文件:./catalog/includes/header.php,如用户遇到上述问题,最理想的修正方法是,在确认configure.php已被修改为644后,把header.php中的判断configure.php权限的功能关掉:

// check if the configure.php file is writeable

####下面被屏蔽掉的原句,再下面的是修改后的,差别在于false是把对configure.php的权限判断功能关掉,ture是打开:

#### if (WARN_CONFIG_WRITEABLE == 'true') {

if (WARN_CONFIG_WRITEABLE == 'false') {

if ( (file_exists(dirname($HTTP_SERVER_VARS['SCRIPT_FILENAME']) . '/includes/configure.php')) && (is_writeable(dirname($HTTP_SERVER_VARS['SCRIPT_FILENAME']) . '/includes/configure.php')) ) {

$messageStack->add('header', WARNING_CONFIG_FILE_WRITEABLE, 'warning');

}

}


Q:为什么系统文件的权限有的是644,有的是755,有的是777

A:把目录的访问权限设置成777是因为让PHP调用nobody用户权限上传或修改文件;其他系统文件应为644,文件夹应为755,图片文件也是644


Q:在Microsoft Windows服务器下安装osCommerce大中华版,需要注意哪些地方?

A:首先,请确认您的服务器已支持PHP语言,并已安装好MySQL数据库。

其次,在使用安装向导前,请先修改./catalog/install/templates/pages/install_3.php文件的第49行和50行:

$sql_file = $dir_fs_www_root . 'install/OSC-2.2ms2-GreaterChina-AddImages.sql';

//$sql_file ='c:\FoxServ\www\catalog\install\tchinese.sql';

修改为(假设您的WWW根目录在“e:\www\”下):

//$sql_file = $dir_fs_www_root . 'install/OSC-2.2ms2-GreaterChina-AddImages.sql';

$sql_file ='e:\www\catalog\install\OSC-2.2ms2-GreaterChina-AddImages.sql';

最后,在安装向导运行过程中,或手动修改configure.php文件时,注意把要填写的Windows服务器下的路径中的所有“\”改为“/”;例如路径“e:\www\catalog\”,正确的填写是“e:/www/catalog/”,否则“\”会为被认为是转意字符,而导致安装出错。


Q:在Microsoft Windows服务器下安装osCommerce大中华版,出现“警告: sessions 资料夹不存在: /tmp. 在这个目录未建立之前 Sessions 无法正常动作”?

A:这是由于用户在安装osCommerce时选择了把Sessions保存于/tmp目录路径下(默认),而Microsoft Windows本身并不存在此目录,所以导致出错。因此,在安装过程中推荐选择把Sessions保存于MYSQL数据库中。如果您已安装好osCommerce而不希望重新运行安装向导,最简单的方法是直接修改./catalog/includes/configure.php的第47行为:

define('STORE_SESSIONS', 'mysql'); // leave empty '' for default handler or set to 'mysql'

同时也修改./catalog/admin/includes/configure.php的第44行为:

define('STORE_SESSIONS', 'mysql'); // leave empty '' for default handler or set to 'mysql'


Q:打开后台管理的“税区”页面时出错:“1064 - You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '-20, 20' at line 1”,需要如何解决?

A:此错误一般在升级到MySQL 4.1.xx 以上出现,原因是“MySQL 4.1.xx handles negatives correctly (by forcing an error) in the code above unlike earlier versions of MySQL.”,需要修改./catalog/admin/includes/classes/split_page_results.php37行:

$offset = ($max_rows_per_page * ($current_page_number - 1));

$sql_query .= " limit " . $offset . ", " . $max_rows_per_page;

改为:

$offset = ($max_rows_per_page * ($current_page_number - 1));

if ($offset < 0)

{

$offset = 0 ;

}

$sql_query .= " limit " . $offset . ", " . $max_rows_per_page;


Q:打开后台管理页面时出错:“Fatal error: Cannot re-assign $this inc on line 31”,需要如何解决?

A:此错误一般在升级到PHP 5.0.5以上出现,原因是原来的语法已不支持,需要修改./ catalog/admin2/includes/classes/upload.php的第31行:

// self destruct

$this = null;

改为:

// self destruct

unset($this);

(注意:在更高版本的PHP5中,推荐直接把 $this = null; 注释掉)


Q:打开后台管理页面时出错:“Warning: Cannot add header information - headers already sent by (output started at /var/www/html/catalog/admin/includes/classes/upload.php:366) in /var/www/html/catalog/admin/includes/functions/general.php on line 89”,需要如何解决?

A:同上,如果你使用的是PHP4,所以请把catalog\admin\includes\classes\upload.php改名为upload.php5,并把里面一个php4upload.php.oldPHP4改名为upload.php即可。


Q:打开后台客户资料管理时出错:“Warning: array_merge() [function.array-merge]: Argument #1 is not an array in ./catalog/admin/customers.php on line 738”及“…on line 740”,需要如何解决?

A:此错误一般在升级到PHP 5.0.5以上出现,原因是原来的语法已不支持,需要修改. /catalog/admin/customers.php的第738行和740行:

$customer_info = array_merge($country, $info, $reviews);