Magento: Show address fields in account creation form

The Magento eCommerce platform hides the "address fields", including the customer's company name, by default. To enable them, most sources on the internet suggest overriding the register.phtml file and either commenting out the check to getShowAddressFields or to specifically call $this->setShowAddressFields (true);. That'll work, but it's not the proper way to do it. Read on the learn the proper way.

Magento account creation form
The default Magento account creation form does not allow the customer to enter his address information.

TL;DR

First, the quick answer. To enable the address fields, add the following to your app/design/frontend/default/template/layout/local.xml file:

<customer_account_create> <reference name="customer_form_register"> <action method="setShowAddressFields"><param>true</param></action> </reference> </customer_account_create>

Explanation

Magento allows virtually all of its behaviour to be overridden by replacing modules or templates. Making a copy of a template (or worse: editing the ones included in the base package) is overkill for this case and will result in your custom template not being updated or the your changes being overwritten when Magento is updated.

For this reason, even though a simple call to $this->setShowAddressFields (true) would suffice, that should not be done through the template file. Instead, Magento provides a way to do such method calls through its local XML files. That is what happens in the XML snippet above.

Sidebar: where is that method?

The customer registration form block is of type Mage_Customer_Block_Form_Register, which (through Mage_Directory_Block_Data, Mage_Core_Block_Template, Mage_Core_Block_Abstract) eventually inherits from Varien_Object. In none of those classes will you actually find the getShowAddressFields or setShowAddressField methods defined as functions and method_exists ($this, 'getShowAddressField') will actually return false. How can this work?

This is because Varien_Object makes use of the PHP feature "Method overloading". By having a function __call ($method, $args) method, it can intercept any calls to non-existent methods. This implementation then checks the name of the method being called and converts the name "getShowAddressFields" into the key "show_address_fields" and looks up this value in its internal data dictionary. If the method name starts with "set", rather than "get" it stores the value instead. It also handles "has" (to see whether a property exists) and "uns" (to unset a property).

It's an intriguing, clean and pretty way to avoid having to write setters and getters for every little variable, but if you're not aware of it, it can lead to a lot of searching where these mystery methods are as grep won't find anything. An alternative method would be to use property overloading instead. The reason to use the set/get functions is probably to make it easier to override getters/setters for certain properties where they may have side effects and for compliance with coding quidelines.

Tags:

Pingbacks

Comments

Dirk

Does this work on Magento 1.7.0.2 also? I do not have a local.xml at app/design/frontend/default/template/layout/local.xml
Even adding this file doesnt work.
Any idea?

Steven Don

The italicised "template" in that directory is the name of the template that you're using. If you are using the included "modern" template, it would be "app/design/frontend/default/modern/layout/local.xml"

After editing/creating that file, you should also clear the caches to make sure it is picked up.

Hennie van Rooyen

Does not have this file in default or base or in my template.

srikal

Really helpful :) Thanks a lot

Kseniya

1.7.0.2 To use the file app\design\frontend\default\[you theme]\layout\customer.xml

Thank you! Your article helped me a lot!

mjjsmeets

I added just the line <action method="setShowAddressFields"><param>true</param></action>
to a already existing customer_account_create block found in a themed version of magento 1.7.0.2 using the file:
app/design/frontend/base/default/layout/persistent.xml

So beware of the version differences, searching for customer_account_create in your sourcetree before you add this block new to some xml file would be smart.

Jai

How to make all these fields optional as these all fields are required.
any help?

Renish Khunt

Really Good. Thank you So much

Perry

Hi! Thanks for the tutorial! I used that method for some time but then I had to switch to an extension that gives more control over custom address fields. I use the one by Amasty

Bikram

Thanks for the post !!!

Pratik Shah

Thanks for sharing this great post. The results are published in address field in account creation form. Nice work, keep it up. by https://www.brushyourideas.com/

MLS

Is there a way to make the address set as default shipping and billing after registration of a new account?

Post a comment