GitHub - jamal13647850/wp-helpers-package

# مستندات فنی کتابخانه WP Helpers

## 1. نگاه کلی به سیستم

### هدف
کتابخانه WP Helpers یک مجموعه ابزار و کلاس‌های کمکی برای توسعه‌دهندگان وردپرس است که امکانات گسترده‌ای را برای پیاده‌سازی سریع‌تر و کارآمدتر قابلیت‌های مختلف در پروژه‌های وردپرسی فراهم می‌کند. این کتابخانه با هدف ساده‌سازی توسعه افزونه‌ها و قالب‌های وردپرس طراحی شده است.

### معماری
کتابخانه WP Helpers با معماری شیءگرا (OOP) طراحی شده و از الگوهای طراحی مدرن مانند Facade، Singleton، و Strategy بهره می‌برد. این کتابخانه در فضای نام `jamal13647850\wphelpers` قرار دارد و شامل چندین زیرسیستم اصلی است:

1. **سیستم کش (Cache)**: مدیریت کش با پشتیبانی از چندین درایور مختلف
2. **سیستم نمایش (View)**: موتور قالب‌سازی مبتنی بر Twig
3. **سیستم اعتبارسنجی (Validation)**: اعتبارسنجی فرم‌ها و درخواست‌ها
4. **مدیریت HTMX**: پشتیبانی از تعاملات AJAX مدرن با استفاده از HTMX
5. **ابزارهای کاربردی**: مجموعه‌ای از کلاس‌های کمکی برای کار با ووکامرس، نظرات، امتیازدهی و غیره
6. **سیستم تنظیمات (Config)**: مدیریت جامع تنظیمات پروژه و ارتباط با wp_options و ACF

### جایگاه کد در سیستم
این کتابخانه به عنوان یک لایه میانی بین هسته وردپرس و کد اختصاصی پروژه عمل می‌کند. توسعه‌دهندگان می‌توانند با استفاده از این کتابخانه، قابلیت‌های پیشرفته را بدون نیاز به نوشتن کد تکراری پیاده‌سازی کنند.

## 2. جزئیات فنی

### سیستم کش (Cache)

#### CacheInterface
رابط اصلی برای تمام درایورهای کش که متدهای استاندارد برای ذخیره، بازیابی و مدیریت داده‌های کش را تعریف می‌کند.

