PAY by square pre WooCommerce
| 开发者 |
webikon
kravco johnnypea martinkrcho savione |
|---|---|
| 更新时间 | 2026年9月4日 11:59 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- PAY by square — slovenský štandard
- QR platba — český štandard
- Automatický výber — podľa meny objednávky (EUR = slovenský, CZK = český)
- Na ďakovnej stránke po odoslaní objednávky
- V emaile s potvrdením objednávky
安装:
- Pripravte si Váš eshop na platforme WooCommerce.
- Zaregistrujte sa na stránke app.bysquare.com.
- Nainštalujte a aktivujte si plugin Pay by Square (Pluginy > Pridať nový > Nahrať plugin).
- Nastavte si parametre platby na účet (WooCommerce > Platby > Priamy prevod na bankový účet): a) Povoľte priamy prevod na bankový účet a prejdite do nastavení (Spravovať). b) Vložte údaje minimálne jedného bankového účtu — údaje IBAN a BIC sú povinné.
- Nastavte si parametre generovania QR kódu (WooCommerce > Nastavenia > Integrácia > PAY by square): a) Príjemca platby — meno osoby alebo organizácie prijímajúcej peniaze. b) Používateľské meno a heslo — údaje, pod ktorými sa prihlasujete na app.bysquare.com (používateľské meno je v tvare emailu). c) Ostatné položky v nastaveniach môžete upraviť podľa Vašich preferencií.
- Vykonajte testovaciu objednávku a skontrolujte si zobrazenie QR kódu po odoslaní objednávky a v emaile.
屏幕截图:
常见问题:
QR kód sa mi na ďakovnej stránke / v emaile nezobrazuje
Skontrolujte si:
- Správnosť prihlasovacích údajov (používateľské meno a heslo na app.bysquare.com).
- Údaje bankového účtu — IBAN aj BIC musia byť vyplnené.
- Počet zostávajúcich generovaní QR kódov v administrácii služby app.bysquare.com.
- V nastaveniach pluginu musí byť vyplnené pole „Príjemca platby".
Plugin nefunguje s mojím SMTP pluginom
Plugin používa na vloženie QR kódu do emailu knižnicu PHPMailer. Ak využívate SMTP plugin, overte si, že používa PHPMailer. Podporovaný je napríklad plugin WP Mail SMTP.
Podporuje plugin blokový checkout?
Áno, QR kód sa zobrazí na ďakovnej stránke aj pri použití blokového checkoutu (WooCommerce 8.9+). Bloková šablóna „Potvrdenie objednávky" musí obsahovať blok „Doplňujúce informácie" – práve v ňom WooCommerce zobrazuje doplnky platobných metód. Ak ste šablónu upravovali vo Vzhľad → Editor → Šablóny a tento blok odstránili, QR kód sa na ďakovnej stránke nezobrazí.
Ako zobrazím QR kód na vlastnom mieste?
Plugin poskytuje verejné metódy, ktoré vrátia adresu alebo cestu k obrázku QR kódu pre danú objednávku. Obrázok sa vygeneruje pri prvom volaní a ďalej sa berie z cache, takže opakované volania pre tú istú objednávku nespotrebúvajú ďalší kredit na app.bysquare.com; každá nová objednávka (alebo zmena sumy) spotrebuje jedno vygenerovanie.
Metódy nekontrolujú spôsob platby ani stav objednávky – QR kód vrátia pre akúkoľvek objednávku. O tom, kedy sa má zobraziť, rozhoduje váš kód:
if ( class_exists( '\Webikon\Woocommerce_Plugin\WC_BACS_Paybysquare\Plugin' ) ) { $order = wc_get_order( $order_id ); if ( $order && 'bacs' === $order->get_payment_method() ) { $plugin = \Webikon\Woocommerce_Plugin\WC_BACS_Paybysquare\Plugin::get_instance(); $url = $plugin->get_qrcode_url( $order ); // adresa obrázka; '' ak QR kód nie je k dispozícii $path = $plugin->get_qrcode_path( $order ); // cesta k súboru, napr. na vloženie do PDF faktúry } }
Obe metódy prijímajú objekt WC_Order alebo ID objednávky. Hotový HTML blok s obrázkom vykreslí metóda thankyou_page_qrcode( $order ) s rovnakým parametrom. Údaje v QR kóde upravíte filtrami pay_by_square_qr_variable_symbol (variabilný symbol) a pay_by_square_qrdata (všetky polia).
更新日志:
- Pripravené pre WordPress 7.1 + WooCommerce 11.1.
- Pridané filtre
pay_by_square_qr_variable_symbolapay_by_square_qrdatana úpravu variabilného symbolu a ďalších údajov v QR kóde. - QR kód sa dá zobraziť aj na vlastnom mieste – vo faktúre, v detaile objednávky či na vlastnej ďakovnej stránke (postup vo FAQ).
- Deklarovaná kompatibilita s blokovým košíkom a pokladňou WooCommerce.
- Opravené: upozornenie o presunutých nastaveniach sa zobrazí len v sekcii Bankový prevod.
- Opravené: poškodený alebo prázdny QR obrázok v cache sa vygeneruje nanovo.
- Opravené: QR obrázok sa už neprikladá k ďalším emailom odoslaným v tej istej požiadavke.
- Opravené: chybná odpoveď služby app.bysquare.com sa zapíše do logu bez PHP varovaní.
- Neúplný bankový účet v nastaveniach Bankového prevodu sa pri tvorbe QR kódu preskočí.
- Pridaný Live Preview na stránke pluginu na WordPress.org (WordPress Playground blueprint)
- Pridané upozornenie v nastaveniach pluginu ak nie je vyplnené pole „Príjemca platby"
- Pridané upozornenie v zozname pluginov ak nie je vyplnené pole „Príjemca platby"
- Pridaná validácia formátu IBAN a BIC
- Aktualizované info o kompatibilite s WordPress 6.9.4 a WooCommerce 10.6
- Pridané logovanie presnej chyby v prípade, že nie je možné vytvoriť obrázok s QR kódom
- Opravené zobrazenie odkazu na nastavenia PAY by square v nastaveniach platieb
- Presunutie nastavení na samostatnú stránku (Integrácia > PAY by square) For older versions see changelog.txt.