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 amb llegenda dins del contingut amb un codi de substitució..

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

Novetat a la versió 1.21: Compatibilitat amb els temes Divi. Aquesta és una característica experimental per permetre que el connector funcioni amb Divi, tal com han demanat molts usuaris. Tingueu en compte que és possible que no funcioni per a tots els dissenys i que, ja que substitueix la funció que fa servir Divi per mostrar imatges destacades, quan estigui activada pot causar problemes amb versions anteriors de Divi o si el tema principal s’actualitza. Com sempre, també pot ser necessari afegir css personalitzats al tema per mostrar els subtítols de la manera que vulgueu

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.
• Permet els shortcodes: marqueu-ho si voleu processar els shortcodes presents al text dels subtítols. Tingueu en compte que si el codi curt retorna HTML, no es filtrarà, independentment de l’estat de l’opció “permetre codi html”; a més, la sortida de shortcodes complexos pot alterar el vostre disseny. Quan estigui activat, podeu escriure el shortcode que vulgueu utilitzar al quadre de subtítols de la manera habitual, és a dir: Paisatge venecià [myshortcode option1 = "text"]
• 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.
• Activa la compatibilitat amb els temes de Divi: Desactivat de manera predeterminada. Permet que el connector funcioni amb Divi. Llegiu les seccions de descripció i PMF per obtenir més informació sobre aquesta opció.

Codi de substitució

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.

Tingueu en compte que l’ús del shortcode no està relacionat amb l’opció “Permetre shortcodes” a la pàgina de configuració.

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.
• allow_shortcodes: De nou el mateix comportament que a la pàgina de configuració. Valor per defecte: false.
• ignore_original_caption: stops using captions defined in the media library as a substitution when the caption field is empty. Default: false.

Exemple d’ús: php
the_FSM_featured_image_caption( array('tag' => 'p', 'class' => 'class1 class2', 'style' => 'color: red;', 'allow_html'=> true, 'allow_shortcodes'=>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!