2A-FFL Woocommerce Plugin Documentation

2A-FFL WooCommerce Plugin Documentation

Overview

The 2A-FFL WooCommerce Plugin enables your WooCommerce store to sell firearm-related products while ensuring compliance with regulations. The plugin enhances the checkout process by allowing customers to search for and select a nearby Federal Firearms License (FFL) dealer, where they can receive their purchased items.

To access the FFL API, you need a monthly subscription and an API key. You can subscribe and obtain your key here: FFL API Subscription.

Installation & Configuration Guide

Step 1: Install the Plugin

1. Navigate to WordPress Admin Panel → Plugins → Add New.
2. Click Upload Plugin and select the plugin .zip file.
3. Click Install Now, then Activate the plugin after installation.
4. Once activated, the plugin will appear in the Plugin List and on the Admin Sidebar.

Step 2: Enter API Key & Activate

1. In the WordPress Admin Panel, go to 2A Data FFL
2. Enter your API key into the FFL API Key input.
3. Click Activate/Validate API Key.
4. The plugin will validate the key and enable its features automatically.
5. Click Save Changes

Step 3: Configure Checkout FFL Selection

1. Google Maps API Key
   Enter your Google Maps API key in the provided field. This is required to display the map on the checkout page, allowing users to select the nearest FFL.

2. Firearm Warning Message
   Add a custom warning message to inform users about regulations or any important information regarding firearm purchases. This message will appear during checkout.

3. Checkout Colors
   Choose the colors that will be used for the plugin’s elements on the checkout page to match your store’s design.

4. Checkout Block Position
   Select where on the checkout page you want the FFL selection block to appear. Options allow you to position it in a preferred section of the page or use the [atf_ffl_map] shortcode.

Step 4: Marking Products as ATF-Controlled Items

1. In the WordPress Admin Panel, navigate to Products → All Products and locate the product you want to mark as an ATF-controlled item.

2. Scroll down to the Product Data section and click on the General tab.

3. Check the box labeled This is an ATF-controlled item and click Save Changes to apply the update.

4. You need to do this for each product that is an ATF-controlled item

Your WooCommerce store is now ready to sell firearm-related products while ensuring compliance with FFL transfer requirements.