entreprise7pro-bootstrap یه بسته npm برای کار با بوتسترپ روی سایت هایی که هنوز از jQuery استفاده می کنن. سازنده اش شرکت Entreprise 7pro و مجوزش MIT هست، یعنی توی پروژه های شخصی و تجاری آزادانه می شه ازش استفاده کرد. خلاصه اش اینه که ادامه همون خط قدیمی بوتسترپ هست، با این فرق که کدش با jQuery جدیدتر هم کار می کنه.
مشکلی که حل می کنه رو هر کسی که یه قالب قدیمی نگه داشته، یه بار باهاش روبه رو شده. بخش جاوااسکریپتی بوتسترپ قدیمی به jQuery وابسته است. وقتی jQuery رو بالا می بری، ممکنه مودال، منوی کشویی یا تب ها شروع کنن به خطا دادن. از اون طرف، بازنویسی کل قالب روی بوتسترپ جدید معمولاً کار سنگینیه، چون اسم کلاس ها و ساختار HTML فرق کرده. این بسته یه راه میانه است: کدهای فعلی رو نگه می داری و jQuery رو هم به روز می کنی.
به درد قالب های قدیمی وردپرس، پنل های مدیریتی، سایت های شرکتی و پروژه هایی می خوره که مشتری ازشون راضیه ولی توسعه دهنده اولیه دیگه در دسترس نیست. اگه پروژه ات تازه شروع شده، سراغش نرو. نسخه های جدیدتر بوتسترپ دیگه به jQuery وابسته نیستن و برای نگه داری در آینده راحت ترن. اگه سایتت راست به چپ است، استایل RTL رو خودت بررسی کن و قبل از انتشار روی چند اندازه صفحه تست بگیر.
یه نکته مهم موقع انتخاب: فقط یکی از نسخه های بوتسترپ باید توی صفحه لود بشه. اگه قالبت خودش یه نسخه داره و تو هم این بسته رو اضافه کنی، دو تا فایل با هم قاطی می شن و مشکل های عجیب پیش میاد. افزونه های جانبی که روی jQuery سوار هستن، مثل اسلایدر و دیت پیکر، هم باید با jQuery جدید سازگار باشن. پس قبل از به روزرسانی، همه چیز رو روی یه نسخه آزمایشی سایت امتحان کن.
برای سایت های ایرانی یه مزیت دیگه هم داره. وقتی اینترنت بین الملل محدود می شه، دسترسی به npm و CDN های خارجی قطع یا کند می شه. نسخه های رسمی و بدون تغییر این بسته توی مخزن داخلی ما هم هست و می تونی از روی هاست داخلی دانلودش کنی.
راهنمای استفاده
برای استفاده از entreprise7pro-bootstrap دو راه داری. اگه پروژه ات با ابزار ساخت مثل npm کار می کنه، بسته رو با همون نام entreprise7pro-bootstrap نصب کن و فایل های CSS و جاوااسکریپتش رو توی خروجی نهایی بیار. اگه سایتت ساده است، مثل بیشتر قالب های وردپرسی، کد آماده پایین همین صفحه رو به صفحه اضافه کن.
قدم ها به ترتیب اینه:
- اول از سایت یا قالبت بکاپ بگیر و بهتره کار رو روی نسخه تست انجام بدی.
- ببین الان چه نسخه ای از بوتسترپ لود می شه و اون رو حذف یا غیرفعال کن. دو نسخه همزمان نباید باشن.
- فایل CSS این بسته رو توی بخش head صفحه بذار.
- jQuery رو قبل از فایل جاوااسکریپت بوتسترپ لود کن، چون ترتیب مهمه.
- فایل جاوااسکریپت این بسته رو آخر صفحه، قبل از بستن body، اضافه کن.
- کش مرورگر و کش سایت رو پاک کن، بعدش مودال ها، منوها، تب ها و فرم ها رو یکی یکی امتحان کن.
اگه توی کنسول مرورگر خطا دیدی، اول مطمئن شو jQuery درست لود شده. خیلی وقت ها مشکل از تکراری بودن فایل ها یا ترتیب اشتباه لود هست، نه از خود بسته.