مبدل برای رسانه – بهینه سازی تصاویر | تبدیل WebP & AVIF

سوالات متداول

How can I report security bugs?

You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team help validate, triage and handle any security vulnerabilities.

Report a security vulnerability.

چگونه پشتیبانی فنی دریافت کنیم؟ (قبل از اینکه کمک بخواهید)

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

هنگام اضافه کردن یک موضوع، این مراحل را دنبال کنید و به هر یک از آنها پاسخ دهید:

1. آیا در صفحه تنظیمات افزونه خطایی دارید؟ لطفا در صورت داشتن هر گونه خطایی این تاپیک را بخوانید.

2. آدرس سایت شما.

3. اسکرین شات از برگه Help Center در صفحه تنظیمات افزونه – لطفاً از کل صفحه عکس بگیرید.

4. لطفاً آزمایشی را انجام دهید که در سؤالات متداول در سؤال “چگونه بررسی کنیم که افزونه کار می کند؟” توضیح داده شده است. لطفاً یک اسکرین شات از Devtools به همراه نتایج آزمایش ارسال کنید.

لطفاً به یاد داشته باشید که پاسخ همه سؤالات را با اضافه کردن یک موضوع درج کنید. بسیار ساده تر است و حل مشکل شما را تسریع می کند.

پیکربندی برای Nginx

اگر از سرور Nginx استفاده می کنید که از قوانین htaccess. پشتیبانی نمی کند، پیکربندی سرور Nginx اضافی برای کارکرد صحیح افزونه مورد نیاز است.

لطفا برای اطلاعات بیشتر این آموزش را بخوانید.

پیکربندی برای Nginx Proxy

اگر از سرور Nginx استفاده می‌کنید که از قوانین htaccess. پشتیبانی می‌کند، اما همچنان در صفحه تنظیمات افزونه خطای پیکربندی سرور دارید، پیکربندی سرور Nginx اضافی برای کارکرد صحیح افزونه مورد نیاز است.

لطفا برای اطلاعات بیشتر این آموزش را بخوانید.

خطا در صفحه تنظیمات افزونه؟

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

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

خطا در هنگام تبدیل؟

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

اگر با خطا مواجه شدید: File "%s" does not exist. Please check file path. به این معنی است که تابع file_exists() در PHP با استفاده از مسیر فایل داده شده در پیام خطا false برگرداند. این مسیر را بررسی کنید و مطمئن شوید که درست است.

اگر با خطا مواجه شدید: File "%s" is unreadable. Please check file permissions. به این معنی است که تابع is_readable() در PHP با استفاده از مسیر فایل ارائه شده در پیام خطا false برگرداند. مجوزهای فایل و دایرکتوری که فایل در آن قرار دارد را بررسی کنید.

اگر با خطا مواجه شدید: "%s" is not a valid image file. یعنی فایل به نوعی آسیب دیده است. فایل را روی دیسک دانلود کنید، با استفاده از هر برنامه گرافیکی دوباره آن را ذخیره کنید و دوباره به صفحه اضافه کنید. اگر خطا برای تصاویر جداگانه اعمال شود، می توانید آن را نادیده بگیرید – فقط تصاویر اصلی بارگیری می شوند، نه WebP.

اگر خطایی دریافت کردید: Image "%s" converted to .webp is larger than original and converted .webp file has been deleted. یعنی وزن تصویر اصلی کمتر از WebP است. این زمانی اتفاق می افتد که تصاویر قبلاً فشرده شده باشند. گزینه «حذف خودکار فایل‌ها با فرمت‌های خروجی بزرگتر از اصلی» را در تنظیمات افزونه غیرفعال کنید تا همیشه از WebP استفاده کنید.

پیش نیازهای افزونه چیا هست؟

عملا هر میزبانی این الزامات را برآورده می کند. شما باید حداقل از PHP 7.0 استفاده کنید و پسوند GD یا Imagick را نصب کنید. برنامه افزودنی باید WebP format پشتیبانی کند. اگر خطایی دارید که می‌گوید کتابخانه GD یا Imagick نصب نشده است، اما آن را نصب کرده‌اید، احتمالاً پیکربندی اشتباهی داشته‌اند و از WebP پشتیبانی نمی‌کنند.

آنها به پسوندهای بومی PHP نیاز دارند که در میان سایر موارد توسط وردپرس برای تولید تصاویر کوچک استفاده می شود. سرور شما باید ماژول‌های mod_mime ، mod_rewrite و mod_expires را نیز فعال داشته باشد.

