آموزش رفع خطای syntax error در وردپرس

در این مقاله قصد داریم بررسی کنیم که syntax error چیست و سپس با نحوه رفع خطای syntax error در وردپرس بیشتر آشنا شویم این خطا اصولا به صورت پیغام unable to parse the subtitle file syntax error at line نمایش داده می شود.

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

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

خطای syntax error در وردپرس چیست؟

ممکن است برای شما سوال پیش آید syntax error چیست ؟ به زبان ساده خطای syntax error در وردپرس زمانی رخ میدهد که شما کدی را به صورت اشتباه به سایت اضاف کردید این نوع خطا ممکن است از یک چیز ساده مانند یک کاما از دست رفته، یک براکت اضافی یا یک علامت نقل قول اشتباه رخ دهد.

مشکلات بروز خطای syntax error دروب سایت وردپرسی

• کاهش اعتبار وب سایت
• اختلال در بخش مدیریت وردپرس
• خطا در کدها

کاهش اعتبار وب سایت

ابتدا باید گفت با بروز این خطا در سایت وردپرسی و مشاهده ی آن توسط کاربران باعث به وجود آمدن کاهش اعتبار وب سایت شما می شود.

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

بروز خطای syntax error در وردپرس میتواند دسترسی شما رابه بخش مدیریت وردپرس غیر ممکن کند.

خطا در کدها

همان طور که گفتیم ارور syntax error در وردپرس ممکن است خطای نوشتاری کوچکی در کد نویسی باشد اما این خطای کوچک میتواند تاثیر زیادی بر روی وب سایت شما داشته باشد و رفع این خطا بسیار زمان بر باشد.

آموزش رفع خطای syntax error در وردپرس

وقتی با ارور syntax error در وردپرس مواجه میشید تصویری مشابه زیر در صفحات پیشخوان وردپرس و یا در کل سایت نمایش داده خواهد شد.

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

• Parse Error: این بخش از پیغام خطا نشون دهنده این هست که برخی کدها و دستورات در وردپرس به خاطر اینکه در جای خودشون قرار نگرفتن، ترتیب سایت رو به هم ریخته و باعث به وجود اومدن خطا شده که در ادامه مسیر و خط اون قطعه کد هم مشخص شده.
• Unexpected: این خطا بخاطر این نشون داده میشه که ممکنه توابعی که نشون از پایان دادن یک دستور داره را به صورت درست وارد نکردید. در زبان‌های برنامه نویسی مختلف برای انجام یک کار ساده مثل پرینت یک متن یک دستور شروع و یک دستور پایان داریم که کارهایی که باید انجام بگیره درست مثل یک حلقه بین شروع و پایان اون قطعه کد قرار میگیره که در زبان php با استفاده از کاراکترهای ; یا () مشخص میشن. حالا اگر در بین کدهای شما اشتباه تایپی رخ داده باشه یا کلا فراموش کرده باشید که شروع و پایان دستور رو بزنید این خطا داده میشه.
• آدرس فایل: در ادامه مسیری رو مشاهده می‌کنید که در اینجا مربوط به فایل فانکشن قالب(functions.php) هست که نشون میده خطا در این فایل هست و باید این فایل رو برای اصلاح قطعه دستور برنامه نویسی بررسی کنید.
• on line: و در نهایت این بخش هم مربوط به شماره خط دستور از فایلی هست که آدرس اون داده شده و با باز کردن فایل که در این مثال فایل فانکشن هست و رفتن به خط 24 میتونید کد رو بررسی و اصلاح کنید.

خب تا اینجا تونستید با استفاده از ارور Syntax Error وردپرس بدونید که منشا خطا از کجاست و تا حدودی نصفی از مسیر رو برای طی کردن مشکل برطرف کنید. حالا برای رفع مشکل باید فایلی که مسیرش مشخص شده رو باز کنید و با رفتن به شماره خط مورد نظر کدهای اون خط رو بررسی کنید. معمولا در اکثر مواقع وقتی این خطا رخ میده، دسترسی به پیشخوان وردپرس برای ویرایش رو ندارید و برای همین باید از طریق FTP یا خود هاست اقدام به ویرایش فایل بکنید.

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

بعد از اینکه به مسیری که در خطا ذکر شده مراجعه کردید فایل مورد نظر رو باز کرده و به خطی که مشخص شده خطا از اونجاست مراجعه کنید که در این مثال ما باید به مسیر wp-content/themes/twentyseventeen رفته و فایل functions.php رو با کلیک روی دکمه EDIT باز کنیم. سپس به خط 24 این کد رفته و کدهای این خط رو بررسی کنیم و ببینیم که اشکال برنامه نویسی در این خطوط چی هست و با دانشی که دارید اصلاحشون کنید.

جلوگیری از خطای syntax error در وردپرس

یکی از راه های جلوگیری از بروز این خطا این است که کد سفارشی را با افزونه قطعه کد مانند WPCode اضاف کنید.

غیرفعال کردن افزونه وردپرس

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

بعد از اینکه وارد File Manager هاست شدید به مسیر public_html/wp-content/plugins مراجعه کنید. تو این مسیر تعدادی پوشه وجود داره که هر کدوم از این پوشه‌ها مال یکی از افزونه‌ها هست. برای غیرفعال کردن هر افزونه وردپرس هم کافیه نام پوشه را تغییر بدین. حالا کافیه پوشه افزونه‌ای که بعد از نصب یا آپدیت باعث بوجود اومدن خطای syntax error وردپرس شده رو پیدا کنید و روی پوشه افزونه راست کلیک کنید. سپس نام پوشه افزونه را به اسمی دیگه تغییر بدین(مثلا با اضافه کردن یک عدد به انتهای اون). بعد از کلیک روی دکمه save نام پوشه افزونه تغییر نام پیدا کرده و غیرفعال خواهد شد. حالا مجددا نام قبلی رو برگردونید و به پیشخوان وردپرس برای بررسی افزونه یا استفاده از افزونه مشابه مراجعه کنید.

تغییر پوسته وردپرس

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

بعد از اینکه وارد File Manager هاست شدید به مسیر public_html/wp-content/themes مراجعه کنید. تو این مسیر تعدادی پوشه وجود داره که هر کدوم از این پوشه‌ها مال یکی از قالب‌ها هست. برای غیرفعال کردن قالبی که ازش استفاده میکنید کافیه نام پوشه قالب رو تغییر بدین. حالا کافیه پوشه قالب که بعد از نصب یا آپدیت باعث بوجود اومدن خطای syntax error وردپرس شده رو انتخاب کرده و روی پوشه قالب راست کلیک کنید. سپس نام پوشه قالب را به اسمی دیگه تغییر بدین(مثلا با اضافه کردن یک عدد به انتهای اون). بعد از کلیک روی دکمه save نام پوشه قالب تغییر نام پیدا کرده و غیرفعال خواهد شد. که در این حالت یکی از قالب‌های پیشفرض وردپرس در سایت فعال خواهد شد. حالا مجددا نام قبلی رو برگردونید و به پیشخوان وردپرس برای بررسی قالب مراجعه کنید.

توصیه می‌کنم که…

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

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

سپس به مسیر public_html مراجعه کرده و با راست کلیک کردن روی فایل wp-config.php و انتخاب گزینه Edit کد زیر را در قسمتی که سایر کدهای define قرار داره به این فایل اضافه کنید.

define('DISALLOW_FILE_MODS',true);

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

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

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

سوالات متداول آموزش رفع خطای syntax error در وردپرس

نتیجه گیری

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