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.
- 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 :
- audio/x-m4a m4a
- audio/mpeg mp3
- video/quicktime mov
- audio/mp4 mp4
- video/x-m4v m4v
- application/pdf pdf
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 : © ℗ &#x2122;
- 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.