get_embed_template() WordPress Function
The get_embed_template() function is used to retrieve the embed template for a specific post. This function is useful for customizing the output of your embedded content.
get_embed_template() #
Retrieves an embed template path in the current or parent template.
Description
The hierarchy for this template looks like:
- embed-{post_type}-{post_format}.php
- embed-{post_type}.php
- embed.php
An example of this is:
- embed-post-audio.php
- embed-post.php
- embed.php
The template hierarchy and template path are filterable via the ‘$type_template_hierarchy’ and ‘$type_template’ dynamic hooks, where $type is ’embed’.
See also
Return
(string) Full path to embed template file.
Source
File: wp-includes/template.php
function get_embed_template() {
$object = get_queried_object();
$templates = array();
if ( ! empty( $object->post_type ) ) {
$post_format = get_post_format( $object );
if ( $post_format ) {
$templates[] = "embed-{$object->post_type}-{$post_format}.php";
}
$templates[] = "embed-{$object->post_type}.php";
}
$templates[] = 'embed.php';
return get_query_template( 'embed', $templates );
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 4.5.0 | Introduced. |