Utilisation du plugin podcast

Présentation

Ce plugin permet au podcaster (vous) de gérer vos fichiers audio video doc mis à disposition des internautes et de générer votre podcast (le fil de syndication RSS 2.0).

Champs

Changing your feed URL
This tag allows you to change the URL where the podcast feed is located. Enter the new URL:

http://new_location/podcast.xml

After adding the tag to your old feed, you should maintain the old feed for 48 hours before retiring it. At that point, iTunes will have updated the directory with the new feed URL. For more information, please see the Changing Your Feed URL section.
Time to live
The ttl tag stands for “time-to-live”. It is an optional integer value that controls how many minutes iTunes will wait between checking for changes in a podcast. If no time-to-live is set on the podcast, the updater job assumes a time-to-live of 24 hours.
Titre
Ce champ requis contient le titre de l'item (l'épisode, le fichier audio, video, doc).
Description
Ce champ requis contient la description de l'item. Ce champ est affiché par les agrégateurs. Moins de 255 caractères.

Les balises HTML, les blancs en-tête et en queue, les caractères excédentaires sont supprimés.
Informations (iTunes)
Ce champ optionnel contient les informations concernant l'épisode. C'est ce qui est affiché lorsque l'on clique sur le i cerclé en fin de ligne. Moins de 4000 caractères.

Les balises HTML, les blancs en-tête et en queue, les caractères excédentaires sont supprimés.
Description (url)
Ce champ actif en mode automatique contient l'adresse du billet associé à l'item.

Le bouton Faire le billet crée un nouveau billet avec les données du formulaire et met à jour ce champ. Il y a création d'un nouveau billet à chaque clic ; supprimer les billets superflus.

Le bouton Amener le billet remplace les valeurs de champs du formulaire par les données du billet référencé dans ce champ. On met dans ce champ soit l'id (un numérique, ex.: 42) soit le lien permanent du billet.
Si une enclosure de podcast est trouvée dans le billet référencé dans ce champ
<a href="http://...demo.mp3" rel="enclosure">podcast</a>
le fichier correspondant à la 1ère enclosure trouvée dans le billet remplace la valeur du champ Fichier audio, video, doc

On peut aussi mettre l'adresse de la page décrivant l'item. Peut remplacer la description longue.
Commentaires (url)
Ce champ contient l'adresse du billet permettant l'ajout de commentaires ; ou l'adresse d'une page de contact. Il permet à l'auditeur de donner son avis concernant l'item.

Cette balise <comments> n'est pas toujours bien comprise. On mettra si possible l'adresse du billet à commenter dans Description (url).
Creative Commons Licence (url)
Licence Creative Commons qui s'applique à l'item. Voir Creative Commons Licenses.
Creative Commons Licence du fil RSS (url)
Licence Creative Commons qui s'applique au fil RSS. Voir Creative Commons Licenses.
Creative Commons Licence de l'item (url)
Valeur par défaut de la licence Creative Commons pour les items. Voir Creative Commons Licenses.
Fichier audio video doc
Ce champ actif en mode automatique contient l'adresse du fichier audio video doc.

On peut entrer le nom du fichier seul (ex. : demo.mp3) ; les champs longueur type guid seront alors automatiquement renseignés et le nom du fichier sera remplaçé par l'URL adéquat, lorsque l'on cliquera sur Ajouter (et si le fichier est dans share/audio).

On peut entrer une adresse relative à la racine du blog (ex. : music/demo.mp3), sans / initial, pour générer http://www.site.com/blog/music/demo.mp3.

On peut entrer une adresse relative à la racine du site (ex. : /podcast/demo.mp3), avec / initial, pour générer http://www.site.com/podcast/demo.mp3.

On peut entrer une adress URL complète, notamment pour les références de fichier audio, video, doc d'un autre site ; les champs longueur type guid seront renseignés si le fichier est en ligne.

En mode génération automatique les champs longueur type sont remis à jour à chaque enregistrement.

Pour iTunes, l'extension du fichier doit être : m4a mp3 mov mp4 m4v pdf.
Longueur
Ce champ contient la dimension en octets du fichier audio.

Il est renseigné par le champ actif Fichier audio, video, doc
Type
Type MIME du fichier

Les types suivants sont générés automatiquement, ils correspondent aux extensions acceptées par iTunes : plus d'autres types MIME usuels audio video avi mpeg wav au aif swf …

Ce champ est renseigné par le champ actif Fichier audio, video, doc
guid
Le GUID (Global Unique IDentifier) évite que le podcatcher télécharge à nouveau et sans nécessité le fichier audio. Il sera permanent et unique pour un fichier audio, même modifié. Entrer le nom de base du fichier : let's_groove_the_funk.mp3
Le GUID doit impérativement être unique pour un podcast donné.
iTunes: Every <item> should have a globally unique identifier that never changes. When you add episodes to your feed, guids are compared in case sensitive fashion to determine which episodes are new. If you omit the guid for an episode, the episode url will be used instead.

