راهنمای افزونه فروشگاه آنلاین

۱پیش از شروع — این بخش را حتماً بخوانید

این چند نکته، پاسخ بیشتر سؤال‌های رایج را روشن می‌کند.

سایت فروشگاه شما اطلاعات را داخل خودش نگه نمی‌دارد. همه اطلاعات به‌صورت آنلاین از سرور دریافت می‌شود:

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

برای نصب به چه چیزهایی نیاز دارید؟

• هاست با PHP نسخه ۷.۴ یا بالاتر (نسخه ۸.۳ هم تست شده است)
• فعال بودن افزونه cURL روی هاست (معمولاً فعال است)
• دامنه‌ای که در اپلیکیشن مدیریت فروشگاه ثبت شده باشد
• دسترسی به File Manager هاست یا یک برنامه FTP

۲نصب مرحله‌به‌مرحله

1. فایل‌ها را بارگذاری کنید. محتوای پوشه را در ریشه سایت قرار دهید؛ این مسیر معمولاً public_html است. دقت کنید index.php باید مستقیم داخل public_html باشد، نه داخل یک پوشه اضافه.
2. دامنه را بررسی کنید. سایت دامنه خودش را به‌صورت خودکار تشخیص می‌دهد و لازم نیست آن را جایی وارد کنید. همان دامنه باید در اپلیکیشن مدیریت فروشگاه ثبت شده باشد.
3. پوشه cache را بسازید و دسترسی آن را تنظیم کنید. اگر این پوشه به‌صورت خودکار ساخته نشد، آن را دستی بسازید و سطح دسترسی را روی 755 بگذارید؛ در صورت نیاز از 775 استفاده کنید.
   مهم: اگر این پوشه قابل نوشتن نباشد، سایت کند می‌شود؛ چون در هر بار نمایش، مجبور است اطلاعات را دوباره از سرور دریافت کند.
4. فایل .htaccess را بررسی کنید. این فایل مخفی است؛ در File Manager گزینه «نمایش فایل‌های مخفی» را فعال کنید. اگر آدرس‌هایی مثل /product/12/ باز نشدند و خطای ۴۰۴ دیدید، یعنی mod_rewrite فعال نیست. از پشتیبانی هاست بخواهید آن را فعال کند.
5. سایت را باز کنید. اگر همه‌چیز درست باشد، صفحه اصلی همراه با کالاهای شما نمایش داده می‌شود.

نصب در زیرشاخه

اگر فروشگاه را داخل یک زیرشاخه نصب کرده‌اید؛ مثلاً example.com/shop/، این خط را در فایل .htaccess از حالت توضیح خارج کنید:

RewriteBase /shop/

اگر هاست شما از nginx استفاده می‌کند

فایل .htaccess روی nginx اجرا نمی‌شود. برای این نوع هاست، مسیرهای زیر را به تنظیمات nginx اضافه کنید:

location = /api.php           { rewrite ^ /core/api.php           last; }
location = /suggest.php       { rewrite ^ /core/suggest.php       last; }
location = /products.php      { rewrite ^ /core/products.php      last; }
location = /validate_cart.php { rewrite ^ /core/validate_cart.php last; }
location = /logo.php          { rewrite ^ /core/logo.php          last; }
location = /manifest.php      { rewrite ^ /core/manifest.php      last; }
location = /robots.txt        { rewrite ^ /core/robots.php        last; }
location = /sitemap.xml       { rewrite ^ /core/sitemap.php       last; }
location ~ ^/(cache|inc|pages)/ { deny all; }
location / { try_files $uri $uri/ /index.php?$query_string; }

۳ساختار فایل‌ها — هر فایل چه کاری انجام می‌دهد؟

در ریشه سایت فقط فایل‌هایی قرار گرفته‌اند که ممکن است لازم باشد آن‌ها را ویرایش کنید.

۴تنظیمات config.php

این‌ها تنظیماتی هستند که احتمالاً بیشتر از بقیه به آن‌ها نیاز پیدا می‌کنید:

۵صفحه لودینگ — loading.php

این همان بخشی است که تا زمان آماده‌شدن سایت به کاربر نشان داده می‌شود.

فایل loading.php در ریشه سایت قرار دارد و می‌توانید ظاهر آن را تغییر دهید. متغیرهای زیر داخل این فایل در دسترس هستند:

مثال: نمایش یک متن ساده

<div id="appLoader" class="app-loader">
  <p style="font-weight:700"><?= htmlspecialchars($loaderName) ?></p>
  <p>لطفاً چند لحظه صبر کنید…</p>
</div>

اگر نمی‌خواهید لودینگ نمایش داده شود، محتوای فایل را به یک div خالی با همان id تبدیل کنید.

۶رنگ و قالب سایت

بعد از تغییر رنگ، ظاهر سایت عوض نشده؟

1. چند دقیقه صبر کنید؛ به‌اندازه مقدار PAGE_CACHE_TTL.
2. اگر تغییری ندیدید، پوشه cache را خالی کنید؛ فقط فایل‌های داخل آن را پاک کنید و خود پوشه را نگه دارید.
3. در مرورگر Ctrl + Shift + R بزنید تا کش مرورگر هم نادیده گرفته شود.

رنگ متن دکمه‌ها خودکار تنظیم می‌شود