```php
interface CacheInterface {
    public function set(string $key, $value, ?int $expiration = null): bool;
    public function get(string $key, $default = null);
    public function delete(string $key): bool;
    public function exists(string $key): bool;
    public function flush(): bool;
}

CacheManager

کلاس Facade برای سیستم کش که امکان استفاده از درایورهای مختلف را فراهم می‌کند.

پارامترها:

$driver_type: نوع درایور کش ('transient', 'object', 'file')
$prefix: پیشوند کلیدهای کش
$default_expiration: زمان انقضای پیش‌فرض به ثانیه

متدهای اصلی:

set(): ذخیره داده در کش
get(): بازیابی داده از کش
delete(): حذف داده از کش
remember(): بازیابی داده از کش یا ذخیره نتیجه تابع callback

درایورهای کش

سه درایور اصلی برای سیستم کش وجود دارد:

TransientCacheDriver: استفاده از سیستم transient وردپرس
ObjectCacheDriver: استفاده از سیستم object cache وردپرس
FileCacheDriver: ذخیره کش در فایل (برای نمایش؛ برای محیط تولید توصیه نمی‌شود)

سیستم نمایش (View)

ViewInterface

رابط اصلی برای سیستم نمایش که متدهای لازم برای رندر قالب‌ها را تعریف می‌کند.

View

پیاده‌سازی سیستم نمایش با استفاده از موتور قالب‌سازی Twig.

متدهای اصلی:

render(): رندر یک قالب و برگرداندن نتیجه به صورت رشته
display(): رندر یک قالب و نمایش مستقیم آن
render_with_exit(): رندر یک قالب و خروج از اجرا

سیستم اعتبارسنجی (Validation)

HTMX_Validator

کلاس اعتبارسنجی داده‌ها با پشتیبانی از قوانین مختلف اعتبارسنجی.

متدهای اصلی:

validate(): اعتبارسنجی داده‌ها بر اساس قوانین تعریف شده
getErrors(): دریافت خطاهای اعتبارسنجی
renderErrors(): رندر خطاهای اعتبارسنجی

قوانین اعتبارسنجی:

required: فیلد اجباری
email: آدرس ایمیل معتبر
url: آدرس URL معتبر
numeric: مقدار عددی
min/max: حداقل/حداکثر طول
و بسیاری دیگر...

CommentValidationTrait

Trait برای اعتبارسنجی نظرات که شامل متدهای مشترک برای اعتبارسنجی نظرات است.

متدهای اصلی:

verifyNonce(): بررسی اعتبار nonce
verifyCaptcha(): بررسی اعتبار کپچا
verifyHoneypot(): بررسی فیلد honeypot
applyRateLimiting(): اعمال محدودیت تعداد درخواست

مدیریت HTMX

HTMX_Controller

کلاس پایه برای کنترلرهای HTMX که امکان ایجاد کنترلرهای سفارشی را فراهم می‌کند.

متدهای اصلی:

registerRoutes(): ثبت مسیرهای HTMX
handleRequest(): پردازش درخواست‌های HTMX
render(): رندر قالب‌ها
triggerEvent(): ارسال رویداد به سمت کلاینت

HTMX_Handler

کلاس مدیریت درخواست‌های HTMX با پشتیبانی از middleware.

متدهای اصلی:

registerEndpoint(): ثبت یک نقطه پایانی HTMX
registerMiddleware(): ثبت یک middleware
handleEndpoint(): پردازش درخواست‌های HTMX
registerAssets(): ثبت فایل‌های JavaScript HTMX

مدیریت تنظیمات سراسری (Config)

Config

کلاس مدیریت تنظیمات پروژه و پشتیبانی کامل از تنظیمات چندلایه، wp_options و ACF.

متدهای اصلی:

Config::init($configPath = null);                   // مقداردهی اولیه با مقادیر پیش‌فرض یا فایل سفارشی
Config::get($key, $default = null);                 // دریافت مقدار براساس dot notation
Config::set($key, $value);                          // تنظیم مقدار جدید در مسیر دلخواه
Config::unset($key);                                // حذف مقدار (هر عمق دلخواه)
Config::saveToOption($optionName, $key = null);     // ذخیره کل یا بخشی از config در wp_options
Config::loadFromOption($optionName, $key = null);   // بارگذاری config از wp_options به حافظه
Config::getACFOption($key, $default = null);        // خواندن گزینه‌های Option Page ساخته‌ شده با ACF یا wp_options

پشتیبانی کامل از providerهای متعدد SMS و multiple pattern برای هر provider در ساختار آرایه‌ای
مناسب برای بارگذاری، ذخیره و حذف هر نوع پیکربندی مرتبط با پروژه/افزونه/قالب
ارتباط یکپارچه با تنظیمات ACF option pages و wp_options
ویژه محیط‌های پیشرفته با نیاز به پایداری، امنیت و مقیاس‌پذیری مدیریت config

ابزارهای کاربردی

CaptchaManager

مدیریت کپچا برای فرم‌ها.

متدهای اصلی:

generate_captcha(): تولید کپچا جدید
verify_captcha(): بررسی اعتبار پاسخ کپچا
render_captcha(): رندر HTML کپچا

BlogCommentsController

مدیریت نظرات وبلاگ.

متدهای اصلی:

prepareCommentsData(): آماده‌سازی داده‌های نظرات
submitComment(): ثبت نظر جدید
filterComments(): فیلتر کردن نظرات

BlogRatingController

مدیریت امتیازدهی به مطالب وبلاگ.

متدهای اصلی:

handle_submit_rating(): پردازش ثبت امتیاز
calculateRating(): محاسبه میانگین امتیازات
hasUserRated(): بررسی اینکه آیا کاربر قبلاً امتیاز داده است یا خیر

CartManager

مدیریت سبد خرید ووکامرس.

متدهای اصلی:

handle_add_to_cart_ajax(): پردازش افزودن محصول به سبد خرید با AJAX
handle_add_to_cart_single_ajax(): پردازش افزودن محصول تکی به سبد خرید با AJAX

AlpineNavWalker

کلاس سفارشی برای ایجاد منوهای پیشرفت 6D40 ه با Alpine.js.

متدهای اصلی:

start_el(): شروع یک آیتم منو
end_el(): پایان یک آیتم منو
start_lvl(): شروع یک سطح منو
end_lvl(): پایان یک سطح منو

3. رابط برنامه‌نویسی (API)

سیستم کش

$cache = new CacheManager('transient', 'my_prefix_', 3600);
$cache->set('key', $value, 3600);
$value = $cache->get('key', $default);
$cache->delete('key');
$value = $cache->remember('key', function() {
    return expensive_operation();
}, 3600);

سیستم نمایش

$view = new View();
$html = $view->render('template.twig', ['key' => 'value']);
$view->display('template.twig', ['key' => 'value']);
$view->render_with_exit('template.twig', ['key' => 'value'], 200);

سیستم اعتبارسنجی

$validator = new HTMX_Validator();
$rules = [
    'name' => 'required|min:3',
    'email' => 'required|email',
    'age' => 'numeric|min:18'
];
if ($validator->validate($_POST, $rules)) {
    $validated_data = $validator->getValidatedData();
} else {
    $errors = $validator->getErrors();
}

سیستم تنظیمات (Config)

use jamal13647850\wphelpers\Config;
Config::init();
Config::set('sms.providers.faraz.username', 'abc');
$username = Config::get('sms.providers.faraz.username');
Config::unset('sms.providers.faraz.patterns.login');
Config::saveToOption('myplugin_config');
Config::loadFromOption('myplugin_config');
$email = Config::getACFOption('contact_email', 'default@example.com');

مدیریت HTMX

class MyController extends HTMX_Controller {
    protected function getNamespace(): string { return 'my_controller'; }
    protected function registerRoutes(): void {
        $this->addRoute('load_items', [
            'handler' => 'loadItems',
            'public' => true,
            'cache' => true
        ]);
    }
    public function loadItems() {
        $items = get_posts(['post_type' => 'item', 'posts_per_page' => 10]);
        $this->render('items/list.twig', ['items' => $items]);
    }
}
$controller = new MyController();
$url = $controller->getRouteUrl('load_items');

ابزارهای کاربردی

$captcha = new CaptchaManager();
$captcha_html = $captcha->render_captcha();
$is_valid = $captcha->verify_captcha($_POST['captcha_answer'], $_POST['captcha_nonce'], $_POST['captcha_transient_key']);

$comments_controller = new BlogCommentsController($view, 'comments/form.twig', $post_id, $captcha);
$comments_data = $comments_controller->prepareCommentsData();
$form_html = $comments_controller->render_comment_form();

$cart_manager = new CartManager();
add_action('wp_ajax_add_to_cart_ajax', [$cart_manager, 'handle_add_to_cart_ajax']);
add_action('wp_ajax_nopriv_add_to_cart_ajax', [$cart_manager, 'handle_add_to_cart_ajax']);

4. مثال‌های کاربردی

مثال ۱: مدیریت کش نتایج پرس‌وجو

use jamal13647850\wphelpers\CacheManager;
$cache = new CacheManager('transient', 'query_cache_', 3600);
function get_cached_recent_posts($count = 5, $category = null) {
    global $cache;
    $cache_key = "recent_posts_{$count}_{$category}";
    return $cache->remember($cache_key, function() use ($count, $category) {
        $args = ['posts_per_page' => $count, 'post_status' => 'publish'];
        if ($category) $args['category_name'] = $category;
        $query = new WP_Query($args);
        $posts = [];
        if ($query->have_posts()) {
            while ($query->have_posts()) {
                $query->the_post();
                $posts[] = [
                    'id' => get_the_ID(),
                    'title' => get_the_title(),
                    'excerpt' => get_the_excerpt(),
                    'link' => get_permalink(),
                    'thumbnail' => get_the_post_thumbnail_url(),
                    'date' => get_the_date()
                ];
            }
            wp_reset_postdata();
        }
        return $posts;
    }, 3600);
}
$recent_posts = get_cached_recent_posts(5, 'news');

مثال ۲: فرم نظرات با اعتبارسنجی و کپچا

use jamal13647850\wphelpers\View;
use jamal13647850\wphelpers\CaptchaManager;
use jamal13647850\wphelpers\BlogCommentsController;
$view = new View();
$captcha = new CaptchaManager($view);
$post_id = get_the_ID();
$comments_controller = new BlogCommentsController(
    $view,
    'components/blog/comment-form.twig',
    $post_id,
    $captcha
);
add_action('wp_ajax_submit_blog_comment', [$comments_controller, 'handle_submit_comment']);
add_action('wp_ajax_nopriv_submit_blog_comment', [$comments_controller, 'handle_submit_comment']);
function render_comments_section() {
    global $comments_controller, $view;
    $comments_data = $comments_controller->prepareCommentsData();
    $form_html = $comments_controller->render_comment_form();
    echo $view->render('components/blog/comments-section.twig', [
        'comments' => $comments_data,
        'form' => $form_html,
        'post_id' => get_the_ID()
    ]);
}

مثال ۳: کنترلر HTMX برای بارگذاری محصولات ووکامرس

use jamal13647850\wphelpers\HTMX_Controller;
class ProductsController extends HTMX_Controller {
    protected function getNamespace(): string { return 'products'; }
    protected function registerRoutes(): void {
        $this->addRoute('load_products', [
            'handler' => 'loadProducts',
            'public' => true,
            'cache' => true,
            'cache_time' => 1800
        ]);
        $this->addRoute('filter_products', [
            'handler' => 'filterProducts',
            'public' => true
        ]);
        $this->addRoute('quick_view', [
            'handler' => 'quickView',
            'public' => true
        ]);
    }
    public function loadProducts() {
        $page = $this->getSanitizedParam('page', 1, 'int');
        $per_page = $this->getSanitizedParam('per_page', 12, 'int');
        $args = [
            'post_type' => 'product',
            'posts_per_page' => $per_page,
            'paged' => $page,
            'post_status' => 'publish'
        ];
        $products = wc_get_products($args);
        $this->render('products/list.twig', [
            'products' => $products,
            'page' => $page,
            'per_page' => $per_page
        ]);
    }
    public function filterProducts() {
        $category = $this->getSanitizedParam('category');
        $min_price = $this->getSanitizedParam('min_price', 0, 'int');
        $max_price = $this->getSanitizedParam('max_price', 0, 'int');
        $orderby = $this->getSanitizedParam('orderby', 'date');
        $args = [
            'post_type' => 'product',
            'posts_per_page' => 12,
            'post_status' => 'publish'
        ];
        if ($category) {
            $args['tax_query'][] = [
                'taxonomy' => 'product_cat',
                'field' => 'slug',
                'terms' => $category
            ];
        }
        if ($min_price > 0 || $max_price > 0) {
            $args['meta_query'][] = [
                'key' => '_price',
                'value' => [$min_price, $max_price > 0 ? $max_price : 999999],
                'compare' => 'BETWEEN',
                'type' => 'NUMERIC'
            ];
        }
        switch ($orderby) {
            case 'price-asc':
                $args['orderby'] = 'meta_value_num';
                $args['meta_key'] = '_price';
                $args['order'] = 'ASC';
                break;
            case 'price-desc':
                $args['orderby'] = 'meta_value_num';
                $args['meta_key'] = '_price';
                $args['order'] = 'DESC';
                break;
            case 'popularity':
                $args['orderby'] = 'meta_value_num';
                $args['meta_key'] = 'total_sales';
                $args['order'] = 'DESC';
                break;
            case 'date':
            default:
                $args['orderby'] = 'date';
                $args['order'] = 'DESC';
        }
        $products = wc_get_products($args);
        $this->render('products/filtered-list.twig', [
            'products' => $products,
            'filters' => [
                'category' => $category,
                'min_price' => $min_price,
                'max_price' => $max_price,
                'orderby' => $orderby
            ]
        ]);
    }
    public function quickView() {
        $product_id = $this->getSanitizedParam('product_id', 0, 'int');
        if (!$product_id) {
            $this->sendError('شناسه محصول نامعتبر است.');
            return;
        }
        $product = wc_get_product($product_id);
        if (!$product) {
            $this->sendError('محصول یافت نشد.');
            return;
        }
        $this->render('products/quick-view.twig', [
            'product' => $product
        ]);
    }
}
$products_controller = new ProductsController();

5. وابستگی‌ها و ارتباطات

وابستگی‌های خارجی

وردپرس: نسخه 5.0 یا بالاتر
PHP: نسخه 7.4 یا بالاتر
Twig: برای موتور قالب‌سازی
HTMX: برای تعاملات AJAX مدرن
Alpine.js: برای منوهای پیشرفته و تعاملات سمت کاربر

ارتباطات داخلی

CacheManager از CacheInterface و درایورهای مختلف کش استفاده می‌کند.
View از ViewInterface پیروی می‌کند و برای رندر قالب‌ها استفاده می‌شود.
BlogCommentsController از CommentValidationTrait و CaptchaManager استفاده می‌کند.
HTMX_Controller و HTMX_Handler از View و HTMX_Validator استفاده می‌کنند.
Config برای مدیریت تنظیمات سراسری، ذخیره دائم، حذف و یکپارچه‌سازی با wp_options و ACF استفاده می‌شود.

ساختار فایل‌ها

src/
  Cache/                    # سیستم کش
    CacheInterface.php
    CacheManager.php
    FileCacheDriver.php
    ObjectCacheDriver.php
    TransientCache.php
  AlpineNavWalker.php
  BlogCommentsController.php
  BlogRatingController.php
  CaptchaManager.php
  CartManager.php
  Category.php
  CommentValidationTrait.php
  Config.php
  CPTCategory.php
  Helper.php
  HTMX_Controller.php
  HTMX_Handler.php
  HTMX_Validator.php
  jdf.php
  ProductCompare.php
  ProductReviewsController.php
  QuickViewManager.php
  SMSForgotPasswordController.php
  SMSLoginController.php
  SMSRegisterController.php
  TwigHelper.php
  TwigHelperInterface.php
  UserMigration.php
  UserProfileManager.php
  View.php
  ViewInterface.php
  WishlistManager.php
  WooCommerce.php
  WordPressTwigExtension.php

6. محدودیت‌ها و نکات مهم

محدودیت‌ها

درایور FileCacheDriver: برای محیط توسعه مناسب است و برای محیط تولید توصیه نمی‌شود.
وابستگی به وردپرس: این کتابخانه به طور خاص برای وردپرس طراحی شده و خارج از آن قابل استفاده نیست.
سازگاری با PHP: نیاز به PHP 7.4 یا بالاتر دارد.
عملکرد کش: در صورت استفاده نادرست از سیستم کش، ممکن است عملکرد سایت کاهش یابد.

7. سیستم تنظیمات قالب با ACF (Theme Settings ACF)

معرفی

این کلاس امکان تعریف و نمایش صفحات تنظیمات قالب و زیرمنوهای آن را به آسانی و بر اساس یک فایل config مرکزی برای شما فراهم می‌کند. قابلیت ویژه نسخه جدید:

بارگذاری و مدیریت منعطف و داینامیک فیلدها از طریق فایل config (بدون نیاز به تغییر کد)
تعریف سطح دسترسی برای هر صفحه یا حتی هر فیلد به سادگی در config
سازگار با نصب مستقیم در قالب یا به عنوان پکیج کامپوزری (Composer Package)
سازگاری با وردپرس فارسی (یا انگلیسی) و معماری استاندارد namespace

ساختار و راه‌اندازی

نصب

اگر پروژه شما کامپوزری است:
```
composer require jamal13647850/wphelpers
```
یا افزودن دستی پوشه به پروژه و لود کردن آن از طریق autoload یا require

نمونه راه‌اندازی در قالب:

// در functions.php یا پلاگین وردپرسی
add_action('after_setup_theme', function() {
    $settings = new \jamal13647850\wphelpers\Utilities\Theme_Settings_ACF();
    // اگر می‌خواهید config خارج از قالب باشد:
    $settings->setConfigPath(get_stylesheet_directory().'/my-config/theme_settings_definitions.php');
});

ساختار فایل config

مثال یک گروه (درون config/theme_settings_definitions.php):

return [
    'general' => [
        'menu_slug'   => 'theme-settings-general-settings',
        'menu_order'  => 0,
        'title'       => __('تنظیمات عمومی', 'your-textdomain'),
        'capability'  => 'manage_options', // سطح دسترسی این صفحه
        'fields' => [
            [
                'type' => 'text',
                'label' => 'متن دلخواه',
                'name'  => 'my_option',
                // ...
                'capability' => 'edit_theme_options', // فقط کاربران خاص این فیلد را خواهند دید!
            ],
            // ...
        ]
    ],
    // سایر گروه‌ها
];

سفارشی‌سازی سطح دسترسی برای صفحه/زیرمنو

در هر آرایه گرو‌ه (صفحه تنظیمات) کلید capability را ست کنید:

برای پنل فقط مدیر: 'capability' => 'manage_options'
فقط ادیتور: 'capability'=>'edit_pages'
برای کاربر سفارشی: 'capability'=>'your_custom_capability'

در هر فیلد جدا نیز می‌توانید 'capability' => ... بدهید تا همان فیلد بسته به نقش نمایش داده شود.

حذف فیلد برای نقش کاربر

کافیست همانطور که بالا گفته شد، در هر فیلد capability یا visible_for_roles مشخص کنید. کلاس به صورت خودکار (در prepareFields) این فیلد را برای کاربران فاقد این حق نمایش نخواهد داد.

مثال:

[
    'type' => 'text',
    'label' => 'کد محرمانه',
    'name'  => 'admin_code',
    'capability' => 'manage_options',
],
[
    'type' => 'text',
    'label' => 'فقط برای نویسنده',
    'name'  => 'editor_code',
    'visible_for_roles' => ['editor']
],

انتقال منو به بخش "نمایش › تنظیمات قالب"

اگر می‌خواهید صفحه تنظیمات در منوی "نمایش" وردپرس درج شود:

acf_add_options_page([
    'page_title'  => __('Theme Settings', 'your-textdomain'),
    'menu_title'  => __('Theme Settings', 'your-textdomain'),
    'menu_slug'   => 'theme-settings',
    'capability'  => 'manage_options',
    'parent_slug' => 'themes.php', // اضافه کنید
    'redirect'    => false,
    'icon_url'    => 'dashicons-admin-customizer',
    'position'    => 60,
]);

در کلاس Theme_Settings_ACF همین مقدار را در main یا زیرمنوها استفاده کنید.

دریافت گزینه‌ها در نمای وبسایت

برای دریافت هر گزینه در قالب:

function theme_option($field, $group = 'general') {
    $prefix = [
        // ... همان prefix های داخل کلاس ...
    ];
    $fieldname = ($prefix[$group] ?? '') . $field;
    return function_exists('get_field') ? get_field($fieldname, 'option') : null;
}

چندزبانه و ترجمه

در فایل config همه labelها و instructions باید با تابع __() و دامین مناسب وارد شوند تا WPML/Polylang آماده ترجمه باشد.

وابستگی‌ها

ACF Pro باید فعال باشد (در صورت نبود، پیام خطای مناسب برای مدیر سایت نمایش داده می‌شود).
حداقل وردپرس ۵ و PHP ۷.۴.
config theme_settings_definitions.php وجود داشته باشد.

نکات پیشرفته

می‌توانید در هر فیلد آرگومان‌های threshold دیتاتایپ یا custom property قرار دهید و prepareFields را بسته به نیاز تغییر دهید.
کلاس باز است و با فیلترهای وردپرس (مانند yourtheme_theme_settings_acf_groups) به آسانی قابل توسعه توسط افزونه یا قالب child می‌باشد.

خلاصه

کد مدیریت تنظیمات قالب شما کاملاً داینامیک، OOP و قابل سفارشی‌سازی برای هر سطح دسترسی و هر پروژه است.
افزودن یا حذف هر تنظیم فقط با تغییر config و بدون نیاز به دستکاری کد کلاس.
نمایش تنظیمات قالب در هر بخش از منو (مستقل، زیر نمایش، یا حتی شاخه سفارشی دیگر وردپرس) تنها با تغییر یک کلید parent_slug.
پشتیبانی قوی برای استارتاپ‌های حرفه‌ای و پروژه‌های بزرگ!

برای مثال از فایل config یا override رفتار خاص فقط کافی است یک آرایه جدید بسازید یا با فیلتر سابق، تغییر دهید.

نکات مهم

امنیت: همیشه از توابع اعتبارسنجی و sanitize برای داده‌های ورودی استفاده کنید.
عملکرد: برای بهبود عملکرد، از سیستم کش به درستی استفاده کنید.
سازگاری: قبل از به‌روزرسانی کتابخانه، تغییرات را در محیط توسعه آزمایش کنید.
تنظیمات: برای تنظیم پیکربندی کتابخانه، از کلاس Config استفاده کنید.
دیباگ: در محیط توسعه، تنظیم debug را فعال کنید تا پیام‌های خطا را مشاهده کنید.

بهترین شیوه‌های استفاده

ایجاد کلاس‌های سفارشی: به جای تغییر مستقیم کد کتابخانه، کلاس‌های سفارشی ایجاد کنید که از کلاس‌های کتابخانه ارث‌بری می‌کنند.
استفاده از سیستم کش: برای بهبود عملکرد، از سیستم کش برای ذخیره نتایج عملیات پرهزینه استفاده کنید.
پیکربندی مناسب: تنظیمات کتابخانه را متناسب با نیازهای پروژه خود پیکربندی کنید.
استفاده از اعتبارسنجی: همیشه از سیستم اعتبارسنجی برای بررسی داده‌های ورودی استفاده کنید.
مستندسازی: کد سفارشی خود را به خوبی مستند کنید و از نام‌گذاری معنادار استفاده کنید.
آزمایش: قبل از استفاده در محیط تولید، کد خود را در محیط توسعه آزمایش کنید.
به‌روزرسانی: کتابخانه را به‌روز نگه دارید تا از آخرین ویژگی‌ها و رفع اشکالات بهره‌مند شوید.
استفاده از HTMX: برای ایجاد رابط کاربری پویا، از قابلیت‌های HTMX استفاده کنید.
مدیریت خطا: همیشه خطاها را مدیریت کنید و پیام‌های خطای مناسب به کاربر نمایش دهید.
استفاده از View: برای جداسازی منطق از نمایش، از سیستم View استفاده کنید.

نتیجه‌گیری

کتابخانه WP Helpers یک مجموعه قدرتمند از ابزارها و کلاس‌های کمکی برای توسعه‌دهندگان وردپرس است که می‌تواند فرآیند توسعه را سرعت بخشیده و کیفیت کد را بهبود دهد. با استفاده از این کتابخانه، می‌توانید از نوشتن کد تکراری جلوگیری کرده و از الگوهای طراحی مدرن بهره ببرید.

با درک عمیق از قابلیت‌های این کتابخانه و رعایت بهترین شیوه‌های استفاده، می‌توانید پروژه‌های وردپرسی حرفه‌ای و مقیاس‌پذیر ایجاد کنید که به راحتی قابل نگهداری و توسعه هستند.

Name		Name	Last commit message	Last commit date
Latest commit History 13 Commits
src		src
templates/views/components		templates/views/components
.gitignore		.gitignore
README.md		README.md
composer.json		composer.json
repomix.config.json		repomix.config.json

jamal13647850/wp-helpers-package

Folders and files

Latest commit

History

Repository files navigation

CacheManager

درایورهای کش

سیستم نمایش (View)

ViewInterface

View

سیستم اعتبارسنجی (Validation)

HTMX_Validator

CommentValidationTrait

مدیریت HTMX

HTMX_Controller

HTMX_Handler

مدیریت تنظیمات سراسری (Config)

Config

ابزارهای کاربردی

CaptchaManager

BlogCommentsController

BlogRatingController

CartManager

AlpineNavWalker

3. رابط برنامه‌نویسی (API)

سیستم کش

سیستم نمایش

سیستم اعتبارسنجی

سیستم تنظیمات (Config)

مدیریت HTMX

ابزارهای کاربردی

4. مثال‌های کاربردی

مثال ۱: مدیریت کش نتایج پرس‌وجو

مثال ۲: فرم نظرات با اعتبارسنجی و کپچا

مثال ۳: کنترلر HTMX برای بارگذاری محصولات ووکامرس

5. وابستگی‌ها و ارتباطات

وابستگی‌های خارجی

ارتباطات داخلی

ساختار فایل‌ها

6. محدودیت‌ها و نکات مهم

محدودیت‌ها

7. سیستم تنظیمات قالب با ACF (Theme Settings ACF)

معرفی

ساختار و راه‌اندازی

نصب

نمونه راه‌اندازی در قالب:

ساختار فایل config

سفارشی‌سازی سطح دسترسی برای صفحه/زیرمنو

حذف فیلد برای نقش کاربر

انتقال منو به بخش "نمایش › تنظیمات قالب"

دریافت گزینه‌ها در نمای وبسایت

چندزبانه و ترجمه

وابستگی‌ها

نکات پیشرفته

خلاصه

نکات مهم

بهترین شیوه‌های استفاده

نتیجه‌گیری

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Packages