تابع is_archive چطور کار می‌کند؟
تابع is_archive برای تشخیص صفحات آرشیو در وردپرس؛ بررسی پارامترها، نکات کلیدی، تفاوت با توابع تخصصی و اشتباهات رایج.
6 دقیقه مطالعه
چرا تشخیص آرشیو اهمیت دارد؟
آرشیو در وردپرس یک مفهوم کلیدی است که همه صفحات فهرست‌محور را شامل می‌شود: آرشیو دسته‌بندی، آرشیو برچسب، آرشیو نویسنده، آرشیو تاریخ، آرشیو پست تایپ سفارشی و حتی آرشیو جستجو (بسته به تنظیمات). این صفحات، برخلاف برگه‌ها و نوشته‌ها، ماهیت فهرست‌محور دارند و معمولاً ساختار نمایش متفاوتی می‌طلبند. اگر در قالب، این صفحات از سایر صفحات تشخیص داده نشوند، نمی‌توان طراحی و تجربه کاربری متفاوتی برای آن‌ها پیاده کرد. برای نمونه، در آرشیو دسته‌بندی معمولاً بهتر است توضیحات دسته و فیلترها نمایش داده شود، در حالی که این عناصر برای نوشته تکی نامرتبط هستند. تابعis_archive() این تشخیص کلی را ممکن می‌کند.
تابع is_archive چیست؟
تابعis_archive() یک تابع شرطی در هسته وردپرس است که در فایل wp-includes/query.php تعریف شده است. این تابع بررسی می‌کند که آیا صفحه فعلی یک صفحه آرشیو است یا نه.
خروجی این تابع یک مقدار بولی است: true اگر صفحه فعلی یکی از انواع آرشیو باشد و false در غیر این صورت. این تابع هیچ پارامتر ورودی نمی‌گیرد.
نکته مهم این است که این تابع تمام انواع آرشیو را شامل می‌شود. اگر می‌خواهید نوع خاصی از آرشیو را تشخیص دهید، باید از توابع تخصصی‌تر مانند is_category()، is_tag()، is_author() یا is_date() استفاده کنید.
امضای تابع و پارامترها
امضای این تابع به‌شکل زیر است:function is_archive() {
global $wp_query;
return $wp_query->is_archive();
}سازوکار داخلی تابع
تابعis_archive() در واقع یک میان‌بر (Wrapper) برای متد is_archive() روی شیء جهانی $wp_query است. این متد در کلاس WP_Query تعریف شده و بررسی می‌کند که آیا کوئری فعلی یکی از انواع آرشیو است یا نه.
در عمل، این متد تمام متغیرهای زیر را بررسی می‌کند:
- is_category
- is_tag
- is_tax
- is_author
- is_date
- is_post_type_archive
اگر هر یک از این متغیرها مقدار true داشته باشد، متد is_archive() مقدار true برمی‌گرداند.
نکته مهم این است که وردپرس برای آرشیوها، فایل archive.php را در اولویت اول قرار می‌دهد. اگر این فایل وجود نداشته باشد، از index.php استفاده می‌کند. برای مطالعه دقیق‌تر درباره سلسله‌مراتب قالب، می‌توانید به راهنمای get_template_part مراجعه کنید.
انواع آرشیو در وردپرس
آرشیوها در وردپرس چند نوع مختلف دارند: - آرشیو دسته‌بندی (Category Archive): برای دسته‌بندی نوشته‌ها - آرشیو برچسب (Tag Archive): برای برچسب‌های نوشته‌ها - آرشیو تاکسونومی سفارشی (Custom Taxonomy Archive): برای تاکسونومی‌های سفارشی - آرشیو نویسنده (Author Archive): برای نوشته‌های یک نویسنده - آرشیو تاریخ (Date Archive): برای روز، ماه یا سال مشخص - آرشیو پست تایپ سفارشی (Custom Post Type Archive): برای پست تایپ‌های سفارشی هر کدام از این آرشیوها، تابع تشخیصی خود را دارند. برای مطالعه دقیق روی هر یک، می‌توانید به راهنمای is_category، راهنمای is_tag، راهنمای is_author و راهنمای is_date مراجعه کنید.تفاوت is_archive با is_category و is_tag
تابعis_archive() یک تشخیص کلی است: هر نوع آرشیو را شامل می‌شود. در مقابل، is_category() تنها آرشیو دسته‌بندی را هدف می‌گیرد و is_tag() تنها آرشیو برچسب.
این تفاوت در الگوهای شرطی اهمیت زیادی دارد. برای نمونه، اگر بخواهید استایل متفاوتی برای همه آرشیوها پیاده کنید، از is_archive() استفاده می‌کنید. اما اگر بخواهید فقط برای آرشیو دسته‌بندی رفتار خاصی پیاده کنید، از is_category() استفاده می‌کنید.
مفهوم تاکسونومی در Taxonomy در ویکی‌پدیا توضیح داده شده است.
کاربردهای عملی در قالب
یکی از رایج‌ترین کاربردهای این تابع، اضافه کردن کلاس CSS اختصاصی به بدنه است. می‌توانید با استفاده از این تابع، استایل یکپارچه‌ای برای همه آرشیوها پیاده کنید:add_filter( 'body_class', 'myplugin_body_classes' );
function myplugin_body_classes( $classes ) {
if ( is_archive() ) {
$classes[] = 'archive-listing-page';
}
return $classes;
}body_class در راهنمای body_class به تفصیل بررسی شده است.
کاربرد دیگر، نمایش عنوان مناسب در بالای صفحه است. برای نمونه، در آرشیو دسته‌بندی می‌توانید نام دسته را نمایش دهید، در آرشیو نویسنده نام نویسنده، در آرشیو تاریخ بازه زمانی و در آرشیو پست تایپ سفارشی نام آن پست تایپ. تابع the_archive_title() این کار را خودکار انجام می‌دهد.
if ( is_archive() ) {
the_archive_title( '', '
' );
the_archive_description( '', '' );
}the_archive_title() و the_archive_description() هر دو خروجی escape شده تولید می‌کنند، بنابراین نیازی به escape دستی نیست.
ارتباط با سلسله‌مراتب قالب
وردپرس برای هر نوع آرشیو، فایل قالب اختصاصی دارد. برای نمونه، دسته‌بندی ازcategory.php یا category-{slug}.php استفاده می‌کند، برچسب از tag.php یا tag-{slug}.php، و پست تایپ سفارشی از archive-{post_type}.php.
اگر این فایل‌ها وجود نداشته باشند، وردپرس به archive.php و سپس index.php برمی‌گردد. تابع is_archive() در هر یک از این فایل‌ها می‌تواند رفتار شرطی ایجاد کند، اما در برخی از آن‌ها زائد است.
برای مطالعه دقیق درباره ساختار قالب و نحوه استفاده از get_header() و get_footer()، می‌توانید به راهنمای get_header و راهنمای get_footer مراجعه کنید.
نکات امنیتی و اشتباهات رایج
اشتباه اول، نبود شرط مناسب در قالب است. اگر در فایلarchive.php از is_archive() بدون پارامتر استفاده کنید، شرط زائد است. اما اگر در فایل مشترک مانند index.php استفاده می‌کنید، شرط ضروری است.
اشتباه دوم، نبود بررسی نوع آرشیو است. اگر بخواهید برای آرشیو دسته‌بندی رفتار خاصی پیاده کنید، باید از is_category() استفاده کنید، نه is_archive() به‌تنهایی.
اشتباه سوم، نبود escape در خروجی است. اگر عنوان یا توضیحات آرشیو را از توابع سفارشی چاپ می‌کنید، باید از esc_html() استفاده کنید. راهنمای این تابع در صفحه esc_html آمده است.
اشتباه چهارم، نبود تست است. باید آرشیو دسته‌بندی، برچسب، نویسنده، تاریخ و پست تایپ سفارشی را در محیط staging تست کنید.
اشتباه پنجم، استفاده از این تابع در حلقه سفارشی است. تابع is_archive() تنها برای حلقه اصلی معتبر است.
اشتباه ششم، نبود توجه به سئو است. آرشیوها در سئو می‌توانند مفید یا مضر باشند. برای مطالعه بیشتر روی این موضوع، می‌توانید به راهنمای سئوی صفحه‌بندی و راهنمای سئوی صفحات دسته فروشگاهی مراجعه کنید.
تحلیل فنی پیشرفته
در نگاه مهندسی، تابعis_archive() یک نقطه تصمیم (Decision Point) در لایه نمایش است که بر چند لایه معماری وردپرس اثر می‌گذارد. لایه اول لایه کوئری است. وردپرس با تجزیه URL و ساخت WP_Query، متغیرهای مختلفی مانند category_name، tag، author_name، year یا post_type را تنظیم می‌کند. سپس متد is_archive() بر اساس این متغیرها تصمیم می‌گیرد.
لایه دوم لایه قالب است. سلسله‌مراتب قالب در آرشیوها پیچیده‌تر از برگه‌ها و نوشته‌هاست. هر نوع آرشیو می‌تواند فایل اختصاصی خود را داشته باشد و این امکان، کنترل دقیق روی نمایش را فراهم می‌کند.
لایه سوم لایه سئو است. آرشیوها می‌توانند محتوای نازک (Thin Content) تولید کنند و به همین دلیل، مدیریت صحیح آن‌ها اهمیت دارد. برای نمونه، آرشیو برچسب‌ها در برخی پروژه‌ها به‌عنوان محتوای کم‌ارزش در نظر گرفته می‌شوند و توصیه می‌شود با noindex مدیریت شوند.
لایه چهارم لایه کشینگ است. صفحه آرشیو معمولاً کش می‌شود، اما اگر محتوای شرطی داشته باشد (مثلاً بر اساس وضعیت ورود کاربر)، باید استراتژی کش مناسب انتخاب شود. برای مطالعه بیشتر روی محتوای شرطی کاربر، می‌توانید به راهنمای is_user_logged_in مراجعه کنید.
لایه پنجم لایه تست است. تست‌های End-to-End باید همه انواع آرشیو را پوشش دهند. مفاهیم پایه‌ای آرشیو در Archive در ویکی‌پدیا توضیح داده شده است.
در معماری Headless WordPress، این تابع در سمت بک‌اند اجرا می‌شود و فرانت‌اند باید بر اساس نوع آرشیو، نمایش متفاوتی پیاده کند. برای مطالعه درباره REST API به راهنمای register_rest_route مراجعه کنید.
پرسش‌های پرتکرار
تفاوتis_archive و is_category چیست؟ is_archive هر نوع آرشیو را شامل می‌شود، در حالی که is_category فقط آرشیو دسته‌بندی را.
آیا is_archive آرشیو جستجو را هم شامل می‌شود؟ خیر، آرشیو جستجو با is_search تشخیص داده می‌شود.
آیا is_archive در حلقه سفارشی کار می‌کند؟ خیر، این تابع تنها بر پایه کوئری اصلی کار می‌کند.
چطور نوع آرشیو را تشخیص دهیم؟ با توابع تخصصی مانند is_category، is_tag، is_author، is_date یا is_post_type_archive.
آیا is_archive در فایل archive.php زائد است؟ بله، چون این فایل تنها برای آرشیوها بارگذاری می‌شود.
نتیجه و مسیر ادامه
تابعis_archive() یک ابزار دقیق برای تشخیص هر نوع آرشیو در وردپرس است. استفاده درست از آن یعنی درک دقیق انواع آرشیو، استفاده از توابع تخصصی‌تر در موارد خاص، توجه به escape در خروجی و تست همه حالت‌ها. هر اشتباه کوچک می‌تواند به تجربه ضعیف کاربر یا مشکلات سئو منجر شود.
اگر این تابع را در پروژه‌ای واقعی به کار برده‌اید و رفتار غیرمنتظره‌ای دیده‌اید — به‌خصوص در ترکیب با کش یا در سایت‌های فروشگاهی — تجربه‌تان می‌تواند راهگشای دیگران باشد. کدام بخش بیشترین زمان را از شما گرفت؟ دیدگاه خود را بنویسید.
سعید کریمه
نویسنده
نویسنده در وردپرس کار.