Skip to content

enrico-sorcinelli/featured-image-extended

Repository files navigation

Featured Image Extended

Feature Image Extended extends featured image functionality allowing:

  • Hiding featured image in your themes for all post types.
  • Adding link to the featured image.
  • Adding thumbnail featured image in administration screens listing.
  • Featured image quick-editing.

Installation

This section describes how to install the plugin and get it working.

  1. Upload the plugin files to the /wp-content/plugins/featured-image-extended directory, or install the plugin through the WordPress Plugins screen directly.
  2. Activate the plugin through the Plugins screen in WordPress.

Usage

Once the plugin is installed you can configure it in the following ways:

  • Using the Settings->Featured Image Extended administration screen.
  • Programmatically, by using featured_image_extended_settings filter (see below).

If your theme uses a different call other than the_post_thumbnail()/get_the_post_thumbnail() in order to get the featured image, this plugin might not work. So, in order to get extended featured image settings and apply to your pages, you should use featured_image_extended() (see below).

API

featured_image_extended( integer $post_id = null )

It returns an array containing featured image extended information of $post_id post (or current post if you don't supply an argument) like following:

array(
	'show'   => true,
	'url'    => 'https://myurl.com',
	'target' => '_blank',
	'title'  => 'Image title',
)

Hooks

featured_image_extended_settings

Filters plugin settings values.

apply_filters( 'featured_image_extended_settings', array $settings )

featured_image_extended_admin_settings

Filter allowing to display or not the plugin settings page in the administration.

apply_filters( 'featured_image_extended_admin_settings', boolean $display )

Frequently Asked Questions

Does it work with Gutenberg?

Not completely. For setting visibility of featured image, this plugin uses admin_post_thumbnail_html filter and currently there are no Gutenberg equivalents.

Screenshots

Admin Featured image metabox

Admin metabox

Admin Post listing

Plugin settings

Plugin settings

The plugin settings page.

Plugin settings

License: GPLv2

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.