Show Menu
SUJETS×

Appel de modules avec la fonction doPlugins

Les modules externes JavaScript sont généralement appelés par la fonction doPlugins, elle-même exécutée lorsque la fonction t() est appelée dans le code à insérer.
Par conséquent, si vous définissez une variable dans la fonction doPlugins , vous risquez d’en remplacer une que vous avez définie sur la page HTML. La seule fois où la fonction doPlugins n’est pas appelée est lorsque la variable usePlugins est définie sur « false ».

Exemple de code

L’exemple de code ci-dessous montre à quoi ressemble la fonction doPlugins dans votre fichier JavaScript :
AppMeasurement pour JavaScript:
/* Plugin Config */ 
s.usePlugins=true 
s.doPlugins=function(s) { 
 /* Add calls to plugins here */ 
}

Code H :
/* Plugin Config */ 
s.usePlugins=true 
function s_doPlugins(s) { 
 /* Add calls to plugins here */ 
} 
s.doPlugins=s_doPlugins

Le code H et les versions antérieures utilisent une syntaxe différente pour la prise en charge de navigateurs très anciens (tels que Microsoft IE 4 et 5).

Changement du nom de la fonction doPlugins

La fonction doPlugins est généralement appelée s_doPlugins . Dans certains cas (en général, lorsque plusieurs versions du code peuvent apparaître sur une seule page), il se peut que le nom de la fonction doPlugins soit modifié. S’il s’avère nécessaire de renommer la fonction doPlugins standard pour éviter des conflits, attribuez-lui le nom de fonction correct doPlugins , comme illustré ci-dessous.
/* Plugin Config */ 
s_mc.usePlugins=true 
function s_mc_doPlugins(s_mc) { 
 /* Add calls to plugins here */ 
} 
s_mc.doPlugins=s_mc_doPlugins 

Utilisation de la fonction doPlugins

La fonction doPlugins permet d’attribuer facilement des valeurs à des variables ou d’extraire des valeurs de paramètres de chaîne de requête sur n’importe quelle page du site. L’utilisation de doPlugins se révèle généralement plus facile que de renseigner des valeurs dans la page HTML, dans la mesure où un seul fichier doit être mis à jour. Gardez à l’esprit que les modifications apportées au fichier JavaScript sont parfois différées. Les visiteurs récurrents sur votre site utilisent souvent des versions en cache du fichier JavaScript. Il se peut donc que les mises à jour du fichier ne soient pas appliquées immédiatement à tous les visiteurs ; il peut parfois s’écouler un mois avant leur application.
L’exemple suivant illustre l’utilisation de la fonction doPlugins pour définir une valeur par défaut pour une variable et pour obtenir une valeur à partir de la chaîne de requête.
/* Plugin Config */ 
s.usePlugins=true 
s.doPlugins=function(s) { 
 /* Add calls to plugins here */ 
 // if prop1 doesn't have a value, set it to "Default Value" 
 if(!s.prop1) 
s.prop1="Default Value" 
 
 // if campaign doesn't have a value, get cid from the query string 
 if(!s.campaign) 
s.campaign=s.getQueryParam('cid'); 
 
// Note: The code to read query parameters is different for  
// Appmeasurement for JavaScript since a plug-in is not required: 
// s.campaign=s.Util.getQueryParam('cid'); 
} 

Modules externes installés

Pour déterminer si un module externe est inclus dans votre fichier JavaScript et est prêt à l’emploi, accédez à la section Plugins Section du fichier JavaScript. L’exemple suivant illustre la fonction getQueryParam.
/************************** PLUGINS SECTION *************************/ 
/* You may insert any plugins you wish to use here.                 */ 
/* 
 * Plugin: getQueryParam 1.3 - Return query string parameter values 
 */ 
s.getQueryParam=new Function("qp","d","" 
+"var s=this,v='',i,t;d=d?d:'';while(qp){i=qp.indexOf(',');i=i<0?qp.l" 
// 
// ... more code below ...
//