public function ajax_vote() {
        $this->verify_request();
        if (!is_user_logged_in()) {
            wp_send_json_error(['message' => esc_html__('Sign in to vote.', 'cine-movie-engine')], 401);
        }
        $playlist_id = isset($_POST['playlist_id']) ? absint($_POST['playlist_id']) : 0;
        $playlist = get_post($playlist_id);
        if (!$playlist || $playlist->post_type !== self::POST_TYPE || $playlist->post_status !== 'publish' || get_post_meta($playlist_id, '_me_cp_visibility', true) !== 'public') {
            wp_send_json_error(['message' => esc_html__('This playlist cannot be voted on.', 'cine-movie-engine')], 404);
        }
        $vote_key = '_me_cp_voted_' . $playlist_id;
        if (!add_user_meta(get_current_user_id(), $vote_key, '1', true)) {
            wp_send_json_error(['message' => esc_html__('You have already voted for this playlist.', 'cine-movie-engine')], 409);
        }
        $votes = absint(get_post_meta($playlist_id, '_me_cp_vote_count', true)) + 1;
        update_post_meta($playlist_id, '_me_cp_vote_count', $votes);
        wp_send_json_success(['votes' => $votes]);
    }

    public function ajax_move_title() {
        $this->verify_request();
        if (!is_user_logged_in()) {
            wp_send_json_error(['message' => esc_html__('Sign in to manage this playlist.', 'cine-movie-engine')], 401);
        }

        $playlist_id = isset($_POST['playlist_id']) ? absint($_POST['playlist_id']) : 0;
        $post_id = isset($_POST['post_id']) ? absint($_POST['post_id']) : 0;
        $direction = isset($_POST['direction']) ? sanitize_key(wp_unslash($_POST['direction'])) : '';
        $playlist = get_post($playlist_id);
        if (!$playlist || $playlist->post_type !== self::POST_TYPE || $playlist->post_status !== 'publish' || (int) $playlist->post_author !== get_current_user_id()) {
            wp_send_json_error(['message' => esc_html__('You cannot manage this playlist.', 'cine-movie-engine')], 403);
        }
        if (!$post_id || !in_array($direction, ['up', 'down'], true)) {
            wp_send_json_error(['message' => esc_html__('Invalid playlist item.', 'cine-movie-engine')], 400);
        }

        $items = $this->get_valid_items($playlist_id);
        $index = array_search($post_id, $items, true);
        $target_index = $direction === 'up' ? $index - 1 : $index + 1;
        if ($index === false || !isset($items[$target_index])) {
            wp_send_json_error(['message' => esc_html__('This title cannot be moved further.', 'cine-movie-engine')], 400);
        }

        $moving_item = $items[$index];
        $items[$index] = $items[$target_index];
        $items[$target_index] = $moving_item;
        update_post_meta($playlist_id, '_me_cp_items', $items);

        $source_user_id = absint(get_post_meta($playlist_id, '_me_cp_source_user_id', true));
        $source_playlist_id = get_post_meta($playlist_id, '_me_cp_source_playlist_id', true);
        if ($source_user_id === get_current_user_id() && $source_playlist_id !== '') {
            $source_playlists = \\MovieEngine\\Frontend\\Users\\UserLibrary::get_playlists($source_user_id);
            if (isset($source_playlists[$source_playlist_id])) {
                $source_playlists[$source_playlist_id]['items'] = $items;
                update_user_meta($source_user_id, '_movie_engine_playlists', $source_playlists);
            }
        }
        wp_send_json_success(['items' => $items]);
    }
    }

    private function render_listing($atts) {
        self::migrate_personal_playlists_batch();

        $sort = isset($_GET['playlist_sort']) ? sanitize_key(wp_unslash($_GET['playlist_sort'])) : 'trending';
        $sort = $sort === 'new' ? 'new' : 'trending';
        $orderby = $sort === 'new' ? 'date' : 'meta_value_num';
        $query_args = [
            'post_type' => self::POST_TYPE,
            'post_status' => 'publish',
            'posts_per_page' => max(1, min(48, absint($atts['limit']))),
            'orderby' => $orderby,
            'order' => 'DESC',
            'meta_query' => [['key' => '_me_cp_visibility', 'value' => 'public']],
        ];
        if ($sort !== 'new') {
            $query_args['meta_key'] = '_me_cp_vote_count';
        }
        $query = new \WP_Query($query_args);

        echo '<div class="me-community-heading"><div><p class="me-community-eyebrow">' . esc_html__('Made by movie fans', 'cine-movie-engine') . '</p><h2>' . esc_html($atts['title']) . '</h2></div></div>';
        echo '<nav class="me-community-sort" aria-label="' . esc_attr__('Sort playlists', 'cine-movie-engine') . '">';
        foreach (['trending' => __('Trending', 'cine-movie-engine'), 'new' => __('Newest', 'cine-movie-engine')] as $key => $label) {
            $url = add_query_arg('playlist_sort', $key);
            echo '<a class="' . ($sort === $key ? 'is-active' : '') . '" href="' . esc_url($url) . '">' . esc_html($label) . '</a>';
        }
        echo '</nav>';

        if ($query->have_posts()) {
            echo '<div class="me-community-grid">';
            $rank = 0;
            while ($query->have_posts()) {
                $query->the_post();
                $rank++;
                $this->render_card(get_the_ID(), $rank);
            }
            echo '</div>';
            wp_reset_postdata();
        } else {
            echo '<p class="me-community-empty">' . esc_html__('No public playlists yet. Publish one from My Playlists in your dashboard.', 'cine-movie-engine') . '</p>';
        }

    }

    private function render_card($playlist_id, $rank) {
        $cover = get_post_meta($playlist_id, '_me_cp_cover', true);
        $items = $this->get_valid_items($playlist_id);
        $votes = absint(get_post_meta($playlist_id, '_me_cp_vote_count', true));
        $views = absint(get_post_meta($playlist_id, '_me_cp_view_count', true));
        $url = add_query_arg('community_playlist', $playlist_id, remove_query_arg('community_playlist'));
        $cover_posters = [];
        if (!$cover) {
            foreach (array_slice($items, 0, 4) as $item_id) {
                $poster = \MovieEngine\Utils\Helpers::get_poster_url($item_id, 'medium');
                if ($poster) {
                    $cover_posters[] = $poster;
                }
            }
        }

        echo '<article class="me-community-card"><a class="me-community-cover" href="' . esc_url($url) . '"><span class="me-community-rank">#' . esc_html($rank) . '</span>';
        if ($cover) {
            echo '<img src="' . esc_url($cover) . '" alt="' . esc_attr(get_the_title($playlist_id)) . '" loading="lazy">';
        } elseif ($cover_posters) {
            echo '<span class="me-community-cover-collage me-community-cover-collage--' . esc_attr(count($cover_posters)) . '" aria-hidden="true">';
            foreach ($cover_posters as $poster) {
                echo '<img src="' . esc_url($poster) . '" alt="" loading="lazy">';
            }
            echo '</span>';
        } else {
            echo '<span class="me-community-cover-empty">' . esc_html__('Playlist', 'cine-movie-engine') . '</span>';
        }
        echo '<span class="me-community-item-count">' . esc_html(sprintf(_n('%s title', '%s titles', count($items), 'cine-movie-engine'), number_format_i18n(count($items)))) . '</span></a>';
        echo '<div class="me-community-card-body"><p class="me-community-card-category">' . esc_html(get_post_meta($playlist_id, '_me_cp_category', true) ?: __('Community pick', 'cine-movie-engine')) . '</p>';
        echo '<h3><a href="' . esc_url($url) . '">' . esc_html(get_the_title($playlist_id)) . '</a></h3>';
        echo '<p class="me-community-card-author">' . esc_html(get_the_author_meta('display_name', (int) get_post_field('post_author', $playlist_id))) . '</p>';
        echo '<div class="me-community-card-footer"><div class="me-community-card-stats"><span class="me-community-vote-count"><span class="fa-solid fa-thumbs-up" aria-hidden="true"></span> <span class="me-community-vote-total">' . esc_html(number_format_i18n($votes)) . '</span></span><span class="me-community-view-count"><span class="fa-solid fa-eye" aria-hidden="true"></span> ' . esc_html(number_format_i18n($views)) . '</span></div>';
        $this->render_vote_button($playlist_id, $votes);
        echo '</div></div></article>';
    }

    public static function get_personal_playlist_post_id($user_id, $playlist_id) {
        $matches = get_posts([
            'post_type' => self::POST_TYPE,
            'post_status' => ['publish', 'draft', 'private', 'pending'],
            'numberposts' => 1,
            'fields' => 'ids',
            'meta_query' => [
                'relation' => 'AND',
                ['key' => '_me_cp_source_user_id', 'value' => absint($user_id)],
                ['key' => '_me_cp_source_playlist_id', 'value' => sanitize_text_field($playlist_id)],
            ],
        ]);

        return $matches ? absint($matches[0]) : 0;
    }

    private static function find_legacy_personal_playlist_post_id($user_id, $playlist_name) {
        $matches = get_posts([
            'post_type' => self::POST_TYPE,
            'post_status' => 'publish',
            'author' => absint($user_id),
            'title' => sanitize_text_field($playlist_name),
            'numberposts' => 1,
            'fields' => 'ids',
            'meta_query' => [
                'relation' => 'AND',
                ['key' => '_me_cp_visibility', 'value' => 'public'],
                ['key' => '_me_cp_source_playlist_id', 'compare' => 'NOT EXISTS'],
            ],
        ]);

        return $matches ? absint($matches[0]) : 0;
    }

    public static function sync_personal_playlist($user_id, $playlist_id, $playlist = null) {
        $community_id = self::get_personal_playlist_post_id($user_id, $playlist_id);
        if (!is_array($playlist)) {
            if (!$community_id) {
                return 0;
            }
            wp_trash_post($community_id);
            return $community_id;
        }

        $items = array_values(array_filter(array_map('absint', (array) ($playlist['items'] ?? [])), function ($item_id) {
            return in_array(get_post_type($item_id), ['movie_engine_movie', 'movie_engine_series'], true) && get_post_status($item_id) === 'publish';
        }));

        if (!$community_id) {
            $community_id = self::find_legacy_personal_playlist_post_id($user_id, $playlist['name'] ?? '');
        }
        if (!$community_id && !$items) {
            return 0;
        }
        $description = sanitize_textarea_field($playlist['description'] ?? '');
        if ($description === '' && $items) {
            $description = sprintf(
                /* translators: %d: number of playlist titles */
                _n('A curated collection of %d title.', 'A curated collection of %d titles.', count($items), 'cine-movie-engine'),
                count($items)
            );
        }
        if (!$community_id) {
            $community_id = wp_insert_post([
                'post_type' => self::POST_TYPE,
                'post_status' => 'publish',
                'post_title' => sanitize_text_field($playlist['name'] ?? ''),
                'post_author' => absint($user_id),
            ], true);
            if (is_wp_error($community_id)) {
                return 0;
            }
            update_post_meta($community_id, '_me_cp_vote_count', 0);
            update_post_meta($community_id, '_me_cp_category', __('Community playlist', 'cine-movie-engine'));
            update_post_meta($community_id, '_me_cp_language', '');
            update_post_meta($community_id, '_me_cp_cover', '');
        }

        update_post_meta($community_id, '_me_cp_source_user_id', absint($user_id));
        update_post_meta($community_id, '_me_cp_source_playlist_id', sanitize_text_field($playlist_id));

        wp_update_post([
            'ID' => $community_id,
            'post_title' => sanitize_text_field($playlist['name'] ?? ''),
            'post_content' => $description,
            'post_status' => $items ? 'publish' : 'draft',
            'post_author' => absint($user_id),
        ]);
        update_post_meta($community_id, '_me_cp_items', $items);
        update_post_meta($community_id, '_me_cp_visibility', $items ? 'public' : 'private');

        return $community_id;
    }

    public static function migrate_personal_playlists_batch() {
        if (get_option('me_community_personal_playlists_migrated')) {
            return;
        }

        $batch_size = 100;
        $offset = absint(get_option('me_community_personal_playlists_offset', 0));
        $user_ids = get_users([
            'fields' => 'ID',
            'number' => $batch_size,
            'offset' => $offset,
            'meta_key' => '_movie_engine_playlists',
        ]);

        foreach ($user_ids as $user_id) {
            $playlists = \MovieEngine\Frontend\Users\UserLibrary::get_playlists($user_id);
            foreach ($playlists as $playlist_id => $playlist) {
                if (!empty($playlist['items'])) {
                    self::sync_personal_playlist($user_id, $playlist_id, $playlist);
                }
            }
        }

        if (count($user_ids) < $batch_size) {
            update_option('me_community_personal_playlists_migrated', 1, false);
            delete_option('me_community_personal_playlists_offset');
        } else {
            update_option('me_community_personal_playlists_offset', $offset + $batch_size, false);
        }
    }

    private function render_detail($playlist_id) {
        $playlist = get_post($playlist_id);
        if (!$playlist || $playlist->post_type !== self::POST_TYPE || $playlist->post_status !== 'publish') {
            echo '<p class="me-community-empty">' . esc_html__('Playlist not found.', 'cine-movie-engine') . '</p>';
            return;
        }
        $visibility = get_post_meta($playlist_id, '_me_cp_visibility', true) ?: 'public';
        if ($visibility === 'private' && (int) $playlist->post_author !== get_current_user_id() && !current_user_can('edit_post', $playlist_id)) {
            echo '<p class="me-community-empty">' . esc_html__('This playlist is private.', 'cine-movie-engine') . '</p>';
            return;
        }

        $items = $this->get_valid_items($playlist_id);
        $votes = absint(get_post_meta($playlist_id, '_me_cp_vote_count', true));
        $views = absint(get_post_meta($playlist_id, '_me_cp_view_count', true)) + 1;
        update_post_meta($playlist_id, '_me_cp_view_count', $views);
        $back_url = remove_query_arg('community_playlist');
        $can_manage = is_user_logged_in() && (int) $playlist->post_author === get_current_user_id();
        $cover = get_post_meta($playlist_id, '_me_cp_cover', true);
        $hero_posters = [];
        if (!$cover) {
            foreach (array_slice($items, 0, 5) as $item_id) {
                $poster = \MovieEngine\Utils\Helpers::get_poster_url($item_id, 'large');
                if ($poster) {
                    $hero_posters[] = $poster;
                }
            }
        }
        $author_id = absint($playlist->post_author);
        $author_avatar = get_user_meta($author_id, 'movie_engine_avatar_url', true);
        if (!$author_avatar) {
            $author_avatar = get_avatar_url($author_id, ['size' => 72]);
        }
        $social_whatsapp = preg_replace('/\D/', '', (string) get_user_meta($author_id, 'movie_engine_social_whatsapp', true));
        $social_instagram = get_user_meta($author_id, 'movie_engine_social_instagram', true);
        $social_facebook = get_user_meta($author_id, 'movie_engine_social_facebook', true);
        $created_date = get_the_date(get_option('date_format'), $playlist_id);

        echo '<a class="me-community-back" href="' . esc_url($back_url) . '">&larr; ' . esc_html__('All playlists', 'cine-movie-engine') . '</a>';
        echo '<main class="me-community-detail-layout"><header class="me-community-detail-hero">';
        echo '<div class="me-community-detail-art" aria-hidden="true">';
        if ($cover) {
            echo '<img src="' . esc_url($cover) . '" alt="">';
        } elseif ($hero_posters) {
            echo '<div class="me-community-detail-collage me-community-detail-collage--' . esc_attr(count($hero_posters)) . '">';
            foreach ($hero_posters as $poster) {
                echo '<img src="' . esc_url($poster) . '" alt="" loading="lazy">';
            }
            echo '</div>';
        }
        echo '</div><div class="me-community-detail-hero-shade"></div><div class="me-community-detail-content"><div class="me-community-detail-heading">';
        echo '<p class="me-community-eyebrow">' . esc_html(get_post_meta($playlist_id, '_me_cp_category', true) ?: __('Community playlist', 'cine-movie-engine')) . '</p>';
        echo '<h1>' . esc_html($playlist->post_title) . '</h1>';
        if ($playlist->post_content !== '') {
            echo '<p class="me-community-detail-description">' . esc_html(wp_strip_all_tags($playlist->post_content)) . '</p>';
        }
        echo '<div class="me-community-detail-curator"><img src="' . esc_url($author_avatar) . '" alt=""><span><strong>' . esc_html(get_the_author_meta('display_name', $author_id)) . '</strong><time datetime="' . esc_attr(get_the_date('c', $playlist_id)) . '">' . esc_html(sprintf(__('Created %s', 'cine-movie-engine'), $created_date)) . '</time></span></div></div>';
        if ($social_whatsapp || $social_instagram || $social_facebook) {
            echo '<nav class="me-community-curator-social" aria-label="' . esc_attr__('Curator social profiles', 'cine-movie-engine') . '">';
            if ($social_whatsapp) {
                echo '<a href="' . esc_url('https://wa.me/' . $social_whatsapp) . '" target="_blank" rel="noopener noreferrer" aria-label="' . esc_attr__('WhatsApp', 'cine-movie-engine') . '" title="' . esc_attr__('WhatsApp', 'cine-movie-engine') . '"><span class="fa-brands fa-whatsapp" aria-hidden="true"></span></a>';
            }
            if ($social_instagram) {
                echo '<a href="' . esc_url($social_instagram) . '" target="_blank" rel="noopener noreferrer" aria-label="' . esc_attr__('Instagram', 'cine-movie-engine') . '" title="' . esc_attr__('Instagram', 'cine-movie-engine') . '"><span class="fa-brands fa-instagram" aria-hidden="true"></span></a>';
            }
            if ($social_facebook) {
                echo '<a href="' . esc_url($social_facebook) . '" target="_blank" rel="noopener noreferrer" aria-label="' . esc_attr__('Facebook', 'cine-movie-engine') . '" title="' . esc_attr__('Facebook', 'cine-movie-engine') . '"><span class="fa-brands fa-facebook-f" aria-hidden="true"></span></a>';
            }
            echo '</nav>';
        }
        echo '<div class="me-community-detail-actions"><div class="me-community-detail-stats">';
        if ($visibility === 'public') {
            echo '<span class="me-community-vote-count"><span class="fa-solid fa-thumbs-up" aria-hidden="true"></span> <span class="me-community-vote-total">' . esc_html(number_format_i18n($votes)) . '</span></span>';
            echo '<span class="me-community-view-count"><span class="fa-solid fa-eye" aria-hidden="true"></span> ' . esc_html(number_format_i18n($views)) . '</span>';
        }
        echo '</div>';
        if ($visibility === 'public') {
            $this->render_vote_button($playlist_id, $votes);
        }
        echo '<button type="button" class="me-community-share" data-share-url="' . esc_url(add_query_arg('community_playlist', $playlist_id, remove_query_arg('community_playlist'))) . '"><span class="fa-solid fa-share-nodes" aria-hidden="true"></span> ' . esc_html__('Share', 'cine-movie-engine') . '</button></div></header>';
        echo '<section class="me-community-detail-list"><h2>' . esc_html__('Movies & TV series', 'cine-movie-engine') . '</h2>';
        if (!$items) {
            echo '<p class="me-community-empty">' . esc_html__('This playlist has no available titles.', 'cine-movie-engine') . '</p>';
        } else {
            foreach ($items as $index => $item_id) {
                $poster = \MovieEngine\Utils\Helpers::get_poster_url($item_id, 'medium');
                echo '<article class="me-community-title" data-post-id="' . esc_attr($item_id) . '"><span class="me-community-title-number">' . esc_html((string) ($index + 1)) . '</span>';
                echo '<a class="me-community-title-poster" href="' . esc_url(get_permalink($item_id)) . '" aria-label="' . esc_attr(sprintf(__('View %s', 'cine-movie-engine'), get_the_title($item_id))) . '">';
                if ($poster) {
                    echo '<img src="' . esc_url($poster) . '" alt="" loading="lazy">';
                } else {
                    echo '<span class="fa-solid fa-film" aria-hidden="true"></span>';
                }
                echo '</a><div class="me-community-title-info"><h3>' . esc_html(get_the_title($item_id)) . '</h3><p>' . esc_html(get_post_type($item_id) === 'movie_engine_series' ? __('TV Series', 'cine-movie-engine') : __('Movie', 'cine-movie-engine')) . '</p>';
                // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Helper escapes its output.
                echo self::render_title_extras($item_id) . '</div>';
                echo '<div class="me-community-title-actions">';
                if ($can_manage) {
                    echo '<div class="me-community-order-controls" aria-label="' . esc_attr(sprintf(__('Reorder %s', 'cine-movie-engine'), get_the_title($item_id))) . '">';
                    echo '<button type="button" class="me-community-move" data-playlist-id="' . esc_attr($playlist_id) . '" data-post-id="' . esc_attr($item_id) . '" data-direction="up" aria-label="' . esc_attr__('Move up', 'cine-movie-engine') . '" ' . disabled($index === 0, true, false) . '><span class="fa-solid fa-chevron-up" aria-hidden="true"></span></button>';
                    echo '<button type="button" class="me-community-move" data-playlist-id="' . esc_attr($playlist_id) . '" data-post-id="' . esc_attr($item_id) . '" data-direction="down" aria-label="' . esc_attr__('Move down', 'cine-movie-engine') . '" ' . disabled($index === count($items) - 1, true, false) . '><span class="fa-solid fa-chevron-down" aria-hidden="true"></span></button>';
                    echo '</div>';
                }
                echo '<a href="' . esc_url(get_permalink($item_id)) . '">' . esc_html__('View title', 'cine-movie-engine') . '</a></div></article>';
            }
        }
        echo '</section></main>';
    }

    private function render_vote_button($playlist_id, $votes) {
        $has_voted = is_user_logged_in() && get_user_meta(get_current_user_id(), '_me_cp_voted_' . $playlist_id, true);
        $label = $has_voted ? __('Voted', 'cine-movie-engine') : __('Vote', 'cine-movie-engine');
        if (!is_user_logged_in()) {
            echo '<a class="me-community-vote" href="' . esc_url(wp_login_url(get_permalink())) . '"><span class="fa-solid fa-thumbs-up" aria-hidden="true"></span> ' . esc_html__('Sign in to vote', 'cine-movie-engine') . '</a>';
            return;
        }
        echo '<button type="button" class="me-community-vote' . ($has_voted ? ' is-voted' : '') . '" data-playlist-id="' . esc_attr($playlist_id) . '" aria-pressed="' . ($has_voted ? 'true' : 'false') . '"' . ($has_voted ? ' disabled' : '') . '><span class="fa-solid fa-thumbs-up" aria-hidden="true"></span> ' . esc_html($label) . '</button>';
    }

    private function get_valid_items($playlist_id) {
        $items = get_post_meta($playlist_id, '_me_cp_items', true);
        if (!is_array($items)) {
            return [];
        }
        return array_values(array_filter(array_map('absint', $items), function ($item_id) {
            return in_array(get_post_type($item_id), ['movie_engine_movie', 'movie_engine_series'], true) && get_post_status($item_id) === 'publish';
        }));
    }

    public static function render_title_extras($post_id) {
        $details = [];
        $year = get_post_meta($post_id, '_movie_engine_year', true);
        $rating = get_post_meta($post_id, '_movie_engine_rating', true);
        $language = get_post_meta($post_id, '_movie_engine_primary_language', true);
        $content_rating = get_post_meta($post_id, '_movie_engine_mpaa', true);
        $genres = get_the_terms($post_id, 'movie_engine_genre');

        if ($year) {
            $details[] = esc_html($year);
        }
        if (is_numeric($rating)) {
            $details[] = '<span class="fa-solid fa-star" aria-hidden="true"></span> ' . esc_html(number_format((float) $rating, 1));
        }
        if ($content_rating) {
            $details[] = esc_html($content_rating);
        }
        if ($language) {
            $details[] = esc_html($language);
        }
        if (is_array($genres) && !is_wp_error($genres)) {
            $genre_names = array_map(function ($term) {
                return $term->name;
            }, array_slice($genres, 0, 2));
            if ($genre_names) {
                $details[] = esc_html(implode(', ', $genre_names));
            }
        }

        $summary = get_post_field('post_excerpt', $post_id);
        if (!$summary) {
            $summary = get_post_meta($post_id, '_movie_engine_tagline', true);
        }
        if (!$summary) {
            $summary = get_post_field('post_content', $post_id);
        }
        $summary = $summary ? wp_trim_words(wp_strip_all_tags($summary), 22) : '';

        $platform_names = [
            'jiohotstar' => 'JioHotstar',
            'manoramamax' => 'ManoramaMax',
            'netflix' => 'Netflix',
            'prime_video' => 'Prime Video',
            'saina_play' => 'Saina Play',
            'sonyliv' => 'SonyLIV',
            'sunnxt' => 'SunNXT',
            'zee5' => 'ZEE5',
        ];
        $provider_links = get_post_meta($post_id, '_movie_engine_ott_links', true);

        $html = '<div class="movie-engine-playlist-title-extra">';
        if ($details) {
            $html .= '<p class="movie-engine-playlist-title-meta">' . implode('<span aria-hidden="true">&bull;</span>', $details) . '</p>';
        }
        if ($summary) {
            $html .= '<p class="movie-engine-playlist-title-summary">' . esc_html($summary) . '</p>';
        }

        $valid_links = [];
        foreach ((array) $provider_links as $provider_link) {
            $platform = sanitize_key($provider_link['platform'] ?? '');
            $url = esc_url($provider_link['url'] ?? '');
            if (isset($platform_names[$platform]) && $url) {
                $valid_links[] = [
                    'name' => $platform_names[$platform],
                    'url' => $url,
                    'availability' => ($provider_link['availability'] ?? 'rent') === 'free' ? 'free' : 'rent',
                ];
            }
        }

        if ($valid_links) {
            $html .= '<div class="movie-engine-playlist-watch-links" aria-label="' . esc_attr__('Where to watch', 'cine-movie-engine') . '">';
            foreach (array_slice($valid_links, 0, 4) as $provider_link) {
                $watch_label = $provider_link['availability'] === 'free'
                    ? sprintf(__('Watch on %s', 'cine-movie-engine'), $provider_link['name'])
                    : sprintf(__('Rent on %s', 'cine-movie-engine'), $provider_link['name']);
                $html .= '<a href="' . esc_url($provider_link['url']) . '" target="_blank" rel="nofollow noopener noreferrer">' . esc_html($watch_label) . '</a>';
            }
            $html .= '</div>';
        } else {
            $html .= '<p class="movie-engine-playlist-watch-unavailable">' . esc_html__('Streaming links not listed', 'cine-movie-engine') . '</p>';
        }

        return $html . '</div>';
    }

    public function ajax_vote() {
        $this->verify_request();
        if (!is_user_logged_in()) {
            wp_send_json_error(['message' => esc_html__('Sign in to vote.', 'cine-movie-engine')], 401);
        }
        $playlist_id = isset($_POST['playlist_id']) ? absint($_POST['playlist_id']) : 0;
        $playlist = get_post($playlist_id);
        if (!$playlist || $playlist->post_type !== self::POST_TYPE || $playlist->post_status !== 'publish' || get_post_meta($playlist_id, '_me_cp_visibility', true) !== 'public') {
            wp_send_json_error(['message' => esc_html__('This playlist cannot be voted on.', 'cine-movie-engine')], 404);
        }
        $vote_key = '_me_cp_voted_' . $playlist_id;
        if (!add_user_meta(get_current_user_id(), $vote_key, '1', true)) {
            wp_send_json_error(['message' => esc_html__('You have already voted for this playlist.', 'cine-movie-engine')], 409);
        }
        $votes = absint(get_post_meta($playlist_id, '_me_cp_vote_count', true)) + 1;
        update_post_meta($playlist_id, '_me_cp_vote_count', $votes);
        wp_send_json_success(['votes' => $votes]);
    }

    public function ajax_move_title() {
        $this->verify_request();
        if (!is_user_logged_in()) {
            wp_send_json_error(['message' => esc_html__('Sign in to manage this playlist.', 'cine-movie-engine')], 401);
        }

        $playlist_id = isset($_POST['playlist_id']) ? absint($_POST['playlist_id']) : 0;
        $post_id = isset($_POST['post_id']) ? absint($_POST['post_id']) : 0;
        $direction = isset($_POST['direction']) ? sanitize_key(wp_unslash($_POST['direction'])) : '';
        $playlist = get_post($playlist_id);
        if (!$playlist || $playlist->post_type !== self::POST_TYPE || $playlist->post_status !== 'publish' || (int) $playlist->post_author !== get_current_user_id()) {
            wp_send_json_error(['message' => esc_html__('You cannot manage this playlist.', 'cine-movie-engine')], 403);
        }
        if (!$post_id || !in_array($direction, ['up', 'down'], true)) {
            wp_send_json_error(['message' => esc_html__('Invalid playlist item.', 'cine-movie-engine')], 400);
        }

        $items = $this->get_valid_items($playlist_id);
        $index = array_search($post_id, $items, true);
        $target_index = $direction === 'up' ? $index - 1 : $index + 1;
        if ($index === false || !isset($items[$target_index])) {
            wp_send_json_error(['message' => esc_html__('This title cannot be moved further.', 'cine-movie-engine')], 400);
        }

        $moving_item = $items[$index];
        $items[$index] = $items[$target_index];
        $items[$target_index] = $moving_item;
        update_post_meta($playlist_id, '_me_cp_items', $items);

        $source_user_id = absint(get_post_meta($playlist_id, '_me_cp_source_user_id', true));
        $source_playlist_id = get_post_meta($playlist_id, '_me_cp_source_playlist_id', true);
        if ($source_user_id === get_current_user_id() && $source_playlist_id !== '') {
            $source_playlists = \MovieEngine\Frontend\Users\UserLibrary::get_playlists($source_user_id);
            if (isset($source_playlists[$source_playlist_id])) {
                $source_playlists[$source_playlist_id]['items'] = $items;
                update_user_meta($source_user_id, '_movie_engine_playlists', $source_playlists);
            }
        }

        wp_send_json_success(['items' => $items]);
    }

    private function verify_request() {
        $nonce = isset($_POST['nonce']) ? sanitize_text_field(wp_unslash($_POST['nonce'])) : '';
        if (!wp_verify_nonce($nonce, self::NONCE_ACTION)) {
            wp_send_json_error(['message' => esc_html__('Your session has expired. Refresh the page and try again.', 'cine-movie-engine')], 403);
        }
    }
}