[cn-content]

Introduction

This shortcode allows you to conditionally display content on the page avoiding the potential for duplicate content issues.

The content to be displayed can be either pulled in from another post or from the shortcode enclosed content. I recommend the former as that method can be easier to set up. Please see the Example section below.

Usage

The most common scenario is to add content above the directory. Here’s a walkthru example of how to set this up correctly to avoid duplicate content.

1. Create a new page.
2. Add the content you want to display above the directory on this page. The content can be built with the Classic Editor, Block Editor, or other page editors like the Divi builder. For best compatibility, the Classic Editor or the Block Editor is recommended.
3. Save the new page with the Directory page as the parent page. This is not strictly required but is recommended for organizations.
4. When saving the page, it is recommended to set the page to Private since it is not necessary to have this page publicly visible.
5. After saving, WordPress will assign the page an id. The page id can be found in the browser’s address bar. Please take note of the id as it will be required for the shortcode.
6. Edit the page which contains the [connections] shortcode.
7. Add the following shortcode before the [connections] shortcode and save the page. Change the n in the example to the page id.

[cn-content id=n/]

When you view the directory page, you will see the contents of the new page displayed above the directory.

Important Notes

• This shortcode must come before the [connections] shortcode.
• This shortcode will not be triggered by the [connections] shortcode options. It will only be triggered by HTTP queries such as Entry permalinks or filtering by category.
• If using both enclosing and self-closing instances of this shortcode on the same page, make sure to add a trailing forward slash (/) to the self-closing instances of the shortcode. The WordPress shortcode parser does not handle the mixing of enclosing and non-enclosing forms of the same shortcode, and you will not get the results you want.
  • https://developer.wordpress.org/plugins/shortcodes/enclosing-shortcodes/#limitations

Options

Examples

Insert the contents of post ID 3, and display it at the location of the shortcode only when viewing the Entry results list.

[cn-content id=3/]

Insert the contents of post ID 18005, and display it at the location of the shortcode only when viewing the single Entry detail/profile page.

[cn-content id=18005 condition=is_single/]

Insert the contents of the post id 18005, display it at the location of the shortcode only when viewing the Entry with the id of 56.

[cn-content id=18005 condition=is_single parameter=56/]

Insert the enclosed content only in the Entry search results view.

[cn-content condition=is_search]Display this content on the search results view only.[/cn-content]

Filters

The following filter can be used to add custom conditions:

Connections_Directory/Shortcode/Conditional_Content/is_condition/{condition}

The filter passes three parameters:

• false :: Return true or false based on whether or not the custom condition is met.
• $parameter :: the value of the parameter shortcode option.
• $shortcode :: the shortcode instance.

/**
 * Example 1
 * 
 * Adds a custom condition named "is_search__and__is_category".
 *
 * This will return false if the condition is BOTH a search and a category
 * and true if only a category.
 *
 * The purpose is to display content only when the is category condition is met, 
 * not when searhcing wihtin category.
 */
add_filter(
	'Connections_Directory/Shortcode/Conditional_Content/is_condition/is_search__and__is_category',
	function( $condition, $parameter, $shortcode ) {
		
		if ( $shortcode->isSearch() && $shortcode->isCategory( $parameter ) ) {
			
			return false;
			
		} 
		
		if ( $shortcode->isCategory( $parameter ) ) {
			
			return true;
		}
		
		return $condition;
	},
	10,
	3
);