چرا خطای نبود فایل screenshot در قالب وردپرس رخ می‌دهد و چگونه آن را اصولی برطرف کنیم؟

screenshot.png دقیقاً چیست و چه نقشی دارد؟

فایل screenshot.png یک تصویر پیش‌نمایش است که در ریشه هر قالب وردپرس قرار می‌گیرد و در پیشخوان، به‌عنوان نماد بصری آن قالب در صفحه «نمایش ← پوسته‌ها» نمایش داده می‌شود. از دید کاربر، این تصویر اولین برخوردی است که با قالب شما دارد — قبل از نصب، قبل از فعال‌سازی، و حتی قبل از دیدن کد یا دموی زنده. از دید توسعه‌دهنده، این فایل یک امضای رسمی است که نشان می‌دهد قالب به استانداردهای اکوسیستم احترام می‌گذارد.

از منظر معماری فایل در وردپرس، این تصویر جزو فایل‌های ضروری هر قالب نیست — هسته وردپرس بدون آن هم می‌تواند قالب را بارگذاری کند. اما در بازبینی رسمی مخزن WordPress.org و در بازبینی Theme Check، وجود آن یک الزام است، نه یک انتخاب. همین دوگانگی — «ضروری برای کارکرد نیست، اما ضروری برای پذیرش است» — باعث می‌شود بسیاری از توسعه‌دهندگان تازه‌کار، اهمیت آن را دست‌کم بگیرند.

برای درک جایگاه این فایل در ساختار کلی قالب، پیشنهاد می‌کنم مقاله قالب وردپرس چیست و چگونه انتخاب کنیم را بخوانید. آنجا توضیح داده‌ام که قالب از چه لایه‌هایی تشکیل می‌شود و هر فایل چه نقشی دارد. فایل screenshot.png در لایه «هویت بصری» قالب قرار می‌گیرد، نه در لایه «اجرا».

یک نکته ظریف که در مشاوره‌ها زیاد دیده‌ام: بعضی از توسعه‌دهندگان فکر می‌کنند این فایل همان thumbnail.png است. اما وردپرس فقط به screenshot.png نگاه می‌کند — نه به thumbnail.png، نه به preview.png. اگر فایل را با نام دیگری بسازید، هسته آن را نادیده می‌گیرد و باز هم با خطای نبود screenshot مواجه می‌شوید. برای مطالعه بیشتر درباره پروتکل Screenshot، ویکی‌پدیا نقطه شروع خوبی است.

فایل screenshot.png برای کاربر، ویترین قالب است؛ برای داور بازبینی، امضای پذیرش؛ و برای خودتان، اولین فرصت برای اثبات اینکه قالب‌تان ارزش یک کلیک را دارد.

چرا نبود این فایل به‌عنوان خطا گزارش می‌شود؟

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

۱. تجربه کاربری در پیشخوان

وقتی کاربری در پیشخوان، صفحه «نمایش ← پوسته‌ها» را باز می‌کند، به‌ازای هر قالب یک کارت نمایش داده می‌شود. اگر screenshot.png موجود نباشد، وردپرس به‌جای آن یک مستطیل خاکستری با یک آیکون پیش‌فرض نمایش می‌دهد. این تجربه بصری، به‌ویژه در سایت‌هایی که ده‌ها قالب نصب دارند، انتخاب را برای کاربر دشوار می‌کند.

۲. اعتماد کاربر به قالب

یک قالب بدون screenshot، از دید کاربر، نیمه‌کاره به نظر می‌رسد — حتی اگر کد آن بی‌نقص باشد. این یک اصل روانشناسی بصری است که در فروشگاه‌های قالب مثل ThemeForest و در مخزن WordPress.org، مستقیماً روی نرخ نصب و دانلود اثر می‌گذارد. اگر با انتخاب قالب برای کسب‌وکار سروکار دارید، معیارهایی که در مقاله چیزهایی که پیش از خرید قالب باید بررسی کنیم فهرست کرده‌ام، شامل همین نکته هم می‌شود.

۳. الزام بازبینی WordPress.org

