Aller au contenu

Pour les développeurs

Documentation pour développeurs

Architecture, modèle de données, API PHP, hooks et filtres, modèles, événements JavaScript et points de terminaison REST pour étendre le plugin Tiered Pricing Table.

Sur cette page

Introduction

Cette page s’adresse aux développeurs qui veulent ajuster ou étendre Tiered Pricing Table for WooCommerce avec du code : lire et modifier les prix, remplacer des modèles, se brancher sur le JavaScript, utiliser l’API REST et, surtout, consulter la liste complète des actions et des filtres. La documentation destinée aux propriétaires de boutique se trouve dans le Guide de l’utilisateur.

Conventions

Le code se trouve dans l’espace de noms TierPricingTable\ (src/), les modèles dans views/. Chaque hook est préfixé par tiered_pricing_table/ et utilise / comme séparateur, par exemple tiered_pricing_table/price/pricing_rule. Les réglages sont des options préfixées par tier_pricing_table_. La plupart des filtres peuvent être branchés depuis un thème ou un plugin à tout moment ; les trois filtres de démarrage addons/list, integrations/plugins et integrations/themes s’exécutent pendant l’inclusion du fichier du plugin et doivent être branchés depuis un plugin must-use ou un plugin chargé avant tier-pricing-table.

Prix et règles

Lire la règle et le prix effectifs

use TierPricingTable\PriceManager;

$rule = PriceManager::getPricingRule( $product_id );   // TierPricingTable\PricingRule — product meta + role/customer/global rules applied

$rule->getRules();            // [ 5 => 9.5, 10 => 8.0 ] (fixed), [ 5 => 10, 10 => 20 ] (percentage) or [ 5 => 1.5, 10 => 3 ] (amount off per unit)
$rule->getType();             // 'fixed' | 'percentage' | 'amount'
$rule->getMinimum();          // ?int
$rule->provider;              // 'product' | 'role-based' | 'user-based' | 'global-rules' | …
$rule->providerData;          // e.g. [ 'rule_id' => 42, 'applying_type' => 'cross' ] or [ 'role' => 'wholesale' ]
$rule->data;                  // 'maximum_quantity', 'group_of_quantity', 'tier_labels', …
$rule->pricingData;           // base-price overrides: regular_price, sale_price, discount, discount_type, pricing_type, tax_status, tax_class

$unit = $rule->getTierPrice( 12 );                 // display price for qty 12 (false if below the first tier)
$unit = $rule->getTierPrice( 12, false, 'cart' );  // raw price, cart context

$has = ! empty( $rule->getRules() );
$has = \TierPricingTable\PricingTable::getInstance()->productHasPricingRules( $product ); // variable products too

Modifier la règle de n’importe quel produit

tiered_pricing_table/price/pricing_rule reçoit le PricingRule après la lecture des métadonnées du produit. Les fournisseurs intégrés utilisent ces priorités ; choisissez la vôtre par rapport à elles : limites de quantité 1, règles de catégorie 10, par rôle 20, par client 25, règles globales 30, demande de devis 99, conversion de devise 9999.

add_filter( 'tiered_pricing_table/price/pricing_rule', function ( \TierPricingTable\PricingRule $rule, int $productId ) {
    if ( has_term( 'clearance', 'product_cat', $productId ) ) {
        $rule->setType( 'percentage' );
        $rule->setRules( [ 3 => 15, 6 => 25 ] );      // 15 % off from 3 units, 25 % from 6
        $rule->logPricingModification( 'Clearance tiers applied by my-plugin' ); // shown in Debug mode
    }
    return $rule;
}, 40, 2 );

Autres filtres utiles : …/price/price_by_rules (prix unitaire final pour une quantité), …/price/round_price / …/price/round_precision, …/cart/product_cart_price (prix appliqué à une ligne du panier), …/cart/total_product_count (quantité utilisée pour choisir le palier dans le panier), …/cart/need_price_recalculation (ignorer une ligne), …/services/regular_pricing/price (prix normal/promotionnel ajusté pour l’utilisateur courant), …/global_pricing/matched_pricing_rule (quelle règle globale s’applique).

Écrire des règles par programmation

Clé de métadonnée (produit / variation)Valeur
_fixed_price_rulesarray<int qty, string price> : par exemple [5 => '9.50', 10 => '8.00']
_percentage_price_rulesarray<int qty, string percent>
_amount_price_rulesarray<int qty, string amount> : un montant déduit du prix du produit par unité
_tiered_price_rules_typefixed | percentage | amount
_tiered_price_minimum_qtyentier > 1
_tiered_pricing_maximum_quantity, _tiered_pricing_group_of_quantityentier (maximum, pas)
_tiered_price_mix_and_match_minimumyes | no (parent variable)
_tiered_pricing_template, _tiered_pricing_base_unit_nameidentifiant de mise en page ; ['singular' => …, 'plural' => …]
_{role}_fixed_price_rules, _{role}_percentage_price_rules, _{role}_amount_price_rules, _{role}_tiered_price_rules_type, _{role}_tiered_price_minimum_qty, _{role}_tiered_price_pricing_type, _{role}_tiered_price_regular_price, _{role}_tiered_price_sale_price, _{role}_tiered_price_discount, _{role}_tiered_price_discount_typerègles par rôle ({role} = identifiant du rôle) ; les règles par client utilisent _user_{userId}_…
// Product-level
update_post_meta( 123, '_fixed_price_rules', [ 5 => '9.50', 10 => '8.00' ] );
update_post_meta( 123, '_tiered_price_rules_type', 'fixed' );
\TierPricingTable\PriceManager::updateProductMinimumQuantity( 123, 5 );

// Role-based
\TierPricingTable\Addons\RoleBasedPricing\RoleBasedPricingRule::buildFromArray( 123, 'wholesale', [
    'pricing_type' => 'flat', 'regular_price' => 20, 'sale_price' => 18,
    'tiered_pricing_type' => 'fixed', 'fixed_tiered_pricing_rules' => [ 10 => 17, 50 => 15 ],
    'minimum_order_quantity' => 5,
] )->save();

// Global rule (post type tpt-global-rule)
use TierPricingTable\Addons\GlobalTieredPricing\CPT\GlobalTieredPricingCPT;
use TierPricingTable\Addons\GlobalTieredPricing\GlobalPricingRule;

$ruleId = wp_insert_post( [ 'post_type' => GlobalTieredPricingCPT::SLUG, 'post_status' => 'publish', 'post_title' => 'Wholesale tiers' ] );
$rule   = GlobalPricingRule::fromArray( [ 'tiered_pricing_type' => 'fixed', 'fixed_rules' => [ 10 => 9.5, 50 => 8 ], 'minimum' => 5, 'applying_type' => 'individual' ] );
$rule->setId( $ruleId );
$rule->setIncludedProductCategories( [ 15 ] );
$rule->setIncludedUsersRole( [ 'wholesale' ] );
$rule->save();

