<?php
namespace Zadex\Dynamic\Tags;

defined('ABSPATH') || exit;

use Zadex\Dynamic\Context;
use Zadex\Dynamic\Tag;

/**
 * A post meta value. Protected keys (leading underscore / `is_protected_meta`) are never printed: they hold
 * plugin internals that a page author with `edit_posts` must not be able to expose.
 */
final class CustomField extends Tag
{
    public function name(): string
    {
        return 'custom-field';
    }

    public function title(): string
    {
        return __('Custom field', 'zadex');
    }

    public function categories(): array
    {
        return ['text', 'url', 'number', 'color', 'image'];
    }

    public function controls(): array
    {
        return [
            ['id' => 'key', 'type' => 'text', 'label' => __('Meta key', 'zadex'), 'default' => '', 'dynamicOptions' => true],
        ];
    }

    public static function is_protected(string $key): bool
    {
        if ($key === '' || $key[0] === '_') {
            return true;
        }
        return function_exists('is_protected_meta') && is_protected_meta($key, 'post');
    }

    public function options(string $control, string $search, Context $ctx): array
    {
        if ($control !== 'key' || $ctx->post_id <= 0 || !function_exists('get_post_custom_keys')) {
            return [];
        }
        $out = [];
        foreach ((array) get_post_custom_keys($ctx->post_id) as $key) {
            if (is_string($key) && !self::is_protected($key)) {
                $out[] = ['value' => $key, 'label' => $key];
            }
        }
        return self::filter_options($out, $search);
    }

    public function render(array $settings, Context $ctx)
    {
        $key = isset($settings['key']) && is_string($settings['key']) ? trim($settings['key']) : '';
        if ($ctx->post_id <= 0 || self::is_protected($key)) {
            return '';
        }
        $value = get_post_meta($ctx->post_id, $key, true);
        return is_scalar($value) ? $value : self::field_value($value);
    }
}