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

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.

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_featured_image_caption()?> per obtenir un string que conté el text que podràs assignar a una variable, o utilitza <?php the_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_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.
  • 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.
Instruccions d’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.

Ressenyes

Very useful!

Thanks for creating this plugin! It is just what I was looking for!
Planned custom CSS features would make the plugin even more awesome.

You say that options for selecting the text to be used as the caption, allowing to choose from image Title / Caption / Alt Text / Description and custom text, is planned too. Maybe you can also consider a feature that, for example, uses image caption as an image caption, and say, image description as a credited source.

For example like here on Ars, where image credit is in a vertical position:
https://arstechnica.com/gadgets/2017/09/ios-11-on-the-iphone-5s-slower-but-not-quite-slow/

All the best!

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” has been translated into 2 locales. 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.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.