Development:Using the File API - Revision history

Mattgibson: /* List area files */ Added code to list files as links

2011-05-19T13:30:24Z

List area files: Added code to list files as links

@@ Line 123: / Line 123: @@
      echo $f->get_filename();
+}
 </code>

Jfruitet: /* Delete file */

2011-05-13T13:03:14Z

Delete file

← Older revision		Revision as of 13:03, 13 May 2011
Line 186:		Line 186:
	// Prepare file record object		// Prepare file record object
	$fileinfo = array(		$fileinfo = array(
	'~~filearea~~' => 'mod_mymodule',		'component' => 'mod_mymodule',
	'filearea' => 'myarea', // usually = table name		'filearea' => 'myarea', // usually = table name
	'itemid' => 0, // usually = ID of row in table		'itemid' => 0, // usually = ID of row in table

Sunner: /* File areas */ Fix a typo

2011-04-05T04:35:03Z

File areas: Fix a typo

← Older revision		Revision as of 04:35, 5 April 2011
Line 12:		Line 12:
	* A unique itemid. Normally, the itemid relates to something depending on the file area type. For example, for a 'course', 'intro' file area, the itemid is 0. For forum post, it is the post id.		* A unique itemid. Normally, the itemid relates to something depending on the file area type. For example, for a 'course', 'intro' file area, the itemid is 0. For forum post, it is the post id.

	File areas are not listed separately anywhere, they are stored implicitly in the files table. Please note that each subsystem is allowed to access only own file areas, for example ~~onnly~~ code in /mod/assignment/* may access files with component 'mod_assignment'.		File areas are not listed separately anywhere, they are stored implicitly in the files table. Please note that each subsystem is allowed to access only own file areas, for example only code in /mod/assignment/* may access files with component 'mod_assignment'.

	===Naming file areas===		===Naming file areas===

Sunner: /* File areas */ Remove a duplicated 'is'

2011-04-05T04:33:59Z

File areas: Remove a duplicated 'is'

← Older revision		Revision as of 04:33, 5 April 2011
Line 10:		Line 10:
	* full component name, for example 'course', 'mod_forum', 'mod_glossary'.		* full component name, for example 'course', 'mod_forum', 'mod_glossary'.
	* A file area type, for example 'intro' or 'post'.		* A file area type, for example 'intro' or 'post'.
	* A unique itemid. Normally, the itemid relates to something depending on the file area type. For example, for a 'course', 'intro' file area, the itemid is is 0. For forum post, it is the post id.		* A unique itemid. Normally, the itemid relates to something depending on the file area type. For example, for a 'course', 'intro' file area, the itemid is 0. For forum post, it is the post id.

	File areas are not listed separately anywhere, they are stored implicitly in the files table. Please note that each subsystem is allowed to access only own file areas, for example onnly code in /mod/assignment/* may access files with component 'mod_assignment'.		File areas are not listed separately anywhere, they are stored implicitly in the files table. Please note that each subsystem is allowed to access only own file areas, for example onnly code in /mod/assignment/* may access files with component 'mod_assignment'.

Chrisstones: ; should be , in the examples

2010-07-26T21:55:58Z

; should be , in the examples

← Older revision		Revision as of 21:55, 26 July 2010
Line 134:		Line 134:
	// Prepare file record object		// Prepare file record object
	$fileinfo = array(		$fileinfo = array(
	'contextid' => $context->id; // ID of context		'contextid' => $context->id, // ID of context
	'component' => 'mod_mymodule'; // usually = table name		'component' => 'mod_mymodule', // usually = table name
	'filearea' => 'myarea'; // usually = table name		'filearea' => 'myarea', // usually = table name
	'itemid' => 0; // usually = ID of row in table		'itemid' => 0, // usually = ID of row in table
	'filepath' => '/'; // any path beginning and ending in /		'filepath' => '/', // any path beginning and ending in /
	'filename' => 'myfile.txt'); // any filename		'filename' => 'myfile.txt'); // any filename

Line 158:		Line 158:
	// Prepare file record object		// Prepare file record object
	$fileinfo = array(		$fileinfo = array(
	'component' => 'mod_mymodule'; // usually = table name		'component' => 'mod_mymodule', // usually = table name
	'filearea' => 'myarea'; // usually = table name		'filearea' => 'myarea', // usually = table name
	'itemid' => 0; // usually = ID of row in table		'itemid' => 0, // usually = ID of row in table
	'contextid' => $context->id; // ID of context		'contextid' => $context->id, // ID of context
	'filepath' => '/'; // any path beginning and ending in /		'filepath' => '/', // any path beginning and ending in /
	'filename' => 'myfile.txt'); // any filename		'filename' => 'myfile.txt'); // any filename

Line 186:		Line 186:
	// Prepare file record object		// Prepare file record object
	$fileinfo = array(		$fileinfo = array(
	'filearea' => 'mod_mymodule';		'filearea' => 'mod_mymodule',
	'filearea' => 'myarea'; // usually = table name		'filearea' => 'myarea', // usually = table name
	'itemid' => 0; // usually = ID of row in table		'itemid' => 0, // usually = ID of row in table
	'contextid' => $context->id; // ID of context		'contextid' => $context->id, // ID of context
	'filepath' => '/'; // any path beginning and ending in /		'filepath' => '/', // any path beginning and ending in /
	'filename' => 'myfile.txt'); // any filename		'filename' => 'myfile.txt'); // any filename

Skodak: /* Create a copy of stored file */

2010-07-03T14:21:17Z

Create a copy of stored file

← Older revision		Revision as of 14:21, 3 July 2010
Line 95:		Line 95:
	<code php>		<code php>
	$context = get_context_instance_by_id($contextid);		$context = get_context_instance_by_id($contextid);
	$file_info = $browser->get_file_info($context, $filearea, $fileitemid, $filepath, $filename);		$file_info = $browser->get_file_info($context, $component, $filearea, $fileitemid, $filepath, $filename);
	// copy this file to draft area		// copy this file to draft area
	$file_info->copy_to_storage($user_context->id, 'user', 'draft', $newitemid, '/', $title);		$file_info->copy_to_storage($user_context->id, 'user', 'draft', $newitemid, '/', $title);

Skodak: /* Delete file */

2010-07-03T13:58:36Z

Delete file

← Older revision		Revision as of 13:58, 3 July 2010
Line 186:		Line 186:
	// Prepare file record object		// Prepare file record object
	$fileinfo = array(		$fileinfo = array(
	'filearea' => '~~my_area~~'; // usually = table name		'filearea' => 'mod_mymodule';
			'filearea' => 'myarea'; // usually = table name
	'itemid' => 0; // usually = ID of row in table		'itemid' => 0; // usually = ID of row in table
	'contextid' => $context->id; // ID of context		'contextid' => $context->id; // ID of context
Line 193:		Line 194:

	// Get file		// Get file
	$file = $fs->get_file($fileinfo->contextid, $fileinfo->filearea,		$file = $fs->get_file($fileinfo->contextid, $fileinfo->component, $fileinfo->filearea,
	$fileinfo->itemid, $fileinfo->filepath, $fileinfo->filename);		$fileinfo->itemid, $fileinfo->filepath, $fileinfo->filename);

Skodak: /* Read file */

2010-07-03T13:57:52Z

Read file

← Older revision		Revision as of 13:57, 3 July 2010
Line 151:		Line 151:
	=== Read file ===		=== Read file ===

	This is a way to read a file, equivalent to <tt>file_get_contents</tt>.		This is a way to read a file, equivalent to <tt>file_get_contents</tt>. '''Please note your are allowed to do this ONLY from mod/mymodule/* code, it is not acceptable to do this anywhere else.''' Other code has to use file_browser interface instead.

	<code php>		<code php>
Line 158:		Line 158:
	// Prepare file record object		// Prepare file record object
	$fileinfo = array(		$fileinfo = array(
	'filearea' => '~~my_area~~'; // usually = table name		'component' => 'mod_mymodule'; // usually = table name
			'filearea' => 'myarea'; // usually = table name
	'itemid' => 0; // usually = ID of row in table		'itemid' => 0; // usually = ID of row in table
	'contextid' => $context->id; // ID of context		'contextid' => $context->id; // ID of context
Line 165:		Line 166:

	// Get file		// Get file
	$file = $fs->get_file($fileinfo->contextid, $fileinfo->filearea,		$file = $fs->get_file($fileinfo->contextid, $fileinfo->component, $fileinfo->filearea,
	$fileinfo->itemid, $fileinfo->filepath, $fileinfo->filename);		$fileinfo->itemid, $fileinfo->filepath, $fileinfo->filename);

Skodak: /* Create file */

2010-07-03T13:55:57Z

Create file

← Older revision		Revision as of 13:55, 3 July 2010
Line 134:		Line 134:
	// Prepare file record object		// Prepare file record object
	$fileinfo = array(		$fileinfo = array(
	'filearea' => '~~my_area~~'; // usually = table name		'contextid' => $context->id; // ID of context
			'component' => 'mod_mymodule'; // usually = table name
			'filearea' => 'myarea'; // usually = table name
	'itemid' => 0; // usually = ID of row in table		'itemid' => 0; // usually = ID of row in table
	~~'contextid' => $context->id; // ID of context~~
	'filepath' => '/'; // any path beginning and ending in /		'filepath' => '/'; // any path beginning and ending in /
	'filename' => 'myfile.txt'); // any filename		'filename' => 'myfile.txt'); // any filename

Skodak: /* List area files */

2010-07-03T13:55:11Z

List area files

← Older revision		Revision as of 13:55, 3 July 2010
Line 118:		Line 118:
	<code php>		<code php>
	$fs = get_file_storage();		$fs = get_file_storage();
	$files = $fs->get_area_files($contextid, '~~user_draft~~');		$files = $fs->get_area_files($contextid, 'mod_assignment', 'submission', $submission->id);
	foreach ($files as $f) {		foreach ($files as $f) {
	// $f is an instance of stored_file		// $f is an instance of stored_file