دبلیوپی کد (WPCode / Insert Headers and Footers)
code قراردادن کدهای نماد اعتماد و آنالیتیکس

راهنمای جامع افزونه دبلیوپی کد (WPCode) برای مدیریت پیشرفته اسکریپت‌ها و کدهای سفارشی در وردپرس

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

آخرین نگارش نسخه 2.3.9
نصب‌های فعال +3 میلیون
امتیاز کاربران ★ 4.9 (1,875 رأی)
توسعه‌دهنده رسمی Syed Balkhi

📋 تفکیک گزارش تغییرات (Changelog) در ۲ نسخه اخیر

پایش لحظه‌ای تغییرات، وصله‌های امنیتی و ویژگی‌های اضافه شده در نسخه کنونی و نسخه پیشین از مخزن رسمی WordPress.org:

نگارش فعلی (Latest) نسخه 2.3.9
• رفع خطای مهلک پی‌اچ‌پی در زمان ثبت خطای قطعه کد در فرانت‌اند یا درخواست‌های رست در صورت عدم وجود پوشه گزارش‌ها • جلوگیری از بازنویسی محتوای قطعه کدها با محتوای ویرایشگر بصری هنگام فعال‌سازی رویدادهای ویرایشگر توسط سایر افزونه‌ها در بخش مدیریتی • شروع همیشه پیش‌نمایش قطعه کدهای کتابخانه از ابتدای کد • رفع خطای مهلک پی‌اچ‌پی در برخی درخواست‌های ایجکس مدیریت مربوط به اعلان اتصال کتابخانه
📑 فهرست عناوین و سرفصل‌های این مقاله:

معماری داخلی افزونه WPCode و حذف نیاز به ویرایش مستقیم فایل functions.php

افزونه دبلیوپی کد (WPCode) که در گذشته با نام Insert Headers and Footers شناخته می‌شد، فراتر از یک ابزار ساده برای درج کدهای رهگیری عمل می‌کند. در معماری سنتی وردپرس، توسعه‌دهندگان و مدیران سایت مجبور بودند برای اضافه کردن توابع سفارشی، کدهای تأییدیه اینماد، یا اسکریپت‌های تحلیلی، فایل functions.php قالب فرزند (Child Theme) یا فایل‌های هدر و فوتر را مستقیماً ویرایش کنند. این رویکرد خطرات امنیتی بالایی به همراه داشت، زیرا یک خطای ساده sintx در فایل PHP می‌توانست کل وب‌سایت را از کار انداخته و خطای مرگبار صفحه سفید مرگ (WSOD) را ایجاد کند. این افزونه با بهره‌گیری از پست‌تایپ‌های اختصاصی در دیتابیس وردپرس، کدهای سفارشی شما را به عنوان متادیتا یا محتوای ساختاریافته ذخیره می‌کند و از طریق هوک‌های استاندارد وردپرس مانند wp_head، wp_footer و wp_body_open در رندر نهایی صفحه تزریق می‌نماید. این مکانیزم تضمین می‌کند که با به‌روزرسانی قالب یا هسته وردپرس، کدهای درج شده از بین نرفته و پایداری سیستم حفظ شود. علاوه بر این، سیستم مدیریت خطا در اجرای کدهای PHP درون افزونه مانع از کرش کلی سایت شده و ار خطاها جلوگیری می‌کند.

مدیریت بهینه اسکریپت‌های شخص ثالث و تأثیر آن بر Core Web Vitals

یکی از چالش‌های اصلی وب‌مسترها در اکوسیستم وب فارسی، بارگذاری اسکریپت‌های سنگین مانند ابزارهای تحلیلگر، کدهای چت آنلاین، سیستم‌های پیامکی و ردیاب‌های تبلیغاتی است که به شدت روی معیارهای Core Web Vitals به ویژه سرعت بارگذاری اولیه و زمان پاسخگویی سرور تأثیر منفی می‌گذارند. افزونه WPCode با ارائه ابزارهای کنترلی دقیق بر روی محل و نحوه بارگذاری اسکریپت‌ها، بهینه‌سازی عملکرد فرانت‌اند را به شکل قابل توجهی ساده‌تر می‌کند. با استفاده از قابلیت شرطی‌سازی (Conditional Logic)، می‌توان تعیین کرد که یک اسکریپت خاص صرفاً در برگه‌های مشخص، پست‌تایپ‌های خاص یا برای کاربران لاگین‌کرده بارگذاری شود. این سطح از کنترل دقیق مانع از اجرای کدهای غیرضروری در صفحات لندینگ یا صفحات اصلی می‌شود و ترافیک پردازشی مرورگر کاربر را بهینه‌سازی می‌کند. همچنین امکان استفاده از ویژگی‌های بارگذاری ناهم‌گام یا async و defer برای اسکریپت‌های جاوااسکریپت فراهم است که از مسدود شدن رندر صفحه (Render-Blocking) جلوگیری کرده و امتیاز ابزارهایی مانند گوگل پیج‌اسپید اینسایت را بهبود می‌بخشد، بدون اینکه نیاز به دانش عمیق برنامه‌نویسی جاوااسکریپت باشد.

سازگاری با ساختار زبان‌های راست‌چین (RTL) و فونت‌های سفارشی

