<?php

if (!defined('ABSPATH')) {
    exit;
}

function aismart_external_guide_allowed() {
    $host = strtolower((string) wp_parse_url(home_url('/'), PHP_URL_HOST));
    $preview = !is_admin() && (isset($_GET['elementor-preview']) || isset($_GET['vc_editable']) || (isset($_GET['builder']) && class_exists('FusionBuilder')));
    return !preg_match('/^demo-[^.]+\.aismartcontent\.co$/', $host)
        && !$preview
        && is_user_logged_in()
        && current_user_can('manage_options');
}

function aismart_external_guide_catalog() {
    $posts = admin_url('edit.php');
    $create = admin_url('edit.php?page=aismart-one-click-post');
    $frontend = add_query_arg('aismart-canvas', 'new-post', home_url('/'));
    $quick = aismart_token_wp_ai_extension_enabled('quick_add_post');
    return [
        [
            'id' => 'add-post', 'title' => 'Quick Add New Post', 'icon' => 'admin-post',
            'aliases' => ['create article', 'write blog', 'one click', '1click', 'new draft', 'frontend', 'backend'],
            'available' => $quick, 'modes' => ['backend' => $create, 'frontend' => $frontend],
            'steps' => [
                ['title' => 'Choose a topic', 'body' => 'Choose Topic list or Manual topic, then select or enter the article topic.', 'selector' => '.aismart-one-click-topic-area', 'route' => 'tool'],
                ['title' => 'Choose the post settings', 'body' => 'Select the article format and Draft, Publish now, or Schedule. Check the date before scheduling.', 'selector' => '.aismart-one-click-options', 'route' => 'tool'],
                ['title' => 'Generate when ready', 'body' => 'Review the topic and settings, then use the normal 1Click Generate button. Generation uses your existing credits.', 'selector' => '#aismart-one-click-submit', 'route' => 'tool'],
                ['title' => 'Review your post', 'body' => 'Open the created post and review its text, images, language, and publication status.', 'selector' => '#the-list', 'route' => 'posts'],
            ],
        ],
        [
            'id' => 'translate', 'title' => 'Quick Translate', 'icon' => 'translation',
            'aliases' => ['language', 'multilingual', 'wpml', 'polylang', 'translate post', 'spanish', 'chinese'],
            'available' => aismart_token_wp_ai_extension_enabled('post_list_translate'), 'url' => $posts,
            'steps' => [
                ['title' => 'Choose the source post', 'body' => 'Find the original post in Posts. Use its AISmart Translate control rather than creating an unrelated copy.', 'selector' => '#the-list', 'route' => 'posts'],
                ['title' => 'Review the translation setup', 'body' => 'Check the configured target languages and source post before using its AISmart Translate button. That button starts the normal translation operation.', 'selector' => '.aismart-post-list-translate', 'route' => 'posts'],
                ['title' => 'Translate and review', 'body' => 'Start translation yourself, wait for its real status, and review the translated post and its language link.', 'selector' => '#the-list', 'route' => 'posts'],
            ],
        ],
        [
            'id' => 'improve', 'title' => 'Quick Improve Content', 'icon' => 'edit',
            'aliases' => ['rewrite', 'fix demo', 'text box', 'edit page', 'edit post', 'improve copy', 'content'],
            'available' => aismart_token_wp_ai_extension_enabled('editor_content'), 'url' => $posts,
            'steps' => [
                ['title' => 'Open the content', 'body' => 'Open the post or page you want to edit. Keep existing unsaved work before moving to another page.', 'selector' => '#the-list, #post', 'route' => 'current'],
                ['title' => 'Choose the text and direction', 'body' => 'Select the intended text or box, then open its Studio text tool. Review the scope and enter the writing direction.', 'selector' => '#aismart-editor-content-form, .aismart-builder-tools, .aismart-elementor-text', 'route' => 'current'],
                ['title' => 'Review before saving', 'body' => 'Use the normal text generation control when ready. Review the replacement, preserve surrounding content, and save only when you approve it.', 'selector' => '#aismart-editor-content-form, #publish, .editor-post-publish-button', 'route' => 'current'],
            ],
        ],
        [
            'id' => 'media', 'title' => 'Quick Generate Media', 'icon' => 'format-image',
            'aliases' => ['image', 'featured image', 'video', 'audio', 'voice', 'sound', 'picture', 'generate media'],
            'available' => aismart_token_wp_ai_extension_enabled('editor_media') || aismart_token_wp_ai_extension_enabled('sound_engineer'), 'url' => $posts,
            'steps' => [
                ['title' => 'Open the destination', 'body' => 'Open the post or page where the media belongs, then open its Studio tools.', 'selector' => '#aismart-editor-ai, #the-list', 'route' => 'current'],
                ['title' => 'Choose the media tool', 'body' => 'Choose Image & Video or Voice & Sound. Enter the prompt and review the available settings and placement.', 'selector' => '#aismart-editor-ai-media-tab, #aismart-editor-ai-audio-tab', 'route' => 'current'],
                ['title' => 'Generate and inspect the result', 'body' => 'Start the normal operation yourself. Wait for the real result, inspect it, and choose its placement before saving.', 'selector' => '#aismart-editor-image-form, #aismart-editor-video-form, #aismart-editor-voice-form', 'route' => 'current'],
            ],
        ],
        [
            'id' => 'schedule', 'title' => 'Quick Schedule Post', 'icon' => 'calendar-alt',
            'aliases' => ['publish later', 'date', 'time', 'schedule article', 'future publication'],
            'available' => true, 'url' => $posts,
            'steps' => [
                ['title' => 'Open the post', 'body' => 'Open the draft you want to schedule. Review its content and current status first.', 'selector' => '#the-list, #post', 'route' => 'current'],
                ['title' => 'Set the publish time', 'body' => 'Open the native publish date controls and choose a future date and time in the site timezone.', 'selector' => '#timestampdiv, #misc-publishing-actions, .editor-post-publish-panel, .editor-post-schedule', 'route' => 'current'],
                ['title' => 'Confirm the schedule', 'body' => 'Use the native Schedule control yourself, then verify the saved date and Scheduled status in Posts.', 'selector' => '#publish, .editor-post-publish-button, #the-list', 'route' => 'current'],
            ],
        ],
        aismart_external_guide_credits_entry(),
    ];
}

