Nintendo Wii forums Forum for writers phpBB mods Essays on copyright Dating advice Narnia forums
phpBB Podcast

Overview
Features
Requirements
License
Installation
Upgrading
Troubleshooting
Changelog
Feedback
Logo

Overview

This is phpBB Podcast, version 0.9.1, released March 15, 2005.  Copyright © 2005 by Tony Boyd.

This adds a podcast field to the phpBB new topic page.  Podcasting is used to distribute audio in blogs. "But phpBB isn't a blog" you might say. Well, with the phpBB Blog mod, it is.

There are 2 major ways to use this product.  You'll have to decide which one you want to pursue.  First, there is the Normal Install, which is for anyone installing from scratch. Second, there is the Upgrade from 0.9.0 to 0.9.1, which is only for the 10 people who already installed the previous version. :)

Features

All this does is add a file upload field – labelled "Podcast" – to the New Topic screen (and the Edit Post screen, but only if it's the post that started the topic). It has a small bit of security – it will only allow podcast files to be uploaded by members of the podcasters group. However, once the files are uploaded, you should expect that anyone can hear the file.

Requirements

PHP 4.1.0 or greater.  A working phpBB 2 installation is needed.  While this doesn't require phpBB Blog, phpBB Blog is the only mod that will actually do anything with the podcast files (it displays them on its blog page).

License

My code is licensed to you under a GPL license, which should have been included with all these files.  The general summary of the GPL license is that you can use my code for free, even in a commerical business.  And you can modify my code.  But you must keep the license, keep the attribution, and any changes you sell or give away must also be GPL.  It is not public domain.  Do not remove license.txt.

Installation

  1. Set up a group called "podcasters" (in your phpBB admin page).
  2. Create a new directory called "podcast" at the top level of your phpBB directory. This means at the same level as the includes, language, and admin directories.
  3. Open the file podcast_install.txt and follow the directions.
  4. Although podcast_install.txt only outlines how to change the subSilver template, you can also easily update all your other template directories. First, repeat the changes to posting_body.tpl for each template directory. Second, put a copy of posting_podcast.tpl in each template directory.
  5. Using a Web browser, go to your forums and create a new topic. Add a title and some text. Near the bottom of the page, note the podcasting field (if it isn't there, head to the first Troubleshooting topic). Add a tiny MP3 file (preferably under 100K) and submit the form.
  6. If the page returns an error, head to the second Troubleshooting topic.
  7. Connect to your server via FTP or Telnet and get into the podcast folder. Do you see a MP3 file in there? If so, head to the next step. If not, head to the third Troubleshooting topic.
  8. Using a Web browser again, go to your forums and create another new topic. Add a title and some text. Add a MP3 file that is at least 2100K in size and submit the form.
  9. If the page returns an error, head to the fourth Troubleshooting topic. If it doesn't return any errors, then you're done. It works.

Upgrading 0.9.0 to 0.9.1

  1. Open the file podcast_upgrade_0.9.0_to_0.9.1.txt and follow the directions.
  2. Using a Web browser, go to your forums and create a new topic. Add a title and some text. Near the bottom of the page, note the podcasting field (if it isn't there, head to the first Troubleshooting topic). Add a tiny MP3 file (preferably under 100K) and submit the form.
  3. If the page returns an error, head to the second Troubleshooting topic.
  4. Connect to your server via FTP or Telnet and get into the podcast folder. Do you see a MP3 file in there? If so, head to the next step. If not, head to the third Troubleshooting topic.
  5. Using a Web browser again, go to your forums and create another new topic. Add a title and some text. Add a MP3 file that is at least 2100K in size and submit the form.
  6. If the page returns an error, head to the fourth Troubleshooting topic. If it doesn't return any errors, then you're done. It works.

Troubleshooting

Why isn't the podcast field appearing on my New Topic page?
Groups. You need to be sure you added a podcasters group to phpBB. If you did and it's still not showing up, then odds are good you logged in as a person that is NOT in the podcasters group. Go back to the groups admin page and add your account to the podcasters group.
How do I fix this error about directory permissions?
Set permissions on the podcast folder to allow write access by your server or PHP engine. With FileZilla, you can right-click the podcast directory, select permissions, and click to add write access. With a command-line Unix or Linux, you can cd into the phpBB directory and issue the command:
chmod 777 podcast
Why is the podcast folder empty, even after I added a small podcast file?
PHP has a flag called "file_uploads" that is probably set to off. Open the php.ini and change it. If you are not the admin of your server, tell the admin that you need it enabled.
Why are my large podcast files not appearing in my podcast folder?
PHP has 3 settings that can upset your ability to upload big files. These are: upload_max_filesize, post_max_size, and max_execution_time. Open your php.ini and set upload_max_filesize to a large number, such as 25MB. Then set post_max_size to be slightly bigger, such as 26MB. That will allow people to send in fairly large files. If you need it bigger, go for it. Finally, set max_execution_time to something large but not insane, such as 600 seconds. This instructs PHP to wait for up to 10 minutes for a file to upload. Make it bigger if you need it. If you are not the admin of your server, tell the admin to make these changes for you.

Changelog

CHANGES FROM 0.9.0 TO 0.9.1
  • Added enctype so that the form properly captures file uploads.
  • Flipped a chunk of code in functions_post.php, it was out of order.

Feedback

Please note that no support is provided by the developer.  However, there is a community-based forum for discussion.  If you have questions, bug reports, code improvements to share, feedback, and/or feature requests, go here:

http://www.outshine.com/forums/

phpBB Podcast logo

The phpBB Podcast logo is copyright 2004 by Anthony Boyd. It may not be used for other purposes. It represents the phpBB Podcast product and is not licensed to be used as a generic podcasting image.