Address field for CCK

New Zeal - March 16, 2007 - 00:27

USE THE 2.2 VERSION. You must re-save all CCK field settings where you've used this module prior to this version. This module makes available as a single CCK field all of the fields you'd expect for a user to enter in an address.

New to 5.x, country_select module. This module makes use of the country/province data created for the addresses module to create country/province dropdowns for all countries in the world. Requires the activeselect module to work.

New additions to version 2.0 include: Custom ordering of fields, Custom naming of fields, Custom default values of fields, Turn fields on/off, Better theming.

Currently, only U.S. and Canadian addresses are supported in the default module, but a framework is in place to support adding other countries. In fact, the extension project (link below) adds support for other countries and the Canadian sub-module can be copied and adjusted easily to add support for the country you wish. Such sub-modules define a country name and two letter abbreviation, along with a list of states/provinces and validation for certain fields in the languages supported in that country. Sub-fields of the module include street1, street2, apartment/suite, city, state, zip, country and other. Validation for each field is based on the country & state/province information in the database, as well as allowed/expected characters in the official languages of the given country. In other words, Canadian zip codes validate differently from U.S. ones and Canadian text fields allow such characters as 'à' whereas U.S. fields do not.

Support was added to allow 'other' countries. This shows the country and state fields as text fields, rather than dropdowns and uses alternative validation accordingly. This is especially important now, while the module is young and there aren't any sub-modules for countries other than those listed above. Only simple text validation will be available as we won't know what to expect from the user, so site admins will have to check the addresses.

If the "activeselect" module is installed and enabled on your system, then the state/province dropdown is populated dynamically via AJAX. With 51 entries for the U.S. alone, adding other countries to the list will quickly make the list ridiculously long. Without "activeselect", you just get the long dropdown.

Added diff module support. Changing the address between revisions now renders correctly in diff view.

I've also added a feature that I needed, but for which the average user may have no use; you can now validate addresses from complete known values. One idea of this use is if you have a church website and want only church members to be able to sign up. Presumably, you would have a list of members and addresses ahead of time. So essentially, they don't so much 'sign up' as 'activate' their accounts. Same thing goes with any kind of group where sign up is physically done in the real world and web site use is a bonus/extra feature of association with that group.

See also http://drupal.org/project/cck_address_extensions for additional country support.

Contact me via my Drupal profile if you'd like to hire me to set this module up, modify it for your particular use, or other Drupal/PHP work.