S120 Display an Object Property

Use the S120 Tag to return the string value of a named property from a named object. The object must be stored using the PropertySTagComponent.setObject() method beforehand. See autoresponder valid property values or the full list of S120 values.

See S120 Display Application Objects for the most common S120 object property tags.

For a full list of the valid maps and tags available, the tag [[S120:help]] displays all valid objects and properties for a given page.

Looking for TeamRaiser Autresponder S120 options? See S-120 TeamRaiser Autoresponders.

Note: Certain [[S120]] tags only function within certain Luminate Online modules and therefore may not transfer across all modules. The definitive list of what [[S120]] properties are available can only be found by entering [[S120:help]] wherever you want to use it. Then take whatever action is necessary to get to the page or autoresponder that you have entered the S120:help tag on. That will give the list of what values are actually available where you are attempting to use the tag.

Application

Platform

Can You Add This S-Tag in the WYSIWYG content editor?

No, this S-Tag cannot be added using the WYSIWYG content editor toolbar. Add the S-Tag code to the HTML using the Plain Text editor. 

Can You Add This S-Tag in the Luminate CMS WYSIWYG content editor?

No, this S-Tag cannot be added using the Luminate CMSWYSIWYG content editor. Add the S-Tag code to the HTML using the Plain Text editor in Luminate CMS.

Format

  • Standard
    [[S120:objectName:propertyName[:propertyParameter...]]]

  • XML
    <convio:session name="120" param=" objectName:propertyName[:propertyParameter...]" />

Parameters

  • object name - the name (or key) of an object. Specifies the name of the object, as specified to PropertySTagComponent.storeObject().

  • property name - the name of a property. A property name must correspond to a public accessor method named getpropertyName or ispropertyName. For example, in order to get the value of a "foo" property, there must be a public method with one of the following signatures: public type getFoo(params) or public type isFoo(params) where params can be one of the following:

    • empty (e.g. public String getFoo())

    • one or more Strings

    • a CVSession and a TemplateContext

    • a CVSession and a TemplateContext followed by one or more Strings. In the case of the methods that take a CVSession and a TemplateContext, the CVSession and TemplateContext supplied to the call to render() will be passed into the accessor method. The values for any String arguments are specified using "property parameters"; see below. By convention, property names always begin with a lowercase letter. For example, a property returned by the accessor, getFooBar(), would be named “fooBar”. As a convenience, the full name of the method can also be used to name a property. This is mainly provided so that tags like [[S120:dc:isTribute]] will work.

  • propertyParameter - Value of parameter to property method.  Specifies a string value that should be supplied as a String argument value when calling the property method. Multiple property parameters can be specified as required. 

  • renderMode - The tag [[S120:rc:renderMode]] will return one of three values: "email", "web", or "printer". (If you are not in the context of a donation, then "rc:renderMode" is returned.) You can use this to customize the autoresponder message depending upon whether it is being rendered in the context of thank you email, the normal web page, or the printer-friendly web page.

Sample Code

  • Standard

    Dear [[S120:dc:name]]

    [[?xxnullxx::x[[S120:dc:jointDonorName]]x:::: and [[S120:dc:jointDonorName]]]] [[S120:dc:isGiftAmountGreaterThan:$50]]

    Returns the string value of the “isGiftAmountGreatherThan” property of the object named by “dc”, supplying “$50” as an argument to the property method.

    [[S120:directory:memberAttr:work_phone]]

    Displays the work phone of a constituent. Testing to see if the field 'work phone' contains a value can further customize this:

    [[?zz::z[[S120:directory:memberAttr:work_phone]]z::::<strong>Work Phone</strong>[[S120:directory:memberAttr:work_phone]]]]

  • XML

    <convio:session name="120" param=" dc:name"/]>