<?php
namespace Zadex\Dynamic\Tags;

defined('ABSPATH') || exit;

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

/**
 * Base for custom-field plugins (ACF, Pods, Toolset, Meta Box). Registered by the Registry only when the
 * plugin's API function exists (`required_function()`).
 */
abstract class PluginField extends Tag
{
    abstract public static function required_function(): string;

    /** @return mixed raw field value */
    abstract protected function field(string $key, Context $ctx);

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

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

    public function group(): string
    {
        return $this->name();
    }

    public function render(array $settings, Context $ctx)
    {
        $key = isset($settings['key']) && is_string($settings['key']) ? trim($settings['key']) : '';
        if ($key === '' || !function_exists(static::required_function())) {
            return '';
        }
        return self::field_value($this->field($key, $ctx));
    }
}