تیم بازبینی مخزن رسمی وردپرس، در چک‌لیست خود، وجود screenshot.png را الزامی می‌داند. اگر این فایل نباشد، قالب شما هرگز در مخزن پذیرفته نمی‌شود — حتی اگر همه معیارهای دیگر را رعایت کرده باشید. این سیاست در واقع یک استاندارد اکوسیستمی است که در طول ده‌ها سال شکل گرفته است. برای فهم بیشتر این استانداردها، مقاله چگونه یک قالب وردپرس استاندارد را تشخیص دهیم فهرست کامل معیارها را در دسترس قرار می‌دهد.

۴. یکپارچگی ساختار فایل قالب

در نگاه ساختاری، هر قالب وردپرس یک قرارداد فایلی دارد: style.css برای هویت، index.php به‌عنوان نقطه ورود، functions.php به‌عنوان لایه منطق، و screenshot.png به‌عنوان لایه بصری. فایل screenshot.png بخشی از این قرارداد است و نبودش، ساختار قالب را ناقص می‌کند. برای مطالعه دقیق‌تر درباره بقیه فایل‌های ضروری، مقاله ساختار فایل‌های یک قالب استاندارد وردپرس را توصیه می‌کنم.

الزامات رسمی WordPress.org برای screenshot

تیم بازبینی مخزن رسمی، الزامات دقیقی برای فایل screenshot.png دارد که رعایت آن‌ها به‌سادگی از رد شدن پروژه جلوگیری می‌کند:

سه نکته مهم در این جدول وجود دارد که در تجربه‌ام بیشترین لغزش را در آن‌ها دیده‌ام:

اول: ابعاد ۱۲۰۰ × ۹۰۰، یک الزام «سخت» نیست، یک توصیه «نرم» است. اما در عمل، اگر ابعاد کوچک‌تر بفرستید، در صفحه نمایش‌های Retina (مثل MacBook یا نمایشگرهای ۴K)، تصویر شما تار به نظر می‌رسد. این تیرگی، بلافاصله حس «کار خانگی» را منتقل می‌کند.

دوم: حجم فایل باید کنترل شود. PNG ذاتاً فرمت حجیمی است، و اگر از اسکرین‌شات خام استفاده کنید، فایل به‌سادگی به چند مگابایت می‌رسد. ابزارهایی مثل TinyPNG یا ImageOptim، حجم را تا ۷۰٪ کاهش می‌دهند بدون افت محسوس کیفیت — همان اصولی که در مقاله چگونه تصاویر سایت را فشرده کنیم توضیح داده‌ام.

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

ابعاد ۱۲۰۰×۹۰۰ یک سلیقه نیست، یک سازگاری با نمایشگرهای امروز است؛ هر پیکسل کمتر، یک قدم دورتر از استاندارد.

نشانه‌ها و علائم در پیشخوان

نبود فایل screenshot همیشه به‌صورت یک پیام صریح خودش را نشان نمی‌دهد. در تجربه‌ام، این نشانه‌ها ظاهر می‌شوند:

• نمایش مستطیل خاکستری در صفحه پوسته‌ها: به‌جای پیش‌نمایش قالب، یک مستطیل خاکستری با آیکون پیش‌فرض نمایش داده می‌شود.
• خطای Theme Check: اگر افزونه Theme Check را نصب کرده باشید، یک پیام REQUIRED با عنوان «screenshot.png not found» نمایش داده می‌شود.
• رد شدن در بازبینی مخزن: اگر قالب را برای انتشار در مخزن ارسال کرده باشید، داور بازبینی دقیقاً همین نکته را به‌عنوان دلیل رد ذکر می‌کند.
• مشکل در فروشگاه‌های قالب: در مارکت‌پلیس‌هایی مثل ThemeForest، نبود این فایل باعث پایین آمدن امتیاز قالب در فهرست می‌شود.
• ناکارآمدی در انتخاب قالب: اگر چند قالب مختلف را نصب کرده باشید و همه فاقد screenshot باشند، انتخاب برای کاربر به یک تجربه ناخوشایند تبدیل می‌شود.

