gomymobi.com: Base de connaissance

Classes de magasins utilisables

Store classes intégrées

- Nous développons déjà de nombreuses classes intégrées et des objets prédéfinis; Vous devez uniquement utiliser ces objets pour créer vos thèmes de magasin.

- En fonction de votre contexte, certains objets ne sont pas disponibles, par exemple: dans la page de liste des produits, vous ne pouvez pas utiliser l'objet $ Product pour demander des détails sur le produit ou vous ne pouvez pas utiliser l'objet $ Shop_Order sauf si vous êtes en page de commande.

- Cependant, les exemples ci-dessus sont rares; Fondamentalement, vous pouvez utiliser tous ces objets globaux dans n'importe quelle page en magasin. Mais soyez prudent.

$Shop = new Shop(Array $shop);

Vous pouvez utiliser cet objet déclaré pour l'utiliser dans n'importe quelle page de vos thèmes de magasin. Cet objet contient toutes les méthodes utiles pour travailler avec les paramètres de magasin.

$shop Tableau des paramètres de magasin extraits de la table de magasin et de la table de site ou de l'ID d'atelier

Revenir: Objet

Exemple: Définir un objet magasin

// Détecter si le site actuel utilise un sous-domaine ou un domaine personnalisé
$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(Chaîne $attr)

Renvoie un attribut (champ de table de base de données) du magasin. Check-out Table des magasins Pour les champs que vous pouvez obtenir; Avec les attributs de Paypal, vous pouvez utiliser: paypal_sandbox, paypal_email, paypal_prefix, paypal_pdt.

Revenir: Chaîne / nombre

Exemple

// Obtenir l'email du propriétaire du magasin
echo $Shop->get('email');

// Obtenir le courriel de Paypal du propriétaire du magasin
echo $Shop->get('paypal_email');

// Obtenir des frais de livraison forfaitaire de magasin pour tous les produits
echo $Shop->get('shipping_cost');

// Obtenir l'état d'ouverture du magasin
echo $Shop->get('status'); // 1 ou 0

getDate(Timestamp $time)

Renvoie une chaîne d'horodatage formaté avec le format de date à partir du paramètre propriétaire du magasin.

$time Un horodatage

Revenir: Chaîne

getFavicon()

Retour favicon URL du magasin.

Revenir: Chaîne

getPayments()

Renvoie un tableau de paramètres de paiement en magasin.

Revenir: Array

Exemple

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()

Retour URL du logo du magasin.

Revenir: Chaîne

getURL()

URL de retour du magasin.

Revenir: Chaîne

Exemple

echo $Shop->getURL();

/*
Basée sur le sous-domaine ou le sous-dossier et le réglage de site d'utilisateur, renvoient l'un des résultats ci-dessous:

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(Nombre $price = 0)

Renvoie une chaîne de prix formatée, en fonction des paramètres de devise de magasin.

Revenir: Chaîne

echo $Shop->Price(30.895);

/*
Basée sur la devise, retournez l'un des résultats ci-dessous:

30$
$30
30.9$
$30.895
*/

$Shop_Categories = new Shop_Categories(Array $categories);

Vous pouvez utiliser cet objet déclaré pour l'utiliser dans n'importe quelle page de vos thèmes de magasin. Cet objet contient la structure hiérarchique de toutes les catégories d'un magasin.

$categories Tableau de toutes les catégories à partir d'un magasin extrait de la table des deux catégories. Ou vous pouvez passer NULL ou vide, cette classe doit obtenir le magasin en cours autimatically.

Revenir: Objet

Exemple: Extraire toutes les catégories de la table puis définir un objet de catégories de magasin

$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);

Exemple: Meilleure solution simple

$Shop_Categories = new Shop_Categories();

2 ci-dessus solutions retour d'objet avec des données comme ci-dessous

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()

Retourne un tableau d'objets (catégories actives de magasin) dans la structure hiérarchique.

Revenir: Arbre d'objets

Exemple: Vous pouvez utiliser cet objet pour créer une barre de menus hiérarchique

