برای انتخاب کلیدenter انتخاب کنید یا برای لغو ESC فشار دهید.

راهنمای کامل تولید تصویر شاخص با GD در Ziba AI 2.3.0

آشنایی با کتابخانه GD و مزایای آن در Ziba AI 2.3.0

کتابخانه GD یک ابزار قدرتمند در PHP برای پردازش تصاویر است که در طول سال‌ها به‌عنوان استانداردی برای تولید و ویرایش تصاویر در وب‌سایت‌های وردپرس تبدیل شده است. در نسخهٔ ۲.۳.۰ از افزونه Ziba AI Content Creator، GD به‌صورت پیش‌فرض در دسترس است و امکان تولید تصویر شاخص با کیفیت بالا و بهینه‌سازی حجم را فراهم می‌کند. یکی از مزایای اصلی GD نسبت به کتابخانه‌های دیگر این است که قابلیت تبدیل مستقیم به فرمت‌های WebP و AVIF را دارد؛ این دو فرمت، نسبت به JPEG یا PNG، حجم کمتری دارند و در زمان بارگذاری صفحات سرعت بالاتری ارائه می‌دهند.

از طریق افزونه، کاربر می‌تواند پارامترهای مختلفی را مانند اندازهٔ تصویر، کیفیت، پس‌زمینه و متن بر روی تصویر تنظیم کند. GD با استفاده از مقادیر پارامترهای imagecreatetruecolor() و imagecopyresampled()

همچنین، GD در Ziba AI امکان ادغام با سیستم‌های کش و CDN را فراهم می‌کند؛ با ذخیرهٔ تصاویر در یک دایرکتوری خاص و سپس پیکربندی وردپرس برای سرویس‌کردن تصاویر از طریق CDN، می‌توان زمان پاسخ سرور را به‌طور چشمگیری کاهش داد. این نکته در صورت استفاده از بهینه‌سازی سرعت بارگذاری صفحات با AI بسیار مفید است.

ساختار فایل‌های پروژه برای تولید تصویر شاخص با GD

مجلدهای اصلی و فایل‌های مورد نیاز

برای شروع کار با تصویر شاخص در Ziba AI، باید مطمئن شوید که ساختار فایل‌های وردپرس شما به‌درستی تنظیم شده است. در زیر یک نمای کلی از فایل‌های کلیدی آورده شده است:

فایل نقش
functions.php تعریف توابع سفارشی برای تولید تصویر
class-ziba-ai-gd.php کلاس اصلی GD در افزونه
templates/single-product.php نمایش تصویر شاخص در برگه محصول
.htaccess تنظیمات دسترسی برای تصاویر کش شده

در فایل functions.php

add_action('save_post', 'ziba_ai_generate_thumbnail', 10, 3);
function ziba_ai_generate_thumbnail($post_ID, $post, $update) {
    // کد تولید تصویر با GD
}

این تابع به‌طور خودکار پس از ذخیرهٔ هر برگه یا محصول فراخوانی می‌شود و تصویر شاخص را تولید می‌کند. برای مطالعهٔ جزئیات بیشتر دربارهٔ ایجاد تصویر شاخص با GD در Ziba AI، می‌توانید به صفحه دانلود افزونه مراجعه کنید.

راهنمای کدنویسی برای ایجاد تصویر شاخص با GD

گام‌های اصلی در تولید تصویر با GD

در این بخش، یک راهنمای گام‌به‌گام برای استفاده از GD در Ziba AI آورده شده است. ابتدا کتابخانه GD باید در PHP فعال باشد؛ در اکثر سرورهای مشترک، این کتابخانه پیش‌فرض نصب شده است. سپس می‌توانید از کد زیر برای تولید تصویر استفاده کنید:

