HappyCoders Multiple Addresses for WooCommerce – User Guide

Thank you for choosing HappyCoders Multiple Addresses for WooCommerce! This guide will walk you through installing, configuring, and using the plugin to enhance your customers’ checkout experience.

---

1. Overview

HappyCoders Multiple Addresses allows your logged-in WooCommerce customers to save and manage multiple billing and shipping addresses. This creates a convenient “Address Book” in their “My Account” area, enabling them to quickly select from pre-saved addresses during checkout, rather than re-typing details for different orders.

This streamlines the checkout process, reduces errors, and is particularly useful for customers who ship to multiple locations (e.g., home, work, gifts) or use different billing details.

---

2. Key Features

1. Customer Address Book: A dedicated section within the WooCommerce “My Account” page.

2. Save Multiple Addresses: Customers can save numerous distinct billing and shipping addresses.

3. Address Nicknames: Users can assign custom labels (e.g., “Home Office,” “Mom’s House”) to their addresses for easy identification.

4. Set Default Addresses: Customers can designate one billing and one shipping address as their default, which will pre-fill the checkout form.

5. Easy Editing & Deletion: Intuitive interface for customers to manage their saved address entries.

6. Checkout Integration:

• Select saved addresses directly on the checkout page.
• Admin option to display selectors as a Dropdown or a Radio List.
• Admin option to show a formatted address block (hiding form fields) or keep fields editable when a saved address is chosen.
• Admin option to allow or disallow entering a brand new address directly at checkout.

1. 1. Address Limits: Admins can set the maximum number of billing and shipping addresses a user can save.
   2. Auto-Default for New Addresses: When a customer adds a new address, it automatically becomes their new default for that address type.
   3. Admin Management: Site administrators can view, edit, and delete addresses for any customer via the User Profile screen.
   4. Compatibility: Designed to work with both Classic WooCommerce Checkout (using the [woocommerce_checkout] shortcode) and the modern Block-Based Checkout.

---

3. Installation

Minimum Requirements:

• WordPress: 5.6 or higher
• WooCommerce: 6.0 or higher
• PHP: 7.4 or higher

Steps:

1. Download: If you have a .zip file for the plugin, download it.

2. WordPress Admin:

• Log in to your WordPress admin dashboard.
• Navigate to Plugins > Add New.
• Click the Upload Plugin button at the top of the page.
• Click Choose File, select the plugin .zip file you downloaded, and click Install Now.
• Once installed, click Activate Plugin.

1. (If installing from WordPress.org repository):

• Navigate to Plugins > Add New.
• Search for “HappyCoders Multiple Addresses”.
• Click Install Now and then Activate.

After Activation:

• The plugin will add its settings page under WooCommerce > Settings > Multiple Addresses.
• A new “Address Book” tab will be available in the “My Account” page for logged-in customers.
• Important: After activation, or if you change themes or WooCommerce settings, it’s a good practice to go to Settings > Permalinks in your WordPress admin and simply click Save Changes (you don’t need to change any permalink settings). This flushes WordPress’s rewrite rules and ensures your new “Address Book” page URL works correctly.

---

4. Plugin Settings

You can configure the plugin by navigating to WooCommerce > Settings and clicking on the “Multiple Addresses” tab (or the name you’ve given your settings tab).

• Address Selector Style:
  • Dropdown Select Box: Customers will see a dropdown menu above the billing/shipping forms at checkout to select a saved address.
  • List (Radio Buttons): Customers will see a list of radio buttons to select a saved address.
• Saved Address Display Format (Checkout):
  • Show Editable Form Fields: When a customer selects a saved address at checkout, the standard address form fields will be populated and remain visible and editable.
  • Show Formatted Address Block (Hide Fields): When a customer selects a saved address, the plugin will display a formatted block of that address, and the individual form fields will be hidden. This provides a cleaner look. The “Enter new address” option will still reveal the editable fields.
• Allow New Address Entry (Checkout):
  • Yes: Customers will see an “Enter a new address” option in the selector at checkout, allowing them to bypass their saved addresses and type a new one.
  • No: The “Enter a new address” option will be hidden. Customers can only choose from their saved addresses or use the default WooCommerce address fields if no saved addresses are selected.
