FSM Custom Featured Image Caption

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

El plugin también 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.
• Muestra la imagen destacada con la leyenda dentro de tu contenido con un shortcode.

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

Nuevo en la versión 1.21 : compatibilidad con temas Divi. Esta es una característica experimental que permite que el complemento funcione con Divi, como lo solicitaron muchos usuarios. Hay que tener en cuenta que es posible que no funcione para todos los diseños y que, dado que reemplaza la función que divi usa para mostrar imágenes destacadas cuando está habilitado, podria causar problemas con versiones anteriores de Divi o si el tema principal se actualiza. Como siempre, también puede ser necesario agregar CSS personalizado a su tema para mostrar los subtítulos de la manera que desee.

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.
• Permitir shortcodes : márquelo si desea procesar los shortcodes presentes en el texto de la leyenda. Tenga en cuenta que si el shortcode devuelve HTML, no se filtrará, independientemente del estado de la opción «permitir código html»; Además, la salida de shortcodes complejos puede alterar su diseño. Cuando está activado, puede escribir el shortcode que desea usar en el cuadro de título de la manera habitual, es decir: Paisaje veneciano [mishortcode option1 = "text"]
• 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.
• Habilitar la compatibilidad con temas Divi : deshabilitado de forma predeterminada. Permite que el complemento funcione con Divi. Lea la descripción y las secciones de preguntas frecuentes para obtener más información sobre esta opción.

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.

Tenga en cuenta que el uso del shortcode no está relacionado con la opción «Permitir shortcodes» de la página de configuración.

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.

Ambas funciones aceptan parámetros pasados dentro de un array con las siguientes claves:

• tag: La etiqueta (sin corchetes) que quieres usar como contenedor. Por defecto es div. Si se establece en falso, se eliminará y devolverá el texto de la leyenda.
• class: El nombre de la clase o clases que quieres usar para el contenedor. Usa espacios para separarlos. Vacío por defecto.
• style: Los estilos CSS que se utilizarán en la etiqueta del contenedor. Vacío por defecto.
• force_visibility: Cuando se establece en verdadero, se ignora la opción de ocultar la leyenda definida por el editor de entradas. Útil para mostrar la leyenda en un lugar diferente, pero mostrando la imagen destacada. Por defecto: false.
• allow_html: Como en la página de configuración, si se establece en verdadero, permite que el navegador analice el código HTML dentro de la leyenda, de lo contrario lo muestra como texto sin formato. Por defecto: false.
• allow_shortcodes: nuevamente el mismo comportamiento que en la página de configuración. Predeterminado: false .
• ignore_original_caption: stops using captions defined in the media library as a substitution when the caption field is empty. Default: false.

Ejemplo de uso: php the_FSM_featured_image_caption( array('tag' => 'p', 'class' => 'class1 class2', 'style' => 'color: red;', 'allow_html'=> true, 'allow_shortcodes'=>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.
• Opciones para configurar el shortcode.
• ¿Tienes más ideas? ¡Queremos oírlas!