Description
NAFS Connector connects an administrator-authorized WooCommerce store to the NAFS commerce service. A NAFS account is required. The hosted service is currently free; future paid plans require a separate agreement. The connector source is available under the MIT license.
- Pair one store with its NAFS organization and sales channel.
- Check connector health and revoke the exact managed WooCommerce API key.
- Synchronize optional Bangladesh delivery-location selectors for classic checkout.
- Attach consent-based campaign attribution to orders.
- Support WooCommerce HPOS and Cart and Checkout Blocks. Blocks uses optional text fields, not cascading location selectors.
NAFS location fields are optional. Missing or invalid supplemental locations do not block checkout or overwrite native WooCommerce addresses. WooCommerce’s normal payment, address and shipping validation still applies. The optional NAFS Bangladesh Delivery shipping method requires a successful NAFS quote; keep an appropriate WooCommerce shipping method configured.
External services
This plugin requires the NAFS service at https://app.nafs.tech/. The store administrator explicitly authorizes WooCommerce access and confirms the exact NAFS API origin during pairing. The hosted API origin is https://api.nafs.tech/; an independently operated NAFS deployment uses the HTTPS origin shown in its pairing confirmation. Do not approve an origin you do not trust.
The plugin sends the following after the relevant administrator action:
- Pairing: a one-time ticket, store URL and connector version to bind the store to the selected NAFS organization and connection.
- Health: signed connector version, event ID and timestamp in periodic heartbeats while paired.
- Delivery locations: organization and connection IDs and catalog synchronization requests after pairing, upgrade, or an administrator-requested resync. Location labels and provider IDs are stored locally.
- Delivery quotes: destination location identifiers and order/cart information needed to calculate shipping when the NAFS Bangladesh Delivery method is selected.
The separately authorized NAFS channel reads store catalog and order information through WooCommerce’s authenticated API and receives native WooCommerce webhooks. Order snapshots can include customer contact details, billing/shipping addresses and order contents. NAFS uses Nango as its server-side credential broker; this plugin does not contact Nango or retain the WooCommerce consumer key or secret.
With explicit analytics consent through WP Consent API, the plugin stores supported campaign parameters, click IDs, timestamps and the landing-page path in a first-party cookie for up to 30 days and attaches attribution to checkout orders. It does not send browser tracking requests to NAFS. Attribution reaches NAFS with the authorized order synchronization. Missing consent disables attribution; withdrawal clears browser evidence. Already placed orders retain their recorded metadata.
Privacy policy: https://app.nafs.tech/privacy-policy
Terms of service: https://app.nafs.tech/terms-of-service
Installation
- Install and activate WooCommerce.
- Install and activate NAFS Connector for WooCommerce.
- In NAFS, open Sales channels, connect your store and approve WooCommerce access as a store administrator.
- Run the connection check, then choose Pair connector.
- Review and confirm the NAFS API origin in WordPress to finish pairing.
- For optional Bangladesh selectors, configure courier locations in NAFS and resync Delivery locations for this sales channel.
- For optional attribution, install WP Consent API and a compatible consent banner that records an explicit analytics choice.
FAQ
-
Does installation automatically connect my store?
-
No. Administrator authorization and explicit connector pairing are required before service requests begin.
-
Do I need to uninstall before an upgrade?
-
No. Update the existing plugin. Normal updates preserve pairing, location catalogs and orders. Deleting the plugin removes its pairing and local location catalog; it does not delete WooCommerce orders or revoke remote NAFS access. Revoke the channel in NAFS when removing that access.
-
Where do updates come from?
-
This directory distribution uses WordPress.org updates. It contains no private update client. Stores using a previous private distribution need the documented migration release or a manual replacement after directory approval.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“NAFS Connector for WooCommerce” is open source software. The following people have contributed to this plugin.
Contributors
Translate “NAFS Connector for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.4.3
- Deliver paired NAFS webhooks directly without waiting for cron.
- Automatically provision and repair hooks on pairing; verify signed callback delivery.
- Surface delivery failures and retry failed notifications.
0.4.2
- Prepare the WordPress.org distribution with native directory updates and service disclosures.
- Preserve optional classic and Blocks checkout metadata, local delivery catalogs and managed connection lifecycle support.