gomymobi.com: 知识库

可用的商店类

存储内置类

- 我们已经开发了许多内置类和预定义对象;您只需要使用这些对象来构建您的商店主题。

- 根据您的上下文，某些对象不可用，例如：在产品的列表页面中，不能使用object $ Product查询有关产品的详细信息，或者除非您在顺序页面中，否则不能使用对象$ Shop_Order。

- 然而，上面的例子是罕见的;基本上，你可以在存储中的任何页面中使用所有这些全局对象。但要小心自己。

$Shop = new Shop(数组 $shop);

您可以使用此声明对象在您的商店主题的任何页面中使用。此对象包含使用存储设置的所有有用方法。

$shop 从商店表和网站表或商店ID获取的商店设置数组

返回: 目的

例: 定义一个store对象

// 检测当前站点是否使用子域或自定义域
$sql_where = strpos($_GET['site'], '.')>0 ? "S.domain='$_GET[site]'" : "S.subdomain='$_GET[site]'";
$db->_select("$PSZ_TABLE_STORES SHOP LEFT JOIN $PSZ_TABLE_SITES S ON S.shop_id=SHOP.id", 'SHOP.*, S.domain, S.subdomain', $sql_where);
if( NULL == ($shop=$db->get_result(1)) )
  error_wrong_usage('../');

$Shop = new Shop($shop);

get(串 $attr)

返回store的属性（数据库表字段）。查看商店表你可以得到的字段;有Paypal的属性你可以使用： paypal_sandbox, paypal_email, paypal_prefix, paypal_pdt.

返回: 字符串/数字

例

// 获得店主的电子邮件
echo $Shop->get('email');

// 获得店主的Paypal电子邮件
echo $Shop->get('paypal_email');

// 获得所有产品的平面运输成本的商店
echo $Shop->get('shipping_cost');

// 获得开店状态
echo $Shop->get('status'); // 1 要么 0

getDate(时间戳 $time)

从商店所有者设置返回带有日期格式的格式化时间戳的字符串。

$time 时间戳

返回: 串

getFavicon()

返回商店的favicon网址。

返回: 串

getPayments()

返回商店付款设置数组。

返回: 数组

例

var_export($Shop->getPayment());

array (
  'bacs' => array (
    'enable' => '1',
    'title' => 'Direct Bank Transfer',
    'description' => 'Make your payment directly into our bank account. Please use your Order ID as the payment reference. Your order will not be shipped until the funds have cleared in our account.',
    'accounts' => 
    array (
      0 => 
      array (
        'name' => 'Ticket Account Holder 1',
        'number' => '223344',
        'bank' => 
        array (
          'name' => 'Bank Name 1',
          'code' => 'CODE1',
          'iban' => '',
          'swift' => 'SWIFT1',
        ),
      ),
      1 => 
      array (
        'name' => 'Ticket Account Holder 2',
        'number' => '445566',
        'bank' => 
        array (
          'name' => 'Bank Name 2',
          'code' => 'CODE2',
          'iban' => 'IBAN2',
          'swift' => 'SWIFT2',
        ),
      ),
    ),
  ),
  'paypal' => array (
    'enable' => '1',
    'sandbox' => '1',
    'title' => 'PayPal',
    'description' => 'Pay via PayPal; you can pay with your credit card if you do not have a PayPal account',
    'email' => 'billing@gomymobi.com',
    'pdt' => '5tzXORMp-DzzyAdTsl1QmX3QSc7h1mJDtpHYqb58Ce2jhVoz4Rpm-TKPfUi',
    'prefix' => 'GTICKET-6717-',
  ),
  'cod' => array (
    'enable' => '1',
    'title' => 'Cash on Delivery',
    'description' => 'Pay with cash upon delivery.',
  ),
)

getLogo()

返回商店的网址。

返回: 串

getURL()

返回商店的URL。

返回: 串

例

echo $Shop->getURL();

