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

Project Course Format: Difference between revisions

From MoodleDocs
No edit summary
Line 1: Line 1:
* Project Course Format 1.9 release 2 - 2008.07.03  
* Project Course Format 1.9 release 2 - 2008.07.03
* Project Course Format 1.9 release 3 - 2009.02.19
* Project Course Format 1.9 release 3 - 2008.12.31
* Project Course Format 1.9 release 4 - 2009.11.30  (new: section delete feature added)
* Project Course Format 1.9 release 4 - 2009.02.19
* Project Course Format 1.9 release 5 - 2009.11.30  (new: section delete feature added)


==Purpose==
==Purpose==
Line 72: Line 73:
In the Project Course Format, each section has its own folder. The folder is kept in Admin >> FIles of each course (not the Site Files). This folder holds the media files and resources that belong to the section (project/topic/theme). Initially, each section folder is named "section01"," section02"," section03" and so on. However, for moving and importing across the site, it is important that each folder have a unique name. You will be prompted to make a unique name.
In the Project Course Format, each section has its own folder. The folder is kept in Admin >> FIles of each course (not the Site Files). This folder holds the media files and resources that belong to the section (project/topic/theme). Initially, each section folder is named "section01"," section02"," section03" and so on. However, for moving and importing across the site, it is important that each folder have a unique name. You will be prompted to make a unique name.


Project Course Format Updates
=============================
release 5 - 2009.11.30
release 3 - 2008.12.31 -- Change buttons design and correspond for Flash 10.
release 2 - 2008.07.03
release 1 - 2008.06.01
==Purpose==
This is an optional course format for handling projects and other learning units with a variety of activities.  A course format changes the layout and operations of the main center column of a Moodle course.  Inside a course, you can select the format of a course by clicking on Admin >> Course Settings.  Typically, Topics format or Weekly format is used.  This format is like Topics format, except that each section of a course can be "packaged" separately.  It has a separate directory and it can be backed up separately with all resources and activities together.  The import function allows a teacher to share and move the section (project) anywhere on the site.  Fast resource creation and bulk media file upload are also possible.  This format is ideal for creating an in-house repository of learning packages and promoting teacher-to-teacher sharing of materials.
==Features==
# section directory
# section backup
# section import across site with auto-regeneration of media file links
# quick resource creator
# bulk file uploader
==Status==
This course format has been used since early April 2008 in a full 1.9 production environment. However, we urge you use this on a development server until you can verify it works well with you your data.  We believe it supports all standard modules plus some third party modules (Feedback, Project, Splitscreen).  Let us know which modules work or do not work in your environment.  Latest discussions here in General Developer Forum: http://moodle.org/mod/forum/discuss.php?d=87044
==Download & Installation==
Download the latest version from CVS Contrib: http://download.moodle.org/download.php/plugins/course/format/project.zip
To install: admin status needed and use standard procedure for installing 3rd party modules as follows:
#  Unzip this package
#  Place the "project" folder into the course/format/ folder of your Moodle 1.9 program files
#  Place the "lang" folder and help files into the appropriate language folders of your moodledata directory
#  Go into a course where you have teacher or admin status.  Click on "Course settings".
#  Change the course format to "project". 
#  Turn "editing on" and you will see new icons appear.
==Changelog==
Changes contributed by Akio Ohnishi and Tomonori Maruyama 2009.11.30
# delete section "X" feature added
Changes contributed by Akio Ohnishi and Tomonori Maruyama 2009.02.19
# new icons for resource upload and file upload
# in the Question Bank, questions are now duplicated into course categories rather than shared across the site
# more reliable copying and relinking of media files
# conversion of Topic/Weekly format courses to Project Format is easier.  Now section folders are automatically created and associated media copied into them.
Changes contributed by Akio Ohnishi  2008.07.02
# AJAX fixed when enabled on the site.
Changes contributed by Matt Gibson  2008.07.03
# Upload links are now labelled 'Upload file(s) and display them here' and 'Upload file(s) without displaying them yet' - still not ideal, but just a personal preference.
# All links/icons have tooltips to elaborate on the imperfect titles
# The divs containing those links will no longer overlap each other on smaller screens, whilst using long titles
# Help files for backup/restore and directory name were the wrong way around
# The directory naming help button was missing
Changes contributed by Matt Gibson  2008.07.08
# Bug fixed in quotation marks inside format.php file (inconsistant " and ' marks)
==Bugs & Known Issues==
Please report bugs to Don Hinkelman (hinkel at sgu.ac.jp).  Known issues include:
#  Importing a project for a second time in the same location will overwrite the old project without warning--previous user data will be lost
#  Converting from a topic-format course will require some manual correction of links
#  After you import a new section into your course, you will be prompted to change the name of the directory.  It is best to have a unique directory name for each section (across a course), however, this is not always enforced strictly.
#  Backup and import icons may be confusing to teachers.  We are searching for new icons.
#  Easy to upload large numbers of files, no easy way to delete them. Be careful!
#  When moving a resource or activity within a course, from one project to another (using the up/down arrow icon, or the AJAX icon), the associated media files or resource file does not move into the new section directory
#  This approach to backup/import may duplicate media files many times within a site.  This is not a problem for a site with its own server and sufficient hard disk capacity.  However, for limited capacity sites (such as on a shared hosting server), this course format could cause you to reach your limit sooner than expected.  Use carefully.
#  No section delete function
==Acknowledgements==
* Design team:  Don Hinkelman and Andy Johnson
* Programming:  Akio Ohnishi and Tomonori Maruyama, version2 software
* Funding:  Sapporo Gakuin University, Japan
==Help Files==
1. English Help file "format/project/resourceupload.html":
'''Quick Resource Upload'''
This is a quick way to upload a resource file into a section of a course. It will automatically name the resource with the same name as the original file. It can also be used to bulk upload an unlimited number of resources. This can save numerous steps and encourage teachers to take the time to publish their documents, handouts, and lesson files. However, be careful when selecting what to upload, because bulk upload is so easy, but there is no bulk delete or undo function. Each new resource must be deleted one-by-one. Any resource created by this method can be edited in the normal way.
2. English Help file "format/project/cousefileupload.html"
'''Quick Course File Upload'''
This is a quick way to upload a batch of media files (audio, video, image, etc.) for any activity in your section/project. For example, if you want to create a quiz with many images and sound files, use this to locate, select, and upload those files. Click on the link, "Quick Course File Upload", and then select the files anywhere on your hard disk. Click "Select" and these files will be instantly uploaded into the Course Files area of your course administration. When you do a backup or import into another course, these files will be included. After moving, a new path to these files will be built in each activity that has links to these files.
3. English Help file "format/project/sectionbackuprestore.html"
'''Section Backup and Import'''
The first icon in this pair of icons (on the left) is for section backup. It will backup all the activities, resources and associated course files into one package. It does not backup any user data or user files. This is useful if you want to send or exchange a zip file to another site or another teacher on a different site. The second icon (on the right) is more important. It is an import icon. First, you have to know the location of a good section/project you want to import into your course. After you have got the location in another course, you normally will go to an empty section in your destination course and click on this. When you click on this, you will have to select the original course, and then you will select one of the sections of that course.
4. English Help file "format/project/directoryname.html"
'''Section Directory Name'''
In the Project Course Format, each section has its own folder. The folder is kept in Admin >> FIles of each course (not the Site Files). This folder holds the media files and resources that belong to the section (project/topic/theme). Initially, each section folder is named "section01"," section02"," section03" and so on. However, for moving and importing across the site, it is important that each folder have a unique name. You will be prompted to make a unique name.


