@teddy-digital/frontend یه بسته npm برای فرانت اند قالب های شاپیفای هست. توضیح رسمی منبعش خیلی کوتاهه و فقط نوشته «Utility js per temi ict shopify»، یعنی ابزارهای کمکی جاوااسکریپت برای قالب های شاپیفای. از قابلیت های تک تک بخش ها حرفی نزده، برای همین ما هم چیزی از خودمون بهش نسبت نمی دیم.
بسته هایی از این جنس معمولاً برای اینه که توی هر قالب مجبور نشی همون اسکریپت های کوچیک و تکراری رو از نو بنویسی یا از یه پروژه به پروژه دیگه کپی کنی. اگه تیمت چند قالب شاپیفای داره، یه بسته مشترک نگهداری و به روزرسانی کدها رو راحت تر می کنه. ولی این فقط برداشت کلی از نوع بسته هست، نه توضیح محتوای همین بسته. قبل از تصمیم گرفتن باید خودت ببینی داخلش واقعاً چی هست.
مخاطب اصلیش توسعه دهنده هایی هستن که روی قالب شاپیفای کار می کنن و با npm و باندل کردن جاوااسکریپت راحتن. اگه سایتت وردپرسیه، به احتمال زیاد این بسته به کارت نمیاد، چون برای قالب های شاپیفای نوشته شده. فریم ورک CSS یا کیت رابط کاربری آماده هم نیست، حداقل توی توضیح رسمی چیزی نیست که این رو نشون بده. پس اگه دنبال دکمه و گرید و کامپوننت ظاهری می گردی، سراغ یه فریم ورک CSS برو.
موقع انتخاب چهار چیز رو یادت باشه. اول، چون توضیح منبع کمه، قبل از استفاده سورس بسته و فایل راهنماش رو بخون و ببین دقیقاً چی ازش در میاد. دوم، اول توی یه قالب آزمایشی تستش کن و بعد برو سراغ سایت اصلی. سوم، مجوز ISC خیلی آزاده و استفاده تجاری رو هم اجازه می ده، فقط متن مجوز و نام سازنده باید کنار کد بمونه. چهارم، نسخه بسته رو توی package.json ثابت نگه دار تا یه به روزرسانی ناخواسته رفتار قالبت رو عوض نکنه.
توی روزهایی که دسترسی به اینترنت بین الملل محدوده هم مشکلی نداری. نسخه های رسمی و بدون تغییر این بسته توی مخزن داخلی ما هم هست و می تونی از همون جا بگیریش.
راهنمای استفاده
اگه با npm کار می کنی، ساده ترین راه اینه که بسته رو از داخل پوشه پروژه قالبت نصب کنی:
- توی ترمینال، داخل پوشه پروژه این دستور رو بزن: npm install @teddy-digital/frontend
- بعد از نصب، پوشه بسته رو توی node_modules باز کن و فایل راهنما و فایل های اصلی رو بخون تا بدونی چه چیزهایی ازش می شه وارد کرد.
- بسته رو توی فایل جاوااسکریپت قالبت وارد کن و با باندلری که توی پروژه داری خروجی نهایی رو بساز.
- فایل ساخته شده رو توی پوشه assets قالب شاپیفای بذار و توی فایل layout قالب بهش لینک بده.
اگه نمی خوای با npm و باندل کار کنی، پایین همین صفحه یه کد آماده برای اضافه کردن بسته به صفحه هست. اون رو توی قالب بذار و بعدش توی کنسول مرورگر چک کن که بدون خطا لود می شه.
قبل از انتشار روی فروشگاه اصلی، حتماً روی یه قالب کپی یا محیط آزمایشی تست کن. اگه جایی خطا دیدی، اول کنسول مرورگر رو نگاه کن و ببین ترتیب لود فایل ها درسته یا نه. یادت نره قبل از هر تغییری از قالب فعلی یه نسخه پشتیبان بگیری.