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

 

By default the data of the Content Egg will be automatically “attached” at the beginning or 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 (Pro feature)


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.


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


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):


[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 (Pro feature)


Check how to use groups


hide (Pro feature)


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 (Pro feature)


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