WordPress.org

한국어

워드프레스 받기
WordPress.org

Plugin Directory

Vietnam Store Toolkit for WooCommerce

Vietnam Store Toolkit for WooCommerce

작성자: YoOhw Studio
다운로드

설명

Vietnam Store Toolkit for WooCommerce adds essential tools for stores in Vietnam: province/city and ward/commune addresses, VietQR, VAT invoices, phone numbers, shipping fees, tracking numbers, and order tracking.

Learn more about the plugin on the official Vietnam Store Toolkit website.

Official Links

Key Features

  • Two-tier addresses covering 34 provinces/cities and 3,321 wards/communes/special zones.
  • Province/city-dependent ward/commune lists in Classic Checkout, Cart, and Checkout Blocks.
  • VAT invoice requests and a provider-neutral electronic invoicing workflow.
  • VietQR for WooCommerce Direct bank transfer.
  • Vietnamese phone number normalization and validation.
  • Shipping fee rules based on address, cart, weight, shipping class, free shipping, and COD.
  • Tracking numbers, a manual timeline, and an order tracking page with no carrier API required.
  • HPOS-compatible order filters, bulk actions, and CSV exports.

What’s New in Version 1.1.2

Version 1.1.2 expands shipping update emails with essential shipment status and tracking details, fixes missing website names in subject lines, and adds an email for sending electronic invoices.

Vietnamese Addresses and Checkout Blocks

The plugin stores province/city codes in WooCommerce’s state field and ward/commune codes in its city field, and hides the postcode when appropriate. Address combinations are validated before they are saved, and ward/commune lists are loaded only when needed.

The fields are applied to checkout, My Account, the cart, store addresses, customer profiles, and orders in wp-admin. In Cart and Checkout Blocks, Ward/Commune is a Province/City-dependent list that synchronizes directly with the Store API, including on custom block pages.

VAT Invoices and VietQR

The invoice request feature is enabled independently under Vietnam store > Core features and does not depend on WooCommerce tax calculation. Classic Checkout and Checkout Blocks can collect the company name, tax identification number, invoice email address, and company address.

The electronic invoicing workflow stores the status, number/series, issue date, lookup URL, provider, PDF/XML files, and change log. The plugin does not issue invoices itself or call a provider API.

VietQR is added to WooCommerce Direct bank transfer (bacs) and does not create a new payment gateway. The QR image and transfer details can appear on the order confirmation page, in My Account, in emails, and in wp-admin. The plugin does not confirm transactions or automatically mark orders as paid.

Shipping Fees and Order Tracking

The “Shipping Fee Rules” method works within WooCommerce Shipping Zones. Rules are evaluated from top to bottom and can be based on province/city, ward/commune, cart total, weight, shipping class, fee, free-shipping threshold, and COD. The editor supports sorting and UTF-8 CSV import/export.

The Shipping panel lets you enter a carrier, tracking number, and tracking URL; send an email; and maintain a manual timeline. URL templates generate links from {tracking_code}, and administrators can also define custom carriers.

Add the “Order Tracking” block or [yoohw_order_tracking] shortcode to let customers look up orders using the order number together with their billing email address or phone number. Results do not display addresses, products, totals, or contact details.

Order Management and HPOS

The WooCommerce > Orders screen includes a compact Information column for invoice and tracking details, advanced filters, actions to resend tracking emails and update carriers, CSV exports, and handoff progress controls. The plugin uses the WooCommerce order API and supports both HPOS and legacy storage.

Migration and Data

WooCommerce Status Tools can scan, back up, and batch-synchronize legacy addresses and GHTK data from Le Van Toan’s plugin. Run the scan tool and review its report before synchronizing.

The 2026-07 administrative dataset is based on the National Statistics Office of Viet Nam through Vietnam Provinces API v2. The bank and BIN lists are based on the VietQR bank list API. Sources and update procedures are documented in data/SOURCES.md.

External Services and Privacy

Source APIs are used only to build static data; the plugin does not call them at runtime. When VietQR is enabled, the browser or email client loads the QR image from VietQR.io by CASSO. The image URL may contain the BIN, account number, QR template, amount, transfer description, and account holder name.

  • Service: https://vietqr.io/
  • Documentation: https://vietqr.io/danh-sach-api/link-tao-ma-nhan/
  • Terms: https://casso.vn/thoa-thuan-su-dung-phan-mem/
  • Privacy: https://casso.vn/chinh-sach-bao-mat-thong-tin/