یک نکته ظریف: در بعضی از قالب‌های پولی، سازنده به‌جای screenshot.png از یک اسکریپت CSS برای بارگذاری تصویر از CDN استفاده می‌کند. این کار در ظاهر مشکل را حل می‌کند، اما در عمل با استانداردها ناسازگار است و در بازبینی رد می‌شود — چون داور بازبینی، یک فایل فیزیکی را در ریشه قالب انتظار دارد.

تشخیص دقیق: از کجا مطمئن شویم فایل هست یا نه؟

تشخیص این خطا بسیار ساده‌تر از سایر خطاهای وردپرس است، چون مستقیماً با یک فایل فیزیکی سر و کار داریم:

گام اول: بررسی مستقیم پوشه قالب

با FTP یا File Manager، به مسیر wp-content/themes/your-theme/ بروید و بررسی کنید که فایل screenshot.png در ریشه آن وجود دارد یا نه. اگر نبود، مقصر پیدا شده است:

ls -la wp-content/themes/your-theme/screenshot.png

اگر خروجی خالی بود، یعنی فایل وجود ندارد. اگر خروجی چیزی مثل screenshot.png 1200x900 480K نشان داد، فایل هست و باید به سراغ گام بعدی بروید.

گام دوم: بررسی ابعاد و حجم فایل

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

identify wp-content/themes/your-theme/screenshot.png

این دستور در سیستم‌هایی که ImageMagick نصب دارند، ابعاد، فرمت و حجم فایل را نشان می‌دهد. اگر ابعاد کمتر از ۸۸۰×۶۶۰ یا حجم بیشتر از ۱ مگابایت بود، فایل نیاز به بازسازی دارد.

گام سوم: بررسی با افزونه Theme Check

اگر به SSH دسترسی ندارید، افزونه Theme Check سریع‌ترین راه است. این افزونه را از مخزن وردپرس نصب کنید، سپس از مسیر «نمایش ← Theme Check» اجرا کنید. اگر پیامی مثل «screenshot.png not found» یا «screenshot.png should be 1200x900 pixels» دیدید، مقصر مشخص است.

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

گام چهارم: بررسی تصویر در پیشخوان

به پیشخوان وردپرس بروید، مسیر «نمایش ← پوسته‌ها» را باز کنید. اگر برای قالب شما یک مستطیل خاکستری با آیکون پیش‌فرض نمایش داده می‌شود، تشخیص تأیید می‌شود.

ساخت اصولی screenshot در چند گام

ساخت این فایل به‌سادگی یک اسکرین‌شات از دموی قالب نیست. برای رسیدن به یک نتیجه حرفه‌ای، مراحل زیر را در تجربه‌ام مفید یافته‌ام:

گام اول: آماده‌سازی محیط نمایش

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

مهم‌ترین نکته در این گام: از دموی پیش‌فرض سازنده استفاده نکنید. قالب باید با محتوایی نمایش داده شود که نمایانگر واقعی آن باشد. اگر قالب برای فروشگاه است، محصول واقعی نشان دهید؛ اگر وبلاگ است، مقاله واقعی.

گام دوم: تنظیم ابعاد دقیق

با استفاده از Chrome DevTools، ویوپورت مرورگر را روی ابعاد ۱۲۰۰×۹۰۰ تنظیم کنید:

1. مرورگر را باز کنید و F12 بزنید
2. آیکون دستگاه (Toggle Device Toolbar) را بزنید
3. عرض را روی ۱۲۰۰ و ارتفاع را روی ۹۰۰ تنظیم کنید
4. صفحه را به‌طور کامل اسکرول کنید تا همه بخش‌ها بارگذاری شوند

نکته ظریف: ابعاد باید دقیقاً ۱۲۰۰×۹۰۰ باشد، نه ۱۲۰۰×۸۰۰ یا ۱۲۰۰×۱۰۰۰. اگر نسبت ابعاد را رعایت نکنید، وردپرس تصویر را کشیده یا بریده نمایش می‌دهد. برای مطالعه بیشتر درباره نسبت‌های ابعادی در طراحی وب، مقاله طراحی ریسپانسیو چیست را توصیه می‌کنم.

