Allows adding custom captions to the featured images of the posts.
This plugin allows adding custom captions to the featured images of the posts. It works with both Gutenberg and the classic editor.
That’s how it works:
The plugin also allows to:
For maintaining a semantic code, this plugin writes the caption in a <figcaption>
label.
New in version 1.21: Compatibility with Divi themes. This is an experimental feature to allow the plugin to work with Divi, as many users requested. Note that it may not work for all layouts, and that since it replaces the function divi uses to show featured images, when enabled it may potentially cause problems with older versions of Divi or if the core theme is updated. As always, it may also be necessary to add custom css to your theme to show the captions the way you want
The caption will adopt the format specified for the <figcaption>
element and the wp-caption-text CSS class, which is common in WordPress themes.
The plugin works out of the box. To start using it, all you need to do is activate it and play with the new options in your edit page. For advanced users, you will found a special settings page for fine-tuning some details.
Go to Settings > FSM Custom Featured Image Caption to set up the CSS and HTML parameters:
Venetian landscape [myshortcode option1="text"]
We’ve added a shortcode that allows you to put the featured image (and it’s caption) in your page. Just write [FSM_featured_image]
anywhere in the content edit box of your post or page to display it. You can also select the size of the image with the parameter “size”. Note that defined image sizes may differ between WordPress themes. The defaults are these: thumbnail, medium, medium_large, large and full.
By using the shortcode, the plugin will try to remove the featured image from your theme’s default position to prevent it from appearing twice. Anyway, this is as this is an experimental feature and results may fluctuate. It also will not appear in lists.
Note that the usage of the shortcode is not related to the “Allow shortcodes” option in the settings page.
Usage example: [FSM_featured_image size=thumb]
The plugin comes with two public functions that allow you to get or output the featured image caption of the current post anywhere in your template.
Once the plugin is activated, use <?php get_FSM_featured_image_caption()?>
to return a string containing the text that you can assign to a variable or <?php the_FSM_featured_image_caption()?>
where you like the caption be displayed.
Both functions accept parameters passed inside an array with the following keys:
div
. If set to false, it will remove it and will return the caption text.false
.false
.false
.false
.Usage example: php
the_FSM_featured_image_caption( array('tag' => 'p', 'class' => 'class1 class2', 'style' => 'color: red;', 'allow_html'=> true, 'allow_shortcodes'=>true );
The plugin comes up with three complete translations:
You can contribute to translating it into more languages at https://translate.wordpress.org/projects/wp-plugins/fsm-custom-featured-image-caption/
Automatic installation
Log in to your WordPress dashboard, navigate to the Plugins menu, and click “Add New”. In the search field type “FSM Custom Featured Image Caption”, then click “Search Plugins”. Once youve found it, click “Install Now”. That’s all.
Manual installation
fsm-custom-featured-image-caption
to the /wp-content/plugins/
directory.Does it work with any theme?
Yes, as long as the theme supports featured images/post thumbnails and uses get_the_post_thumbnail in the code.
Does it work with Divi?
Not by default, but you have an option in the Options page to enable the compatibility. Note that this is an experimental feature and that since Divi doesn’t offer an easier way to hook the function that shows the featured image, the plugin attempts to replace it. Note that while it will be generaly safe to activate, this may result in incompatibilities or even errors on older Divi versions or if a Divi update changes that particular function. Since it involves a third party, we can’t offer assistance if this option doesn’t work with your layout or installation
I’m using the theme [X], and the caption does not appear/appears in a wrong place / has a different color/background, etc.
Note that the plugin only adds some tags to the image to show the caption, and other than the editable custom CSS for the caption text, it does not add styles to the theme. In most cases, the result would be acceptable. In others, maybe you have to modify your theme or add custom CSS styles (usually in Appearance> Customize) to make the caption and the caption container look as you need.