Address, phone, invoice, and shipping data is stored in the store’s WordPress/WooCommerce installation. The plugin does not add analytics, advertising, or remote data collection services.

블록

이 플러그인은 1개의 블록을 제공합니다.

  • Vietnam Order Tracking Order lookup by order number and customer email or phone number.

설치

  1. Install and activate WooCommerce.
  2. Install and activate Vietnam Store Toolkit for WooCommerce.
  3. Review your selling locations and store address in WooCommerce settings.
  4. Configure Direct bank transfer if you need VietQR.
  5. If you need invoices, enable “Accept invoice requests at checkout” under Vietnam store > Core features.
  6. If you need address-based fees, add “Shipping Fee Rules” to a Shipping Zone.
  7. If you are migrating from Le Van Toan’s plugin, run the scan tool before synchronizing.

FAQ

Does the plugin support Cart and Checkout Blocks?

Yes. The plugin supports Province/City and Ward/Commune fields, VAT invoices, phone number validation, VietQR, and shipping information. WooCommerce 8.9 or later is required.

How does the plugin store Vietnamese addresses?

Province/city codes are stored in WooCommerce’s state field; ward/commune/special-zone codes are stored in its city field.

Can customers request VAT invoices?

Yes, when “Accept invoice requests at checkout” is enabled under Vietnam store > Core features.

Does VietQR automatically confirm payments?

No. VietQR is added to Direct bank transfer but does not connect to bank transactions.

Where do I configure shipping fees at the ward/commune level?

Go to WooCommerce > Settings > Shipping, open a zone, and add “Shipping Fee Rules.”

How do I create an order tracking page?

Add the “Order Tracking” block or [yoohw_order_tracking] shortcode to a page.

Does the plugin include carrier API integrations?

No. The public release provides API-free tracking and a framework for custom connectors.

Does the plugin support HPOS and Vietnamese?

Yes. The plugin is HPOS-compatible and includes Vietnamese translations for the interface, emails, and validation messages.

후기

이 플러그인에 대한 평가가 없습니다.

기여자 & 개발자

“Vietnam Store Toolkit for WooCommerce”(은)는 오픈 소스 소프트웨어입니다. 다음의 사람들이 이 플러그인에 기여하였습니다.

기여자

“Vietnam Store Toolkit for WooCommerce”(이)가 1 개 언어로 번역되었습니다. 기여해 주셔서 번역자님께 감사드립니다.

자국어로 “Vietnam Store Toolkit for WooCommerce”(을)를 번역하세요.

개발에 관심이 있으십니까?

코드 탐색하기는, SVN 저장소를 확인하시거나, 개발 기록을 RSS로 구독하세요.

변경이력

1.1.2 (July 30, 2026)

  • New: Added the Plugin URI and clickable links to the official Website, Documentation, Support, and key topic pages so the product source can be verified.
  • New: Added a WooCommerce email for the electronic invoicing workflow, with HTML and plain-text templates, customization in email settings, manual sending from the order metabox, and attachments for available PDF/XML files.
  • New: Automatically changed the invoice status to Sent to customer after an email was sent successfully, while storing the status and send time and displaying a result notice.
  • Update: Added shipment status, service, COD amount, and update time to emails triggered by an internal shipping connector; internal shop-account rate details are not displayed.
  • Update: Used the dedicated subject Shipping update: {shipment_status} - Order #{order_number} for emails triggered by an internal connector.
  • Update: Hid the VAT information row in the order list’s Information column when invoice requests at checkout are disabled, while retaining filters and historical invoice data exports.
  • Update: Displayed the manual Shipment Journey form in the order metabox only after a manual shipment with a tracking number has been created.
  • Improve: Collapsed the manual tracking update form after a tracking number has been created; administrators can reopen it from the “Update tracking number” row, whose color follows each user’s admin color scheme.
  • Improve: Fixed the shipping and electronic invoice email placeholder lifecycle: restored {site_title}, {site_address}, {site_url}, and {store_email} on every send; refreshed order/shipment/invoice placeholders; and ensured they work correctly in subjects, headings, and additional content across repeated sends.
  • Improve: Fixed the enabled shipping service count on the Vietnam store page by directly counting registered, available providers.
  • Improve: Completed the Vietnamese translation for the electronic invoice email feature.

See changelog.txt for the complete change history.

기초

평점

아직 제출된 리뷰가 없습니다.

Your review

모든 리뷰 보기

지원

할 말 있으신가요? 도움이 필요하신가요?

지원 포럼 보기