گام سوم: گرفتن اسکرین‌شات

از ابزارهای زیر می‌توانید برای گرفتن اسکرین‌شات استفاده کنید:

• Chrome Built-in: از منوی سه‌نقطه، گزینه «Capture full size screenshot» را انتخاب کنید
• Awesome Screenshot: افزونه‌ای که امکانات ویرایشی خوبی دارد
• Shottr: ابزار سبک و سریع برای macOS
• Lightshot: گزینه‌ای سریع برای ویندوز

گام چهارم: ویرایش و بهینه‌سازی

تصویر گرفته‌شده را در یک ویرایشگر مثل Photoshop، Figma یا GIMP باز کنید. سه کار مهم:

1. ابعاد را روی ۱۲۰۰×۹۰۰ پیکسل ثابت کنید.
2. اگر لازم است، متن‌های اضافی یا المان‌های تبلیغاتی را حذف کنید.
3. فایل را به فرمت PNG با تنظیمات فشرده‌سازی بهینه ذخیره کنید.

برای بهینه‌سازی حجم، می‌توانید از سرویس‌هایی مثل TinyPNG یا ابزارهای خط فرمان مثل pngquant استفاده کنید:

pngquant --quality=70-90 screenshot.png --output screenshot.png

گام پنجم: افزودن به قالب

فایل نهایی را با نام دقیق screenshot.png در ریشه پوشه قالب خود کپی کنید. سپس کش پیشخوان را پاک کنید و صفحه «نمایش ← پوسته‌ها» را رفرش کنید. باید پیش‌نمایش قالب شما را ببینید.

اگر می‌خواهید درباره مراحل کامل ساخت یک قالب از صفر بدانید، مقاله ساخت قالب اختصاصی وردپرس چه مراحلی دارد نقشه راه کاملی ارائه می‌دهد.

اشتباهات رایج در ساخت screenshot

در طول سال‌ها کار روی صدها قالب، اشتباهات مشخصی را دیده‌ام که مرتب تکرار می‌شوند:

اشتباه اول: استفاده از نام اشتباه

بعضی از توسعه‌دهندگان فایل را با نام screenshot.jpg یا screenshot.jpeg ذخیره می‌کنند. وردپرس فقط نام screenshot.png را تشخیص می‌دهد. حتی اگر همه چیز دیگر عالی باشد، این یک اشتباه، همه‌چیز را خراب می‌کند.

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

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

اشتباه سوم: ابعاد ناسازگار

استفاده از ابعاد مربعی (مثلاً ۱۰۰۰×۱۰۰۰) باعث می‌شود وردپرس تصویر را بریده یا کشیده نمایش دهد. همیشه نسبت ۴:۳ را رعایت کنید.

اشتباه چهارم: قرار دادن متن تبلیغاتی

بعضی از توسعه‌دهندگان نسخه رایگان و پولی قالب را با هم متفاوت می‌کنند و در screenshot نسخه رایگان، متن «Upgrade to Pro» قرار می‌دهند. این کار در بازبینی مخزن، دلیل رد فوری است.

اشتباه پنجم: کپی کردن اسکرین‌شات از قالب دیگر

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

اشتباه ششم: نادیده گرفتن نسخه Retina

بعضی از توسعه‌دهندگان فقط یک نسخه از screenshot تولید می‌کنند. اگرچه وردپرس فقط نسخه اصلی را می‌خواند، اما اگر می‌خواهید کیفیت در نمایشگرهای Retina حفظ شود، از ابعاد حداقل ۱۲۰۰×۹۰۰ استفاده کنید — این ابعاد به‌طور خودکار در دستگاه‌های معمولی هم به‌خوبی نمایش داده می‌شود.

پرسش‌های پرتکرار درباره فایل screenshot قالب وردپرس

آیا نبود فایل screenshot.png باعث خرابی سایت می‌شود؟

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

ابعاد دقیق استاندارد screenshot.png چقدر است؟