[[Category:Contributed code]]
[[Category:Contributed code]]
[[Category:Course format]]
[[Category:Course format]]

Revision as of 06:24, 2 December 2009

  • Project Course Format 1.9 release 2 - 2008.07.03
  • Project Course Format 1.9 release 3 - 2008.12.31
  • Project Course Format 1.9 release 4 - 2009.02.19
  • Project Course Format 1.9 release 5 - 2009.11.30 (new: section delete feature added)

Purpose

This is an optional course format for handling projects and other learning units with a variety of activities. A course format changes the layout and operations of the main center column of a Moodle course. Inside a course, you can select the format of a course by clicking on Admin >> Course Settings. Typically, Topics format or Weekly format is used. This format is like Topics format, except that each section of a course can be "packaged" separately. It has a separate directory and it can be backed up separately with all resources and activities together. The import function allows a teacher to share and move the section (project) anywhere on the site. Fast resource creation and bulk media file upload are also possible. This format is ideal for creating an in-house repository of learning packages and promoting teacher-to-teacher sharing of materials. Note: for simply adding the "Quick Resource Creator" function, check the Modules and Plugins Database of moodle.org: http://moodle.org/mod/data/view.php?d=13&rid=2880 (Thanks to Mike Wilson).

Features

  • section directory
  • section backup
  • section import across site with auto-regeneration of media file links
  • section delete
  • quick resource creator
  • bulk file uploader

Status

