<?php

namespace bff\modules\seo\social;

use bff\tpl\admin\Form;
use bff\modules\seo\Template;

/**
 * Twitter Network
 * @see https://developer.twitter.com/en/docs/twitter-for-websites/cards/guides/getting-started
 * @see https://cards-dev.twitter.com/validator
 * @copyright Tamaranga
 */
class Twitter implements Provider
{
    /** @var array meta cache */
    protected $meta = [];

    /**
     * Provider unique key
     * @return string
     */
    public function providerKey(): string
    {
        return 'tw';
    }

    /**
     * Provider title
     * @return string
     */
    public function providerTitle(): string
    {
        return 'Twitter';
    }

    /**
     * Page settings form
     * @param Form $form
     * @param bool $static form
     * @param bool $general
     * @param array $opts
     */
    public function form($form, $static = false, $general = false, array $opts = [])
    {
        $form->text('tw_title', _t('@seo', 'Twitter Title'));
    }

    /**
     * General settings form
     * @param Form $form
     */
    public function settings($form)
    {
        // ...
    }

    /**
     * Get social page meta
     * @param Template $template seo template
     * @param array $page page data
     * @param string $lang language
     * @param bool|array $landing active landing page or false
     * @param array $opts [social_images_key, general_social_template_key]
     * @return array
     */
    public function getMeta(Template $template, array $page, string $lang, $landing, array $opts = []): array
    {
        if ($this->meta) {
            return $this->meta;
        }

        // ...

        return $this->meta;
    }
}