مستندات فنی قالب XPay

<?php
/*
Template Name: faq
*/

/**
 * This file is handled by MVC routing system
 * Content is rendered from views/
 * 
 * @see routes.php
 */

/**
 * FAQ page
 */
public function faq()
{
    $data = [
        'page_title' => get_the_title(),
        'faqs' => get_field('faq_items'), // مثال: دریافت از ACF
        // اضافه کردن داده‌های مورد نیاز
    ];

    $this->render('pages.faq', $data);
}

<?php
/**
 * FAQ Page Template
 * 
 * @var string $page_title
 * @var array $faqs
 */

defined('ABSPATH') || exit;
?>

<div class="faq-page">
    <h1><?php echo esc_html($page_title); ?></h1>
    
    <?php if (!empty($faqs)): ?>
        <div class="faq-list">
            <?php foreach ($faqs as $faq): ?>
                <div class="faq-item">
                    <h3><?php echo esc_html($faq['question']); ?></h3>
                    <p><?php echo wp_kses_post($faq['answer']); ?></p>
                </div>
            <?php endforeach; ?>
        </div>
    <?php endif; ?>
</div>

Template::register('faq', PageController::class, 'faq', 'pages.faq');

Template::register(
    'template-name',      // نام template (باید با Template Name در فایل root یکسان باشد)
    Controller::class,    // کلاس کنترلر
    'methodName',         // نام متد در کنترلر
    'view.path'          // مسیر view با dot notation
);

<?php
/*
Template Name: archive-video
*/

/**
 * This file is handled by MVC routing system
 * Content is rendered from views/
 * 
 * @see routes.php
 */

/**
 * Video archive
 */
public function video()
{
    $data = [
        'posts' => new \WP_Query([
            'post_type' => 'video',
            'posts_per_page' => get_option('posts_per_page'),
            'paged' => get_query_var('paged') ? get_query_var('paged') : 1,
        ]),
        'archive_title' => get_field('video_archive_title', 'option'),
    ];

    $this->render('archives.video', $data);
}

<?php
/**
 * Video Archive Template
 * 
 * @var WP_Query $posts
 * @var string $archive_title
 */

defined('ABSPATH') || exit;
?>

<div class="video-archive">
    <h1><?php echo esc_html($archive_title); ?></h1>
    
    <?php if ($posts->have_posts()): ?>
        <div class="video-list">
            <?php while ($posts->have_posts()): $posts->the_post(); ?>
                <article class="video-item">
                    <h2><?php the_title(); ?></h2>
                    <?php the_excerpt(); ?>
                </article>
            <?php endwhile; ?>
        </div>
        
        <?php
        // Pagination
        the_posts_pagination();
        wp_reset_postdata();
        ?>
    <?php else: ?>
        <p>ویدیویی یافت نشد.</p>
    <?php endif; ?>
</div>

Template::register('archive-video', ArchiveController::class, 'video', 'archives.video');

<?php
/*
Template Name: single-video
*/

/**
 * This file is handled by MVC routing system
 * Content is rendered from views/
 * 
 * @see routes.php
 */

/**
 * Single video page
 */
public function video()
{
    global $post;

    $data = [
        'post' => $post,
        'video_url' => get_field('video_url'),
        'duration' => get_field('video_duration'),
        'related_videos' => $this->getRelatedVideos($post->ID),
    ];

    $this->render('singles.video', $data);
}

/**
 * Get related videos
 */
private function getRelatedVideos($post_id)
{
    return new \WP_Query([
        'post_type' => 'video',
        'posts_per_page' => 4,
        'post__not_in' => [$post_id],
        'orderby' => 'rand',
    ]);
}

<?php
/**
 * Single Video Template
 * 
 * @var WP_Post $post
 * @var string $video_url
 * @var string $duration
 * @var WP_Query $related_videos
 */

defined('ABSPATH') || exit;
?>

