The #managed_file element is expanded into a set of FAPI elements including two '#submit' buttons one for Upload one for Remove, a '#file' element and a handful of '#hidden' and '#markup' elements to handle progress indication and displaying of already uploaded files.
-Note: New files are uploaded with a status of 0 and are treated as temporary files which are removed after 6 hours via cron. Your module is responsible for changing the $file objects status to FILE_STATUS_PERMANENT and saving the new status to the database. Something like the following within your submit handler should do the trick.
+Note: New files are uploaded with a status of 0 and are treated as temporary files which are removed after 6 hours via cron. Your module is responsible for changing the $file objects status to FILE_STATUS_PERMANENT and saving the new status to the database. Something like the following within your submit handler should do the trick. +
+ // Load the file via file.fid.
+ $file = file_load($form_state['values']['my_file_field']);
+ // Change status to permanent.
+ $file->status = FILE_STATUS_PERMANENT;
+ // Save.
+ file_save($file);
+ Once a file has been uploaded the file object's fid can be used as the #default_value for the form element. This will display an icon, a link to the file, and a remove button.
@@ -1731,7 +1740,21 @@Properties: #access, #after_build, +#array_parents, #attached, +#attributes, #description, +#disabled, #element_validate, +#parents, #post_render, +#prefix, #pre_render, +#process, #states, +#suffix, #theme, +#theme_wrappers, #title, +#tree, #weight
+ +Usage example (image_example.pages.inc.):
+ +<?php
// Use the #managed_file FAPI element to upload an image file.
$form['image_example_image_fid'] = array(
'#title' => t('Image'),
'#type' => 'managed_file',
'#description' => t('The uploaded image will be displayed on this page using the image style choosen below.'),
'#default_value' => variable_get('image_example_image_fid', ''),
'#upload_location' => 'public://image_example_images/',
);
?>