Podcasting Plugin

This plugin allows the creation of Podcasting feeds based on Confluence pages and news items.

Name Podcasting Plugin
Vendor Adaptavist.com Ltd (Website)
Authors Dan Hardiker, David Peterson
Homepage http://confluence.atlassian.com/display/CONFEXT/Podcasting+Plugin
Issue Management n/a
Categories Content Macros
Version 1.2
Availability Confluence v2.3 to v2.9-m2-r2
State Stable
License Freeware / Open Source (BSD)
Price Free
Release Docs http://confluence.atlassian.com/display/CONFEXT/Podcasting+Plugin
Java API Docs n/a
Download Source http://svn.atlassian.com/svn/public/contrib/confluence/adaptavist-podcast-plugin/tags/1.2
Download JAR adaptavist-podcast-plugin-1.2.jar
This plugin can be installed and updated via the Confluence Repository Client.

Description/Features

Channels

The first step is to create a podcast channel. You can have one or more channel, usually differentiated by the labels they require or disallow. For example, you can have a general 'all episodes' channel which has no requirements, or you can have a 'Rock' channel which requires the episode to have the 'rock' label.

To set up a channel, do the following:

  1. Select a space and click 'Browse Space'.
  2. Select the 'Podcasts' tab.
  3. Click 'Create Channel'.
  4. Fill in the details.

The trickiest setting is the 'Labels' field. Here, you can require or exclude episodes based on their labels. Some examples:

  • "foo bar": Allow either 'foo' or 'bar' labeled episodes.
  • "+foo +bar": Allow only episodes with both 'foo' and 'bar'.
  • "+foo -bar": Allow only episodes with 'foo' and without 'bar'.

Episodes.

A channel is populated with episodes. A podcast episode requires two ingredients:

  1. The 'podcast' label.
  2. An attached audio file which has been selected as the podcast for this episode.

These can both be set manually (ie. add the 'podcast' label yourself, then upload an MP3 file), or via the 'Podcast' tab on each page. If you can't find the 'Podcast' tab on a page, you probably need to create a channel first (see above).

If you want to modify or check the episode is set up correctly, try the following:

  1. Navigate to your page/news item
  2. Select the "Podcast" tab.
  3. Check the 'podcast health' section. Follow any instructions.
  4. Choose the mp3 attachment from the select box.
  5. Save the Podcast episode.

Usage

Advertising

Once you've set up your channels and episodes, you need to advertise their existence and subscribe from your favourite podcast player.

You can easily list the channels in a space with the following:

{podcast-channels}

If you'd like to list the available episodes, try this:

{podcast-channels:episodes=true}

Subscribing

Once you have your channels advertised, you need to subscribe in your podcast player:

  1. Right-click on the channel icon or title and copy the link location.
  2. Paste the address into your podcast player.

That's it! Now you just have to keep adding new content for all your ever-demanding fans.

Version History

