编辑“Gallery:模块:checkout”

= Checkout模块 =
使用户可以通过电子邮件的方式订购G2项目或通过''PayPal''进行购买。

有扩展模块会下载pdf格式的发票，允许顾客下载图片并链接项目值组，这样当配置无误时，人们就可以购买其他图片/尺寸/相册的访问权限了。

Checkout的0.3.3版本经由Gallery: 2.2.4编写并经过测试。

该模块的贡献者有''dleaberr1''，''turnbulm''，''jayhen''和''alecmyers''。

== 模块的安装==

使用Gallery的管理/插件页面的"获取更多插件（get more plugins）"标签。Checkout位于社群存储库中，因此在更新可用插件列表之前你应当确保激活了社群插件框。Checkout，checkoutpaypal，checkoutemail，checkoutdownload，checkoutgroups以及checkoutpdfinvoice位于列表的商业（Commerce）部分。

在安装checkout时应当禁用cart模块，因为它们都有一个'添加到购物车（add to cart）'命令，所以很容易混淆产生不期后果。

同样请注意，为了能够让匿名（游客）用户可以购买项目，你必须为所有人（Everyone）用户组添加'[checkout]purchase items'权限。此设定针对希望被购买的项目 有效—如果你希望Gallery中所有的东西都可以被购买的话，那么当你编辑根相册时可以在权限页面中进行设定。

== 模块的能力 ==

* '''单位项目/相册定价''' 各相册/项目在编辑项目页面上的此标签允许在单位相册或单位项目的基础上进行产品价格和参量的自定义。
* 发送给管理者及顾客的订单'''电子邮件报告'''
* '''订单状态跟踪'''表示某些插件（checkoutpaypal）配置后能够自动确认付款收据，启动通知并允许下载。对于人工付款选项（支票，银行转帐），一键订单状态更新将会自订单管理页面被启动。
* '''开放式结构'''表示新模块可以被添加到系列中来自定义产品管理，邮资原先，电子邮件及其他订单参量。
* '''打折'''可以为较广种类范围的订单标准进行配置，包括最小值，产品数量，Gallery组（对已注册用户）会员制以及顾客输入的打折代码（打折券），这些都可以配置。
* '''面向顾客的订单状态页面'''允许顾客查看订单进程并在适当的时间下载文件。
* '''可扩展的付款结构'''表示可添加新的付款方式。

== 选取并配置模块 ==

=== 'Checkout'核心模块 ===
核心模块需要进行某些配置。它在管理视图中被完全呈现在单独页面上了，并且十分直截了当。仔细地按自己的业务需要设定选项。 

Checkout模块也创建一个'''新的Gallery权限'''，名为'''[checkout] Purchase item'''。通过使用Gallery现有的权限框架设定此相册项目上的权限，你就可以定义那些项目可以被那些用户购买。

要使其对站点范围的所有访问者可用的话，浏览到Gallery顶部并选择各相册的"编辑权限（Edit Permissions）"。为"所有人（Everybody）"组（或"已注册用户（Registered Users）"）添加新的用户组权限，以允许他们"[checkout] Purchase item"。

=== checkoutpaypal - 'paypal'付款插件 ===
PayPal插件允许你接受购物车内项目的Paypal付款。再次重申一下，所有的东西都在一个页面上，这些字段为：

* '''PayPal电子邮件地址'''参量将你的gallery链接到Paypal商户帐号上。当你创建了PayPal账户时，这就是你所注册的电子邮件地址。此地址应当保证正确，否则的话用户会把款项打到错误的PayPal账户中。
* '''PayPal付款的货币代码'''是PayPal接受款项的货币种类。目前所支持的PayPal货币列表已完成- 你无法接受其他种类货币的付款。请参见下面的URL获取更多信息： http://www.paypal.com/cgi-bin/webscr?cmd=p/sell/mc/mc_intro-outside

* '''PayPal操作模式'''运行你转换模块来操作PayPal '沙盒（sandbox）'而无需作出真实的付款行为。要使用此特点的话，你需要注册一个PayPal开发者帐号。该沙盒作为一个开放环境模拟了真实的PayPal环境，但不牵涉使用真实的货币。更多的信息可以参看此URL：https://developer.paypal.com/

=== checkoutemail - '电子邮件'付款插件===
电子邮件（email）插件允许购物车（cart）的内容通过电子邮件发送到指定的地址，同时带有发送信息。接着在完成订单之前，你可以通过其他方式（比如支票）收集付款。通过自定义该模块中的模板以包含你的付款信息，顾客的订单在被确认之时就会收到付款方式的相关信息。

=== checkoutdownload ===

该模块扩展了checkout，允许顾客下载含有订购图片的zip格式文件。该模块的配置选项在站点管理页面上有解释。默认情况下，下载按钮出现在顾客的确认电邮之中以及订单状态页面之上。

=== checkoutgroups ===

该模块扩展了checkout，当订单付讫时将顾客添加至用户组中。某个订购组可以被设定为任何单独产品/项目组合，通过编辑项目（编辑相册/编辑相片）页面上的checkout标签扩展名来完成。该特点的可能存在的用处包括：购买较大图片的访问权，购买相册访问权并允许回头客在将来享受折扣—取决于该购买者被添加到的用户组预先指派的权限。

已注册用户需要在下单之前登入方可使用这些特点。

=== checkoutpdfinvoice ===

下载发票进行打印并使用此模块邮寄给顾客。尽管无需做配置，你还是需要编辑（包括其中的）pdf模板，发票在此间的某个外部应用程序中，比如Adobe Illustrator，被建立起来并包括你的标识以及地址详细信息。使用订单管理页面上的按钮下载发票。

== 准备好PayPal设定==
在接受PayPal付款之前，你需要注册一个PayPal帐户！如果你还没有注册的话，请打开https://www.paypal.com/cgi-bin/webscr?cmd=_registration-run 并注册为'Premier'或'Business'类型的用户（都是免费注册的）。

一旦你完成了帐户注册，就在PayPal上登入注册好的帐户来到'''个人资料'''页面。你需要做一个修改以使得checkout模块能够正常工作：

* 在'''邮资计算（Postage Calculations）'''中仅对页面底部的多选框进行设定以允许checkout的以交易为基础的邮资值被使用。最简单的办法就是点击'清除设定（Clear Settings）'按钮，并'保存（Save）'。

如果你要使用'''PayPal沙盒'''（见第三部分的注释）的话，那么你应当为沙盒商户帐户再次使用该设定。

== 测试 ==
请在付诸实践之前做好测试！

如果你已注册好了PayPal沙盒的话，那么测试的第一步就是将模块置于管理页面中的'沙盒'模式下并尝试进行一些交易。PayPal URL是https://www.sandbox.paypal.com/.... 这样你就可以确定作出付款时，实际上是在沙盒中进行测试。

如果你还没有注册沙盒的话，那么最简单的测试办法就是在自己的站点上使用自己的信用卡做一次真实的购买操作。一旦经处理，你就可以登入到PayPal商户帐号并退款。（注：PayPal不允许使用在他们上面注册的信用卡进行购买交易，因此你需要一张PayPal不知道的信用卡。）

[[Category:Gallery 2:Modules]]
[[Category:Gallery 2:Contributed modules]]