<?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
/**
* This class wraps a WP_Post and proxies any undefined attributes
* and methods to the wrapped class. We need to do this because at present
* the WP_Post class is marked as final (in 4.5 this will change, though it's
* not clear if there will be a mechanism to retrieve from the DB into the over-
* ridden class dynamically).
*
* @package automattic/jetpack
*/
use Automattic\Jetpack\Status;
require_once __DIR__ . '/class.json-api-metadata.php';
require_once __DIR__ . '/class.json-api-date.php';
require_once ABSPATH . 'wp-admin/includes/post.php';
require_once ABSPATH . 'wp-includes/post.php';
/**
* Base class for SAL_Post.
*/
abstract class SAL_Post {
/**
* A WP_Post instance.
*
* @var WP_Post
*/
public $post;
/**
* The post request context (for example 'edit' or 'display')
*
* @var string
*/
public $context;
/**
* A Jetpack_Site instance.
*
* @var Jetpack_Site
*/
public $site;
/**
* Constructor function
*
* @param Jetpack_Site $site A Jetpack_Site instance.
* @param WP_Post $post A WP_Post instance.
* @param string $context The post request context (for example 'edit' or 'display').
*/
public function __construct( $site, $post, $context ) {
$this->post = $post;
$this->context = $context;
$this->site = $site;
}
/**
* Setting this WP_Post instance's key value
*
* @param string $key The post key to set.
* @param string $value The value to set the post key to (for example filter, ID, post_status).
*/
public function __set( $key, $value ) {
$this->post->{ $key } = $value;
}
/**
* Returning a WPCOM_JSON_API_Links instance if the post key is set to 'links', or the post key value.
*
* @param string $key The post key value.
*
* @return WPCOM_JSON_API_Links|string
*/
public function __get( $key ) {
if ( 'links' === $key ) {
require_once __DIR__ . '/class.json-api-links.php';
return WPCOM_JSON_API_Links::getInstance();
}
return $this->post->{ $key };
}
/**
* A function to either call a given function, or return an error if it doesn't exist.
*
* @param string $name A function name to be called.
* @param mixed $arguments Arguments to be passed into the given function.
*
* @return mixed|bool
*/
public function __call( $name, $arguments ) {
if ( is_callable( array( $this->post, $name ) ) ) {
return call_user_func_array( array( $this->post, $name ), $arguments );
} else {
// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_trigger_error
trigger_error(
esc_html(
sprintf(
/* translators: %s is the method name that has been called */
__( 'Call to undefined method %s', 'jetpack' ),
$name
)
)
);
}
}
/**
* Checking to see if a given property is set.
*
* @param string $name Property to check if set.
*
* @return bool
*/
public function __isset( $name ) {
return isset( $this->post->{ $name } );
}
/**
* Defining a base get_like_count() function to be extended in the Jetpack_Post class.
*
* This will define a default value for the like counts on a post, if this hasn't been defined yet.
*
* @see class.json-api-post-jetpack.php
*/
abstract public function get_like_count();
/**
* Defining a base is_liked() function to be extended in the Jetpack_Post class.
*
* This will define a default value for whether or not the current user likes this post, if this hasn't been defined yet.
*
* @see class.json-api-post-jetpack.php
*/
abstract public function is_liked();
/**
* Defining a base is_reblogged() function to be extended in the Jetpack_Post class.
*
* This will define a default value for whether or not the current user reblogged this post, if this hasn't been defined yet.
*
* @see class.json-api-post-jetpack.php
*/
abstract public function is_reblogged();
/**
* Defining a base is_following() function to be extended in the Jetpack_Post class.
*
* This will define a default value for whether or not the current user is following this blog, if this hasn't been defined yet.
*
* @see class.json-api-post-jetpack.php
*/
abstract public function is_following();
/**
* Defining a base get_global_id() function to be extended in the Jetpack_Post class.
*
* This will define the unique WordPress.com-wide representation of a post, if this hasn't been defined yet.
*
* @see class.json-api-post-jetpack.php
*/
abstract public function get_global_id();
/**
* Defining a base get_geo() function to be extended in the Jetpack_Post class.
*
* This will define a default value for whether or not there is gelocation data for this post, if this hasn't been defined yet.
*
* @see class.json-api-post-jetpack.php
*/
abstract public function get_geo();
/**
* Returns an int which helps define the menu order for the post.
*
* @return int
*/
public function get_menu_order() {
return (int) $this->post->menu_order;
}
/**
* Returns a string which represents the post's GUID.
*
* @return string
*/
public function get_guid() {
return (string) $this->post->guid;
}
/**
* Returns a string which represents the post type.
*
* @return string
*/
public function get_type() {
return (string) $this->post->post_type;
}
/**
* Returns an object which holds the terms associated with that post object.
*
* @return object
*/
public function get_terms() {
$taxonomies = get_object_taxonomies( $this->post, 'objects' );
$terms = array();
foreach ( $taxonomies as $taxonomy ) {
if ( ! $taxonomy->public && ! current_user_can( $taxonomy->cap->assign_terms ) ) {
continue;
}
$terms[ $taxonomy->name ] = array();
$taxonomy_terms = wp_get_object_terms( $this->post->ID, $taxonomy->name, array( 'fields' => 'all' ) );
foreach ( $taxonomy_terms as $term ) {
$formatted_term = $this->format_taxonomy( $term, $taxonomy->name, 'display' );
$terms[ $taxonomy->name ][ $term->name ] = $formatted_term;
}
$terms[ $taxonomy->name ] = (object) $terms[ $taxonomy->name ];
}
return (object) $terms;
}
/**
* Returns an object which holds the posts tag details
*
* @return object
*/
public function get_tags() {
$tags = array();
$terms = wp_get_post_tags( $this->post->ID );
foreach ( $terms as $term ) {
if ( ! empty( $term->name ) ) {
$tags[ $term->name ] = $this->format_taxonomy( $term, 'post_tag', 'display' );
}
}
return (object) $tags;
}
/**
* Returns an object which holds the posts category details
*
* @return object
*/
public function get_categories() {
$categories = array();
$terms = wp_get_object_terms( $this->post->ID, 'category', array( 'fields' => 'all' ) );
foreach ( $terms as $term ) {
if ( ! empty( $term->name ) ) {
$categories[ $term->name ] = $this->format_taxonomy( $term, 'category', 'display' );
}
}
return (object) $categories;
}
/**
* Returns an array of objects which hold the posts attachment information and numbers representing how many associated posts are found.
*
* @return array
*/
public function get_attachments_and_count() {
$attachments = array();
$_attachments = new WP_Query(
array(
'post_parent' => $this->post->ID,
'post_status' => 'inherit',
'post_type' => 'attachment',
'posts_per_page' => '20',
)
);
foreach ( $_attachments->posts as $attachment ) {
$attachments[ $attachment->ID ] = $this->get_media_item_v1_1( $attachment->ID );
}
return array( (object) $attachments, (int) $_attachments->found_posts );
}
/**
* Returns an array with a posts metadata information.
*
* @return array
*/
public function get_metadata() {
$metadata = array();
foreach ( (array) has_meta( $this->post->ID ) as $meta ) {
// Don't expose protected fields.
$meta_key = $meta['meta_key'];
$show = ! ( WPCOM_JSON_API_Metadata::is_internal_only( $meta_key ) )
&&
(
WPCOM_JSON_API_Metadata::is_public( $meta_key )
||
current_user_can( 'edit_post_meta', $this->post->ID, $meta_key )
);
if ( Jetpack_SEO_Posts::DESCRIPTION_META_KEY === $meta_key && ! Jetpack_SEO_Utils::is_enabled_jetpack_seo() ) {
$show = false;
}
if ( $show ) {
$metadata[] = array(
'id' => $meta['meta_id'],
'key' => $meta['meta_key'],
'value' => $this->safe_maybe_unserialize( $meta['meta_value'] ),
);
}
}
return $metadata;
}
/**
* Returns an object with a posts link meta details.
*
* @return object
*/
public function get_meta() {
$meta = (object) array(
'links' => (object) array(
'self' => (string) $this->get_post_link(),
'help' => (string) $this->get_post_link( 'help' ),
'site' => (string) $this->get_site_link(),
'replies' => (string) $this->get_post_link( 'replies/' ),
'likes' => (string) $this->get_post_link( 'likes/' ),
),
);
$amp_permalink = get_post_meta( $this->post->ID, '_jetpack_amp_permalink', true );
if ( ! empty( $amp_permalink ) ) {
$meta->links->amp = (string) $amp_permalink;
}
// add autosave link if a more recent autosave exists.
if ( 'edit' === $this->context ) {
$autosave = wp_get_post_autosave( $this->post->ID );
if ( $autosave && $autosave->post_modified > $this->post->post_modified ) {
$meta->links->autosave = (string) $this->get_post_link() . '/autosave';
}
}
return $meta;
}
/**
* Returns an array with the current user's publish, deletion and edit capabilities.
*
* @return array
*/
public function get_current_user_capabilities() {
return array(
'publish_post' => current_user_can( 'publish_post', $this->post->ID ),
'delete_post' => current_user_can( 'delete_post', $this->post->ID ),
'edit_post' => current_user_can( 'edit_post', $this->post->ID ),
);
}
/**
* Returns an array with post revision ids, or false if 'edit' isn't the current post request context.
*
* @return bool|array
*/
public function get_revisions() {
if ( 'edit' !== $this->context ) {
return false;
}
$args = array(
'posts_per_page' => -1,
'post_type' => 'revision',
'post_status' => 'any',
'fields' => 'ids', // Fetch only the IDs.
'post_parent' => $this->post->ID,
);
$revision_query = new WP_Query( $args );
return $revision_query->posts; // This returns an array of revision IDs.
}
/**
* Returns an object with extra post permalink suggestions.
*
* @return object
*/
public function get_other_urls() {
$other_urls = array();
if ( 'publish' !== $this->post->post_status ) {
$other_urls = $this->get_permalink_suggestions( $this->post->post_title );
}
return (object) $other_urls;
}
/**
* Calls the WPCOM_JSON_API_Links get_site_link() function to generate a site link endpoint URL.
*
* @return string Endpoint URL including site information.
*/
protected function get_site_link() {
return $this->links->get_site_link( $this->site->get_id() );
}
/**
* Calls the WPCOM_JSON_API_Links get_post_link() function to generate a posts endpoint URL.
*
* @param string $path Optional path to be appended to the URL.
* @return string Endpoint URL including post information.
*/
protected function get_post_link( $path = null ) {
return $this->links->get_post_link( $this->site->get_id(), $this->post->ID, $path );
}
/**
* Returns an array of user and post specific social media post URLs.
*
* @return array
*/
public function get_publicize_urls() {
$publicize_urls = array();
$publicize = get_post_meta( $this->post->ID, 'publicize_results', true );
if ( $publicize ) {
foreach ( $publicize as $service => $data ) {
switch ( $service ) {
// @todo explore removing once Twitter is removed from Publicize.
case 'twitter':
foreach ( $data as $datum ) {
$publicize_urls[] = esc_url_raw( "https://twitter.com/{$datum['user_id']}/status/{$datum['post_id']}" );
}
break;
case 'fb':
foreach ( $data as $datum ) {
$publicize_urls[] = esc_url_raw( "https://www.facebook.com/permalink.php?story_fbid={$datum['post_id']}&id={$datum['user_id']}" );
}
break;
}
}
}
return (array) $publicize_urls;
}
/**
* Returns a string with the page's custom template metadata.
*
* @return string
*/
public function get_page_template() {
return (string) get_post_meta( $this->post->ID, '_wp_page_template', true );
}
/**
* Returns a string representing the source URL of a post's featured image (or an empty string otherwise).
*
* Note - this is overridden in jetpack-shadow
*
* @return string
*/
public function get_featured_image() {
$image_attributes = wp_get_attachment_image_src( get_post_thumbnail_id( $this->post->ID ), 'full' );
if ( is_array( $image_attributes ) && isset( $image_attributes[0] ) ) {
return (string) $image_attributes[0];
} else {
return '';
}
}
/**
* Returns an object representing a post's featured image thumbnail image.
*
* @return object
*/
public function get_post_thumbnail() {
$thumb = null;
$thumb_id = get_post_thumbnail_id( $this->post->ID );
if ( ! empty( $thumb_id ) ) {
$attachment = get_post( $thumb_id );
if ( ! empty( $attachment ) ) {
$featured_image_object = $this->get_attachment( $attachment );
}
if ( ! empty( $featured_image_object ) ) {
$thumb = (object) $featured_image_object;
}
}
return $thumb;
}
/**
* Returns the format slug for a post (for example 'link', 'image' - the default being 'standard').
*
* @return string
*/
public function get_format() {
$format = (string) get_post_format( $this->post->ID );
if ( ! $format ) {
$format = 'standard';
}
return $format;
}
/**
* Returns an object with the post's attachment details.
*
* @param WP_POST $attachment The post's attachment details in the form of a WP_POST object.
*
* @return object
*/
private function get_attachment( $attachment ) {
$metadata = wp_get_attachment_metadata( $attachment->ID );
$result = array(
'ID' => (int) $attachment->ID,
'URL' => (string) wp_get_attachment_url( $attachment->ID ),
'guid' => (string) $attachment->guid,
'mime_type' => (string) $attachment->post_mime_type,
'width' => (int) isset( $metadata['width'] ) ? $metadata['width'] : 0,
'height' => (int) isset( $metadata['height'] ) ? $metadata['height'] : 0,
);
if ( isset( $metadata['duration'] ) ) {
$result['duration'] = (int) $metadata['duration'];
}
/** This filter is documented in class.jetpack-sync.php */
return (object) apply_filters( 'get_attachment', $result );
}
/**
* Returns an ISO 8601 formatted datetime string representing the date of post creation.
*
* @return string
*/
public function get_date() {
return (string) WPCOM_JSON_API_Date::format_date( $this->post->post_date_gmt, $this->post->post_date );
}
/**
* Returns an ISO 8601 formatted datetime string representing the date the post was last modified.
*
* @return string
*/
public function get_modified_date() {
return (string) WPCOM_JSON_API_Date::format_date( $this->post->post_modified_gmt, $this->post->post_modified );
}
/**
* Returns the post's title.
*
* @return string
*/
public function get_title() {
if ( 'display' === $this->context ) {
return (string) get_the_title( $this->post->ID );
} else {
return (string) htmlspecialchars_decode( $this->post->post_title, ENT_QUOTES );
}
}
/**
* Returns the permalink for the post (or the post parent if the post type is a revision).
*
* @return string
*/
public function get_url() {
if ( 'revision' === $this->post->post_type ) {
return (string) esc_url_raw( get_permalink( $this->post->post_parent ) );
} else {
return (string) esc_url_raw( get_permalink( $this->post->ID ) );
}
}
/**
* Returns the shortlink for the post.
*
* @return string
*/
public function get_shortlink() {
return (string) esc_url_raw( wp_get_shortlink( $this->post->ID ) );
}
/**
* Returns the post content, or a string saying 'This post is password protected' if that is the case.
*
* @return string
*/
public function get_content() {
if ( 'display' === $this->context ) {
// @todo: move this WPCOM-specific hack
add_filter( 'the_password_form', array( $this, 'the_password_form' ) );
$content = (string) $this->get_the_post_content_for_display();
remove_filter( 'the_password_form', array( $this, 'the_password_form' ) );
return $content;
} else {
return (string) $this->post->post_content;
}
}
/**
* Returns the post excerpt, or a string saying 'This post is password protected' if that is the case.
*
* @return string
*/
public function get_excerpt() {
if ( 'display' === $this->context ) {
add_filter( 'the_password_form', array( $this, 'the_password_form' ) );
ob_start();
the_excerpt();
$response = (string) ob_get_clean();
remove_filter( 'the_password_form', array( $this, 'the_password_form' ) );
} else {
$response = htmlspecialchars_decode( (string) $this->post->post_excerpt, ENT_QUOTES );
}
return $response;
}
/**
* Returns the current post status (publish, future, draft, pending, private).
*
* @return string
*/
public function get_status() {
return (string) get_post_status( $this->post->ID );
}
/**
* Returns true if the post is a sticky post, false otherwise.
*
* @return bool
*/
public function is_sticky() {
return (bool) is_sticky( $this->post->ID );
}
/**
* Returns the post's slug.
*
* @return string
*/
public function get_slug() {
return (string) $this->post->post_name;
}
/**
* Returns the post's password, if password protected.
*
* @return string
*/
public function get_password() {
$password = (string) $this->post->post_password;
if ( 'edit' === $this->context ) {
$password = htmlspecialchars_decode( (string) $password, ENT_QUOTES );
}
return $password;
}
/**
* Returns an object representing a post's parent, and false if it doesn't have one.
*
* @return object|bool
*/
public function get_parent() {
if ( $this->post->post_parent ) {
$parent = get_post( $this->post->post_parent );
if ( 'display' === $this->context ) {
$parent_title = (string) get_the_title( $parent->ID );
} else {
$parent_title = (string) htmlspecialchars_decode( $this->post->post_title, ENT_QUOTES );
}
return (object) array(
'ID' => (int) $parent->ID,
'type' => (string) $parent->post_type,
'link' => (string) $this->links->get_post_link( $this->site->get_id(), $parent->ID ),
'title' => $parent_title,
);
} else {
return false;
}
}
/**
* Returns a string saying 'This post is password protected' (to be later used within the_password_form filter).
*
* @return string
*/
public function the_password_form() {
return __( 'This post is password protected.', 'jetpack' );
}
/**
* Returns an array with information related to the comment and ping status of a post.
*
* @return array
*/
public function get_discussion() {
return array(
'comments_open' => (bool) comments_open( $this->post->ID ),
'comment_status' => (string) $this->post->comment_status,
'pings_open' => (bool) pings_open( $this->post->ID ),
'ping_status' => (string) $this->post->ping_status,
'comment_count' => (int) $this->post->comment_count,
);
}
/**
* Returns true if likes are enabled - either for the post, or site-wide.
*
* @return bool
*/
public function is_likes_enabled() {
/** This filter is documented in modules/likes.php */
$sitewide_likes_enabled = (bool) apply_filters( 'wpl_is_enabled_sitewide', ! get_option( 'disabled_likes' ) );
$post_likes_switched = get_post_meta( $this->post->ID, 'switch_like_status', true );
return $post_likes_switched || ( $sitewide_likes_enabled && '0' !== $post_likes_switched );
}
/**
* Returns true if sharing is enabled, false otherwise.
*
* @return bool
*/
public function is_sharing_enabled() {
$show = true;
/** This filter is documented in modules/sharedaddy/sharing-service.php */
$show = apply_filters( 'sharing_show', $show, $this->post );
$switched_status = get_post_meta( $this->post->ID, 'sharing_disabled', false );
if ( ! empty( $switched_status ) ) {
$show = false;
}
return (bool) $show;
}
/**
* Returns the post content in the form of a string, ready for displaying.
*
* Note: No Blog ID parameter. No Post ID parameter. Depends on globals.
* Expects setup_postdata() to already have been run
*
* @return string
*/
public function get_the_post_content_for_display() {
global $pages, $page;
$old_pages = $pages;
$old_page = $page;
$content = implode( "\n\n", $pages );
$content = preg_replace( '/<!--more(.*?)?-->/', '', $content );
// phpcs:disable WordPress.WP.GlobalVariablesOverride.Prohibited -- Assignment to globals is intentional
$pages = array( $content );
$page = 1;
ob_start();
the_content();
$return = ob_get_clean();
$pages = $old_pages;
$page = $old_page;
// phpcs:enable WordPress.WP.GlobalVariablesOverride.Prohibited
return $return;
}
/**
* Returns an object containing the post author's information (eg. ID, display name, email if the user has post editing capabilities).
*
* @return object
*/
public function get_author() {
if ( 0 == $this->post->post_author ) { // phpcs:ignore Universal.Operators.StrictComparisons.LooseEqual -- numbers could be numeric strings.
return null;
}
$show_email = 'edit' === $this->context && current_user_can( 'edit_post', $this->post->ID );
$user = get_user_by( 'id', $this->post->post_author );
if ( ! $user || is_wp_error( $user ) ) {
return null;
}
// @todo: factor this out
// phpcs:disable WordPress.NamingConventions.ValidVariableName
if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) {
$active_blog = get_active_blog_for_user( $user->ID );
$site_id = $active_blog->blog_id ?? -1;
$profile_URL = "https://gravatar.com/{$user->user_login}";
} else {
$profile_URL = 'https://gravatar.com/' . md5( strtolower( trim( $user->user_email ) ) );
$site_id = -1;
}
$author = array(
'ID' => (int) $user->ID,
'login' => (string) $user->user_login,
'email' => $show_email ? (string) $user->user_email : false,
'name' => (string) $user->display_name,
'first_name' => (string) $user->first_name,
'last_name' => (string) $user->last_name,
'nice_name' => (string) $user->user_nicename,
'URL' => (string) esc_url_raw( $user->user_url ),
'avatar_URL' => (string) esc_url_raw( $this->get_avatar_url( $user->user_email ) ),
'profile_URL' => (string) esc_url_raw( $profile_URL ),
);
// phpcs:enable WordPress.NamingConventions.ValidVariableName
if ( $site_id > -1 ) {
$author['site_ID'] = (int) $site_id;
}
return (object) $author;
}
/**
* Returns the avatar URL for a user, or an empty string if there isn't a valid avatar.
*
* @param string $email The user's email.
* @param int $avatar_size The size of the avatar in pixels.
*
* @todo Provide a non-WP.com option.
*
* @return string
*/
protected function get_avatar_url( $email, $avatar_size = 96 ) {
$avatar_url = function_exists( 'wpcom_get_avatar_url' ) ? wpcom_get_avatar_url( $email, $avatar_size ) : '';
if ( ! $avatar_url || is_wp_error( $avatar_url ) ) {
return '';
}
return esc_url_raw( htmlspecialchars_decode( $avatar_url[0], ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401 ) );
}
/**
* Return extra post permalink suggestions in an array including the 'permalink_URL' and the 'suggested_slug'.
*
* @param string $title The current post title.
*
* @return array
*/
public function get_permalink_suggestions( $title ) {
$suggestions = array();
list( $suggestions['permalink_URL'], $suggestions['suggested_slug'] ) = get_sample_permalink( $this->post->ID, $title );
return $suggestions;
}
/**
* Returns an object with formatted taxonomy information such as slug and meta information.
*
* Otherwise, returns an error if the edit or display permissions aren't correct.
*
* @param WP_Term $taxonomy The current taxonomy.
* @param string $taxonomy_type The current taxonomy type, for example 'category'.
* @param string $context The current context, for example 'edit' or 'display'.
*
* @return object
*/
private function format_taxonomy( $taxonomy, $taxonomy_type, $context ) {
// Permissions.
switch ( $context ) {
case 'edit':
$tax = get_taxonomy( $taxonomy_type );
if ( ! current_user_can( $tax->cap->edit_terms ) ) {
return new WP_Error( 'unauthorized', 'User cannot edit taxonomy', 403 );
}
break;
case 'display':
if ( ( new Status() )->is_private_site() && ! current_user_can( 'read' ) ) {
return new WP_Error( 'unauthorized', 'User cannot view taxonomy', 403 );
}
break;
default:
return new WP_Error( 'invalid_context', 'Invalid API CONTEXT', 400 );
}
$response = array();
$response['ID'] = (int) $taxonomy->term_id;
$response['name'] = (string) $taxonomy->name;
$response['slug'] = (string) $taxonomy->slug;
$response['description'] = (string) $taxonomy->description;
$response['post_count'] = (int) $taxonomy->count;
if ( is_taxonomy_hierarchical( $taxonomy_type ) ) {
$response['parent'] = (int) $taxonomy->parent;
}
$response['meta'] = (object) array(
'links' => (object) array(
'self' => (string) $this->links->get_taxonomy_link( $this->site->get_id(), $taxonomy->slug, $taxonomy_type ),
'help' => (string) $this->links->get_taxonomy_link( $this->site->get_id(), $taxonomy->slug, $taxonomy_type, 'help' ),
'site' => (string) $this->links->get_site_link( $this->site->get_id() ),
),
);
return (object) $response;
}
/**
* Builds and returns the media item's details.
*
* @param int $media_id The media item ID.
* @todo: factor this out into site.
*
* @return object
*/
private function get_media_item_v1_1( $media_id ) {
$media_item = get_post( $media_id );
if ( ! $media_item || is_wp_error( $media_item ) ) {
return new WP_Error( 'unknown_media', 'Unknown Media', 404 );
}
$file = basename( wp_get_attachment_url( $media_item->ID ) );
$file_info = pathinfo( $file );
$ext = isset( $file_info['extension'] ) ? $file_info['extension'] : '';
$response = array(
'ID' => $media_item->ID,
'URL' => wp_get_attachment_url( $media_item->ID ),
'guid' => $media_item->guid,
'date' => (string) WPCOM_JSON_API_Date::format_date( $media_item->post_date_gmt, $media_item->post_date ),
'post_ID' => $media_item->post_parent,
'author_ID' => (int) $media_item->post_author,
'file' => $file,
'mime_type' => $media_item->post_mime_type,
'extension' => $ext,
'title' => $media_item->post_title,
'caption' => $media_item->post_excerpt,
'description' => $media_item->post_content,
'alt' => get_post_meta( $media_item->ID, '_wp_attachment_image_alt', true ),
'thumbnails' => array(),
);
if ( in_array( $ext, array( 'jpg', 'jpeg', 'png', 'gif', 'webp' ), true ) ) {
$metadata = wp_get_attachment_metadata( $media_item->ID );
if ( isset( $metadata['height'] ) && isset( $metadata['width'] ) ) {
$response['height'] = $metadata['height'];
$response['width'] = $metadata['width'];
}
if ( isset( $metadata['sizes'] ) ) {
/**
* Filter the thumbnail sizes available for each attachment ID.
*
* @module json-api
*
* @since 3.9.0
*
* @param array $metadata['sizes'] Array of thumbnail sizes available for a given attachment ID.
* @param int $media_id The media item ID.
*/
$sizes = apply_filters( 'rest_api_thumbnail_sizes', $metadata['sizes'], $media_id );
if ( is_array( $sizes ) ) {
foreach ( $sizes as $size => $size_details ) {
$response['thumbnails'][ $size ] = dirname( $response['URL'] ) . '/' . $size_details['file'];
}
}
}
if ( isset( $metadata['image_meta'] ) ) {
$response['exif'] = $metadata['image_meta'];
}
}
if ( in_array( $ext, array( 'mp3', 'm4a', 'wav', 'ogg' ), true ) ) {
$metadata = wp_get_attachment_metadata( $media_item->ID );
if ( isset( $metadata['length'] ) ) {
$response['length'] = $metadata['length'];
}
$response['exif'] = $metadata;
}
if ( in_array( $ext, array( 'ogv', 'mp4', 'mov', 'wmv', 'avi', 'mpg', '3gp', '3g2', 'm4v' ), true ) ) {
$metadata = wp_get_attachment_metadata( $media_item->ID );
if ( isset( $metadata['height'] ) && isset( $metadata['width'] ) ) {
$response['height'] = $metadata['height'];
$response['width'] = $metadata['width'];
}
if ( isset( $metadata['length'] ) ) {
$response['length'] = $metadata['length'];
}
if ( empty( $response['length'] ) && isset( $metadata['duration'] ) ) {
$response['length'] = (int) $metadata['duration'];
}
if ( empty( $response['length'] ) && isset( $metadata['videopress']['duration'] ) ) {
$response['length'] = ceil( $metadata['videopress']['duration'] / 1000 );
}
// add VideoPress info.
if ( function_exists( 'video_get_info_by_blogpostid' ) ) {
$info = video_get_info_by_blogpostid( $this->site->get_id(), $media_id );
// Thumbnails.
if ( function_exists( 'video_format_done' ) && function_exists( 'video_image_url_by_guid' ) ) {
$response['thumbnails'] = array(
'fmt_hd' => '',
'fmt_dvd' => '',
'fmt_std' => '',
);
foreach ( $response['thumbnails'] as $size => $thumbnail_url ) {
if ( video_format_done( $info, $size ) ) {
$response['thumbnails'][ $size ] = video_image_url_by_guid( $info->guid, $size );
} else {
unset( $response['thumbnails'][ $size ] );
}
}
}
$response['videopress_guid'] = $info->guid ?? null;
$response['videopress_processing_done'] = true;
$response['videopress_processing_done'] = isset( $info->finish_date_gmt ) && '0000-00-00 00:00:00' !== $info->finish_date_gmt ? $info->finish_date_gmt : false;
}
}
$response['thumbnails'] = (object) $response['thumbnails'];
$response['meta'] = (object) array(
'links' => (object) array(
'self' => (string) $this->links->get_media_link( $this->site->get_id(), $media_id ),
'help' => (string) $this->links->get_media_link( $this->site->get_id(), $media_id, 'help' ),
'site' => (string) $this->links->get_site_link( $this->site->get_id() ),
),
);
// add VideoPress link to the meta.
if ( in_array( $ext, array( 'ogv', 'mp4', 'mov', 'wmv', 'avi', 'mpg', '3gp', '3g2', 'm4v' ), true ) ) {
if ( function_exists( 'video_get_info_by_blogpostid' ) ) {
$response['meta']->links->videopress = (string) $this->links->get_link( '/videos/%s', $response['videopress_guid'], '' );
}
}
if ( $media_item->post_parent > 0 ) {
$response['meta']->links->parent = (string) $this->links->get_post_link( $this->site->get_id(), $media_item->post_parent );
}
return (object) $response;
}
/**
* Temporary wrapper around maybe_unserialize() to catch exceptions thrown by unserialize().
*
* Can be removed after https://core.trac.wordpress.org/ticket/45895 lands in Core.
*
* @param string $original Serialized string.
*
* @return string Unserialized string or original string if an exception was raised.
**/
protected function safe_maybe_unserialize( $original ) {
try {
return maybe_unserialize( $original );
} catch ( Exception $e ) {
return $original;
}
}
}