در طراحی وب‌سایت‌های فارسی‌زبان، بارگذاری صحیح فونت‌های سفارشی، استایل‌های مختص زبان‌های راست‌چین و هماهنگ‌سازی کدهای CSS با قالب‌های مختلف اهمیت حیاتی دارد. بسیاری از قالب‌های استاندارد جهانی به صورت پیش‌فرض پشتیبانی کاملی از زبان فارسی یا استایل‌های خاص درگاه‌های پرداخت بانکی و سامانه‌های پیامکی ندارند. افزونه WPCode به مدیران سایت اجازه می‌دهد تا استایل‌های CSS سفارشی خود را به صورت گلوبال یا محدود به بخش‌های خاصی از سایت تزریق کنند تا مشکلات به‌هم‌ریختگی فونت‌ها یا چیدمان المان‌های راست‌چین به سرعت برطرف شود. استفاده از این افزونه برای تزریق کدهای مربوط به فونت‌های وب (مانند وواز، وزیرمتن یا ایران‌سنس) از طریق تگ‌های link یا استایل‌های درون‌خطی در بخش هد، به طراحان امکان می‌دهد بدون دستکاری سورس کد قالب، کنترل کامل بر تایپوگرافی سایت داشته باشند. این ساختار همچنین برای اعمال کدهای سفارشی مرتبط با استایل‌های واکنش‌گرا (Responsive) در موبایل و دسکتاپ بسیار کارآمد است و پایداری ظاهر سایت را در هاست‌ها و سرورهای مختلف تضمین می‌کند.

امنیت، کنترل دسترسی و پیاده‌سازی استانداردهای ایزو و اینماد در وردپرس

برای دریافت نماد اعتماد الکترونیکی (اینماد) و اتصال به درگاه‌های پرداخت مستقیم یا واسطه، درج کدهای تأییدیه و اسکریپت‌های امنیتی در هدر یا فوتر سایت الزامی است. افزونه WPCode با فراهم کردن یک محیط امن و ایزوله برای درج این کدها، از تزریق کدهای مخرب توسط کاربران دارای دسترسی سطح پایین جلوگیری می‌کند. مدیر کل سایت می‌تواند سطح دسترسی به مدیریت کدهای سفارشی را محدود کند تا فقط نقش‌های کاربری خاصی توانایی ویرایش یا ایجاد اسکریپت‌های جدید را داشته باشند. علاوه بر این، در محیط‌های هاستینگ اشتراکی ایران که گاه با محدودیت‌های منابع یا پایداری سرور مواجه هستند، اجرای کدهای PHP از طریق این افزونه به جای ویرایش فایل‌های اصلی، امنیت کلی سیستم را بالا می‌برد. سیستم لاگ‌گیری و قابلیت فعال‌سازی یا غیر فعال‌سازی سریع هر قطعه کد بدون نیاز به دسترسی FTP، به تیم‌های فنی اجازه می‌دهد در صورت بروز اختلال در درگاه‌های پرداخت یا سامانه‌های پیامکی، به سرعت کد مربوطه را عیب‌یابی یا موقتاً غیرفعال کنند.

❓ سوالات متداول درباره دبلیوپی کد (WPCode / Insert Headers and Footers)

پاسخ به سوالات و چالش‌های فنی وبمسترها، طراحان سایت و مدیران سرور درباره افزونه دبلیوپی کد (WPCode / Insert Headers and Footers) در این بخش گردآوری شده است:

افزونه WPCode دارای یک قطعه‌کد (Snippet) از نوع PHP است که کدهای شما را درون یک ساختار ایمن اجرا می‌کند. اگر کد شما حاوی خطای سینتکسی باشد، سیستم مدیریت خطای وردپرس از وقوع خطای صفحه سفید جلوگیری کرده و پیام خطای مربوطه را در داشبورد نمایش می‌دهد یا کد را موقتاً غیرفعال می‌کند. توصیه می‌شود همیشه قبل از انتشار نهایی کدهای PHP پیچیده، آن‌ها را در یک محیط استیجینگ تست کنید.
خود افزونه سبک است و بار اضافه محسوسی ایجاد نمی‌کند. تأثیر روی سرعت کاملاً به کدهایی بستگی دارد که شما درون آن قرار می‌دهید. با استفاده از قابلیت Conditional Logic می‌توانید مطمئن شوید اسکریپت‌های سنگین فقط در صفحات ضروری لود می‌شوند و این کار به بهبود سرعت و معیارهای Core Web Vitals کمک می‌کند.
از منوی افزونه در پیشخوان وردپرس، بخش «Code Snippets» را انتخاب کرده و گزینه «Header & Footer» را باز کنید. سپس کد متا یا اسکریپت ارائه شده توسط اینماد یا گوگل را در کادر مربوط به Header قرار داده و تغییرات را ذخیره کنید. این کد به طور خودکار در تمام صفحات سایت بین تگ‌های <head> قرار خواهد گرفت.
نسخه رایگان تمامی امکانات پایه مانند درج کد در هدر و فوتر، کدهای PHP، و مدیریت اسکریپت‌های عمومی را به طور کامل ارائه می‌دهد که برای اکثر سایت‌های وردپرسی و فروشگاهی ایرانی جهت اتصال درگاه‌ها و کدهای تأییدیه کاملاً کافی است. نسخه پرو امکانات پیشرفته‌تری مانند تست A/B، ریویژن‌های پیشرفته کد و ابزارهای تخصصی‌تر ای-کامرس را شامل می‌شود.