Troubleshoot field connection shortcodes (Themer)

If your field connection shortcode isn't displaying the content the way you think it should in a Themer layout, the first question to ask is whether the field connection shortcode is returning a value and what value it's returning for a particular post or page.

To test this, use an HTML module with a conditional shortcode to the field connection while previewing a particular page or post in your Themer layout. It's helpful to add a status message to clarify what you tested for.

Here are a couple examples.

Tip: We're providing the shortcode with parameters in these examples, but here's a tip for finding the field connection parameters for any shortcode you want to test.

1 Test featured image shortcode

You can use the following code to test for the following aspects of a featured image.

  • Whether a featured image exists.
  • What its URL is.
  • Whether the image has a title and what the title is.
  • Whether the image has a caption and what the caption is.
  • Whether the image has a description and what the description is.
  • Whether the image has alt tag content and what the content is.

The following code tests for all of these display parameter values. You can remove the ones you don't want to test.

To test a featured image and its properties:

  1. Add the following code to an HTML module in a Singular-type Themer layout.
Does this post have a featured image?<br>
[wpbb-if post:featured_image]<br>
YES: [wpbb post:featured_image size='thumbnail' display='tag' 
    align='default' linked='yes']<br>
URL: [wpbb post:featured_image size='thumbnail' display='url' 
    align='default' linked='yes']  <br> 
TITLE: [wpbb post:featured_image size='thumbnail' display='title' 
    align='default' linked='yes'] <br> 
CAPTION: [wpbb post:featured_image size='thumbnail' display='caption' 
    align='default' linked='yes'] <br>  
DESCRIPTION: [wpbb post:featured_image size='thumbnail' display='description' 
    align='default' linked='yes']  <br> 
ALT: [wpbb post:featured_image size='thumbnail' display='alt' 
    align='default' linked='yes']   
[/wpbb-if]
  1. At the top of the page in the Preview bar, choose the post or page that you want to test.

The following screenshot shows the result: the featured image, its URL, and the content (or lack of content) in the Title, Caption, Description, and Alt fields for that image in the Media Library. You can vary the size parameter in the code (large, medium, etc.) to test the featured image at various sizes. In the URL test, the file name shows the pixel dimensions for that size.

If there is no featured image, the results will display only the initial question: Does this post have a featured image?

2 Test ACF image field shortcode

Suppose you have an Advanced Custom Field (using the Advanced Custom Fields plugin) called corp-photo.

You can test for whether this field contains an image for a particular post or page by adding this code to an HTML module in a Singular Themer layout.

Does this post have a corporate photo? 
[wpbb-if post:acf type='image' name='corp-photo']Yes: [wpbb post:acf type='image' name='corp-photo']
[/wpbb-if]

The field connection shortcode for an ACF Image field returns the image URL, not the image itself. If this field contains an image, you can expect to see the image URL displayed, as shown in this screenshot.

If you wrap the ACF field connection shortcode in a <img> tag, you'll see the image instead of the URL, as shown in the following code and screenshot of the result.

Does this post have a corporate photo? 
[wpbb-if post:acf type='image' name='corp-photo']Yes: <img src="[wpbb post:acf 
  type='image' name='corp-photo']">
[/wpbb-if]