Template Tags

Core Template Tags

AdSanity ads can be placed programmatically. There are two template tags available for users. One to add a single ad and one to show an ad group. You may want to add these tags to specific templates or template parts to display your advertisements.

To show a single ad:

adsanity_show_ad(
	array(
		// any valid ad ID will do
		// (you can get this from the main list of ads)
		'post_id' => 1,
		// (one of the following: // alignleft, aligncenter, alignright or alignnone)
		'align' => false,
		// this will optionally return the output instead of echoing it
		'return' => false,
	)
);

To show a group of ads:

adsanity_show_ad_group(
	array(
		// an array of valid group ids
		// (you can get these from the main list of ad groups)
		'group_ids' => array(),
		// number of ads to show total
		'num_ads' => 1,
		// number of ads to show per row
		'num_columns' => 1,
		// this will optionally return the output instead of echoing it
		'return' => false,
	)
);

Add-On Template Tags

To show rotating ads:

adsanity_show_rotating_ads(
	array(
		// random ads or date-based ordering
		'random' => true,
		// any valid group id
		'group_id' => 0,
		// (one of the following: alignleft, aligncenter, alignright or alignnone)
		'align' => false,
		// how many seconds to show an ad before rotating
		'time' => 30,
		// setting a max width can help keep ads responsive,
		// but also no wider than necessary
		'max_width' => 0,
		// this will optionally return the output instead of echoing it
		'return' => false,
	)
);

To show ordered ads:

adsanity_show_ordered_ads(
	array(
		// the number of columns to output
		'num_columns' => 1,
		// an array of valid ad ids
		// (you can get these from the main list of ads)
		'ad_ids' => array(),
		// (one of the following: // alignleft, aligncenter, alignright or alignnone)
		'align' => 'alignnone',
		// this will optionally return the output instead of echoing it
		'return' => false,
	)
);