// AI amounts use Main's x100 wallet denomination; TeleWhats credits are 1:1 (2026-10-26).
function aismart_external_guide_credits_entry() {
    $plans = 'https://aismartcontent.co/dashboard/user/payment';
    $telewhats = 'https://telewhats.com';
    return [
        'id' => 'credits', 'title' => 'Credits & Top-Up Guide', 'icon' => 'money-alt', 'kind' => 'reference',
        'aliases' => ['credit', 'credits', 'balance', 'wallet', 'price', 'pricing', 'cost', 'plan', 'enterprise', 'subscription', 'top up', 'topup', 'refill', 'buy credits', 'how much', 'money', 'payment', 'package', 'pack', 'reset', 'renewal', 'run out', 'wp unit', 'cf credits', 'slip', 'easyslip', 'delivery', 'postage', 'telewhats'],
        'available' => true, 'url' => $plans,
        'steps' => [
            [
                'title' => 'Credits in one minute',
                'body' => 'Credits are separate balances your workspace receives from a plan or top-up. Each type pays only for its own work, so an empty Video balance cannot borrow from Text or WordPress credits.',
                'points' => [
                    'AI wallets: Text Credits, Image Credits, WP Unit Credits, Media Credits, Video Credits, Avatar Credits, and AIMagic Credits.',
                    'TeleWhats commerce credits: CF Credits, CF Slip Credits, and Delivery Credits.',
                    'Studio checks the balance before a paid action starts. If it is not enough, the action does not run and you can top up.',
                    'Reading this Help Book is free. It never buys credits or starts a paid action.',
                ],
            ],
            [
                'title' => 'What each AI credit pays for',
                'body' => 'AI plan cards show smaller plan-unit amounts. A listing of 500 WordPress Credits funds 50,000 WP Unit Credits (500 x 100) in your wallet; these are the same grant, not two balances. TeleWhats CF, CF Slip, and Delivery Credits stay 1:1.',
                'points' => [
                    'Text Credits: AI writing uses the displayed balance as words are generated; check the tool quote for the exact cost.',
                    'Image Credits: a standard generated image uses 100 Image Credits. A WordPress AI image may instead spend WP Unit Credits; check its quote.',
                    'WP Unit Credits: a standard WordPress AI text request uses 100, such as translating one post into one language. Four WordPress AI images can use 400.',
                    'Media Credits: a 60-second Stability MP3 currently uses about 1,000 Media Credits. Music videos and other providers have different quotes.',
                    'Video Credits: an 8-second AI Learning video uses 100 Video Credits. Other video tools show their own quote.',
                    'Avatar Credits: talking-avatar work needs an active monthly or yearly plan; the cost depends on the clip and is quoted before generation.',
                    'AIMagic Credits: one AIMagic guide uses 100 AIMagic Credits. Other AIMagic tools can quote different amounts.',
                ],
            ],
            [
                'title' => 'Example: Enterprise Monthly, $299',
                'body' => 'Enterprise Monthly costs $299 per month before tax. When it starts and on each monthly renewal, the workspace receives these spendable wallet amounts:',
                'points' => [
                    '100,000,000 Text Credits for AI writing; the number of words depends on the quoted writing cost.',
                    '75,000 Image Credits: about 750 standard images at 100 each.',
                    '50,000 WP Unit Credits: about 500 standard WordPress AI text requests at 100 each.',
                    '160,000 Media Credits: about 160 one-minute MP3s at the example 1,000-credit quote; music video rates differ.',
                    '1,000 Video Credits: about 10 eight-second AI Learning videos at 100 each.',
                    '1,000 Avatar Credits for talking-avatar work; check the quote for each clip.',
                    '1,500 AIMagic Credits: about 15 AIMagic guides at 100 each.',
                    '25 team seats share the workspace pools; each member needs an assigned allowance. All AI tools and templates and priority support are included.',
                    'Enterprise Yearly costs $2,990 per year including tax; compare its own credit amounts before buying, as they can differ from Monthly.',
                ],
                'example' => 'Example: with no previous WordPress balance, Enterprise grants the workspace 50,000 WP Unit Credits. One standard 100-credit text request leaves 49,900 WP Unit Credits.',
                'link' => $plans, 'linkLabel' => 'Compare Plans',
            ],
            [
                'title' => 'How the monthly reset works',
                'body' => 'On each renewal date, Enterprise gives a new monthly allowance. Unused monthly plan credits do not roll over; the new allowance replaces them.',
                'points' => [
                    'Credits from a top-up pack are kept separately. The monthly reset does not remove them.',
                    'Top-up credits stay usable until their own expiry date, even after renewal.',
                    'If the subscription ends, its remaining monthly credits end too, but valid top-up credits remain.',
                ],
                'example' => 'Example: 12,000 monthly WP Unit Credits remain at renewal. They are replaced by a fresh 50,000, not 62,000. Unexpired WP Unit Credits from a top-up remain available separately.',
            ],
            [
                'title' => 'Ran out before renewal? Top up now',
                'body' => 'You do not need to wait for next month. A one-time pack adds wallet credits after payment confirmation. These are the spendable amounts, with USD prices before tax:',
                'points' => [
                    'Basic Pack $99 (3 months): 30,000,000 Text Credits; 20,000 Image Credits; 15,000 WP Unit Credits; 1,000 Media Credits; 400 Video Credits; 200 Avatar Credits; 5,000 AIMagic Credits.',
                    'Standard Pack $199 (6 months): 60,000,000 Text Credits; 40,000 Image Credits; 30,000 WP Unit Credits; 2,000 Media Credits; 700 Video Credits; 500 Avatar Credits; 7,500 AIMagic Credits.',
                    'Premium Pack $299 (12 months): 100,000,000 Text Credits; 60,000 Image Credits; 45,000 WP Unit Credits; 3,000 Media Credits; 1,000 Video Credits; 1,000 Avatar Credits; 10,000 AIMagic Credits.',
                    'A top-up adds balance only. It does not upgrade your plan or unlock plan-only features.',
                ],
                'example' => 'Example: your Enterprise WP Unit Credits reach 0 on day 20. A $99 Basic Pack adds 15,000 WP Unit Credits, enough for about 150 standard 100-credit requests. At renewal Enterprise adds 50,000 new monthly units; any unused Basic Pack units remain until their expiry.',
                'link' => $plans, 'linkLabel' => 'Open Plans & Top-Ups',
            ],
            [
                'title' => 'TeleWhats CF Credits',
                'body' => '1 CF Credit = 1 approved Facebook or Instagram Live CF order. Each credit costs THB 1 ($10 = 320 CF Credits). CF Credits are bought separately in TeleWhats and are not reset by your monthly plan.',
                'points' => [
                    'Welcome bonus: 10 CF Credits after your first real Live CF monitor starts.',
                    'THB 500 = 500 CF Credits.',
                    'THB 2,500 = 3,000 CF Credits (+20% bonus).',
                    'THB 5,000 = 6,500 CF Credits (+30% bonus).',
                    'THB 10,000 = 13,500 CF Credits (+35% bonus).',
                    'THB 20,000 = 28,000 CF Credits (+40% bonus).',
                ],
                'example' => 'Example: a live sale with 300 approved orders uses 300 CF Credits. If an approval fails or is rolled back, its credit is refunded.',
                'link' => $telewhats, 'linkLabel' => 'Open TeleWhats',
            ],
            [
                'title' => 'TeleWhats CF Slip Credits',
                'body' => '1 CF Slip Credit = 1 automatic bank-slip check with EasySlip. Each credit costs THB 2 ($10 = 160 CF Slip Credits). There is no welcome bonus.',
                'points' => [
                    'THB 2,500 = 1,500 CF Slip Credits (+20% bonus).',
                    'THB 5,000 = 3,250 CF Slip Credits (+30% bonus).',
                    'THB 10,000 = 6,750 CF Slip Credits (+35% bonus).',
                    'THB 20,000 = 14,000 CF Slip Credits (+40% bonus).',
                    'A fake, duplicate, or rejected slip still uses its credit once the check has started.',
                    'With 0 CF Slip Credits, shoppers send the slip in Messenger and you check it yourself.',
                ],
                'example' => 'Example: 200 shoppers upload payment slips, so 200 CF Slip Credits are used. CF Credits and CF Slip Credits cannot pay for each other.',
                'link' => $telewhats, 'linkLabel' => 'Open TeleWhats',
            ],
            [
                'title' => 'TeleWhats Delivery Credits',
                'body' => '1 Delivery Credit = THB 1 of shipping postage. The real carrier price is used when you book a parcel. Delivery refills are paid in Thai baht.',
                'points' => [
                    '500 Delivery Credits for THB 539.',
                    '1,000 Delivery Credits for THB 1,065.',
                    '2,500 Delivery Credits for THB 2,646.',
                    '5,000 Delivery Credits for THB 5,280.',
                    '10,000 Delivery Credits for THB 10,547.',
                    'The small difference covers card processing fees; every purchased credit is spendable postage.',
                ],
                'example' => 'Example: with 500 Delivery Credits, booking a THB 25.04 parcel leaves THB 474.96 available and THB 25.04 reserved for that parcel.',
                'link' => $telewhats, 'linkLabel' => 'Open TeleWhats',
            ],
            [
                'title' => 'Buy and check safely',
                'body' => 'Every credit type has its own balance and its own top-up. Choose the type you actually need.',
                'points' => [
                    'AI credits: view balances and buy plans or packs on your AISmartContent dashboard.',
                    'CF, CF Slip, and Delivery Credits: the workspace owner buys them in the TeleWhats Live CF credits panel.',
                    'Credits are added only after the payment provider confirms payment. Closing checkout before paying does not charge you.',
                    'If a balance looks wrong, contact support instead of buying again.',
                ],
                'link' => $plans, 'linkLabel' => 'Open Plans & Top-Ups',
            ],
        ],
    ];
}

