cfdocs.org /

Description

Describes a presenter in a slide presentation. A slide presentation can have multiple presenters. The presenters must be referenced from the slides defined by the cfpresentationslide tag.

History

ColdFusion 8: Added this tag.

Category

Data output tags

Syntax

<cfpresenter 
    biography = "text string" 
    email = "e-mail address of the presenter" 
    image = "relative pathname for JPG" 
    name = "text string" 
    logo = "relative pathname for JPG" 
    title = "text string">
Note: You can specify this tag’s attributes in an attributeCollection attribute whose value is a structure. Specify the structure name in the attributeCollection attribute and use the tag’s attribute names as structure keys.

See also

cfchart, cfpresentation, cfpresentationslide

Attributes

Attribute

Req/Opt

Default

Description

biography

Optional

A text string that provides information about the presenter; for example, “Sally Maverick has been a top seller of Adobe products for the last five years.”

email

Optional

E-mail address of the presenter. This attribute activates the Contact link in the presentation control panel, which opens an e-mail message when you click it.

image

Optional

Pathname for the presenter’s image in JPEG format. The JPEG file must be relative to the CFM page. If you specify a video for the cfpresentationslide tag, the video clip overrides this value for that slide.

name

Required

Name of the presenter. Use this value in the presenter attribute of the cfpresentationslide tag to associate the presenter with the slide.

logo

Optional

Pathname of the image file that represents the presenter’s logo or the logo of the presenter’s organization. The logo must be in JPEG format. The file must be relative to the CFM file website.

title

Optional

Title of the presenter, for example, “VP of Sales”.

Usage

Use the cfpresenter tag to define the presenters that you specify for each slide. The presenter information appears in the control panel for the slide to which it is assigned. To specify a presenter for a slide, use the presenter attribute of the cfpresentationslide tag.

You can specify an image of the presenter and the presenter’s company logo by using the image and logo attributes of the presenter tag, respectively. To display a video clip in place of the presenter’s image, you can specify an FLV or SWF file for video attribute of the cfpresentationslide tag.

Example

<!--- This example shows how to specify presenters for a slide ---> 
<!--- presentation and assign a presenter to each slide in the presentation. ---> 
<cfpresentation title="myPresentation" directory="presentation" overwrite="yes"> 
 
<!--- The following code defines three presenters. ---> 
<cfpresenter name="Shyam" title="President" email="shyam@somecompany.com" 
    image="images\shyam01.jpg"> 
<cfpresenter name="Ram" title="V.P. Sales" email="ram@somecompany.com"  
    image="images\ram01.jpg"> 
<cfpresenter name="Michelle" title="V.P. Engineering"  
    email="mhatter@adobe.com" image="images\michelle01.jpg"> 
 
<!--- The following code assigns a presenter to each of three slides in the presentation. ---> 
<cfpresentationslide title="myFirstSlide" src="slide1.swf" duration="10"  
    presenter="Shyam"/> 
<cfpresentationslide title="mySecondSlide" src="slide2.swf" duration="15"  
    presenter="Michelle"/> 
<cfpresentationslide title="myThirdSlide" src="slide3.swf" duration="2"  
    presenter="Ram"/> 
 
<!--- In the following slide, ColdFusion uses a video clip ---> 
<!--- instead of the JPEG image for the presenter. ---> 
<cfpresentationslide title="myFourthSlide" src="slide4.swf" duration="5"  
    presenter="Shyam" video="video\video1.flv"/> 
</cfpresentation>