Incrustar Contenido en WordPress

Este elemento es una expansión del contenido de los cursos y guías de Lawi. Ofrece hechos, comentarios y análisis sobre este tema. [aioseo_breadcrumbs] Todo lo que tiene que hacer para incrustar algo en un artículo o página es añadir su URL a su área de contenido. Asegúrese de que la URL está en su propia línea y no es un hipervínculo (se puede hacer clic cuando se muestra el contenido).

Por ejemplo:

https://www.youtube.com/…

WordPress lo convertirá automáticamente en un vídeo de YouTube cuando muestre el contenido.

También puedes incluir la URL en el shortcode

. Esto tendrá el mismo efecto, pero la URL no necesita estar en su propia línea. Esto también permite establecer una anchura y una altura máximas (pero no fijas): ….

Si WordPress no logra incrustar el contenido de su URL, entonces simplemente mostrará la URL (sin incluir ninguna característica especial).

oEmbed

Esta sencilla función de incrustación se realiza con mayor frecuencia mediante oEmbed; se trata de un protocolo que permite al sitio A (como su blog) solicitar a un sitio B proveedor de contenidos (como YouTube), el código HTML necesario para incrustar contenidos del sitio B en su sitio A.

oEmbed ha sido diseñado para evitar tener que copiar y pegar el código HTML del sitio que aloja los medios que quieres incrustar. Admite vídeos, imágenes, texto y mucho más.

oEmbed se compone de un consumidor y un proveedor. El proveedor proporciona recursos que pueden ser incrustados en el consumidor y el consumidor solicita esos recursos a través del endpoint de oEmbed.

Los tipos Photo, Video y Rich deben proporcionar una URL, anchura y altura en su respuesta. Los proveedores pueden incluir también otros datos, pero esto es todo lo que se requiere cuando se trata de este tipo de contenido. La especificación oEmbed es una guía, los proveedores pueden hacer su propia implementación de oEmbed. El proveedor debe tener al menos un endpoint oEmbed y una URL de recursos.

Echemos un vistazo a SlideShare y veamos cómo han implementado oEmbed.

En su documentación especifican el endpoint oEmbed y el endpoint de recursos. El endpoint de oEmbed es: https://www.slideshare.net/api/oembed/2. El endpoint del recurso se parece a esto: https://www.slideshare.net/user-slug/slidename-slug. Para obtener la información del proveedor, debemos utilizar el endpoint oEmbed y pasar un parámetro de la URL del recurso. Los parámetros deben estar codificados en la URL. El requisito mínimo es el parámetro URL, pero también se puede pasar maxwidth, maxheight y el formato. Realmente depende del formato del contenido, pero para los formatos Video, Photo y Rich tienes la opción de pasar estos argumentos. Además, oEmbed sólo especifica el método GET, por lo que no puedes utilizar otros métodos.

Para más información, véase oembed.com.

Preguntas y Respuestas

¿Puedo utilizar cualquier URL con este sistema?
No, no por defecto. Por razones de seguridad, WordPress sólo integra el contenido de las URLs de la lista blanca interna.

Bien, ¿desde qué sitios puedo incrustar contenidos?
Puede utilizar cualquier sitio de la lista que ofrece WordPress (lista blanca). Más allá de la lista blanca, todos los sitios de oEmbed son compatibles con WordPress. Se pueden añadir manualmente proveedores adicionales. WordPress proporciona dos funciones, una para registrar un sitio que soporta oEmbed y otra que podemos codificar para añadir soporte de oEmbed a nuestro sitio. Utilice wp_oembed_add_provider() para añadir un sitio oEmbed existente a WordPress. También puedes usar wp_embed_register_handler() para añadir un sitio no oEmbed.

¿Cómo añado, cambio o elimino el apoyo a los sitios?
Añadir soporte para un sitio adicional depende de que el sitio acepte el protocolo oEmbed.

Añadir soporte para un sitio habilitado para oEmbed
Si un sitio puede hablar con oEmbed, puede llamar a wp_oembed_add_provider() para añadir el sitio y el formato de URL a la lista blanca interna.

Añadir soporte para un sitio que no acepta oEmbed
Es necesario registrar un manejador utilizando wp_embed_register_handler() proporcionando una función de devolución de llamada que genere el código HTML.

Basado en la experiencia de varios autores, mis opiniones, perspectivas y recomendaciones se expresarán a continuación (o en otros lugares de esta plataforma, respecto a las características en 2026 o antes, y el futuro de esta cuestión):

Eliminación del soporte para un sitio habilitado para oEmbed
Si quieres eliminar un proveedor de oEmbed que está en la lista blanca, debes llamar a wp_oembed_remove_provider.

Eliminación del soporte para un sitio que no acepta oEmbed
Si desea eliminar un manejador de sitio no registrado por Ombed, llame a wp_embed_unregister_handler.

¿Qué pasa con la función de descubrimiento de oEmbed?
Esta función está desactivada en la implementación de WordPress. Por defecto, sólo se puede incrustar contenido de sitios web que estén en la lista blanca interna. Esto es para evitar la incrustación accidental de contenido de sitios maliciosos.

Sin embargo, si crees que eres lo suficientemente inteligente como para evitar este problema, puedes dar a los usuarios de unfiltered_html (administradores y editores) la posibilidad de incrustar contenido de sitios web que tengan etiquetas oEmbed Discovery en sus páginas de contenido. Anteriormente solo era necesario instalar y activar el plugin oEmbed Discovery. Pero este plugin ha sido cerrado a partir del 28 de febrero de 2019 y no está disponible para su descarga. Este cierre es permanente.

Autor: ST

▷ Esperamos que haya sido de utilidad. Si conoces a alguien que pueda estar interesado en este tema, por favor comparte con él/ella este contenido. Es la mejor forma de ayudar al Proyecto Lawi.