if( $Shop_Categories->length>0 )
{
  // Boucle pour récupérer toutes les catégories
  foreach ($Shop_Categories->getAll() as $cat) {
    $pTemplate->assign_block_vars('menu_category_top_nav', array(
      // Accéder à la catégorie propriété directement
      'NAME'      => $cat->name,
      'SLUG'      => $cat->slug,
      'ICON'      => is_image($cat->icon) ? '<img class="category-icon" src="' . $cat->icon . '"/>' : '<i class="' . $cat->icon . '"></i>',

      // Si les visiteurs sont dans une catégorie, le marquer comme actif
      'ACTIVE'    => $Shop_Current_Category!=NULL && $Shop_Current_Category->slug==$cat->slug ? 'active' : '',

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

      // Construire des enfants pour cette catégorie si disponible
      'CHILDS'    => get_html_menu_childs($cat->childs),
    ));
  }
}

$Shop_Current_Category = new Shop_Category(Array $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 Tableau de toutes les propriétés de catégorie (champs de table) extraites de la table de catégories. Ou vous pouvez utiliser slug unique de la catégorie

Revenir: Object / NULL

Exemple: Définir un objet pour une catégorie

$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)

Ajoutez un objet catégorie à l'objet catégorie courant comme structure hiérarchique.

$category_object Un objet de la catégorie que vous aimeriez ajouter comme enfant

$Shop_Pages = new Shop_Pages();

Cet objet contient toutes les pages actives d'un magasin, vous pouvez utiliser cet objet n'importe où dans les magasins.

Revenir: Object / NULL

get(Int &$id)

Renvoie un objet de page de magasin par page ID.

$id La valeur d'ID de la page doit être récupérée

Revenir: Object / NULL

getAll()

Retourne le tableau des objets de page de magasin.

Revenir: Arbre d'objets

Shop_Page(Array $page)

Cette classe vous permet de déclarer un objet pour une page.

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

Revenir: Object / NULL

Price()

Cette méthode renvoie le prix final que les acheteurs doivent payer, après calculé avec la vente ou les frais d'inscription (pour les produits d'abonnement). Cette méthode est utilisée dans la page de commande.

Revenir: Nombre

Purchase_Price()

Cette méthode renvoie le prix final que les acheteurs doivent payer, après calculé avec frais d'inscription. Cette méthode est utilisée uniquement pour les produits d'abonnement.

Revenir: Nombre

Get_Price(Booléen $short = false)

Retourne une chaîne de prix du produit. Vous pouvez appliquer le filtre get_price Pour formater le résultat final.

$short Afficher le format court de prix

Revenir: Chaîne

Exemple: Si le produit est unique, faire écho à l'un des résultats

echo $Product->Get_Price();

// 30$
// <strike class='font-xs'>30$</strike> <b>19$</b>
// Ordinaire: <strike>30$</strike><br/>Vente: <b>19$</b>

Exemple: Si le produit est un groupe

echo $Product->Get_Price();

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

Exemple: Si le produit est un abonnement, écho quelque chose comme ci-dessous

echo $Product->Get_Price();

// 9$ / Mois pendant 6 mois
// 3$ À l'avance alors 9$ / Mois après 1 semaine Essai gratuit
// 0$ À l'avance alors 9$ / Mois après 1 mois Essai gratuit

Exemple: appliquer le filtre

// Ajouter la fonction de filtre ci-dessous à functions.php
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();

// Si le produit est unique
// 30$
// <small class='font-xs'>30$</small> <b>19$</b>
// Ordinaire: <small>30$</small><br/>Vente: <b>19$</b>

// Si le produit est un groupe
// 30$ to 50$

// Si le produit est abonné
// 3$ À l'avance alors 9$ / Mois après 1 semaine période LIBRE

Get_Relates(Int $number = 8)

Renvoie un tableau qui contient des objets de produits connexes. Ces produits similaires sont calculés en fonction du nom du produit.

$number Par défaut, chercher 8 produits associés seulement

Revenir: Arbre d'objets

Get_Childs()

Retourne un tableau d'objets qui contient des produits enfants. Cette méthode est utilisée si le produit est un groupe. Le résultat renvoie FALSE si le produit n'est pas un groupe, renvoie NULL s'il n'y a pas d'enfants ou retourne des enfants.

Revenir: Arbre d'objets / NULL / FALSE

Get(Chaîne $attr)

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

$attr Attribut aimerait récupérer, attributs supplémentaires

featured_image Image du produit

