:.:.:.:. jcfplayer - documentation :.:.:.:.

Qu'est ce que le ?

Le est un lecteur de fichiers MP3. L'idée m'est venue alors que j'utilisais le plugin Wordpress “Audio Player” de Martin Laine et je trouvais cela si simple et pratique que j'ai cherché l'équivalent pour mon forum phpBB. Tres surpris de n'avoir rien trouvé (peut etre ai-je mal cherché), j'ai décidé d'en faire un.
Il n'est pas encore aussi sophistiqué que celui de Martin Laine mais qui sait, cela dépendra de l'intérêt porté à ce ?

Le et les forums phpBB

Le est en fait un MOD destiné aux forums phpBB.
Les modifications à faire dans le source sont tout à fait minimes: seulement 2 modifications dans le fichier includes/bbcode.php.

Comment l'utilsateur final se sert-il de ce lecteur?

Il lui suffit d'encadrer l'url de son fichier mp3 par les bbcodes [mp3] [/mp3], et le post publié affichera le player pret à charger et jouer ce fichier.

Comment fonctionne-t-il?

C'est plus que simple, fonctionnement standard: il charge le fichier des que vous appuyez sur le bouton "play"
Une fois chargé, vous pouvez accéder directement à n'importe quel moment du morceau en cliquant sur la position correspondante dans la barre de progression orange.

Une installation ultra simple en 3 étapes

NOTE: Le MOD a été créé pour la version 2.0.19 de phpBB mais devrait fonctionner avec la plupart des versions précédentes..

Télécharger et dézipper l'archive.
A la racine de votre forum, créer un repertoire "plugin" et placez y le fichier “jcfplayer.swf”.
Faites les modifications suivantes dans le code:

Dans le fichier includes/bbcode.php :

Trouver :

// [CODE] and [/CODE] for posting code (HTML, PHP, C etc etc) in your posts.
$text = bbencode_second_pass_code($text, $uid, $bbcode_tpl);

Insérer apres:

// JCFPluginMarker =============================== Start
$text = str_replace("[mp3:$uid]", '<object type="application/x-shockwave-flash" data="plugin/jcfplayer.swf" width="310" height="30" id="audioplayer1"><param name="movie" value="plugin/jcfplayer.swf" /><param name="FlashVars" value="soundFile=', $text);
$text = str_replace("[/mp3:$uid]", '" /><param name="quality" value="high" /><param name="menu" value="false" /><param name="wmode" value="transparent" /></object>', $text);
// JCFPluginMarker =============================== End

Trouver :

function bbencode_first_pass($text, $uid)
{
// pad it with a space so we can distinguish between FALSE and matching the 1st char (index 0).
// This is important; bbencode_quote(), bbencode_list(), and bbencode_code() all depend on it.
$text = " " . $text;

Insérer apres:

// JCFPluginMarker =============================== Start
// [MP3] and [/MP3]
$text = bbencode_first_pass_pda($text, $uid, '[mp3]', '[/mp3]', '', false, '');
// JCFPluginMarker =============================== End

C'est tout, ça devrait fonctionner maintenant!

Je ne l'ai testé que sur Internet Explorer et Mozilla Firefox. Je ne sais pas pour les autres, désolé…

Versions à venir?

Je ne sais pas.
J'ai fait ça vite fait pour un besoin personnel, et voyant que le résultat remplissait mon besoin, j'ai pensé que cela pourrait en interesser d'autres.
On verra surtout suivant les retours des utilisateurs (sil y en a )...

Jcfrog, 31 mars 2006.