-
Notifications
You must be signed in to change notification settings - Fork 1
/
podcast.plugin.xml
executable file
·111 lines (109 loc) · 11.4 KB
/
podcast.plugin.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
<?xml version="1.0" encoding="utf-8" ?>
<pluggable type="plugin">
<name>Podcast</name>
<version>1.3</version>
<guid>DA241F86-AA81-11DD-B868-811556D89593</guid>
<copyright>2008-2013</copyright>
<license url="http://www.apache.org/licenses/LICENSE-2.0.html">Apache Software License 2.0</license>
<author url="http://habariproject.org/">The Habari Community</author>
<url>http://habariproject.org/</url>
<description><![CDATA[Provides podcasting functionality and iTunes compatibility.]]></description>
<provides>
<feature url="http://wiki.habariproject.org/en/Feature/podcast">podcast</feature>
</provides>
<help>
<value><![CDATA[
<p><strong>If you are upgrading your Podcast plugin, it is recommended that you deactivate, then reactivate the plugin to set new default values. All your current feed settings will be preserved.</strong></p>
<h3>Usage</h3>
<h4>General</h4>
<p>When Podcast is activated, it creates a new content type called, naturally enough, podcast. You will see a new menu item under the admin menu's 'New' submenu to create podcast posts, and a new menu item under the 'Manage' submenu to manage podcast posts.</p>
<p>Podcast has three main screens for configuration. Two of these, 'Manage Feeds' and 'Edit feed' are located on the plugins page of the admin area and are used to manage and edit your podcast feeds. The third is located on the post publish page and is reached by clicking the 'Enclosures' tab under the tags area when you are creating or editing a podcast post.</p>
<h4>Manage Feeds</h4>
<p>Podcast is able to create and maintain as many feeds as you wish, a capability you may know as category casting. To create or delete a podcast feed use this configuration form.</p>
<ol>
<li>Navigate to the Plugins page of the admin area.</li>
<li>Select 'Manage Feeds' from the Podcast dropdown menu. The feed management form will open up. To create a new feed
<ol>
<li>type in the feed's name in the top edit box</li>
<li>select the feed type from the next select box</li>
<li>click the 'Save' button. Currently iTunes is the only feed type available.</li>
</ol>
To delete a feed you no longer want
<ol>
<li>uncheck the feed you want to delete at the bottom of the form.</li>
</li>click the 'Save' button.</li>
</ol>
</li>
</ol>
<h4>Edit feed</h4>
<p>Once you have created a feed, a new option will be added to the Podcast plugin's dropdown menu, 'Edit name_of_feed feed'. There will be a menu item added for each feed you create. Several items are required. Their labels have an asterisk ( * ) at the end. Without filling in these items, your changes will not be saved. To edit a feed's options</p>
<ol>
<li>Navigate to the Plugins page of the admin area.</li>
<li>Select 'Edit name_of_feed feed' from the Podcast dropdown menu. A configuration form for the selected feed will open up. The options in the form will relate to the type of feed you are creating. For now, this means iTunes feed options. For iTunes the following options are available:
<ol>
<li>Podcast Author - defaults to the current user's display name</li>
<li>Podcast Subtitle - defaults to the blog's tagline</li>
<li>Podcast Summary = defaults to the blog's tagline</li>
<li>Podcast Owner Name - defaults to the current user's display name</li>
<li>Podcast Owner Email = defaults to the current user's email</li>
<li>Content Rating - defaults to 'No Rating'.</li>
<li>Podcast Artwork URL - enter the url for the artwork to supply to iTunes. These needs to be an image no larger than 300 x 300 pixels</li>
<li>Podcast Category - Choose the appropriate categories from the select boxes. You need to select at least one, and can have up to three</li>
<li>Block Podcast - defaults to unchecked. Do not check this unless you want to block your podcast from iTunes</li>
<li>New podcast url - if you move your feed to a new url, you need to notify iTunes. do so by entering the new url in this field</li>
</ol>
</li>
</ol>
<p>When you are done making the changes you desire, click the \'Save\' button. A message will pop up in the messages area of the admin to notify you when you have successfully edited the feed options.</p>
<h4>Creating and Editing a Podcast Post</h4>
<p>After you have the feed set up, you are ready to begin creating posts for your podcast. To do so select New->Podcast from the admin's main menu. You will be taken to a publish page that, for the most part, is like a normal entry's publish page. Write a post as you normally would, complete with title, content, and tags, then you'll be ready to add the podcast specific items. If you have uploaded you audio files to a directory accessible to the Habari media silo, you'll find your work is much easier.</p>
<p>1. Click on the location in your post where you want the podcast player to appear, then open the Habari silo and navigate to the directory containing your audio file. While audio files currently don't have an associated icon, you'll see their title's listed, and will note that underneath each a menu item has been added that says 'add to name_of_feed'. Click the 'add to ..' item to insert a link to the file in your post where you last had the cursor. The link added will have the format</p>
<p><a href=\"http://url/path/to/file/filename.mp3\" rel=\"enclosure\"<filename.mp3</a>>/p>
<p>Note: There are two important points here. First, the link must have the rel=\"enclosure\" attribute. The Podcast plugin relies on this when determining what links to replace with a player. Second, if your audio files are hosted externally, you won't be able to use the silo and will have to enter this link by hand.</p>
<p>If you have more than one feed, you can use a post in as many of them as you like. You can either add the same audio file for each feed, or add more than one audio file to the post in the position you desire, with whichever feeds you want. Having more than one audio file in a post won't interfere with the individual feeds. Each will contain only the appropriate audio file. However, in the post as viewed on your blog, a player will appear for each feed and each file. Please note that the last link entered for each feed from the Habari silo in this manner will be the only one to be added to the actual podcast feed.</p>
<p>2. Click the 'Enclosures' tab underneath the tags area. A form will open containing the options for the player display settings and for each indivdual feed that you have created for your site, one set of feed options after the other. For the display settings the options include
<ul>
<li>Show player instead of link - Checked by default. Uncheck to not show a player for the podcast in your post. Instead, a link to download the podcast will be shown.</li>
<li>Show download link under player - Uncheck to not show a download link for the podcast if a player is shown for it.</li>
</ul>
For iTunes feeds the settings include
<ul>
<li>Podcast Enclosure - this is the name of the audio file you are using for the feed. If you placed the file in the post with the Habari silo, this will have been automatically filled in for you. If not, enter it manually, being sure to enter a fully qualified url. This is the only required item.</li>
<li>Subtitle - if you want the post to have a subtitle, enter it here</li>
<li>Content Rating - this defaults to 'No Rating'. use this setting to override the feed rating for that particular post</li>
<li>Summary - if you wish to have a summary for the post, enter it here</li>
<li>Block - if you wish to block a particular post from iTunes, check this item</li>
</ul>
</p>
<p>If the post is being added to more than one feed, continue on to make desired changes for each feed. After you are completely done, click the 'Save' button to save the post as a draft or to save any changes to an already published post, or click the 'Publish' button to publish the post. When you do so, the Podcast plugin will add any tags for the post to its iTunes keywords, calculate the length of the audio file for each feed, and calculate the running time for each audio file. These calculations can cause Podcast posts to take a little longer to save than regular entries, especially if the audio files are hosted on an external server.</p>
<p>Note: If you haven't set up a feed, there will be no links in the Habari media silo to insert a podcast into a post. Nor will there be any controls under the Enclosures tab to set information regarding the podcast's enclosures. There will only appear text directing you to create a feed.</p>
<h4>Accessing Podcasts From Your Site</h4>
<p>The Podcast plugin makes several changes to your blog
<ul>
<li><b>Home page</b> - Podcast posts show up on your home page intermixed with regular entries.</li>
<li><b>Multiple post archives</b> - Podcast posts show up in your tag urls intermixed with regular entries.</li>
<li><b>Podcast urls</b> - Podcasts are accessible by using an archive url of the form http://yoursite.com/podcast/name_of_podcast. This will contain only posts that have been assigned to the named podcast.</li>
<li><b>Feed urls</b> - Podcast feeds are accessible by using a url of the form http://yoursite.com/podcast/name_of_podcast/rss for an RSS-2 feed. The feed will contain only feed item versions of posts that have been assigned to the named podcast.</li>
</ul>
</p>
<h4>Podcast Templates</h4>
<p>Podcast comes with four templates one each for an individual podcast post and for multiple podcast post pages, for both the rawphpengine and the hiengine. These will probably not fit with the theme of your blog, so it is recommended that you copy them to your theme directory and modify them as needed.</p>
<h4>The Players</h4>
<p>Podcast provides two flash players, the nifty player and the slim version of the xspf player, as well as allowing you the option of using the Html 5 player that modern browsers have built in. It uses the chosen player to enable playing podcast audio files on your site. When a podcast post is viewed, the plugin searches it's content and replaces all links with the rel=\"enclosure\" attribute with a player and a link to download the file. Thus, if you have multiple audio file links in the post, a separate player will be embedded for each of them.</p>
<p>To configure the flash players
<ol>
<li>Select 'Configure Players' from Podcast's droplist on the plugin page of the admin area.</li>
<li>Choose which player you wish to use. The default is the niftyplayer.</li>
<li>Set the options for the selected player. For both players you can set the height and width. The default values are reasonable for most sites. For the niftyplayer you can set the background color to more closely match your site using hex RGB colors. A hex RGB color consists of 6 digits. The left two denote the degree of red, the middle two the degree of green, and the right two the degree of blue. Each digit is a hexadecimal numeral from 0 - F. The default results in a white background.</li>
</ol>
</p>
<p>There is no configuration for the Html 5 player. However, many browsers under Linux are not able to natively play mp3 files through the Html 5 player, so you will also need to provide an ogg audio file. These are easiest to obtain by using a program such as OggConvert to create the ogg file from the mp3. It will retain the same name as your mp3, but with the 'ogg' extension. Upload it to the same directory in which you have your mp3 files, and Podcast will take care of the rest.</p>
<h4>Uninstallation</h4>
<ol>
<li>Got to the plugins page of your Habari admin panel.</li>
<li>Click on the Deactivate button.</li>
<li>Delete the Podcast directory from your user/plugins directory.</li>
</ol>
]]></value>
</help>
</pluggable>