Zum Inhalt springen

Für Entwickler

Entwicklerdokumentation

Architektur, Datenmodell, PHP-API, Hooks & Filter, Templates, JavaScript-Events und REST-Endpunkte zum Erweitern des Plugins Tiered Pricing Table.

Auf dieser Seite

Einführung

Diese Seite richtet sich an Entwickler, die Tiered Pricing Table for WooCommerce per Code anpassen oder erweitern möchten: Preise lesen und ändern, Templates überschreiben, sich in das JavaScript einklinken, die REST-API nutzen und, vor allem, die vollständige Liste der Actions und Filter. Die Dokumentation für Shop-Betreiber finden Sie im Benutzerhandbuch.

Konventionen

Der Code liegt im Namespace TierPricingTable\ (src/), Templates in views/. Jeder Hook hat das Präfix tiered_pricing_table/ und verwendet / als Trennzeichen, z. B. tiered_pricing_table/price/pricing_rule. Einstellungen sind Optionen mit dem Präfix tier_pricing_table_. Die meisten Filter können jederzeit aus einem Theme oder Plugin eingehängt werden; die drei Boot-Filter addons/list, integrations/plugins und integrations/themes laufen, während die Plugin-Datei eingebunden wird, und müssen aus einem Must-Use-Plugin oder einem Plugin eingehängt werden, das vor tier-pricing-table geladen wird.

Preise und Regeln

Die wirksame Regel und den Preis lesen

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

Die Regel für ein beliebiges Produkt ändern

tiered_pricing_table/price/pricing_rule erhält die PricingRule, nachdem die Produkt-Metadaten gelesen wurden. Die eingebauten Provider verwenden diese Prioritäten, richten Sie Ihre danach aus: Mengenbeschränkungen 1, Kategorieregeln 10, rollenbasiert 20, kundenbasiert 25, globale Regeln 30, Angebotsanfrage 99, Währungsumrechnung 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 );

Weitere nützliche Filter: …/price/price_by_rules (endgültiger Stückpreis für eine Menge), …/price/round_price / …/price/round_precision, …/cart/product_cart_price (für einen Warenkorbartikel gesetzter Preis), …/cart/total_product_count (Menge, mit der im Warenkorb die Staffel gewählt wird), …/cart/need_price_recalculation (einen Artikel überspringen), …/services/regular_pricing/price (angepasster regulärer Preis bzw. Aktionspreis für den aktuellen Benutzer), …/global_pricing/matched_pricing_rule (welche globale Regel greift).

Regeln programmatisch schreiben