This course format has been used since April 2008 in a full 1.9 production environment. Moving sections of courses has been increasingly more reliable, especially with quizzes which have a complicated set of categories and permissions. Since 2009, we have added the [Sharing Cart: https://docs.moodle.org/en/Sharing_Cart], which is a separate block for moving individual course items. We believe both the Project Course Format and Sharing Cart supports all standard modules plus some third party modules (Feedback, Project, Splitscreen). Let us know which modules work or do not work in your environment.

Download & Installation

To install: admin status needed, and use standard procedure for installing 3rd party plugins as follows.

  1. Unzip this package
  2. Place the "project" folder into the course/format/ folder of your Moodle 1.9 program files
  3. Go into a course where you have teacher or admin status. Click on "Course settings".
  4. Change the course format to "project".
  5. Turn "editing on" and you will see new icons appear.

Changelog

Changes contributed by Tomonori Maruyama 2009.11.30

  • section delete function added

Changes contributed by Akio Ohnishi and Tomonori Maruyama 2009.02.19

  1. new icons for resource upload and file upload

Changes contributed by Akio Ohnishi 2008.07.02

  • AJAX fixed when enabled on the site.

Changes contributed by Matt Gibson 2008.07.03

  1. Upload links are now labelled 'Upload file(s) and display them here' and 'Upload file(s) without displaying them yet' - still not ideal, but just a personal preference.
  2. All links/icons have tooltips to elaborate on the imperfect titles
  3. The divs containing those links will no longer overlap each other on smaller screens, whilst using long titles
  4. Help files for backup/restore and directory name were the wrong way around
  5. The directory naming help button was missing

Changes contributed by Matt Gibson 2008.07.08

  1. Bug in quotation marks inside format.php file (inconsistant " and ' marks)

Bugs & Known Issues

Please report bugs to Don Hinkelman (hinkel at sgu.ac.jp). Known issues include:

  1. Importing a project for a second time in the same location may overwrite the old project without warning--previous user data will be lost. We recommend backing up the section first and renaming the section folder.
  2. Converting from a topic-format course to a project format course should not require manual correction of links. If you experience this problem, please report the problem to us.
  3. After you import a new section into your course, you may be prompted to change the name of the directory. It is best to have a unique directory name for each section (across a course), however, this is not always enforced strictly.
  4. When moving a resource or activity within a course, from one project to another (using the up/down arrow icon, or the AJAX icon), the associated media files or resource file does not move into the new section directory
  5. This approach to backup/import may duplicate media files many times within a site. This is not a problem for a site with its own server and sufficient hard disk capacity. However, for limited capacity sites (such as on a shared hosting server), this course format could cause you to reach your limit sooner than expected. Use carefully.

Acknowledgements

Design team: Don Hinkelman and Andy Johnson (hinkel at sgu.ac.jp) Programming: Akio Ohnishi and Tomonori Maruyama, Version2 Web Development Funding: Sapporo Gakuin University, Japan

Help Files

1. English Help file "format/project/resourceupload.html": Quick Resource Upload This is a quick way to upload a resource file into a section of a course. It will automatically name the resource with the same name as the original file. It can also be used to bulk upload an unlimited number of resources. This can save numerous steps and encourage teachers to take the time to publish their documents, handouts, and lesson files. However, be careful when selecting what to upload, because bulk upload is so easy, but there is no bulk delete or undo function. Each new resource must be deleted one-by-one. Any resource created by this method can be edited in the normal way.

2. English Help file "format/project/cousefileupload.html" Quick Course File Upload This is a quick way to upload a batch of media files (audio, video, image, etc.) for any activity in your section/project. For example, if you want to create a quiz with many images and sound files, use this to locate, select, and upload those files. Click on the link, "Quick Course File Upload", and then select the files anywhere on your hard disk. Click "Select" and these files will be instantly uploaded into the Course Files area of your course administration. When you do a backup or import into another course, these files will be included. After moving, a new path to these files will be built in each activity that has links to these files.

3. English Help file "format/project/sectionbackuprestore.html" Section Backup and Import The first icon in this pair of icons (on the left) is for section backup. It will backup all the activities, resources and associated course files into one package. It does not backup any user data or user files. This is useful if you want to send or exchange a zip file to another site or another teacher on a different site. The second icon (on the right) is more important. It is an import icon. First, you have to know the location of a good section/project you want to import into your course. After you have got the location in another course, you normally will go to an empty section in your destination course and click on this. When you click on this, you will have to select the original course, and then you will select one of the sections of that course.

4. Help file "format/project/directoryname.html" Section Directory Name In the Project Course Format, each section has its own folder. The folder is kept in Admin >> FIles of each course (not the Site Files). This folder holds the media files and resources that belong to the section (project/topic/theme). Initially, each section folder is named "section01"," section02"," section03" and so on. However, for moving and importing across the site, it is important that each folder have a unique name. You will be prompted to make a unique name.