Customizing a field label

You'd add a #process callback to the address form element, then alter it from there.

  $form['field_address']['widget'][0]['address']['#process'][] = 'mymodule_change_labels'; 

function mymodule_change_labels($element, $form_state, $complete_form) {
  $element['organization']['#title'] = 'Building';
}

That said, it feels like you're abusing the Organization field for something it was not intended for. I'd rather use the address_line2 for that.

but adding anything to #process as described above was causing the entire address widget to show up empty (even if I just returned the element unchanged).

You probably didn't have "return $element;" at the end of you process callback. Forgot to mention that. Anyway, after_build is just as fine.

If you only need to change the labels, you can also use a translation:
- enable the interface translation module
- for the English (built-in) language, enable Interface translation to English: /admin/config/regional/language/edit/en
- visit a form or display with an address field to generate the translation source strings
- translate the labels: /admin/config/regional/translate

The advantage is that the labels are changed everywhere using 1 setting.

At least for current versions (Drupal 8.5.3, Address 1.3), when adding following code to the form_alter the original field element's process callback (Drupal\address\Element\Address::processAddress) is not called at all:
$form['field_address']['widget'][0]['address']['#process'][] = 'mymodule_change_labels';
That's why even if this function returns $element the wiget is empty.

For it to work its necessary calling the original field element's process callback explicitely for example like this:

$form['field_address']['widget'][0]['address']['#process'][] = ['Drupal\address\Element\Address', 'processAddress']; 
$form['field_address']['widget'][0]['address']['#process'][] = 'mymodule_change_labels'; 

Hello Guys,

I'm currently working with the versions Drupal Core 8.5.5 and Address 1.4. But the following code isn't changing anything. I do know it is called because i get the drupal message, but no change is made. Am I doing something wrong here?

@budalokko Maybe you should update to Address version 1.4? I don't need the original process call.

/*
 * Implementation of hook_form_alter()
 */
function mymodule_form_alter(&$form, &$form_state, $form_id){
  // Change form id here
   if ($form_id == 'myFormId') {
       $form['myAdressField']['widget'][0]['address']['#process'][] = 'mimi_wizard_address_label';
   }
}

function mymodule_address_label($element, $form_state, $complete_form) {
  drupal_set_message('mymodule_address_label() executed.');
  $element['given_name']['#size'] = 30;
  return $element;
}

The example code above does not work for me, nor does the documentation example at drupalcommerce.org. These appear to assume the addressfield is a standard field in the form.

In my case the addressfield is a field on a profile checkout pane, added via Commerce Profile Panes, using inline entity form. It's necessary to add the after_build callback via hook_inline_entity_form_entity_form_alter(), and I must add it to the widget base element, not the widget address element. The code below successfully alters the address_line1 field label:

function MYMODULE_inline_entity_form_entity_form_alter(&$entity_form, FormStateInterface &$form_state) {
  if ($entity_form['#entity_type'] == 'profile' && isset $entity_form['address']) {
    $entity_form['address']['widget']['#after_build'][] = 'MYMODULE_address_after_build';
  }
}

function MYMODULE_address_after_build($element, FormStateInterface $form_state) {
  $element[0]['address']['address_line1']['#title'] = t('Postal address');
  return $element;
}

Hope this helps. I do wonder when the address_line1 label default got changed from simply "Address" to "Street address"? That's a big assumption to make.

Just a note to say that there are docs now: https://docs.drupalcommerce.org/commerce2/developer-guide/customers/addr...

Of course, checkout will be a different story, especially if using a contrib module that does its own embedding.

Bojan, the form id is something like profile_customer_address-book-add_form, note the dashes instead of underlines. Is this a bug that can't be fixed any more because people rely on it, or is it on purpose?

Also, for editing an existing address, the form id is profile_customer_address-book-edit_form.

Has anyone figured out how to override the address line during the checkout process? I tried #9, but my MYMODULE_inline_entity_form_entity_form_alter function is never called.

@sagesolutions no, I am trying the same right now. Did you figure this out?

I figured it out like this:

function MODULE_form_alter(&$form, FormStateInterface $form_state, $form_id) {
  if ($form_id == 'commerce_checkout_flow_multistep_custom' && $form['#step_id'] == 'order_information') {
    if (isset($form['shipping_information']['shipping_profile']['address']['widget'][0]['address'])) {
      $form['shipping_information']['shipping_profile']['address']['widget'][0]['address']['#after_build'][] = 'MODULE_customize_address';
    }
  }
}

function MODULE_customize_address($element, FormStateInterface $form_state) {
  ...
  return $element;
}

@bojanz Should we update the docs at https://docs.drupalcommerce.org/commerce2/developer-guide/customers/addr... ? For me those instructions didn't work.