ابعاد توصیه‌شده ۱۲۰۰ × ۹۰۰ پیکسل با نسبت ۴:۳ است. ابعاد حداقلی که در مخزن رسمی پذیرفته می‌شود، ۸۸۰ × ۶۶۰ پیکسل است. اگر ابعاد کمتر از این باشد، احتمالاً در بازبینی رد می‌شود.

آیا می‌توانم از فرمت JPG به‌جای PNG استفاده کنم؟

از نظر فنی، وردپرس فقط screenshot.png را می‌خواند. اگر فایل با نام screenshot.jpg ذخیره شود، نادیده گرفته می‌شود. پس حتماً فرمت PNG را رعایت کنید.

آیا برای قالب چایلد هم باید screenshot بسازم؟

بله، اگرچه اجباری نیست. اگر قالب چایلد شما screenshot نداشته باشد، وردپرس به‌طور پیش‌فرض از screenshot قالب والد استفاده می‌کند. اما برای تمایز بصری، توصیه می‌کنم یک screenshot اختصاصی بسازید که نشان دهد چایلد تم چیست.

چطور بفهمم بازبین مخزن چرا قالب من را رد کرده؟

بازبین معمولاً یک پیام با فهرست دقیق دلایل رد ارسال می‌کند. اگر فقط «screenshot missing» ذکر شده باشد، با افزودن فایل و ارسال مجدد، قالب پذیرفته می‌شود. برای مطالعه بیشتر درباره استانداردهای عمومی بازبینی، مقاله چگونه یک قالب وردپرس استاندارد را تشخیص دهیم را ببینید.

آیا می‌توانم screenshot پویا (Dynamic) داشته باشم؟

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

حجم ایده‌آل screenshot چقدر است؟

حجم توصیه‌شده زیر ۵۰۰ کیلوبایت و حجم قابل‌پذیرش زیر ۱ مگابایت است. اگر فایل شما بیشتر از این باشد، ابزارهایی مثل TinyPNG یا pngquant حجم را به‌سادگی کاهش می‌دهند.

کالبدشکافی فنی: وردپرس چطور screenshot را می‌خواند؟

برای درک عمیق این موضوع، باید بدانید وردپرس چطور فایل‌های قالب را اسکن می‌کند. هسته وردپرس در فایل wp-admin/includes/theme.php یک تابع به نام get_theme_data() دارد که اطلاعات هر قالب را از هدر style.css می‌خواند. اما برای نمایش screenshot، از تابع get_screenshot() استفاده می‌کند که فایل‌های زیر را به‌ترتیب اولویت جستجو می‌کند:

1. screenshot.png — فرمت اصلی و توصیه‌شده
2. screenshot.jpg — پشتیبانی می‌شود اما توصیه نمی‌شود
3. screenshot.jpeg — پشتیبانی می‌شود
4. screenshot.gif — در نسخه‌های بسیار قدیمی پشتیبانی می‌شد

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

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

یک نکته کمتر شناخته‌شده: وردپرس از نسخه ۴.۶ به بعد، در بخش Customizer هم از فایل screenshot برای نمایش پیش‌نمایش استفاده می‌کند. این یعنی حتی اگر در پیشخوان، فایل به‌درستی نمایش داده شود، در محیط Customizer ممکن است رفتار متفاوتی داشته باشد — به‌خصوص اگر ابعاد فایل با نسبت ۴:۳ سازگار نباشد. برای مطالعه بیشتر درباره Customizer، مقاله چگونه قالب آماده را سفارشی کنیم را توصیه می‌کنم.

نکته سوم: در محیط چندسایتی (Multisite)، فایل screenshot ممکن است به‌خاطر مسیرهای متفاوت بارگذاری، دیرتر لود شود. این حالت در تجربه‌ام نادر است، اما اگر با آن مواجه شدید، بدانید که ریشه در ساختار پوشه‌هاست، نه در خود فایل. برای مطالعه بیشتر درباره وردپرس مولتی‌سایت توصیه می‌کنم.

screenshot در چایلد تم: چه تفاوتی دارد؟

