Flashvar-variabele

Dient te worden gebruikt als de redacteur een XML-bestand voor een flash dient te kiezen.

Voorbeeld:

Flash:tmplFlash(img)
XML-bestand voor flash:tmplFlashXML(flashvar)

In de html/template zijn vervolgens twee variabelen beschikbaar:

tmplFlashXML: bevat het unieke id van het XML-bestand, bijv. '000003'.

_xcms_flashvar_url_tmplFlashXML: bevat het pad naar het XML-bestand.

In het cms is het pad naar een XML-bestand altijd /cms/data/<website>/xml_flashvars/<id>.xml. In de publieke website is het pad altijd /<website>/_xml/<id>.xml. Deze paden kunnen dus ook worden gebruikt om de XML direct op te vragen en te bekijken.

Het XML-bestand kan in de HTML bijvoorbeeld als volgt aan de flash worden gekoppeld (in vet enkele aandachtspunten die na het voorbeeld worden toegelicht):

<script type="text/javascript">
  var u = (new Date()).getTime() % 1000000000; 
  var url = '<!-- TMPL_VAR NAME="tmplFlash" -->?xmlUrl=<!-- TMPL_VAR NAME="tmplFlashXML" ESCAPE="URL" -->?u='+u;
  writeObject(
    '<object width="123" height="456" data="'+url+'" type="application/x-shockwave-flash">'+
      '<param name="movie" value="'+url+'" />'+ 
      '<param name="quality" value="high" />'+ 
      '<param name="wmode" value="transparent" />'+ 
    '</object>'
  ); 
</script>

Waarin tmplFlash de stijl-variabele met de flash zelf is en tmplFlashXML het gekozen XML-bestand.
Let op het gebruik van de functie writeObject() om de hinderlijke 'Klik hier om object te activeren'-melding in Internet Explorer te voorkomen. Verder wordt gebruik gemaakt van een random getal u om de URL naar het XML-bestand steeds uniek te maken om te voorkomen dat de flash (cq. de browser) het XML-bestand cached en daardoor te allen tijde het actuele bestand gebruikt.
Tevens wordt de template variabele voor het XML-bestand voorzien van een ESCAPE="URL". Dit om er voor te zorgen dat slaches (/) in de url worden vervangen met %2F wat nodig is als een url wordt meegegeven via een andere url (namelijk de url naar de flash zelf).

NB: hoe en welke variabele naam te gebruiken is voor het doorgeven van het XML-bestand hangt af van de flash. Vraag dus aan de maker van de flash naar de mogelijkheden!