// Cart rule: a discount on the cart once its subtotal reaches a tier (applied as a virtual coupon)
$orderRuleId = wp_insert_post( [ 'post_type' => GlobalTieredPricingCPT::SLUG, 'post_status' => 'publish', 'post_title' => 'Spend more, save more' ] );
$orderRule   = GlobalPricingRule::fromArray( [
    'kind'                     => 'order',
    'order_basis'              => 'amount',                    // or 'quantity': the tiers compare with the item count
    'order_discount_type'      => 'fixed',                     // an amount off, or 'percentage' (premium)
    'order_tiers'              => [ [ 'from' => 300, 'discount' => 25 ], [ 'from' => 600, 'discount' => 60 ] ],
    'order_label'              => 'Order discount {discount}', // placeholders: {discount}, {threshold}
    'order_free_shipping'      => 'amount',                    // 'none', 'always', 'amount' or 'quantity'
    'order_free_shipping_from' => 500,
    'order_shipping_bar'       => 'yes',                       // premium
    'order_minimum_amount'     => 50,                          // premium
    'priority'                 => 10,
] );
$orderRule->setId( $orderRuleId );
$orderRule->setIncludedProductCategories( [ 15 ] ); // optional scope: only these lines count and are discounted; none = the whole cart
$orderRule->save();

\TierPricingTable\Core\ServiceContainer::getInstance()->getCache()->purge();

Métadonnées de règle globale d’une règle de panier (_tpt_rule_kind = order) : _tpt_rule_kind (product \| order), _tpt_order_basis (amount \| quantity : ce à quoi les paliers sont comparés), _tpt_order_tiers (lignes de from et discount), _tpt_order_discount_type (fixed \| percentage), _tpt_order_label, _tpt_order_free_shipping (none \| always \| amount \| quantity), _tpt_order_free_shipping_from, _tpt_order_shipping_bar (yes \| no), _tpt_order_shipping_bar_message, _tpt_order_shipping_bar_reached, _tpt_order_minimum_amount, _tpt_order_minimum_quantity. fromArray() accepte les mêmes clés sans le préfixe _tpt_ (kind, order_basis, order_tiers, order_discount_type, order_label, order_free_shipping, order_free_shipping_from, order_shipping_bar, order_shipping_bar_message, order_shipping_bar_reached, order_minimum_amount, order_minimum_quantity). Lors d’une mise à jour, OrderDiscounts\MinimumsMigration transforme le tableau des minimums des anciennes règles de panier par rôle en une règle de commande par rôle (l’option tier_pricing_table_order_minimums_migrated en garde la trace). Dans le panier, OrderDiscounts\OrderDiscountResolver::resolve( WC_Cart $cart, ?WP_User $user ) renvoie le OrderDiscount que le panier a gagné (règle, palier, sous-total pris en compte, propriétés du coupon) et nextTier() ce qui manque pour le suivant. OrderDiscounts\FreeShippingBar::progress( ?WC_Cart $cart, ?WP_User $user ) renvoie l’état de la barre de livraison gratuite (règle, mode, seuil, valeur, reste, atteint, pourcentage), progressFor( $rule, $counted ) la même chose à partir d’une règle et de lignes comptées, et render( $context ) le HTML de la barre.

Modèles

Afficher le tableau vous-même

ob_start();
\TierPricingTable\PricingTable::getInstance()->renderPricingTable( $product_id, null, [ 'display' => true, 'display_type' => 'blocks', 'title' => 'Volume pricing' ] );
$html = ob_get_clean();

Clés de réglages que vous pouvez passer : display_type (table, blocks, options, dropdown, horizontal-table, plain-text, tooltip), title, quantity_column_title, price_column_title, discount_column_title, quantity_type (range \| static), show_discount_column, clickable_rows, active_tier_color, table_style, blocks_style, options_style, compact_layout, options_show_total, options_show_original_product_price, options_show_default_option, options_option_text, plain_text_option_text, update_price_on_product_page, show_total_price, quantity_measurement_singular, quantity_measurement_plural. Les mêmes clés fonctionnent comme attributs de shortcode. Utilisez tiered_pricing_table/should_render_pricing_table pour supprimer l’affichage automatique et tiered_pricing_table/display_settings pour modifier les réglages à la volée.

Remplacer les modèles depuis un thème