function aismart_external_guide_assets() {
    if (!aismart_external_guide_allowed()) {
        return;
    }
    $root = dirname(__DIR__);
    $url = plugin_dir_url($root . '/aismart-token.php');
    wp_enqueue_style('dashicons');
    wp_enqueue_style('aismart-external-guide', $url . 'assets/external-guide.css', [], (string) filemtime($root . '/assets/external-guide.css'));
    wp_enqueue_script('aismart-external-guide', $url . 'assets/external-guide.js', [], (string) filemtime($root . '/assets/external-guide.js'), true);
    wp_add_inline_script('aismart-external-guide', 'window.AISmartExternalGuide = ' . wp_json_encode([
        'catalog' => aismart_external_guide_catalog(),
        'postsUrl' => admin_url('edit.php'),
        'storageKey' => 'aismart-help-v1-' . get_current_blog_id() . '-' . get_current_user_id(),
    ]) . ';', 'before');
}
add_action('admin_enqueue_scripts', 'aismart_external_guide_assets', 40);
add_action('wp_enqueue_scripts', 'aismart_external_guide_assets', 40);
add_action('elementor/editor/after_enqueue_scripts', 'aismart_external_guide_assets', 40);

function aismart_external_guide_render() {
    static $rendered = false;
    if ($rendered || !aismart_external_guide_allowed()) {
        return;
    }
    $rendered = true;
    ?>
    <aside id="aismart-help-book" aria-label="AISmart Help Book">
        <button type="button" id="aismart-help-launcher" aria-expanded="false" aria-controls="aismart-help-panel" title="Open AISmart Help Book"><span class="dashicons dashicons-book-alt" aria-hidden="true"></span><span>Studio Help</span></button>
        <section id="aismart-help-panel" role="dialog" aria-label="AISmart Help Book" hidden>
            <header class="aismart-help-header"><strong>AISmart Help Book</strong><button type="button" id="aismart-help-close" title="Close help" aria-label="Close help"><span class="dashicons dashicons-no-alt" aria-hidden="true"></span></button></header>
            <div id="aismart-help-home">
                <label class="aismart-help-search"><span class="dashicons dashicons-search" aria-hidden="true"></span><span class="screen-reader-text">Search guides</span><input id="aismart-help-search" type="search" role="combobox" aria-autocomplete="list" aria-controls="aismart-help-results" aria-expanded="false" autocomplete="off" placeholder="Search guides"></label>
                <div id="aismart-help-results" role="listbox" aria-label="Guide suggestions"></div>
                <p id="aismart-help-search-status" role="status" aria-live="polite"></p>
            </div>
            <section id="aismart-help-mode" aria-label="Choose where to work" hidden><div class="aismart-help-guide-heading"><button type="button" id="aismart-help-mode-back" title="Back to help book" aria-label="Back to help book"><span class="dashicons dashicons-arrow-left-alt2" aria-hidden="true"></span></button><h2>Quick Add New Post</h2></div><div class="aismart-help-mode-options"><button type="button" data-aismart-help-mode="backend"><span class="dashicons dashicons-admin-generic" aria-hidden="true"></span>Use Backend</button><button type="button" data-aismart-help-mode="frontend"><span class="dashicons dashicons-admin-site-alt3" aria-hidden="true"></span>Use Frontend</button></div></section>
            <section id="aismart-help-guide" hidden>
                <div class="aismart-help-guide-heading"><button type="button" id="aismart-help-back" title="Back to help book" aria-label="Back to help book"><span class="dashicons dashicons-arrow-left-alt2" aria-hidden="true"></span></button><h2 id="aismart-help-guide-title"></h2></div>
                <p id="aismart-help-progress"></p><h3 id="aismart-help-step-title"></h3><p id="aismart-help-instruction"></p>
                <ul id="aismart-help-points" hidden></ul>
                <p id="aismart-help-example" hidden></p>
                <p id="aismart-help-target-status" role="status" aria-live="polite"></p>
                <a id="aismart-help-open-tool" href="#"><span class="dashicons dashicons-external" aria-hidden="true"></span><span id="aismart-help-open-tool-label">Open Tool</span></a>
                <div class="aismart-help-navigation"><button type="button" id="aismart-help-previous" title="Previous instruction" aria-label="Previous instruction"><span class="dashicons dashicons-arrow-left-alt2" aria-hidden="true"></span></button><button type="button" id="aismart-help-next">I Did This<span class="dashicons dashicons-arrow-right-alt2" aria-hidden="true"></span></button></div>
            </section>
        </section>
    </aside>
    <?php
}
add_action('admin_footer', 'aismart_external_guide_render', 50);
add_action('wp_footer', 'aismart_external_guide_render', 15);
add_action('elementor/editor/footer', 'aismart_external_guide_render', 50);

function aismart_external_frontend_canvas() {
    if (!aismart_external_guide_allowed()
        || is_admin()
        || !aismart_token_wp_ai_extension_enabled('quick_add_post')
        || sanitize_key(wp_unslash((string) ($_GET['aismart-canvas'] ?? ''))) !== 'new-post') {
        return;
    }
    aismart_token_one_click_post_page();
}
add_action('wp_footer', 'aismart_external_frontend_canvas', 10);