در مورد قالب چایلد، رفتار وردپرس کمی متفاوت است. اگر چایلد تم شما فایل screenshot.png نداشته باشد، وردپرس به‌طور خودکار به سراغ فایل screenshot.png قالب والد می‌رود و همان را نمایش می‌دهد. این رفتار از نسخه ۴.۷ به بعد به‌طور پیش‌فرض اعمال می‌شود.

این یعنی نیازی به ساخت screenshot اختصاصی برای چایلد تم ندارید — اما اگر می‌خواهید چایلد تم شما به‌طور بصری از قالب والد متمایز باشد، توصیه می‌کنم یک screenshot مخصوص بسازید که نشان دهد چایلد تم چه تغییراتی دارد. برای مطالعه بیشتر درباره مفهوم چایلد تم و کاربردهایش، مقاله قالب وردپرس چایلد چیست و چه زمانی به آن نیاز داریم را ببینید.

یک نکته مهم: در بعضی از فروشگاه‌های قالب، قالب چایلد به‌عنوان یک محصول مستقل فروخته می‌شود. در این حالت، داشتن screenshot اختصاصی الزامی است — چون در فهرست محصولات، buyer می‌خواهد ببیند چایلد تم چه چیزی به قالب والد اضافه می‌کند.

مطالعه موردی: احیای یک قالب ردشده

یک تیم توسعه‌دهنده ایرانی، یک قالب حرفه‌ای برای فروش در مخزن WordPress.org آماده کرده بود. تمام مراحل توسعه، تست، و مستندسازی را انجام داده بودند. بعد از ارسال، داور بازبینی، قالب را رد کرد. دلیل: «Missing screenshot.png».

علائم:

• فایل screenshot در ریشه قالب وجود داشت، اما با نام screenshot.jpg
• تیم فکر می‌کرد JPG هم قابل قبول است
• سه روز صرف جستجو برای مشکل شده بود

تشخیص:

بعد از بازبینی دستی پوشه قالب، مشخص شد که فایل screenshot.jpg وجود دارد اما با فرمت اشتباه. وردپرس آن را نادیده می‌گیرد، چون نام فایل دقیقاً screenshot.png نیست. این اشتباه ساده، سه روز از برنامه تیم را عقب انداخته بود.

درمان:

1. ابتدا فایل را در فتوشاپ باز کردیم و با ابعاد ۱۲۰۰×۹۰۰ ذخیره کردیم.
2. سپس با ابزار pngquant حجم را به زیر ۴۰۰ کیلوبایت رساندیم.
3. فایل را در ریشه قالب با نام دقیق screenshot.png قرار دادیم.
4. با افزونه Theme Check، تأیید گرفتیم که خطا برطرف شده.
5. قالب را مجدداً ارسال کردیم و در همان هفته پذیرفته شد.

درس‌آموخته:

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

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

واپسین نکته: پیش از ارسال، یک تصویر

فایل screenshot.png در نگاه اول یک جزئیات کوچک به نظر می‌رسد، اما وقتی به پایان پروژه قالب می‌رسید، همین فایل ساده می‌تواند مرز بین پذیرش و رد شدن باشد. برخلاف خطاهای پیچیده‌ای مثل کندی قالب یا ناسازگاری با افزونه‌ها، این خطا با یک کار ساده در چند دقیقه حل می‌شود — به‌شرطی که آن را جدی بگیرید.

از تجربه‌ام، سه اصل عملی بیشترین بازدهی را داشته‌اند: اول، فرمت PNG را همیشه رعایت کنید — حتی اگر ابزارهای دیگر JPG را قبول کنند. دوم، ابعاد ۱۲۰۰×۹۰۰ را جدی بگیرید، چون در نمایشگرهای امروز، این استاندارد است. سوم، حجم فایل را زیر ۵۰۰ کیلوبایت نگه دارید تا بارگذاری سریع باشد — همان اصل «تصویر سبک، سایت سبک» که در سئوی تصویر توضیح داده‌ام.

در نهایت، اگر در آستانه انتشار قالب هستید، توصیه می‌کنم قبل از هر چیز، یک بار با افزونه Theme Check همه‌چیز را بررسی کنید. سه دقیقه بررسی، می‌تواند سه روز انتظار را از شما بگیرد.

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