Shortcodes

After setting up and activating modules you can search and add different content on the post edit page. After saving the post, all data of the Content Egg plugin will also be stored in the Custom Fields – the default Wordpress repository for post metadata.

By default the data of the Content Egg will be automatically “attached” at the beginning/end of the post when displaying on the site. Each module has its own option in settings.

Module and Block shortcodes

If you want full control of the place for offers inside the content – use Shortcodes.

When you search any content in the Content Egg you will see a shortcode helper to quickly add the output post with a shortcode.

Choose a template for the output in the right select and copy the generated shortcode in the left field. Then place the shortcode in a content.

There are two available shortcode types: for modules and common (or block) shortcodes (works for all modules at once). The module shortcode is available in each module (see the picture above). Common shortcodes are available at the top of panel.

Common shortcodes are very good when you want to make a common comparison list from all modules, etc.

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]

order

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

[content-egg-block template=offers_list order=desc]

Default is - asc.

products

Filter by product ID. Click on the product image to add product ID filter to shortcode:

You can also set multiple ID 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

Check how to use groups.

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 product 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.