MakeMeHappy.sk
SK EN
Všetky snippety

Ako zobraziť vlastné upozornenie pri produkte na objednávku

Pri jednoduchom fyzickom produkte na objednávku môžete pridať krátku vetu, ktorá zákazníka vyzve overiť termín ešte pred nákupom. Nasledujúci mini-plugin ju doplní do klasického súhrnu produktu. Pôvodný text skladovej dostupnosti ponechá zobrazený.

Rozsah overenia: kód bol skontrolovaný proti zdroju WooCommerce 11.2.1, prešiel kontrolou syntaxe v PHP 8.4 a izolovanými kontrolami. Nebol prakticky otestovaný v bežiacom WordPresse, v téme ani v prehliadači. Pred použitím ho overte na testovacej kópii konkrétneho e-shopu.

Kedy sa upozornenie zobrazí

Iba na detaile jednoduchého, fyzického a nesťahovateľného produktu, ktorý WooCommerce považuje za kúpiteľný a skladovo dostupný na nákup a pri ktorom is_on_backorder(1) vráti kladný výsledok. Kontrolujeme teda dostupnosť jedného kusu. Povolené backorders pri zostávajúcej zásobe samy osebe upozornenie nezapnú.

Pri manuálne nastavenom stave onbackorder WooCommerce považuje produkt za tovar na objednávku aj bez evidencie počtu kusov. Preto kód nepridáva samostatnú podmienku backorders_allowed(), ktorá by takýto ručný stav mohla vylúčiť. Správanie vychádza z metód oficiálnej triedy WC_Product.

Celý kód vlastného pluginu

Súbor pomenujte mmh-backorder-notice.php. Predponu mmh_bo_notice_20261028_ ponechajte pri funkcii aj pri registrácii hooku. Rovnaký kód neinštalujte súčasne na viaceré miesta.

<?php
/**
 * Plugin Name: MMH – Upozornenie na tovar na objednávku
 * Description: Doplní upozornenie na detaile jednoduchého fyzického produktu na objednávku.
 * Version: 1.0.0
 * Requires PHP: 7.4
 * License: GPL-2.0-or-later
 */

defined( 'ABSPATH' ) || exit;

add_action( 'woocommerce_single_product_summary', 'mmh_bo_notice_20261028_render', 25 );

/**
 * Render a plain notice; leave purchasing and the original stock text unchanged.
 */
function mmh_bo_notice_20261028_render() {

	if ( ! class_exists( 'WC_Product' ) || ! function_exists( 'is_product' ) || ! is_product() || is_admin() ) {
		return;
	}

	global $product;

	if (
		! $product instanceof WC_Product
		|| ! $product->is_type( 'simple' )
		|| $product->is_virtual()
		|| $product->is_downloadable()
		|| ! $product->is_purchasable()
		|| ! $product->is_in_stock()
		|| ! $product->is_on_backorder( 1 )
	) {
		return;
	}

	echo '<p class="mmh-bo-notice-20261028">' . esc_html( 'Tovar je na objednávku. Pred nákupom si u nás overte dostupnosť a predpokladaný termín odoslania.' ) . '</p>';
}

Inštalácia cez vlastný malý plugin

  1. Na počítači vytvorte priečinok mmh-backorder-notice a doň uložte uvedený súbor mmh-backorder-notice.php v UTF-8. Súbor má začínať <?php, bez textu pred ním a bez koncovej značky PHP.
  2. Zabaľte celý priečinok do ZIP-u. Štruktúra má byť mmh-backorder-notice/mmh-backorder-notice.php; do ZIP-u nepridávajte testy ani výskumné podklady.
  3. Najprv na testovacom webe otvorte Pluginy → Pridať nový → Nahrať plugin, nahrajte ZIP a aktivujte MMH – Upozornenie na tovar na objednávku.
  4. Skontrolujte jednoduchý produkt na objednávku, produkt skladom a vypredaný produkt. Upozornenie očakávajte iba v prvom prípade. Overte aj produkt bez ceny a nesprávny typ produktu.
  5. Pozrite si detail ako neprihlásený návštevník na mobile aj počítači. Ak web používa cache, obnovte príslušnú produktovú stránku. Pri inej téme alebo po jej zmene vykonajte kontrolu znovu.

Upozornenie zámerne neobsahuje vymyslenú dodaciu lehotu. Vlastnú formuláciu môžete upraviť v jedinom texte vo volaní esc_html(). Zachovajte úvodzovky a používajte obyčajný text bez HTML. Escapovanie výstupu vysvetľuje referencia WordPressu k esc_html().

Obmedzenia, ktoré treba poznať

  • Variabilné, skupinové, externé a iné typy produktov sú vylúčené. Kód nereaguje na zmenu vybratej variácie. Pri skupinovom produkte sa poznámka môže zobraziť až po otvorení samostatného jednoduchého produktu.
  • Virtuálne a sťahovateľné produkty sú vylúčené, aj keď používajú typ simple. Rovnako sa nič nevypíše pri chýbajúcom produkte alebo produkte, ktorý WooCommerce nepovažuje za kúpiteľný.
  • Je určený pre klasickú PHP šablónu, ktorá volá woocommerce_single_product_summary. Priorita 25 je v štandardnej šablóne medzi krátkym popisom a formulárom nákupu. Téma môže poradie zmeniť. V blokovej šablóne Single Product ani v page builderi bez tohto hooku zobrazenie nezaručujeme; prázdny výsledok nie je dôvodom upravovať košík.
  • Nekontroluje aktuálne zvolené množstvo ani obsah košíka. Pri troch kusoch skladom a požiadavke na päť sa poznámka týmto kódom dynamicky neobjaví. Neslúži ako jediná informácia o dostupnosti; ponechajte vhodné štandardné upozornenia WooCommerce.
  • Nevypočítava dátum, nesynchronizuje dodávateľa a neukladá údaje. Neregistruje zmeny košíka, cien, objednávok ani platieb a neposiela e-maily. Pri vypnutom WooCommerce zostáva bez výstupu.
  • Text je pevne po slovensky. Mini-plugin nepridáva správu prekladov ani vlastné štýly. Prípadné viacjazyčné zobrazenie a čitateľnosť overte v nastavení svojho webu.

Použitý hook a štandardné poradie sú v oficiálnej šablóne produktu WooCommerce. Tento kód pridáva samostatný odsek, preto môže byť zobrazený spolu s pôvodným upozornením. Skontrolujte, aby sa oba texty významovo nerozchádzali.

Ako úpravu vypnúť

V zozname pluginov deaktivujte MMH – Upozornenie na tovar na objednávku a podľa potreby obnovte cache produktovej stránky. Dodatočný odsek sa prestane vytvárať; skladové nastavenia produktov sa tým nemenia. Ak by úprava vlastného textu spôsobila chybu a administrácia nešla otvoriť, cez správcu súborov hostingu alebo SFTP premenujte iba priečinok wp-content/plugins/mmh-backorder-notice. Súbory jadra WooCommerce ani tému netreba upravovať.

Ak potrebujete aj odhad termínu

Doplnková veta rieši iba vysvetlenie dostupnosti. Pre dátumy si pozrite dokumentáciu odhadovaného času doručenia a príslušný plugin. Ďalšie malé úpravy nájdete v sekcii Snippety.