آموزش افزونه ویرایش قالب وردپرس؛ نکات ایمنی و رفع خطا

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

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

پیشنهاد میهن وردپرس اینه که از افزونه WP Editor استفاده نکنید. طبق اطلاعاتی که در زمان بررسی صفحه افزونه دیده شده، حدود هفت ماه از آخرین به‌روزرسانی اون می‌گذره و اطلاعات سازگاری نمایش‌داده‌شده هم قدیمیه. این افزونه روی سایتی با PHP 8.2 هنگام فعال‌سازی با پیام «به‌دلیل داشتن مشکلی جدی افزونه فعال نشد» روبه‌رو شده. این تجربه به‌تنهایی ثابت نمی‌کنه که افزونه روی همه نسخه‌های بالاتر از PHP 6 فعال نمی‌شه؛ برای مشخص‌شدن علت قطعی باید Error Log یا همون گزارش خطای سرور بررسی بشه. بااین‌حال، این نشونه‌ها برای استفاده‌نکردن از افزونه روی سایت اصلی کافی هستن.

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

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

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

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

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

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

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

بهتره تغییر رو اول در محیط آزمایشی یا Staging انجام بدید. محیط آزمایشی یک نسخه جدا از سایت اصلیه که بازدیدکننده‌ها اون رو نمی‌بینن. این محیط بهتون فرصت می‌ده نتیجه کد رو بدون به‌خطرانداختن سایت اصلی بررسی کنید.

برای تغییر فایل‌های قالب، از پوسته فرزند استفاده کنید. پوسته فرزند قالب کوچیکی هست که تغییرهای شما رو جدا از قالب اصلی نگه می‌داره. بعضی فایل‌های اون می‌تونن جای نسخه مشابه در قالب اصلی رو بگیرن؛ ولی این رفتار برای همه فایل‌ها یکسان نیست. برای نمونه، فایل functions.php پوسته فرزند جای فایل functions.php قالب اصلی رو نمی‌گیره و هر دو فایل بارگذاری می‌شن.

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

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

نصب و فعال‌کردن افزونه WP Editor

1. از پیشخوان وردپرس وارد «افزونه‌ها ← افزودن افزونه تازه» بشید.
2. عبارت «WP Editor» رو در کادر جست‌وجو وارد کنید و نام و سازنده افزونه رو با صفحه رسمی اون تطبیق بدید.
3. روی دکمه نصب و بعد دکمه فعال‌سازی کلیک کنید.
4. اگه افزونه بدون خطا فعال شد، منوی WP Editor یا بخش تنظیمات مربوط به اون رو از پیشخوان باز کنید.

اگه پیام «به‌دلیل داشتن مشکلی جدی افزونه فعال نشد» رو دیدید، ادامه ندید. این پیام یعنی هنگام فعال‌سازی یک خطای PHP رخ داده. نسخه وردپرس و PHP رو از «ابزارها ← سلامت سایت ← اطلاعات» بررسی کنید و گزارش Error Log هاست رو ببینید. Error Log همون گزارشی هست که نام فایل و جزئیات خطا رو ثبت می‌کنه. بدون متن کامل خطا نمی‌شه علت رو با اطمینان مشخص کرد.

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

آشنایی با امکانات WP Editor

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

• مرورگر AJAX برای بازکردن و جابه‌جاشدن بین فایل‌ها معرفی شده.
• ابزار جست‌وجو و جایگزینی برای پیدا کردن عبارت‌های تکراری داخل کد معرفی شده.
• Nivo Lightbox در فهرست قابلیت‌های افزونه اومده، ولی کاربرد دقیق اون در نسخه فعلی باید بررسی بشه.
• شماره خط کمک می‌کنه خط مشخصی از کد رو سریع پیدا کنید.
• اندازه فونت، ارتفاع ویرایشگر و میزان تورفتگی ممکنه از تنظیمات افزونه قابل‌تغییر باشن.
• طبق توضیحات افزونه، می‌تونید پسوند فایل‌های قابل‌ویرایش رو مشخص کنید.

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

تنظیم افزونه WP Editor برای شروع کار

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

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

تنظیمات ویرایشگر قالب

در بخش Theme Editor ممکنه گزینه‌هایی برای تغییر ظاهر و رفتار ویرایشگر قالب ببینید. گزینه Theme ظاهر رنگی محیط کد رو عوض می‌کنه. Font Size اندازه نوشته‌ها و Editor Height ارتفاع کادر ویرایش رو مشخص می‌کنن.

Line Numbers شماره خط‌ها رو نشون می‌ده. Line Wrapping هم خط‌های طولانی رو داخل عرض ویرایشگر می‌شکنه تا مجبور نشید صفحه رو افقی جابه‌جا کنید. Active Line Highlighting خطی رو که روی اون کار می‌کنید برجسته می‌کنه.

Indent Size و Tab Size فاصله تورفتگی کد رو کنترل می‌کنن. این فاصله روی اجرای بیشتر کدهای PHP اثر مستقیم نداره، ولی مرتب‌بودن کد باعث می‌شه ساختار اون رو راحت‌تر بفهمید و احتمال اشتباه کمتر بشه.

گزینه Extensions پسوندهای قابل‌ویرایش رو مشخص می‌کنه. پسوند نام بخش پایانی فایل، مثل PHP،‏ CSS یا JS هست. پسوندی رو اضافه نکنید، مگر اینکه دقیقاً بدونید اون فایل چه کاری انجام می‌ده.

تنظیمات ویرایشگر افزونه

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

