<?php
/**
 * The link to the manual on aumcreate.com, shown on the Plugins screen.
 *
 * Added for the wordpress.org listing. While this plugin shipped only inside a template kit the
 * buyer already had the manual through that channel; anyone installing it from the directory has
 * no such channel, and before this there was nothing in the admin that said where the manual is.
 *
 *  An address nobody can reach fails silently. A 404 here raises no warning, writes no log
 * entry, and does not stop the plugin working. So the table below is the only place an address is
 * written, an empty string means *not published in that language* and renders no link at all, and
 * every one of these four returned 200 when fetched before being written here -
 * together with a deliberately wrong address that returned 404, because four 200s prove nothing
 * on a site that answers 200 to everything.
 *
 * Modelled on `aumframe/src/Docs.php` and `aumnexcart/includes/class-docs.php` — same table
 * shape, same locale mapping, same reasons. `aumframe/tools/docs-link-check.mjs` finds this file
 * by those markers and checks it along with the others.
 *
 * @package AumReserva
 */

defined('ABSPATH') || exit;

final class AumReserva_Docs
{
    /** Site locale segment → the manual's published address. Empty string = not published there. */
    private const URLS = [
        'en'      => 'https://aumcreate.com/manual/aumreserva',
        'zh-hans' => 'https://aumcreate.com/zh-hans/manual/aumreserva',
        'zh-hant' => 'https://aumcreate.com/zh-hant/manual/aumreserva',
        'ja'      => 'https://aumcreate.com/ja/manual/aumreserva',
    ];

    /**
     * WordPress admin language → which of those four to send them to.
     *
     *  **The language of the prose and the language of the screenshots are two different
     * things.** This plugin ships one translation, `zh_CN` (there is no `zh_TW` and no `ja` in
     * `languages/`, and WordPress does not fall `zh_TW` back to `zh_CN`). So a Traditional
     * Chinese or Japanese administrator is reading an English admin screen, and the manual's
     * zh-hant and ja pages are translations of the prose carrying the English screenshots —
     * which is what matches what is on their screen.
 */
    private const WP_TO_SITE = [
        'zh_CN' => 'zh-hans',
        'zh_TW' => 'zh-hant',
        'zh_HK' => 'zh-hant',
        'ja'    => 'ja',
    ];

    private const FALLBACK = 'en';

    /**
     * `get_user_locale()` rather than `get_locale()`: the Plugins screen is read in whatever
     * language that administrator set for themselves, which can differ from the site's.
 */
    private static function locale(): string
    {
        return self::WP_TO_SITE[get_user_locale()] ?? self::FALLBACK;
    }

    /** The URL for this administrator, or '' when the page is not published in their language. */
    public static function url(): string
    {
        return self::URLS[self::locale()] ?? '';
    }
}