目录搜索
文字

购物车类允许将项目添加到用户浏览您的网站时保持活动的会话。这些物品可以以标准的“购物车”格式检索和显示,允许用户更新数量或从购物车中移除物品。

重要

购物车图书馆已被拒绝,不应使用。目前仅保留用于向后兼容。

请注意,购物车类仅提供核心“购物车”功能。它不提供运输,信用卡授权或其他处理组件。

  • 使用购物车类

    • 什么是行ID?

    • 初始化购物车类

    • 将商品添加到购物车

    • 将多个项目添加到购物车

    • 显示购物车

    • 更新购物车

  • 类参考

使用购物车类

初始化购物车类

重要

Cart类使用CodeIgniter的会话类将购物车信息保存到数据库,因此在使用Cart类之前,您必须按照会话文档中的说明设置数据库表,并在您的application / config / config.php中设置会话首选项文件来利用数据库。

要在控制器构造函数中初始化购物车类,请使用以下$this->load->library()方法:

$this->load->library('cart');

加载后,Cart对象将可用:

$this->cart

注意

Cart类将自动加载和初始化会话类,因此除非您在应用程序的其他地方使用会话,否则不需要加载Session类。

将商品添加到购物车

要将商品添加到购物车,只需将包含商品信息的数组传递给$this->cart->insert()方法,如下所示:

$data = array(        'id'      => 'sku_123ABC',        'qty'     => 1,        'price'   => 39.95,        'name'    => 'T-Shirt',        'options' => array('Size' => 'L', 'Color' => 'Red'));$this->cart->insert($data);

重要

上面的前四个数组索引(id,qty,price和name)是必需的。如果您忽略其中的任何一项,则数据将不会保存到购物车。第五个索引(选项)是可选的。它旨在用于您的产品具有与之相关联的选项的情况。如上所示,使用数组作为选项。

五个保留索引是:

  • id - 商店中的每个产品都必须具有唯一标识符。通常这将是一个“SKU”或其他这样的标识符。

  • 数量 - 正在购买的数量。

  • 价格 - 物品的价格。

  • 名称 - 项目的名称。

  • 选项 - 识别产品所需的任何其他属性。这些必须通过数组传递。

除上述五个索引外,还有两个保留字:rowid和小计。这些由Cart类内部使用,因此请勿在将数据插入购物车时将这些词用作索引名称。

你的数组可能包含额外的数据。你在数组中包含的任何内容都将存储在会话中。但是,最好将所有产品中的数据标准化,以便使表格中的信息更容易显示。

$data = array(        'id'      => 'sku_123ABC',        'qty'     => 1,        'price'   => 39.95,        'name'    => 'T-Shirt',        'coupon'         => 'XMAS-50OFF');$this->cart->insert($data);

insert()如果您成功插入单个项目,该方法将返回$ rowid。

将多个项目添加到购物车

通过使用多维数组,如下所示,可以在一个动作中将多个产品添加到购物车。在希望允许用户从同一页面上的多个项目中进行选择的情况下,这非常有用。

$data = array(        array(                'id'      => 'sku_123ABC',                'qty'     => 1,                'price'   => 39.95,                'name'    => 'T-Shirt',                'options' => array('Size' => 'L', 'Color' => 'Red')        ),        array(                'id'      => 'sku_567ZYX',                'qty'     => 1,                'price'   => 9.95,                'name'    => 'Coffee Mug'        ),        array(                'id'      => 'sku_965QRS',                'qty'     => 1,                'price'   => 29.95,                'name'    => 'Shot Glass'        ));$this->cart->insert($data);

显示cart

要显示购cart,您将创建一个代码类似于下面显示的代码的视图文件。

请注意,这个例子使用了表单助手。

<?php echo form_open('path/to/controller/update/method'); ?><table cellpadding="6" cellspacing="1" style="width:100%" border="0"><tr>        <th>QTY</th>        <th>Item Description</th>        <th style="text-align:right">Item Price</th>        <th style="text-align:right">Sub-Total</th></tr><?php $i = 1; ?><?php foreach ($this->cart->contents() as $items): ?>        <?php echo form_hidden($i.'[rowid]', $items['rowid']); ?>        <tr>                <td><?php echo form_input(array('name' => $i.'[qty]', 'value' => $items['qty'], 'maxlength' => '3', 'size' => '5')); ?></td>                <td>                        <?php echo $items['name']; ?>                        <?php if ($this->cart->has_options($items['rowid']) == TRUE): ?>                                <p>                                        <?php foreach ($this->cart->product_options($items['rowid']) as $option_name => $option_value): ?>                                                <strong><?php echo $option_name; ?>:</strong> <?php echo $option_value; ?><br />                                        <?php endforeach; ?>                                </p>                        <?php endif; ?>                </td>                <td style="text-align:right"><?php echo $this->cart->format_number($items['price']); ?></td>                <td style="text-align:right">$<?php echo $this->cart->format_number($items['subtotal']); ?></td>        </tr><?php $i++; ?><?php endforeach; ?><tr>        <td colspan="2"> </td>        <td class="right"><strong>Total</strong></td>        <td class="right">$<?php echo $this->cart->format_number($this->cart->total()); ?></td></tr></table><p><?php echo form_submit('', 'Update your Cart'); ?></p>

更新cart

要更新cart中的信息,您必须将包含行ID和一个或多个预定义属性的数组传递给$this->cart->update()方法。