نمونه ای از پیکربندی صحیح سرور را می توانید در اینجا بیابید. پیوند به پیکربندی فعلی شما را می‌توانید در برگه Help Center در صفحه تنظیمات افزونه پیدا کنید.

به مواردی که با رنگ قرمز مشخص شده اند توجه کنید. اگر مقادیر مشخص شده با رنگ قرمز در مورد شما ظاهر نمی شود، به این معنی است که سرور شما شرایط فنی را برآورده نمی کند. به مقدار پشتیبانی WebP برای کتابخانه GD و WEBP در لیست افزونه های پشتیبانی شده برای کتابخانه Imagick توجه کنید.

در شرایطی که سرور شما الزامات فنی را برآورده نمی کند، لطفاً با مدیر سرور خود تماس بگیرید. ما قادر به کمک به شما نیستیم. لطفا در مورد این موضوع با ما تماس نگیرید، زیرا این یک مشکل پیکربندی سرور است، نه یک افزونه.

همچنین REST API باید فعال باشد و بدون محدودیت اضافی کار کند. اگر مشکلی با آن دارید، لطفاً با توسعه دهنده ای که وب سایت شما را ایجاد کرده است تماس بگیرید. او باید به راحتی مشکل کار نکردن REST API را پیدا کند.

چگونه بررسی کنیم افزونه کار میکنه؟

می توانید اطلاعات بیشتری در مورد نحوه کار این افزونه در کتابچه راهنمای ما بیابید.

چگونه محل آپلودها رو تغییر بدیم؟

این کار با استفاده از انواع فیلترهای زیر برای تغییر مسیرهای پیش فرض امکان پذیر است. این یک راه حل برای کاربران پیشرفته است. اگر نیستید، لطفا از این سوال صرف نظر کنید.

مسیر دایرکتوری نصب ریشه وردپرس (به طور پیش فرض ABSPATH ) :

add_filter( 'webpc_site_root', function( $path ) {
    return ABSPATH;
} );

مسیرهای دایرکتوری ها (نسبت به دایرکتوری ریشه) :

add_filter( 'webpc_dir_name', function( $path, $directory ) {
    switch ( $directory ) {
        case 'uploads':
            return 'wp-content/uploads';
        case 'webp':
            return 'wp-content/uploads-webpc';
        case 'plugins':
            return 'wp-content/plugins';
        case 'themes':
            return 'wp-content/themes';
    }
    return $path;
}, 10, 2 );

توجه داشته باشید که دایرکتوری /uploads-webpc باید در همان سطح تودرتو با دایرکتوری های /uploads ، /plugins و /themes باشد.

پیشوند در URL دایرکتوری /wp-content/ یا معادل آن (استفاده شده در htaccess.) :

add_filter( 'webpc_htaccess_rewrite_path', function( $prefix ) {
    return '/';
} );

برای نمونه ساختار سفارشی وردپرس زیر:

...
├── web
    ...
    ├── app
    │   ├── mu-plugins
    │   ├── plugins
    │   ├── themes
    │   └── uploads
    ├── wp-config.php
    ...

از فیلترهای زیر استفاده کنید:

add_filter( 'webpc_site_root', function( $path ) {
    return 'C:/WAMP/www/project/web'; // your valid path to root
} );
add_filter( 'webpc_htaccess_rewrite_path', function( $prefix ) {
    return '/';
} );
add_filter( 'webpc_dir_name', function( $path, $directory ) {
    switch ( $directory ) {
        case 'uploads':
            return 'app/uploads';
        case 'webp':
            return 'app/uploads-webpc';
        case 'plugins':
            return 'app/plugins';
        case 'themes':
            return 'app/themes';
    }
    return $path;
}, 10, 2 );

پس از تنظیم فیلترها در پنل مدیریت به Settings -> Converter for Media بروید و دکمه Save Changes را کلیک کنید. فایل های .htaccess با قوانین مناسب باید در دایرکتوری های /uploads و /uploads-webpc ایجاد شوند.

چگونه محلی رو از تبدیل کردن خارج کنیم؟

To exclude selected directories, provide them in the Excluded directories field in the Advanced Settings tab in the plugin settings.

In this field, you can enter a directory name or path. Here are examples:
– 2023
– 2024/01
– 2023,2024/01