/*
基于子域或子文件夹和用户站点设置的系统设置，返回以下结果之一：

http://www.user-custom-domain.com/shop-slug/
http://site-sub-domain.gomymobi.com/shop-slug/
http://www.gomymobi.com/app/sites/site-sub-domain/shop-slug/
*/

Price(数 $price = 0)

返回基于商店货币设置的格式化价格字符串。

返回: 串

echo $Shop->Price(30.895);

/*
基于货币的商店设置，返回以下结果之一：

30$
$30
30.9$
$30.895
*/

$Shop_Categories = new Shop_Categories(数组 $categories);

您可以使用此声明对象在您的商店主题的任何页面中使用。此对象包含来自商店的所有类别的层次结构。

$categories 来自从类别表中获取的商店的所有类别的数组。或者你可以传递NULL或空，这个类将自动获得当前的存储。

返回: 目的

例: 从表中获取所有类别，然后定义商店类别的对象

$db->_select($PSZ_TABLE_STORE_CATEGORIES, 'id, name, slug, icon, parent, description', "active=1 AND shop_id=" . $Shop->get('id') . " AND user_id=" . $Shop->get('user_id'), "ORDER BY sorting DESC, created_time ASC");
if( NULL == ($categories = $db->get_result()) )
  $Shop_Categories = new Shop_Categories($categories);

例: 最好的简单解决方案

$Shop_Categories = new Shop_Categories();

2以上解决方案返回对象与数据如下

Shop_Categories::__set_state(array(
   'categories' => array (
      0 => Shop_Category::__set_state(array(
           'id' => '1',
           'icon' => NULL,
           'name' => '3D',
           'slug' => '3d',
           'description' => '',
           'childs' => array(),
           'popular' => NULL,
           'parent' => '0',
        )),
      1 => Shop_Category::__set_state(array(
           'id' => '2',
           'icon' => NULL,
           'name' => 'IMAX',
           'slug' => 'imax',
           'description' => '',
           'childs' => array (),
           'popular' => NULL,
           'parent' => '0',
      )),
      2 => Shop_Category::__set_state(array(
           'id' => '3',
           'icon' => NULL,
           'name' => 'Genre',
           'slug' => 'genre',
           'description' => '',
           'childs' => array (
              0 => Shop_Category::__set_state(array(
                 'id' => '4',
                 'icon' => NULL,
                 'name' => 'Action',
                 'slug' => 'action',
                 'description' => '',
                 'childs' => array(),
                 'popular' => NULL,
                 'parent' => '3',
              )),
              1 => Shop_Category::__set_state(array(
                 'id' => '5',
                 'icon' => NULL,
                 'name' => 'Horror',
                 'slug' => 'horror',
                 'description' => '',
                 'childs' => array(),
                 'popular' => NULL,
                 'parent' => '3',
              )),
            ),
           'popular' => NULL,
           'parent' => '0',
      )),
    ),
   'length' => 3,
))

getAll()

返回层次结构中的对象数组（存储的活动类别）。

返回: 对象数组

例: 您可以使用此对象创建层次结构菜单栏

if( $Shop_Categories->length>0 )
{
  // 循环以获取所有类别
  foreach ($Shop_Categories->getAll() as $cat) {
    $pTemplate->assign_block_vars('menu_category_top_nav', array(
      // 直接访问类别属性
      'NAME'      => $cat->name,
      'SLUG'      => $cat->slug,
      'ICON'      => is_image($cat->icon) ? '<img class="category-icon" src="' . $cat->icon . '"/>' : '<i class="' . $cat->icon . '"></i>',

      // 如果访问者属于某个类别，请将其标记为活动
      'ACTIVE'    => $Shop_Current_Category!=NULL && $Shop_Current_Category->slug==$cat->slug ? 'active' : '',

      'HAS_CHILD' => count($cat->childs) ? true : false,

      // 构建此类别的子级（如果可用）
      'CHILDS'    => get_html_menu_childs($cat->childs),
    ));
  }
}

