افزونه نمایش کد در وردپرس؛ آموزش SyntaxHighlighter

افزونه نمایش کد در وردپرس؛ آموزش SyntaxHighlighter

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

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

آنچه در این مقاله می‌خوانید۱۰ بخش

قبل از نصب افزونه، کد رو چطور در وردپرس نمایش بدیم؟

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

بلوک Code وردپرس چه کاری انجام می‌ده؟

داخل ویرایشگر نوشته روی دکمه «+» کلیک کنید و Code یا «کد» رو جست‌وجو کنید. بعد بلوک رو اضافه کنید و کدتون رو داخلش بچسبونید. این روش برای نمایش چند خط دستور، یک شورت‌کد نمونه یا قطعه‌کدی کوتاه مناسبه.

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

چه زمانی به افزونه نمایش کد در وردپرس نیاز داریم؟

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

موقع انتخاب افزونه فقط ظاهرش رو نبینید. تاریخ آخرین به‌روزرسانی، نسخه‌های سازگار وردپرس و PHP، گزارش‌های پشتیبانی و نتیجه آزمایش افزونه روی سایت خودتون هم مهم هستن.

SyntaxHighlighter Evolved چه امکاناتی داره؟

SyntaxHighlighter Evolved کد رو داخل یک کادر خوانا نشون می‌ده و بخش‌های مختلف اون رو براساس زبانی که انتخاب می‌کنید رنگی می‌کنه. امکانات دقیق افزونه به موتور نمایش و تنظیماتی بستگی داره که برای اون در نظر می‌گیرید.

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

نکات مهم قبل از نصب افزونه

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

  • نسخه موردنیاز وردپرس و PHP رو در صفحه افزونه بررسی کنید.
  • افزونه رو اول روی یک سایت آزمایشی امتحان کنید.
  • قبل از فعال‌کردن افزونه در سایت اصلی، از فایل‌ها و پایگاه داده نسخه پشتیبان بگیرید.
  • چند نوشته دارای PHP، CSS و JavaScript رو هم در موبایل و هم در دسکتاپ ببینید.

آموزش نصب افزونه SyntaxHighlighter Evolved

نصب افزونه از مخزن وردپرس

وارد پیشخوان وردپرس بشید و از منوی «افزونه‌ها» روی «افزودن افزونه تازه» کلیک کنید. عبارت SyntaxHighlighter Evolved رو در کادر جست‌وجو بنویسید. قبل از نصب، نام افزونه و صفحه جزئیاتش رو ببینید تا یک افزونه مشابه رو اشتباهی نصب نکنید.

روی «هم‌اکنون نصب نمایید» کلیک کنید و کمی منتظر بمونید تا نصب تموم بشه. بعد دکمه «فعال نمایید» رو بزنید.

نصب افزونه از مخزن وردپرس
نصب افزونه از مخزن وردپرس

فعال‌کردن افزونه و پیداکردن تنظیماتش

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

ورود به تنظیمات SyntaxHighlighter
ورود به تنظیمات SyntaxHighlighter

تنظیمات SyntaxHighlighter Evolved رو چطور انجام بدیم؟

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

تنظیمات افزونه SyntaxHighlighter
تنظیمات افزونه SyntaxHighlighter

انتخاب نسخه موتور نمایش کد

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

انتخاب قالب رنگی مناسب

در بخش Color Theme می‌تونید طرح رنگی کادر کد رو انتخاب کنید. قالبی رو بردارید که متن و پس‌زمینه اون تضاد کافی داشته باشن و رنگ‌هاش با قالب سایتتون قاطی نشن. خوانابودن کد از هماهنگی ظاهری مهم‌تره.

فعال‌کردن زبان‌های برنامه‌نویسی موردنیاز

هر زبان یک Brush داره که الگوی رنگ‌بندی همون زبان رو بارگذاری می‌کنه. فقط زبان‌هایی رو فعال کنید که واقعاً در سایتتون استفاده می‌شن. گزینه Load All Brushes همه زبان‌های در دسترس رو بارگذاری می‌کنه، ولی بیشتر سایت‌ها به فعال‌کردن همه اون‌ها نیازی ندارن.

تنظیم شماره خط، نوار ابزار و لینک‌ها

Display Line Numbers شماره هر خط رو کنار کد نشون می‌ده. این گزینه برای آموزش‌هایی مفیده که داخل متن به یک خط مشخص اشاره می‌کنن. Display The Toolbar نوار ابزار قطعه‌کد رو کنترل می‌کنه. گزینه Automatically Make URLs Clickable هم نشانی‌های داخل کد رو قابل کلیک می‌کنه. اگه حفظ شکل دقیق نمونه کد براتون مهمه، نتیجه این گزینه رو با دقت ببینید.

