<?php

namespace Aumframe\Shortcodes;

defined('ABSPATH') || exit;

/**
 * `[aumframe_audio field="<meta key>"]` — a native audio player for an audio field of the current post.
 *
 * Why this has to exist.
 *
 * The content model has an `audio` field type; a field resolves to
 * `{id, url, filename, mime, size, hasFile}` and can be bound as text (the URL, the size)… and that is all:
 * there is no node that *plays* it. `Image` has `src`, `Embed` is static HTML with no bindings, `Shortcode`
 * runs PHP. So an audio field could be filled in the admin and never heard on the front end, with nothing
 * reported.
 *
 * A `Shortcode` node with `[aumframe_audio field="sound_clip"]` renders an `<audio controls>` for the attachment
 * stored in that field of the post being displayed. Empty field → empty string (a player with nothing to play
 * is worse than no player); the layout hides the block with a `post.meta.<field>.hasFile` condition.
 *
 *  Current post only. Inside a loop the shortcode still reads the page's post, not the row — a per-row
 * player would need the audio URL as a node binding, which is an editor-side change (recorded, not done).
 *
 * Attributes: `field` (required) - `preload` (`none` default - `metadata` - `auto`) - `class`.
 *
 *  Moved here from the AumCreate theme (aumframe 1.9.1)
 *
 * wordpress.org does not allow a theme to register shortcodes — Theme Check calls every `add_shortcode()`
 * in a theme *plugin-territory functionality [that] must not be used in themes*, as a blocking error.
 * The code is unchanged apart from the text domain; it only ever used core functions, so there was nothing
 * to rewire. `class="aum-audio …"` is kept so any styling that matched it still matches.
 */
final class Audio
{
    public static function boot(): void
    {
        add_shortcode('aumframe_audio', [self::class, 'render']);
    }

    public static function render($atts): string
    {
        $a = shortcode_atts(['field' => '', 'preload' => 'none', 'class' => ''], (array) $atts, 'aumframe_audio');
        $field = sanitize_key((string) $a['field']);
        if ($field === '') {
            return '';
        }

        $post_id = (int) get_queried_object_id();
        if (!$post_id) {
            $post_id = (int) get_the_ID();
        }
        if (!$post_id) {
            return '';
        }

        $raw = get_post_meta($post_id, $field, true);
        $att = is_numeric($raw) ? (int) $raw : 0;
        $url = $att ? (string) wp_get_attachment_url($att) : (is_string($raw) && preg_match('#^https?://#', $raw) ? $raw : '');
        if ($url === '') {
            return '';
        }

        $mime = $att ? (string) get_post_mime_type($att) : '';
        $preload = in_array($a['preload'], ['none', 'metadata', 'auto'], true) ? $a['preload'] : 'none';
        $class = trim('aum-audio ' . sanitize_html_class((string) $a['class']));

        return sprintf(
            '<audio class="%1$s" controls preload="%2$s" src="%3$s"%4$s>%5$s</audio>',
            esc_attr($class),
            esc_attr($preload),
            esc_url($url),
            $mime !== '' ? ' type="' . esc_attr($mime) . '"' : '',
            esc_html__('Your browser cannot play this recording.', 'aumframe')
        );
    }
}