Imagen automática para LinkedIn en WordPress
La imagen Open Graph es la imagen que LinkedIn muestra cuando compartes un enlace. En esta entrada explico, paso a paso y de forma sencilla, cómo hice que WordPress la cree automáticamente con PHP cada vez que publico, para que siempre tenga el título correcto sin hacerla a mano.
Cuando compartes un enlace en LinkedIn, aparece una tarjeta con una imagen, un título y una descripción. En este artículo te cuento, paso a paso y sin complicaciones, cómo hice que WordPress cree esa imagen solo, cada vez que publico una entrada.
El problema
Al principio yo creaba la imagen de cada entrada a mano. Eso tenía dos problemas:
- Si me olvidaba, LinkedIn mostraba la tarjeta sin imagen.
- Si cambiaba el título de la entrada, la imagen seguía mostrando el título viejo. La imagen es una «foto»: el texto que tiene dibujado no se actualiza solo.
¿De dónde saca LinkedIn la tarjeta?
De unas etiquetas ocultas en el código de tu página, llamadas Open Graph. Tú no las ves, pero LinkedIn, Facebook o WhatsApp sí las leen:
<meta property="og:title" content="LDAP Reconnaissance">
<meta property="og:description" content="Qué es y cómo detectarlo...">
<meta property="og:image" content="https://.../og-ldap.png">
og:title: el título de la tarjeta.og:description: el texto de debajo.og:image: la imagen.
En mi blog, el plugin The SEO Framework escribe estas etiquetas por mí, y para og:image usa la imagen destacada de la entrada. Así que la solución era sencilla: si WordPress crea la imagen destacada automáticamente, LinkedIn siempre tendrá una imagen correcta.
Qué necesité
- WPCode: un plugin que permite agregar código PHP a WordPress sin tocar los archivos del tema.
- GD: una herramienta de PHP para dibujar imágenes. La mayoría de hostings la traen; lo comprobé en Herramientas → Salud del sitio → Información.
- Una fuente en formato .ttf: usé Josefin Sans, la misma de los títulos del blog, para que la imagen combine con el sitio.
Paso 1: dibujar la imagen
Piensa en GD como un programa de dibujo que se maneja con instrucciones. Le decimos: «crea un lienzo, píntalo de negro y escribe el título en blanco».
// 1. Crear un "lienzo" vacío de 1200 x 627 píxeles
$im = imagecreatetruecolor( 1200, 627 );
// 2. Pintarlo de negro (rojo 10, verde 10, azul 10 = casi negro)
imagefill( $im, 0, 0, imagecolorallocate( $im, 10, 10, 10 ) );
// 3. Preparar el color blanco para el texto
$blanco = imagecolorallocate( $im, 255, 255, 255 );
// 4. Escribir el título con la fuente Josefin Sans
// (tamaño, ángulo, posición x, posición y, color, archivo de fuente, texto)
imagettftext( $im, 112, 0, $x, $y, $blanco, $fuente, 'LDAP Reconnaissance' );
El tamaño 1200 × 627 no es casual: es la medida que LinkedIn recomienda para que la tarjeta se vea grande.
Paso 2: que el título quepa y quede centrado
No todos los títulos miden lo mismo. «Kerberoasting» es corto, pero un título de diez palabras no cabe en una línea. Por eso, antes de dibujar, el código mide el texto:
// imagettfbbox() NO dibuja: solo mide cuánto ocuparía el texto
$caja = imagettfbbox( $tamano, 0, $fuente, $texto );
$ancho = $caja[2] - $caja[0];
// Si es más ancho que 1000 px, probamos con letra más pequeña
while ( $ancho > 1000 ) {
$tamano = $tamano - 3;
$caja = imagettfbbox( $tamano, 0, $fuente, $texto );
$ancho = $caja[2] - $caja[0];
}
// Centrar: (ancho de la imagen - ancho del texto) / 2
$x = ( 1200 - $ancho ) / 2;
En el código real hago lo mismo, pero además parto el título en varias líneas (hasta tres) cuando es largo, y lo centro también de arriba abajo.
Paso 3: guardar la imagen y ponerla como destacada
Ya tenemos la imagen en memoria. Ahora hay que guardarla como archivo, registrarla en la Biblioteca de medios y asignarla a la entrada:
// Guardar el PNG en la carpeta de subidas de WordPress
$archivo = wp_upload_bits( 'og-mi-entrada.png', null, $png );
// Registrarlo en la Biblioteca de medios
$id_imagen = wp_insert_attachment( array(
'post_mime_type' => 'image/png',
'post_title' => 'OG: ' . $titulo,
'post_status' => 'inherit',
), $archivo['file'], $id_entrada );
// Ponerlo como imagen destacada de la entrada
set_post_thumbnail( $id_entrada, $id_imagen );
Paso 4: que se ejecute solo
WordPress avisa cuando pasan ciertas cosas, por ejemplo «acabo de guardar una entrada». Esos avisos se llaman hooks (ganchos). Nosotros nos «enganchamos» a ese aviso para ejecutar nuestro código en ese momento:
// "Cuando WordPress termine de guardar una entrada, ejecuta esto"
add_action( 'wp_after_insert_post', function ( $id_entrada, $entrada ) {
// Solo entradas (no páginas) y solo si están publicadas
if ( $entrada->post_type !== 'post' || $entrada->post_status !== 'publish' ) {
return;
}
// Crear la imagen (si hace falta)
vz_og_generate( $id_entrada );
}, 20, 2 );
Dentro de la función que crea la imagen puse tres reglas sencillas:
- Si la entrada no tiene imagen destacada, la crea.
- Si la imagen la creó este código y el título cambió, la vuelve a crear y borra la anterior.
- Si yo puse una imagen a mano, no la toca.
Para saber qué imagen creó el código y con qué título, guardo esos dos datos en la entrada como metadatos (información extra que WordPress guarda junto a cada entrada).
Paso 5: comprobar en LinkedIn
LinkedIn guarda una copia de cada tarjeta (caché). Si cambias la imagen, LinkedIn puede seguir mostrando la vieja. Para obligarlo a leerla de nuevo, pega la URL de tu entrada en el Post Inspector de LinkedIn.
Ojo: pega la URL del artículo, no la de la imagen. Si pegas la URL de un archivo .png, LinkedIn dirá que no encuentra título ni descripción, porque una imagen no tiene etiquetas Open Graph.
Lo que aprendí en el camino
- Menos es más. Probé a poner dentro de la imagen etiquetas, mi nombre, la URL, una descripción, una línea decorativa y un degradado. En la tarjeta pequeña de LinkedIn todo eso se veía borroso. Lo que mejor funcionó fue solo el título, grande, blanco sobre negro.
- La descripción va fuera de la imagen. LinkedIn ya muestra el título y el dominio debajo de la imagen; no hace falta repetirlos dentro.
- Medir antes de dibujar. Mi primera versión cortaba la palabra «Reconnaissance» porque no medía el ancho real del texto.
- Probar antes de dar por terminado. Después de instalar el código, cambié el título de una entrada para comprobar que la imagen se regeneraba sola, y luego lo devolví a su valor original.
Resumen
Con unas 150 líneas de PHP en WPCode, cada entrada que publico tiene su imagen para LinkedIn, con el mismo estilo y siempre con el título correcto. Lo único que hago a mano es pasar la URL por el Post Inspector antes de compartirla.