تنظیمات پیش‌فرض در افزونه SyntaxHighlighter
تنظیمات پیش‌فرض در افزونه SyntaxHighlighter

تنظیم خطوط طولانی، اندازه تب و شماره شروع

خطوط طولانی باید یا به خط بعد برن یا داخل کادر اسکرول افقی داشته باشن. تنظیم Wrap Long Lines این رفتار رو در موتورهای پشتیبانی‌شده کنترل می‌کنه. معمولاً اسکرول افقی در موبایل شکل اصلی کد رو بهتر نگه می‌داره.

Tab Size فاصله تورفتگی تب‌ها رو تعیین می‌کنه. Starting Line Number هم می‌گه شماره‌گذاری از چه عددی شروع بشه. برای نمونه، اگه فقط خط‌های ۲۰ تا ۳۰ یک فایل رو نشون می‌دید، می‌تونید شماره شروع رو روی ۲۰ بذارید.

اضافه‌کردن عنوان و کلاس CSS دلخواه

در بخش Title می‌تونید عنوانی مثل «کد فایل functions.php» بنویسید. Additional CSS Classes هم برای اضافه‌کردن کلاس CSS دلخواه به کادر کده. اگه با CSS آشنا نیستید، بهتره این قسمت رو خالی بذارید؛ چون یک استایل اشتباه می‌تونه خوانایی کد رو خراب کنه.

اگه بعداً خواستید ظاهر کادر رو با CSS تغییر بدید، آموزش ساخت باکس اسکرول‌دار با HTML و CSS کمک می‌کنه مفهوم کادر و اسکرول رو راحت‌تر درک کنید.

بررسی پیش‌نمایش و ذخیره تنظیمات

از بخش Preview نگاهی به پیش‌نمایش تنظیمات بندازید و بعد تغییرات رو ذخیره کنید. پیش‌نمایش فقط برای بررسی اولیه‌ست. نتیجه نهایی رو داخل یک نوشته واقعی، در دسکتاپ و موبایل هم ببینید؛ چون CSS قالب ممکنه ظاهر کادر رو تغییر بده.

بررسی پیش‌نمایش و ذخیره تنظیمات
بررسی پیش‌نمایش و ذخیره تنظیمات

چطور کد رو با ویرایشگر بلوکی نمایش بدیم؟

  1. یک نوشته رو باز کنید و روی دکمه «+» بزنید.
  2. نام SyntaxHighlighter یا Code رو جست‌وجو کنید و بلوک اختصاصی افزونه رو اضافه کنید.
  3. زبان برنامه‌نویسی رو از تنظیمات بلوک انتخاب کنید.
  4. کد رو داخل بلوک بذارید و قبل از انتشار، پیش‌نمایش نوشته رو ببینید.

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

نمایش کد PHP با یک مثال ساده

بعد از اضافه‌کردن بلوک افزونه، زبان PHP رو انتخاب کنید و این نمونه رو داخلش بذارید:

PHP
<?phpecho 'سلام از وردپرس';?>

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

نمایش کد CSS با یک مثال ساده

برای نمایش CSS، زبان CSS رو انتخاب کنید و نمونه زیر رو داخل بلوک بذارید:

