ELEMENTARNO Ukraine for WooCommerce
| 开发者 | voltraider |
|---|---|
| 更新时间 | 2026年11月3日 00:21 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv3 or later |
| 版权网址: | 版权信息 |
详情介绍:
A Ukrainian online store on WooCommerce usually needs several separate plugins: one for card payments, one for Nova Poshta, one for receipts, one for notifications. ELEMENTARNO Ukraine for WooCommerce puts all of that in one place, with one settings page and the same logic everywhere.
Every service is a separate module. Turn on only what you actually use. A module that is off loads no code and does not slow your site down.
Payments
- Take cards, Apple Pay and Google Pay through WayForPay, LiqPay or plata by mono. The customer pays on the bank's secure page and comes back to your store.
- Refund a whole order or part of it and check a payment's status right from the order, without opening the bank's dashboard.
- Works with both the classic and the block checkout, with the official provider logos next to each payment method.
- Nova Poshta: the customer picks a city and a branch or parcel locker with suggestions as they type. The directory is kept on your site, so checkout stays fast even when the Nova Poshta API is slow.
- Ukrposhta: the customer gives the region, the city and the postcode of their post office instead of a street address; your own delivery price for every shipping zone.
- Checkbox: a fiscal receipt (ПРРО) is created on its own as soon as an order is paid, or with one click from the order.
- Telegram: you and your team see new orders and payments in a chat right away, and get a reminder about online orders left unpaid. Add your own order fields (chopsticks, delivery time, anything your checkout collects) and a button that opens the order.
- TurboSMS: customers get an SMS or a Viber message when their order status changes.
- The small changes Ukrainian stores usually paste into functions.php, as switches: "300 грн" instead of "₴300.00", whole prices without ".00", no "(optional)" next to fields, no "Ship to a different address?", coupons called "Промокод", and a +380 phone mask. More to come.
- Card details never pass through your site, and every payment notification is checked against the bank's signature.
- The checkout page makes no outside requests; notifications and receipts are sent in the background and never keep the customer waiting.
- Written from scratch from the services' official documentation, with no third-party libraries. HPOS is supported.
安装:
- Install and activate the plugin. WooCommerce must be active.
- Open WooCommerce → ELEMENTARNO and enable the modules you need.
- Enter the credentials: payments under WooCommerce → Settings → Payments, Nova Poshta under Shipping, Checkbox, Telegram and TurboSMS under Integration.
- For Nova Poshta, press "Refresh directory now" once and add the "Nova Poshta (ELEMENTARNO)" method to your shipping zone.
屏幕截图:
常见问题:
Does the plugin store card data?
No. Customers enter their card on the bank's secure page; your site only learns whether the payment went through.
Which currencies are supported?
UAH, USD and EUR. If your bank contract allows another currency, it can be added with the elementarno_supported_currencies filter.
How do I test LiqPay?
Enter the sandbox_ keys from your LiqPay dashboard. The plugin notices them and switches to test mode by itself.
Is the money returned when I cancel a paid order?
Only if you turn on "Refund on cancel" in the payment method settings. Without it, cancelling changes the status only, as everywhere in WooCommerce: refund the payment with the "Refund" button in the order and choose "Refund via …", not "Refund manually".
I got a "New order" e-mail or message, but the order is not paid
With this plugin's payment methods, an order paid by card is announced only after the bank confirms the payment; while the customer is still paying, the order stays "Pending payment". Since version 2.7.0 this also holds for the first seconds of a payment, which earlier put the order on hold. In the Telegram settings you can choose to get the message right after checkout instead, with the payment status in it, and a reminder about orders that stay unpaid.
The order stays "pending payment" after a successful payment
The bank could not reach your site to report the payment. Open the order and use "Check payment status", and the status will update. If it keeps happening, make sure your hosting or security plugin does not block outside requests.
The Nova Poshta picker does not show on my checkout
It appears right after the contact fields and works with the standard checkout and with most theme checkout builders. If your checkout layout has no contact fields, add the [elementarno_np_picker] shortcode where you want the picker.
Where do I find the Checkbox credentials?
In your Checkbox account: the cash register's license key and the cashier's PIN code. Your account e-mail and password are not needed.
Notifications or receipts arrive with a delay
Your hosting is most likely holding back WP-Cron. Ask your host, or switch to a real cron yourself: set DISABLE_WP_CRON to true in wp-config.php and run wp-cron.php every minute from your hosting panel.
Where do the payment logos come from?
Bank and payment service logos are their official brand files; Visa, Mastercard, Apple Pay and Google Pay logos come from WooCommerce itself. All logos belong to their owners and are only used to show the payment method. The plugin is not affiliated with any of these companies.
更新日志:
2.8.0
- Ukrposhta: the checkout now asks for what a Ukrposhta parcel needs, the region, the city and the five-digit postcode of the post office, with a link to the Ukrposhta postcode directory; the street-address fields are hidden, as with Nova Poshta. The post office is shown on the thank-you page, in e-mails, in the admin order and in Telegram and SMS messages ({delivery_point}).
- Nova Poshta and Ukrposhta share one mechanism for hiding the address fields, so the two methods no longer compete when a customer switches between them. The Nova Poshta filter
elementarno_np_hidden_checkout_fieldskeeps working; the new name iselementarno_delivery_hidden_checkout_fields. - Telegram, TurboSMS: new placeholder {delivery_point} (Nova Poshta branch or Ukrposhta post office); the default Telegram template uses it.
- Payments: when the bank's notification and the customer's return arrive at the same moment, the order is re-read from the database before it is settled, so it can never be marked paid twice. A second successful payment for an already paid order (two tabs, two attempts) is reported in the order notes as a double charge to refund, and a refund of that second attempt no longer marks the order as refunded.
- Payments: a cancelled order that had been paid is not revived by a repeated "success" from the provider. A refund reported without an amount leaves the order status alone and asks you to check, instead of marking the whole order refunded.
- plata by mono, LiqPay: a customer who comes back from the payment page without paying is sent to the payment page with a message, not to the "thank you" page.
- LiqPay: "payment not found" from the status check no longer turns the order into "failed"; a sandbox payment arriving while the store uses live keys is put on hold instead of counted as paid.
- Checkbox: a failed second sign-in no longer causes a fatal error; "create fiscal receipt" by hand after a timeout re-uses the same receipt id, so no second receipt reaches the tax office; receipts are refused for orders in a currency other than UAH; validation errors are shown in full.
- Nova Poshta: the posted shipping method is used during checkout validation, so switching to Nova Poshta right before "Place order" does not skip the branch check; only WooCommerce's own address fields are made optional, not your theme's required fields; cities with the same name show their region; a truncated list of cities or a failed database write stops the sync instead of deleting data; the branch search works even after the checkout page has been open for a long time.
- Settings: a "Remove the saved key" checkbox next to every saved credential.
- Telegram: very long messages are cut at a line break with their formatting closed, so they arrive; placeholder text typed by the customer is printed as text; a message that timed out is not sent again without its button; Telegram and TurboSMS retry on HTTP 429 and 5xx.
- plata by mono: an order with two or more of the same product could not be paid. monobank expects the price of one unit in each basket line and the plugin sent the line total, so monobank refused the invoice ("INVALID_MERCHANT_PAYM_INFO") and the customer never reached the payment page. The basket now carries unit prices and always adds up to the amount; discounts, paid delivery and fees are included.
- Nova Poshta: the directory sync pauses between pages and, when Nova Poshta refuses a page ("too many requests") or does not answer, waits and tries the same page again. A sync that stopped anyway continues from the page where it stopped instead of downloading everything again; "Start over" is still there.
- Card payments: while the customer is still paying (invoice created, 3-D Secure, processing), the order stays "Pending payment". Before, it was put on hold, and WooCommerce sent the "New order" and "Order on hold" e-mails before the payment went through.
- Telegram: choose when orders paid online are announced: only after a successful payment, or right after checkout with the payment status in the message. When the money arrives, the message is updated and a short "Order … is paid" reply follows.
- Telegram: a reminder about online orders still not paid after 15, 30 or 60 minutes, with the customer's name and phone.
- Telegram: an order paid later no longer gets a second full message, and its message stays up to date when the status changes. New placeholder {payment_status}.
- New option for WayForPay, LiqPay and plata by mono: "Refund on cancel". When a paid order is cancelled, the unrefunded amount is returned to the customer automatically, with the result in the order notes. Off by default.
- Security: payment references now carry a random part, and a plata by mono notification is accepted only for an invoice this store created.
- Security: in WayForPay test mode the payment method is shown only to shop managers, and sandbox notifications can no longer touch live orders.
- Checkbox: a receipt can no longer be issued twice when the request times out; the receipt id is chosen before the request and reused on retry.
- Payments: a late "pending" or "failed" notification no longer reopens a cancelled or refunded order, a reversal is recorded only for money that was actually taken, and a notification and the customer's return are processed one at a time.
- Nova Poshta: the branch picker now searches as you type, by number, street or "поштомат", so every branch and parcel locker in Kyiv, Lviv or Odesa can be found.
- Nova Poshta: a directory refresh that brings back far fewer branches than before keeps the old directory instead of deleting it.
- Telegram, TurboSMS and Checkbox retry automatically when the service is unreachable.
- Credentials with special characters are saved as typed, and more fields are hidden in debug logs.
- Telegram: a fuller default message, like the WooCommerce order e-mail: the customer's name, phone and e-mail, items with SKU, totals with delivery, discounts and fees (gift wrapping and the like), the branch or address and the customer's comment.
- Telegram: new placeholders {totals}, {fees}, {address}, {date} and {site}.
- Telegram: a "Use the default template" button for stores that saved their template earlier, and the test button now sends your latest order exactly as it will look.
- Telegram: "new order" now arrives when the order is really placed, at the same moment as the WooCommerce "New order" e-mail: right after checkout for cash on delivery or bank transfer, after a successful payment for card payments. Failed or repeated online payment attempts no longer send extra messages.
- Telegram: optional "waiting for online payment" message for orders not paid within a minute. When the customer pays, the same message turns into the new order.
- Telegram: one message per order. If an event repeats for the same order, the first message is updated instead of a new one being sent.
- Telegram: add any order field to the message. The settings page finds the fields your recent orders carry (chopsticks, delivery time, gift note…) and adds them with one click; {meta:key} prints any single field.
- Telegram: an "Open order" button under each message and an {order_url} placeholder.
- Telegram: product options such as size or add-ons are shown next to each item; new {note} placeholder for the customer's comment; lines with nothing to show are left out.
- The Settings link of a module you just switched on appears right after saving, without reloading the page.
- Nothing is switched on after activation any more; pick the modules you need on WooCommerce → ELEMENTARNO.
- New "Store tweaks" module: common functions.php snippets as switches. "300 грн" instead of "₴300.00", whole prices without ".00", hidden "(optional)" labels, billing address only, coupons renamed to "Промокод", +380 phone mask with validation.
- Clearer plugin description.
- The modules screen links to the WordPress.org support forum.
- First public release on WordPress.org.