WP Manifestindependent plugin directory
manifest / media / wp-post-thumbnail-endpoint

WP Post Thumbnail Endpoint

A WordPress plugin that provides a special URL for accessing Post Thumbnails by their corresponding Post ID

★ 2stars
v0.1.0latest · 8 years ago

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/xemlock/wp-post-thumbnail-endpoint/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

This WordPress plugin provides a special URL dependent only on Post ID that, when visited, redirects to the Post Thumbnail (aka Featured Image) corresponding to the provided ID.

This can particularily be useful when implementing client-side JavaScript features (in a theme or plugin) that need to display Post Thumbnail based only on Post ID, without sending additional AJAX requests.

Installation

Place the Plugin directory inside wp-content/plugins in your WordPress installation. Then go to plugins administration screen and activate the Plugin.

You can also directly include the main plugin file plugin.php in your own plugin or theme. This plugin will be active as long as the plugin or theme referencing it remains active.

Usage

Post thumbnail URL

Once the plugin has been installed, post thumbnails are accessible via the following URL:

/index.php?post_thumbnail=POST_ID

or, if pretty permalinks are enabled, via:

/post_thumbnail/POST_ID

Post thumbnail size may be specified in the URL either by adding size query variable to the raw URL:

/index.php?post_thumbnail=POST_ID&size=SIZE

or by appending it to the pretty URL:

/post_thumbnail/POST_ID/SIZE

The size provided in the URL must be one of the registered thumbnail size names, i.e. built-in sizes ("thumbnail", "medium", "large" and "full") or those added explicitly via add_image_size(). Unrecognized size names will be ignored, which will result in redirection to the original (unresized) image.

Functions

The Plugin provides two functions for building unified post thumbnail URLs:

  • get_post_thumbnail_endpoint_structure()

    which returns the current structure for unified URLs, with post_id and size parameters given as %post_id% and %size% respectively. This can be used as an URL template on the client side.

  • get_post_thumbnail_endpoint( $post_id [, $size ] )

    which returns the unified post thumbnail URL for the given post ID and optionally specified thumbnail size

Disclaimer

This plugin is intended for use by theme/plugin developers rather than end users, as it provides no usable functionality for the latter.

Releases

1 release.

Tag
Published
v0.1.0 latest
Jan 5, 2018 8 years ago

These releases are tags only. The author does not attach a packaged zip, so there are no download counts to report.