Documentation

How to use and configure the Intagrate WordPress plugin

Template Tags

Avatar
Written by Iain
Last updated 01 Sep 2019

About

You can use the template tags to access Instagram data and plugin data in your title, content, excerpt, and custom meta fields for an account. This allows your to combine tags with text and HTML to have complete control over the output of the plugin.

Tags will not work in the account post titles for multiple images in the same post.

Only some tags can be used in the title and custom meta fields but they can be combined with normal text as well.

The tags can be used in the main content in any combination along with HTML markup.

The Tags

image

Usage: %%image%%

The image url, either direct from Instagram or from the WP media library.

Note: Cannot be used in the Title

video

Usage: %%video%%

The video url, either direct from Instagram or from the WP media library.

Note: Cannot be used in the Title

caption

Usage: %%caption%%

The image caption from Instagram including tags.

caption-escaped

Usage: %%caption-escaped%%

The image caption from Instagram including tags, escaped for use in HTML attributes like title and alt.

caption-tags-no-hash

Usage: %%caption-tags-no-hash%%

The image caption from Instagram including tags without the #.

caption-tags-no-hash-escaped

Usage: %%caption-tags-no-hash-escaped%%

The image caption from Instagram including tags without the #, escaped for use in HTML attributes like title and alt.

caption-no-tags

Usage: %%caption-no-tags%%

The image caption from Instagram excluding tags.

caption-no-tags-escaped

Usage: %%caption-no-tags-escaped%%

The image caption from Instagram excluding tags, escaped for use in HTML attributes like title and alt.

caption-no-usernames

Usage: %%caption-no-usernames%%

The image caption from Instagram excluding username mentions.

caption-no-usernames-escaped

Usage: %%caption-no-usernames-escaped%%

The image caption from Instagram excluding username mentions, escaped for use in HTML attributes like title and alt.

caption-no-usernames-no-tags

Usage: %%caption-no-usernames-no-tags%%

The image caption from Instagram excluding tags and username mentions.

caption-no-usernames-no-tags-escaped

Usage: %%caption-no-usernames-no-tags-escaped%%

The image caption from Instagram excluding tags and username mentions, escaped for use in HTML attributes like title and alt.

tags

Usage: %%tags%%

The image tags from Instagram

tags-first

Usage: %%tags-first%%

The first image tag from Instagram

username

Usage: %%username%%

The username of who posted the image on Instagram.

instagram-user-profile-url

Usage: %%instagram-user-profile-url%%

The link to the Instagram profile of who posted the image.

Note: Cannot be used in the Title

instagram-user-profile-image-url

Usage: %%instagram-user-profile-image-url%%

The link to the Instagram profile image of who posted the image.

Note: Cannot be used in the Title

instagram-media-type

Usage: %%instagram-media-type%%

The type of Instagram media, i.e. image or video.

instagram-media-id

Usage: %%instagram-media-id%%

The ID of the Instagram media

instagram-url

Usage: %%instagram-url%%

The link to the Instagram media page.

Note: Cannot be used in the Title

instagram-image-url

Usage: %%instagram-image-url%%

The link to the Instagram image.

Note: Cannot be used in the Title

instagram-video-url

Usage: %%instagram-video-url%%

The link to the Instagram video.

Note: Cannot be used in the Title

instagram-embed-url

Usage: %%instagram-embed-url%%

The Instagram embed link for images and videos.

Note: Cannot be used in the Title

wordpress-image-url

Usage: %%wordpress-image-url%%

The link to the image if saved in the WP media library.

Note: Cannot be used in the Title

wordpress-video-url

Usage: %%wordpress-video-url%%

The link to the video if saved in the WP media library.

Note: Cannot be used in the Title

wordpress-post-url

Usage: %%wordpress-post-url%%

The link to the post created in WP.

Note: Cannot be used in the Title

gallery

Usage: %%gallery%%

A gallery of all images that have been saved to the WP media library for the post.

Note: Cannot be used in the Title or Meta

map

Usage: %%map%%

A Google map of the location of a geo tagged image.

Note: Cannot be used in the Title or Meta

location-name

Usage: %%location-name%%

The name of the location of a geo tagged image.

location-lat

Usage: %%location-lat%%

The latitude of the location of a geo tagged image.

location-lng

Usage: %%location-lng%%

The longitude of the location of a geo tagged image.

image-date

Usage: %%image-date%%

The date the image was taken on Instagram.

filter

Usage: %%filter%%

The Instagram filter used on the image.

likes

Usage: %%likes%%

The Instagram Likes count for the image.

Filters

You can amend and adjust the values returned by any of the template tags using filters.

The name of the filter hook is the in the same format for each tag; igp_template_[tag].

For example to change the %%caption-no-tags%% you would use the filter igp_template_caption_no_tags. Hypens in tags would need to be converted to underscores in the code.

So to create your own code to make use of the filter you would use something like the below in a separate plugin (adding to your theme’s functions.php is a bad idea).


add_filter( 'igp_template_caption_no_tags', 'my_igp_template_caption_no_tags' );

function my_igp_template_caption_no_tags( $caption ) {
    return $caption .' from Instagram without tags, caption changed by a filter!';
}

Now any images caption will have ‘ from Instagram without tags, caption changed by a filter!’ appended to it when the plugin runs and creates a post for the image.

Where shall I add the code? Take a look at http://dev7studios.com/adding-code-customisations-wordpress-the-right-way/

Open a Suport Ticket

Let's get you started

Start publishing your Instagram media to your site today