$Shop_Current_Category = new Shop_Category(数组 $category);

If this defined object $Shop_Current_Category is not NULL, indicate visitors are viewing some store category. And you may access all properties of this object directly, please check its properties (table fields).

$category 所有类别属性的数组（表字段）从类别表中提取。或者你可以使用独特的lug类

返回: 对象/ NULL

例: 定义某个类别的对象

$db->_select($PSZ_TABLE_STORE_CATEGORIES, 'id, name, slug, icon, parent, description', "active=1 AND shop_id=" . $Shop->get('id') . " AND user_id=" . $Shop->get('user_id') . " AND slug='some-category-slug'");
  if( NULL != ($result=$db->get_result(1)) )
    $Shop_Current_Category = new Shop_Category($result);

addChild(Shop_Category $category_object)

将一些类别对象添加到当前类别对象作为层次结构。

$category_object 您想要添加为子类的某个类别的对象

$Shop_Pages = new Shop_Pages();

此对象包含商店的所有活动页面，您可以在商店中的任何位置使用此对象。

返回: 对象/ NULL

get(Int &$id)

按页面ID返回商店页面的对象。

$id 页面的ID值需要检索

返回: 对象/ NULL

getAll()

返回商店页面对象的数组。

返回: 对象数组

Shop_Page(数组 $page)

这个类允许你为一个页面声明一个对象。

$page array of store page properties (table fields) fetched from page table. Or you may use ID (number) of page

返回: 对象/ NULL

Price()

此方法返回购买者需要支付的最终价格，在计算出销售或注册费（对于订阅产品）后。此方法用于结帐页面。

返回: 数

Purchase_Price()

此方法返回购买者需要支付的最终价格，之后计算与注册费。此方法仅用于fpr订阅产品。

返回: 数

Get_Price(布尔值 $short = false)

返回一个字符串的产品价格。您可以应用过滤器 get_price 格式化最终结果。

$short 显示短格式的价格

返回: 串

例: 如果产品是单一的，回声结果之一

echo $Product->Get_Price();

// 30$
// <strike class='font-xs'>30$</strike> <b>19$</b>
// 定期: <strike>30$</strike><br/>销售: <b>19$</b>

例: 如果产品是一个组

echo $Product->Get_Price();

// 30$ <i class="fa fa-long-arrow-right"></i> 50$

例: 如果产品是订阅，回声如下

echo $Product->Get_Price();

// 9$ / 月为6个月
// 3$ 前面然后 9$ / 1个月后免费试用
// 0$ 前面然后 9$ / 月后1个月免费试用

例: 应用过滤器

// 在函数下面添加过滤函数
function get_price_format($price) {
  $price = str_replace('strike', 'small', $price);
  $price = str_replace('<i class="fa fa-long-arrow-right"></i>', 'to', $price);
  $price = str_replace('Free Trial', 'FREE period', $price);
  return $price;
}
add_filter('get_price', 'get_price_format');

echo $Product->Get_Price();

// 如果产品是单一的
// 30$
// <small class='font-xs'>30$</small> <b>19$</b>
// 定期: <small>30$</small><br/>销售: <b>19$</b>

// 如果产品是组
// 30$ to 50$

// 如果产品是订阅
// 3$ 前面然后 9$ / 月后1周免费期

Get_Relates(Int $number = 8)

返回包含相关产品对象的数组。这些类似产品是基于产品名称计算的。

$number 默认情况下，仅提取8个相关产品

返回: 对象数组

Get_Childs()

返回包含children产品的对象数组。如果产品是组，则使用此方法。如果product不是组，则返回FALSE，如果没有子项或返回children，则返回NULL。

返回: 对象数组/ NULL / FALSE

Get(串 $attr)

Return an attribute (table field) of product. Beside, this method also accepts some extra attributes for accessing easier.

$attr 属性想检索，额外的属性

featured_image 产品的特征图像