<article class="single-video">
    <h1><?php echo esc_html($post->post_title); ?></h1>
    
    <div class="video-player">
        <iframe src="<?php echo esc_url($video_url); ?>"></iframe>
    </div>
    
    <div class="video-content">
        <?php echo wp_kses_post($post->post_content); ?>
    </div>
    
    <?php if ($related_videos->have_posts()): ?>
        <div class="related-videos">
            <h2>ویدیوهای مرتبط</h2>
            <!-- نمایش ویدیوهای مرتبط -->
        </div>
    <?php endif; ?>
</article>

Template::register('single-video', SingleController::class, 'video', 'singles.video');

<?php

namespace XPayMain\Controllers;

defined('ABSPATH') || exit;

use XPayMain\Core\Controller;

/**
 * VideoController
 * 
 * Handles video-related functionality
 * 
 * @package XPayMain\Controllers
 * @since 2.0.0
 */
class VideoController extends Controller
{
    /**
     * Display video gallery
     */
    public function gallery()
    {
        $data = [
            'videos' => $this->getAllVideos(),
            'categories' => $this->getVideoCategories(),
        ];

        $this->render('video.gallery', $data);
    }

    /**
     * Get all videos
     */
    private function getAllVideos()
    {
        return new \WP_Query([
            'post_type' => 'video',
            'posts_per_page' => -1,
        ]);
    }

    /**
     * Get video categories
     */
    private function getVideoCategories()
    {
        return get_terms([
            'taxonomy' => 'video_category',
            'hide_empty' => true,
        ]);
    }
}

use XPayMain\Controllers\VideoController;

Template::register('video-gallery', VideoController::class, 'gallery', 'video.gallery');

<?php
/**
 * Video Card Partial
 * 
 * @var WP_Post $video
 */

defined('ABSPATH') || exit;
?>

<div class="video-card">
    <?php if (has_post_thumbnail($video->ID)): ?>
        <div class="video-thumbnail">
            <?php echo get_the_post_thumbnail($video->ID, 'medium'); ?>
        </div>
    <?php endif; ?>
    
    <h3><?php echo esc_html($video->post_title); ?></h3>
    <p><?php echo wp_trim_words($video->post_excerpt, 20); ?></p>
    
    <a href="<?php echo get_permalink($video->ID); ?>">
        مشاهده ویدیو
    </a>
</div>

<?php
// در فایل view اصلی
foreach ($videos as $video): 
    include get_template_directory() . '/views/partials/video-card.php';
endforeach;
?>

// در کنترلر
public function gallery()
{
    $videos = $this->getAllVideos();
    
    $videoCards = '';
    foreach ($videos as $video) {
        $videoCards .= $this->renderToString('partials.video-card', ['video' => $video]);
    }
    
    $this->render('video.gallery', ['video_cards' => $videoCards]);
}

// در wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', true);

// در functions.php موقتاً اضافه کنید
add_action('init', function() {
    if (current_user_can('administrator')) {
        echo '<pre>';
        print_r(\XPayMain\Core\Template::getRoutes());
        echo '</pre>';
    }
});

// در Template.php موقتاً اضافه کنید
public static function handleTemplateRedirect()
{
    $templateType = self::getTemplateType();
    
    // Debug
    if (current_user_can('administrator')) {
        echo "<!-- Template Type: {$templateType} -->";
    }
    
    // ... ادامه کد
}

Template::register('faq', PageController::class, 'faq', 'pages.faq');
// فایل باید در: views/pages/faq.php

Template::register('faq', PageController::class, 'faq', 'pages/faq.php'); // ❌

// ✅ درست
$data = [
    'title' => 'عنوان صفحه',
    'items' => $items,
];

// ❌ نادرست
$data = $items; // نه آرایه associative

// برای متن ساده
<?php echo esc_html($text); ?>

// برای URL
<?php echo esc_url($url); ?>

// برای attribute
<?php echo esc_attr($attribute); ?>

// برای HTML (فقط با کنترل شده)
<?php echo wp_kses_post($content); ?>

<?php
/**
 * Page Title
 * 
 * Description of what this view does
 * 
 * @var string $title Page title
 * @var array $items List of items to display
 * @var WP_Post $post Current post object
 */
?>