• Max Billing Addresses:
  • Set the maximum total number of billing addresses a user can save in their address book.
  • Enter 0 or leave blank for unlimited.
• Max Shipping Addresses:
  • Set the maximum total number of shipping addresses a user can save in their address book.
  • Enter 0 or leave blank for unlimited.

Click Save changes after configuring your options.

---

5. How Customers Use the Address Book

Accessing the Address Book

Logged-in customers can access their Address Book by:

1. Navigating to their My Account page.
2. Clicking on the “Address Book” (or “HC Address Book” / similar, depending on your endpoint slug) tab in the account menu.

Adding a New Address

1. In the Address Book, customers will see an “Add New Address” form.
2. They select the Address Type: Billing, Shipping
3. They fill in the address details:

• • Address Nickname (Optional): A friendly name for the address (e.g., “Home,” “Work Office,” “Gift – Jane Doe”).
  • Standard address fields (First Name, Last Name, Company, Country, Address, City, State, Postcode, Phone, Email).

1. Click Save Address.

• • The newly added address will automatically be set as their default address for the selected type(s).
  • A success message will confirm the addition. They may be prompted if they’ve reached an address limit set by the admin.

Viewing Saved Addresses

• • Below the “Add New Address” form, customers will see separate sections for their “Saved Billing Addresses” and “Saved Shipping Addresses.”
  • Addresses are typically displayed as cards, often in a carousel if multiple exist.
  • The address marked as (Default) will be shown first.

Editing an Address

1. Find the address card they wish to modify in their Address Book.
2. Click the Edit button on that address card.
3. A modal window (or inline form) will appear, pre-filled with the address details.
4. Make the necessary changes.
5. Click Update Address.

Deleting an Address

1. Find the address card they wish to remove.
2. Click the Delete button on that address card.
3. A confirmation prompt will appear. Click “OK” to confirm.
   • If the deleted address was a default, the plugin will attempt to set another saved address (if available) as the new default.

Setting Default Addresses

1. Each address card (that is not already the default for its type) will have a Set as Default button.
2. Clicking this button will make that address the new default billing or shipping address.
3. The page will typically reload to reflect the change.
4. The default address is used to pre-fill the checkout forms.

Using Saved Addresses at Checkout

1. When a logged-in customer reaches the checkout page:

2. Above the standard Billing Address form, they will see a selector (dropdown or radio list, based on admin settings) titled “Select Saved Billing Address.”

3. If shipping is required and different from billing, a similar selector will appear above the Shipping Address form.

4. The customer can:

• Choose one of their saved addresses from the list. The checkout form fields will automatically populate with the details of the selected address.
  • If the admin has set “Saved Address Display Format” to “Show Formatted Address Block,” the form fields will hide, and a summary of the selected address will be shown.
• (If allowed by admin) Select “Enter a new address.” This will keep the standard checkout form fields visible for manual entry.
• If no selection is made, their default WooCommerce address (or the pre-filled fields from a previous session) will be used.

---

6. Troubleshooting & FAQ

• Address Book page shows “Not Found” (404 Error):
  • This usually means WordPress rewrite rules need to be refreshed. Go to Settings > Permalinks in your WordPress admin and simply click the Save Changes button. You don’t need to change any settings there; just saving will flush the rules. This often happens after plugin activation or theme changes.
• Selectors not appearing on Checkout Page:
  • Ensure the user is logged in.
  • Ensure the plugin is active.
  • If using the Classic Checkout, ensure your theme hasn’t removed standard WooCommerce hooks like woocommerce_before_checkout_billing_form. Try with a default theme like Storefront to test.
  • If using the Block-Based Checkout, ensure your site is using a block-compatible theme and that there are no JavaScript errors in your browser console preventing the integration scripts from running.
• Address not saving or updating:
  • Ensure the “Max Addresses” limit (if set) hasn’t been reached.

We hope you enjoy using HappyCoders Multiple Addresses for WooCommerce!