tags 产品的所有标签，如果存在，返回标签数组

返回: 数组/字符串

is(串 $type)

检测产品是否真的是东西。

$type 属性想检测，可接受的值:

saleoff 检查产品是否销售（折扣）
new 如果产品是新的，则返回TRUE
instock 如果产品仍然存在，则返回TRUE
outstock 如果产品缺货，则返回TRUE
group 检测产品是否为组
subscription 检查产品是否是订阅
single 检查产品是否单一
digital 检查产品是否是数字的

返回: 真假

List_Products(串 $type = '',串 $condition = '',Int $number = 10,布尔值 $parent = false)

此类用于列出根据您的规则和条件过滤的产品。

$type 主过滤器需要申请;默认情况下，此类返回新产品;可接受的值:

featured 仅选择特色产品
discounted 选择产品只有折扣或销售
childs 挑选儿童的产品，用于 $condition 是父ID
cart 采摘产品是在购物车，与 $condition 是一个产品ID数组
relate 挑相关产品，配合使用 $condition 是当前产品的ID和名称的数组
order_add_item 搜索产品添加到订单，用于订单管理页面与商店所有者权限

$condition 您想申请的其他条件

$number 限制您要检索的产品数量;默认情况下，仅检索10个产品

$parent 如果为TRUE，请选择不在任何组中的产品

返回: 对象数组/ NULL

例

// 获得新产品
$New_Products = new List_Products();

// 获得新10个产品
$New_Products = new List_Products('', '', 10);

// 获得名称或描述中带有字符串“VIP”的新产品
$New_Products = new List_Products('', 'VIP');

// 获得特色产品
$Item_Featured = new List_Products('featured');

// 获得十大打折产品
$Item_Discounted = new List_Products('discounted', '', 10);

// 获得产品在购物车，用于购物车和结帐页
$Cart_Items = new List_Products('cart');

// 或使用这个长的解决方案
$Cart_Items = new List_Products('cart', array_keys($_COOKIE[ $shop_cookie_name ]['cart']) );

// 访问者使用搜索功能时获得10个产品，并按价格降序排序
$Items = new List_Products("price DESC", $keyword, 10);

// 按时间递减得到产品
$Items = new List_Products("time DESC");

// 得到的产品受欢迎
$Items = new List_Products("pageviews DESC");

// 获取当前产品的相关项目
$Items = new List_Products('relate');

// 或使用这个长的解决方案
$Items = new List_Products('relate', 
    array('id' => $Product->get('id'), 'name' => $Product->get('name'))
);

// 获得当前产品的儿童项目
$Items = new List_Products('childs');

// 或使用这个长的解决方案
$Items = new List_Products('childs', $Product->get('id'));

if( $Items->length>0 )
{
  // 在这里处理您的工作
}

Total(串 $type = '',串 $keyword = '')

此静态方法使用您的规则和条件对产品进行计数。

$type main filter to count, you may check table fields for futher usage, acceptable defined values:

featured 计数所有特色产品
discounted 计数所有打折产品

返回: 真假

例

// 计数所有特色产品
echo List_Products::Total('featured');

// 计数所有打折产品
echo List_Products::Total('discounted');

// 计数所有带有字符串\'VIP\'的产品的名称或描述
echo List_Products::Total('', 'VIP');

// 计数所有订阅的产品
echo List_Products::Total("item_type='subscription'");

// 计数所有可下载的产品
echo List_Products::Total("downloadable=1");

// 计数所有未发布（草稿）产品
echo List_Products::Total("published_time=0");

// 计数所有出售（折扣）产品
echo List_Products::Total("price_sale>0");

// 计数所有产品的订阅和免费试用
echo List_Products::Total("signup_fee>0");

get(Int &$id)

返回当前列表中的产品对象。

$id 产品的ID值需要检索

返回: 对象/ NULL

getAll()

返回当前列表中的产品对象数组。

返回: 对象数组

getIDs()

