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!
Captures
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
- Puja
fsm-custom-featured-image-caption
a la carpeta/wp-content/plugins/
- Activa l’extensió a través de l’opció ‘Extensions’ del menú del WordPress
- Pots utilitzar l’extensió a la pàgina d’edició d’entrades.
PMF
-
Funciona amb qualsevol tema?
Sí, sempre que el tema sigui compatible amb imatges destacades i utilitziget_the_post_thumbnail
al codi font. -
Funciona amb Divi?
No per defecte, però teniu una opció a la pàgina Opcions per habilitar la compatibilitat. Tingueu en compte que es tracta d’una característica experimental i que, com que Divi no ofereix una manera més senzilla de fer un hook a la funció que mostra la imatge destacada, el connector intenta substituir-la. Tot i que serà generalment segur activar-lo, això pot provocar incompatibilitats o fins i tot errors en versions anteriors de Divi o si una actualització de Divi canvia aquesta funció en particular. Com que implica un tercer, no us podrem oferir ajuda si aquesta opció no funciona amb el vostre disseny o instal·lació -
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
Col·laboradors i desenvolupadors
«FSM Custom Featured Image Caption» és programari de codi obert. La següent gent ha col·laborat en aquesta extensió.
Col·laboradors“FSM Custom Featured Image Caption” s’ha traduït a 2 configuracions regionals. Gràcies als traductors per les seves aportacions.
Traduïu «FSM Custom Featured Image Caption» a la vostra 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.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
- Bug fix: restored accidentally removed class “featured”
1.21
- Nou paràmetre experimental a la pàgina d’opcions per fer compatible el connector amb els temes de Divi.
1.20
- S’ha afegit una opció general per permetre shortcodes al títol
- S’ha eliminat un missatge d’avís
- S’ha comprovat la compatibilitat amb WP 5.6
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 defigcaption
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.