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:
If you add again the same shortcode, then you will see the next item:
An another example with next
:
First two items:
Next four products:
...
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)
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:
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
cols
In some output layouts, for example, in grid shortcode, you can control number of columns per row
sort
Possible values for module shortcodes: price
, discount
, reverse
, total_price
. Example:
Read more here.
order
You can use this parameter only in sortable shortcodes, for example in lists. You can set asc
, desc
. Example:
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:
currency
If you have offers in your product list with different currency, you can convert them all into one currency (list of available currencies):
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):
groups
Split products into separate lists. Check how to use groups.
btn_text
Use this parameter to set custom text for buttons, for example:
hide
You can use hide
shortcode parameter to hide some product data.
For example, hide product price:
hide product price and domain name:
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):
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.
locale
Filter by product locale. It can be used for Amazon, Ebay and Shopee modules only.
Please read more here how it can be used with visitor geolocation plugins.
ean
Filter by one or more EAN codes.
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.
keyword
*Experimental feature.
This creates an auto-updated list of products by keyword. This only works with module shortcodes.
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):
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:
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]
Last updated