=== Vanquish Multiple Addresses for WooCommerce ===
Contributors: vanquish83, freemius
Tags: woocommerce, addresses, multiple addresses, shipping address, address book
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Let WooCommerce customers save and pick from multiple billing and shipping addresses, in My Account and at checkout.

== Description ==

Vanquish Multiple Addresses for WooCommerce gives your customers a real address book. They can save as many billing and shipping addresses as they like, name them (Home, Office, …), set a default, and pick one at checkout instead of retyping it every time.

**Free features**

* Unlimited saved billing and shipping addresses per customer
* Add, edit and delete addresses from the My Account area
* Pick a saved address at checkout (billing and shipping)
* Works in both the classic checkout and the block checkout
* Name each address and set a default
* Enable or disable the selector on the billing / shipping form independently
* Optional billing and shipping address columns on the admin orders list

There is no cap on the number of addresses, no time limit, and nothing switched off waiting to be paid for. The premium edition adds separate features; it does not unlock these.

**Premium features**

Where the free edition is about keeping addresses, the premium edition is about using several of them in the same order — one basket going to more than one place — and about managing your customers' address books yourself.

* Ship each product in the cart to a different saved address, in both checkouts
* Split the order into one package, and one shipping cost, per destination
* Handling fees per extra destination, flat or by number of destinations
* Delivery notes stored with an address and carried into the order notes
* A separate shipping email per address
* Per-role restrictions and a maximum number of saved addresses per customer
* Search, multi-select, bulk delete and duplicate in the customer's address book
* CSV import and export of every customer's addresses
* A customer's address book on their user profile, and an address picker when editing an order
* Custom CSS for the My Account and checkout pages

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`, or install it from the Plugins screen.
2. Activate the plugin.
3. Make sure WooCommerce is installed and active.
4. Configure it under **Multiple Addresses** in the admin menu.

== Frequently Asked Questions ==

= Does it require WooCommerce? =

Yes. The plugin needs WooCommerce to be installed and active.

= Where are the customer addresses stored? =

In standard WordPress user meta, so they are removed with the user and are never sent to any external service.

= Does it work with the block checkout? =

Yes. The saved-address selector appears in both the classic checkout and the
block checkout, and the premium per-product destinations work in both too.

= Does an address have to be a billing or a shipping address? =

No. There is one address book, and any saved address can be used for billing, for
shipping, or for both. Each address can be marked as the default for billing and
for shipping independently, so the address you use for both does not have to be
saved twice.

= I already use "WooCommerce Multiple Customer Addresses &amp; Shipping". Do my customers lose their addresses? =

No. Each customer's saved addresses are converted the first time their address
book is read, so there is nothing to run and nothing to time. The conversion
also fixes something the old plugin could not: an address saved once for billing
and again for shipping becomes a single entry usable for both, and an address
that matches one already saved here is merged into it rather than added twice.

The old data is never deleted. It stays exactly where it was, so going back to
the previous plugin leaves you with everything you had.

= I am coming from "WooCommerce Multiple Customer Addresses &amp; Shipping". Is everything I use here? =

Almost. The address book, the checkout selectors, per-product destinations, split
shipping and the admin-side tools are all here, several of them rebuilt and
improved.

The one thing deliberately left out is the **VAT / tax ID field**. It was never
really part of an address book, and there are dedicated plugins that do it
properly — including our own. Everything else you were using has been carried
over.

= How does free shipping work when an order is split across destinations? (premium) =

When the premium "charge shipping separately for each destination" option is on,
WooCommerce quotes each destination as its own shipment. Anything that depends on
the order value — a free shipping threshold, or a table rate — therefore applies
**per destination**, using the value of the products going to that address, not
the order total. An order of 100 split evenly between two addresses is two
shipments of 50 each, so a "free over 80" rule will not apply to either.

Leave the option off to keep a single shipping cost for the whole order while
still recording which address each product goes to.

== Screenshots ==

1. The address book in My Account: every saved address, named, with the default for billing and for shipping marked.
2. Adding or editing an address without leaving the page, using WooCommerce's own address fields and country rules.
3. Choosing a saved address in the classic checkout, with add, edit and delete alongside the selector.
4. The same selector in the block checkout.
5. Premium: sending each product to a different saved address in the classic checkout, with shipping quoted separately for each destination.
6. Premium: the same in the block checkout, where destinations are chosen above the shipping options they affect.
7. Premium: managing the address book in bulk — search, select several at once, delete them together, or duplicate one as a starting point.

== Changelog ==

= 1.0.1 =
* Adds an "Activate Premium" page explaining how to install the premium version after buying. Freemius offers no licence field in the free build, and rightly so — the premium code is not in this package at all, so a key would have nothing to unlock. That is invisible to someone who has just paid and is looking for somewhere to type it, so the steps are now spelled out.

= 1.0.0 =
* Initial release.
* Address book in My Account: save, name, edit and delete any number of billing and shipping addresses.
* Saved-address selector in the classic checkout and the block checkout.
* An address has no type: any address can be the default for billing, for shipping, or for both, so the one you use for both is not saved twice.
* Optional billing and shipping address columns on the orders list, with High-Performance Order Storage support.
* Addresses saved by "WooCommerce Multiple Customer Addresses &amp; Shipping" are converted automatically, merging entries that plugin stored twice. The old data is left untouched.
