Shortcode parameters

By using shortcode parameters, you can control certain parameters module data display.

template

Use template parameter for different output look. In right part, you can choose name of shortcode and copy it from left part.

next

Use next parameter if you want to divide whole list on separate blocks.

For example, this shortcode with the parameter next will show first Amazon item:

[content-egg module=Amazon next=1]

If you add again the same shortcode, then you will see the next item:

[content-egg module=Amazon next=1]

An another example with next:

First two items:

[content-egg module=Amazon next=2]

Next four products:

[content-egg module=Amazon next=4]

...

You can use next parameter for module's and for common shortcodes.

limit/offset

These parameters are similar to next, but you have more control on them.

Next shortcode will show 3 offers from Amazon but will start from third product in list (first product has 0 number)

[content-egg module=Amazon limit=3 offset=2]

post_id

Another useful parameter of shortcode is post_id. It can be useful when you create “Top set” pages and want to show data from several posts:

[content-egg module=Amazon template=item post_id=123]

This shortcode will show an Amazon module data from post with ID = 123

modules

You can also show offers from several modules with modules parameter

[content-egg-block template=offers_list modules=Amazon,Ebay]

cols

In some output layouts, for example, in grid shortcode, you can control number of columns per row

[content-egg-block template=offers_grid cols=2]

sort

Possible values for module shortcodes: price, discount, reverse, total_price. Example:

[content-egg module=Amazon template=list sort=discount]

Read more here.

order

You can use this parameter only in sortable shortcodes, for example in lists. You can set asc, desc. Example:

[content-egg module=Amazon template=list sort=price order=desc]

Default is - asc.

products

Filter products output by product ID. Click on the "id" button to add the product ID filter to the output shortcode. You can also set multiple IDs separated by commas.

disable_features

This parameter can be used with item template only to disable "Features" section:

[content-egg module=Amazon template=item disable_features=1]

currency

If you have offers in your product list with different currency, you can convert them all into one currency (list of available currencies):

[content-egg-block template=offers_grid currency=EUR]

You can use this currency parameter for module shortcodes and common block shortcodes.

If your currency is not listed above, you can add exchange rate manually. Add in functions.php of your theme (or child theme):

function my_content_egg_currency_rate ($rate, $from, $to)
{
    if ($from == 'USD' && $to == 'KES')
        return 100.15; // <--- rate
    if ($from == 'KES' && $to == 'USD')
        return 0.01; // <--- rate
}
add_filter( 'content_egg_currency_rate', 'my_content_egg_currency_rate', 0, 3 );

groups

Split products into separate lists. Check how to use groups.

btn_text

Use this parameter to set custom text for buttons, for example:

[content-egg module=Amazon template=list_no_price btn_text="CHECK PRICE"]

[content-egg-block template=buttons_row btn_text="%PRICE% at %MERCHANT%"]

hide

You can use hide shortcode parameter to hide some product data.

For example, hide product price:

[content-egg-block template=offers_list hide=price]

hide product price and domain name:

[content-egg module=Ebay template=list hide=price,domain]

All available fields: 'price', 'priceOld', 'domain', 'rating', 'title', 'stock_status', 'img', 'merchant'.

show

Use show parameter only with "customizable"block template. We also recommend adding "products" parameter to show only one information about a product (like price, title, button, etc):

product price: [content-egg-block template=customizable product="808726894" show=price]

All available fields: title, img, price, priceOld, currencyCode, button, stock_status, url, last_update, img+url'.

add_query_arg

You can rebuild affiliate URL and append query variables to the URL query by using this parameter.

[content-egg module=Amazon add_query_arg="tag=CUSTOM_TAG"]

locale

Filter by product locale. It can be used for Amazon, Ebay and Shopee modules only.

[content-egg module=Amazon locale=US]

Please read more here how it can be used with visitor geolocation plugins.

ean

Filter by one or more EAN codes.

[content-egg module=Amazon template=list ean=0711719765790,5016488137300]

Please note, this parameter does not add new products, it only filters the output of existing products.

remove_duplicates_by

Removes duplicate products. Duplicates are checked for one of the product fields: orig_url, url, title, ean, domain. The module priority will be used to determine which product to remove. It can be used with block shortcodes only.

[content-egg-block template=offers_list remove_duplicates_by=orig_url]

keyword

*Experimental feature.

This creates an auto-updated list of products by keyword. This only works with module shortcodes.

[content-egg module=Amazon template=list keyword="echo dot"]

This parameter adds an auto-update keyword and automatically creates groups to filter product output. If you want to set your own group name use the syntax like (the group separator '->' must be encoded):

[content-egg module=Amazon template=list keyword="echo dot->Smart speakers"]

You can set the maximum number of search results and auto-update schedule in the settings of each module. Use the "limit" parameter to limit the number of results for a particular shortcode:

[content-egg module=Amazon keyword="echo dot" limit=3]

Useful snippets

Low price: [content-egg-block template=customizable show=price limit=1 sort=price order=asc]

High price: [content-egg-block template=customizable show=price limit=1 sort=price order=desc]

Three cheapest products:

[content-egg-block template=offers_list limit=3 sort=price order=asc]