FFL Connect for WooCommerce
| 开发者 | jeffvato |
|---|---|
| 更新时间 | 2026年11月9日 05:39 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Selling firearms online means every order has to ship to a Federal Firearms Licensee (FFL), not to the customer. FFL Connect adds that step to your WooCommerce checkout.
When a cart contains a product that needs an FFL transfer, the customer searches by ZIP code, sees nearby licensed dealers in a list and on a map, and picks one. The chosen dealer becomes the order's shipping address and the dealer's FFL number is saved on the order, so you do not have to chase customers for dealer details after they pay.
What it does
- Adds an FFL dealer picker (ZIP code search, results list and interactive map) to the checkout.
- Appears only when the cart contains a product that needs an FFL transfer.
- Lets you mark products one by one ("Requires FFL transfer") or by whole product category.
- Sets the order's shipping address to the chosen dealer.
- Shows the dealer's FFL number on the order screen and in order emails.
- Re-checks the chosen dealer on your server before the order is accepted. If the check cannot be completed, the order is not placed.
- Works with WooCommerce High-Performance Order Storage.
- WooCommerce, using the classic checkout (the
[woocommerce_checkout]shortcode). The dealer picker does not appear on the block-based checkout. - An FFL Connect API key. The plugin is free; the dealer database it searches is a paid service.
- Go to fflconnect.net/pricing and buy an annual licence for your store. You can pay by credit card or Google Pay.
- Your API key and the plugin download link are emailed to you as soon as the payment goes through. The key is also shown on your order page.
- Paste the key into WooCommerce > FFL Connect on your site and press Test connection.
安装:
- Install and activate the plugin. WooCommerce must be active.
- Get an API key at fflconnect.net/pricing (see "How to get an API key" above). It is emailed to you right after purchase.
- Go to WooCommerce > FFL Connect and enter your API key. Press Save Changes, then Test connection.
- Tell the plugin which products need an FFL transfer: tick product categories on the same settings page, or tick Requires FFL transfer on individual products (Product data > General).
- Make sure your checkout page uses the
[woocommerce_checkout]shortcode. - Add an FFL product to your cart and open the checkout to see the dealer picker.
屏幕截图:
常见问题:
Is the plugin free?
The plugin is free and open source. It needs an API key for the FFL Connect dealer database, which is a paid annual service.
Does it work with the block checkout?
No. The dealer picker is added to the classic checkout only. If your checkout page uses the Checkout block, replace it with the [woocommerce_checkout] shortcode.
What happens if a customer does not choose a dealer?
The order is not accepted. They see a message asking them to search for and select a dealer.
What happens if the dealer service cannot be reached?
Customers see a message that the search is unavailable, and orders containing FFL items are not accepted until it is back. Orders without FFL items are not affected.
Can a customer type in a dealer that is not in the results?
No. Only dealers returned by the search can be selected, and the selection is confirmed again on your server.
Where do I see the chosen dealer?
On the order screen, under the shipping address, and in order emails. The dealer's name and address are also the order's shipping address.
Does it support product variations?
Yes. If the product, the selected variation, or one of the product's categories is marked as needing an FFL, the picker appears.
更新日志:
1.1.2
- Renamed internal function, class, constant, hook and option names from the ffl_connect_ / FFL_Connect_ prefix to fflconnect_ / FFLConnect_. WordPress.org review flagged both ffl and ffl_connect as too short and too generic to be a unique plugin prefix. Existing saved API keys are migrated automatically.
- Renamed internal option, AJAX and script-data names from the gemini_ffl_ prefix to ffl_connect_, to avoid name collisions flagged in review. Existing saved API keys are migrated automatically on upgrade.
- First release on WordPress.org.
- New settings page under WooCommerce > FFL Connect with a connection test.
- Mark whole product categories as needing an FFL transfer, in addition to individual products.
- Dealer results are listed alphabetically.
- The picker now inherits your theme's colours and works on dark themes.
- The map library is bundled with the plugin.
- Order data is stored through WooCommerce's order API (High-Performance Order Storage compatible).
- The dealer's FFL number is included in order emails.