Featured Image Caption

Description

Featured Image Caption makes it simple to show a caption with the featured image of a post or page. It works seamlessly with most themes, with no coding required. If you like to mess about in the code, it supports that too.

For full details about the plugin and usage documentation, check out the plugin wiki on GitHub.

Screenshots

  • Featured Image Caption meta box below the Featured Image meta box.

Installation

  1. Upload the featured-image-caption directory to your site’s plugins directory.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Review the plugin options found in Settings > Featured Image Caption.

FAQ

Where do I find the documentation for this plugin?

Documentation is maintained on the plugin’s GitHub wiki. I don’t want to maintain two separate sets of documentation and run the risk of conflicting/outdated information, and all of the plugin development happens on GitHub.

Reviews

Doesn’t work

Doesn’t work. Numerous recent threads in the support forum reporting the same problem but no response from the developer. It appears this plugin is no longer supported. Disappointing as there is a real need for this type of plugin.

Not compatible with wordpress 4.7

When i upgraded my site to wordpress 4.7, this plugin caused my jetpack to break. Could not connect to jetpack if this plugin is installed. Had to disable this plugin. Hopefully an updated version will come with the fix.

Not working with Extra Theme (Elegant Theme)

I looked into using Mizagorn’s fix for the Divi theme which comes from the same stable, but unfortunately the line of code to follow doesn’t appear in the equivalent file.

If anyone get’s it working with Extra, please post the fix because the plugin sounds exactly what I am looking for.

Read all 22 reviews

Contributors & Developers

“Featured Image Caption” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

0.8.6

Fix an error thrown due to a deprecated function call for the WP REST API.

0.8.5

Fix an issue with empty caption data causing Undefined Index errors for the REST API.
Credit: github/brockpetrie

0.8.4

Fix a bug with the REST API throwing errors for posts with no caption data.

0.8.3

Add support for the WordPress REST API. The caption fields are added as properties in the posts response. See plugin documentation for the REST API for usage information.

0.8.2

  • When automatic caption appending is enabled, the plugin can optionally only append the caption when viewing a single post.
  • Improved validation of supported PHP version. If PHP is too old, the plugin is deactivated and a warning is displayed.
  • Bug fixes and improvements.

0.8.1

Restricts the automatic caption insertion to only occur in The Loop.

0.8.0

  • Changes the name of the shortcode from cc-featured-image-caption to ccfic. This was done for a few reasons. First, WordPress documentation advises against hyphens in shortcode names, so in order to follow best practices the hyphens have been removed. Second, it’s easier to type the abbreviation when using the shortcode. Please note, the old shortcode name still works for now, but you should expect that it will be removed entirely by the time this plugin reaches its 1.0.0 release. As such, please update all the locations that you use the shortcode. Please see the shortcode documentation for usage information.
  • Fixes the activation process so that initial configuration is saved properly in the database.

0.7.2

Fixes a bug in upgrading plugin options.

0.7.1

Fixes missing dependency.

0.7.0

Fixes bug in handling HTML tags in caption data that was introduced in the last release. Bug fixes related to activation.

0.6.3

Adds support for HTML tags to be used in caption and source text. HTML tags are filtered, and only tags allowed in post content are allowed in caption and source text.

0.6.2

Fixes issue with incorrectly escaped characters for the meta box fields.

0.6.1

Fixes a bug introduced in 0.6.0 in the theme function.

0.6.0

A shortcode has been added for easy insertion of caption information into a post or page. Debugging information is now displayed on the plugin settings page. Minor bug fixes.

0.5.0

** Major Release / Breaking Changes **

Plugin can automatically add the caption after the featured image, removing the need to modify theme files. If you are upgrading from a previous option this will be disabled by default, otherwise it is enabled by default. Theme function cc_featured_image_caption() is not needed if you have automatic caption insertion turned on. If this option is enabled, the function won’t display anything. You can, however, still use it to return the caption data. CSS classes have changed. See the FAQ for information about the new markup and CSS classes.

0.4.1

  • Added the option to have the source link open in a new window. This option is on a post-by-post basis. Thanks to avluis for the suggestion.
  • Every time you save a post, the “new window” setting is saved to your user options as the default for your user for that setting.

0.4.0

  • Restructured the plugin to improve performance.
  • Fixed a bug with nonce verification when saving the caption data.

0.3.3

Added support for custom post types. Thanks to anlutro for the contribution.

0.3.2

Removed image source attribution pre-text.

0.3.1

Only display caption text data if it has been set.

0.3.0

Dedicated fields for image source attribution. When formatted text is requested, the source information has its own CSS class.

0.2.0

  • SYNTAX CHANGE: The theme function cc_featured_image_caption() no longer needs to be used with echo but instead defaults to echo. If you’d like to return the result, add false as an argument for the function like so: cc_featured_image_caption( false );
  • Allow HTML tags in the caption. Only permits tags that WordPress allows in post content.
  • A new function has been added to check whether a caption is set for the post. Use the function cc_has_featured_image_caption() which returns true if a caption is set, and false if a caption is not set.

0.1.3

Theme function checks whether the caption data returned to it is false. If false, the theme function also returns false. If not false, the theme function returns a formatted caption string.

0.1.2

Fixed bug in declaring <span> class.

0.1.1

Added <span> around the rendered caption to allow for CSS formatting.

0.1.0

Initial release