Promotions via XSLT¶

Displays Arena "Promotions" using your custom (or default) configured XSLT file which is useful when precise control of the XHTML output is needed.

Figure 1 - a complex sample using a custom XSLT and a jQuery plug-in

Figure 2 – a simple example which uses the default XSLT

Installation¶

1. Import the example (.XML) page underneath an existing Arena page. The module is included in the page export file.
2. Configure the module as needed.
3. View the page in your browser. Note: you will need to create some promotions first in order to see them.

Configuration – Module Settings¶

Many of the module settings are the same as those found in the standard Promotion Thumbnails module, however a few additional ones are:

• Image Effect – Controls which type of effect to use such as Rotate, Polaroid, Drop Shadow, etc. See Arena Image Documentation for full details.
• Image Effect Settings – Used with the Image Effect to control the effect of each effect type. See Arena Image Documentation for full details.
• js Path – The path to any JavaScript file or plug-in you want to inject on the page.
• Priority Level – This can be used as a limiter/filter so that only items with priority higher (1 = highest, 99 = lowest) or equal will be shown.
• Priority Randomized – When set to true, the promotions ordering will be randomized with a weighting factor based on each item’s priority. This means any items of higher priority (1 = highest, 99 = lowest) will be more likely to be ordered higher in the list.
• Thumbnail Document Type – This controls whether to use the standard "web promotion thumbnail" image or a custom document type (as defined in the promotion's "Media" tab) for the promotion thumbnail.
• Time to Cache (minutes) – This is used to cache the resulting promotion set in the web cache for faster retrieval. Specify in number of whole minutes. Set to 0 to disable.
• Use Person's Campus – When set to true, if the person viewing the promotion list is logged in to your site and they have a campus set on their record, the promotions listed will be those that match their campus (as determined by Arena's PromotionRequestCollection.LoadCurrentWebRequests() method)
• XsltUrl – this will specify the custom eXtensible Stylesheet Language Transformation file to use when building the output.

XSLT¶

For information on building your own XSLT please consult a tutorial on the topic such as http://www.w3schools.com/xsl/.

Once you’re familiar with XSL, the XML you will be transforming will be in the format of:

<arenapromotions>
  <container>
    <item
      id="[ID]" 
      topic="[the TopicArea value]" 
      title="[the Promotion's title]" 
      summary="[the Promotion's web summary]" 
      details="[the Promotion's web details"                            <!-- as of v1.1.0 -->
      imageUrl= "[URL of the thumbnail image]" 
      detailsUrl="[URL of the Promotion's external URL (if any),  event details page, or promotion details page]" 
    />

    <item />
    <item />
    <item />

  </container>
</arenapromotions>