<?php
/**
* Global Transformations class for Cloudinary.
*
* @package Cloudinary
*/
namespace Cloudinary\Media;
use Cloudinary\Connect\Api;
use Cloudinary\Relate;
use Cloudinary\Settings\Setting;
use Cloudinary\Sync;
use Cloudinary\REST_API;
use Cloudinary\Utils;
use WP_Post;
/**
* Class Global Transformations.
*
* Handles Contextual Globals transformations for content.
*/
class Global_Transformations {
/**
* Holds the Media instance.
*
* @since 0.1
*
* @var \Cloudinary\Media Instance of the plugin.
*/
private $media;
/**
* Holds the taxonomy fields defined in settings.
*
* @since 0.1
*
* @var array
*/
private $taxonomy_fields;
/**
* Holds the global settings (lowest level).
*
* @since 0.1
*
* @var array
*/
public $globals;
/**
* Holds the order meta key to maintain consistency.
*/
const META_ORDER_KEY = 'cloudinary_transformations';
/**
* Holds the apply type meta key to maintain consistency.
*/
const META_APPLY_KEY = 'cloudinary_apply_type';
/**
* Holds the overwrite transformations for featured images meta key.
*/
const META_FEATURED_IMAGE_KEY = '_cloudinary_featured_overwrite';
/**
* Holds the media settings.
*
* @var Setting
*/
protected $media_settings;
/**
* Global Transformations constructor.
*
* @param \Cloudinary\Media $media The plugin.
*/
public function __construct( \Cloudinary\Media $media ) {
$this->media = $media;
$this->media_settings = $this->media->get_settings();
$this->globals['image'] = $this->media_settings->get_setting( 'image_settings' );
$this->globals['video'] = $this->media_settings->get_setting( 'video_settings' );
// Set value to null, to rebuild data to get defaults.
$field_slugs = array_keys( $this->globals['image']->get_value() );
$field_slugs = array_merge( $field_slugs, array_keys( $this->globals['image']->get_value() ) );
foreach ( $field_slugs as $slug ) {
$setting = $this->media_settings->get_setting( $slug );
if ( $setting->has_param( 'taxonomy_field' ) ) {
$context = $setting->get_param( 'taxonomy_field.context', 'global' );
if ( isset( $this->taxonomy_fields[ $context ] ) && in_array( $setting, $this->taxonomy_fields[ $context ], true ) ) {
continue;
}
$priority = intval( $setting->get_param( 'taxonomy_field.priority', 10 ) ) * 1000;
while ( isset( $this->taxonomy_fields[ $context ][ $priority ] ) ) {
$priority ++;
}
if ( ! isset( $this->taxonomy_fields[ $context ] ) ) {
$this->taxonomy_fields[ $context ] = array();
}
$this->taxonomy_fields[ $context ][ $priority ] = $setting;
}
}
foreach ( $this->taxonomy_fields as $context => $set ) {
ksort( $this->taxonomy_fields[ $context ] );
}
$this->setup_hooks();
}
/**
* Add fields to Add taxonomy term screen.
*/
public function add_taxonomy_fields() {
$template_file = $this->media->plugin->template_path . 'taxonomy-transformation-fields.php';
if ( file_exists( $template_file ) ) {
// Initialise the settings to be within the terms context, and not contain or alter the global setting value.
$this->init_term_transformations();
include $template_file; // phpcs:ignore
}
}
/**
* Add fields to Edit taxonomy term screen.
*/
public function edit_taxonomy_fields() {
$template_file = $this->media->plugin->template_path . 'taxonomy-term-transformation-fields.php';
if ( file_exists( $template_file ) ) {
// Initialise the settings to be within the terms context, and not contain or alter the global setting value.
$this->init_term_transformations();
include $template_file; // phpcs:ignore
}
}
/**
* Save the meta data for the term.
*
* @param int $term_id The term ID.
*/
public function save_taxonomy_custom_meta( $term_id ) {
foreach ( $this->taxonomy_fields as $context => $set ) {
foreach ( $set as $setting ) {
$meta_key = self::META_ORDER_KEY . '_' . $setting->get_param( 'slug' );
$value = $setting->get_submitted_value();
// Check if it's option based.
if ( $setting->has_param( 'options' ) ) {
$options = $setting->get_param( 'options', array() );
if ( ! in_array( $value, $options, true ) ) {
$value = null;
}
}
// If null, skip it.
if ( is_null( $value ) ) {
continue;
}
// Update the metadata.
update_term_meta( $term_id, $meta_key, $value );
}
}
}
/**
* Get transformations for a term.
*
* @param int $term_id The term ID to get transformations for.
* @param string $type The default transformations type.
*
* @return array
*/
private function get_term_transformations( $term_id, $type ) {
$meta_data = array();
if ( ! empty( $this->taxonomy_fields[ $type ] ) ) {
foreach ( $this->taxonomy_fields[ $type ] as $setting ) {
$slug = $setting->get_param( 'slug' );
$meta_key = self::META_ORDER_KEY . '_' . $slug;
$value = get_term_meta( $term_id, $meta_key, true );
$meta_data[ $slug ] = $value;
}
// Clear out empty items.
$meta_data = array_filter( $meta_data );
}
return $meta_data;
}
/**
* Resets the taxonomy fields values.
*/
protected function reset_taxonomy_field_values() {
foreach ( $this->taxonomy_fields as $context => $set ) {
foreach ( $set as $setting ) {
$setting->set_value( null );
}
}
}
/**
* Init term meta field values.
*/
public function init_term_transformations() {
// Enqueue Cloudinary.
$this->media->plugin->enqueue_assets();
$this->reset_taxonomy_field_values();
$types = array_keys( $this->taxonomy_fields );
foreach ( $types as $type ) {
$transformations = $this->get_transformations( $type );
foreach ( $transformations as $slug => $transformation ) {
$this->media_settings->get_setting( $slug )->set_value( $transformation );
}
}
}
/**
* Get the transformations.
*
* @param string $type The context type to get transformations for.
*
* @return array
*/
public function get_transformations( $type ) {
$transformations = isset( $this->globals[ $type ] ) ? $this->globals[ $type ] : array();
if ( function_exists( 'get_current_screen' ) ) {
$screen = get_current_screen();
if ( $screen instanceof \WP_Screen ) {
// check screen context.
switch ( $screen->base ) {
case 'term':
$term_id = filter_input( INPUT_GET, 'tag_ID', FILTER_SANITIZE_NUMBER_INT );
$transformations = $this->get_term_transformations( $term_id, $type );
break;
default:
$transformations = array();
break;
}
}
}
return $transformations;
}
/**
* Get the transformations of a posts taxonomies.
*
* @param string $type The type to get.
*
* @return string
*/
public function get_taxonomy_transformations( $type ) {
static $cache = array();
$post = $this->get_current_post();
$key = wp_json_encode( func_get_args() ) . ( $post ? $post->ID : 0 );
if ( isset( $cache[ $key ] ) ) {
return $cache[ $key ];
}
$return_transformations = '';
if ( $post ) {
$transformations = array();
$terms = $this->get_terms( $post->ID );
if ( ! empty( $terms ) ) {
foreach ( $terms as $item ) {
$transformation = $this->get_term_transformations( $item['term']->term_id, $type );
if ( ! empty( $transformation[ $type . '_freeform' ] ) ) {
$transformations[] = trim( $transformation[ $type . '_freeform' ] );
}
}
// Join the freeform.
$return_transformations = implode( '/', (array) $transformations );
}
}
$cache[ $key ] = $return_transformations;
return $cache[ $key ];
}
/**
* Check if the image has a post taxonomy overwrite.
*
* @return bool
*/
public function is_taxonomy_overwrite() {
$apply_type = false;
$post = $this->get_current_post();
if ( $post ) {
$apply_type = get_post_meta( $post->ID, self::META_APPLY_KEY . '_terms', true );
}
return ! empty( $apply_type );
}
/**
* Load the preview field.
*
* @param bool $video Flag if this is a video preview.
*/
public function load_preview( $video = false ) {
$file = 'transformation-preview';
if ( true === $video ) {
$file .= '-video';
}
require $this->media->plugin->template_path . $file . '.php'; // phpcs:ignore
}
/**
* Register Taxonomy Ordering.
*
* @param string $type The post type (unused).
* @param \WP_Post $post The current post.
*/
public function taxonomy_ordering( $type, $post ) {
if ( $this->has_public_taxonomies( $post ) ) {
add_meta_box( 'cld-taxonomy-order', __( 'Categories/Tags transformations', 'cloudinary' ), array( $this, 'render_ordering_box' ), null, 'side', 'core' );
}
}
/**
* Check if the post has any public taxonomies.
*
* @param \WP_POST $post The post to check.
*
* @return bool
*/
public function has_public_taxonomies( $post ) {
$taxonomies = get_object_taxonomies( $post, 'objects' );
// Only get taxonomies that have a UI.
$taxonomies = array_filter(
$taxonomies,
function ( $tax ) {
return $tax->show_ui;
}
);
return ! empty( $taxonomies );
}
/**
* Render the ordering metabox.
*
* @param \WP_Post $post the current Post.
*/
public function render_ordering_box( $post ) {
// Show UI if has taxonomies.
if ( $this->has_public_taxonomies( $post ) ) {
echo $this->init_taxonomy_manager( $post ); // phpcs:ignore
}
}
/**
* Get terms for the current post that has transformations.
*
* @param int $post_id The post ID.
*
* @return array|false|int|\WP_Error|\WP_Term[]
*/
public function get_terms( $post_id ) {
// Get terms for this post on load.
$items = get_post_meta( $post_id, self::META_ORDER_KEY . '_terms', true );
$terms = array();
if ( ! empty( $items ) ) {
$items = array_map(
function ( $item ) {
// Get the id.
if ( false !== strpos( $item, ':' ) ) {
$parts = explode( ':', $item );
$term = get_term_by( 'id', $parts[1], $parts[0] );
if ( ! $term ) {
$term = get_term_by( 'term_taxonomy_id', $parts[1], $parts[0] );
}
} else {
// Something went wrong, and value was not an int and didn't contain a tax:slug string.
return null;
}
// Return if term is valid.
if ( $term instanceof \WP_Term ) {
return array(
'term' => $term,
'value' => $item,
);
}
return null;
},
$items
);
$terms = array_filter( $items );
} else {
$taxonomies = get_object_taxonomies( get_post_type( $post_id ) );
$current_terms = wp_get_object_terms( $post_id, $taxonomies );
if ( ! empty( $current_terms ) ) {
$terms = array_map(
function ( $term ) {
$value = $term->taxonomy . ':' . $term->term_id;
$item = array(
'term' => $term,
'value' => $value,
);
return $item;
},
$current_terms
);
}
}
return $terms;
}
/**
* Make an item for ordering.
*
* @param int $id The term id.
* @param string $name The term name.
*
* @return string
*/
public function make_term_sort_item( $id, $name ) {
$out = array(
'<li class="cld-tax-order-list-item" data-item="' . esc_attr( $id ) . '">',
'<span class="dashicons dashicons-menu cld-tax-order-list-item-handle"></span>',
'<input class="cld-tax-order-list-item-input" type="hidden" name="cld_tax_order[]" value="' . $id . '">' . $name,
'</li>',
);
return implode( $out );
}
/**
* Init the taxonomy ordering metabox.
*
* @param \WP_Post $post The current Post.
*
* @return string
*/
private function init_taxonomy_manager( $post ) {
wp_enqueue_script( 'wp-api' );
$terms = $this->get_terms( $post->ID );
$out = array();
$out[] = '<div class="cld-tax-order">';
$out[] = '<p style="font-size: 12px; font-style: normal; color: rgb( 117, 117, 117 );">' . esc_html__( 'If you placed custom transformations on categories/tags you may order them below. ', 'cloudinary' ) . '</li>';
$out[] = '<ul class="cld-tax-order-list" id="cld-tax-items">';
$out[] = '<li class="cld-tax-order-list-item no-items">' . esc_html__( 'No terms added', 'cloudinary' ) . '</li>';
if ( ! empty( $terms ) ) {
foreach ( (array) $terms as $item ) {
$out[] = $this->make_term_sort_item( $item['value'], $item['term']->name );
}
}
$out[] = '</ul>';
// Get apply Type.
if ( ! empty( $terms ) ) {
$type = get_post_meta( $post->ID, self::META_APPLY_KEY . '_terms', true );
$out[] = '<label class="cld-tax-order-list-type"><input ' . checked( 'overwrite', $type, false ) . ' type="checkbox" value="overwrite" name="cld_apply_type" />' . esc_html__( 'Disable global transformations', 'cloudinary' ) . '</label>';
}
$out[] = '</div>';
return implode( $out );
}
/**
* Save the taxonomy ordering meta.
*
* @param int $post_id The post ID.
*/
public function save_taxonomy_ordering( $post_id ) {
$args = array(
'cld_tax_order' => array(
'filter' => FILTER_CALLBACK,
'flags' => FILTER_REQUIRE_ARRAY,
'options' => 'sanitize_text_field',
),
'cld_apply_type' => array(
'filter' => FILTER_CALLBACK,
'options' => 'sanitize_text_field',
),
);
$taxonomy_order = filter_input_array( INPUT_POST, $args );
if ( ! empty( $taxonomy_order['cld_tax_order'] ) ) {
// Map to ID's where needed.
$order = array_map(
function ( $line ) {
$parts = explode( ':', $line );
if ( ! empty( $parts[1] ) && ! is_numeric( $parts[1] ) ) {
// Tag based, find term ID.
$line = null;
$term = get_term_by( 'name', $parts[1], $parts[0] );
if ( ! empty( $term ) ) {
$line = $term->taxonomy . ':' . $term->term_id;
}
} elseif ( empty( $parts[1] ) ) {
// strange '0' based section, remove to be safe.
$line = null;
}
return $line;
},
$taxonomy_order['cld_tax_order']
);
$order = array_filter( $order );
update_post_meta( $post_id, self::META_ORDER_KEY . '_terms', $order );
} else {
delete_post_meta( $post_id, self::META_ORDER_KEY . '_terms' );
}
if ( ! empty( $taxonomy_order['cld_apply_type'] ) ) {
update_post_meta( $post_id, self::META_APPLY_KEY . '_terms', $taxonomy_order['cld_apply_type'] );
} else {
delete_post_meta( $post_id, self::META_APPLY_KEY . '_terms' );
}
}
/**
* Register meta for featured image transformations overwriting.
*
* @return void
*/
public function register_featured_overwrite() {
register_meta(
'post',
self::META_FEATURED_IMAGE_KEY,
array(
'show_in_rest' => true,
'single' => true,
'default' => false,
'type' => 'boolean',
'description' => esc_html__( 'Flag on whether transformation should be overwritten for a featured image.', 'cloudinary' ),
'auth_callback' => function () {
return Utils::user_can( 'override_transformation', 'edit_posts' );
},
)
);
}
/**
* Add checkbox to override transformations for featured image.
*
* @param string $content The content to be saved.
* @param int $post_id The post ID.
* @param int $attachment_id The ID of the attachment.
*
* @return string
*/
public function classic_overwrite_transformations_featured_image( $content, $post_id, $attachment_id ) {
if ( ! empty( $attachment_id ) ) {
// Get the current value.
$field_value = get_post_meta( $post_id, self::META_FEATURED_IMAGE_KEY, true );
// Add hidden field and checkbox to the HTML.
$content .= sprintf(
'<p><label for="%1$s"><input type="hidden" name="%1$s" value="0" /><input type="checkbox" name="%1$s" id="%1$s" value="1" %2$s /> %3$s</label></p>',
esc_attr( self::META_FEATURED_IMAGE_KEY ),
checked( $field_value, 1, false ),
esc_html__( 'Overwrite Global Transformations', 'cloudinary' )
);
}
return $content;
}
/**
* Updates appropriate meta for overwriting transformations of a featured image.
*
* @param int $post_id The post ID.
*/
public function save_overwrite_transformations_featured_image( $post_id ) {
$field_value = filter_input( INPUT_POST, self::META_FEATURED_IMAGE_KEY, FILTER_VALIDATE_BOOLEAN );
if ( ! is_null( $field_value ) ) {
update_post_meta( $post_id, self::META_FEATURED_IMAGE_KEY, $field_value );
}
}
/**
* Get the current post.
*
* @return WP_Post|null
*/
public function get_current_post() {
/**
* Filter the post ID.
*
* @hook cloudinary_current_post_id
* @default null
*
* @return {WP_Post|null}
*/
$post_id = apply_filters( 'cloudinary_current_post_id', null );
if ( is_null( $post_id ) && ! in_the_loop() ) {
return null;
}
return get_post( $post_id );
}
/**
* Insert the cloudinary status column.
*
* @param array $cols Array of columns.
*
* @return array
*/
public function transformations_column( $cols ) {
$custom = array(
'cld_transformations' => __( 'Transformations', 'cloudinary' ),
);
$offset = array_search( 'parent', array_keys( $cols ), true );
if ( empty( $offset ) ) {
$offset = 4; // Default location some where after author, in case another plugin removes parent column.
}
$cols = array_slice( $cols, 0, $offset ) + $custom + array_slice( $cols, $offset );
return $cols;
}
/**
* Display the Cloudinary Column.
*
* @param string $column_name The column name.
* @param int $attachment_id The attachment id.
*/
public function transformations_column_value( $column_name, $attachment_id ) {
if ( 'cld_transformations' === $column_name && $this->media->sync->is_synced( $attachment_id ) ) {
// Transformations are only available for Images and Videos.
if (
! in_array(
$this->media->get_media_type( $attachment_id ),
array(
'image',
'video',
),
true
)
) {
return;
}
// If asset isn't deliverable, don't show transformations.
if ( ! $this->media->plugin->get_component( 'delivery' )->is_deliverable( $attachment_id ) ) {
return;
}
$item = $this->media->plugin->get_component( 'assets' )->get_asset( $attachment_id, 'dataset' );
if ( ! empty( $item['data']['public_id'] ) ) {
$text = __( 'Add transformations', 'cloudinary' );
$transformations = Relate::get_transformations( $attachment_id, true );
if ( ! empty( $transformations ) ) {
$text = $transformations;
}
$args = array(
'page' => 'cloudinary',
'section' => 'edit-asset',
'asset' => $attachment_id,
);
?>
<a href="<?php echo esc_url( add_query_arg( $args, 'admin.php' ) ); ?>" data-transformation-item="<?php echo esc_attr( wp_json_encode( $item ) ); ?>"><?php echo esc_html( $text ); ?></a>
<?php
}
}
}
/**
* Setup hooks for the filters.
*/
public function setup_hooks() {
$taxonomies = get_taxonomies( array( 'show_ui' => true ) );
$global = $this;
array_map(
function ( $taxonomy ) use ( $global ) {
add_action( $taxonomy . '_add_form_fields', array( $global, 'add_taxonomy_fields' ) );
add_action( $taxonomy . '_edit_form_fields', array( $global, 'edit_taxonomy_fields' ) );
add_action( 'create_' . $taxonomy, array( $global, 'save_taxonomy_custom_meta' ) );
add_action( 'edited_' . $taxonomy, array( $global, 'save_taxonomy_custom_meta' ) );
},
$taxonomies
);
// Add ordering metaboxes and featured overwrite.
add_action( 'add_meta_boxes', array( $this, 'taxonomy_ordering' ), 10, 2 );
add_action( 'save_post', array( $this, 'save_taxonomy_ordering' ), 10, 1 );
add_action( 'save_post', array( $this, 'save_overwrite_transformations_featured_image' ), 10, 3 );
add_filter( 'admin_post_thumbnail_html', array( $this, 'classic_overwrite_transformations_featured_image' ), 10, 3 );
// Filter and action the custom column.
add_filter( 'manage_media_columns', array( $this, 'transformations_column' ), 11 );
add_action( 'manage_media_custom_column', array( $this, 'transformations_column_value' ), 10, 2 );
// Register Meta.
$this->register_featured_overwrite();
}
}