Course files

Revision as of 07:05, 21 September 2010 by Martin Dougiamas (talk | contribs)

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 2.3. Up-to-date documentation for the latest stable version is available here: Course files.

This page talks about the legacy "Course files" area in Moodle 2, and related topics.

It's useful for any teacher who wants to know how to add files to a Moodle 2.0 course (especially if you previously used Moodle 1.9 or earlier).

Files in Moodle 1.9

In versions of Moodle before 2.0 all the files uploaded into Moodle were stored in a physical directory on disk known as the 'Course Files' area.

This is where a teacher might upload files to be part of the course content, but this area also included everything students uploaded, such as assignments and forum attachments. These "activity files" were stored in a special folder called "moddata" in a certain structure that helped modules keep track of their own files.

Typical Moodle 1.x workflows

The course files area was accessed in two ways through the Moodle interface by teachers.

  1. Through the "Files" link in the Course Administration block, or
  2. When a file was required in other places, such as a resource, or attachment.

When publishing a file as a resource, say a PDF file, a teacher might:

  1. Upload it to their course files area along with all the other files they intend to use in the course
  2. Add a resource to the course
  3. Select the PDF from the course files

Students did not have direct access to read the course files area, all they could do is upload files from their desktop computer straight into activities.


A less typical workflow

  1. Use FTP to push files straight into the course files area
  2. Add resources to the course using these files
  3. Update the resources later by updating the files directly via FTP

This meant expert users could update course content with files or HTML mini-sites without having to touch the web interface.


Problems with the Moodle 1.x model

  • If the original file is deleted or renamed from Course Files then it breaks everywhere it was being shown
  • Storing files on disk meant names were restricted (eg Japanese names would break on some operating systems)
  • All Course Files had to be readable by students (if they knew the URL) because Moodle had no way of telling what context you were viewing a file in (eg the same file might be in a HTML text in a forum and also in a resource). This meant that files stored here were not as secret as teachers thought they were.
  • You could not re-use an upload in multiple courses, you had to upload it to each course over and over
  • Backups had to include ALL course files, just in case they were required, even if the backup only contained one activity
  • Media might appear to teachers sometimes and look fine, but others would not see it (eg course descriptions)
  • When copying (importing) activities from one course to another it was impossible to tell all the media that should be imported with it


Files in Moodle 2.0

In Moodle 2.0 the files work a lot more like Web 2.0 systems (eg Facebook or Google Docs).

Each activity and each text has its own file area, and files are associated directly with the place it is used. For example, a file attached to a forum post is stored "with" the forum post, and becomes subject to exactly the same access restrictions.

The Files system is intimately connected with the Repository system, and a File Picker which makes it easy to browse external and internal repositories for files, and then copy them into Moodle. Certain repositories also allow you to link directly to their media files. Repositories in general are the way of the future for content - most Web 2.0 systems are really repositories of data with various management interfaces.

A Private Files area is provided for each user to store a collection of files for their own use. This is useful for students as well as teachers, and makes it easy to re-use media across the Moodle site. Only you can access your own private files.

The Course Files area is deprecated and off by default (see Moodle 1.x Problems described above). During an upgrade from 1.9 all Course Files are migrated into new file areas and the Course Files area is hidden from view. See the discussion below about what happens if you want to continue using it.

Internally, files are actually stored in a "file pool" of blobs on disk with numbers for names. All the actual names and metadata is now stored in a database.


Why is it better?

Integrity

If the forum post with embedded media files (eg images) is copied to another course, then the files move with it. Anyone in the new course will also see the media files. This makes activities more portable and re-usable.

If two activities use the same file and one is deleted, then the other one is not affected.

There should be less errors where everything looks fine to teachers and is broken for students.

Security

Access to files is governed the same way as the items that they attached to, which is what people expect. All files are now controlled by the settings in the usual Moodle interface, including roles and permissions.

Re-use

It is now fast and easy to re-use files across Moodle. Using the File picker you can choose a file you recently used, or one from any course you have access to.

Backups

Backups of activities are now small, accurate and easier to handle, because we know exactly what files to include. This is important for things like Community hubs, where sharing of courses and parts of courses will become more common, and sharing every file you have in a course is often not acceptable.

Internationalisation

We are no longer restricted by the operating system, we can use files with any names we like.


How to duplicate Moodle 1.x functionality

FTP files into Moodle

Change a file once, have it update in many places

Roadmap for future improvements

Synch files

Linking ability to filesystem repository

See also