Simple Audio Player – Shortcode
This shortcode display a simple Audio player that does the job, the shortcode syntax is the same as Wordpress one, thats why if you want to import Wordpress article to Joomla! this plugin is for you.
The JS librairie used is MediaElement.js.
** Shortcode usage :**
Simple : [audio src="audio.mp3"]
Advanced : [audio src="source.mp3" loop="on" preload="auto" autoplay="on"]
Mandatory parameter :
- src : URL of your audio file
Optional parameters :
loop : on / off = Allows for the looping of media
autoplay : on / off = Causes the media to automatically play as soon as the media file is ready.
preload : none / auto / metadata = Specifies if and how the audio should be loaded when the page loads, by default the audio should not be loaded when the page loads, auto = the audio should be loaded entirely when the page loads, metadata = only metadata should be loaded when the page loads.
style : CSS code applied to the player
background : background color of the player, various formats supported : #228CBF rgb(34, 140, 191) or rgba(34, 140, 191, 0.50) ..
hidden : on / off = hide the player
showvolume : on / off = permit to show or not the volume group
txtcolor : change text color, accept classic css colors : #f00, red, rgba(255,0,0,0.5) ..
btcolor : change color of main buttons, black, red, green, blue or white
Italic value = default value
FAQ
What if multiple players are on the same page?
The autoplay is disabled, and it is impossible to play two songs simultaneously.
Is this plugin compatible with the Joomla "Custom Content" module?
Yes : however, in the module settings, the "Content Plug-ins" option must be active
Is this plugin compatible with live streams .m3u8, .mwa ...?
Currently not
Is Flash required for this plugin to work?
No, adobe flash is not and will never be necessary
Changelogs Version 1.5 :
+ new attribute added : "showvolume"
+ new attribute added : "txtcolor"
+ new attribute added : "btcolor"
+ update jQuery to latest version (3.2.1)
+ rewrite the way to load the main library (more efficient now)
+ CSS : removing 'box-shadow' on buttons (some templates skin all buttons..)
+ CSS : removing 'outline' on buttons focused
Version 1.4 :
+ add automatic updates
+ fix a display bug with some specific templates
Version 1.3 :
+ new global params "default width", define the default player width, even if it loads in a tab or a toggler
Version 1.2 :
+ new attribute added : "hidden"
Version 1.1 :
+ new attribute added : "background"
+ fix some bugs
Created : October 2014
Update : February 2018
Joomla : 2.x - 3.x
Compatible : all browsers
Flash required : non
Ce plugin ajoute un shortcode général [audio], utilisable dans les articles joomla classique ainsi que dans le module natif "contenu HTML personnalisé", et dans toutes les autres extensions joomla développé dans l'esprit Joomla!
Le shortcode affiche un lecteur audio classique, la syntaxe du shortcode est exactement la même que celle de Wordpress, c'est la raison pour laquelle ce plugin est fait pour vous si vous souhaitez importer des articles Wordpress sur Joomla par exemple.
Le lecteur audio est basé sur la librairie MediaElement.js
Utilisation du shortcode :
Simple : [audio src="source.mp3"]
Avancée : [audio src="source.mp3" loop="on" preload="auto" autoplay="on"]
Paramètre obligatoire :
- src : URL de votre fichier audio (le paramètre "mp3" existe aussi, en alias)
Paramètres optionnel :
loop : on / off = lire le fichier en boucle
autoplay : on / off = lire le fichier automatiquement
preload : none / auto / metadata = Par défaut le fichier n'est pas pré-chargé, auto = Pré-chargement automatique du fichier, metadata = Pré-charge automatiquement seulement les métadata du fichier.
style : code CSS qui sera appliqué à la balise audio
background : couleur d’arrière plan du lecteur, peut être aux divers formats : #228CBF rgb(34, 140, 191) ou encore rgba(34, 140, 191, 0.50)
hidden : on / off = cache le lecteur audio
showvolume : on / off = permet de montrer ou non le groupe de volume
txtcolor : modifie la couleur du texte, couleurs au format css classique : #f00, red, rgba (255,0,0,0.5) ..
btcolor : change la couleur des boutons principaux : black, red, green, blue or white
Valeur en italique = valeur par défaut
Questions / Réponses
Et si plusieurs lecteurs sont présent sur la même page ?
L'autoplay se désactive, et il est impossible de jouer 2 musiques en même temps.
Est-ce que ce plugin est compatible avec le module Joomla "Contenu personnalisé" ?
Oui : cependant, dans les paramètres du module, l'option "Plug-ins de contenu" doit être active
Est-ce que ce plugin est compatible avec les flux "live" .m3u8, .mwa ... ?
Pour le moment non
Est-ce que Flash est requis pour que ce plugin fonctionne ?
Non, adobe flash n'est pas et ne sera jamais nécessaire
Changelogs
Version 1.5 :
+ support de l'attribut : "showvolume"
+ support de l'attribut : "txtcolor"
+ support de l'attribut : "btcolor"
+ mise à jour de jQuery (3.2.1)
+ réécriture la façon de charger la bibliothèque principale (plus efficace maintenant)
+ CSS : suppression de 'box-shadow' sur les boutons
+ CSS : suppression de 'outline' sur les boutons qui ont le focus
Version 1.4 :
+ ajout du support des mises à jour automatique
+ correction d'un bug d'affichage avec certains thèmes
Version 1.3 :
+ ajout d'un paramètre global de configuration "largeur par défaut", permet de définir la largeur du lecteur si ce dernier est dans un tabs par exemple
Version 1.2 :
+ support de l'attribut "hidden"
Version 1.1 :
+ support de l'attribut "background"
+ correction de quelques bugs
Création : Octobre 2014
Mise à jour : Fév. 2018
Joomla : 2.x - 3.x - 4.Alpha
Compatible : tout navigateur
Flash requis : non
This plugin adds a general shortcode [audio], usable in classic Joomla articles and the native "Custom content" module, and all other third party extension using default joomla "contents events".
Extension Data :
- Compatibility :
- Joomla 3.xYes
- Joomla 4.xYes
- Joomla 5.xYes
- Joomla 6.xYes