返回当前列表中的产品ID数组。

返回: 数组

Shop_Order(数组 $order_properties)

返回商店订单的对象。

$order_properties array of all order properties (table fields) fetched from order table. Or you may use order ID value

返回: 对象/ NULL

例

// 得到店铺订单
$Shop_Order = new Shop_Order($order_id);

// 或使用这个长的解决方案
$db->_select(
  $PSZ_TABLE_STORE_ORDERS, '*',
  "`shop_id`=? AND `user_id`=? AND `key`=?",
  array($Shop->get('id'), $Shop->get('user_id'), $order_key)
);
if( NULL != ($order=$db->get_result(1)) )
  $Shop_Order = new Shop_Order($order);

is(串 $type)

检测订单是否真的有事。

$type 属性想检测，可接受的值:

subscription 检查订单是否是订阅
shipping 检查订单是否有有形物品需要发运
suspended 如果订单已暂停，则返回TRUE
downloadable 如果订单有可下载的文件，则返回TRUE

返回: 真假

Subscription_Price(布尔值 $short = false)

返回基于商店货币设置的格式化价格字符串。此方法用于在购物车，结帐页，订单页中显示订单的总价格;并仅用于显示目的，不用于计算。

使用 $Shop_Order->get('purchase_price') 如果想获得订阅价格，或计算。

$short 如果为TRUE，返回短格式

返回: 串

get(串 $attr, 串 $option = '')

返回一个顺序的属性（数据库表字段）。查看订单表你可能会得到的字段。.

$attr 属性想检索;在表字段旁边，还可以使用这些定义的属性:

date 检索订单的创建日期，结果以商店所有者的日期格式设置格式化
date_completed 检索订单的完成日期（付款日期），结果以商店所有者的日期格式设置格式化
items 按顺序返回产品列表，与第二个参数一起使用 $option
count 返回总产品
list 返回一个产品字符串，包括每个产品和购买计数的链接
id 返回产品ID数组
default 返回数组的产品
files 按顺序检索可下载文件的数组，或者如果设置了第二个参数，则只返回文件数 $option = 'count'
buyer_name 返回买家的全名
buyer_email 返回链接到买家电子邮件或电子邮件只有设置第二个参数 $option = 'raw'
buyer_phone 返回链接到电话号码的买家或电话号码只有设置第二个参数 $option = 'raw'
ship_fullname 返回送货人的全名
ship_fax 退回发货人的传真
ship_company 退货公司
ship_email 返回链接到发货人的电子邮件或电子邮件只有设置第二个参数 $option = 'raw'
ship_phone 返回链接到电话号码的发货人或电话号码只有设置第二个参数 $option = 'raw'
ship_address 返回送货地址
payment_method 如果设置第二个参数，则返回所选付款的方法名称或方法段 $option = 'key'
payment_guide 选择方法的返回支付指南
paypal_link 返回到Paypal的链接，如果订单是未付的，付款方式是Paypal

$option 附加选项需要检索

返回: 串

gomymobi.com: 知识库

可用的商店类

存储内置类

例: 定义一个store对象

例

例

例

例: 从表中获取所有类别，然后定义商店类别的对象

例: 最好的简单解决方案

2以上解决方案返回对象与数据如下

例: 您可以使用此对象创建层次结构菜单栏

例: 定义某个类别的对象

例: 如果产品是单一的，回声结果之一

例: 如果产品是一个组

例: 如果产品是订阅，回声如下

例: 应用过滤器

例

例

例

如果您的事情不在本节的范围内，请随时与我们联系 通过使用上面的联系人按钮或直接发送 hello@gomymobi.com 主题： [contactgmm] 如果在24小时内没有收到我们的回复，请重新发送票

如果您的事情不在本节的范围内，请随时与我们联系
通过使用上面的联系人按钮或直接发送 hello@gomymobi.com 主题： [contactgmm]
如果在24小时内没有收到我们的回复，请重新发送票