注意

如果数量设置为零,则该物品将从购物车中移除。

$data = array(        'rowid' => 'b99ccdf16028f015540f341130b6d8ec',        'qty'   => 3);$this->cart->update($data);// Or a multi-dimensional array$data = array(        array(                'rowid'   => 'b99ccdf16028f015540f341130b6d8ec',                'qty'     => 3        ),        array(                'rowid'   => 'xw82g9q3r495893iajdh473990rikw23',                'qty'     => 4        ),        array(                'rowid'   => 'fh4kdkkkaoe30njgoe92rkdkkobec333',                'qty'     => 2        ));$this->cart->update($data);

您也可以在插入项目时更新您之前定义的任何属性,例如选项,价格或其他自定义字段。

$data = array(        'rowid'  => 'b99ccdf16028f015540f341130b6d8ec',        'qty'    => 1,        'price'  => 49.95,        'coupon' => NULL);$this->cart->update($data);

什么是行ID?

行ID是在将商品添加到购物车时由购物车代码生成的唯一标识符。创建唯一ID的原因是,可以通过购物车管理具有不同选项的相同产品。

例如,假设有人购买两个相同的T恤(相同的产品ID),但尺寸不同。产品ID(和其他属性)对于两种尺寸都是相同的,因为它们是同一件衬衫。唯一的区别是尺寸。因此,购物车必须具有识别这种差异的手段,以便两种尺寸的衬衫可以独立管理。它通过创建基于产品ID和与其关联的任何选项的唯一“行ID”来实现。

在几乎所有情况下,更新购物车都是用户通过“查看购物车”页面所做的事情,因此对于开发者来说,您不可能永远不必关心“行ID”,除非确保您的“查看购物车”页面在隐藏表单域中包含此信息,并确保update()在提交更新表单时将其传递给方法。请检查上面的“查看购物车”页面的结构以获取更多信息。

类参考

class CI_Cart$product_id_rules = '.a-z0-9_-'

这些是我们用来验证产品ID的正则表达式规则 - 默认情况下是字母数字,短划线,下划线或句点

$product_name_rules = 'w -.:'

这些是我们用来验证产品ID和产品名称的正则表达式规则 - 默认情况下是字母数字,破折号,下划线,冒号或句点

$product_name_safe = TRUE

是否仅允许安全的产品名称。默认为TRUE。

insert([$items = array()])

参数:

$ items(array) - 要插入购物车的项目

返回:

成功为TRUE,失败为FALSE

返回类型:

布尔

  • $ itemsarray) - 要插入购物车的项目

Returns:  TRUE on success, FALSE on failure
Return type:  bool
Insert items into the cart and save it to the session table. Returns TRUE on success and FALSE on failure.

update([$items = array()])

参数:

$ items(array) - 要在购物车中更新的项目

返回:

成功为TRUE,失败为FALSE

返回类型:

布尔

  • $ itemsarray) - 要在购物车中更新的项目

Returns:  TRUE on success, FALSE on failure
Return type:  bool
此方法允许更改给定项目的属性。通常情况下,如果用户在结帐前更改数量,则会从“查看购物车”页面中调用。该数组必须包含每个项目的rowid。

remove($rowid)

参数:

$ rowid(int) - 要从购物车中移除的物品的ID

返回:

成功为TRUE,失败为FALSE

返回类型:

布尔

  • $ rowidint) - 要从购物车中移除的物品的ID

Returns:  TRUE on success, FALSE on failure
Return type:  bool
允许您通过传递`$ rowid`来从购物车中删除商品。

total()

返回:

总金额

返回类型:

INT

total_items()

返回:

购物车中的物品总量

返回类型:

INT

contents([$newest_first = FALSE])

参数:

$ newest_first(bool) - 是否先用最新的项目排列数组

返回:

购物车内容的数组

返回类型:

排列

  • $ newest_firstbool) - 是否先用最新的项目排列数组

Returns:  An array of cart contents
Return type:  array
返回包含购物车中所有内容的数组。您可以通过传递数组来排序返回数组的顺序TRUE将内容从最新到最旧排序,否则将从最旧到最新排序。

get_item($row_id)

参数:

$ row_id(int) - 要检索的行ID

返回:

项目数据的数组

返回类型:

排列

  • $ row_idint) - 要检索的行ID

Returns:  Array of item data
Return type:  array
返回包含与指定行ID匹配的项的数据的数组,如果不存在此类项,则返回FALSE。

has_options($row_id = '')

参数:

$ row_id(int) - 要检查的行ID

返回:

如果选项存在则为TRUE,否则为FALSE

返回类型:

布尔

  • $ row_idint) - 要检查的行ID

Returns:  TRUE if options exist, FALSE otherwise
Return type:  bool
如果购物车中的特定行包含选项,则返回TRUE(布尔值)。这个方法被设计成在`content()`循环中使用,因为你必须将rowid传递给这个方法,如上面的显示购物车示例所示。

product_options([$row_id = ''])

参数:

$ row_id(int) - 行ID

返回:

一系列产品选项

返回类型:

排列

  • $row_id (int) – Row ID

返回:产品选项数组
Return type:  array
Returns an array of options for a particular product. This method is designed to be used in a loop with `contents()`, since you must pass the rowid to this method, as shown in the Displaying the Cart example above.

destroy()

Return type:

void

上一篇:下一篇: