نام درست فایل functions.php است، نه function.php. این فایلِ پوسته فعال می‌تواند رفتار وردپرس را گسترش دهد، اما هر قطعه کدی الزاماً به آن تعلق ندارد. تغییرات وابسته به ظاهر در پوسته فرزند و قابلیت مستقل از پوسته در افزونه اختصاصیِ قابل نگهداری، معمولاً مرز روشن‌تری دارند. پیش از کپی کد، هدف، منبع و راه بازگشت را مشخص کنید.
کجا کد را قرار دهیم؟
| نوع تغییر | محل قابل بررسی |
|---|---|
| رفتار مخصوص ظاهر پوسته | پوسته فرزند سازگار |
| قابلیت مستقل از تغییر پوسته | افزونه اختصاصی |
| چند خط CSS | مسیر CSS یا تنظیم سفارشی مناسب |
| تغییر هسته وردپرس | از ویرایش مستقیم اجتناب کنید و hook مناسب را بیابید |
پیش‌نیازهای ویرایش
- از فایل و دیتابیس مرتبط بکاپ قابل بازگردانی بگیرید.
- کپی آزمایشی و دسترسی SFTP یا پنل فایل مستقل از پیشخوان آماده کنید.
- نسخه PHP و وردپرس موردنیاز کد و وابستگی آن را بخوانید.
- مطمئن شوید نام تابع یا کلاس با کد موجود تکراری نیست.
- هر بار یک تغییر کوچک اعمال کنید و diff را بررسی کنید.
خطاهای رایج هنگام چسباندن کد
داخل بخشی که PHP از قبل باز است، تگ آغاز <?php را دوباره نگذارید. علامت‌های نقل‌قول تزئینی، کاراکتر نامرئی، پرانتز ناقص و کپی علامت $ اعلان ترمینال می‌توانند کد را خراب کنند. در فایل خالص PHP، تگ پایانی معمولاً لازم نیست. کدی که در init کاربر مدیر می‌سازد یا اختیار نامحدود می‌دهد، قطعه معمولی سفارشی‌سازی محسوب نمی‌شود.
آزمون و برگشت
با مفسر سازگار می‌توان syntax را پیش از بارگذاری بررسی کرد. مسیر زیر نمونه است و باید فایل واقعیِ همان کپی را هدف بگیرد.
php -l /path/to/child-theme/functions.phpاین آزمون فقط syntax را بررسی می‌کند، نه سازگاری runtime یا امنیت. پس از بارگذاری، صفحه عمومی، پیشخوان و رفتار خاص کد را کنترل کنید. اگر سایت قطع شد، از مسیر مستقل فایل سالم را برگردانید و خطای دقیق را از لاگ بخوانید؛ افزودن کدهای بیشتر روی فایل خراب تشخیص را سخت‌تر می‌کند.
به‌روزرسانی و نگهداری
ویرایش پوسته والد ممکن است با آپدیت از بین برود. functions.php پوسته فرزند نیز جایگزین فایل والد نیست و هر دو می‌توانند بارگذاری شوند؛ تعریف تکراری تابع می‌تواند fatal بسازد. نام‌گذاری اختصاصی، hook مناسب و ثبت دلیل تغییر به نگهداری کمک می‌کند. رازها و کلیدهای دسترسی را داخل این فایل عمومی پروژه قرار ندهید.
مطالعه مرتبط
منابع و مستندات
بازبینی محتوا و منابع: ۲۶ مهر ۱۴۰۵. دستورهای نمونه برای محیط مشخص‌شده‌اند؛ پیش از استفاده روی سرویس عملیاتی، سازگاری محیط و نسخه پشتیبان را بررسی کنید.
