وردپرس (WordPress) Filter Hook پلتفرم: wordpress مبتدی (Easy) سطح ریسک: پایین و بی‌خطر (Low Risk)

غیرفعال کردن تغییر مقیاس خودکار تصاویر بزرگ در وردپرس (Disable Big Image Scaling)

تست‌شده و بازبینی‌شده در 1405/06/29 ۳۴۴ بار کپی ۲۰۷۸ مشاهده
پاسخ سریع و خلاصه کاربردی (Quick Answer)

با بازگرداندن `__return_false` به فیلتر `big_image_size_threshold`، تغییر سایز خودکار تصاویر بزرگ را کاملاً خاموش کنید.

مشخصات فنی و شناسنامه کد (Code Information)

بازبینی: 1405/06/29
پلتفرم اجرایی (Platform) wordpress
نوع کد (Code Type) Filter Hook
محل قرارگیری فایل (Location) functions.php
سطح دشواری (Difficulty) مبتدی (Easy)
سطح ریسک (Risk Level) پایین و بی‌خطر (Low Risk)
نیاز به بکاپ اولیه؟ خیر (کم‌ریسک)
سازگاری با وردپرس وردپرس ۵.۳ به بالا
سازگاری با ووکامرس و HPOS سازگار
|
<?php
/**
 * غیرفعال‌سازی تغییر مقیاس خودکار تصاویر با ابعاد بیش از ۲۵۶۰ پیکسل در وردپرس
 */
add_filter( 'big_image_size_threshold', '__return_false' );

کد را کجا قرار دهیم؟ (Placement Guide)

کد را در functions.php پوسته یا فایل mu-plugin قرار دهید.

مسیر فایل: functions.php

این کد چگونه کار می‌کند؟ (How it Works)

وردپرس با دریافت مقدار false شرط بررسی ابعاد بیش از ۲۵۶۰ پیکسل را رد کرده و فایل اصلی را بدون دستکاری ذخیره می‌کند.

چه زمانی از این کد استفاده کنیم؟ (Use Cases)

در وب‌سایت‌های عکاسی، نمونه‌کار معماری، چاپ و بسته‌بندی یا دانلود والپیپر که حفظ پیکسل به پیکسل فایل اورجینال اهمیت دارد.

چه زمانی نباید از این کد استفاده کنیم؟ (Anti-patterns)

در سایت‌های عمومی که نویسندگان ممکن است عکس‌های ۱۰ مگابایتی دوربین را مستقیماً آپلود کرده و سرعت لود را تخریب کنند.

پیش‌نیازهای اجرا

وردپرس ۵.۳ به بالا.

نحوه تست و اطمینان از عملکرد

یک تصویر با عرض مثلاً ۳۰۰۰ پیکسل آپلود کنید؛ نام فایل نباید دارای عبارت `-scaled.jpg` باشد و ابعاد آن دقیقاً ۳۰۰۰ پیکسل بماند.

نحوه بازگردانی سریع (Rollback)

کد را حذف کنید تا آستانه پیش‌فرض ۲۵۶۰ پیکسل بازگردد.

خطاهای رایج و راه‌حل رفع

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

ملاحظات و نکات امنیتی

فاقد ریسک امنیتی.

تاثیر بر سرعت و پرفورمنس

اگر عکس در سایز اصلی به کاربر لود شود باعث کاهش سرعت می‌شود؛ بنابراین در فرانت از سایزهای مناسب استفاده کنید.

پرسش‌های متداول پیرامون این کد (FAQ)

بله، به جای return_false می‌توانید عددی مثل 4000 را به فیلتر برگردانید تا آستانه به ۴۰۰۰ پیکسل افزایش یابد.
منابع و مستندات رسمی بررسی‌شده (Official Sources):

سبد خرید شما

0 افزونه

سبد خرید شما خالی است

هنوز محصولی را به سبد خرید اضافه نکرده‌اید. می‌توانید از افزونه‌های اختصاصی ما دیدن فرمایید.

مشاهده فروشگاه افزونه‌ها

ثبت درخواست مشاوره

با تکمیل فرم زیر، کارشناسان فنی بیسکو وب در سریع‌ترین زمان ممکن با شما تماس می‌گیرند.

مشاور
پشتیبانی و مشاوره تخصصی
پاسخگویی سریع کارشناسان
09903336117