To exclude selected files, use the following filter (in this case with the suffix “-skipped” in a filename, e.g. image-skipped.png):

add_filter( 'webpc_supported_source_file', function( bool $status, string $file_name, string $server_path ): bool {
    $excluded_suffix = '-skipped';
    if ( strpos( $file_name, $excluded_suffix . '.' ) !== false ) {
        return false;
    }
    return $status;
}, 10, 3 );

Argument $server_path مسیر سرور مطلق به یک فهرست یا فایل است. در داخل فیلترها، در صورت نیاز می توانید قوانین پیچیده تری را اعمال کنید.

Changes to excluded directories and files take effect before images are converted – they do not affect already converted images. These images must be manually removed from the directory: /wp-content/uploads-webpc/.

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

این افزونه به طور پیش فرض از دایرکتوری های زیر پشتیبانی می کند: – /gallery – /plugins – /themes – /uploads

اگر می‌خواهید برای یک فهرست سفارشی پشتیبانی اضافه کنید، کد زیر را به فایل functions.php در فهرست تم خود اضافه کنید (به جای custom-directory از یک نام دایرکتوری درست استفاده کنید) :

add_filter( 'webpc_source_directories', function ( $directories ) {
    $directories[] = 'custom-directory';
    return $directories;
} );

به یاد داشته باشید که این دایرکتوری باید در پوشه /wp-content واقع شود.

چگونه بصورت دستی تبدیل را احرا کنیم؟

به طور پیش فرض، با کلیک بر روی دکمه Start Bulk Optimization ، همه تصاویر تبدیل می شوند. علاوه بر این، هنگامی که فایل‌های جدیدی را به کتابخانه رسانه خود اضافه می‌کنید، تبدیل به صورت خودکار انجام می‌شود.

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

اگر می خواهید با افزونه خود که توسط خودتان تصاویر تولید می کند یکپارچه شوید، می توانید این کار را انجام دهید. افزونه ما امکان این نوع ادغام را فراهم می کند. این برای همه تصاویر موجود در فهرست /wp-content کار می کند.

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

شما می توانید به صورت دستی تبدیل فایل های انتخاب شده را اجرا کنید، می توانید از عملی استفاده کنید که یک آرایه را با لیستی از مسیرها به آن ارسال می کنید (آنها باید مسیرهای سرور مطلق باشند) :

do_action( 'webpc_convert_paths', $paths, true );

یک روش جایگزین این است که به صورت دستی تبدیل پیوست انتخابی را با ارسال شناسه پست از کتابخانه رسانه شروع کنید. به یاد داشته باشید که این عمل را پس از ثبت تمام اندازه های تصویر (یعنی پس از اجرای تابع add_image_size ) اجرا کنید:

do_action( 'webpc_convert_attachment', $post_id, true );

برای حذف فایل های تبدیل شده به صورت دستی، از عمل زیر استفاده کنید و به عنوان آرگومان آرایه ای از مسیرهای سرور مطلق به فایل ها ارائه دهید (با این کار فایل های تبدیل شده به صورت دستی حذف می شوند) :

do_action( 'webpc_delete_paths', $paths );

پشتیبانی از WP-CLI

این افزونه از WP-CLI پشتیبانی می کند که تبدیل تصویر سریعتر را از سطح سرور امکان پذیر می کند. اطلاعات بیشتر در مورد نحوه شروع کار با WP-CLI را می توانید در کتابچه راهنمای کاربر بیابید. دستورات پشتیبانی شده در زیر توضیح داده شده است.

بررسی حداکثر تعداد تصاویر برای تبدیل در وب سایت:

wp converter-for-media calculate

تبدیل تمامی تصاویر:

wp converter-for-media regenerate

تبدیل همه تصاویر (با گزینه “تبدیل اجباری مجدد همه تصاویر”):

wp converter-for-media regenerate --force

افزونه از CDN پشتیبانی میکند؟

فایل های وب سایت (فایل های وردپرس) و تصاویر کتابخانه رسانه باید روی یک سرور باشند. اگر آنها هستند، همه چیز باید خوب کار کند.

اگر فقط تصاویر شما روی سرور CDN دیگری باشد، متاسفانه عملیات صحیح غیرممکن است، زیرا چنین تصاویری توسط سرور دیگری مدیریت می شوند.

لیست فعلی سرورهای CDN پشتیبانی شده: – BunnyCDN (قبل از استفاده به دستورالعمل ها مراجعه کنید)