Copiez n’importe quel fichier du dossier views/frontend/ du plugin (tiered-pricing-table.php, tiered-pricing-blocks-style-3.php, summary-table.php, …) dans **wp-content/themes/{your-theme}/tiered-pricing-table/** et modifiez-le là. tiered_pricing_table/template/location permet à un plugin de rediriger un modèle.

Dossier de remplacement dans le thème

Variables dans les modèles de mise en page : $pricing_rule (PricingRule), $price_rules, $pricing_type, $minimum, $product, $product_id, $settings, $id.

Respecter le contrat de balisage

Le JavaScript lit le balisage : conservez l’id de l’élément racine, data-product-id, data-price-rules, data-minimum, data-regular-price, data-sale-price, data-price, data-product-price-suffix, un élément par palier avec data-tiered-quantity / data-tiered-price / data-tiered-price-exclude-taxes / data-tiered-price-include-taxes, la ligne de base avec data-tiered-quantity="{minimum}" et la classe tiered-pricing--active, ainsi que les fonctions utilitaires tptParseOptionText() / tptParsePlainText().

Injecter du contenu dans les mises en page

// Extra column in the table layouts
add_action( 'tiered_pricing_table/tiered_pricing/header_columns', fn() => print '<th>Total</th>' );
add_action( 'tiered_pricing_table/tiered_pricing/row_columns', function ( \TierPricingTable\PricingRule $rule, $qty ) {
    $qty   = $qty ?: max( 1, (int) $rule->getMinimum() ); // null = base row
    $price = $rule->getTierPrice( $qty );
    echo '<td>' . ( $price ? wc_price( $price * $qty ) : '—' ) . '</td>';
}, 10, 2 );

// Badge next to a tier in every layout
foreach ( [ 'table', 'horizontal-table', 'blocks', 'options', 'dropdown', 'plain-text' ] as $layout ) {
    add_action( "tiered_pricing_table/{$layout}/label", function ( $rule, $qty ) {
        if ( 50 === (int) $qty ) { echo '<span class="my-badge">Best value</span>'; }
    }, 10, 2 );
}

// "100 or more" instead of "100+"
add_filter( 'tiered_pricing_table/tiered_pricing/last_tier_postfix', fn() => ' or more' );

Tous les hooks de mise en page sont listés sous Hooks de modèle.

JavaScript

Le moteur frontend (tiered-pricing-table-front-js, jQuery) expose document.__tieredPricing :

// Point the plugin at a custom quantity input / price container
document.__tieredPricing = document.__tieredPricing || { overrides: {} };
document.__tieredPricing.overrides.$getQuantityField  = ( parentId ) => jQuery( '#my-qty-' + parentId );
document.__tieredPricing.overrides.$getPriceContainer = ( productId, parentId ) => jQuery( '#my-price-' + parentId );

// React to quantity changes
jQuery( document ).on( 'tiered_price_update', '.tpt__tiered-pricing', function ( event, data ) {
    // data.quantity, data.price, data.price_excl_tax, data.productId, data.parentId,
    // data.pricing = { price, price_excl_tax, price_incl_tax, priceHtml, tieredQuantity, eventQuantity }
} );

// Set the quantity
jQuery( '.quantity-input-product-123' ).val( 10 ).trigger( 'change' );

// Initialise tables inserted after page load (quick view, AJAX)
document.querySelectorAll( '.tpt__tiered-pricing' ).forEach( function ( el ) {
    if ( ! el.__tptInit ) { el.__tptInit = true; document.__tieredPricing.initFunction( el ); }
} );

Le prix du produit affiché en direct est le HTML de prix de WooCommerce enveloppé dans <span class="tiered-pricing-dynamic-price-wrapper" data-price-type="dynamic|static|no-rules"> ; renvoyez static depuis tiered_pricing_table/frontend/default_price_behaviour_type pour conserver le prix de WooCommerce, ou false depuis …/frontend/wrap_price pour ignorer l’enveloppe. Points d’accroche de style : .tpt__tiered-pricing, .tiered-pricing--active, .tiered-pricing-table, .tiered-pricing-block, .tiered-pricing-option, .tiered-pricing-dropdown, .tier-pricing-summary-table, .tiered-pricing-you-save, .tiered-pricing-tier-label.

Shortcodes, bloc et widget

Point d’intégrationDétails
[tiered-pricing-table]product_id (l’article courant par défaut) ainsi que n’importe quelle clé de réglages de Afficher le tableau vous-même : par exemple [tiered-pricing-table product_id="123" display_type="blocks" title="Volume pricing"]
[tiered_price_you_save]product_id, color, template, consider_sale_price
[tiered_pricing_wholesale_registration]Le formulaire de demande de compte grossiste (8.0.0+). Aucun attribut ; le formulaire, ses champs et ses messages viennent de Réglages → Vente en gros. Affiche une note réservée au gérant de boutique tant que la fonctionnalité est désactivée.
[tiered_pricing_free_shipping_bar]La barre de livraison gratuite de la règle de panier dont relève le panier du visiteur (8.3.0+, premium). Aucun attribut ; les messages, les couleurs et la hauteur viennent de la règle et de la page de réglages des règles de panier (la section de réglages order-rules, listée dans la navigation uniquement lorsqu’elle est ouverte). Affiche un div.tpt-free-shipping-bar-live vide lorsqu’aucune règle avec barre ne s’applique ; les fragments du panier actualisent chaque conteneur de ce type lors d’un ajout au panier.
Block tiered-pricing-table/free-shipping-barLa même barre sous forme de bloc (aucun attribut ; prend en charge l’alignement et l’espacement).
Block tiered-pricing-table/tiered-pricing-blockdisplayType, title, activeTierColor, showDiscountColumn, titres de colonnes
Elementor widget tiered-pricing-tableproduct_id, display_type, title, active_tier_color, titres de colonnes, réglages des options et de l’unité de mesure

API REST

Les points d’accès produit et variation de WooCommerce (/wp-json/wc/v3/products/{id}, /products/{id}/variations/{vid}) lisent et écrivent ces champs :

ChampValeur
tiered_pricing_typefixed | percentage | amount
tiered_pricing_fixed_rules, tiered_pricing_percentage_rules, tiered_pricing_amount_rules{ "<qty>": <price|percent|amount off> }
tiered_pricing_minimum_quantityentier ou null
tiered_pricing_roles_data{ "<role>": { pricing_type, regular_price, sale_price, discount, discount_type, tiered_pricing_type, fixed_rules, percentage_rules, amount_rules, minimum, tax_status, tax_class } } : l’écriture remplace toutes les données de rôle ; envoyez les paliers et le minimum sous la forme fixed_tiered_pricing_rules, percentage_tiered_pricing_rules, amount_tiered_pricing_rules, minimum_order_quantity
tiered_pricing_product_settings{ "layout": "default"|<layout>, "base_unit_name": { "singular", "plural" }, "default_variation": <id> }
PUT /wp-json/wc/v3/products/123
{
  "tiered_pricing_type": "percentage",
  "tiered_pricing_percentage_rules": { "10": 5, "50": 12.5 },
  "tiered_pricing_minimum_quantity": 5,
  "tiered_pricing_roles_data": { "wholesale": { "pricing_type": "percentage", "discount": 15, "tiered_pricing_type": "fixed", "fixed_tiered_pricing_rules": { "10": 7.5 }, "minimum_order_quantity": 4 } }
}

Ajoutez votre propre champ en étendant TierPricingTable\Services\API\ProductFields\ProductField et en ajoutant la classe avec tiered_pricing_table/api/product_fields. Routes du plugin : tier-pricing-table/v1/quote-request (POST, public), /quote-forms, /quote-settings, /tax-settings, tier-pricing-table/features/tier-labels/v1/labels, …/custom-columns/v1/columns, …/tools/v1/*. Colonnes d’import/export CSV WooCommerce : tiered_price_fixed, tiered_price_percentage (qty:value,…), tiered_price_type, tiered_price_minimum et, par rôle, {role}_tiered_price_*.

Étendre l’administration

// A setting in the General tab (option tier_pricing_table_my_hide_for_guests, 'yes' | 'no')
add_filter( 'tiered_pricing_table/settings/general_settings', function ( array $fields ) {
    $fields[] = [
        'title'   => 'Hide table for guests',
        'id'      => \TierPricingTable\Settings\Settings::SETTINGS_PREFIX . 'my_hide_for_guests',
        'type'    => \TierPricingTable\Settings\CustomOptions\TPTSwitchOption::FIELD_TYPE,
        'default' => 'no',
    ];
    return $fields;
} );

// An integration with its own on/off toggle under Settings → Integrations (boot-time filter)
class My_Integration extends \TierPricingTable\Integrations\Plugins\PluginIntegrationAbstract {
    public function getTitle(): string       { return 'My Plugin'; }
    public function getDescription(): string { return 'Adds option costs to tiered prices.'; }
    public function getSlug(): string        { return 'my-plugin'; }
    public function run() { add_filter( 'tiered_pricing_table/cart/product_cart_price', [ $this, 'addOptionsCost' ], 20, 2 ); }
}
add_filter( 'tiered_pricing_table/integrations/plugins', fn( array $list ) => array_merge( $list, [ My_Integration::class ] ) );
  • Onglets et champs de réglages : tiered_pricing_table/settings/sections, …/general_settings, …/general_subsections, …/calculation_logic (groupe Calcul des prix), …/advanced_settings, …/tools_settings, …/sections_order. Types de champs : tpt_switch_option, tpt_display_type, tpt_text_template, tpt_link_button.
  • Éditeur de produit : affichez des champs sur tiered_pricing_table/admin/pricing_tab_begin|after_minimum_order_quantity_field|advance_product_options|pricing_tab_end ($postId ; after_minimum_order_quantity_field transmet aussi $loop et le préfixe du nom de champ, '_variable' dans la section Produit variable) et à l’intérieur du formulaire de règles (…/admin/tiered_pricing_rules_form/form_begin|inputs|form_end) ; enregistrez sur woocommerce_process_product_meta / woocommerce_save_product_variation. Nommez les champs avec TierPricingTable\Forms\Form::getFieldName( $base, $role, $loop ).
  • Règles par rôle / par client : affichez sur …/admin/role_based_rules/after_tiered_pricing_rules_field (et user_based_rules), enregistrez sur …/role_based_rules/save_role_based_rules (et user_based_rules/save_user_based_rules).
  • Règles globales : ajoutez un onglet avec tiered_pricing_table/global_pricing/form_tabs (étendez CPT\Form\FormTab), enregistrez dans …/global_pricing/before_updating, lisez vos métadonnées dans …/global_pricing/after_built_rule, ajoutez des colonnes de liste avec …/global_pricing/columns.
  • Colonnes de tableau personnalisées : étendez Addons\CustomColumns\Columns\AbstractCustomColumn et enregistrez-la avec tiered_pricing_table/custom_columns/available_columns_types + …/custom_columns/columns_handlers.
  • Modules complémentaires : étendez Addons\AbstractAddon et ajoutez-le avec tiered_pricing_table/addons/list (filtre de démarrage) ; il obtient un interrupteur dans l’onglet Modules.

Débogage

  • Le mode débogage (Réglages → Modules → Débogage) affiche la règle résolue sous chaque ligne du panier et dans le tableau de prix, y compris le journal écrit avec PricingRule::logPricingModification().
  • Cache : le HTML des prix du catalogue est mis en cache dans le transient tpt_product_data ; videz-le depuis Réglages → Modules → Cache ou avec ServiceContainer::getInstance()->getCache()->purge().
  • $GLOBALS['tpt_current_user_id'] fait exécuter chaque calcul de prix pour cet utilisateur (les commandes manuelles l’utilisent).

Référence des hooks

Chaque filtre et chaque action déclenchés par le plugin, regroupés par thème. Le Type est F (filtre : renvoyez le premier paramètre) ou A (action). Les paramètres sont listés dans l’ordre ; le premier paramètre d’un filtre est la valeur à renvoyer. Chaque ligne est accessible par un lien direct (l’identifiant de la ligne est hook- + le nom du hook dont les caractères non alphanumériques sont remplacés par -). Tous les noms sont préfixés par tiered_pricing_table/ sauf indication contraire.

Démarrage et services

HookTypeParamètresDescription
tpt_fs_loadedA—SDK Freemius initialisé (tpt_fs() disponible).
tiered_pricing_table/container/service_instanceFstring $classNameNom de classe instanciée par ServiceContainer::initService() : renvoyez une sous-classe pour remplacer un service.
tiered_pricing_table/addons/listFarray<string,AbstractAddon> $addonsInstances des modules complémentaires indexées par classe, avant run() : ajoutez, retirez ou remplacez des modules.
tiered_pricing_table/supported_simple_product_typesFstring[] $typesPar défaut simple, variation, subscription, subscription-variation.
tiered_pricing_table/supported_variable_product_typesFstring[] $typesPar défaut variable, variable-subscription.
tiered_pricing_table/supported_variation_product_typesFstring[] $typesPar défaut variation, subscription-variation.
tiered_pricing_table/pricing_layoutsFarray<string,string> $layoutsIdentifiant de mise en page ⇒ libellé (table, blocks, options, dropdown, horizontal-table, plain-text, tooltip).
tiered_pricing_table/current_userFWP_User $userL’utilisateur pour lequel les prix sont calculés (par défaut : l’utilisateur courant, ou $GLOBALS['tpt_current_user_id']).
tiered_pricing_table/current_user_rolesFstring[] $roles, int $userIdRôles utilisés pour la tarification par rôle et les clés de cache ; un visiteur non connecté reçoit le pseudo-rôle guest.
tiered_pricing_table/rules_separatorFstring $separatorSéparateur des listes qty:price dans l’import/export CSV (par défaut ,).
tiered_pricing_table/rule_separatorFstring $separatorSéparateur entre la quantité et le prix dans une même règle à l’export CSV (par défaut :). Les tableurs lisent 20:100 comme une heure ; renvoyez = pour obtenir 20=100. L’importeur accepte :, = et la valeur configurée.
tiered_pricing_table/template/locationFstring $absolutePath, string $templateChemin final de n’importe quel modèle (frontend/…, admin/…, addons/…).
tiered_pricing_table/template/before_renderAstring $absolutePath, array $variablesAvant l’inclusion d’un modèle.
tiered_pricing_table/template/after_renderAstring $absolutePath, array $variablesAprès l’inclusion d’un modèle.
tiered_pricing_table/assets/js/urlFstring $url, string $fileURL d’une ressource JS du plugin.
tiered_pricing_table/assets/css/urlFstring $url, string $fileURL d’une ressource CSS du plugin.

Calcul des prix

HookTypeParamètresDescription
tiered_pricing_table/price/pricing_ruleFPricingRule $rule, int $productIdPoint d’extension principal. La règle effective d’un produit après lecture des métadonnées au niveau du produit ; les fournisseurs (catégorie 10, rôle 20, client 25, global 30, devis 99) la modifient ici. Mise en cache par requête.
tiered_pricing_table/price/product_price_rulesFarray $rules, int $productId, string $typeRègles au niveau du produit lues dans les métadonnées (contexte view uniquement).
tiered_pricing_table/price/price_by_rulesFfloat|false $price, int $quantity, int $productId, string $context, string $place, PricingRule $rulePrix unitaire final pour une quantité (false = aucun palier ne correspond).
tiered_pricing_table/price/round_priceFbool $roundIndique s’il faut arrondir les prix des paliers (par défaut : l’option Arrondir le prix).
tiered_pricing_table/price/round_precisionFint $decimalsPrécision d’arrondi (par défaut max(2, wc_get_price_decimals())).
tiered_pricing_table/discount/decimalsFint $decimals, float $percent, ?WC_Product $product, ?PricingRule $ruleDécimales des remises en pourcentage affichées dans chaque mise en page et dans le champ {tp_discount} (par défaut 2 ; renvoyez 0 pour des nombres entiers comme « 10 % »).
tiered_pricing_table/price/typeFstring $type, int $productIdType de tarification au niveau du produit (fixed | percentage | amount).
tiered_pricing_table/price/minimumF?int $minimum, int $productIdQuantité minimale de commande au niveau du produit.
tiered_pricing_table/services/pricing_service_enabledFbool $enabledRenvoyez true pour activer RegularPricingService (filtres de prix WC). Les modules globaux, par rôle et par client le font.
tiered_pricing_table/services/regular_pricing/priceF?float $newPrice, ?WC_Product $product, ?string $specific ('regular'|'sale'|null), $originalPricePrix normal/promotionnel/courant ajusté pour l’utilisateur courant (null conserve la valeur de WooCommerce).
tiered_pricing_table/services/pricing/override_zero_pricesFbool $overrideIndique si les produits à prix zéro voient leur prix remplacé (par défaut true).
tiered_pricing_table/advanced_quantity/get_maximumF?int $value, int $productId, string|false $roleQuantité maximale pour un produit ; les valeurs propres à un rôle sont appliquées ici.
tiered_pricing_table/advanced_quantity/get_group_ofF?int $value, int $productId, string|false $rolePas de quantité pour un produit.
tiered_pricing_table/addons/category_tier_pricing_skip_categoryFbool $skip, int $productId, WC_Product $productIgnorer les anciennes règles au niveau de la catégorie pour un produit.
tiered_pricing_table/check_if_variable_product_has_rulesFbool $check, WC_Product $productRenvoyez true pour que productHasPricingRules() analyse les variations au lieu de supposer qu’un produit variable a des règles.

Panier et paiement

HookTypeParamètresDescription
tiered_pricing_table/cart/need_price_recalculationFbool $recalculate, array $cartItem, WC_Cart $cartRenvoyez false pour laisser le prix d’une ligne à WooCommerce (le module de coupons l’utilise à 999).
tiered_pricing_table/cart/product_cart_priceFfloat|false $price, array $cartItem, string $cartItemKey, int $totalQuantityPrix unitaire appliqué à la ligne du panier.
tiered_pricing_table/cart/total_product_countFint $count, array $cartItemQuantité utilisée pour choisir le palier d’une ligne (somme des variations lorsque Regrouper les variations est activé ; les règles globales cross additionnent les lignes correspondantes).
tiered_pricing_table/cart/need_price_recalculation/itemFbool $recalculate, array $cartItemIdem, pour le prix de ligne affiché.
tiered_pricing_table/cart/total_savingsFfloat $savings, WC_Cart $cartMontant affiché dans la ligne « Économies totales » des totaux du panier et du paiement classique.
tiered_pricing_table/cart/product_cart_price/itemFfloat|false $price, array $cartItemPrix unitaire affiché.
tiered_pricing_table/cart/product_cart_old_priceFfloat $oldPrice, array $cartItemPrix barré affiché à côté du prix remisé.
tiered_pricing_table/cart/item/consider_sale_price_as_discountFbool $consider, array $cartItemAfficher le prix promotionnel comme une remise dans le prix de la ligne du panier.
tiered_pricing_table/cart/recalculate_cart_item_subtotalFbool $recalculate, array $cartItem, string $key, string $subtotalHtmlIndique si la cellule du sous-total est réécrite en ancien/nouveau prix.
tiered_pricing_table/cart/subtotal/consider_sale_price_as_discountFbool $consider, array $cartItem, string $keyIdem pour le sous-total (par défaut : l’option).
tiered_pricing_table/minimum_quantity/control_cart_quantity_fieldFbool $control, WC_Product $productLaisser le module de quantité minimale définir min sur le champ de quantité du panier.
tiered_pricing_table/minimum_quantity/item_quantityFint $quantity, int $productIdQuantité comparée au minimum.
tiered_pricing_table/manual_created_orders/modify_item_priceFbool $modify, WC_Order_Item_Product $itemIgnorer une ligne lors du recalcul d’une commande manuelle avec la tarification échelonnée.

Page produit, prix dynamique et catalogue

HookTypeParamètresDescription
tiered_pricing_table/should_render_pricing_tableFbool $render, int $parentProductId, ?int $variationId, array $settingsRenvoyez false pour supprimer tout le widget.
tiered_pricing_table/display_settingsFarray $settings, int $productIdRéglages de rendu finaux (l’identifiant du produit est celui de la variation lorsqu’elle est résolue).
tiered_pricing_table/frontend/enqueue_assetsFbool $enqueueIndique si le script et la feuille de style du frontend se chargent sur la page courante (par défaut true, sur toutes les pages). Renvoyez false selon vos propres conditions pour les ignorer ; une page qui affiche un tableau de prix ou une grille de produits les charge quand même.
tiered_pricing_table/ajax_variations_thresholdFint $thresholdAu-delà de ce nombre, les variations se chargent par AJAX au lieu d’être pré-rendues (10 par défaut).
tiered_pricing_table/before_rendering_tiered_pricingAWC_Product $parentProduct, ?int $variationId, array $settingsAvant l’enveloppe.
tiered_pricing_table/before_rendering_tiered_pricing/innerAPricingRule $rule, WC_Product $product, array $settingsAvant l’inclusion d’un modèle de mise en page (aussi pour chaque variation pré-rendue ou chargée par AJAX). Le mode débogage affiche ses informations ici.
tiered_pricing_table/product/default_variationF?WC_Product_Variation $variation, int $productIdVariation affichée par défaut pour un produit variable.
tiered_pricing_table/frontend/wrap_priceFbool $wrap, WC_Product $product, string $priceHtmlEnvelopper le HTML du prix dans le span de prix dynamique.
tiered_pricing_table/frontend/wrap_variable_priceFbool $wrap, WC_Product $productIdem pour les produits variables.
tiered_pricing_table/frontend/default_price_behaviour_typeFstring $type ('dynamic'), WC_Product $product, string $priceHtml, string $contextdynamic (le JS réécrit le prix), static (le laisse tel quel), no-rules. $context vaut product-page ou shop-loop.
tiered_pricing_table/frontend/modify_price_suffixFbool $modify, string $suffix, WC_Product $product, $price, $qtyEnvelopper {price_including_tax} / {price_excluding_tax} dans des spans que le JS peut mettre à jour.
tiered_pricing_table/frontend/variation_render_settingsFarray $settings, int $variationId, string $displayContextRéglages des tableaux de variations chargés par AJAX.
tiered_pricing_table/frontend/load_variation/verify_nonceFbool $verify, string $nonce, string $actionActiver la vérification du nonce sur le point d’accès AJAX get_pricing_table (par défaut false).
tiered_pricing_table/catalog_pricing/price_htmlFstring $newHtml, string $defaultHtml, WC_Product $productHTML du prix du catalogue (le plus bas / la fourchette / personnalisé).
tiered_pricing_table/catalog_pricing/format_variation_priceFbool $format, string $defaultHtml, WC_Product $variationFormater aussi les prix des variations dans le catalogue (par défaut false).
tiered_pricing_table/text_template_variablesFarray $variablesChamps proposés dans les réglages de modèles de texte (tp_quantity, tp_discount, tp_rounded_discount, tp_price, tp_base_unit_name, tp_required_quantity, tp_next_price, tp_next_discount, tp_actual_discount, tp_ys_price, tp_ys_total_price, tp_ys_percentage_discount).

Hooks de modèle

Déclenchés à l’intérieur des modèles de mise en page dans views/frontend/. $args pour les actions de libellé vaut ['id' => $id, 'style' => '<style>'] ; $qty vaut null pour la ligne de base (minimum) dans row_columns.

HookTypeParamètresDescription
tiered_pricing_table/tiered_pricing/beforeAPricingRule $ruleAvant le tableau (styles de tableau, tableau horizontal).
tiered_pricing_table/tiered_pricing/header_columnsAPricingRule $ruleAffichez des cellules d’en-tête <th> supplémentaires (styles de tableau, tableau horizontal).
tiered_pricing_table/tiered_pricing/row_columnsAPricingRule $rule, ?int $qtyAffichez des cellules <td> supplémentaires pour chaque ligne.
tiered_pricing_table/tiered_pricing/rowsAPricingRule $rule, array $settings, string $templateNameLignes supplémentaires à la fin de <tbody>.
tiered_pricing_table/table/tfootAPricingRule $rule, array $settings, string $templateNamePied du tableau.
tiered_pricing_table/tiered_pricing/afterAPricingRule $rule, int $productIdAprès le tableau (le tableau horizontal ne passe que $rule).
tiered_pricing_table/tiered_pricing/last_tier_postfixFstring $postfix ('+'), int $qty, PricingRule $rule, string $layout ('table'|'blocks')Suffixe de la quantité du dernier palier (par exemple 100+).
tiered_pricing_table/table/labelAPricingRule $rule, int $qty, array $argsBadge à côté d’une quantité dans les mises en page en tableau.
tiered_pricing_table/horizontal-table/labelAPricingRule $rule, int $qty, array $argsBadge dans le tableau horizontal.
tiered_pricing_table/blocks/labelAPricingRule $rule, int $qty, array $argsBadge dans les mises en page en blocs.
tiered_pricing_table/options/labelAPricingRule $rule, int $qty, array $argsBadge dans les mises en page en options.
tiered_pricing_table/dropdown/labelAPricingRule $rule, int $qty, array $argsBadge dans la liste déroulante.
tiered_pricing_table/plain-text/labelAPricingRule $rule, int $qty, array $argsBadge dans les lignes de texte simple.
tiered_pricing_table/horizontal-table/after_columnsAPricingRule $rule, array $settingsColonnes supplémentaires dans la grille horizontale.
tiered_pricing_table/blocks/blocksAPricingRule $rule, array $settingsBlocs supplémentaires à l’intérieur de .tiered-pricing-blocks.
tiered_pricing_table/blocks/after_blocksAPricingRule $ruleAprès le conteneur de blocs.
tiered_pricing_table/options/optionsAPricingRule $rule, array $settingsOptions supplémentaires.
tiered_pricing_table/options/after_optionsAPricingRule $ruleAprès les options.
tiered_pricing_table/dropdown/optionsAPricingRule $ruleOptions <li> supplémentaires.
tiered_pricing_table/dropdown/after_optionsAPricingRule $ruleAprès la liste déroulante.
tiered_pricing_table/plain-text/lineAPricingRule $rule, array $settingsLignes supplémentaires.
tiered_pricing_table/plain-text/after_linesAPricingRule $rule, array $settingsAprès la liste.
tiered_pricing_table/product_page/before_table_summaryAstring $totalLabel, string $eachLabelAutour du récapitulatif des totaux (tableau et détaillé).
tiered_pricing_table/summary/before_inline_summaryAstring $totalLabel, string $eachLabelAvant le récapitulatif en ligne.
tiered_pricing_table/summary/after_inline_summaryAstring $totalLabel, string $eachLabelAprès le récapitulatif en ligne.

Libellés de paliers et colonnes personnalisées

HookTypeParamètresDescription
tiered_pricing_table/addons/tier_labels/label_htmlFstring $html, TierLabel $labelBalisage du libellé rendu.
tiered_pricing_table/custom_columns/available_columns_typesFarray<string,string> $typesEnregistrer un type de colonne (type ⇒ libellé).
tiered_pricing_table/custom_columns/available_data_typesFarray $typesprice, number, text.
tiered_pricing_table/custom_columns/columns_handlersFarray<string,string> $handlersType de colonne ⇒ classe de gestionnaire (étend AbstractCustomColumn).
tiered_pricing_table/custom_columns/show_custom_columnFbool $visible, AbstractCustomColumn $columnMasquer/afficher une colonne.
tiered_pricing_table/custom_columns/nameFstring $name, AbstractCustomColumn $columnTexte d’en-tête de colonne.
tiered_pricing_table/custom_columns/valueFmixed $value, PricingRule $rule, ?int $qty, AbstractCustomColumn $columnValeur de la cellule.

Règles de tarification globales

HookTypeParamètresDescription
tiered_pricing_table/global_pricing/matched_pricing_ruleF?GlobalPricingRule $rule, WC_Product $product, WP_User $userLa règle choisie pour un produit/utilisateur : implémentez ici un arbitrage personnalisé.
tiered_pricing_table/global_pricing/match_requirementsFbool $matched, GlobalPricingRule $rule, WP_User $user, WC_Product $productRésultat de la logique de correspondance d’une règle.
tiered_pricing_table/global_pricing/after_built_ruleFGlobalPricingRule $ruleRègle construite à partir des métadonnées de l’article : lisez vos propres métadonnées dans $rule->data.
tiered_pricing_table/global_pricing/validationFbool $valid, GlobalPricingRule $ruleIndique si une règle est considérée comme valide (elle a une tarification).
tiered_pricing_table/global_pricing/order_discount/linesFarray $lines, WC_Cart $cartLes lignes du panier qu’une règle de panier compte (key, product, quantity, amount après les prix échelonnés, avec ou sans taxes selon le réglage).
tiered_pricing_table/global_pricing/order_discount/ruleF?GlobalPricingRule $rule, array $lines, WP_User $userLa règle de panier dont relève le panier (la plus prioritaire, correspondant au client, avec une ligne comptée).
tiered_pricing_table/global_pricing/order_discount/resolvedFOrderDiscount $discount, WC_Cart $cart, WP_User $userLa remise que le panier a gagnée, avant son application.
tiered_pricing_table/global_pricing/order_discount/coupon_codeFstring $code, GlobalPricingRule $ruleLe code du coupon virtuel (le titre de la règle sous forme d’identifiant, ou order-discount-{id} lorsqu’un vrai coupon en est propriétaire).
tiered_pricing_table/global_pricing/order_discount/coupon_propsFarray $props, GlobalPricingRule $ruleLes données du coupon transmises à WooCommerce (discount_type, amount, product_ids, …).
tiered_pricing_table/global_pricing/order_discount/labelFstring $label, OrderDiscount $discountLe libellé de la ligne de remise, champs remplis.
tiered_pricing_table/global_pricing/order_discount/nudgeFstring $message, array $next, WC_Cart $cartLe message « ajoutez X de plus » ($next : règle, palier, base, sous-total, quantité, reste).
tiered_pricing_table/global_pricing/order_discount/missed_minimumsFarray $missed, array $lines, WP_User $userLes minimums non atteints des règles de commande correspondantes (rule, type, minimum, actual).
tiered_pricing_table/global_pricing/order_discount/shipping_barF?array $progress, ?WC_Cart $cart, WP_User $userL’état de la barre de livraison gratuite avant son rendu (rule, mode, items, threshold, value, remaining, reached, percent) ; renvoyez null pour masquer la barre.
tiered_pricing_table/global_pricing/has_order_rulesFbool $hasIndique si la boutique a une règle de panier, quel que soit son statut sauf la corbeille : ce n’est qu’alors que la liste des règles affiche son filtre de type, le bouton des réglages des règles de panier et, avec aussi des règles de produit, le type de chaque ligne (8.3.0+)
tiered_pricing_table/global_pricing/has_product_rulesFbool $hasIndique si la boutique a une règle de tarification de produit (les règles enregistrées avant l’existence des types de règles comptent comme des règles de produit) (8.3.0+)
tiered_pricing_table/global_pricing/show_rule_type_pointerFbool $showIndique si l’astuce sur le type de règle s’ouvre sur une nouvelle règle : par défaut tant que la boutique n’a aucune règle de tarification et que l’utilisateur ne l’a pas fermée (8.3.0+)
tiered_pricing_table/global_pricing/before_adjusting_pricing_ruleFPricingRule $rule, GlobalPricingRule $globalRule, int $productId, string $priorityAvant l’application d’une règle correspondante ($priority : flexible | prefer-product | override).
tiered_pricing_table/global_pricing/after_adjusting_pricing_ruleFPricingRule $rule, GlobalPricingRule $globalRule, int $productId, string $priorityAprès son application.
tiered_pricing_table/global_pricing/form_tabsFFormTab[] $tabs, Form $formOnglets de l’éditeur de règles.
tiered_pricing_table/global_pricing/form/tab_endAFormTab $tab, GlobalPricingRule $ruleFin de chaque onglet.
tiered_pricing_table/global_pricing/after_minimum_order_quantity_fieldAint $ruleId, GlobalPricingRule $ruleOnglet Quantité, après le champ du minimum.
tiered_pricing_table/global_pricing/before_updatingAGlobalPricingRule $rule, int $ruleIdÀ l’enregistrement, avant $rule->save() : conservez les champs personnalisés.
tiered_pricing_table/global_pricing/columnsFarray $columnsColonnes du tableau de liste (objets avec getName()/render()).
tiered_pricing_table/global_pricing/table/after_tab_renderAstring $column, GlobalPricingRule $ruleAprès l’affichage d’une cellule du tableau de liste.

Tarification par rôle

HookTypeParamètresDescription
tiered_pricing_table/role_based_rules/available_rolesFarray $rolesRôles qu’une règle de produit peut cibler, sous la forme key => label : chaque rôle WordPress plus guest (visiteurs non connectés).
tiered_pricing_table/role_based_rules/rule_exists_metaFstring[] $metaSuffixes, string $roleSuffixes de métadonnées dont l’existence signifie « le rôle a des règles » (par défaut _tiered_price_rules_type, _tiered_price_pricing_type).
tiered_pricing_table/role_based_rules/price/product_price_rulesFarray $rules, int $productId, string $typeRègles de paliers du rôle lues dans les métadonnées.
tiered_pricing_table/role_based_rules/price/typeFstring $type, string $role, int $productIdfixed | percentage | amount.
tiered_pricing_table/role_based_rules/price/minimumF?int $minimum, string $role, int $productIdQuantité minimale du rôle.
tiered_pricing_table/role_based_rules/price/regular_priceF?float $price, string $role, int $productIdPrix normal du rôle.
tiered_pricing_table/role_based_rules/price/sale_priceF?float $price, string $role, int $productIdPrix promotionnel du rôle.
tiered_pricing_table/role_based_rules/price/discountF?float $discount, string $role, int $productIdRemise en pourcentage du rôle.
tiered_pricing_table/role_based_rules/price/discount_typeFstring $type, string $role, int $productIdsale_price | regular_price.
tiered_pricing_table/role_based_rules/price/pricing_typeFstring $type, string $role, int $productIdflat | percentage.
tiered_pricing_table/role_based_rules/price/tax_statusFstring $status, string $role, int $productIdRemplacement du statut de taxe du rôle.
tiered_pricing_table/role_based_rules/price/tax_classFstring $class, string $role, int $productIdRemplacement de la classe de taxe du rôle.
tiered_pricing_table/role_based_rules/delete_role_ruleAint $productId, string $roleAprès la suppression des règles d’un rôle sur un produit.
tiered_pricing_table/role_based_rules/save_role_based_rulesAint $productId, array $postData, string $role, ?int $loopAprès l’enregistrement des règles d’un rôle depuis l’éditeur de produit.
tiered_pricing_table/role_based_pricing/after_adjusting_pricing_ruleAPricingRule $rule, RoleBasedPricingRule $roleRule, int $productIdAprès l’application de la règle du rôle au PricingRule du produit.
tiered_pricing_table/role_based/after_built_ruleFRoleBasedPricingRule $ruleRègle construite à partir des métadonnées.
tiered_pricing_table/role_based/after_built_rule_from_arrayFRoleBasedPricingRule $rule, string $role, array $dataRègle construite à partir d’un tableau (import).
tiered_pricing_table/role_based_rules/import_export_disabled_rolesFstring[] $rolesRôles exclus de l’import/export CSV (par défaut editor, author, contributor, shop_manager).

Tarification par client

HookTypeParamètresDescription
tiered_pricing_table/user_based_rules/rule_exists_metaFstring[] $metaSuffixes, int $userIdIdentique à l’équivalent pour les rôles.
tiered_pricing_table/user_based_rules/price/product_price_rulesFarray $rules, int $productId, string $typeRègles de paliers du client.
tiered_pricing_table/user_based_rules/price/typeFstring $type, int $userId, int $productIdfixed | percentage | amount.
tiered_pricing_table/user_based_rules/price/minimumF?int $minimum, int $userId, int $productIdMinimum du client.
tiered_pricing_table/user_based_rules/price/regular_priceF?float $price, int $userId, int $productIdPrix normal du client.
tiered_pricing_table/user_based_rules/price/sale_priceF?float $price, int $userId, int $productIdPrix promotionnel du client.
tiered_pricing_table/user_based_rules/price/discountF?float $discount, int $userId, int $productIdRemise du client.
tiered_pricing_table/user_based_rules/price/discount_typeFstring $type, int $userId, int $productIdsale_price | regular_price.
tiered_pricing_table/user_based_rules/price/pricing_typeFstring $type, int $userId, int $productIdflat | percentage.
tiered_pricing_table/user_based_rules/price/tax_statusFstring $status, int $userId, int $productIdRemplacement du statut de taxe.
tiered_pricing_table/user_based_rules/price/tax_classFstring $class, int $userId, int $productIdRemplacement de la classe de taxe.
tiered_pricing_table/user_based_rules/delete_user_ruleAint $productId, int $userIdAprès la suppression des règles d’un client.
tiered_pricing_table/user_based_rules/save_user_based_rulesAint $productId, array $postData, int $userId, ?int $loopAprès l’enregistrement des règles d’un client.
tiered_pricing_table/user_based_pricing/after_adjusting_pricing_ruleAPricingRule $rule, UserBasedPricingRule $userRule, int $productIdAprès l’application de la règle du client.
tiered_pricing_table/user_based/after_built_ruleFUserBasedPricingRule $ruleRègle construite à partir des métadonnées.
tiered_pricing_table/user_based/after_built_rule_from_arrayFUserBasedPricingRule $rule, int $userId, array $dataRègle construite à partir d’un tableau.

Éditeur de produit dans l’administration

HookTypeParamètresDescription
tiered_pricing_table/admin/pricing_tab_beginAint $postIdHaut de l’onglet Tarification échelonnée.
tiered_pricing_table/admin/after_minimum_order_quantity_fieldAint $productId, ?int $loop, string $customPrefixAprès le champ de quantité minimale : dans l’onglet Général d’un produit simple (préfixe ''), dans la section Produit variable d’un produit variable (préfixe '_variable', que portent aussi les noms des champs) et dans chaque variation ($loop défini).
tiered_pricing_table/admin/before_advance_product_optionsAint $postIdAvant la section Affichage.
tiered_pricing_table/admin/advance_product_optionsAint $postIdFin de la section Affichage (mise en page et libellé de l’unité) ; l’endroit idéal pour des champs personnalisés par produit.
tiered_pricing_table/admin/variable_product_optionsAint $postIdÀ l’intérieur de la section Produit variable (la première section de l’onglet, produits variables uniquement), après les paliers et les limites de quantité du parent ; la variation par défaut, les prix partagés et les champs de calcul du minimum s’affichent ici.
tiered_pricing_table/admin/visibility_optionsAint $postIdÀ l’intérieur de la section Visibilité ; la section ne s’affiche que si quelque chose s’y accroche (le champ Qui peut voir ce produit du module de boutique privée).
tiered_pricing_table/admin/pricing_tab_endAint $postIdBas de l’onglet.
tiered_pricing_table/admin/role_customer_pricing_tab_activeFbool $activeAfficher la section Prix par rôle et par client de l’onglet Tarification échelonnée (un onglet à part avant 8.2.0 / 10.2.0).
tiered_pricing_table/admin/role_customer_pricing_tab_beginAint $postIdHaut de la section Prix par rôle et par client.
tiered_pricing_table/admin/role_customer_pricing_tab_contentAint $postIdContenu de la section (bloc des rôles 99, bloc des clients 100).
tiered_pricing_table/admin/role_customer_pricing_tab_endAint $postIdBas de la section.
tiered_pricing_table/admin/role_customer_section_openFbool $open, int $productIdIndique si la section Prix par rôle et par client démarre ouverte (par défaut : ouverte sur les produits simples, sur les produits variables seulement lorsque le produit a des prix par rôle ou par client).
tiered_pricing_table/admin/tiered_pricing_rules_form/form_beginA$entityId, ?string $role, ?int $loop, string $customPrefixDébut du composant du formulaire de règles.
tiered_pricing_table/admin/tiered_pricing_rules_form/after_pricing_typeA$entityId, ?string $role, ?int $loop, string $customPrefixAprès le sélecteur fixe/pourcentage/montant.
tiered_pricing_table/admin/tiered_pricing_rules_form/inputsA$entityId, $amount, ?string $role, ?int $loop, string $customPrefix, string $typeÀ l’intérieur de chaque ligne de palier.
tiered_pricing_table/admin/tiered_pricing_rules_form/form_endA$entityId, ?string $role, ?int $loop, string $customPrefixFin du composant.
tiered_pricing_table/admin/tiered_pricing_rules_form/inputs_widthFint $percentLargeur des champs de quantité/prix (50 par défaut).
tiered_pricing_table/admin/components/tiered_pricing_rules_form/get_from_requestA$entityId, ?string $role, ?int $loop, string $customPrefix, array $data, array $requestAprès l’analyse du formulaire de règles depuis $_POST.
tiered_pricing_table/admin/role_based_rules/after_minimum_order_quantity_fieldAint $productId, string $role, ?int $loopÀ l’intérieur du formulaire de tarification d’un rôle.
tiered_pricing_table/admin/role_based_rules/after_tiered_pricing_rules_fieldAint $productId, string $role, ?int $loopÀ l’intérieur du formulaire de tarification d’un rôle (les sélecteurs de taxe s’affichent ici).
tiered_pricing_table/admin/user_based_rules/after_minimum_order_quantity_fieldAint $productId, int $userId, ?int $loopÀ l’intérieur du formulaire de tarification d’un client.
tiered_pricing_table/admin/user_based_rules/after_tiered_pricing_rules_fieldAint $productId, int $userId, ?int $loopÀ l’intérieur du formulaire de tarification d’un client.
tiered_pricing_table/admin/tips/get_tip_by_slugF?Tip $tip, string $slugRésoudre une astuce personnalisée de l’administration.

API REST, import et export

HookTypeParamètresDescription
tiered_pricing_table/api/product_fieldsFstring[] $fieldClassesClasses (étendant ProductField) enregistrées comme champs produit de l’API REST WooCommerce.
tiered_pricing_table/api/supported_product_typesFstring[] $objectTypes, ProductField $fieldTypes d’objets REST auxquels le champ est ajouté (par défaut product, product_variation).
tiered_pricing_table/import/woocommerce/import_columnsFarray $columnsColonnes proposées sur l’écran d’association de l’importeur CSV WooCommerce.
tiered_pricing_table/import/woocommerce/mapping_screen_columnsFarray $headerToKeyAssociation automatique des en-têtes CSV aux colonnes.
tiered_pricing_table/request_quote/quote_request_submittedAint $quoteRequestIdUne demande de devis a été enregistrée (les e-mails s’y accrochent).

Intégrations

HookTypeParamètresDescription
tiered_pricing_table/integrations/pluginsFstring[] $classesClasses d’intégration de plugins (au démarrage : voir la note ci-dessus).
tiered_pricing_table/integrations/themesFarray<string,string> $needleToClassIntégrations de thèmes indexées par une aiguille en minuscules comparée au nom/modèle du thème (au démarrage).
tiered_pricing_table/integrations/{slug}/variable_products_supportedFbool $supported, WC_Product $productIndique si l’enrichissement du schéma SEO s’exécute pour les produits variables ; {slug} vaut yoast_seo, rank_math ou seopress.

Vente en gros et boutique privée

Disponible depuis la version 8.0.0 ; l’inscription grossiste et la boutique privée font partie du plugin gratuit, les moyens de paiement et de livraison par rôle nécessitent la version premium. Le minimum de commande par rôle est devenu une règle de panier en 8.3.0 (voir les hooks order_discount/* sous Règles de tarification globales). Les e-mails sont des classes WC_Email standard (TPT_Wholesale_Admin_New_Application, TPT_Wholesale_Customer_Received, TPT_Wholesale_Customer_Approved, TPT_Wholesale_Customer_Rejected), enregistrées via woocommerce_email_classes et déclenchées via woocommerce_email_actions : tous les filtres d’e-mail de WooCommerce s’y appliquent donc.

HookTypeParamètresDescription
tiered_pricing_table/wholesale/application_submittedAint $applicationId, WholesaleApplication $applicationUne demande de compte grossiste a été envoyée ; le compte client existe à ce stade.
tiered_pricing_table/wholesale/application_approvedAint $applicationId, WholesaleApplication $application, int $decidedByLa demande a été approuvée et le client a le rôle grossiste. $decidedBy est l’identifiant de l’utilisateur qui a décidé, 0 pour une approbation automatique.
tiered_pricing_table/wholesale/application_rejectedAint $applicationId, WholesaleApplication $application, int $decidedByLa demande a été refusée ; le motif est enregistré avec la demande.
tiered_pricing_table/closed_store/is_open_pageFbool $openRenvoyez true pour garder la requête courante ouverte aux visiteurs alors que la boutique est fermée (s’exécute sur template_redirect après les exceptions intégrées).

Réglages

HookTypeParamètresDescription
tiered_pricing_table/settings/sectionsFSectionAbstract[] $sectionsOnglets de réglages.
tiered_pricing_table/settings/general_settingsFarray $fieldsChamps de l’onglet Général (après la fusion des sous-sections).
tiered_pricing_table/settings/general_subsectionsFstring[] $subsectionClassesSous-sections de l’onglet Général.
tiered_pricing_table/settings/calculation_logicFarray $fieldsChamps du groupe Calcul des prix de l’onglet Général.
tiered_pricing_table/settings/advanced_settingsFarray $fieldsInterrupteurs des modules de l’onglet Avancé (appelé Outils avant 8.0.0).
tiered_pricing_table/settings/tools_settingsFarray $fieldsChamps affichés après les modules dans l’onglet Avancé (avant Cache et Débogage).
tiered_pricing_table/settings/wholesale_subsectionsFstring[] $subsectionClassesClasses de sous-sections ajoutées à l’onglet Vente en gros (8.0.0+).
tiered_pricing_table/settings/sections_orderFarray<string,int> $orderOrdre des onglets de réglages (section id => priority).
tiered_pricing_table/settings/is_premiumFbool $premiumIndique si le configurateur de mise en page considère le site comme premium (déverrouille les contrôles réservés au premium).
tiered_pricing_table/install/theme_colorF?string $colorLa couleur du thème détectée sur une installation neuve pour le palier actif (l’arrière-plan des boutons d’un thème de blocs, ou la couleur d’accent de Storefront, Astra, OceanWP et Flatsome). Renvoyez une couleur hexadécimale pour utiliser la vôtre, null pour la valeur neutre par défaut ; les couleurs sur lesquelles le texte blanc n’est pas lisible sont écartées.
tiered_pricing_table/catalog/excluded_stylesFarray<string,string[]> $stylesStyles de design masqués pour la grille de produits (layout => styles ; par défaut ['blocks' => ['style-8']]).
tiered_pricing_table/settings/integrations_settingsFarray $rowsLignes d’interrupteurs d’intégration.
tiered_pricing_table/settings/integrations_categoriesFarray<string,array> $categoriesGroupes d’intégrations (id => ['title','description']).
tiered_pricing_table/settings/table_columns/after_fieldsA—Après les champs de titres de colonnes.
tiered_pricing_table/settings/table_columns/endA—Fin du champ des titres de colonnes (l’interface des colonnes personnalisées s’y monte).

Ressources

  • Guide de l’utilisateur : documentation destinée aux propriétaires de boutique, pour chaque fonctionnalité.
  • Guides : articles pratiques.
  • Nous contacter : il manque un hook ou vous avez une question d’intégration ? Dites-le-nous.