Version Date State License Price
Show description 1.2 (#3) 24 Apr 2007 Stable Freeware / Open Source (BSD) Free

Release Notes
The inital public release.

Contributors

Screenshots

Screenshots
(view as slideshow)
   
   
 

Labels

 
  1. Apr 26, 2007

    James Hines says:

    I'm having difficulty getting this to work.  Specifically, iTunes does not ...

    I'm having difficulty getting this to work.  Specifically, iTunes does not seem to recognize the URL to my

    podcast.  This is what that URL looks like.  Is this correct the correct format?

    (http://wiki.seagate.com:8081/podcast/feed/rss.action?key=Test&channel.id=DKY5HAPA5HIV)

    1. Apr 26, 2007

      Dan Hardiker says:

      If you go to that URL in your browser, does it give you an RSS feed?

      If you go to that URL in your browser, does it give you an RSS feed?

      1. Apr 26, 2007

        James Hines says:

        Yes, it does.

        Yes, it does.

        1. Apr 29, 2007

          David Peterson says:

          It's possible that the 'Test' space you're using is not accessible to anonymous ...

          It's possible that the 'Test' space you're using is not accessible to anonymous users. I haven't actually tried testing iTunes compatibility if the space being accessed is secured.

          1. Apr 30, 2007

            James Hines says:

            Yes, that was the issue.  Thanks for the help.

            Yes, that was the issue.  Thanks for the help.

          2. Jun 25, 2007

            Nate Oster says:

            Was there a workaround for this?  All of our spaces are internal, but we'd ...

            Was there a workaround for this?  All of our spaces are internal, but we'd still like to have podcasts within the company. 

            I suppose we could always append a userid and password to the URL, but I'd rather not.

  2. Aug 03, 2007

    James Hines says:

    I recently upgraded iTunes to version 7.3.2.6 ( from 7.0something) and now I can...

    I recently upgraded iTunes to version 7.3.2.6 ( from 7.0-something) and now I can no longer download the podcast episodes that I am hosting on Confluence (2.5.4) with the podcasting plugin.  Is anyone having similar trouble?

    1. Aug 28, 2007

      Paul Carruthers says:

      Yup. I'm on iTunes 7.3.2 as well and cannot download the files. Similarly, in my...

      Yup. I'm on iTunes 7.3.2 as well and cannot download the files. Similarly, in my RSS aggregator the message comes back as cannot find files.

      Tried with all permissions set for anonymous users and still no joy.

      Also, tried to find an issue tracker for this plugin on Adaptavist site with no luck. Is there one?

      Great plugin, but having external access is critical for it to be really useful.

      -pc.

  3. Dec 18, 2007

    Torge Schmidt says:

    The podcast channel and episodes can be seen by the podcast receiver, but the mp...

    The podcast channel and episodes can be seen by the podcast receiver, but the mp3 can't be downloaded. Also, the information page about the podcast does not open, but references a non-existent URL.

    It appears, that the item (and info) URL the plugin creates is not correct:

    http://HOST:PORT/confluence/confluence/download/attachments/6947208/1dfre011103-excerpt.mp3

    instead of

    http://HOST:PORT/confluence/download/attachments/6947208/1dfre011103-excerpt.mp3

    There is one "confluence/" too much in the path! The "information" page about the audio file has the same issue.

    1. Mar 05

      Rick Hadsall says:

      Torge, We have the same problem. Our file URLs have an additional /confluence/ ...

      Torge,

      We have the same problem. Our file URLs have an additional /confluence/ in it. I think there might be hard coding in the plugin rather than a read to the general configuration that discusses the context root.

      David - I also second the question about whether we can keep Anonymous access off but still podcast. Is there some way to use an alternate directory that would be serviceable to anonymous users off the regular url path?

      Rick

  4. Feb 29

    neeraj says:

    Hi I am Trying the Podcasting .. I did the step succesfully upto creating and s...

    Hi
    I am Trying the Podcasting .. I did the step succesfully upto creating and subscribing the RSS Feed . ok

    1. if i click show All Items in that Feeds there is no any items .
    2. now i have Link

    http://ipaddress:9090/projectname/podcast/feed/rss.action?key=KMSDev&channel.id=T1ZFPHVGCAJ8
    I dont have any Idea what to to with that link

    I tried to paste in Itune Player , i got trouble . Plsss help me what to do with this link

    write next Steps

    1. Feb 29

      David Peterson says:

      The most common problem people have is that the space the podcast belongs to is ...

      The most common problem people have is that the space the podcast belongs to is not acessible by anonymous users.

      Alternately, there may be an error in your feed, or in your actual podcast pages. Have you confirmed that each of your podcast pages is a valid podcast?

      1. Mar 03

        neeraj says:

        Thanks David :) Ya, every PodCast is a Valid podcast . every thing is Fine(even...

        Thanks David

        Ya, every PodCast is a Valid podcast . every thing is Fine(even anonymous user have persmission to access )I am trying to paste the Above url in Podcast player(I-TUNE). problem is still there

        can u write again clear and without Doubt, Steps how to USE this Important Plugin

        thanks David

  5. Mar 02

    Rick Hadsall says:

    We installed this plugin today.  We added a podcast, created a channel in t...

    We installed this plugin today.  We added a podcast, created a channel in the space.  Once I added the channel's label to the page that had the podcast and refreshed the page, the log just dumped the longest stack trace in the history of Java, and now the page isn't visible - gives a Confluence error.

    Here's the stack trace:

    2008-03-02 22:00:16,835 ERROR [TP-Processor12] [confluence.util.velocity.VelocityUtils] getRenderedTemplate Error occurred rendering template: /templates/podcast/channel/macro.vm
    – url: /confluence/display/ILIIntegration/ServiceDesignPrinciples | userName: x033124 | action: viewpage | page: 7045931
    org.apache.velocity.exception.MethodInvocationException: Invocation of method 'renderPodcastEpisodeDescription' in class com.adaptavist.confluence.podcast.PodcastManager threw exception class java.lang.NoClassDefFoundError : Could not initialize class org.w3c.tidy.AttributeTable
    at org.apache.velocity.runtime.parser.node.ASTMethod.execute(ASTMethod.java:309)

    ...
    caused by:
    java.lang.NoClassDefFoundError: Could not initialize class org.w3c.tidy.AttributeTable
    at org.w3c.tidy.Lexer.parseAttrs(Lexer.java:3650)
    ...

    2008-03-02 22:00:16,854 ERROR [TP-Processor12] [confluence.util.velocity.VelocityUtils] getRenderedTemplate Error occurred rendering template: /templates/podcast/channel/macro.vm
    – url: /confluence/display/ILIIntegration/ServiceDesignPrinciples | userName: x033124 | action: viewpage | page: 7045931
    org.apache.velocity.exception.MethodInvocationException: Invocation of method 'renderPodcastEpisodeDescription' in class com.adaptavist.confluence.podcast.PodcastManager threw exception class java.lang.NoClassDefFoundError : Could not initialize class org.w3c.tidy.AttributeTable
    at org.apache.velocity.runtime.parser.node.ASTMethod.execute(ASTMethod.java:309)
    ...
    2008-03-02 22:00:16,854 ERROR [TP-Processor12] [confluence.util.velocity.VelocityUtils] getRenderedTemplate Error occurred rendering template: /templates/podcast/channel/macro.vm
    – url: /confluence/display/ILIIntegration/ServiceDesignPrinciples | userName: x033124 | action: viewpage | page: 7045931
    org.apache.velocity.exception.MethodInvocationException: Invocation of method 'renderPodcastEpisodeDescription' in class com.adaptavist.confluence.podcast.PodcastManager threw exception class java.lang.NoClassDefFoundError : Could not initialize class org.w3c.tidy.AttributeTable
    at org.apache.velocity.runtime.parser.node.ASTMethod.execute(ASTMethod.java:309)

    This is Confluence 2.7.1 and the latest version of this plugin.

    Rick

    1. Mar 05

      Rick Hadsall says:

      Nevermind, it went away on its own. That org.w3c.tidy issue was crashing export ...

      Nevermind, it went away on its own. That org.w3c.tidy issue was crashing export space at the same time as podcasting.. odd.

  6. Mar 26

    Jes Deamer says:

    Is there an easy way add an additional file format? We used enhanced AAC (m4a) a...

    Is there an easy way add an additional file format? We used enhanced AAC (m4a) and have been unsuccessful in adding these as episodes.