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).
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!
Capturas
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
- Sube la carpeta
fsm-custom-featured-image-caption
al directorio/wp-content/plugins/
. - Activa el plugin a través del menú «Plugins» en WordPress.
- Usa el plugin en la página de edición de entradas.
FAQ
-
¿Funciona con cualquier tema?
Sí, mientras que el tema sea compatible con imágenes destacadas/miniaturas de entradas y useget_the_post_thumbnail
en el código. -
¿Funciona con Divi?
No de forma predeterminada, pero tiene una opción en la página Opciones para habilitar la compatibilidad. Tenga en cuenta que esta es una función experimental y que, dado que Divi no ofrece una forma más fácil de conectar la función que muestra la imagen destacada, el complemento intenta reemplazarla. Tenga en cuenta que, si bien será generalmente seguro activarlo, esto puede resultar en incompatibilidades o incluso errores en versiones anteriores de Divi o si una actualización de Divi cambia esa función en particular. Dado que se trata de un tercero, no podemos ofrecer asistencia si esta opción no funciona con su diseño o instalación. -
Estoy usando el tema X y la leyenda no aparece/aparece en un lugar incorrecto o tiene un color/fondo diferente, etc.
Ten en cuenta que el plugin solo agrega algunas etiquetas a la imagen para mostrar la leyenda. Aparte del posible CSS personalizado que hayas configurado, no se agregan estilos al tema. En la mayoría de los casos, el resultado acostumbra a ser correcto. En otros, tal vez tengas que modificar tu tema o agregar estilos CSS personalizados (normalmente en Apariencia > Personalizar) para que la leyenda y el contenedor se vean como esperas.
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» está traducido en 2 idiomas. 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.24
- Added a global option in the general settings page to ignore the image captions defined for the image in the Media library. Tested compatibility up to wp 6.1
1.23
- Bug fix: removed warnings that appeared in some cases
1.22
- Corrección de fallos: Restaurada la clase «destacada» eliminada accidentalmente
1.21
- Nueva configuración experimental en la página de opciones para que el complemento sea compatible con los temas Divi
1.20
- Se agregó una opción general para permitir shortcodes en la leyenda
- Mensaje de aviso eliminado
- Comprobada la compatibilidad con WordPress 5.6
1.19
- Se ha añadido un enlace a la configuración del plugin en la página de plugins de WordPress
- Mejoras en algunos textos
1.18
- Nuevo: Compatible con Gutenberg
- Optimizaciones de código
1.17
- Mejoras en la detección del post-id llamado por post_thumbnail_html para evitar resultados incorrectos en temas que muestran múltiples imágenes destacadas de diferentes publicaciones
- Condición adicional para dejar de procesar la imagen destacada cuando no hay contenido
- Pequeñas correcciones
1.16
- Se ha mejorado la forma en que el plugin detecta si es llamado desde una lista de widgets u otros plugins que muestran listas de entradas de una sola página.
- Se ha añadido una opción para mostrar el título cuando la imagen destacada aparece en listas
1.15
- Añadida una comprobación para devolver una cadena vacía si no hay leyenda, en lugar de un figcaption vacío (u otra etiqueta personalizada), para evitar espacios inesperados en algunos temas.
1.14
- Se ha corregido la identificación de páginas individuales donde no aparece la leyenda
- Se ha cambiado el nombre de las funciones públicas por otros más específicos para evitar conflictos con futuras versiones de WordPress u otros plugins. También se ha corregido la nomenclatura para seguir las convenciones de WordPress.
- Se ha añadido un shortcode para mostrar la imagen destacada y su leyenda dentro del contenido de la entrada (experimental)
1.13
- Corrección menor: se ha añadido una verificación al gancho save_post para evitar que aparezcan avisos en algunos casos mientras se está en modo de depuración
1.12
- Corregido: el plugin usaba figure en lugar de figcaption en los parámetros predeterminados
- Se permite que las funciones públicas se utilicen sin parámetros (recuperando los valores por defecto)
1.11
- Corregido: los parámetros se guardan al cargar para evitar perderlos en algunas circunstancias
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.