FSM Custom Featured Image Caption

Descripció

Aquesta extensió us permet afegir llegendes a les imatges destacades a les entrades. Funciona tant amb Gutenberg com amb l’editor clàssic.

Funciona així:

  • 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 els estils de la llegenda.
  • Mostrar el text de la llegenda a qualsevol lloc del tema utilitzant una funció personalitzada.
  • Mostrar la imatge destacada i la llegenda dins de qualsevol contingut mitjançant un shrotcode.

Per mantenir la semàntica del codi font, l’extensió defineix la llegenda dins d’una etiqueta <figcaption>.

Format

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

Ús

L’extensió funciona des del primer moment. Per començar a utilitzar-la només heu d’activar-la i configurar les noves opcions que trobareu a la pàgina d’edició d’entrades. Si sou un usuari avançat, trobareu algunes configuracions especials amb què podreu afinar més detalls.

Accediu a Settings > FSM Custom Featured Image Caption per configurar el CSS i els paràmetres HTML:

  • CSS per al text de la llegenda: Trieu 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). Podeu indicar més d’una classe, separades amb espais.
  • Permet el codi HTML: Marqueu-lo si voleu processar el text de les llegendes com a HTML perquè el navegador les interpreti. Penseu que un codi HTML incorrecte pot espatllar el format de la pàgina.
  • Mostra les llegendes a les llistes: Desactivat per defecte. Marqueu-lo si voleu mostrar les llegendes quan les imatges destacades apareixen en llistats, com a les pàgines de categories, en ginys amb les últimes entrades, etc. Penseu que alguns temes poden afegir contenidors al voltant de les imatges (enllaços, per exemple) que poden entrar en conflicte amb l’aspecte de les llegendes.

Shortcode

Hem incorporat un shortcode que us permet inserir la imatge destacada i la seva llegenda en qualsevol lloc. Simplement escriviu [FSM_featured_image] en qualsevol punt de l’editor d’entrades. També podeu triar la mida de la imatge amb el paràmetre “size”. Peneu que les mides de les imatges poden variar entre diferents temes de WordPress. Les mides predefinides són: thumbnail, medium, medium_large, large i full.

Utilitzant el shortcode, l’extensió intentarà eliminar la imatge destacada de la ubicació per defecte al vostre tema per evitar que es mostri dues vegades. Aquesta funcionalitat és experimental i els resultats poden ser variables. Tampoc no apareixerà a les llistes.

Exemple d’ús: [FSM_featured_image size=thumb]

Per a desenvolupadors

L’extensió incorpora dues funcions públiques que us permeten obtenir o mostrar la llegenda de la imatge destacada de l’entrada actual a qualsevol lloc del vostre tema.

Amb l’extensió activada, utilitzeu <?php get_FSM_featured_image_caption()?> per mostrar una cadena amb el text que utilitzareu com a variable o <?php the_FSM_featured_image_caption()?> allà on vulgueu mostrar la llegenda.

Aquestes dues funcions accepten paràmetres passats dins d’una matriu amb les següents claus:

  • tag: L’etiqueta (sense parèntesis) que voleu fer servir de contenidor. Per defecte és div. Si es configura com a fals, s’eliminarà i simplement es retornarà el text de la llegenda.
  • class: El nom de la classe o classes que voleu utilitzar per al contenidor. Utilitzeu 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. Útil quan voleu 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 verdader, 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)

Podeu contribuir a traduir l’extensió a més idiomes a https://translate.wordpress.org/projects/wp-plugins/fsm-custom-featured-image-caption/

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.
  • Opcions per ajustar el shortcode.
  • Teniu 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ó

Instal·lació automàtica

Accediu al vostre escriptori de WordPress, aneu al menú d’Extensions i feu clic a Afegeix. Al camp de cerca, escriviu “FSM Custom Featured Image Caption”. Quan la trobeu, cliqueu a “Instal·la ara”. Un cop finalitzada la instal·lació, cliqueu “Activa” per activar l’extensió.

Instal·lació manual

  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. Faig servir el tema X i la llegenda no apareix o apareix en un lloc incorrecte, o mostra un color o fons diferent, etc.

    Aquesta extensió només afegeix algunes etiquetes a la imatge per poder mostrar la llegenda. Tret del codi CSS que especifiqueu a la configuració, no afegeix cap estil al tema. Normalment el resultat acostuma a ser correcte. En algun cas potser caldrà ajustar el tema o afegir estils CSS addicionals (per exemple a Aparença> Personalitza) per fer que la llegenda o el seu contenidor es mostrin com espereu.

Ressenyes

27 juny 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 gener 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 octubre 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 agost 2018
Thank you for the plugin and quick support!
Llegiu totes les 10 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?

Navegueu pel codi, baixeu-vos el repositori SVN, o subscriviu-vos al registre de desenvolupament per fisl de subscripció RSS.

Registre de canvis

1.19

  • S’ha afegit un enllaç a la configuració de l’extensió dins la llista d’extensions de WordPress
  • S’han modificat alguns textos

1.18

  • Ara l’extensió també és compatible amb Gutenberg
  • S’ha optimitzat el codi font

1.17

  • S’ha millorat la detecció de l’ID del post cridat per post_thumbnail_html per evitar resultats incorrectes en els casos que es mostren múltiples imatges destacades de diferents entrades.
  • S’ha afegit una nova condició per aturar el processament de la imatge destacada si no existeix contingut.
  • Diverses correccions menors

1.16

  • S’ha millorat el mètode de detecció de crides des de llistes per ginys o altres extensions que mostren llistes d’entrades en una sola pàgina
  • S’ha afegit l’opció de mostrar la llegenda quan la imatge destacada apareix en llistats

1.15

  • S’ha afegit una opció que retorna una cadena buida si no existeix la llegenda, en comptes d’una etiqueta figcaption buida o qualsevol altra, per evitar espais estranys en alguns temes.

1.14

  • S’ha corregit la identificació de les pàgines on no apareix la llegenda.
  • S’ha canviat els noms de les funcions públiques per uns de més específics amb la intenció d’evitar conflictes amb futures versions del WordPress o altres extensions. Els noms nous també segueixen les convencions del WordPress.
  • S’ha incorporat un shortcode que mostra la imatge destacada i la seva llegenda dins de qualsevol entrada (experimental)

1.13

  • Correcció menor: s’ha afegit una opció a save_post per a evitar que apareguin notificacions en alguns casos mentre està activat el mode debug.

1.12

  • Corregit: l’extensió feia servir figure en lloc de figcaption als paràmetres predeterminats
  • Permet que les funcions públiques s’utilitzin sense paràmetres (tornada als valors predeterminats)

1.11

  • Corregit: Ara es guarden els paràmetres en carregar la pàgina per evitar la seva pèrdua en algunes circumstàncies.

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.