Carga de imágenes en un módulo personalizado

Estoy escribiendo un módulo personalizado y lo necesito para cargar una imagen. Tengo problemas para encontrar buena documentación sobre esto, pero creo que estoy cerca.

¿Qué me estoy perdiendo? $ file devuelve false en el envío del formulario.

function mymodule_custom_content_block_form($form_state){
    $form = array();
    $form['custom_content_block_text'] = array(
        '#type' => 'textarea',
        '#title' => t('Block text'),
        '#default_value' => variable_get('mymodule_custom_content_block_text'),
        '#required' => true,
    );
    $form['custom_content_block_image'] = array(
        '#type' => 'file',
        '#name' => 'custom_content_block_image',
        '#title' => t('Block image'),
        '#size' => 40,
        '#description' => t("Image should be less than 400 pixels wide and in JPG format."),
    );  
    $form['submit'] = array(
        '#type' => 'submit',
        '#value' => t('Update'),
    );
    return $form;
}

function mymodule_custom_content_block_form_submit($form, &$form_state){
    if(isset($form_state['values']['custom_content_block_image'])){
        $validators = array('file_validate_extensions' => array('jpg jpeg'));
        $file = file_save_upload('custom_content_block_image', $validators, 'public://');
        if($file == false){
            drupal_set_message(t("Error saving image."), $type = "error", $repeat = false);
        }
        else{
            $file->status = FILE_STATUS_PERMANENT;
            $file = file_save($file);   
        }
    }
    variable_set('mymodule_custom_content_block_text', $form_state['values']['custom_content_block_text']);
    drupal_set_message(t('Custom Content Block has been updated.'));
}

Si no te importa que te diga que estás haciendo esto de la manera difícil. Drupal tiene un managed_filetipo de elemento que maneja la mayoría de esta lógica por usted:

function mymodule_custom_content_block_form($form, &$form_state) {
  $form['custom_content_block_image'] = array(
    '#type' => 'managed_file',
    '#name' => 'custom_content_block_image',
    '#title' => t('Block image'),
    '#size' => 40,
    '#description' => t("Image should be less than 400 pixels wide and in JPG format."),
    '#upload_location' => 'public://'
  ); 

  return $form; 
}

function mymodule_custom_content_block_form_submit($form, &$form_state) {
  if (isset($form_state['values']['custom_content_block_image'])) {
    $file = file_load($form_state['values']['custom_content_block_image']);

    $file->status = FILE_STATUS_PERMANENT;

    file_save($file);
  }
}

Con Clive answer, mi imagen se eliminó después de 6 horas. Entonces, si alguien experimentó el mismo problema que yo tuve. Aquí está la solución (de la respuesta de Clive con una pequeña adición).

function mymodule_custom_content_block_form($form, &$form_state) {
  $form['custom_content_block_image'] = array(
    '#type' => 'managed_file',
    '#name' => 'custom_content_block_image',
    '#title' => t('Block image'),
    '#size' => 40,
    '#description' => t("Image should be less than 400 pixels wide and in JPG format."),
    '#upload_location' => 'public://'
  ); 

  return $form; 
}

function mymodule_custom_content_block_form_submit($form, &$form_state) {
  if (isset($form_state['values']['custom_content_block_image'])) {
    $file = file_load($form_state['values']['custom_content_block_image']);

    $file->status = FILE_STATUS_PERMANENT;

    $file_saved =file_save($file);
    // Record that the module is using the file. 
    file_usage_add($file_saved, 'mymodule_custom_content_block_form', 'custom_content_block_image', $file_saved->fid); 
  }
}

La solución es agregar file_usage_add. De la documentación de la API:

Nota: Los archivos nuevos se cargan con un estado de 0 y se tratan como archivos temporales que se eliminan después de 6 horas a través de cron. Su módulo es responsable de cambiar el estado de los objetos $ file a FILE_STATUS_PERMANENT y guardar el nuevo estado en la base de datos. Algo como lo siguiente dentro de su controlador de envío debería hacer el truco.

Ver: https://api.drupal.org/api/drupal/developer%21topics%21forms_api_reference.html/7.x#managed_file

Este atributo debe agregarse a su formulario para que funcione con la carga de archivos.

$form['#attributes']['enctype'] = "multipart/form-data";