شروع کار با قلاب ها

در قسمت منوی همیار تولز » قلاب‌ها (Hooks) شما این امکان را خواهید داشت تا کدهای PHP اختصاصی خود را بدون نگرانی از پاک شدن در هر بروزرسانی قرار دهید. قلاب‌ها در واقع کدهای PHP هستند که به شما این قابلیت را خواهند داد تا بدون کوچک‌ترین تغییری در کدهای اصلی افزونه، قسمتی از عملکرد افزونه را تغییر دهید.

نیاز به قلاب جدیدی دارم که وجود ندارد!

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

قلاب ها چطور کار میکنند؟

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

تفاوت filter و action چیست؟

اینکه دقیقا از کدام استفاده کنید در قسمت راهنمای هر قلاب درج شده اما بطور کلی زمانی که قرار باشد یک عملیات جدید به افزونه اضافه شود باید از action و زمانی که قرار است قسمتی از داده‌ها، در افزونه return تغییر کند از filter استفاده میشود.

اگر خطایی در کدهای من رخ داد چه اتفاقی میفتد؟

کدهایی که از قسمت همیار تولز » قلاب‌ها (Hooks) به افزونهه اضافه کنید تاثیری در عملکرد کلی سایت نخواهد گذاشت. افزونه سعی میکند خطا را به شما نمایش دهد اما هیچ خطایی موجب از دسترس خارج شدن سایت شما نخواهد شد.

درصورتی که قلابی تنظیم کردید و با خطای php روبرو شدید کافیست محتویات فایل custom-hooks.php رو در مسیر /hamyar-tools/includes/hooks به کلی یا کدی که باعث بروز خطا شده است را حذف کنید.

ساختار قرار گیری کدها

برای قرار دادن کدها باید توجه داشته باشید که حتما تگ php باز شده باشد و در ادامه کدهای خود را قرار دهید:

نکته ۱: بستن تگ php الزامی نیست.

نکته ۲: درصورتی که خطایی در کدهای شما وجود داشته باشد در سایت شما نمایش داده میشود.