اگر رنگ روشنی مثل زرد انتخاب کنید، متن دکمه‌ها خودکار تیره می‌شود؛ اگر رنگ اصلی تیره باشد، متن دکمه‌ها سفید می‌شود. لازم نیست تنظیم جداگانه‌ای انجام دهید.

حالت شب

سایت دکمه روشن/تاریک دارد و انتخاب کاربر را ذخیره می‌کند. برای تغییر رنگ‌های حالت شب، آرایهٔ $GLOBALS['THEME_DARK'] در theme.php را ویرایش کنید.

۷تغییر فونت

فونت پیش‌فرض سایت ایران‌یکان‌ایکس است.

روش ۱ — استفاده از فونت دلخواه

1. فایل فونت را با فرمت woff2 آماده کنید؛ بهتر است سه وزن نازک، معمولی و ضخیم داشته باشد.
2. فایل‌های فونت را داخل پوشه assets/fonts/ قرار دهید.
3. فایل assets/css/style.css را باز کنید. خط‌های ۶ تا ۸ مربوط به تعریف فونت هستند:

   @font-face{
     font-family:'IRANYekanX';
     src:url('/assets/fonts/IRANYekanX-Light.woff2') format('woff2');
     font-weight:300;
     font-display:swap;
   }

   نام فایل‌ها را با نام فونت‌های خودتان جایگزین کنید. هر خط مربوط به یک وزن است: ۳۰۰، ۵۰۰ و ۷۰۰.
4. اگر نام خانواده فونت را هم تغییر دادید، در همان فایل مقدار font-family را در قانون body به نام تازه تغییر دهید.
5. ذخیره کنید و در مرورگر Ctrl + Shift + R بزنید.

روش ۲ — تغییر اندازه فونت

در فایل style.css قانون body را پیدا کنید و مقدار font-size را تغییر دهید. سایر بخش‌های سایت نسبی تنظیم شده‌اند و با این تغییر هماهنگ می‌شوند.

۸اندازه تصاویر و کارت‌ها

همه این تنظیمات از theme.php انجام می‌شود و نیازی به ویرایش CSS نیست.

در فایل theme.php آرایه $GLOBALS['THEME_SIZES'] را پیدا کنید:

$GLOBALS['THEME_SIZES'] = array(
    'maxw'     => '1120px',  // بیشترین عرض کل صفحه
    'radius'   => '12px',    // میزان گردی گوشه‌ها
    'card-w'   => '158px',   // عرض کارت کالا
    'card-img' => '158px',   // ارتفاع تصویر روی کارت
    'logo'     => '52px',    // اندازه لوگو در سربرگ
);

۹لوگو و آیکن سایت

لوگو

لوگو از اپلیکیشن مدیریت فروشگاه دریافت می‌شود. اگر لوگویی ثبت نکرده باشید، سایت از مقدار LOGO_URL در فایل config.php استفاده می‌کند.

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

Favicon (آیکن کنار نام سایت در تب مرورگر)

فایل favicon.ico را در ریشه سایت با آیکن دلخواه خودتان جایگزین کنید. اندازه پیشنهادی ۳۲×۳۲ پیکسل است.

۱۰کش و سرعت سایت

کش یعنی سایت نسخه آماده اطلاعات را نگه می‌دارد تا دفعات بعد سریع‌تر نمایش داده شود.

تغییر داده‌ام، اما روی سایت دیده نمی‌شود!

در بیشتر موارد، دلیلش کش است. این کارها را به‌ترتیب انجام دهید:

1. چند دقیقه صبر کنید.
2. فایل‌های داخل پوشه cache را پاک کنید، اما خود پوشه را نگه دارید.
3. در مرورگر Ctrl + Shift + R بزنید.
4. اگر هنوز نسخه قبلی را می‌بینید، سایت را در حالت ناشناس (Incognito) باز کنید تا مشخص شود مشکل از کش مرورگر است یا از سرور.

تنظیم تعادل بین «سرعت» و «به‌روز بودن»

سایت کند است

• مطمئن شوید پوشه cache قابل نوشتن است؛ این مهم‌ترین عامل سرعت است.
• تصاویر کالاها را پیش از آپلود فشرده کنید.
• اگر تعداد کالاها زیاد است، مقدار PAGE_SIZE را کمتر کنید؛ مثلاً ۲۴.

۱۱پرداخت، دامنه و SSL

درگاه پرداخت

تنظیمات اصلی درگاه، مثل نوع درگاه بانکی و کلیدها، از داخل اپلیکیشن مدیریت فروشگاه انجام می‌شود.

SSL و https

سایت فروشگاهی باید حتماً https داشته باشد. بیشتر هاست‌ها گواهی رایگان Let's Encrypt ارائه می‌کنند؛ آن را از پنل هاست فعال کنید. بدون SSL، مرورگرها به کاربر هشدار «ناامن» نشان می‌دهند و ممکن است درگاه پرداخت هم درست کار نکند.

تغییر دامنه

اگر دامنه سایت را تغییر دادید، دامنه جدید را در اپلیکیشن مدیریت فروشگاه هم به‌روز کنید؛ در غیر این صورت سایت پیام «فروشگاه یافت نشد» نمایش می‌دهد.

۱۲پرسش‌های متداول

پاسخ کوتاه به سؤال‌هایی که بیشتر پرسیده می‌شوند.