تابع is_404 چطور کار می‌کند؟
تابع is_404 برای تشخیص صفحه خطای ۴۰۴ در وردپرس؛ بررسی پارامترها، نکات کلیدی، طراحی صفحه سفارشی و اشتباهات رایج.
5 دقیقه مطالعه
چرا تشخیص صفحه ۴۰۴ اهمیت دارد؟
صفحه خطای ۴۰۴ (Not Found) یکی از پرتکرارترین صفحاتی است که کاربران با آن مواجه می‌شوند. این صفحه ممکن است به دلایل مختلف ظاهر شود: تغییر ساختار URL، حذف محتوا، لینک اشتباه، خرابی سایت مبدأ یا حتی اشتباه تایپی کاربر. اگر صفحه ۴۰۴ به‌درستی طراحی نشود، کاربر به‌سرعت سایت را ترک می‌کند و این ترک می‌تواند به کاهش نرخ تبدیل و افت سئو منجر شود. تابعis_404() دقیقاً همین تشخیص را ممکن می‌کند و به توسعه‌دهنده اجازه می‌دهد تجربه‌ای هوشمند و مفید برای کاربر خطادیده بسازد.
تابع is_404 چیست؟
تابعis_404() یک تابع شرطی در هسته وردپرس است که در فایل wp-includes/query.php تعریف شده است. این تابع بررسی می‌کند که آیا صفحه فعلی یک صفحه خطای ۴۰۴ است یا نه.
خروجی این تابع یک مقدار بولی است: true اگر صفحه فعلی صفحه ۴۰۴ باشد و false در غیر این صورت. این تابع هیچ پارامتر ورودی نمی‌گیرد.
نکته مهم این است که این تابع تنها برای حلقه اصلی (Main Query) معتبر است. اگر از WP_Query سفارشی استفاده کنید، is_404() مقدار نادرست برمی‌گرداند.
امضای تابع و پارامترها
امضای این تابع به‌شکل زیر است:function is_404() {
global $wp_query;
return $wp_query->is_404();
}سازوکار داخلی تابع
تابعis_404() در واقع یک میان‌بر (Wrapper) برای متد is_404() روی شیء جهانی $wp_query است. این متد در کلاس WP_Query تعریف شده و بررسی می‌کند که آیا در فرآیند تجزیه URL، هیچ محتوایی با آدرس درخواستی مطابقت نداشته است یا نه.
وقتی کاربر یک آدرس را وارد می‌کند، وردپرس با استفاده از سیستم Rewrite و کوئری، تلاش می‌کند محتوای متناظر را پیدا کند. اگر هیچ محتوایی پیدا نشود، متغیر is_404 در WP_Query مقدار true می‌گیرد.
نکته مهم دیگر این است که وردپرس برای صفحه ۴۰۴، فایل 404.php را در اولویت اول قرار می‌دهد. اگر این فایل وجود نداشته باشد، از index.php استفاده می‌کند. برای مطالعه درباره سلسله‌مراتب قالب، می‌توانید به راهنمای get_template_part مراجعه کنید.
تفاوت is_404 با سایر توابع شرطی
تابعis_404() تنها صفحه خطای ۴۰۴ را هدف می‌گیرد. در مقابل، is_search() صفحه جستجو را هدف می‌گیرد و is_archive() هر نوع آرشیو را شامل می‌شود.
برای مطالعه بیشتر روی این توابع، می‌توانید به راهنمای is_search، راهنمای is_archive و راهنمای is_front_page مراجعه کنید.
کاربردهای عملی در قالب
یکی از رایج‌ترین کاربردهای این تابع، تنظیم کد پاسخ HTTP مناسب و حذف کلاس‌های اضافی از بدنه است:add_filter( 'body_class', 'myplugin_body_classes' );
function myplugin_body_classes( $classes ) {
if ( is_404() ) {
$classes[] = 'error-404-page';
}
return $classes;
}body_class در راهنمای body_class به تفصیل بررسی شده است.
کاربرد دیگر، نمایش لینک‌های پیشنهادی در صفحه ۴۰۴ است. می‌توانید از این تابع برای پیشنهاد مقالات مشابه یا محصولات مرتبط استفاده کنید. این کار به کاهش نرخ پرش کمک می‌کند و تجربه کاربر را بهبود می‌بخشد.
طراحی صفحه ۴۰۴ سفارشی
طراحی یک صفحه ۴۰۴ حرفه‌ای، شامل چند مرحله است. ابتدا باید فایل404.php در قالب یا Child Theme ساخته شود. این فایل باید ساختار اصلی قالب را داشته باشد و در کنار آن، پیام خطا و لینک‌های پیشنهادی را نمایش دهد.
نمونه ساختار پایه:
get_header();
?>
esc_url() برای پاک‌سازی URL و از home_url() برای دریافت آدرس اصلی سایت استفاده شده است. این دو تابع در پروژه‌های حرفه‌ای باید به‌درستی به کار بروند.
نکته مهم درباره کد پاسخ HTTP: وردپرس به‌صورت خودکار کد ۴۰۴ را در هدر پاسخ قرار می‌دهد، بنابراین لازم نیست به‌صورت دستی این کار را انجام دهید. با این حال، اگر بخواهید مطمئن شوید، می‌توانید از تابع status_header() استفاده کنید.
نکات امنیتی و اشتباهات رایج
اشتباه اول، نبود فایل404.php در قالب است. اگر این فایل وجود نداشته باشد، وردپرس از index.php استفاده می‌کند که معمولاً طراحی مناسبی برای صفحه خطا ندارد.
اشتباه دوم، نبود شرط مناسب است. اگر بخواهید در قالب شرطی برای ۴۰۴ بگذارید، باید همیشه is_404() را در ابتدای شرط قرار دهید.
اشتباه سوم، چاپ مستقیم URL درخواست‌شده بدون escape است. مهاجم می‌تواند با وارد کردن URL مخرب، کاربر را به صفحه فیشینگ هدایت کند.
اشتباه چهارم، نبود تست است. باید آدرس‌های نامعتبر مختلف را تست کنید تا مطمئن شوید صفحه ۴۰۴ درست نمایش داده می‌شود.
اشتباه پنجم، استفاده از این تابع در حلقه سفارشی است. تابع is_404() تنها برای حلقه اصلی معتبر است.
تحلیل فنی پیشرفته
در نگاه مهندسی، تابعis_404() یک نقطه تصمیم (Decision Point) در لایه نمایش است که هم بر منطق قالب و هم بر سئو اثر می‌گذارد. لایه اول لایه کوئری است. وردپرس با تجزیه URL و ساخت WP_Query، بررسی می‌کند که آیا محتوایی با آدرس درخواستی مطابقت دارد یا نه. اگر مطابقت نداشته باشد، متغیر is_404 فعال می‌شود.
لایه دوم لایه قالب است. فایل 404.php اگر وجود داشته باشد، بارگذاری می‌شود و در غیر این صورت، از index.php استفاده می‌شود. تابع is_404() در هر یک از این فایل‌ها می‌تواند رفتار شرطی ایجاد کند.
لایه سوم لایه سئو است. مهم است که صفحه ۴۰۴ به‌درستی کد وضعیت HTTP را برگرداند. اگر کد ۲۰۰ برگردانده شود، موتورهای جستجو آن صفحه را ایندکس می‌کنند که می‌تواند به افت کیفیت سایت منجر شود. وردپرس به‌صورت خودکار کد ۴۰۴ را ارسال می‌کند، اما برخی قالب‌ها این رفتار را به‌اشتباه تغییر می‌دهند. برای مطالعه درباره رفع خطاهای ۴۰۴ واقعی، می‌توانید به راهنمای رفع خطای ۴۰۴ در وردپرس مراجعه کنید.
لایه چهارم لایه تجربه کاربری است. صفحه ۴۰۴ فرصت طلایی برای تبدیل کاربر را از دست رفته به یک بازدیدکننده مفید است. لینک‌های پیشنهادی، جعبه جستجو و پیشنهاد محتوا می‌توانند در این صفحه ظاهر شوند. برای مطالعه بیشتر روی این موضوع، می‌توانید به راهنمای فرصت طلایی صفحه ۴۰۴ مراجعه کنید.
لایه پنجم لایه Observability است. در پروژه‌های بزرگ، ثبت آدرس‌های ۴۰۴ به‌صورت متمرکز می‌تواند به کشف خطاهای ساختاری کمک کند. ابزارهایی مانند Google Search Console این خطاها را گزارش می‌دهند و مفاهیم پایه‌ای آن در HTTP 404 در ویکی‌پدیا توضیح داده شده است.
در Headless WordPress، این تابع در سمت بک‌اند اجرا می‌شود و فرانت‌اند معمولاً تصمیم می‌گیرد که آیا محتوای ۴۰۴ را نمایش دهد یا نه. با این حال، هماهنگی این دو لایه اهمیت بالایی دارد. در REST API نیز، بهتر است پاسخ‌های ۴۰۴ با کد وضعیت مناسب ارسال شوند تا کلاینت بتواند به‌درستی تصمیم بگیرد.
پرسش‌های پرتکرار
تفاوتis_404 و is_archive چیست؟ is_archive هر نوع آرشیو را شامل می‌شود، اما is_404 فقط صفحه خطای ۴۰۴ را.
آیا is_404 در حلقه سفارشی کار می‌کند؟ خیر، این تابع تنها بر پایه کوئری اصلی کار می‌کند.
چطور صفحه ۴۰۴ را سفارشی کنیم؟ با ساخت فایل 404.php در قالب یا Child Theme.
آیا صفحه ۴۰۴ باید ایندکس شود؟ خیر، این صفحه نباید ایندکس شود. وردپرس به‌صورت خودکار کد ۴۰۴ را ارسال می‌کند که مانع ایندکس می‌شود.
چطور آدرس‌های ۴۰۴ را در Google Search Console بررسی کنیم؟ با ورود به بخش Coverage و مشاهده گزارش صفحات ۴۰۴.
نتیجه و مسیر ادامه
تابعis_404() یک ابزار دقیق برای تشخیص صفحه خطای ۴۰۴ در وردپرس است. استفاده درست از آن یعنی درک دقیق ساختار کوئری، طراحی صفحه سفارشی مناسب، توجه به کد وضعیت HTTP و escape در خروجی. هر اشتباه کوچک می‌تواند به تجربه ضعیف کاربر یا افت سئو منجر شود.
اگر این تابع را در پروژه‌ای واقعی به کار برده‌اید و رفتار غیرمنتظره‌ای دیده‌اید — به‌خصوص در ترکیب با کش یا در REST API — تجربه‌تان می‌تواند راهگشای دیگران باشد. کدام بخش بیشترین زمان را از شما گرفت؟ دیدگاه خود را بنویسید.
سعید کریمه
نویسنده
نویسنده در وردپرس کار.