FSM Custom Featured Image Caption

Descripció

Aquesta extensió permet afegir una llegenda personalitzada a la imatge destacada d’una entrada. Funciona de la següent manera:

  • Si no s’indica cap llegenda a l’extensió, es mostrarà la llegenda genèrica definida a la Biblioteca.
  • Si s’indica una llegenda a l’extensió, es mostrarà aquesta en lloc de la llegenda genèrica definida a la Biblioteca.
  • Si no s’indica cap llegenda a l’extensió ni tampoc a la Biblioteca, no es mostra res (òbviament).

L’extensió també permet:

  • Amagar la llegenda, tant l’original de la Mediateca com la personalitzada.
  • Ocultar completament la imatge destacada a la pàgina publicada, sense la necessitat de des-adjuntar-la de l’entrada.
  • Diverses opcions per modificar l’estil de la llegenda
  • Mostrar el text de la llegenda a qualsevol lloc del tema utilitzant una funció personalitzada
  • Output the featured image with caption inside your content with a shortcode (experimental)

Aquesta extensió escriu la llegenda dins l’etiqueta <figcaption> per mantenir la semàntica correcta del codi font.

Format

La llegenda adopta el format especificat per a l’element <figcaption> i la classe CSS wp-caption-text, les habituals en els temes del WordPress.

Ús

Per defecte, l’extensió funciona sense necessitat de cap configuració. Només cal activar-la i podràs utilitzar les noves opcions que trobaràs a la secció d’imatge destacada de la pàgina d’edició d’entrades. Tanmateix, l’extensió crea una pàgina de configuració per a usuaris avançats que et permetrà realitzar alguns ajustos addicionals. Visita Opcions > FSM Custom Featured Image Caption per configurar alguns paràmetres CSS i HTML:

  • CSS per al text de la llegenda: tria alguna de les opcions per modificar la classe o l’estil que es farà servir al contenidor de la llegenda (per defecte és wp-caption-text). Pots indicar més d’una classe, separades amb espais.
  • Permet codi HTML: marca aquesta opció si vols que s’interpreti el codi HTML (per exemple “Foto de Joana Pinyol“). Tingues en compte que codi HTML incorrecte o etiquetes òrfenes poden fer malbé la teva pàgina.
  • Show image captions in lists: Check if you want to show the caption when the featured image appears in a list, i.e. in a category page, in a widget showing the latests posts, etc. Disabled by default. Note that some themes may add containers around the image (i.e. a link tag) that can interfere with the correct presentation of the caption

Shortcode

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 and it will appear. 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 being: thumbnail, medium, medium_large, large and full.

When you use the shortcode, the plugin will try to remove the featured image from your theme’s default position (so it doesn’t appears twice, but as this is an experimental feature, results may vary. It also will not appear in lists

Usage example
[FSM_featured_image size=thumb]

Per a desenvolupadors

L’extensió inclou dues funcions públiques que permeten obtenir i mostrar la llegenda personalitzada de l’entrada actual a qualsevol lloc del tema.

Amb l’extensió activa, utilitza <?php get_FSM_featured_image_caption()?> per obtenir un string que conté el text que podràs assignar a una variable, o utilitza <?php the_FSM_featured_image_caption()?> allà on vulguis que es mostri la llegenda.

Aquestes dues funcions accepten paràmetres passats dins d’un array amb les següents keys:

  • tag: l’etiqueta (sense parèntesis) que vols fer servir de contenidor. Per defecte és div. Si es configura com a false s’eliminarà i simplement es retornarà el text de la llegenda.
  • class: El nom de la classe o classes que es vol utilitzar per al contenidor. Utilitza un espai per a separar-les. Per defecte està en blanc.
  • style: Els estils CSS que s’aplicaran a l’etiqueta del contenidor. Per defecte està en blanc.
  • force_visibility: quan s’estableix en true, s’ignora l’opció hide caption configurada a l’editor d’entrades. Pot ser d’utilitat si vols mostrar la llegenda en un lloc diferent tot i mantenir visible la imatge destacada. Per defecte: false
  • allow_html: com a la pàgina de configuració, si es configura en true, permet que el navegador analitzi el codi HTML dins de la llegenda. Si no, es mostrarà com a text pla. Per defecte: false

Exemple d’ús:

php

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

Traduccions

L’extensió inclou 3 traduccions completes:

  • Anglès (en)
  • Espanyol (es_ES)
  • Català (ca)

Properament

  • Més opcions per seleccionar el text de la llegenda, tot permetent triar entre el títol, la llegenda, el text alt o la descripció de la imatge. O bé un text totalment personalitzat.
  • Options to fine tune the shortcode.
  • Tens més idees? Volem sentir-les!

Captures

  • Pàgina de configuració de l'extensió.
  • L'extensió a la pàgina d'edició d'entrades.

Instal·lació

  1. Puja fsm-custom-featured-image-caption a la carpeta /wp-content/plugins/
  2. Activa l’extensió a través de l’opció ‘Extensions’ del menú del WordPress
  3. Pots utilitzar l’extensió a la pàgina d’edició d’entrades.

PMF

  1. Funciona amb qualsevol tema?
    Sí, sempre que el tema sigui compatible amb imatges destacades i utilitzi
    get_the_post_thumbnail al codi font.

  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 in order 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 and in others you are required 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.

Ressenyes

Works well, awesome support

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!

Great plugin & support

This plugin is just what I need to display featured image captions so I can properly give credit to my image sources (even though I’ll be using mostly free images). I like the “Allow HTML code” option in the plugin’s settings page so I can even link back to an image source directly in the caption.

The support for this plugin is great too. Plugin author Fesomia was responsive and quick to troubleshoot an issue I had with the caption not wrapping properly on smaller screens (easily resolved with just a minor CSS fix which you can read about in the support forum for this plugin).

Keep up the great work, Fesomia, and look forward to further updates to this already useful plugin!

Easily Add Captions To Feature Images

I was looking for a way to display captions below feature images. I tried another plugin available for just this purpose, however it did not work correctly and was last updated over two years ago. FSM Custom Featured Image Caption not only works to display captions on feature images, it also provides additional options for enhanced customization. When I had a support inquiry, Fesomia replied quickly with an explanation about the notices I was seeing (while in debug mode) and a minor update to their plugin.

Llegiu totes les 7 ressenya

Col·laboradors i desenvolupadors

"FSM Custom Featured Image Caption" és programari de codi obert. La següent gent ha contribuït en aquesta extensió.

Contribuïdors

“FSM Custom Featured Image Caption” s'ha traduït a 2 localitzacions. Gràcies als traductos per les seves aportacions.

Tradueix “FSM Custom Featured Image Caption” a la teva llengua.

Interessats en el desenvolupament?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Registre de canvis

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

  • Pàgina de configuració per a personalitzar els estils i la presentació
  • S’han afegit funcions públiques perquè els usuaris avançats les puguin utilitzar a les plantilles dels temes

1.01

  • Millores al textdomain i a les traduccions
  • Es mantenen els paràmetres després de seleccionar una altra imatge

1.0

  • Versió estable.