FSM Custom Featured Image Caption

Descripción

Este plugin permite añadir leyendas a las imágenes destacadas de las entradas. Funciona tanto con Gutenberg como con el editor clásico.

Así funciona:

  • Si no se indica ninguna leyenda en el plugin, se mostrará la leyenda genérica definida en la Biblioteca.
  • Si se indica una leyenda en el plugin, se mostrará esta en lugar de la leyenda genérica definida en la Biblioteca.
  • Si no se indica ninguna leyenda en el plugin ni tampoco en la Biblioteca, no se muestra nada (obviamente).

Este plugin también te permite:

  • Ocultar la leyenda, tanto la original definida en la Biblioteca de medios como la personalizada.
  • Ocultar completamente la imagen destacada en la vista pública, sin tener que desvincularla de la entrada.
  • Configurar varias opciones para modificar los estilos utilizados en la leyenda.
  • Mostrar el texto de la leyenda en cualquier lugar de tu tema usando una función personalizada.
  • Mostrar la imagen destacada y la leyenda dentro de tu contenido con un shortcode (experimental).

Para mantener la semántica del código fuente, este plugin escribe la leyenda en una etiqueta <figcaption>.

Formato

La leyenda adoptará el formato especificado para el elemento <figcaption> y la clase CSS wp-caption-text, que son las habituales en los temas para WordPress.

Uso

El plugin funciona sin más. Para comenzar a usarlo, todo lo que necesitas hacer es activarlo y probar las nuevas opciones ubicadas en la página de edición de entradas. Los usuarios avanzados encontrarán una página de configuraciones especiales donde ajustar algunos detalles más.

Ves a Ajustes > FSM Custom Featured Image Caption para ajustar el CSS y los parámetros HTML:

  • CSS de la leyenda: Elige una de las opciones para modificar la clase/estilos que se usarán en el contenedor de la leyenda (por defecto es wp-caption-text). Ten en cuenta que puedes indicar más de una clase separada con espacios.
  • Permitir código HTML: Márcalo si deseas procesar el texto de la leyenda como HTML para que el navegador interprete las etiquetas HTML en lugar de mostrarlas. Ten en cuenta que el código HTML incorrecto o las etiquetas huérfanas pueden romper tu diseño.
  • Mostrar leyendas en listas: Desactivado por defecto. Comprueba si quieres mostrar la leyenda cuando la imagen destacada aparece en listas, como por ejemplo en una página de categorías, en widgets con las últimas publicaciones, etc. Ten en cuenta que algunos temas pueden agregar contenedores alrededor de la imagen (como etiquetas de enlaces) que pueden entrar en conflicto con el aspecto de la leyenda.

Shortcode

Hemos incorporado un shortcode que te permite colocar la imagen destacada (y su leyenda) en cualquier lugar de la página. Simplemente escribe [FSM_featured_image] en cualquier lugar del contenido para mostrarlo. También puedes seleccionar el tamaño de la imagen con el parámetro «size». Ten en cuenta que los tamaños de imagen predeterminados pueden diferir entre los temas de WordPress. Los valores predeterminados son los siguientes: thumbnail, medium, medium_large, large y full.

Al usar el shortcode, el plugin intentará eliminar la imagen destacada de la posición por defecto en tu tema para evitar que aparezca dos veces. Se trata de una función experimental y los resultados pueden variar. Tampoco aparecerá en listas.

Ejemplo de uso: [FSM_featured_image size=thumb]

Para desarrolladores

El plugin incluye dos funciones públicas que te permiten obtener o mostrar en cualquier lugar de tu plantilla la leyenda de la imagen destacada de la entrada en curso.

Una vez el plugin activado, utiliza <?php get_FSM_featured_image_caption()?> para devolver una cadena con el texto que podrás asignar a una variable o <?php the_FSM_featured_image_caption()?> allí donde desees mostrar la leyenda.

Both functions accept parameters passed inside an array with the following keys:

  • tag: The tag (without brackets) you want to use as a container. By default is div. If set to false, it will remove it and will return the caption text.
  • class: The name of the class/classes you want to use for the container. Use spaces to separate them. Empty by default.
  • style: The CSS styles to be used in the container tag. Empty by default.
  • force_visibility: When set to true, it ignores the hide caption option defined by the post editor. Useful for displaying your caption in a different place, but showing the featured image. Default: false.
  • allow_html: like in the settings page, if set to true, allows the browser to parse the HTML code inside the caption text, else shows it as plain text. Default: false.