تنظیمات ویرایشگر نوشته و محدودیتش در ویرایشگر بلوکی

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

ویرایش فایل‌های قالب وردپرس با WP Editor

1. اول مطمئن بشید نسخه پشتیبان سالم و راه دسترسی به فایل‌منیجر هاست رو دارید.
2. ویرایشگر پوسته رو از پیشخوان باز کنید. محل دقیق اون به نوع قالب، نسخه وردپرس، سطح دسترسی و تنظیمات سایتتون بستگی داره.
3. قالب موردنظر و بعد فایل موردنظر رو از فهرست انتخاب کنید.
4. قبل از ویرایش، یک کپی از محتوای فعلی فایل نگه دارید.
5. فقط تغییر محدود و لازم رو انجام بدید و کد رو دوباره بررسی کنید.
6. تغییر رو ذخیره کنید و صفحه‌های اصلی سایت، پیشخوان و فرم‌های مهم رو آزمایش کنید.

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

کدوم فایل‌های قالب رو نباید بدون شناخت تغییر بدید؟

فایل functions.php حساسه، چون وردپرس اون رو هنگام اجرای سایت بارگذاری می‌کنه و یک خطای PHP داخلش می‌تونه کل سایت رو از دسترس خارج کنه. فایل‌های header.php،‏ footer.php،‏ index.php و فایل‌های قالب صفحه هم ساختار بخش‌های مهم سایت رو کنترل می‌کنن.

اگه نمی‌دونید یک فایل چه نقشی داره، اون رو تغییر ندید. فایل style.css برای تغییرهای محدود ظاهری قابل‌فهم‌تره، ولی حتی کد CSS اشتباه هم می‌تونه چیدمان سایت رو به‌هم بریزه.

چطور تغییرهای قالب رو با پوسته فرزند نگه دارید؟

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

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

ویرایش فایل‌های افزونه وردپرس با WP Editor

1. از بخش مربوط به افزونه‌ها، ویرایشگر افزونه رو باز کنید.
2. افزونه موردنظر رو از فهرست انتخاب کنید.
3. فایل مناسب رو باز کنید و قبل از تغییر، یک کپی از نسخه فعلی اون داشته باشید.
4. با ابزار جست‌وجو عبارت موردنظر رو پیدا کنید و فقط همون بخش لازم رو تغییر بدید.
5. کد رو ذخیره کنید و عملکرد افزونه، پیشخوان و صفحه‌های مرتبط رو بررسی کنید.

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

چرا ویرایش مستقیم افزونه معمولاً انتخاب خوبی نیست؟

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

چطور جلوی پاک‌شدن تغییرها بعد از به‌روزرسانی رو بگیرید؟

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

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

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

مسیر ویرایشگرها در قالب‌های کلاسیک

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

مسیر ویرایشگرها در قالب‌های بلوکی

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

چرا ممکنه ویرایشگر فایل رو در پیشخوان نبینید؟

مدیر سایت یا شرکت هاستینگ می‌تونه ویرایش فایل رو غیرفعال کنه. افزونه امنیتی، تنظیمات شبکه چندسایته، سطح دسترسی حساب کاربری یا ثابت DISALLOW_FILE_EDIT هم ممکنه این گزینه رو پنهان کنه. اگه مدیر سایت نیستید، احتمالاً اجازه لازم برای ویرایش فایل‌ها رو ندارید.

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

اگه بعد از ویرایش سایت خراب شد، چه کار کنید؟

1. پیام خطا و ایمیل حالت بازیابی وردپرس رو بررسی کنید. اگه هنوز به ویرایشگر دسترسی دارید، آخرین تغییر رو برگردونید.
2. اگه پیشخوان باز نمی‌شه، از SFTP،‏ SSH یا فایل‌منیجر هاست فایل تغییرکرده رو با نسخه سالم جایگزین کنید.
3. اگه فعال‌سازی یک افزونه باعث خطا شده، پوشه همون افزونه رو از راه فایل‌منیجر تغییر نام بدید تا وردپرس بتونه اون رو غیرفعال کنه.
4. اگه فایل سالم ندارید، آخرین نسخه پشتیبان سالم رو بازیابی کنید.
5. گزارش خطای PHP یا Error Log هاست رو بررسی کنید تا نام فایل، نوع خطا و شماره خط مشکل‌دار رو پیدا کنید.
6. بعد از برگشت سایت، صفحه‌های مهم و عملکرد بخشی رو که تغییر داده بودید دوباره آزمایش کنید.

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

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

غیرفعال‌کردن ویرایش فایل از پیشخوان وردپرس

برای غیرفعال‌کردن ویرایشگر فایل می‌تونید ثابت DISALLOW_FILE_EDIT رو در فایل wp-config.php فعال کنید. ثابت یعنی یک تنظیم داخل کد که مقدار اون هنگام اجرای وردپرس عوض نمی‌شه.

define( 'DISALLOW_FILE_EDIT', true );

این کد رو قبل از خط پایانی ویرایش در فایل wp-config.php قرار بدید. قبل از تغییر این فایل حتماً نسخه پشتیبان بگیرید، چون اشتباه داخل اون می‌تونه اتصال یا اجرای وردپرس رو مختل کنه.

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

جایگزین‌های امن‌تر برای ویرایش قالب و افزونه

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

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

جمع‌بندی: آیا WP Editor برای شما مناسبه؟

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

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

سؤال‌های رایج درباره افزونه ویرایش قالب وردپرس

تیم تولید محتوا

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