Le module de progression PVE
Mode d'emploi

Sommaire

  1. Arborescence de l'application
  2. Installer l'application
  3. Mettre à jour le contenu
  4. Ordre des éléments
  5. Crédits

La dernière version du package est téléchargeable ici.

1. Arborescence de l'application

progression.swf
AC_RunActiveContent.js
/img		
/xml

Le fichier exécutable est progression.swf. Pour fonctionner, il doit au minimum être accompagné du dossier /xml contenant le fichier content.xml. Le dossier /img contient toutes les images qui n'appartiennent pas à l'interface de l'application :

Le fichier AC_RunActiveContent.js sert à afficher progression.swf dans une page web.

2. Installer l'application

Il suffit de copier l'ensemble du package sur un serveur web. Le dossier /xml doit toujours être posé au même niveau que progression.swf mais le dossier img peut en théorie être posé n'importe où, le chemin vers chaque image étant précisé dans le fichier XML de configuration.

Copiez la ligne de code ci-dessous dans votre page HTML, entre les balise <head> et </head> :

<script src="scripts/AC_RunActiveContent.js" type="text/javascript"></script>

Copiez le code ci-dessous à l'endroit de la page web où vous souhaitez placer l'application :

<script type="text/javascript">
	var flashvars = "";
	if (window.location.search != "")
		flashvars += "&ext=" + window.location.search.substring(1);
	if (window.location.hash != "") {
		var arrayVars = window.location.hash.substring(1).split('&');
		flashvars += "&inst=" + arrayVars[0];
		if (arrayVars.length>1)
			flashvars += "&boss=" + arrayVars[1];
	}
AC_FL_RunContent( 'codebase','http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,28,0','width','808','height','570','src','progression','quality','high','pluginspage','http://www.adobe.com/shockwave/download/download.cgi?P1_Prod_Version=ShockwaveFlash','movie','progression', 'FlashVars', flashvars ); //end AC code
</script>
<noscript>
	<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,28,0" width="808" height="570">
		<param name="movie" value="progression.swf" />
		<param name="quality" value="high" />
		<embed src="progression.swf" quality="high" pluginspage="http://www.adobe.com/shockwave/download/download.cgi?P1_Prod_Version=ShockwaveFlash" type="application/x-shockwave-flash" width="808" height="570"></embed>
	</object>
</noscript>

3. Mettre à jour le contenu

L'intégralité du paramétrage et du contenu de l'application est accessible depuis le fichier content.xml. Le fichier est constitué d'un ensemble de noeuds imbriqués sur le modèle suivant :

<nocturnesProgressionPVE>
	<extension>
		<instance>
			<boss />
			<hautfait />
		</instance>
	</extension>
</nocturnesProgressionPVE>

Cette imbrication doit être strictement respectée pour que l'application ne provoque pas d'erreur, mais il n'y a pas de limite théorique au nombre de noeuds similaires pouvant co-exister à un niveau donné. En revanche, il y a une limite pratique, dictée par les dimensions de l'interface graphique : on ne peut pas afficher à la fois plus de 14 boss, 15 haut-faits, 12 instances, et probablement 5 extensions.

Voici les attributs modifiables pour chaque noeud :

<extension>

nom
(texte) le nom de l'extension

<instance>

nom
(texte) le nom de l'instance
visuel
(texte) url de l'image de fond associée à l'instance. L'application accepte des chemins relatifs ou absolus. La dimension de l'image doit être de 770x487 pixels. Le format doit être .jpg ou .png.
heroique
(texte) si la valeur est "oui", indique que l'instance est disponible en mode héroïque
enCours
(texte) si la valeur est "oui", indique l'instance majoritairement pratiquée par la guilde à date. Au chargement, l'application affiche directement cette instance. Attention: pour fonctionner correctement, une seule instance par extension doit avoir cet attribut à "oui".

<boss>

icone
(texte) url de la vignette représentant le boss. La dimension de l'image doit être de 35x38 pixels. Le format doit être .jpg ou .png. nom: nom du boss
visuel
(texte) url du screenshot de down. La dimension de l'image doit être si possible de 770x487 pixels. Le format doit être .jpg ou .png.
statut
(chiffre) indique le pourcentage de vie restant au boss lors du meilleur essai. Pour un boss down, indiquer "0"
dateKill
(texte) date du premier kill
Hstatut
(chiffre) indique le pourcentage de vie restant au boss lors du meilleur essai en mode héroïque. Pour un boss down, indiquer "0"
HdateKill
(texte) date du premier kill en mode héroïque
visuelX
(chiffre) si la largeur de l'image de screenshot est supérieure à 770 pixels, cet attribut peut être utilisé pour caler sa position horizontalement. Une valeur positive décale l'image vers la droite, une valeur négative la décale vers la gauche.
visuelY
(chiffre) si la hauteur de l'image de screenshot est supérieure à 487 pixels, cet attribut peut être utilisé pour caler sa position verticalement. Une valeur positive décale l'image vers le bas, une valeur négative la décale vers le haut.

<hautfait>

icone
(texte) url de la vignette représentant le haut fait. La dimension de l'image doit être de 38x38 pixels. Le format doit être .jpg ou .png.
nom
(texte) nom du haut fait
achieved
(texte) date d'accomplissement du haut fait

Ordre des éléments

Ajouter une nouvelle instance ou une extension se fait en copiant-collant simplement les balises nécessaires. Il est important de respecter l'imbrication décrite plus haut, et de se rappeller que les extensions comme les instances sont traitées dans un ordre inversement chronologique : la première instance/extension listée est toujours la plus récente.

Les boss et les haut-faits se listent dans leur ordre d'apparition : premier boss/haut-fait en début de liste, dernier boss/haut-fait en fin de liste.

Crédits