[cn-entry] - Connections

Introduction

To display a single directory entry, use the [cn-entry] shortcode. Example:

[cn-entry id=n]

The n in this example is the entry ID found on the Connections Manage admin page.

Tip

Click here to learn shortcode basics.

Shortcode Options

`force_home`

Permalinks for an entry are generated based on the context in which the shortcode is used. If the shortcode is present on a page, all links associated with that particular instance of the shortcode will direct to that page. However, if the shortcode is used on a WordPress Post or in a non-page section of the theme’s sidebar, the links will instead direct to the page designated as the Directory Homepage on the Connections: Settings admin page located under the Display tab.

Depending on how you’re using Connections you may want to force an instance of the shortcode when used on a page other than the Directory Homepage to the Directory Homepage. In this case, you would use the force_home shortcode option.

Example:

[cn-entry id=2 force_home='true']

Tip

If you would rather have the links resolve to a page other than the Directory Homepage, use the home_id shortcode option instead.

`home_id`

The various permalinks for an entry are created contextually. This means if the shortcode is used on a page, all links for that instance of the shortcode will resolve to that page. However, if the shortcode is used on WordPress Post or in the theme’s sidebar; or in any area that is not a page, the links will resolve to the page set as the Directory Homepage on the Connections : Settings admin page under the Display tab.

Example:

/*
 * The Directory Homepage ID is 33 but you need the premalinks need to resolve
 * to a separate page ID for this shortcode instance and that page ID is 68
 */
[cn-entry id=2 home_id=68]

Tip

You must use a page ID.

`id`

Screen Capture - Showing Entry ID Location

The id option allows you to show the details for a specific directory entry.

To locate the entry ID on WordPress admin, navigate to Manage under the Connections admin menu and click the Show Details link below the directory entry. The Entry ID is labeled as such and is located at the far right of the entry row.

Example:

[cn-entry id=349]

Important

This option is required unless the random shortcode option is used.

`random`

The random option allows you to display a random directory entry.

`template`

The default template set on the Connections : Templates admin can be overridden by setting the template option.

Examples:

/*
 * Ouput Entry ID 2 using the `card-single` template.
 */
[cn-entry id=2 template='card-single']