Shortcodes

Plugin poskytuje shortcodes pro vlastní umístění různých prvků na webu.

Přehled shortcodes

Shortcode	Popis	Modul
[wpify_discounts_savings_summary]	Souhrn úspor	Discount Rules
[wpify_progress_upsell_bar]	Progress upsell bar	Upsell Bar
[wpify_discount_selection]	Výběr dárkových produktů	Discount Rules
[wpify_discount_info_block]	Info blok se slevovými informacemi	Discount Rules

---

Souhrn úspor

[wpify_discounts_savings_summary]

Zobrazí kompletní blok souhrnu úspor včetně názvů aplikovaných slev a celkové ušetřené částky.

Parametry

Shortcode nemá žádné parametry. Obsah se řídí nastavením v Obecné nastavení:

• Zobrazit názvy slev - zapne/vypne seznam názvů pravidel
• Zobrazit ušetřenou hodnotu - zapne/vypne celkovou částku

Příklad výstupu

<div class="wpify-woo-savings-summary">
    <div class="wpify-woo-savings-summary__labels">
        Aplikované slevy: Zimní výprodej, VIP sleva
    </div>
    <div class="wpify-woo-savings-summary__total">
        Ušetřili jste: 350 Kč
    </div>
</div>

Použití

// V šabloně
echo do_shortcode( '[wpify_discounts_savings_summary]' );

// V page builderu nebo widgetu
[wpify_discounts_savings_summary]

AJAX podpora

Shortcode automaticky podporuje AJAX aktualizace při změně košíku díky CSS třídě wpify-woo-savings-summary-fragment.

---

Progress Upsell Bar

[wpify_progress_upsell_bar]
[wpify_progress_upsell_bar id="0"]

Zobrazí progress bar(y) motivující zákazníky k vyššímu nákupu.

Parametry

Parametr	Typ	Výchozí	Popis
id	int	všechny	Index konkrétního baru (0 = první, 1 = druhý, atd.)

Příklady

// Zobrazit všechny nakonfigurované progress bary
[wpify_progress_upsell_bar]

// Zobrazit pouze první bar
[wpify_progress_upsell_bar id="0"]

// Zobrazit pouze druhý bar
[wpify_progress_upsell_bar id="1"]

Poznámky

• Indexy začínají od 0
• Pokud bar s daným indexem neexistuje, nic se nezobrazí
• Podmíněné zobrazení (datum, role) se respektuje i u shortcode

---

Výběr dárkových produktů

[wpify_discount_selection]
[wpify_discount_selection rule_id="123"]

Zobrazí blok pro výběr produktů z pravidel typu Free Gift nebo Buy X Get Y s módem Manual Select.

Parametry

Parametr	Typ	Výchozí	Popis
rule_id	int	všechna	ID konkrétního pravidla
position	string	custom	Pozice pro CSS třídu

Příklady

// Zobrazit výběr ze všech aktivních pravidel
[wpify_discount_selection]

// Zobrazit výběr pouze pro konkrétní pravidlo
[wpify_discount_selection rule_id="456"]

Kdy se zobrazí

Shortcode zobrazí obsah pouze pokud:

1. Existuje aktivní pravidlo typu Free Gift nebo BOGO s Manual Select módem
2. Jsou splněny všechny podmínky pravidla
3. Zákazník ještě nevybral produkt (nebo může vybrat více)

AJAX podpora

Výběrový blok se automaticky aktualizuje při změně košíku.

---

Info Block (slevové informace)

[wpify_discount_info_block]
[wpify_discount_info_block product_id="123"]

Zobrazí info blok se slevovými informacemi pro produkt. Tento shortcode umožňuje zobrazit slevové informace na libovolném místě webu, nejen na produktové stránce.

Parametry

Parametr	Typ	Výchozí	Popis
product_id	int	aktuální	ID produktu pro který se mají zobrazit slevy

Příklady

// Na produktové stránce (použije aktuální produkt)
[wpify_discount_info_block]

// Pro konkrétní produkt
[wpify_discount_info_block product_id="456"]

// V PHP šabloně
<?php echo do_shortcode( '[wpify_discount_info_block product_id="123"]' ); ?>

Kdy se zobrazí

Shortcode zobrazí obsah pouze pokud:

1. Existuje platný produkt (z parametru nebo aktuální produktová stránka)
2. Pro produkt existují aktivní slevová pravidla
3. Pravidla mají nastavenou zprávu pro zobrazení

Poznámky

• Bez parametru product_id funguje pouze na produktové stránce nebo v produktové smyčce
• S parametrem product_id funguje na libovolné stránce
• Pokud produkt nemá žádná aktivní slevová pravidla, shortcode nevykreslí nic

---

Kde použít shortcodes

Page buildery

Většina page builderů (Elementor, Divi, Beaver Builder, WPBakery) podporuje shortcodes přímo:

1. Přidejte blok “Shortcode” nebo “Text”
2. Vložte shortcode
3. Uložte stránku

Widgety

V klasických widgetech nebo block widgetech:

1. Přidejte widget “Text” nebo “Shortcode”
2. Vložte shortcode

Šablony tématu

V PHP šablonách použijte:

<?php echo do_shortcode( '[wpify_discounts_savings_summary]' ); ?>

Hooks

Pokud chcete shortcode zobrazit na konkrétním WooCommerce hooku:

add_action( 'woocommerce_before_cart', function() {
    echo do_shortcode( '[wpify_progress_upsell_bar id="0"]' );
} );

---

Často kladené otázky

Shortcode nezobrazuje nic

Zkontrolujte:

1. Je příslušný modul aktivován?
2. Jsou splněny podmínky pravidla?
3. Je v košíku nějaký produkt (pro savings summary)?
4. Existuje aktivní pravidlo s daným ID?

Mohu použít více shortcodes na jedné stránce?

Ano. Můžete použít libovolný počet shortcodes. Každý se vykreslí nezávisle.

Fungují shortcodes s cachováním?

Shortcodes generují dynamický obsah závislý na košíku. Pro správnou funkci:

• Vyloučte stránky s shortcodes z full-page cache
• Nebo použijte AJAX fragmenty (automaticky podporováno)