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_rules | array<int qty, string price> — z. B. [5 => '9.50', 10 => '8.00'] |
_percentage_price_rules | array<int qty, string percent> |
_amount_price_rules | array<int qty, string amount> — ein Rabattbetrag auf den Produktpreis pro Einheit |
_tiered_price_rules_type | fixed | percentage | amount |
_tiered_price_minimum_qty | int > 1 |
_tiered_pricing_maximum_quantity, _tiered_pricing_group_of_quantity | int (Maximum, Schrittweite) |
_tiered_price_mix_and_match_minimum | yes | no (variables übergeordnetes Produkt) |
_tiered_pricing_template, _tiered_pricing_base_unit_name | Layout-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_type | rollenbasierte 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.

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
| Integrationspunkt | Details |
|---|---|
[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-bar | Derselbe Balken als Block (keine Attribute; unterstützt Ausrichtung und Abstände). |
Block tiered-pricing-table/tiered-pricing-block | displayType, title, activeTierColor, showDiscountColumn, Spaltentitel |
Elementor-Widget tiered-pricing-table | product_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:
| Feld | Wert |
|---|---|
tiered_pricing_type | fixed | percentage | amount |
tiered_pricing_fixed_rules, tiered_pricing_percentage_rules, tiered_pricing_amount_rules | { "<qty>": <price|percent|amount off> } |
tiered_pricing_minimum_quantity | Ganzzahl 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$loopund 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 überwoocommerce_process_product_meta/woocommerce_save_product_variation. Benennen Sie Felder mitTierPricingTable\Forms\Form::getFieldName( $base, $role, $loop ). - Rollen-/Kundenregeln: Rendern Sie auf
…/admin/role_based_rules/after_tiered_pricing_rules_field(unduser_based_rules), speichern Sie auf…/role_based_rules/save_role_based_rules(unduser_based_rules/save_user_based_rules). - Globale Regeln: Fügen Sie mit
tiered_pricing_table/global_pricing/form_tabseinen Tab hinzu (erweitern SieCPT\Form\FormTab), speichern Sie in…/global_pricing/before_updating, lesen Sie Ihre Metadaten in…/global_pricing/after_built_ruleund fügen Sie mit…/global_pricing/columnsListenspalten hinzu. - Benutzerdefinierte Tabellenspalten: Erweitern Sie
Addons\CustomColumns\Columns\AbstractCustomColumnund registrieren Sie die Klasse mittiered_pricing_table/custom_columns/available_columns_types+…/custom_columns/columns_handlers. - Add-ons: Erweitern Sie
Addons\AbstractAddonund fügen Sie es mittiered_pricing_table/addons/listhinzu (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_datazwischengespeichert. Leeren Sie es unter Einstellungen → Module → Cache oder mitServiceContainer::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
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tpt_fs_loaded | A | — | Freemius-SDK initialisiert (tpt_fs() verfügbar). |
tiered_pricing_table/ | F | string $className | Klassenname, der von ServiceContainer::initService() instanziiert wird. Geben Sie eine Unterklasse zurück, um einen Service zu ersetzen. |
tiered_pricing_table/ | F | array<string,AbstractAddon> $addons | Add-on-Instanzen nach Klasse indiziert, vor run(). Fügen Sie Add-ons hinzu, entfernen oder ersetzen Sie sie. |
tiered_pricing_table/ | F | string[] $types | Standard: simple, variation, subscription, subscription-variation. |
tiered_pricing_table/ | F | string[] $types | Standard: variable, variable-subscription. |
tiered_pricing_table/ | F | string[] $types | Standard: variation, subscription-variation. |
tiered_pricing_table/ | F | array<string,string> $layouts | Layout-Slug ⇒ Bezeichnung (table, blocks, options, dropdown, horizontal-table, plain-text, tooltip). |
tiered_pricing_table/ | F | WP_User $user | Der Benutzer, für den Preise berechnet werden (Standard: aktueller Benutzer oder $GLOBALS['tpt_current_user_id']). |
tiered_pricing_table/ | F | string[] $roles, int $userId | Rollen, die für rollenbasierte Preise und Cache-Schlüssel verwendet werden; ein nicht angemeldeter Besucher erhält die Pseudo-Rolle guest. |
tiered_pricing_table/ | F | string $separator | Trennzeichen für qty:price-Listen beim CSV-Import/-Export (Standard ,). |
tiered_pricing_table/ | F | string $separator | Trennzeichen 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/ | F | string $absolutePath, string $template | Endgültiger Pfad eines beliebigen Templates (frontend/…, admin/…, addons/…). |
tiered_pricing_table/ | A | string $absolutePath, array $variables | Bevor ein Template eingebunden wird. |
tiered_pricing_table/ | A | string $absolutePath, array $variables | Nachdem ein Template eingebunden wurde. |
tiered_pricing_table/ | F | string $url, string $file | URL eines JS-Assets des Plugins. |
tiered_pricing_table/ | F | string $url, string $file | URL eines CSS-Assets des Plugins. |
Preisberechnung
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | F | PricingRule $rule, int $productId | Zentraler 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/ | F | array $rules, int $productId, string $type | Regeln auf Produktebene, aus den Metadaten gelesen (nur Kontext view). |
tiered_pricing_table/ | F | float|false $price, int $quantity, int $productId, string $context, string $place, PricingRule $rule | Endgültiger Stückpreis für eine Menge (false = keine Staffel getroffen). |
tiered_pricing_table/ | F | bool $round | Ob Staffelpreise gerundet werden (Standard: Option Preis runden). |
tiered_pricing_table/ | F | int $decimals | Rundungsgenauigkeit (Standard max(2, wc_get_price_decimals())). |
tiered_pricing_table/ | F | int $decimals, float $percent, ?WC_Product $product, ?PricingRule $rule | Nachkommastellen 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/ | F | string $type, int $productId | Preisart auf Produktebene (fixed | percentage | amount). |
tiered_pricing_table/ | F | ?int $minimum, int $productId | Mindestbestellmenge auf Produktebene. |
tiered_pricing_table/ | F | bool $enabled | Geben Sie true zurück, um RegularPricingService zu aktivieren (WC-Preisfilter). Global-/Rollen-/Kunden-Add-ons tun dies. |
tiered_pricing_table/ | F | ?float $newPrice, ?WC_Product $product, ?string $specific ('regular'|'sale'|null), $originalPrice | Angepasster regulärer Preis / Aktionspreis / aktueller Preis für den aktuellen Benutzer (null behält den Wert von WooCommerce bei). |
tiered_pricing_table/ | F | bool $override | Ob bei Produkten mit dem Preis null der Preis überschrieben wird (Standard true). |
tiered_pricing_table/ | F | ?int $value, int $productId, string|false $role | Maximale Menge für ein Produkt; rollenspezifische Werte werden hier angewendet. |
tiered_pricing_table/ | F | ?int $value, int $productId, string|false $role | Mengenschritt für ein Produkt. |
tiered_pricing_table/ | F | bool $skip, int $productId, WC_Product $product | Veraltete Regeln auf Kategorieebene für ein Produkt überspringen. |
tiered_pricing_table/ | F | bool $check, WC_Product $product | Geben Sie true zurück, damit productHasPricingRules() die Varianten durchsucht, statt anzunehmen, dass ein variables Produkt Regeln hat. |
Warenkorb und Kasse
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | F | bool $recalculate, array $cartItem, WC_Cart $cart | Geben Sie false zurück, um den Preis eines Artikels WooCommerce zu überlassen (das Gutschein-Add-on nutzt dies bei 999). |
tiered_pricing_table/ | F | float|false $price, array $cartItem, string $cartItemKey, int $totalQuantity | Auf dem Warenkorbartikel gesetzter Stückpreis. |
tiered_pricing_table/ | F | int $count, array $cartItem | Menge, 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/ | F | bool $recalculate, array $cartItem | Wie oben, für den angezeigten Artikelpreis. |
tiered_pricing_table/ | F | float $savings, WC_Cart $cart | Betrag, der in der Zeile „Gesamtersparnis“ der Warenkorbsummen und an der klassischen Kasse angezeigt wird. |
tiered_pricing_table/ | F | float|false $price, array $cartItem | Angezeigter Stückpreis. |
tiered_pricing_table/ | F | float $oldPrice, array $cartItem | Durchgestrichener Preis neben dem reduzierten Preis. |
tiered_pricing_table/ | F | bool $consider, array $cartItem | Den Aktionspreis als Rabatt im Preis des Warenkorbartikels anzeigen. |
tiered_pricing_table/ | F | bool $recalculate, array $cartItem, string $key, string $subtotalHtml | Ob die Zwischensummen-Zelle als alt/neu umgeschrieben wird. |
tiered_pricing_table/ | F | bool $consider, array $cartItem, string $key | Dasselbe für die Zwischensumme (Standard: Option). |
tiered_pricing_table/ | F | bool $control, WC_Product $product | Dem Add-on für die Mindestmenge erlauben, min im Mengenfeld des Warenkorbs zu setzen. |
tiered_pricing_table/ | F | int $quantity, int $productId | Menge, die mit dem Minimum verglichen wird. |
tiered_pricing_table/ | F | bool $modify, WC_Order_Item_Product $item | Einen Artikel überspringen, wenn eine manuelle Bestellung mit Staffelpreisen neu berechnet wird. |
Produktseite, dynamischer Preis und Katalog
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | F | bool $render, int $parentProductId, ?int $variationId, array $settings | Geben Sie false zurück, um das gesamte Widget zu unterdrücken. |
tiered_pricing_table/ | F | array $settings, int $productId | Endgültige Render-Einstellungen (die Produkt-ID ist die der Variante, sobald sie aufgelöst ist). |
tiered_pricing_table/ | F | bool $enqueue | Ob 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/ | F | int $threshold | Varianten oberhalb dieser Anzahl werden per AJAX geladen, statt vorab gerendert zu werden (Standard 10). |
tiered_pricing_table/ | A | WC_Product $parentProduct, ?int $variationId, array $settings | Vor dem Wrapper. |
tiered_pricing_table/ | A | PricingRule $rule, WC_Product $product, array $settings | Bevor ein Layout-Template eingebunden wird (auch für jede vorab gerenderte/per AJAX geladene Variante). Der Debug-Modus gibt hier aus. |
tiered_pricing_table/ | F | ?WC_Product_Variation $variation, int $productId | Standardmäßig angezeigte Variante eines variablen Produkts. |
tiered_pricing_table/ | F | bool $wrap, WC_Product $product, string $priceHtml | Das Preis-HTML in das Span für den dynamischen Preis einschließen. |
tiered_pricing_table/ | F | bool $wrap, WC_Product $product | Dasselbe für variable Produkte. |
tiered_pricing_table/ | F | string $type ('dynamic'), WC_Product $product, string $priceHtml, string $context | dynamic (JS schreibt den Preis um), static (unverändert lassen), no-rules. $context ist product-page oder shop-loop. |
tiered_pricing_table/ | F | bool $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/ | F | array $settings, int $variationId, string $displayContext | Einstellungen für Variantentabellen, die per AJAX geladen werden. |
tiered_pricing_table/ | F | bool $verify, string $nonce, string $action | Nonce-Prüfung am AJAX-Endpunkt get_pricing_table aktivieren (Standard false). |
tiered_pricing_table/ | F | string $newHtml, string $defaultHtml, WC_Product $product | Preis-HTML im Katalog (niedrigster / Spanne / benutzerdefiniert). |
tiered_pricing_table/ | F | bool $format, string $defaultHtml, WC_Product $variation | Auch Variantenpreise im Katalog formatieren (Standard false). |
tiered_pricing_table/ | F | array $variables | In 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.
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | A | PricingRule $rule | Vor der Tabelle (Tabellenstile, horizontale Tabelle). |
tiered_pricing_table/ | A | PricingRule $rule | Zusätzliche <th>-Kopfzellen ausgeben (Tabellenstile, horizontale Tabelle). |
tiered_pricing_table/ | A | PricingRule $rule, ?int $qty | Zusätzliche <td>-Zellen pro Zeile ausgeben. |
tiered_pricing_table/ | A | PricingRule $rule, array $settings, string $templateName | Zusätzliche Zeilen am Ende von <tbody>. |
tiered_pricing_table/ | A | PricingRule $rule, array $settings, string $templateName | Tabellenfuß. |
tiered_pricing_table/ | A | PricingRule $rule, int $productId | Nach der Tabelle (die horizontale Tabelle übergibt nur $rule). |
tiered_pricing_table/ | F | string $postfix ('+'), int $qty, PricingRule $rule, string $layout ('table'|'blocks') | Suffix der Menge der letzten Staffel (z. B. 100+). |
tiered_pricing_table/ | A | PricingRule $rule, int $qty, array $args | Badge neben einer Menge in Tabellenlayouts. |
tiered_pricing_table/ | A | PricingRule $rule, int $qty, array $args | Badge in der horizontalen Tabelle. |
tiered_pricing_table/ | A | PricingRule $rule, int $qty, array $args | Badge in Block-Layouts. |
tiered_pricing_table/ | A | PricingRule $rule, int $qty, array $args | Badge in Options-Layouts. |
tiered_pricing_table/ | A | PricingRule $rule, int $qty, array $args | Badge im Dropdown. |
tiered_pricing_table/ | A | PricingRule $rule, int $qty, array $args | Badge in Klartextzeilen. |
tiered_pricing_table/ | A | PricingRule $rule, array $settings | Zusätzliche Spalten im horizontalen Raster. |
tiered_pricing_table/ | A | PricingRule $rule, array $settings | Zusätzliche Blöcke innerhalb von .tiered-pricing-blocks. |
tiered_pricing_table/ | A | PricingRule $rule | Nach dem Block-Container. |
tiered_pricing_table/ | A | PricingRule $rule, array $settings | Zusätzliche Optionen. |
tiered_pricing_table/ | A | PricingRule $rule | Nach den Optionen. |
tiered_pricing_table/ | A | PricingRule $rule | Zusätzliche <li>-Optionen. |
tiered_pricing_table/ | A | PricingRule $rule | Nach der Dropdown-Liste. |
tiered_pricing_table/ | A | PricingRule $rule, array $settings | Zusätzliche Zeilen. |
tiered_pricing_table/ | A | PricingRule $rule, array $settings | Nach der Liste. |
tiered_pricing_table/ | A | string $totalLabel, string $eachLabel | Um die Summenübersicht (Tabelle und detailliert). |
tiered_pricing_table/ | A | string $totalLabel, string $eachLabel | Vor der Inline-Zusammenfassung. |
tiered_pricing_table/ | A | string $totalLabel, string $eachLabel | Nach der Inline-Zusammenfassung. |
Staffel-Labels und benutzerdefinierte Spalten
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | F | string $html, TierLabel $label | Gerendertes Label-Markup. |
tiered_pricing_table/ | F | array<string,string> $types | Einen Spaltentyp registrieren (Typ ⇒ Bezeichnung). |
tiered_pricing_table/ | F | array $types | price, number, text. |
tiered_pricing_table/ | F | array<string,string> $handlers | Spaltentyp ⇒ Handler-Klasse (erweitert AbstractCustomColumn). |
tiered_pricing_table/ | F | bool $visible, AbstractCustomColumn $column | Eine Spalte aus- oder einblenden. |
tiered_pricing_table/ | F | string $name, AbstractCustomColumn $column | Text der Spaltenüberschrift. |
tiered_pricing_table/ | F | mixed $value, PricingRule $rule, ?int $qty, AbstractCustomColumn $column | Zellenwert. |
Globale Preisregeln
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | F | ?GlobalPricingRule $rule, WC_Product $product, WP_User $user | Die für ein Produkt/einen Benutzer gewählte Regel; implementieren Sie hier eine eigene Auswahllogik. |
tiered_pricing_table/ | F | bool $matched, GlobalPricingRule $rule, WP_User $user, WC_Product $product | Ergebnis der Abgleichslogik einer Regel. |
tiered_pricing_table/ | F | GlobalPricingRule $rule | Aus Post-Metadaten erstellte Regel; lesen Sie Ihre eigenen Metadaten in $rule->data. |
tiered_pricing_table/ | F | bool $valid, GlobalPricingRule $rule | Ob eine Regel als gültig gilt (hat Preise). |
tiered_pricing_table/ | F | array $lines, WC_Cart $cart | Die Warenkorbpositionen, die eine Warenkorbregel zählt (key, product, quantity, amount nach Staffelpreisen, je nach Einstellung mit oder ohne Steuer). |
tiered_pricing_table/ | F | ?GlobalPricingRule $rule, array $lines, WP_User $user | Die Warenkorbregel, unter die der Warenkorb fällt (höchste Priorität, passend zum Kunden, mit einer gezählten Position). |
tiered_pricing_table/ | F | OrderDiscount $discount, WC_Cart $cart, WP_User $user | Der Rabatt, den der Warenkorb erreicht hat, bevor er angewendet wird. |
tiered_pricing_table/ | F | string $code, GlobalPricingRule $rule | Der Code des virtuellen Gutscheins (der Regeltitel als Slug oder order-discount-{id}, wenn ein echter Gutschein ihm gehört). |
tiered_pricing_table/ | F | array $props, GlobalPricingRule $rule | Die Gutscheindaten, die an WooCommerce übergeben werden (discount_type, amount, product_ids, …). |
tiered_pricing_table/ | F | string $label, OrderDiscount $discount | Die Bezeichnung der Rabattzeile, Platzhalter ausgefüllt. |
tiered_pricing_table/ | F | string $message, array $next, WC_Cart $cart | Die Meldung „Noch X hinzufügen“ ($next: Regel, Staffel, Basis, Zwischensumme, Menge, verbleibend). |
tiered_pricing_table/ | F | array $missed, array $lines, WP_User $user | Die nicht erfüllten Mindestwerte der passenden Bestellregeln (rule, type, minimum, actual). |
tiered_pricing_table/ | F | ?array $progress, ?WC_Cart $cart, WP_User $user | Der 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/ | F | bool $has | Ob 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/ | F | bool $has | Ob 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/ | F | bool $show | Ob 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/ | F | PricingRule $rule, GlobalPricingRule $globalRule, int $productId, string $priority | Bevor eine passende Regel angewendet wird ($priority: flexible | prefer-product | override). |
tiered_pricing_table/ | F | PricingRule $rule, GlobalPricingRule $globalRule, int $productId, string $priority | Nachdem sie angewendet wurde. |
tiered_pricing_table/ | F | FormTab[] $tabs, Form $form | Tabs des Regeleditors. |
tiered_pricing_table/ | A | FormTab $tab, GlobalPricingRule $rule | Ende jedes Tabs. |
tiered_pricing_table/ | A | int $ruleId, GlobalPricingRule $rule | Tab „Menge“, nach dem Feld für das Minimum. |
tiered_pricing_table/ | A | GlobalPricingRule $rule, int $ruleId | Beim Speichern, vor $rule->save(): benutzerdefinierte Felder speichern. |
tiered_pricing_table/ | F | array $columns | Spalten der Listentabelle (Objekte mit getName()/render()). |
tiered_pricing_table/ | A | string $column, GlobalPricingRule $rule | Nachdem eine Zelle der Listentabelle gerendert wurde. |
Rollenbasierte Preise
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | F | array $roles | Rollen, auf die eine Produktregel zielen kann, als key => label: jede WordPress-Rolle plus guest (nicht angemeldete Besucher). |
tiered_pricing_table/ | F | string[] $metaSuffixes, string $role | Meta-Suffixe, bei deren Vorhandensein „die Rolle hat Regeln“ gilt (Standard _tiered_price_rules_type, _tiered_price_pricing_type). |
tiered_pricing_table/ | F | array $rules, int $productId, string $type | Staffelregeln der Rolle, aus den Metadaten gelesen. |
tiered_pricing_table/ | F | string $type, string $role, int $productId | fixed | percentage | amount. |
tiered_pricing_table/ | F | ?int $minimum, string $role, int $productId | Mindestmenge der Rolle. |
tiered_pricing_table/ | F | ?float $price, string $role, int $productId | Regulärer Preis der Rolle. |
tiered_pricing_table/ | F | ?float $price, string $role, int $productId | Aktionspreis der Rolle. |
tiered_pricing_table/ | F | ?float $discount, string $role, int $productId | Prozentualer Rabatt der Rolle. |
tiered_pricing_table/ | F | string $type, string $role, int $productId | sale_price | regular_price. |
tiered_pricing_table/ | F | string $type, string $role, int $productId | flat | percentage. |
tiered_pricing_table/ | F | string $status, string $role, int $productId | Überschreibung des Steuerstatus der Rolle. |
tiered_pricing_table/ | F | string $class, string $role, int $productId | Überschreibung der Steuerklasse der Rolle. |
tiered_pricing_table/ | A | int $productId, string $role | Nachdem die Regeln einer Rolle von einem Produkt gelöscht wurden. |
tiered_pricing_table/ | A | int $productId, array $postData, string $role, ?int $loop | Nachdem die Regeln einer Rolle im Produkteditor gespeichert wurden. |
tiered_pricing_table/ | A | PricingRule $rule, RoleBasedPricingRule $roleRule, int $productId | Nachdem die Rollenregel auf die PricingRule des Produkts angewendet wurde. |
tiered_pricing_table/ | F | RoleBasedPricingRule $rule | Aus Metadaten erstellte Regel. |
tiered_pricing_table/ | F | RoleBasedPricingRule $rule, string $role, array $data | Aus einem Array (Import) erstellte Regel. |
tiered_pricing_table/ | F | string[] $roles | Rollen, die vom CSV-Import/-Export ausgeschlossen sind (Standard editor, author, contributor, shop_manager). |
Kundenbasierte Preise
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | F | string[] $metaSuffixes, int $userId | Wie das Pendant für Rollen. |
tiered_pricing_table/ | F | array $rules, int $productId, string $type | Staffelregeln des Kunden. |
tiered_pricing_table/ | F | string $type, int $userId, int $productId | fixed | percentage | amount. |
tiered_pricing_table/ | F | ?int $minimum, int $userId, int $productId | Mindestmenge des Kunden. |
tiered_pricing_table/ | F | ?float $price, int $userId, int $productId | Regulärer Preis des Kunden. |
tiered_pricing_table/ | F | ?float $price, int $userId, int $productId | Aktionspreis des Kunden. |
tiered_pricing_table/ | F | ?float $discount, int $userId, int $productId | Rabatt des Kunden. |
tiered_pricing_table/ | F | string $type, int $userId, int $productId | sale_price | regular_price. |
tiered_pricing_table/ | F | string $type, int $userId, int $productId | flat | percentage. |
tiered_pricing_table/ | F | string $status, int $userId, int $productId | Überschreibung des Steuerstatus. |
tiered_pricing_table/ | F | string $class, int $userId, int $productId | Überschreibung der Steuerklasse. |
tiered_pricing_table/ | A | int $productId, int $userId | Nachdem die Regeln eines Kunden gelöscht wurden. |
tiered_pricing_table/ | A | int $productId, array $postData, int $userId, ?int $loop | Nachdem die Regeln eines Kunden gespeichert wurden. |
tiered_pricing_table/ | A | PricingRule $rule, UserBasedPricingRule $userRule, int $productId | Nachdem die Kundenregel angewendet wurde. |
tiered_pricing_table/ | F | UserBasedPricingRule $rule | Aus Metadaten erstellte Regel. |
tiered_pricing_table/ | F | UserBasedPricingRule $rule, int $userId, array $data | Aus einem Array erstellte Regel. |
Produkteditor im Admin-Bereich
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | A | int $postId | Oberer Bereich des Tabs Staffelpreise. |
tiered_pricing_table/ | A | int $productId, ?int $loop, string $customPrefix | Nach 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/ | A | int $postId | Vor dem Abschnitt Anzeige. |
tiered_pricing_table/ | A | int $postId | Ende des Abschnitts Anzeige (Layout und Einheitenbezeichnung); der Ort für eigene Felder pro Produkt. |
tiered_pricing_table/ | A | int $postId | Im 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/ | A | int $postId | Im 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/ | A | int $postId | Unterer Bereich des Tabs. |
tiered_pricing_table/ | F | bool $active | Den Abschnitt Rollen- und Kundenpreise im Tab Staffelpreise anzeigen (vor 8.2.0 / 10.2.0 ein eigener Tab). |
tiered_pricing_table/ | A | int $postId | Oberer Bereich des Abschnitts Rollen- und Kundenpreise. |
tiered_pricing_table/ | A | int $postId | Inhalt des Abschnitts (Rollenblock 99, Kundenblock 100). |
tiered_pricing_table/ | A | int $postId | Unterer Bereich des Abschnitts. |
tiered_pricing_table/ | F | bool $open, int $productId | Ob 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/ | A | $entityId, ?string $role, ?int $loop, string $customPrefix | Anfang der Komponente des Regelformulars. |
tiered_pricing_table/ | A | $entityId, ?string $role, ?int $loop, string $customPrefix | Nach der Auswahl fest/prozentual/Betrag. |
tiered_pricing_table/ | A | $entityId, $amount, ?string $role, ?int $loop, string $customPrefix, string $type | In jeder Staffelzeile. |
tiered_pricing_table/ | A | $entityId, ?string $role, ?int $loop, string $customPrefix | Ende der Komponente. |
tiered_pricing_table/ | F | int $percent | Breite der Eingabefelder für Menge/Preis (Standard 50). |
tiered_pricing_table/ | A | $entityId, ?string $role, ?int $loop, string $customPrefix, array $data, array $request | Nachdem das Regelformular aus $_POST ausgewertet wurde. |
tiered_pricing_table/ | A | int $productId, string $role, ?int $loop | Im Preisformular einer Rolle. |
tiered_pricing_table/ | A | int $productId, string $role, ?int $loop | Im Preisformular einer Rolle (hier werden die Steuer-Auswahlfelder ausgegeben). |
tiered_pricing_table/ | A | int $productId, int $userId, ?int $loop | Im Preisformular eines Kunden. |
tiered_pricing_table/ | A | int $productId, int $userId, ?int $loop | Im Preisformular eines Kunden. |
tiered_pricing_table/ | F | ?Tip $tip, string $slug | Einen benutzerdefinierten Admin-Tipp auflösen. |
REST-API, Import und Export
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | F | string[] $fieldClasses | Klassen (erweitern ProductField), die als REST-Produktfelder von WooCommerce registriert werden. |
tiered_pricing_table/ | F | string[] $objectTypes, ProductField $field | REST-Objekttypen, zu denen das Feld hinzugefügt wird (Standard product, product_variation). |
tiered_pricing_table/ | F | array $columns | Spalten, die im Zuordnungsbildschirm des WooCommerce-CSV-Importers angeboten werden. |
tiered_pricing_table/ | F | array $headerToKey | Automatische Zuordnung von CSV-Überschriften zu Spalten. |
tiered_pricing_table/ | A | int $quoteRequestId | Eine Angebotsanfrage wurde gespeichert (E-Mails hängen sich hier ein). |
Integrationen
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | F | string[] $classes | Integrationsklassen für Plugins (Boot-Zeit, siehe Hinweis oben). |
tiered_pricing_table/ | F | array<string,string> $needleToClass | Theme-Integrationen, nach einem kleingeschriebenen Suchbegriff indiziert, der mit dem Theme-Namen/Template abgeglichen wird (Boot-Zeit). |
tiered_pricing_table/ | F | bool $supported, WC_Product $product | Ob 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.
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | A | int $applicationId, WholesaleApplication $application | Ein Großhandelsantrag wurde eingereicht; das Kundenkonto existiert zu diesem Zeitpunkt. |
tiered_pricing_table/ | A | int $applicationId, WholesaleApplication $application, int $decidedBy | Der Antrag wurde genehmigt und der Kunde hat die Großhandelsrolle. $decidedBy ist die ID des entscheidenden Benutzers, 0 bei automatischer Genehmigung. |
tiered_pricing_table/ | A | int $applicationId, WholesaleApplication $application, int $decidedBy | Der Antrag wurde abgelehnt; der Grund wird mit dem Antrag gespeichert. |
tiered_pricing_table/ | F | bool $open | Geben 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
| Hook | Typ | Parameter | Beschreibung |
|---|---|---|---|
tiered_pricing_table/ | F | SectionAbstract[] $sections | Einstellungs-Tabs. |
tiered_pricing_table/ | F | array $fields | Felder des Tabs „Allgemein“ (nachdem die Unterabschnitte zusammengeführt wurden). |
tiered_pricing_table/ | F | string[] $subsectionClasses | Unterabschnitte des Tabs „Allgemein“. |
tiered_pricing_table/ | F | array $fields | Felder der Gruppe Preisberechnung im Tab „Allgemein“. |
tiered_pricing_table/ | F | array $fields | Modulschalter des Tabs „Erweitert“ (vor 8.0.0 „Werkzeuge“ genannt). |
tiered_pricing_table/ | F | array $fields | Felder, die nach den Modulen im Tab „Erweitert“ angezeigt werden (vor Cache und Debug). |
tiered_pricing_table/ | F | string[] $subsectionClasses | Unterabschnittsklassen, die an den Tab „Großhandel“ angehängt werden (ab 8.0.0). |
tiered_pricing_table/ | F | array<string,int> $order | Reihenfolge der Einstellungs-Tabs (section id => priority). |
tiered_pricing_table/ | F | bool $premium | Ob der Layout-Customizer die Website als Premium behandelt (schaltet die Premium-Steuerelemente frei). |
tiered_pricing_table/ | F | ?string $color | Die 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/ | F | array<string,string[]> $styles | Für das Produktraster ausgeblendete Designstile (layout => styles; Standard ['blocks' => ['style-8']]). |
tiered_pricing_table/ | F | array $rows | Zeilen der Integrationsschalter. |
tiered_pricing_table/ | F | array<string,array> $categories | Integrationsgruppen (id => ['title','description']). |
tiered_pricing_table/ | A | — | Nach den Eingabefeldern für die Spaltentitel. |
tiered_pricing_table/ | A | — | 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.