Ubercart Addresses

The uc_addresses module adds support for one or more addresses in the user's profile. When users register, you can require that they provide an address. Users can then add more addresses and edit or delete existing addresses. One address is always designated as the default address and cannot be deleted (but it can be edited). Users can optionally name each address (e.g. "work", "mary", "joe").

The Ubercart order process is altered so that users select delivery and billing addresses from their collection of addresses rather than from previous orders. You can ask the module to automatically fill in the billing and/or the delivery address with the user's default address. Any new addresses entered during the order process are automatically added to the user's list.

A first alpha version of Ubercart Addresses 6.x-2.x has been released! The main flow of the module has been tested and should be fully operational. Give it a try and report any bugs you may find. (A few bugs have been fixed in dev, see the changelog.)

Development

• The 7.x branch: there is a first development release now available! See the release notes for more information about what works and what does not work yet. An alpha release (7.x-1.0-alpha1) is planned for the end of March, 2012.
• The 6.x-2.x branch: any new features will go in this branch. This version is not ready for production use. See further for more information.
• The 6.x-1.x branch: no new features will be added to this branch. It's open for bug fixes only.
• The 5.x branch: there will be no further development on the 5.x branch.

Ubercart Addresses 6.x-2.x/7.x-1.x

This version introduces a rich API in which other modules can connect. The API introduces the following:

• A system for loading, deleting and saving addresses: the address book API.
• A system for adding extra address fields: the field handler API. The module Extra Fields Pane makes use of this API.

Features

The 6.x-2.x and 7.x-1.x versions contain the following features:

• Address book: users can add multiple addresses to their profile.
• Default billing and default shipping addresses: users can mark addresses as their default billing address or their default shipping address. This may be the same address.
• Address nickname: users can give each address a name.
• Address formats: Ubercart Addresses comes with it's own address formats that are build by using tokens, rather than the predefined set of variables Ubercart uses. This way it's possible to add any extra address values to an address format. Only addresses used by Ubercart Addresses are formatted using Ubercart Addresses' address formats.
• Select addresses from address book at checkout: users can select an address from their address book at checkout.
• Require an address when registering: you can require users to fill in an address when they register.
• Fine grained permissions settings: there are permissions for viewing, editing and deleting own addresses and permissions for viewing, editing and deleting addresses of other users. There is also a set of hooks available to get further control about addresses access. See the file uc_addresses.api.php (included with the module) for more information.

Dependencies

• Ubercart 6.x-2.6 or later (6.x-2.3 or later if you don't need the features in the order administration)
• CTools 6.x-1.8 or later
• Token

Integrations

• Views (planned for 6.x-2.0-alpha2, to help see #1391216: Views integration for the 6.x-2.x and 7.x-1.x version)
• Extra Fields Pane 6.x-2.0-beta1 or later

Development status

• API alpha - The address book API is considered complete and can be tested. The field handler API may need some more tweaks.
• Address book bèta - The address book should be feature complete and is ready for testing.
• Checkout alpha - Usability improvements are planned.
• Order bèta - Addresses can be selected from the address book and from other sources. Please review if this feature works as expected: #396342: addresses in admin orders interface.
• Documentation bèta - A detailed guide of the API is now available! Documentation about the hooks can be find in the file uc_addresses.api.php which is included with the module.

Views support

Need Views support for the 6.x-1.x version? Thanks to the work of madsph, you can integrate uc_addresses with Views by adding his uc_views module.

Maintainers

• The 6.x-2.x and 7.x-1.x versions are actively maintained by MegaChriz.
• The 5.x and 6.x-1.x versions were originally maintained by Tony Freixas.

How to help

I'm looking for volunteers to test the 6.x-2.x version of the module thoroughly. I'm also looking for co-developers who want to help me with the 6.x-2.x and 7.x-1.x version. #1391216: Views integration for the 6.x-2.x and 7.x-1.x version is open for volunteers to pick up.

Downloads