tags Toutes les balises de produit, retourner tableau de balises si existent

Revenir: Array / String

is(Chaîne $type)

Détecter si le produit est vraiment quelque chose.

$type Attribut aimerait détecter des valeurs acceptables:

saleoff Vérifier si le produit est en vente (escompte)
new Retourner TRUE si le produit est nouveau
instock Retourner TRUE si le produit est encore en stock
outstock Retourner TRUE si le produit est en rupture de stock
group Détecter si le produit est un groupe
subscription Vérifier si le produit est un abonnement
single Vérifier si le produit est unique
digital Vérifier si le produit est numérique

Revenir: VRAI FAUX

List_Products(Chaîne $type = '',Chaîne $condition = '',Int $number = 10,Booléen $parent = false)

Cette classe est utilisée pour répertorier les produits, filtrés par vos règles et conditions.

$type Filtre principal que vous devez appliquer; Par défaut, cette classe renvoie de nouveaux produits; Valeurs acceptables:

featured Sélectionner uniquement les produits en vedette
discounted Choisissez les produits ont la remise ou la vente seulement
childs Choisir les enfants du produit, $condition Est l'ID parent
cart Pick est dans le panier, utilisé avec $condition Est un tableau d'ID de produit
relate Produits liés à la $condition Est un tableau d'ID et Nom du produit actuel
order_add_item Recherche de produits à ajouter dans l'ordre, utilisé dans la page de gestion des commandes avec l'autorisation du propriétaire du magasin

$condition Conditions supplémentaires que vous souhaitez appliquer

$number Limitez le nombre de produits que vous souhaitez récupérer; Par défaut, récupérer 10 produits seulement

$parent Si TRUE, sélectionnez des produits qui ne sont pas dans un groupe

Revenir: Arbre d'objets / NULL

Exemple

// Obtenir de nouveaux produits
$New_Products = new List_Products();

// Obtenir 10 nouveaux produits
$New_Products = new List_Products('', '', 10);

// Obtenir de nouveaux produits avec la chaîne \'VIP\' dans le nom ou la description
$New_Products = new List_Products('', 'VIP');

// Obtenir des produits en vedette
$Item_Featured = new List_Products('featured');

// Obtenir les 10 meilleurs produits à prix réduits
$Item_Discounted = new List_Products('discounted', '', 10);

// Obtenir des produits dans le panier, utilisés dans le panier et les pages de caisse
$Cart_Items = new List_Products('cart');

// Ou utiliser cette solution longue
$Cart_Items = new List_Products('cart', array_keys($_COOKIE[ $shop_cookie_name ]['cart']) );

// Obtenir 10 produits lorsque les visiteurs utilisent la fonctionnalité de recherche, et trier par prix descendre
$Items = new List_Products("price DESC", $keyword, 10);

// Obtenir des produits par heure décroissante
$Items = new List_Products("time DESC");

// Obtenir des produits par populaires
$Items = new List_Products("pageviews DESC");

// Obtenir des articles connexes du produit actuel
$Items = new List_Products('relate');

// Ou utiliser cette solution longue
$Items = new List_Products('relate', 
    array('id' => $Product->get('id'), 'name' => $Product->get('name'))
);

// Obtenir des articles enfants du produit actuel
$Items = new List_Products('childs');

// Ou utiliser cette solution longue
$Items = new List_Products('childs', $Product->get('id'));

if( $Items->length>0 )
{
  // Traitez vos emplois ici
}

Total(Chaîne $type = '',Chaîne $keyword = '')

Cette méthode statique compte les produits avec vos règles et conditions.

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

featured Compter tous les produits en vedette
discounted Compter tous les produits à prix réduit

Revenir: VRAI FAUX

Exemple

// Compter tous les produits en vedette
echo List_Products::Total('featured');

// Compter tous les produits à prix réduit
echo List_Products::Total('discounted');

// Compter tous les produits avec la chaîne \'VIP\' dans le nom ou la description
echo List_Products::Total('', 'VIP');

// Compter tous les produits avec abonnement
echo List_Products::Total("item_type='subscription'");

// Compter tous les produits téléchargeables
echo List_Products::Total("downloadable=1");

// Compter tous les produits non publiés (rédigés)
echo List_Products::Total("published_time=0");

