After a lot of debugging, I finally managed to make this work. The trick lies inside $form['complete form']
. but first things first, how does form_set_value() work and what does it do?
the form_set_value()
function
as the docs suggested:
if you want to update the value of $form['elem1']['elem2'], which should be stored in $form_state['values']['elem1']['elem2'], you would set $element['#parents'] = array('elem1','elem2').
now what does that mean? in my case, I had a textfield called 'field_event_title', which is the name I gave it on creation. in $form
, all fields have a sub-array in $form['field_name']
, which is in my case $form['field_event_title']
. this is where the submitted value also is stored. now since it is a textfield, drupal maintains both the language and the delta [question for editors: is this right?] of the inputted data. so in fact, the value is not stored in $form['field_name']['value']
, but in $form['field_name']['und'][0]['value']
(['und']=language; [0]=delta). note that 'und' is the drupal key for the default language of the site, if it is, say, in german, then it would be 'de', however, in most cases it should be 'und'.
to actually change the value using form_set_value(), one is ought to invoke the function by writing:
form_set_value($form['field_name'],array('und' => array(0 => array('value' => 'foo'))),$form_state);
i.e. $element = $form['field_name']
$value=array('und' => array(0 => array('value' => 'foo')))
updating a form to repopulate it with different values than submitted (or clearing them)
but that did not work in my case since I wanted to clear fields once a custom validation error has been invoked. now one would suspect that the form repopulates itself using the values inside $form_state['values']
(which is actually the place where the values are stored, the actual place that gets updated when using form_set_value()
and the place which generates the $form
later.), but that is not the case: it uses the values inside $form_state['complete form']
, which is a 'copy' of $form
(notice that it is spelled 'complete form', with a space, not an underscore).
so using $form_state['complete form']['field_name']['und'][0]['value']['#value']='foo';
is what updates the values that actually repopulate the form on a validation error. (note: you can, as do I in my usecase, set it to =NULL
to simply empty the field).
summary
now where is the difference between $form['field_name']
(e.g. updating through form_set_value()
) and $form['complete form']
? well, the former updates the actual value, which then gets stored inside the database, the latter is being used to repopulate a form when it failed a validation.