Ce champ est renseigné par le champ actif Fichier audio, video, doc
Auteur
Ce champ contient soit l'email de l'auteur du fichier audio, video, doc kenobi@starwars.com, soit son nom, caractère @ exclu.
Catégories du podcast
Valeurs des catégories pour le fil RSS standard, séparées par des virgules.
Catégories pour les items
Valeurs par défaut pour les items du fil RSS standard, séparées par des virgules.
Catégories standard
Ce champ contient les catégories standard pour l'item séparées par des virgules.
Catégorie sous-catégorie
Ce champ contient la catégorie iTunes pour l'item suivie optionellement de la sous-catégorie ; séparées par une virgule.
Catégorie sous-catégorie
Valeurs pour le fil RSS iTunes, séparées par une virgule.
On peut spécifier jusqu'à 3 catégories avec ou sans sous-catégorie.
Date
Ce champ contient la date de publication de l'épisode (item). La date du fichier audio est prise par défaut.
La date est de préférence dans le format RFC 2822
exemple : Sat, 2 Jul 2005 16:06:02 +0200
Publier l'épisode dans un ou plusieurs fils de syndication spécifiques
L'item (épisode) est mis dans chaque fil RSS spécifique dont le nom est sélectionné.

La case à cocher est signalée par le titre du podcast, suivi du nom du podcast puis du nom du fichier fil RSS.

Rappel : le fil général (premier nom dans la config) contient tous les items.

État
L'état permet de choisir si l'item (épisode) est en ligne ou hors ligne. C'est à dire qu'il sera inclus ou non dans les fils de syndication RSS.
Durée l'épisode audio, video (iTunes)
Ce champ permet aux utilisateurs du fil RSS de connaitre la durée avant téléchargement. Le format est HH:MM:SS ; exemple 00:02:34 ; specs 2005-07-07 HH:MM:SS, H:MM:SS, MM:SS, ou M:SS (H = heures, M = minutes, S = secondes)
Explicit (iTunes)
Ce champ contient la mention Oui, Non ou Clean pour signaler un type de contenu.

Pour Oui ou Clean le graphique correspondant apparait à l'affichage dans iTunes.
Mots-clés (iTunes)
Ce champ contient les mots-clés que vous voulez associer à l'épisode audio, video, doc pour iTunes ; séparés par des virgules ou blancs ; 12 au plus sont retenus pour les fils RSS, séparés par virgule.
Création des balises iTunes
Est-ce que les balises spécifiques et propriétaires de iTunes doivent être créés ?
Titre du podcast
Nom représentatif de l'ensemble des épisodes audio, video, doc du fil RSS.
Adresse (URL) du billet
Le billet ou la page décrivant le fil RSS.
http://www.site.fr/blog/index.php?2005/07/24/11-flux-audio
www.site.fr/blog/index.php?2005/07/24/11-flux-audio
Noms pour fils RSS
Contient des noms (blancs autorisés) séparés par des virgules. Le premier nom (requis) est celui du fil général qui contient tous les items (épisodes). Chaque nom suivant génére un fil RSS spécifique qui contient les items ayant le même nom dans la sélection faite dans Publier l'épisode dans un ou plusieurs fils de syndication spécifiques de l'item.

Ces noms peuvent être par exemple des noms de catégorie de billets du blog, des noms spécifiques (aac, mpeg, iTunes, standard …) ou autres.

Les noms peuvent comporter des blancs multiples ; les comparaisons se font après suppression des blancs multiples et en insensible à la casse.

Le nom de fichier du fil RSS est dérivé du nom entré (mis en minuscules, sans blancs, sans caractères accentués), suivi de l'extension qui figure dans le champ Adresse du podcast. Il y a un 2ème fichier .php associé qui permet des actions spécifiques (l'appel de BBClone RSS est fait si ce plugin est installé).
Extension pour les fils
Extension des fils RSS qui contiennent les épisodes (les fils en extension .php sont aussi générés). Le défaut est xml.
Répertoire des fichiers audio, video, doc
Il indique le répertoire ou rechercher le fichier audio, video, doc dans l'ajout ou l'édition d'un épisode si l'on entre seulement son nom ; par exemple, demo.mp3 sera recherché dans share/audio/

Ce chemin se termine par un /