// Compter tous les produits de vente-off (actualisés)
echo List_Products::Total("price_sale>0");

// Compter tous les produits avec abonnement et essai gratuit
echo List_Products::Total("signup_fee>0");

get(Int &$id)

Retourne un objet du produit dans la liste actuelle.

$id La valeur ID du produit doit être récupérée

Revenir: Object / NULL

getAll()

Renvoie un tableau de l'objet produit dans la liste actuelle.

Revenir: Arbre d'objets

getIDs()

Renvoie un tableau d'ID de produits dans la liste actuelle.

Revenir: Array

Shop_Order(Array $order_properties)

Retourne un objet de l'ordre du magasin.

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

Revenir: Object / NULL

Exemple

// Obtenir l'ordre des magasins
$Shop_Order = new Shop_Order($order_id);

// Ou utiliser cette solution longue
$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(Chaîne $type)

Détecter si l'ordre est vraiment quelque chose.

$type Attribut aimerait détecter des valeurs acceptables:

subscription Vérifier si la commande est un abonnement
shipping Vérifier si l'ordre a des articles tangibles doivent être expédiés
suspended Retourner TRUE si l'ordre est suspendu
downloadable Retourner TRUE si l'ordre a des fichiers téléchargeables

Revenir: VRAI FAUX

Subscription_Price(Booléen $short = false)

Renvoie une chaîne de prix formatée, en fonction des paramètres de devise de magasin. Cette méthode a utilisé pour montrer le prix total de la commande dans le panier, les pages de caisse, les pages de commande; Et pour l'affichage seulement but, pas pour calculer.

Utilisation $Shop_Order->get('purchase_price') Si vous voulez obtenir un prix d\'abonnement, ou pour le calcul.

$short Si VRAI, renvoyer le format court

Revenir: Chaîne

get(Chaîne $attr, Chaîne $option = '')

Renvoie un attribut (champ de table de base de données) d'ordre. Check-out Tableau des commandes Pour les champs que vous pouvez obtenir..

$attr Attribut aimerait récupérer; À côté des champs de tableau, vous pouvez également utiliser ces attributs définis:

date Récupérer la date de commande créée, le résultat est formaté par le format de date du propriétaire du magasin
date_completed Récupérer la date terminée (date de paiement) de l'ordre, le résultat est formaté par le format de date du propriétaire du magasin
items Retourner la liste des produits dans l'ordre, utilisé avec le second paramètre $option
count Retour total des produits
list Retourner une chaîne de produits, inclure un lien vers chaque produit et le nombre d'achats
id Renvoie une matrice d'ID de produit
default Retour de produits
files Récupérer un tableau de fichiers téléchargeables dans l'ordre ou renvoyer uniquement le nombre de fichiers si le second paramètre est défini $option = 'count'
buyer_name Retour nom complet de l'acheteur
buyer_email Retourner le lien à l'email de l'acheteur ou de l'email seulement si le deuxième paramètre fixé $option = 'raw'
buyer_phone Renvoyer le lien au numéro de téléphone de l'acheteur ou du numéro de téléphone seulement si le deuxième paramètre $option = 'raw'
ship_fullname Renvoyer le nom complet de l'expéditeur
ship_fax Retour de la personne expédiée
ship_company Compagnie de retour de la personne expédiée
ship_email Retourner le lien à l'email de la personne expédiée ou du courrier électronique seulement si le deuxième paramètre réglé $option = 'raw'
ship_phone Renvoyer le lien au numéro de téléphone de la personne expédiée ou du numéro de téléphone seulement si le deuxième paramètre $option = 'raw'
ship_address Adresse de retour
payment_method Méthode de retour nom du paiement choisi ou slug de méthode si paramètre second paramètre $option = 'key'
payment_guide Retour guide payant de la méthode choisie
paypal_link Le lien de retour à Paypal pour payer si l'ordre est impayé et la méthode de paiement est Paypal

$option Option supplémentaire à récupérer

Revenir: Chaîne

N\'hésitez pas à nous contacter si votre truc est en dehors de cette section
En utilisant le bouton de contact ci-dessus ou envoyez directement à hello@gomymobi.com Avec sujet: [contactgmm]
Si ne pouvait pas recevoir notre réponse dans les 24 heures, s'il vous plaît renvoyer le billet à nouveau