Usage example: php
the_FSM_featured_image_caption( array('tag' => 'p', 'class' => 'class1 class2', 'style' => 'color: red;', 'allow_html'=> true );

Traducciones

El plugin viene con tres traducciones completas:

  • Inglés (en)
  • Español (es_ES)
  • Catalán (ca)

Puedes contribuir traduciendo el plugin a más idiomas en https://translate.wordpress.org/projects/wp-plugins/fsm-custom-featured-image-caption/

Próximamente

  • Más opciones para seleccionar el texto que se va a usar como leyenda, permitiendo elegir entre el título / la leyenda / el texto «alt» / la descripción de la imagen y un texto personalizado.
  • Options to fine-tune the shortcode.
  • ¿Tienes más ideas? ¡Queremos oírlas!

Capturas

  • Página de configuración del plugin.
  • El plugin en la página de edición de entradas.

Instalación

Instalación automática

Accede a tu escritorio de WordPress, ve al menú de Plugins y haz clic en «Añadir nuevo». En el campo de búsqueda teclea «FSM Custom Featured Image Caption» y haz clic en «Buscar plugins». Una vez que lo hayas encontrado, haz clic en «Instalar ahora». Eso es todo.

Instalación manual

  1. Sube la carpeta fsm-custom-featured-image-caption al directorio /wp-content/plugins/.
  2. Activa el plugin a través del menú «Plugins» en WordPress.
  3. Usa el plugin en la página de edición de entradas.

FAQ

  1. ¿Funciona con cualquier tema?
    Sí, mientras que el tema sea compatible con imágenes destacadas/miniaturas de entradas y use get_the_post_thumbnail en el código.

  2. 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.

Reseñas

27 de junio de 2019
This was exactly what I was needing. Thank you for creating this plugin! I was looking for a way to add an image credit to my blog featured images. This plugin paired with another one I found that allows me to link my featured images is exactly what I needed.
2 de enero de 2019
This plugin gives you full control over the featured image caption. Moreover, there is fast support from the developer, so if there are some problems, they will be solved soon. Great job!
11 de octubre de 2018
This plugin is most useful if you use pictures as featured images that are not your own and need to give credit for them. It works as described and the support is awesome. When I had an issue with the plugin the developer replied and fixed the problem within 24h. Recommend!
9 de agosto de 2018
Thank you for the plugin and quick support!
Leer todas las 10 reseñas

Colaboradores y desarrolladores

«FSM Custom Featured Image Caption» es un software de código abierto. Las siguientes personas han colaborado con este plugin.

Colaboradores

«FSM Custom Featured Image Caption» ha sido traducido a 2 idiomas locales. Gracias a los traductores por sus contribuciones.

Traduce «FSM Custom Featured Image Caption» a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.

Registro de cambios

1.19

  • Added «settings» link in the wordpress plugins list page
  • Some texts modified

1.18

  • Added support for Gutenberg
  • Code optimization

1.17

  • Improved the detection of the post-id called by post_thumbnail_html to avoid wrong results on themes showing multiple featured images of different posts
  • Additional condition to stop processing the featured image if there is no content
  • Minor variable corrections

1.16

  • Modified the way the plugin detects if called from a list for widgets and other plugins showing a list of posts from a single page
  • Added option to show the caption when the featured image appears on a list

1.15

  • Added a check to return an empty string if there is no caption text instead of an empty figcaption (or custom tag) to prevent weird spacing in some themes.

1.14

  • Corrected identification of single pages where the caption was not appearing
  • Renamed the public function names to a more specific ones in order to avoid conflicts with future versions of wordpress or other plugins. It also fixes the naming to follow wordpress conventions.
  • Added shortcode to show the featured image and it’s caption inside the post contents (experimental)

1.13

  • Minor correction: added check to save_post hook to prevent Notices appearing in some cases while on debug mode

1.12

  • Corrected: The plugin was using figure instead of figcaption in the default parameters
  • Allow public functions to be used without parameters (fall back to the defaults)

1.11

  • Corrected: Save the parameters on load to prevent losing them in some circumstances

1.10

  • Nueva página de ajustes para personalizar los estilos y la presentación
  • Se han añadido funciones públicas para que los usuarios avanzados las puedan utilizar dentro de las plantillas del tema

1.01

  • Mejoras en el textdomain y en las traducciones
  • Se mantienen los parámetros después de seleccionar otra imagen.

1.0

  • Versión estable.