function ziba_ai_create_thumbnail($post_id) {
    $img_path = wp_upload_dir()['basedir'] . "/ziba-ai-thumbnails/{$post_id}.png";
    $width = 1200;
    $height = 630;

    // ایجاد تصویر خالی
    $im = imagecreatetruecolor($width, $height);

    // تعیین رنگ پس‌زمینه (سفید)
    $bg = imagecolorallocate($im, 255, 255, 255);
    imagefill($im, 0, 0, $bg);

    // افزودن متن عنوان
    $title = get_the_title($post_id);
    $text_color

تنظیمات پیشرفتهٔ کیفیت تصویر شاخص با GD در Ziba AI 2.3.0
برای دستیابی به تصاویر شاخص با کیفیت بالا، لازم است پارامترهای کد GD را به دقت تنظیم کنید. در Ziba AI، این تنظیمات در بخش Ziba AI → Settings قابل دسترسی است. اولین گام، انتخاب فرمت خروجی است؛ image/jpeg برای تصاویر با حجم کمتر و image/png برای تصاویر شفاف. پس از انتخاب فرمت، می‌توانید کیفیت را در بازهٔ ۰ تا ۱۰۰ تنظیم کنید؛ مقدار ۸۰ معمولاً تعادلی بین کیفیت و حجم فایل فراهم می‌کند. برای تصاویر با رنگ‌های زیاد، استفاده از imagepng با پارامتر compression ۶ تا ۹ پیشنهاد می‌شود. در نهایت، اطمینان حاصل کنید که سرویس Ziba AI Content Creator به درستی در فایل wp-config.php پیکربندی شده باشد تا کتابخانه GD فعال باشد.نکات عملی برای بهینه‌سازی سرعت بارگذاری تصاویر
یک روش ساده برای کاهش زمان بارگذاری، استفاده از تبدیل تصاویر به WebP است. اگر سرور شما این فرمت را پشتیبانی می‌کند، می‌توانید در تابع تولید تصویر، پس از ایجاد تصویر JPEG یا PNG، آن را به WebP تبدیل کنید؛ این کار حجم فایل را تا ۴۰٪ کاهش می‌دهد. همچنین، اضافه کردن cache-control: max-age=31536000 در هدرهای HTTP باعث می‌شود مرورگرها تصاویر را برای یک سال ذخیره کنند و بارگذاری مجدد را کاهش دهند.معایب احتمالی استفاده از GD بر سرالگرهای بزرگ
“اگر حجم تصویر بیش از ۵ مگابایت باشد، حافظه مصرفی سرور ممکن است به سرعت پر شود؛ برای این موارد پیشنهاد می‌شود از کتابخانه Imagick استفاده کنید.” – متخصصین سئو وب‌سایت‌های وردپرس
در نهایت، مطمئن شوید که نسخه PHP سرور حداقل ۷.۴ باشد؛ زیرا GD در نسخه‌های قدیمی‌تر ممکن است به درستی کار نکند. برای دانلود و نصب Ziba AI 2.3.0 می‌توانید به این لینک مراجعه کنید تا آخرین به‌روزرسانی‌ها را دریافت نمایید.بررسی مقایسه‌ای: GD در مقابل Imagick برای تولید تصویر شاخص در Ziba AI



ویژگی
GD (Ziba AI 2.3.0)
Imagick (پیشنهاد)




سرعت پردازش
متوسط – مناسب برای تصاویر کوچک تا متوسط
سریع‌تر برای تصاویر بزرگ و پیچیده


حافظه مصرفی
کمتر – مناسب برای سرورهای محدود
بیشتر – نیاز به حافظه کافی


پشتیبانی از فرمت‌های جدید
WebP محدود
پشتیبانی کامل از WebP، JPEG2000 و غیره


سازگاری PHP
PHP 7.4+
PHP 7.4+ با افزونه imagick نصب شده



برای انتخاب مناسب‌ترین ابزار، ابتدا حجم تصاویر موردنظر و منابع سرور را ارزیابی کنید. اگر تصاویر با کیفیت بالا و حجم بالایی تولید می‌کنید، Imagick گزینه بهتری است؛ اما اگر سرور شما در محدوده حافظه محدود است، GD همچنان انتخابی مناسب و مطمئن است.
نصب Imagick: sudo apt-get install php-imagick
فعال‌سازی در php.ini: extension=imagick.so
بازنشانی سرور وب (Apache/Nginx)
تست عملکرد با تولید چند تصویر نمونه در Ziba AI


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

بهینه‌سازی کش و حجم تصاویر شاخص تولید‌شده با GD در Ziba AI 2.3.0
یکی از چالش‌های اصلی در تولید تصاویر شاخص با GD، حجم فایل و زمان بارگذاری است. برای این منظور، Ziba AI 2.3.0 امکان فعال‌سازی کش محلی در حافظهٔ وردپرس را فراهم کرده است، که باعث کاهش بار سرور و سرعت لود صفحات می‌شود. در ادامه یک راهنمای عملی برای بهره‌برداری حداکثری از این قابلیت آورده شده است.تنظیم کش در فایل functions.php
کد زیر را در فایل functions.php قالب خود قرار دهید تا تصاویر تولید‌شده توسط GD در کش وردپرس ذخیره شوند:
فایل functions.php را باز کنید.
کد زیر را در آخر آن اضافه کنید: add_filter( 'ziba_ai_gd_cache', '__return_true' );
سرویس کش (Redis یا Memcached) را در تنظیمات وردپرس فعال کنید.

پس از اعمال این تغییر، هر تصویر شاخص جدیدی که توسط GD ساخته می‌شود، در کش ذخیره می‌شود و در درخواست‌های بعدی به سرعت بارگذاری می‌شود.
کاهش حجم تصویر با کیفیت مناسب
استفاده از پارامتر quality در تابع GD باعث کنترل مستقیم بر فشرده‌سازی JPEG می‌شود. برای مثال:$gd->save( $path, ['quality' => 70] );

کیفیت ۷۰٪ معمولاً تعادلی مناسب بین کیفیت بصری و حجم فایل ارائه می‌دهد. برای مقایسه، جدول زیر را مشاهده کنید.

کیفیت کیفیت بصری حجم تقریبی (KB)
90 عالی ۴۸۰
۷۰ خوب ۳۲۰
۵۰ مقبول ۲۰۰

«توجه: استفاده از کیفیت پایین‌تر می‌تواند باعث کاهش کیفیت در دستگاه‌های با رزولوشن بالا شود؛ لذا پیش از اجرا، تصاویر را در محیط‌های مختلف تست کنید.»

این روش باعث می‌شود تصاویر شاخص در زمان‌های اوج ترافیک به سرعت بارگذاری شوند و تجربه کاربری بهبود یابد. برای دانلود کامل افزونه و دسترسی به مستندات بیشتر، می‌توانید به صفحه دانلود Ziba AI مراجعه کنید.

عیب‌یابی و رفع خطاهای رایج در استفاده از GD در Ziba AI 2.3.0

خطاهای مربوط به GD معمولاً به دلیل عدم فعال‌سازی کتابخانه یا محدودیت‌های PHP رخ می‌دهند. در این بخش، راهکارهای عملی برای تشخیص و رفع این خطاها ارائه می‌شود.

خطای “GD extension not loaded”

این خطا زمانی رخ می‌دهد که PHP کتابخانه GD را بارگذاری نکرده باشد. برای رفع آن:

  1. در php.ini، خط extension=gd
  2. سرویس وب را ریستارت کنید.
  3. در داشبورد وردپرس، به بخش Ziba AI → Settings رفته و گزینهٔ Use GD for thumbnails را فعال کنید.

پس از اعمال این تغییرات، افزونه باید بدون خطا اجرا شود.

خطای “Image dimensions exceed maximum allowed”

به‌طور پیش‌فرض، وردپرس محدودیت ۵۱۲۰×۵۱۲۰ پیکسل را برای تصاویر اعمال می‌کند. برای افزایش این محدودیت در Ziba AI:

«در فایل wp-config.php خط زیر را اضافه کنید: define( 'WP_MAX_IMAGE_SIZE', 10240 ); تا حداکثر عرض تصویر را دو برابر کنید.»

استفاده از لاگ‌های خطا

برای تشخیص دقیق‌تر، فایل لاگ PHP را بررسی کنید. خطاهای مرتبط با GD معمولاً در بخش error_log

[Thu Nov 15 12:34:56 2026] PHP Fatal error:  Uncaught Exception: GD library is not available in /wp-content/plugins/ziba-ai-content-creator/includes/class-gd.php:45

با مشاهده این پیام، می‌توانید به راحتی مشکل را تشخیص دهید و رفع کنید. در صورت نیاز به پشتیبانی بیشتر، می‌توانید از صفحه ابرنِسخهٔ افزونه برای گزارش خطا استفاده کنید.

با رعایت این نکات، تولید تصاویر شاخص با GD در Ziba AI 2.3.0 بدون مشکل و با کیفیت بالا انجام خواهد شد.