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

Ipodcast module

From MoodleDocs
Revision as of 15:07, 15 February 2008 by Helen Foster (talk | contribs) (cat edit)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Installation Instructions

  1. Copy the ipodcast folder to your mod directory.
  2. Copy the ipodcast.php from the moodle/mod/ipodcast/lang/en/ to your moodle/lang/en directory.
  3. Copy the ipodcast folder from moodle/mod/ipodcast/lang/en/ to moodle/lang/en/help/
  4. Go to your administration and install module and make sure all succeeds

Apache

Make sure to AllowOverride All(or enough to get "AddType" to function) on /mod/ipodcast folder.

Apache will need to have .htaccess override allowed for the ipodcast module directory. The module directory contains a premade .htaccess to allow scripts to run with media extensions ie. .mp3 , .mov, .mp4, .m4v . iTunes will only download files with these extensions. The folder contains a .htaccess file which allows files with media extentions to execute as php files. This fools iTunes into downloading the media file

To do this edit your httpd.conf file to include something like:

<Directory "/your_path_here/moodle/mod/ipodcast">
AllowOverride All
</Directory>

and then restart apache.


Apache Note for ISP users.

Because most ISP's will not allow you to modify the httpd.conf. Add the extensions in the /mod/ipodcast/.htaccess in the Apache handler area. Addtionally modifying the .htaccess file didn't seem to work. However adding the extensions supplied in the .htaccess file in the Apache Handler area of the ISP supplied control panel worked fine.

Example:(one extension line in the /mod/ipodcast/.htaccess file)

AddType application/x-httpd-php .pdf


In ISP supplied control panel find the appache handler icon. Open it up put the extension in the first box like "pdf" then put "application/x-httpd-php" in the next box and click add. The additions you make should be reflected there in the control panel for you to see. There are seven or eight extensions in the /mod/ipodcast/.htaccess file add all of them one at a time.

IIS

Go to IIS Manager and fan down to the moodle/mod/ipodcast directory in the left pane. Right click on the ipodcast directory and open properties. Click on the Directory tab and in the bottom section click on the Create button then click on the Configuration button. It should inherit the setting from the root setup. Find the .php line and write down the executable path to the CGI. Then click the Add button and add the same executable path to the media extensions one add for each " .mp3, .m4v, .mov , .mp4" Apply then click ok all the way out.

You should have a working setup here.

To this point has only been tested with Windows and mysql other OS's are untested. Also English is the only language file.

Using the Module

Setting up the Course Podcast

The next step is to hit the ipodcast module settings and make sure you want the iTunes tag support. By default the mysql.sql file enables these options. If you delete the module and try and reload it those two entries will cause a key duplicate error in v.18 the next rev fixes that issue. You will need to delete those records in the config table in order to install a second time.

Now go into a course you are a teacher or admin for and turn editing on.

Add an Activity and Podcast should now be in the list. When you select it you should get the message "iPodcast settings have not been set for this Course. Set here before continuing"

This is the first time per course setting for the podcast. It will load some default settings from the course.

Check over and hit "Save Course Settings" . The header should now read "Updating iPodcast settings for Course {coursename}" .

Select done to get back to the course outline.

Adding a Podcast

Now add a podcast activity again for whatever section you want.

Update the name summary and notes to your preference and hit the save button. You should see a tabbed window with a few options.

  • View Podcast tab views it as a student would see the page.
  • Comments tab views the student comments on the podcast
  • Views tab shows who has viewed the media file and when.
  • Edit Podcast tab edits the Name, Summary, and notes of the podcast
  • iTunes Tags tab edits all the iTunes specific information
  • Attachment tab loads and selects the media file.
  • Visibility tab selects both the current or scheduled visibility for the podcast.

By default the iTunes tags are set from the Course settings for the podcast. No Attachment and visibility is set to hidden.

To select a media file hit the Attachment tag and select the Change... button then select Upload a file button.

You should get another window with a Browse... button select it and an open window should appear. Find the media file and select it. Remember only "mp3,mov,m4v, and mp4" files are supported. After selecting the file click Upload this file you should have a directory listing with that file listed.

Choose select from the action column and the line should go grey and the action will display "Currently Selected" .

Choose Close this window button to take you back to the Podcast.

The Attachment window will not update unless the browser is refreshed(on the list to fix).

Now change the current visibility to "Podcast visible to students" click save and the podcast entry is ready.

Subscribing

To subscribe to the podcast click on "Podcasts" under activities for the course. Its on the upper left side on my moodle. This should bring up a list of published podcasts, probably just one if you were following this from scratch. In the upper right corner should be a rss iPodcast button right click and copy shortcut or link. Now paste that shortcut into the iTunes subscribe to ipodcast window.

If all is well you should have the podcast.

The rss xml feed is built when the link is called so you don't have to wait for cron after adding a podcast activity.

Release notes

v.24

02/19/06 Tom Dolsky - Repaired make directory function
02/19/06 Tom Dolsky - Added embedded media player
02/19/06 Tom Dolsky - Added usemediafilter module setting.
02/19/06 Tom Dolsky - Fixed quotes causing error on module settings page.
02/19/06 Tom Dolsky - Added media filter settings text.
02/19/06 Tom Dolsky - Moved all needed rsslib functions to this file ipodcast should now work without replacing lib/rsslib.php

v.23

02/07/06 Tom Dolsky - Ran the feed through feed validator and made several necassary changes
02/07/06 Tom Dolsky - Keywords now separated by commas - it will replace all the spaces eith commas on upgrade, also make sure to copy the new language file over it has the space comma verbage changed
02/06/06 Tom Dolsky - Added a subscribe link for a on click itunes subscribe

v.22

02/05/06 Tom Dolsky - Fixed Edit button from course view causing error

v.21

Darren Smith's Database fix hopefully
Blank upload popup fix
delete podcast if its an external reference would fail - fixed now

v.20

uploadpopup now refreshes parent window
fixed duration tag not being included in rss feed
backuplib.php now backs up podcasts,podcast course settings, podcast views, and podcast comments
deleting podcast deletes the media file
The attachment edit box can have an external url typed in it. only links that start with "http://" or "https://" currently, and the length field will be empty

v.19

fixed the deleting and reinstalling module bug

To Do

  • rewrite mp3lib.php to support id3v2.x with pictures
  • Add hours to calculate_length() in lib/mp3lib.php
  • Write id3tag information into mp3
  • write mpeg4lib.php for video podcasting need to use ffmpeg for this
  • need to have external url support - started needs a bunch of cleanup
  • Finish help buttons and help text
  • Backuplib.php is built but tested very little
  • Restore is non-functional

Report a Bug

Please report any bugs or feature requests to tomtek AT cytekmedia DOT com

The podcast module is Copyright, Thomas E. Dolsky Cytek Media Systems, Inc.

See also