1 file.field.inc _file_field_get_description_from_element($element)

Retrieves the file description from a field field element.

This helper function is used by file_field_widget_process_multiple().


$element: The element being processed.

Return value

A description of the file suitable for use in the administrative interface.:


core/modules/file/file.field.inc, line 928
Field module functionality for the File module.


function _file_field_get_description_from_element($element) {
  // Use the actual file description, if it's available.
  if (!empty($element['#default_value']['description'])) {
    return $element['#default_value']['description'];
  // Otherwise, fall back to the filename.
  if (!empty($element['#default_value']['filename'])) {
    return $element['#default_value']['filename'];
  // This is probably a newly uploaded file; no description is available.
  return FALSE;