E-Tags: Evaluated Session Tags

E-Tags are evaluate tags and function in the same manner as session tags (S-Tags). Each S-Tag has a corresponding E-Tag. For example, E100 performs the same function as S100.

Use an E-Tag instead of an S-Tag when you need to nest one S-Tag inside of the other, because an S-Tag cannot contain another S-Tag. To nest an S-Tag inside of another S-Tag, change the outer S-Tag to an E-Tag.

For example:

Works

[[E36:top_participants_list,[[S80:trID]],SCROLLING,SUM,10,Top Walkers]]

Will not work

[[S36:top_participants_list,[[S80:trID]],SCROLLING,SUM,10,Top Walkers]]

E-Tags allow a parameter string to be dynamically generated. The parameter_string_template is compiled at the same time as the parent template. So at render time, the template is evaluated, and the result is passed as the parameter string to the session tag implementation, which will parse and evaluate it, and return the appropriate component.

Format

  • Bracket

    [[Enn:parameter_string_template]]

  • XML

    <convio:session name="nn" param="parameter_string" astemplate="any value or empty" {title="description"} />

Examples

  • Make a Dynamic Ask based on a sustaining gift:

    [[E88:sustained_monthly_amount,default_amount,modify_percentage,increment_amount,round_to_nearest]]

  • Display the amount left to be raised to reach a campaign goal - the amount needs to be dynamic and updated as people donate to the campaign. Use the E130 tag to allow S-Tag value calculations.

    1. In the Content Editor (WYSIWYG), enter the E130 tag with the double bracket opening:

      [[E130:

    2. Add the goal amount by using the S15 tag and a Campaign ID of 1121 (example):

      [[E130:[[S15:1121:goal_formatted]]

    3. Add the amount raised so far:

      [[E130:[[S15:1121:goal_formatted]][[S15:1121:amountRaised_formatted]]

    4. Tell the E130 tag to subtract the first value from the second, and to display the final value as currency, with a dollar sign.

      [[E130:[[S15:1121:goal_formatted]][[S15:1121:amountRaised_formatted]] - currency]]

    5. Preview the page to verify that the correct amount displays.

 

TeamRaiser Navigation

You can also embed the TeamRaiser navigation into a PageWrapper. This is good for situations where you would like to provide all the TeamRaiser Custom pages with a consistent look and feel, but have slightly different navigation at each event level.

  • Vertical Navigation:

    [[E401:[[S80:trID]]]]

  • Horizontal Navigation:

    [[E402:[[S80:trID]]]]