WordPress.org

Ready to get started?Download WordPress

Codex

it:Riferimento funzioni/wp embed register handler

Contents

Descrizione

Registra un handler per un embed. Se il sito in questione supporta oEmbed, può essere opportuno usare wp_oembed_add_provider(). Si veda il documento Embed per maggiori informazioni.

Questa funzione deve essere chiamata da un plugin o dal file functions.php di un un tema.

Utilizzo

 <?php wp_embed_register_handler$id$regex$callback$priority ); ?> 

Parametri

$id
(string) (richiesto) Un ID o un nome interno per l'handler. Deve essere univoco.
Default: Nessuno
$regex
(string) (richiesto) L'espressione regolare da usare per verificare se questo handler deve essere usato per un URL.
Default: Nessuno
$callback
(callback) (richiesto) La funzione di callback da chiamare se l'espressione regolare è soddisfatta.
Default: Nessuno
$priority
(int) (opzionale) Usato per specificare l'ordine in cui gli handler registrati vengono verificati (default: 10). Numeri inferiori corrispondono a test effettuati con maggiore priorità, mentre handler con medesima priorità sono verificati nell'ordine in cui sono stati aggiunti all'azione.
Default: 10

Esempi

Registra un handler per incorporare i video di Forbes.

<?php

wp_embed_register_handler( 'forbes', '#http://(?:www|video)\.forbes\.com/(?:video/embed/embed\.html|embedvideo/)\?show=([\d]+)&format=frame&height=([\d]+)&width=([\d]+)&video=(.+?)($|&)#i', 'wp_embed_handler_forbes' );

function wp_embed_handler_forbes( $matches, $attr, $url, $rawattr ) {

	$embed = sprintf(
			'<iframe src="http://www.forbes.com/video/embed/embed.html?show=%1$s&format=frame&height=%2$s&width=%3$s&video=%4$s&mode=render" width="%3$spx" height="%2$spx" frameborder="0" scrolling="no" marginwidth="0" marginheight="0"></iframe>',
			esc_attr($matches[1]),
			esc_attr($matches[2]),
			esc_attr($matches[3]),
			esc_attr($matches[4])
			);

	return apply_filters( 'embed_forbes', $embed, $matches, $attr, $url, $rawattr );
}

?>

Log delle modifiche

Da: 2.9.0

Correlati

L'elenco seguente riporta un misto di collegamenti alle pagine in italiano e a quelle in inglese. Man mano che le varie pagine verranno tradotte, l'elenco verrà aggiornato, e quando tutto sarà tradotto verrà rimosso questo avviso.

Embeds: wp_oembed_add_provider(), wp_oembed_remove_provider(), wp_oembed_get(), wp_embed_defaults(), wp_embed_register_handler(), wp_embed_unregister_handler(), get_embedded_audio(), get_embedded_media(), get_embedded_video(), wp_embed_handler_audio(), wp_embed_handler_video()