commencer par un / pour indiquer un répertoire situé à la racine du site
mettre un URL complet pour indiquer un répertoire situé sur un autre serveur.
Player MP3
Génération dans le billet associé de l'appel du player de Dewplayer reloaded ou de neolao.
Faire le billet, long
Non : permet de créer le billet associé avec un minimum d'informations.
Nombre max d'entrées
Limite du nombre d'entrées à lire dans la table MySQL dc_podcast.
Nombre max d'items
Nombre d'épisodes à inclure dans le fil de syndication RSS 2.0.
Langage du podcast
en en-us en-gb fr fr-fr fr-ca .... Voir la suite ici.
Editeur du podcast
Adresse email et nom de l'éditeur du podcast ou du webmestre sous la forme
kenobi@kenobi-radio.com (Ben Kenobi)
le champ peut être vide.
Date de publication
Ce champ permet de spécifier la date de publication du podcast si la date de génération prise par défaut ne convient pas.
La date est à mettre dans le format RFC 2822
exemple : Sat, 2 Jul 2005 16:06:02 +0200
Auteur des épisodes
Nom par défaut de l'auteur des épisodes ; ex.: by Ben ; le champ peut être vide.
Copyright
Mentions de propriétés intellectuelles pour l'ensemble du podcast.
On peut utiliser © ℗ ™
en entrant : &#xA9; &#x2117; &#x2122;
Répertoire des fils de syndication
Le répertoire des fils RSS pour ce fil RSS.

Par exemple : share/feeds/

Ce chemin se termine par un / ; commencer par un / pour indiquer un répertoire situé à la racine du site
Image du podcast pour le fil RSS standard
Valeur maximum pour la largeur : 144, valeur par défaut : 88 ; valeur maximum pour la hauteur : 400, valeur par défaut : 31. Le champ peut être vide (pas de création des balises images).
Entrer : images/kenobi-radio.jpg (racine du blog)
pour générer dans le podcast : http://www.kenobi.org/blog/images/kenobi-radio.jpg
entrer : /images/kenobi-radio.jpg (racine du site)
pour http://www.kenobi.org/images/kenobi-radio.jpg
Description du podcast
Ce champ recommandé contient la description du fil RSS. Ce champ est affiché par les agrégateurs. Moins de 255 caractères.

iTunes : il est affiché dans la colonne Description de l'agrégateur. De préférence court et significatif, quelques mots seulement.

Make your title specific. Your podcast will be available to iTunes customers internationally, so be specific about your subject and intended audience. A podcast entitled Our Community Bulletin is too vague for the right people to find it. My Podcast will attract no subscribers, no matter how compelling the content.

Les balises HTML, les blancs en-tête et en queue, les caractères excédentaires sont supprimés.
Informations (iTunes)
Ce champ optionnel contient les informatins concernant le podcast. Il est affiché lorsque l'on clique sur le i cerclé en fin de ligne dans l'agrégateur iTunes. Moins de 4000 caractères.

Il est également affiché dans le Music Store sous Podcast Description (avril 2006).

Take advantage of this field. The <iTunes:summary> field is your chance to tell potential subscribers all about your podcast. Describe your subject matter, media format, episode schedule, and other relevant info so that they know what they’ll be getting when they subscribe.

Les balises HTML, les blancs en-tête et en queue, les caractères excédentaires sont supprimés.
Mots-clés
La meilleure utilisation des mots-clés est d'inclure les fautes de frappe les plus fréquentes concernant le titre ou la description, pour s'assurer que le pocast peut être recherché avec succés malgré une faute de frappe.
Séparés par des virgules ou blancs ; 12 au plus sont retenus pour les fils RSS, séparés par virgule. Minimiser l'utilisation de ces mots-clés.
Image iTunes pour le podcast
Elle apparait dans le répertoire du Music Store.
Valeur minimum : 170 x 170 à 72 dpi ;
valeur recommandée : 300 x 300, à 72 dpi ;
le champ peut être vide (pas de création des balises images).
Entrer : images/ben-kenobi.jpg (racine du blog)
pour générer dans le podcast : http://www.kenobi.org/blog/images/ben-kenobi.jpg
entrer : /images/ben-kenobi.jpg (racine du site)
pour http://www.kenobi.org/images/ben-kenobi.jpg
Génération automatique
Si oui le(s) fil(s) de syndication RSS 2.0) sont créés à chaque Ajouter ou Enregistrer sans intervention de l'utilisateur.

Si non l'utilisateur contrôle les opérations en utilisant les fonctions disponibles dans ce mode manuel. Il doit générer les fils RSS en utilisant le bouton Gen RSS.
Statistiques Podtrac
Si oui les liens dans les fils de syndication RSS 2.0 et les liens de podcast dans le billet associé sont modifiés pour utiliser les services de Podtrac .
Longueur des titres
Affichés dans l'administration.
Items par page
Nombre d'entrées à afficher par page sur la page d'administration.
Signature du billet associé
Texte ajouté en fin de billet à celui associé à l'épisode par le bouton Faire le billet.

On peut mettre du texte en format wiki DotClear, exemple :

[iTunes Music Store|http://phobos.apple.com/votre adresse dans le Music Store]

''Ceci est un exemple de billet créé par le bouton __Faire le billet__ dans l'interface d'administration du plugin podcast''

Noter que dans le conf.ini les caractères fin de ligne CR LF sont remplacés par #cr; (chaine réservée). Ceci est nécessaire pour que la signature tienne dans une seule ligne du conf.ini.