CSS
.mihanwp-code-box {    background: #f5f5f5;    color: #222;    padding: 16px;}

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

روش نمایش کد با شورت‌کد در ویرایشگر کلاسیک

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

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

برای PHP، کدتون رو بین برچسب باز و بسته php بذارید:

Shortcode
[php]<?phpecho 'سلام از وردپرس';?>[/php]

برای CSS هم می‌تونید از برچسب css استفاده کنید:

Shortcode
[css].mihanwp-code-box {    background: #f5f5f5;}[/css]

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

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

نکات مهم برای جلوگیری از اجراشدن یا خراب‌شدن کد

  • کد رو داخل بلوک یا شورت‌کد مخصوص همون زبان بذارید.
  • بعد از ذخیره، نوشته رو دوباره باز کنید و مطمئن بشید علامت‌های <، > و نقل‌قول‌ها تغییر نکردن.
  • کد رو اول در یک ویرایشگر متن ساده کپی کنید تا قالب‌بندی پنهان نرم‌افزارهای دیگه پاک بشه.
  • کدهای ناشناس رو روی سایت اصلی اجرا نکنید.

مشکلات رایج نمایش کد در وردپرس و راه‌حل اون‌ها

چرا رنگ‌بندی کد نمایش داده نمی‌شه؟

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

چرا بعضی کاراکترهای کد تغییر می‌کنن؟

این مشکل معمولاً وقتی پیش میاد که کد رو از نرم‌افزارهای دارای قالب‌بندی منتقل می‌کنید یا HTML رو مستقیم تغییر می‌دید. کد رو از یک ویرایشگر متن ساده منتقل کنید. بعد از ذخیره هم علامت‌های کوچک‌تر، بزرگ‌تر، نقل‌قول و براکت‌ها رو دوباره ببینید.

چرا خطوط بلند از کادر بیرون می‌زنن؟

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

چرا افزونه با قالب یا افزونه‌های دیگه تداخل داره؟

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

بلوک Code وردپرس بهتره یا SyntaxHighlighter Evolved؟

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

اگه فقط ظاهر متفاوتی برای چند قطعه‌کد می‌خواید، قبل از نصب افزونه تازه ببینید بلوک Code همراه با CSS قالب نیازتون رو برطرف می‌کنه یا نه. برای آشنایی با یک گزینه دیگه هم می‌تونید آموزش نمایش کد در وردپرس با افزونه WP-SynHighlight رو بخونید. یادتون نره قبل از نصب هر افزونه، وضعیت فعلی سازگاری و نگهداری اون رو در مخزن وردپرس ببینید.

جمع‌بندی

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

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

سؤال‌های متداول درباره نمایش کد در وردپرس

آیا برای نمایش کد حتماً باید افزونه نصب کنیم؟

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

آیا SyntaxHighlighter Evolved با ویرایشگر بلوکی کار می‌کنه؟

بله. این افزونه برای ویرایشگر بلوکی، بلوک مخصوص نمایش کد داره. بعد از فعال‌سازی، نام SyntaxHighlighter یا Code رو در فهرست بلوک‌ها جست‌وجو کنید.

چطور کد رو بدون اجراشدن داخل نوشته قرار بدیم؟

کد رو داخل بلوک Code وردپرس، بلوک اختصاصی افزونه یا شورت‌کد مربوط به زبان بذارید. بعد از ذخیره هم پیش‌نمایش نوشته رو ببینید تا مطمئن بشید کاراکترهای کد تغییر نکردن.

برای نمایش کد PHP، CSS و JavaScript چه روشی بهتره؟

برای مثال‌های کوتاه، بلوک Code وردپرس کافیه. برای آموزش‌های طولانی که به رنگ‌بندی و شماره خط نیاز دارن، بلوک SyntaxHighlighter Evolved انتخاب کاربردی‌تریه؛ البته بهتره اول سازگاری افزونه رو روی سایت آزمایشی بررسی کنید.

نظر شما در این مورد چیه؟

  1. U326419۲۳ شهریور ۱۴۰۲

    سلام با تشکر از سایت خوبتون چه جوری میتونم یک دکمه در سایتم بزارم که با کلیک روی ان متنی برای کاربر کپی بشه در کیبرد

    • رضا راد۲۷ شهریور ۱۴۰۲

      سلام سپاس. باید یا از افزونه استفاده کنید یا کد جاوا اسکریپت. به انگلیسی تو گوگل سرچ کنید کدش هست.

  2. U311467۱ اسفند ۱۴۰۰

    سلام استاد راد.سوالی از خدمت شما داشتم.من وقتی با inspect elemen مروگر کدهای html سایت رو مشاهده میکنم هیچ راهی پیدا نکردم که بتونم مسیر و فایلی که کد در آن قرار داره رو پیدا کنم که بتونم ویرایش کنم افزونه سرج در کدهای سایت رو هم امتحان کردم اما پیدا نشد.آیا راهی برای پیدا کردن این کدها وجود داره؟ممنون میشم راهنمایی بفرمایید

    • رضا راد۴ اسفند ۱۴۰۰

      سلام نه به این راحتی که نیست. کدها تو بک اند اجرا میشه و دسترسی بهشون ندارید

  3. U6594۸ مرداد ۱۳۹۶

    عالی بود خسته نباشید

  4. کاربر مهمان۷ شهریور ۱۳۹۵

    عالی بود دستت درد نکنه داداش

پشتیبانپشتیبانپشتیبانپشتیبانپشتیبان
تیم میهن وردپرس
پشتیبانپشتیبانپشتیبانپشتیبانپشتیبان
تیم میهن وردپرسآنلاین و پاسخگوی شما هستیم.آنلاین

در حال بارگذاری...

هر سوالی دارید بپرسید.پاسخگوی شما هستیم.