> ## Documentation Index
> Fetch the complete documentation index at: https://docs.smartwpplugins.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Requirements and setup steps for Unwan

## Requirements

| Requirement | Minimum |
| ----------- | ------- |
| WordPress   | 6.5     |
| PHP         | 7.4     |
| WooCommerce | 8.2     |

Unwan declares `Requires Plugins: woocommerce` in its plugin header, so WordPress will refuse to activate it without WooCommerce already active — you don't need to remember the dependency order yourself.

<Note>
  Unwan has no other runtime dependencies. It ships with a small built-in PSR-4 autoloader, so there is no Composer install step required to run it — Composer is only used for the project's own development tooling.
</Note>

## Install

<Steps>
  <Step title="Install and activate WooCommerce">
    Unwan is a WooCommerce extension and does nothing without it. If WooCommerce isn't active, Unwan will show an admin notice explaining the minimum version required instead of loading.
  </Step>

  <Step title="Install Unwan">
    Either search for **Unwan – Address Library for WooCommerce** under **Plugins → Add New Plugin** in your WordPress admin, or upload `unwan-for-woocommerce.zip` directly via **Plugins → Add New Plugin → Upload Plugin**.
  </Step>

  <Step title="Activate the plugin">
    On activation, Unwan registers its My Account rewrite endpoint and flushes rewrite rules automatically — no manual permalink resave is required.
  </Step>

  <Step title="Open the settings screen">
    Go to **WooCommerce → Settings → Accounts & Privacy → Unwan** (or use the **Settings** link Unwan adds directly under its entry on the Plugins screen) to configure behavior, appearance, and labels. No setting is required to get started — reasonable defaults are already in place after activation.
  </Step>
</Steps>

## Verifying it worked

* A signed-in customer visiting **My Account** should see an **Address book** entry in the account navigation, replacing WooCommerce's plain "Addresses" item.
* A customer with at least one saved address (their billing or shipping profile default counts) should see a picker above the corresponding fields at checkout.
* If nothing appears at checkout, that's expected until a customer has a saved address — the picker only renders when there's something to pick from. See the [Quickstart](/unwan/quickstart) to create a test address quickly.

## Uninstalling

By default, deleting Unwan leaves all customer address data and settings in place — useful if you're reinstalling later or just deactivating temporarily. If you want a full removal, enable **Uninstall cleanup** on the settings screen before deleting the plugin; this removes Unwan's own settings and the shared additional-address records, but never touches WooCommerce's own billing or shipping profile fields.


## Related topics

- [Introduction](/unwan/introduction.md)