Meta-Schlüssel (Produkt / Variante)Wert
_fixed_price_rulesarray<int qty, string price> — z. B. [5 => '9.50', 10 => '8.00']
_percentage_price_rulesarray<int qty, string percent>
_amount_price_rulesarray<int qty, string amount> — ein Rabattbetrag auf den Produktpreis pro Einheit
_tiered_price_rules_typefixed | percentage | amount
_tiered_price_minimum_qtyint > 1
_tiered_pricing_maximum_quantity, _tiered_pricing_group_of_quantityint (Maximum, Schrittweite)
_tiered_price_mix_and_match_minimumyes | no (variables übergeordnetes Produkt)
_tiered_pricing_template, _tiered_pricing_base_unit_nameLayout-Slug; ['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_typerollenbasierte Regeln ({role} = Rollen-Slug); Kundenregeln verwenden _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();

Meta einer globalen Regel für eine Warenkorbregel (_tpt_rule_kind = order): _tpt_rule_kind (product \| order), _tpt_order_basis (amount \| quantity: womit die Staffeln verglichen werden), _tpt_order_tiers (Zeilen mit from und 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() nimmt dieselben Schlüssel ohne das Präfix _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). Beim Update wandelt OrderDiscounts\MinimumsMigration die Mindestbestell-Tabelle der alten Warenkorbregeln nach Rolle in eine Bestellregel pro Rolle um (die Option tier_pricing_table_order_minimums_migrated hält das fest). Im Warenkorb liefert OrderDiscounts\OrderDiscountResolver::resolve( WC_Cart $cart, ?WP_User $user ) den OrderDiscount, den der Warenkorb erreicht hat (Regel, Staffel, gezählte Zwischensumme, Coupon-Eigenschaften), und nextTier() das, was bis zur nächsten Staffel fehlt. OrderDiscounts\FreeShippingBar::progress( ?WC_Cart $cart, ?WP_User $user ) liefert den Zustand des Balkens für kostenlosen Versand (Regel, Modus, Schwellenwert, Wert, verbleibend, erreicht, Prozent), progressFor( $rule, $counted ) dasselbe aus einer Regel und gezählten Positionen, und render( $context ) das HTML des Balkens.

Templates

Die Tabelle selbst ausgeben

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

Einstellungsschlüssel, die Sie übergeben können: 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. Dieselben Schlüssel funktionieren als Shortcode-Attribute. Mit tiered_pricing_table/should_render_pricing_table unterdrücken Sie die automatische Ausgabe, und mit tiered_pricing_table/display_settings ändern Sie Einstellungen im laufenden Betrieb.

Templates aus einem Theme überschreiben

Kopieren Sie eine beliebige Datei aus dem Ordner views/frontend/ des Plugins (tiered-pricing-table.php, tiered-pricing-blocks-style-3.php, summary-table.php, …) nach **wp-content/themes/{your-theme}/tiered-pricing-table/** und bearbeiten Sie sie dort. Mit tiered_pricing_table/template/location kann ein Plugin ein Template umleiten.

Ein Override-Ordner im Theme

Variablen in Layout-Templates: $pricing_rule (PricingRule), $price_rules, $pricing_type, $minimum, $product, $product_id, $settings, $id.

Den Markup-Vertrag einhalten

Das JavaScript liest das Markup. Behalten Sie daher id, data-product-id, data-price-rules, data-minimum, data-regular-price, data-sale-price, data-price und data-product-price-suffix des Wurzelelements bei, ein Element pro Staffel mit data-tiered-quantity / data-tiered-price / data-tiered-price-exclude-taxes / data-tiered-price-include-taxes, die Basiszeile mit data-tiered-quantity="{minimum}" und der Klasse tiered-pricing--active sowie die Hilfsfunktionen tptParseOptionText() / tptParsePlainText().

Inhalte in Layouts einfügen

// 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' );

Alle Layout-Hooks sind unter Template-Hooks aufgelistet.

JavaScript

Die Frontend-Engine (tiered-pricing-table-front-js, jQuery) stellt document.__tieredPricing bereit:

// 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 ); }
} );

Der Live-Produktpreis ist das Preis-HTML von WooCommerce, eingeschlossen in <span class="tiered-pricing-dynamic-price-wrapper" data-price-type="dynamic|static|no-rules">; geben Sie aus tiered_pricing_table/frontend/default_price_behaviour_type den Wert static zurück, um den Preis von WooCommerce beizubehalten, oder false aus …/frontend/wrap_price, um den Wrapper zu überspringen. Hooks fürs Styling: .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, Block und Widget

IntegrationspunktDetails
[tiered-pricing-table]product_id (standardmäßig der aktuelle Beitrag) sowie jeder Einstellungsschlüssel aus Die Tabelle selbst ausgeben, z. B. [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]Das Großhandels-Antragsformular (ab 8.0.0). Keine Attribute; Formular, Felder und Meldungen stammen aus Einstellungen → Großhandel. Gibt einen Hinweis nur für Shop-Manager aus, solange die Funktion ausgeschaltet ist.
[tiered_pricing_free_shipping_bar]Der Balken für kostenlosen Versand der Warenkorbregel, unter die der Warenkorb des Besuchers fällt (ab 8.3.0, Premium). Keine Attribute; Meldungen, Farben und Höhe stammen aus der Regel und der Einstellungsseite für Warenkorbregeln (der Einstellungsbereich order-rules, in der Navigation nur sichtbar, solange er geöffnet ist). Gibt ein leeres div.tpt-free-shipping-bar-live aus, wenn keine Regel mit Balken greift; die Warenkorb-Fragmente aktualisieren beim Hinzufügen zum Warenkorb jeden solchen Wrapper.
Block tiered-pricing-table/free-shipping-barDerselbe Balken als Block (keine Attribute; unterstützt Ausrichtung und Abstände).
Block tiered-pricing-table/tiered-pricing-blockdisplayType, title, activeTierColor, showDiscountColumn, Spaltentitel
Elementor-Widget tiered-pricing-tableproduct_id, display_type, title, active_tier_color, Spaltentitel, Optionen/Maßeinheit-Einstellungen

REST-API

Die WooCommerce-Endpunkte für Produkte und Varianten (/wp-json/wc/v3/products/{id}, /products/{id}/variations/{vid}) lesen und schreiben diese Felder:

FeldWert
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_quantityGanzzahl oder 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 } } — beim Schreiben werden alle Rollendaten ersetzt; senden Sie Staffeln und Mindestmenge als 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 } }
}

Fügen Sie ein eigenes Feld hinzu, indem Sie TierPricingTable\Services\API\ProductFields\ProductField erweitern und die Klasse mit tiered_pricing_table/api/product_fields anhängen. Routen des Plugins: tier-pricing-table/v1/quote-request (POST, öffentlich), /quote-forms, /quote-settings, /tax-settings, tier-pricing-table/features/tier-labels/v1/labels, …/custom-columns/v1/columns, …/tools/v1/*. Spalten für den CSV-Import/-Export von WooCommerce: tiered_price_fixed, tiered_price_percentage (qty:value,…), tiered_price_type, tiered_price_minimum und pro Rolle {role}_tiered_price_*.

Den Admin-Bereich erweitern

// 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 ] ) );
  • Einstellungs-Tabs und -Felder: tiered_pricing_table/settings/sections, …/general_settings, …/general_subsections, …/calculation_logic (Gruppe Preisberechnung), …/advanced_settings, …/tools_settings, …/sections_order. Feldtypen: tpt_switch_option, tpt_display_type, tpt_text_template, tpt_link_button.
  • Produkteditor: Rendern Sie Felder auf tiered_pricing_table/admin/pricing_tab_begin|after_minimum_order_quantity_field|advance_product_options|pricing_tab_end ($postId; after_minimum_order_quantity_field übergibt außerdem $loop und das Präfix des Feldnamens, '_variable' im Abschnitt „Variables Produkt“) und innerhalb des Regelformulars (…/admin/tiered_pricing_rules_form/form_begin|inputs|form_end); speichern Sie über woocommerce_process_product_meta / woocommerce_save_product_variation. Benennen Sie Felder mit TierPricingTable\Forms\Form::getFieldName( $base, $role, $loop ).
  • Rollen-/Kundenregeln: Rendern Sie auf …/admin/role_based_rules/after_tiered_pricing_rules_field (und user_based_rules), speichern Sie auf …/role_based_rules/save_role_based_rules (und user_based_rules/save_user_based_rules).
  • Globale Regeln: Fügen Sie mit tiered_pricing_table/global_pricing/form_tabs einen Tab hinzu (erweitern Sie CPT\Form\FormTab), speichern Sie in …/global_pricing/before_updating, lesen Sie Ihre Metadaten in …/global_pricing/after_built_rule und fügen Sie mit …/global_pricing/columns Listenspalten hinzu.
  • Benutzerdefinierte Tabellenspalten: Erweitern Sie Addons\CustomColumns\Columns\AbstractCustomColumn und registrieren Sie die Klasse mit tiered_pricing_table/custom_columns/available_columns_types + …/custom_columns/columns_handlers.
  • Add-ons: Erweitern Sie Addons\AbstractAddon und fügen Sie es mit tiered_pricing_table/addons/list hinzu (Boot-Filter); es erhält einen Schalter im Tab „Module“.

Debugging

  • Der Debug-Modus (Einstellungen → Module → Debug) gibt die aufgelöste Regel unter jedem Warenkorbartikel und in der Preistabelle aus, einschließlich des Logs, das mit PricingRule::logPricingModification() geschrieben wird.
  • Cache: Das Preis-HTML des Katalogs wird im Transient tpt_product_data zwischengespeichert. Leeren Sie es unter Einstellungen → Module → Cache oder mit ServiceContainer::getInstance()->getCache()->purge().
  • $GLOBALS['tpt_current_user_id'] sorgt dafür, dass jede Preisberechnung für diesen Benutzer läuft (manuelle Bestellungen nutzen das).

Hooks-Referenz

Jeder Filter und jede Action, die das Plugin auslöst, nach Themen gruppiert. Der Typ ist F (Filter, den ersten Parameter zurückgeben) oder A (Action). Die Parameter sind der Reihe nach aufgeführt; der erste Parameter eines Filters ist der Wert, der zurückzugeben ist. Jede Zeile lässt sich direkt verlinken (die Zeilen-ID ist hook- + der Hook-Name, wobei Zeichen, die nicht alphanumerisch sind, durch - ersetzt werden). Alle Namen haben das Präfix tiered_pricing_table/, sofern sie nicht vollständig angegeben sind.

Bootstrap und Services

HookTypParameterBeschreibung
tpt_fs_loadedA—Freemius-SDK initialisiert (tpt_fs() verfügbar).
tiered_pricing_table/container/service_instanceFstring $classNameKlassenname, der von ServiceContainer::initService() instanziiert wird. Geben Sie eine Unterklasse zurück, um einen Service zu ersetzen.
tiered_pricing_table/addons/listFarray<string,AbstractAddon> $addonsAdd-on-Instanzen nach Klasse indiziert, vor run(). Fügen Sie Add-ons hinzu, entfernen oder ersetzen Sie sie.
tiered_pricing_table/supported_simple_product_typesFstring[] $typesStandard: simple, variation, subscription, subscription-variation.
tiered_pricing_table/supported_variable_product_typesFstring[] $typesStandard: variable, variable-subscription.
tiered_pricing_table/supported_variation_product_typesFstring[] $typesStandard: variation, subscription-variation.
tiered_pricing_table/pricing_layoutsFarray<string,string> $layoutsLayout-Slug ⇒ Bezeichnung (table, blocks, options, dropdown, horizontal-table, plain-text, tooltip).
tiered_pricing_table/current_userFWP_User $userDer Benutzer, für den Preise berechnet werden (Standard: aktueller Benutzer oder $GLOBALS['tpt_current_user_id']).
tiered_pricing_table/current_user_rolesFstring[] $roles, int $userIdRollen, die für rollenbasierte Preise und Cache-Schlüssel verwendet werden; ein nicht angemeldeter Besucher erhält die Pseudo-Rolle guest.
tiered_pricing_table/rules_separatorFstring $separatorTrennzeichen für qty:price-Listen beim CSV-Import/-Export (Standard ,).
tiered_pricing_table/rule_separatorFstring $separatorTrennzeichen zwischen Menge und Preis innerhalb einer Regel beim CSV-Export (Standard :). Tabellenkalkulationen lesen 20:100 als Uhrzeit; geben Sie = zurück, um 20=100 zu erhalten. Der Importer akzeptiert :, = und den konfigurierten Wert.
tiered_pricing_table/template/locationFstring $absolutePath, string $templateEndgültiger Pfad eines beliebigen Templates (frontend/…, admin/…, addons/…).
tiered_pricing_table/template/before_renderAstring $absolutePath, array $variablesBevor ein Template eingebunden wird.
tiered_pricing_table/template/after_renderAstring $absolutePath, array $variablesNachdem ein Template eingebunden wurde.
tiered_pricing_table/assets/js/urlFstring $url, string $fileURL eines JS-Assets des Plugins.
tiered_pricing_table/assets/css/urlFstring $url, string $fileURL eines CSS-Assets des Plugins.

Preisberechnung

HookTypParameterBeschreibung
tiered_pricing_table/price/pricing_ruleFPricingRule $rule, int $productIdZentraler Erweiterungspunkt. Die wirksame Regel für ein Produkt, nachdem die Metadaten auf Produktebene gelesen wurden; Provider (Kategorie 10, Rolle 20, Kunde 25, global 30, Angebot 99) ändern sie hier. Wird pro Anfrage zwischengespeichert.
tiered_pricing_table/price/product_price_rulesFarray $rules, int $productId, string $typeRegeln auf Produktebene, aus den Metadaten gelesen (nur Kontext view).
tiered_pricing_table/price/price_by_rulesFfloat|false $price, int $quantity, int $productId, string $context, string $place, PricingRule $ruleEndgültiger Stückpreis für eine Menge (false = keine Staffel getroffen).
tiered_pricing_table/price/round_priceFbool $roundOb Staffelpreise gerundet werden (Standard: Option Preis runden).
tiered_pricing_table/price/round_precisionFint $decimalsRundungsgenauigkeit (Standard max(2, wc_get_price_decimals())).
tiered_pricing_table/discount/decimalsFint $decimals, float $percent, ?WC_Product $product, ?PricingRule $ruleNachkommastellen prozentualer Rabatte, die in jedem Layout und im Platzhalter {tp_discount} angezeigt werden (Standard 2; geben Sie 0 zurück für ganze Zahlen wie „10 %“).
tiered_pricing_table/price/typeFstring $type, int $productIdPreisart auf Produktebene (fixed | percentage | amount).
tiered_pricing_table/price/minimumF?int $minimum, int $productIdMindestbestellmenge auf Produktebene.
tiered_pricing_table/services/pricing_service_enabledFbool $enabledGeben Sie true zurück, um RegularPricingService zu aktivieren (WC-Preisfilter). Global-/Rollen-/Kunden-Add-ons tun dies.
tiered_pricing_table/services/regular_pricing/priceF?float $newPrice, ?WC_Product $product, ?string $specific ('regular'|'sale'|null), $originalPriceAngepasster regulärer Preis / Aktionspreis / aktueller Preis für den aktuellen Benutzer (null behält den Wert von WooCommerce bei).
tiered_pricing_table/services/pricing/override_zero_pricesFbool $overrideOb bei Produkten mit dem Preis null der Preis überschrieben wird (Standard true).
tiered_pricing_table/advanced_quantity/get_maximumF?int $value, int $productId, string|false $roleMaximale Menge für ein Produkt; rollenspezifische Werte werden hier angewendet.
tiered_pricing_table/advanced_quantity/get_group_ofF?int $value, int $productId, string|false $roleMengenschritt für ein Produkt.
tiered_pricing_table/addons/category_tier_pricing_skip_categoryFbool $skip, int $productId, WC_Product $productVeraltete Regeln auf Kategorieebene für ein Produkt überspringen.
tiered_pricing_table/check_if_variable_product_has_rulesFbool $check, WC_Product $productGeben Sie true zurück, damit productHasPricingRules() die Varianten durchsucht, statt anzunehmen, dass ein variables Produkt Regeln hat.

Warenkorb und Kasse

HookTypParameterBeschreibung
tiered_pricing_table/cart/need_price_recalculationFbool $recalculate, array $cartItem, WC_Cart $cartGeben Sie false zurück, um den Preis eines Artikels WooCommerce zu überlassen (das Gutschein-Add-on nutzt dies bei 999).
tiered_pricing_table/cart/product_cart_priceFfloat|false $price, array $cartItem, string $cartItemKey, int $totalQuantityAuf dem Warenkorbartikel gesetzter Stückpreis.
tiered_pricing_table/cart/total_product_countFint $count, array $cartItemMenge, mit der für einen Artikel die Staffel gewählt wird (Summe der Varianten, wenn Varianten zusammenfassen aktiv ist; globale cross-Regeln summieren die übereinstimmenden Artikel).
tiered_pricing_table/cart/need_price_recalculation/itemFbool $recalculate, array $cartItemWie oben, für den angezeigten Artikelpreis.
tiered_pricing_table/cart/total_savingsFfloat $savings, WC_Cart $cartBetrag, der in der Zeile „Gesamtersparnis“ der Warenkorbsummen und an der klassischen Kasse angezeigt wird.
tiered_pricing_table/cart/product_cart_price/itemFfloat|false $price, array $cartItemAngezeigter Stückpreis.
tiered_pricing_table/cart/product_cart_old_priceFfloat $oldPrice, array $cartItemDurchgestrichener Preis neben dem reduzierten Preis.
tiered_pricing_table/cart/item/consider_sale_price_as_discountFbool $consider, array $cartItemDen Aktionspreis als Rabatt im Preis des Warenkorbartikels anzeigen.
tiered_pricing_table/cart/recalculate_cart_item_subtotalFbool $recalculate, array $cartItem, string $key, string $subtotalHtmlOb die Zwischensummen-Zelle als alt/neu umgeschrieben wird.
tiered_pricing_table/cart/subtotal/consider_sale_price_as_discountFbool $consider, array $cartItem, string $keyDasselbe für die Zwischensumme (Standard: Option).
tiered_pricing_table/minimum_quantity/control_cart_quantity_fieldFbool $control, WC_Product $productDem Add-on für die Mindestmenge erlauben, min im Mengenfeld des Warenkorbs zu setzen.
tiered_pricing_table/minimum_quantity/item_quantityFint $quantity, int $productIdMenge, die mit dem Minimum verglichen wird.
tiered_pricing_table/manual_created_orders/modify_item_priceFbool $modify, WC_Order_Item_Product $itemEinen Artikel überspringen, wenn eine manuelle Bestellung mit Staffelpreisen neu berechnet wird.

Produktseite, dynamischer Preis und Katalog

HookTypParameterBeschreibung
tiered_pricing_table/should_render_pricing_tableFbool $render, int $parentProductId, ?int $variationId, array $settingsGeben Sie false zurück, um das gesamte Widget zu unterdrücken.
tiered_pricing_table/display_settingsFarray $settings, int $productIdEndgültige Render-Einstellungen (die Produkt-ID ist die der Variante, sobald sie aufgelöst ist).
tiered_pricing_table/frontend/enqueue_assetsFbool $enqueueOb das Frontend-Skript und das Stylesheet auf der aktuellen Seite geladen werden (Standard true, jede Seite). Geben Sie bei Ihren eigenen Bedingungen false zurück, um sie zu überspringen; eine Seite, die eine Preistabelle oder ein Produktraster ausgibt, lädt sie trotzdem.
tiered_pricing_table/ajax_variations_thresholdFint $thresholdVarianten oberhalb dieser Anzahl werden per AJAX geladen, statt vorab gerendert zu werden (Standard 10).
tiered_pricing_table/before_rendering_tiered_pricingAWC_Product $parentProduct, ?int $variationId, array $settingsVor dem Wrapper.
tiered_pricing_table/before_rendering_tiered_pricing/innerAPricingRule $rule, WC_Product $product, array $settingsBevor ein Layout-Template eingebunden wird (auch für jede vorab gerenderte/per AJAX geladene Variante). Der Debug-Modus gibt hier aus.
tiered_pricing_table/product/default_variationF?WC_Product_Variation $variation, int $productIdStandardmäßig angezeigte Variante eines variablen Produkts.
tiered_pricing_table/frontend/wrap_priceFbool $wrap, WC_Product $product, string $priceHtmlDas Preis-HTML in das Span für den dynamischen Preis einschließen.
tiered_pricing_table/frontend/wrap_variable_priceFbool $wrap, WC_Product $productDasselbe für variable Produkte.
tiered_pricing_table/frontend/default_price_behaviour_typeFstring $type ('dynamic'), WC_Product $product, string $priceHtml, string $contextdynamic (JS schreibt den Preis um), static (unverändert lassen), no-rules. $context ist product-page oder shop-loop.
tiered_pricing_table/frontend/modify_price_suffixFbool $modify, string $suffix, WC_Product $product, $price, $qty{price_including_tax} / {price_excluding_tax} in Spans einschließen, die das JS aktualisieren kann.
tiered_pricing_table/frontend/variation_render_settingsFarray $settings, int $variationId, string $displayContextEinstellungen für Variantentabellen, die per AJAX geladen werden.
tiered_pricing_table/frontend/load_variation/verify_nonceFbool $verify, string $nonce, string $actionNonce-Prüfung am AJAX-Endpunkt get_pricing_table aktivieren (Standard false).
tiered_pricing_table/catalog_pricing/price_htmlFstring $newHtml, string $defaultHtml, WC_Product $productPreis-HTML im Katalog (niedrigster / Spanne / benutzerdefiniert).
tiered_pricing_table/catalog_pricing/format_variation_priceFbool $format, string $defaultHtml, WC_Product $variationAuch Variantenpreise im Katalog formatieren (Standard false).
tiered_pricing_table/text_template_variablesFarray $variablesIn Textvorlagen-Einstellungen angebotene Platzhalter (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).

Template-Hooks

Werden in den Layout-Templates in views/frontend/ ausgelöst. $args für Label-Actions ist ['id' => $id, 'style' => '<style>']; $qty ist in row_columns für die Basiszeile (Minimum) null.

HookTypParameterBeschreibung
tiered_pricing_table/tiered_pricing/beforeAPricingRule $ruleVor der Tabelle (Tabellenstile, horizontale Tabelle).
tiered_pricing_table/tiered_pricing/header_columnsAPricingRule $ruleZusätzliche <th>-Kopfzellen ausgeben (Tabellenstile, horizontale Tabelle).
tiered_pricing_table/tiered_pricing/row_columnsAPricingRule $rule, ?int $qtyZusätzliche <td>-Zellen pro Zeile ausgeben.
tiered_pricing_table/tiered_pricing/rowsAPricingRule $rule, array $settings, string $templateNameZusätzliche Zeilen am Ende von <tbody>.
tiered_pricing_table/table/tfootAPricingRule $rule, array $settings, string $templateNameTabellenfuß.
tiered_pricing_table/tiered_pricing/afterAPricingRule $rule, int $productIdNach der Tabelle (die horizontale Tabelle übergibt nur $rule).
tiered_pricing_table/tiered_pricing/last_tier_postfixFstring $postfix ('+'), int $qty, PricingRule $rule, string $layout ('table'|'blocks')Suffix der Menge der letzten Staffel (z. B. 100+).
tiered_pricing_table/table/labelAPricingRule $rule, int $qty, array $argsBadge neben einer Menge in Tabellenlayouts.
tiered_pricing_table/horizontal-table/labelAPricingRule $rule, int $qty, array $argsBadge in der horizontalen Tabelle.
tiered_pricing_table/blocks/labelAPricingRule $rule, int $qty, array $argsBadge in Block-Layouts.
tiered_pricing_table/options/labelAPricingRule $rule, int $qty, array $argsBadge in Options-Layouts.
tiered_pricing_table/dropdown/labelAPricingRule $rule, int $qty, array $argsBadge im Dropdown.
tiered_pricing_table/plain-text/labelAPricingRule $rule, int $qty, array $argsBadge in Klartextzeilen.
tiered_pricing_table/horizontal-table/after_columnsAPricingRule $rule, array $settingsZusätzliche Spalten im horizontalen Raster.
tiered_pricing_table/blocks/blocksAPricingRule $rule, array $settingsZusätzliche Blöcke innerhalb von .tiered-pricing-blocks.
tiered_pricing_table/blocks/after_blocksAPricingRule $ruleNach dem Block-Container.
tiered_pricing_table/options/optionsAPricingRule $rule, array $settingsZusätzliche Optionen.
tiered_pricing_table/options/after_optionsAPricingRule $ruleNach den Optionen.
tiered_pricing_table/dropdown/optionsAPricingRule $ruleZusätzliche <li>-Optionen.
tiered_pricing_table/dropdown/after_optionsAPricingRule $ruleNach der Dropdown-Liste.
tiered_pricing_table/plain-text/lineAPricingRule $rule, array $settingsZusätzliche Zeilen.
tiered_pricing_table/plain-text/after_linesAPricingRule $rule, array $settingsNach der Liste.
tiered_pricing_table/product_page/before_table_summaryAstring $totalLabel, string $eachLabelUm die Summenübersicht (Tabelle und detailliert).
tiered_pricing_table/summary/before_inline_summaryAstring $totalLabel, string $eachLabelVor der Inline-Zusammenfassung.
tiered_pricing_table/summary/after_inline_summaryAstring $totalLabel, string $eachLabelNach der Inline-Zusammenfassung.

Staffel-Labels und benutzerdefinierte Spalten

HookTypParameterBeschreibung
tiered_pricing_table/addons/tier_labels/label_htmlFstring $html, TierLabel $labelGerendertes Label-Markup.
tiered_pricing_table/custom_columns/available_columns_typesFarray<string,string> $typesEinen Spaltentyp registrieren (Typ ⇒ Bezeichnung).
tiered_pricing_table/custom_columns/available_data_typesFarray $typesprice, number, text.
tiered_pricing_table/custom_columns/columns_handlersFarray<string,string> $handlersSpaltentyp ⇒ Handler-Klasse (erweitert AbstractCustomColumn).
tiered_pricing_table/custom_columns/show_custom_columnFbool $visible, AbstractCustomColumn $columnEine Spalte aus- oder einblenden.
tiered_pricing_table/custom_columns/nameFstring $name, AbstractCustomColumn $columnText der Spaltenüberschrift.
tiered_pricing_table/custom_columns/valueFmixed $value, PricingRule $rule, ?int $qty, AbstractCustomColumn $columnZellenwert.

Globale Preisregeln

HookTypParameterBeschreibung
tiered_pricing_table/global_pricing/matched_pricing_ruleF?GlobalPricingRule $rule, WC_Product $product, WP_User $userDie für ein Produkt/einen Benutzer gewählte Regel; implementieren Sie hier eine eigene Auswahllogik.
tiered_pricing_table/global_pricing/match_requirementsFbool $matched, GlobalPricingRule $rule, WP_User $user, WC_Product $productErgebnis der Abgleichslogik einer Regel.
tiered_pricing_table/global_pricing/after_built_ruleFGlobalPricingRule $ruleAus Post-Metadaten erstellte Regel; lesen Sie Ihre eigenen Metadaten in $rule->data.
tiered_pricing_table/global_pricing/validationFbool $valid, GlobalPricingRule $ruleOb eine Regel als gültig gilt (hat Preise).
tiered_pricing_table/global_pricing/order_discount/linesFarray $lines, WC_Cart $cartDie Warenkorbpositionen, die eine Warenkorbregel zählt (key, product, quantity, amount nach Staffelpreisen, je nach Einstellung mit oder ohne Steuer).
tiered_pricing_table/global_pricing/order_discount/ruleF?GlobalPricingRule $rule, array $lines, WP_User $userDie Warenkorbregel, unter die der Warenkorb fällt (höchste Priorität, passend zum Kunden, mit einer gezählten Position).
tiered_pricing_table/global_pricing/order_discount/resolvedFOrderDiscount $discount, WC_Cart $cart, WP_User $userDer Rabatt, den der Warenkorb erreicht hat, bevor er angewendet wird.
tiered_pricing_table/global_pricing/order_discount/coupon_codeFstring $code, GlobalPricingRule $ruleDer Code des virtuellen Gutscheins (der Regeltitel als Slug oder order-discount-{id}, wenn ein echter Gutschein ihm gehört).
tiered_pricing_table/global_pricing/order_discount/coupon_propsFarray $props, GlobalPricingRule $ruleDie Gutscheindaten, die an WooCommerce übergeben werden (discount_type, amount, product_ids, …).
tiered_pricing_table/global_pricing/order_discount/labelFstring $label, OrderDiscount $discountDie Bezeichnung der Rabattzeile, Platzhalter ausgefüllt.
tiered_pricing_table/global_pricing/order_discount/nudgeFstring $message, array $next, WC_Cart $cartDie Meldung „Noch X hinzufügen“ ($next: Regel, Staffel, Basis, Zwischensumme, Menge, verbleibend).
tiered_pricing_table/global_pricing/order_discount/missed_minimumsFarray $missed, array $lines, WP_User $userDie nicht erfüllten Mindestwerte der passenden Bestellregeln (rule, type, minimum, actual).
tiered_pricing_table/global_pricing/order_discount/shipping_barF?array $progress, ?WC_Cart $cart, WP_User $userDer Zustand des Balkens für kostenlosen Versand, bevor er gerendert wird (rule, mode, items, threshold, value, remaining, reached, percent); geben Sie null zurück, um den Balken auszublenden.
tiered_pricing_table/global_pricing/has_order_rulesFbool $hasOb der Shop eine Warenkorbregel in einem beliebigen Status außer Papierkorb hat: Nur dann zeigt die Regelliste ihren Typfilter, die Schaltfläche für die Einstellungen der Warenkorbregeln und, wenn es auch Produktregeln gibt, den Typ jeder Zeile (ab 8.3.0)
tiered_pricing_table/global_pricing/has_product_rulesFbool $hasOb der Shop eine Produktpreisregel hat (Regeln, die vor Einführung der Regeltypen gespeichert wurden, zählen als Produktregeln) (ab 8.3.0)
tiered_pricing_table/global_pricing/show_rule_type_pointerFbool $showOb sich der Tipp beim Regeltyp bei einer neuen Regel öffnet: standardmäßig, solange der Shop keine Preisregel hat und der Benutzer ihn nicht geschlossen hat (ab 8.3.0)
tiered_pricing_table/global_pricing/before_adjusting_pricing_ruleFPricingRule $rule, GlobalPricingRule $globalRule, int $productId, string $priorityBevor eine passende Regel angewendet wird ($priority: flexible | prefer-product | override).
tiered_pricing_table/global_pricing/after_adjusting_pricing_ruleFPricingRule $rule, GlobalPricingRule $globalRule, int $productId, string $priorityNachdem sie angewendet wurde.
tiered_pricing_table/global_pricing/form_tabsFFormTab[] $tabs, Form $formTabs des Regeleditors.
tiered_pricing_table/global_pricing/form/tab_endAFormTab $tab, GlobalPricingRule $ruleEnde jedes Tabs.
tiered_pricing_table/global_pricing/after_minimum_order_quantity_fieldAint $ruleId, GlobalPricingRule $ruleTab „Menge“, nach dem Feld für das Minimum.
tiered_pricing_table/global_pricing/before_updatingAGlobalPricingRule $rule, int $ruleIdBeim Speichern, vor $rule->save(): benutzerdefinierte Felder speichern.
tiered_pricing_table/global_pricing/columnsFarray $columnsSpalten der Listentabelle (Objekte mit getName()/render()).
tiered_pricing_table/global_pricing/table/after_tab_renderAstring $column, GlobalPricingRule $ruleNachdem eine Zelle der Listentabelle gerendert wurde.

Rollenbasierte Preise

HookTypParameterBeschreibung
tiered_pricing_table/role_based_rules/available_rolesFarray $rolesRollen, auf die eine Produktregel zielen kann, als key => label: jede WordPress-Rolle plus guest (nicht angemeldete Besucher).
tiered_pricing_table/role_based_rules/rule_exists_metaFstring[] $metaSuffixes, string $roleMeta-Suffixe, bei deren Vorhandensein „die Rolle hat Regeln“ gilt (Standard _tiered_price_rules_type, _tiered_price_pricing_type).
tiered_pricing_table/role_based_rules/price/product_price_rulesFarray $rules, int $productId, string $typeStaffelregeln der Rolle, aus den Metadaten gelesen.
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 $productIdMindestmenge der Rolle.
tiered_pricing_table/role_based_rules/price/regular_priceF?float $price, string $role, int $productIdRegulärer Preis der Rolle.
tiered_pricing_table/role_based_rules/price/sale_priceF?float $price, string $role, int $productIdAktionspreis der Rolle.
tiered_pricing_table/role_based_rules/price/discountF?float $discount, string $role, int $productIdProzentualer Rabatt der Rolle.
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 $productIdÜberschreibung des Steuerstatus der Rolle.
tiered_pricing_table/role_based_rules/price/tax_classFstring $class, string $role, int $productIdÜberschreibung der Steuerklasse der Rolle.
tiered_pricing_table/role_based_rules/delete_role_ruleAint $productId, string $roleNachdem die Regeln einer Rolle von einem Produkt gelöscht wurden.
tiered_pricing_table/role_based_rules/save_role_based_rulesAint $productId, array $postData, string $role, ?int $loopNachdem die Regeln einer Rolle im Produkteditor gespeichert wurden.
tiered_pricing_table/role_based_pricing/after_adjusting_pricing_ruleAPricingRule $rule, RoleBasedPricingRule $roleRule, int $productIdNachdem die Rollenregel auf die PricingRule des Produkts angewendet wurde.
tiered_pricing_table/role_based/after_built_ruleFRoleBasedPricingRule $ruleAus Metadaten erstellte Regel.
tiered_pricing_table/role_based/after_built_rule_from_arrayFRoleBasedPricingRule $rule, string $role, array $dataAus einem Array (Import) erstellte Regel.
tiered_pricing_table/role_based_rules/import_export_disabled_rolesFstring[] $rolesRollen, die vom CSV-Import/-Export ausgeschlossen sind (Standard editor, author, contributor, shop_manager).

Kundenbasierte Preise

HookTypParameterBeschreibung
tiered_pricing_table/user_based_rules/rule_exists_metaFstring[] $metaSuffixes, int $userIdWie das Pendant für Rollen.
tiered_pricing_table/user_based_rules/price/product_price_rulesFarray $rules, int $productId, string $typeStaffelregeln des Kunden.
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 $productIdMindestmenge des Kunden.
tiered_pricing_table/user_based_rules/price/regular_priceF?float $price, int $userId, int $productIdRegulärer Preis des Kunden.
tiered_pricing_table/user_based_rules/price/sale_priceF?float $price, int $userId, int $productIdAktionspreis des Kunden.
tiered_pricing_table/user_based_rules/price/discountF?float $discount, int $userId, int $productIdRabatt des Kunden.
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 $productIdÜberschreibung des Steuerstatus.
tiered_pricing_table/user_based_rules/price/tax_classFstring $class, int $userId, int $productIdÜberschreibung der Steuerklasse.
tiered_pricing_table/user_based_rules/delete_user_ruleAint $productId, int $userIdNachdem die Regeln eines Kunden gelöscht wurden.
tiered_pricing_table/user_based_rules/save_user_based_rulesAint $productId, array $postData, int $userId, ?int $loopNachdem die Regeln eines Kunden gespeichert wurden.
tiered_pricing_table/user_based_pricing/after_adjusting_pricing_ruleAPricingRule $rule, UserBasedPricingRule $userRule, int $productIdNachdem die Kundenregel angewendet wurde.
tiered_pricing_table/user_based/after_built_ruleFUserBasedPricingRule $ruleAus Metadaten erstellte Regel.
tiered_pricing_table/user_based/after_built_rule_from_arrayFUserBasedPricingRule $rule, int $userId, array $dataAus einem Array erstellte Regel.

Produkteditor im Admin-Bereich

HookTypParameterBeschreibung
tiered_pricing_table/admin/pricing_tab_beginAint $postIdOberer Bereich des Tabs Staffelpreise.
tiered_pricing_table/admin/after_minimum_order_quantity_fieldAint $productId, ?int $loop, string $customPrefixNach dem Feld für die Mindestmenge: im Tab „Allgemein“ eines einfachen Produkts (Präfix ''), im Abschnitt Variables Produkt eines variablen Produkts (Präfix '_variable', das auch die Feldnamen tragen) und in jeder Variante ($loop gesetzt).
tiered_pricing_table/admin/before_advance_product_optionsAint $postIdVor dem Abschnitt Anzeige.
tiered_pricing_table/admin/advance_product_optionsAint $postIdEnde des Abschnitts Anzeige (Layout und Einheitenbezeichnung); der Ort für eigene Felder pro Produkt.
tiered_pricing_table/admin/variable_product_optionsAint $postIdIm Abschnitt Variables Produkt (der erste Abschnitt des Tabs, nur bei variablen Produkten), nach den Staffeln und Mengenbeschränkungen des übergeordneten Produkts; hier werden die Felder für Standardvariante, gemeinsame Preise und Berechnung des Minimums ausgegeben.
tiered_pricing_table/admin/visibility_optionsAint $postIdIm Abschnitt Sichtbarkeit; der Abschnitt wird nur ausgegeben, wenn hier etwas eingehängt ist (das Wer darf dieses Produkt sehen des Add-ons für den privaten Shop).
tiered_pricing_table/admin/pricing_tab_endAint $postIdUnterer Bereich des Tabs.
tiered_pricing_table/admin/role_customer_pricing_tab_activeFbool $activeDen Abschnitt Rollen- und Kundenpreise im Tab Staffelpreise anzeigen (vor 8.2.0 / 10.2.0 ein eigener Tab).
tiered_pricing_table/admin/role_customer_pricing_tab_beginAint $postIdOberer Bereich des Abschnitts Rollen- und Kundenpreise.
tiered_pricing_table/admin/role_customer_pricing_tab_contentAint $postIdInhalt des Abschnitts (Rollenblock 99, Kundenblock 100).
tiered_pricing_table/admin/role_customer_pricing_tab_endAint $postIdUnterer Bereich des Abschnitts.
tiered_pricing_table/admin/role_customer_section_openFbool $open, int $productIdOb der Abschnitt Rollen- und Kundenpreise geöffnet startet (Standard: geöffnet bei einfachen Produkten, bei variablen Produkten nur, wenn das Produkt Rollen- oder Kundenpreise hat).
tiered_pricing_table/admin/tiered_pricing_rules_form/form_beginA$entityId, ?string $role, ?int $loop, string $customPrefixAnfang der Komponente des Regelformulars.
tiered_pricing_table/admin/tiered_pricing_rules_form/after_pricing_typeA$entityId, ?string $role, ?int $loop, string $customPrefixNach der Auswahl fest/prozentual/Betrag.
tiered_pricing_table/admin/tiered_pricing_rules_form/inputsA$entityId, $amount, ?string $role, ?int $loop, string $customPrefix, string $typeIn jeder Staffelzeile.
tiered_pricing_table/admin/tiered_pricing_rules_form/form_endA$entityId, ?string $role, ?int $loop, string $customPrefixEnde der Komponente.
tiered_pricing_table/admin/tiered_pricing_rules_form/inputs_widthFint $percentBreite der Eingabefelder für Menge/Preis (Standard 50).
tiered_pricing_table/admin/components/tiered_pricing_rules_form/get_from_requestA$entityId, ?string $role, ?int $loop, string $customPrefix, array $data, array $requestNachdem das Regelformular aus $_POST ausgewertet wurde.
tiered_pricing_table/admin/role_based_rules/after_minimum_order_quantity_fieldAint $productId, string $role, ?int $loopIm Preisformular einer Rolle.
tiered_pricing_table/admin/role_based_rules/after_tiered_pricing_rules_fieldAint $productId, string $role, ?int $loopIm Preisformular einer Rolle (hier werden die Steuer-Auswahlfelder ausgegeben).
tiered_pricing_table/admin/user_based_rules/after_minimum_order_quantity_fieldAint $productId, int $userId, ?int $loopIm Preisformular eines Kunden.
tiered_pricing_table/admin/user_based_rules/after_tiered_pricing_rules_fieldAint $productId, int $userId, ?int $loopIm Preisformular eines Kunden.
tiered_pricing_table/admin/tips/get_tip_by_slugF?Tip $tip, string $slugEinen benutzerdefinierten Admin-Tipp auflösen.

REST-API, Import und Export

HookTypParameterBeschreibung
tiered_pricing_table/api/product_fieldsFstring[] $fieldClassesKlassen (erweitern ProductField), die als REST-Produktfelder von WooCommerce registriert werden.
tiered_pricing_table/api/supported_product_typesFstring[] $objectTypes, ProductField $fieldREST-Objekttypen, zu denen das Feld hinzugefügt wird (Standard product, product_variation).
tiered_pricing_table/import/woocommerce/import_columnsFarray $columnsSpalten, die im Zuordnungsbildschirm des WooCommerce-CSV-Importers angeboten werden.
tiered_pricing_table/import/woocommerce/mapping_screen_columnsFarray $headerToKeyAutomatische Zuordnung von CSV-Überschriften zu Spalten.
tiered_pricing_table/request_quote/quote_request_submittedAint $quoteRequestIdEine Angebotsanfrage wurde gespeichert (E-Mails hängen sich hier ein).

Integrationen

HookTypParameterBeschreibung
tiered_pricing_table/integrations/pluginsFstring[] $classesIntegrationsklassen für Plugins (Boot-Zeit, siehe Hinweis oben).
tiered_pricing_table/integrations/themesFarray<string,string> $needleToClassTheme-Integrationen, nach einem kleingeschriebenen Suchbegriff indiziert, der mit dem Theme-Namen/Template abgeglichen wird (Boot-Zeit).
tiered_pricing_table/integrations/{slug}/variable_products_supportedFbool $supported, WC_Product $productOb die Erweiterung des SEO-Schemas für variable Produkte läuft; {slug} ist yoast_seo, rank_math oder seopress.

Großhandel und privater Shop

Verfügbar ab 8.0.0; Großhandelsregistrierung und privater Shop sind Teil des kostenlosen Plugins, Zahlungs- und Versandarten nach Rolle erfordern die Premium-Version. Die Mindestbestellung pro Rolle wurde in 8.3.0 zu einer Warenkorbregel (siehe die Hooks order_discount/* unter Globale Preisregeln). Die E-Mails sind Standard-WC_Email-Klassen (TPT_Wholesale_Admin_New_Application, TPT_Wholesale_Customer_Received, TPT_Wholesale_Customer_Approved, TPT_Wholesale_Customer_Rejected), registriert über woocommerce_email_classes und ausgelöst über woocommerce_email_actions, sodass jeder WooCommerce-E-Mail-Filter auf sie anwendbar ist.

HookTypParameterBeschreibung
tiered_pricing_table/wholesale/application_submittedAint $applicationId, WholesaleApplication $applicationEin Großhandelsantrag wurde eingereicht; das Kundenkonto existiert zu diesem Zeitpunkt.
tiered_pricing_table/wholesale/application_approvedAint $applicationId, WholesaleApplication $application, int $decidedByDer Antrag wurde genehmigt und der Kunde hat die Großhandelsrolle. $decidedBy ist die ID des entscheidenden Benutzers, 0 bei automatischer Genehmigung.
tiered_pricing_table/wholesale/application_rejectedAint $applicationId, WholesaleApplication $application, int $decidedByDer Antrag wurde abgelehnt; der Grund wird mit dem Antrag gespeichert.
tiered_pricing_table/closed_store/is_open_pageFbool $openGeben Sie true zurück, um die aktuelle Anfrage für Besucher offen zu halten, während der Shop geschlossen ist (läuft bei template_redirect nach den eingebauten Ausnahmen).

Einstellungen

HookTypParameterBeschreibung
tiered_pricing_table/settings/sectionsFSectionAbstract[] $sectionsEinstellungs-Tabs.
tiered_pricing_table/settings/general_settingsFarray $fieldsFelder des Tabs „Allgemein“ (nachdem die Unterabschnitte zusammengeführt wurden).
tiered_pricing_table/settings/general_subsectionsFstring[] $subsectionClassesUnterabschnitte des Tabs „Allgemein“.
tiered_pricing_table/settings/calculation_logicFarray $fieldsFelder der Gruppe Preisberechnung im Tab „Allgemein“.
tiered_pricing_table/settings/advanced_settingsFarray $fieldsModulschalter des Tabs „Erweitert“ (vor 8.0.0 „Werkzeuge“ genannt).
tiered_pricing_table/settings/tools_settingsFarray $fieldsFelder, die nach den Modulen im Tab „Erweitert“ angezeigt werden (vor Cache und Debug).
tiered_pricing_table/settings/wholesale_subsectionsFstring[] $subsectionClassesUnterabschnittsklassen, die an den Tab „Großhandel“ angehängt werden (ab 8.0.0).
tiered_pricing_table/settings/sections_orderFarray<string,int> $orderReihenfolge der Einstellungs-Tabs (section id => priority).
tiered_pricing_table/settings/is_premiumFbool $premiumOb der Layout-Customizer die Website als Premium behandelt (schaltet die Premium-Steuerelemente frei).
tiered_pricing_table/install/theme_colorF?string $colorDie Theme-Farbe, die bei einer Neuinstallation für die aktive Staffel erkannt wird (der Schaltflächenhintergrund eines Block-Themes oder der Akzent von Storefront, Astra, OceanWP und Flatsome). Geben Sie eine Hex-Farbe zurück, um Ihre eigene zu verwenden, oder null für den neutralen Standard; Farben, auf denen weißer Text nicht lesbar ist, werden verworfen.
tiered_pricing_table/catalog/excluded_stylesFarray<string,string[]> $stylesFür das Produktraster ausgeblendete Designstile (layout => styles; Standard ['blocks' => ['style-8']]).
tiered_pricing_table/settings/integrations_settingsFarray $rowsZeilen der Integrationsschalter.
tiered_pricing_table/settings/integrations_categoriesFarray<string,array> $categoriesIntegrationsgruppen (id => ['title','description']).
tiered_pricing_table/settings/table_columns/after_fieldsA—Nach den Eingabefeldern für die Spaltentitel.
tiered_pricing_table/settings/table_columns/endA—Ende des Feldes für die Spaltentitel (hier wird die Oberfläche für benutzerdefinierte Spalten eingebunden).

Ressourcen

  • Benutzerhandbuch — Dokumentation für Shop-Betreiber zu jeder Funktion.
  • Anleitungen — How-to-Artikel.
  • Kontakt — Ein Hook oder eine Integration fehlt? Sagen Sie uns Bescheid.