[asa2]

Basic usage

[asa2]ASIN[/asa2]

Options

ajax

If you deactivate AJAX globally in the options, you can decide to load single products via AJAX by using the ajax option.

[asa2 ajax="1"]B0094J2BZ0[/asa2]

associate_id_set

Defines which Associate ID set to use for internationalized products. The Associate ID of the product’s country code will be used if it was found in the set.

Note

Option tracking_id is dominant, meaning that if you set tracking_id, this ID will be used and associate_id_set will be ignored.

[asa2 associate_id_set="my-i18n-ids"]B0094J2BZ0[/asa2]

country_code

With the option country_code you can define the Amazon country store you want to embed the product from.

Note

You can use different stores on the same page.

Supported country codes are: BR, CA, CN, DE, ES, FR, IN, IT, JP, MX, UK, US.

[asa2 country_code="BR"]B00BGA9WK2[/asa2]
[asa2 country_code="CA"]B00BGA9WK2[/asa2]
[asa2 country_code="CN"]B00RQ25LQI[/asa2]
[asa2 country_code="DE"]B00BIYAO3K[/asa2]
[asa2 country_code="ES"]B00BIYAO3K[/asa2]
[asa2 country_code="FR"]B00BIYAO3K[/asa2]
[asa2 country_code="IN"]B00BIYAO3K[/asa2]
[asa2 country_code="IT"]B00BIYAO3K[/asa2]
[asa2 country_code="JP"]B00O0Y0LR4[/asa2]
[asa2 country_code="MX"]B00O0Y0LR4[/asa2]
[asa2 country_code="UK"]B00BE4HOIM[/asa2]
[asa2 country_code="US"]B00BGA9WK2[/asa2]

custom_rating

Can be used to display the rating stars image with a custom rating. Place it in a template with placeholder {{ CustomRating }}.

Allowed values are: 0, 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5

Examples:

[asa2 custom_rating="4"]B0094J2BZ0[/asa2]
[asa2 custom_rating="3.5"]B0094J2BZ0[/asa2]

disabled

If you want to hide a product temporarily but not to delete the whole shortcode, you can use option disabled. If it is set to 1, the shortcode will not be rendered.

[asa2 disabled="1"]B0094J2BZ0[/asa2]

no_cache

The no_cache option will prevent the product from being loaded from cache. This is useful if you want to test template updates in the frontend. In production you should not use it.

[asa2 no_cache="1"]B0094J2BZ0[/asa2]

mobile_tpl

With option mobile_tpl you can define a template which will be used on mobile devices (Smartphones). Note that option Mobile templates has to be activated before this will work.

[asa2 tpl="my_desktop_template" mobile_tpl="my_template_for_smartphones"]ASIN[/asa2]

official_cart_button_img

If you use the official cart buttons, you can overwrite which button image to use with this shortcode option.

Available button images are “buy1.gif”, “buy2.gif”, “buy3.gif”, “buy4.gif”, “buy5.gif”, “buy6.gif”.

For more details, see option Cart button image

short_url

Use the option short_url to transform the Amazon page URL into a shorter format.

[asa2 short_url="1"]B0094J2BZ0[/asa2]

// results in: http://www.amazon.de/exec/obidos/ASIN/B0094J2BZ0/tracking-id

This may be combined with a custom tracking ID of course:

[asa2 short_url="1" tracking_id="other-id"]B0094J2BZ0[/asa2]

// results in: http://www.amazon.de/exec/obidos/ASIN/B0094J2BZ0/other-id

tpl

If you want to define a template by its name, use the tpl option.

[asa2 tpl="my_awsome_template"]B0094J2BZ0[/asa2]

tplid

If you want to define a template by its ID, use the tplid option. You can find the ID in the first column of the template table. Using the template ID allows you to change the template’s name afterwards.

[asa2 tplid="16"]B0094J2BZ0[/asa2]
Templates table column ID

tracking_id

Custom Associate ID

[asa2 tracking_id="other-id"]B0094J2BZ0[/asa2]

value

Instead of a template, just a single value of the product can be rendered by using the option value.

A value can be any of the available Placeholders without the placeholder delimiter {{ }}.

This example shortcode would display the product title:

[asa2 value="Title"]B0094J2BZ0[/asa2]

You can combine the value with Default Filters.

For example, to display the release date of a product in a custom date format, use this shortcode:

[asa2 value="ReleaseDate|date('m/d/Y')"]B0094J2BZ0[/asa2]

The Product Picker supports the value option. On tab “Shortcode”, choose “Single value” and select the placeholder from the drop down menu.

Product Picker value selection

Custom Values

Additionally to the shortcode options, you can also define custom values to use as placeholders in templates.

It is very easy. Just define a unique shortcode option with a value and use the exact same option name as placeholder in a template.

[asa2 my_custom_text="Banana!"]B0094J2BZ0[/asa2]

# use placeholder {{ my_custom_text }} in your template