دليل استخدام ثيم شَهِيShahi theme user guide

شَهِي هو ثيم عصري لمنصة سلة، مصمّم خصيصًا للمتاجر التي تبيع المنتجات الغذائية ومنتجات العسل والتمور والمأكولات الطبيعية.

يركّز الثيم على إبراز صور المنتجات بشكل جذاب، ويمنح التاجر صفحة رئيسية مرنة يمكن تركيبها من مكوّنات جاهزة متعددة دون الحاجة لأي برمجة.

أبرز ما يميّز الثيم:

• صفحة رئيسية قابلة للتركيب من 12 قسمًا مخصّصًا إضافةً إلى أقسام سلة الجاهزة.
• قائمة ميجا مينو (Mega Menu) لعرض التصنيفات بشكل موسّع.
• مسار التنقل (Breadcrumb) في الصفحات الداخلية.
• تحكّم كامل بالألوان الأساسية والفرعية وألوان الهيدر والفوتر.
• إمكانية تغيير خطوط المتجر من لوحة التحكم.
• تصميم متجاوب بالكامل مع الجوال والتابلت وسطح المكتب.
• دعم كامل للغة العربية واتجاه RTL، مع ملف ترجمة إنجليزي جاهز (LTR).
• صفحات متكاملة: المنتج، التصنيفات، الماركات، المدونة، السلة، حساب العميل، الولاء، صفحات الهبوط.

Shahi is a modern Salla theme built specifically for stores selling food, honey, dates and natural products.

The theme is designed to make product photography the centre of attention, and gives merchants a flexible homepage that can be assembled from ready-made sections with no coding required.

Key features:

• A homepage assembled from 12 custom sections plus Salla's built-in sections.
• Mega menu navigation for browsing categories.
• Breadcrumb navigation on inner pages.
• Full control over primary, secondary, header and footer colours.
• Store fonts configurable from the dashboard.
• Fully responsive across mobile, tablet and desktop.
• Complete Arabic RTL support, with a ready English (LTR) translation file.
• Complete page set: product, category, brands, blog, cart, customer account, loyalty and landing pages.

1. ادخل إلى لوحة تحكم متجرك على سلة.
2. من القائمة العلوية اختر المتجر وقنوات البيع ← متجر الثيمات.
3. ابحث عن ثيم شَهِي ثم اضغط تركيب الثيم.
4. بعد اكتمال التركيب انتقل إلى تصميم المتجر ← ستجد تنسيقًا جديدًا باسم الثيم.
5. اضغط تعديل لبدء التخصيص، أو نشر لتفعيل الثيم مباشرةً على المتجر.

1. Open your store dashboard on Salla.
2. From the top menu choose Store & Sales Channels → Theme Store.
3. Find the Shahi theme and click Install.
4. Once installed, go to Store Design — a new layout will appear under the theme name.
5. Click Edit to start customising, or Publish to make the theme live.

للوصول إليها: تصميم المتجر ← اختر تنسيق شَهِي ← تعديل ← إعدادات الثيم.

خيارات slider_background_size:

• Contain — إظهار الصورة كاملةً في المنتصف دون قصّ. مناسب للمنتجات ذات الخلفية البيضاء أو الشفافة.
• Cover — تغطية الصورة لكامل المساحة مع المحافظة على نسبة الصورة. قد يتم قصّ أطراف الصورة.

Path: Store Design → select the Shahi layout → Edit → Theme settings.

slider_background_size options:

• Contain — shows the whole image centred, never cropped. Best for products on a white or transparent background.
• Cover — fills the whole area while preserving the aspect ratio. Edges of the image may be cropped.

الألوان

• اللون الأساسي يُضبط من إعدادات سلة العامة: تصميم المتجر ← الألوان.
• اللون الفرعي وألوان الهيدر والفوتر تُضبط من إعدادات الثيم كما في الجدول أعلاه.

اختر ألوانًا ذات تباين كافٍ بين النص والخلفية لضمان وضوح القراءة على جميع الأجهزة.

الخطوط

يدعم الثيم خاصية الخطوط (fonts) من سلة. لتغيير الخط:

تصميم المتجر ← الخطوط ← اختر خط العناوين وخط النصوص.

Colours

• The primary colour is set in Salla's global settings: Store Design → Colours.
• The secondary, header and footer colours are set in Theme settings (see the table above).

Choose colours with enough contrast between text and background so content stays legible on every device.

Fonts

The theme supports Salla's fonts feature. To change the font:

Store Design → Fonts → choose a heading font and a body font.

الصفحة الرئيسية في ثيم شَهِي مبنية من أقسام (Components) يمكنك ترتيبها وإضافتها وحذفها بحرية.

الخطوات:

1. تصميم المتجر ← اختر تنسيق شَهِي ← تعديل.
2. ستظهر لك الصفحة الرئيسية مع قائمة الأقسام الحالية.
3. اضغط إضافة قسم واختر القسم المطلوب من القائمة.
4. عبّئ حقول القسم (العناوين، الصور، المنتجات...).
5. اسحب الأقسام لإعادة ترتيبها حسب الأولوية.
6. اضغط حفظ ثم نشر.

ترتيب مقترح لمتجر أغذية:

1. صور متحركة (سلايدر)      ← بنر ترويجي رئيسي
2. مميزات المتجر            ← الشحن، الدفع، الضمان
3. روابط سريعة              ← اختصارات لأهم التصنيفات
4. منتجات مختارة            ← الأكثر مبيعًا
5. صور مربعة (محسنة)        ← عروض موسمية
6. منتجات التصنيف           ← عسل / تمور / مكسرات
7. القسم الترويجي مع العد التنازلي ← عرض محدود بوقت
8. الماركات التجارية
9. المدونة
10. انستقرام

The Shahi homepage is built from sections (components) that you can add, reorder and remove freely.

Steps:

1. Store Design → select the Shahi layout → Edit.
2. The homepage appears with its current list of sections.
3. Click Add section and pick the section you want.
4. Fill in the section fields (titles, images, products…).
5. Drag sections to reorder them.
6. Click Save, then Publish.

Suggested order for a food store:

1.  Image slider              ← main promotional banner
2.  Store features            ← shipping, payment, guarantee
3.  Quick links               ← shortcuts to key categories
4.  Featured products         ← best sellers
5.  Enhanced square banners   ← seasonal offers
6.  Category products         ← honey / dates / nuts
7.  Promo with countdown      ← limited-time offer
8.  Brands
9.  Blog
10. Instagram

7.1 صور متحركة (سلايدر) — home.slider

عرض شرائح متحركة في أعلى الصفحة الرئيسية.

المقاس المقترح: 1920×700 بكسل.

7.2 صورة مع عنوان — home.image-with-text

مجموعة صور مع عناوين وروابط، مناسبة لإبراز مجموعات المنتجات.

7.3 مميزات المتجر — home.store-features

شريط لإبراز مزايا المتجر مثل الشحن المجاني والدفع الآمن.

المقاس المقترح للأيقونة: 64×64 بكسل بصيغة SVG أو PNG شفاف.

7.4 الماركات التجارية — home.brands

عرض شعارات الماركات التجارية المسجّلة في متجرك.

7.5 منتجات التصنيف — home.category-products

عرض منتجات مجموعة من التصنيفات في تبويبات.

7.6 منتجات مختارة — home.featured-products

سلايدر لمنتجات تختارها يدويًا.

7.7 صور مربعة (محسنة) — home.banners

بنرات تسويقية بصور وأزرار.

المقاس المقترح: 800×800 بكسل (مربّع).

7.8 المدونة — home.posts

عرض مقالات مختارة من مدونة المتجر.

7.9 روابط سريعة — home.main-links

شريط أيقونات للتنقل السريع لأهم أقسام المتجر.

7.10 تصنيفات مختارة — home.categories-selected

عرض تصنيفات بصور مخصّصة تختارها بنفسك.

7.11 القسم الترويجي مع العد التنازلي — home.promo-with-countdown

قسم عرض محدود بمؤقّت تنازلي.

7.12 انستقرام — home.instagram

عرض آخر منشورات حساب انستقرام.

أقسام سلة الجاهزة المدعومة

بالإضافة إلى الأقسام المخصّصة أعلاه، يدعم الثيم أقسام سلة الجاهزة التالية:

المنتجات المميزة · المنتجات الثابتة · أحدث المنتجات · سلايدر المنتجات · آراء العملاء · انستقرام · الروابط الرئيسية · التصنيفات المختارة · القسم الترويجي مع العد التنازلي · يوتيوب

7.1 Image slider — home.slider

An animated slideshow at the top of the homepage.

Recommended size: 1920×700 px.

7.2 Image with text — home.image-with-text

A group of images with titles and links, useful for highlighting product collections.

7.3 Store features — home.store-features

A strip highlighting store benefits such as free shipping and secure payment.

Recommended icon size: 64×64 px, SVG or transparent PNG.

7.4 Brands — home.brands

Displays the logos of brands registered in your store.

7.5 Category products — home.category-products

Shows products from a set of categories in tabs.

7.6 Featured products — home.featured-products

A slider of manually selected products.

7.7 Enhanced square banners — home.banners

Marketing banners with images and buttons.

Recommended size: 800×800 px (square).

7.8 Blog — home.posts

Shows selected articles from the store blog.

7.9 Quick links — home.main-links

An icon strip for quick navigation to key parts of the store.

7.10 Selected categories — home.categories-selected

Displays categories with custom images you choose yourself.

7.11 Promo with countdown — home.promo-with-countdown

A limited-time offer section with a countdown timer.

7.12 Instagram — home.instagram

Shows the latest posts from an Instagram account.

Supported built-in Salla sections

In addition to the custom sections above, the theme supports these built-in Salla sections:

Featured products · Fixed products · Latest products · Products slider · Testimonials · Instagram · Main links · Selected categories · Promo with countdown · YouTube

1. أضف منتجاتك من المنتجات ← إضافة منتج.
2. ارفع صورًا مربّعة عالية الجودة (1000×1000 بكسل أو أكثر) — الثيم يعتمد بشكل كبير على جودة الصور.
3. عبّئ الوصف والسعر وسعر التخفيض إن وُجد ليظهر شارة الخصم.
4. أضف خيارات المنتج (الوزن، الحجم، النكهة) من تبويب الخيارات.
5. فعّل الوسوم لتظهر في صفحة المنتج (يتطلب تفعيل إعداد إظهار الوسوم).
6. اضبط طريقة عرض صور سليدر المنتج من إعدادات الثيم بما يناسب صور منتجاتك.

1. Add products from Products → Add product.
2. Upload square, high-quality images (1000×1000 px or larger) — the theme relies heavily on image quality.
3. Fill in the description, price and sale price (a discount badge appears when a sale price is set).
4. Add product options (weight, size, flavour) from the options tab.
5. Add tags so they show on the product page (requires the Show tags setting to be on).
6. Set Product slider image fit in theme settings to suit your product photography.

1. أنشئ تصنيفاتك من المنتجات ← التصنيفات.
2. ارفع صورة لكل تصنيف — تُستخدم في أقسام تصنيفات مختارة والقائمة الرئيسية.
3. اربط المنتجات بالتصنيفات المناسبة.
4. لعرض التصنيفات في القائمة العلوية الموسّعة (Mega Menu) اضبطها من المتجر وقنوات البيع ← روابط مخصصة / القائمة الرئيسية.

1. Create categories from Products → Categories.
2. Upload an image for each category — used by the Selected categories section and the main menu.
3. Assign products to the right categories.
4. To show categories in the mega menu, configure them from Store & Sales Channels → Custom links / Main menu.

نصائح:

• استخدم صيغة WebP أو JPEG مضغوطة لتسريع تحميل الصفحة.
• حافظ على نمط بصري موحّد (نفس الخلفية والإضاءة) لجميع صور المنتجات.
• تأكّد أن كل صورة أقل من 500 كيلوبايت قدر الإمكان.

Tips:

• Use compressed WebP or JPEG to speed up page loads.
• Keep a consistent visual style (same background and lighting) across all product photos.
• Keep each image under 500 KB where possible.

القائمة الرئيسية

يدعم الثيم الميجا مينو. اضبط عناصر القائمة من: المتجر وقنوات البيع ← روابط مخصصة.

الفوتر

يعرض الفوتر تلقائيًا:

• روابط القوائم والصفحات التعريفية
• بيانات التواصل (الهاتف، البريد، العنوان)
• روابط التواصل الاجتماعي
• وسائل الدفع المتاحة
• تطبيقات المتجر (إن وُجدت)
• الرقم الضريبي والسجل التجاري

تُضبط هذه البيانات من الإعدادات ← بيانات المتجر وقنوات التواصل.

ألوان الفوتر تُضبط من إعدادات الثيم (footer_bg و footer_color).

Main menu

The theme supports a mega menu. Configure its items from: Store & Sales Channels → Custom links.

Footer

The footer automatically displays:

• Menu links and static pages
• Contact details (phone, email, address)
• Social media links
• Available payment methods
• Store apps (if any)
• VAT number and commercial registration number

These are configured under Settings → Store data and Contact channels.

Footer colours are set in theme settings (footer_bg and footer_color).

• الثيم مصمّم أساسًا للعربية باتجاه RTL بشكل كامل.
• يتضمّن ملف ترجمة إنجليزي (LTR) جاهز في src/locales/en.json.
• لتفعيل تعدد اللغات: الإعدادات ← اللغات ← أضف اللغة المطلوبة.
• بعض حقول الأقسام تدعم تعدد اللغات (multilanguage) — ستظهر لك خانة لكل لغة مفعّلة.

• The theme is designed primarily for Arabic with full RTL support.
• A ready English (LTR) translation file ships at src/locales/en.json.
• To enable multiple languages: Settings → Languages → add the language you need.
• Some section fields are multilanguage — you will see a separate input for each enabled language.

• قسم انستقرام يتطلب رمز وصول (Access Token) صالح من Instagram Basic Display API، ويجب تجديده دوريًا.
• قسم الماركات التجارية يتطلب إضافة الماركات مسبقًا من لوحة التحكم.
• قسم المدونة يتطلب وجود مقالات منشورة.
• القسم الترويجي مع العد التنازلي: المؤقّت يظهر فقط عند تحديد تاريخ انتهاء مستقبلي.
• الثيم يعتمد على مكوّنات Twilight الرسمية من سلة؛ يُنصح بإبقاء المتجر على أحدث إصدار.

• The Instagram section requires a valid access token from the Instagram Basic Display API, refreshed periodically.
• The Brands section requires brands to be added in the dashboard first.
• The Blog section requires published articles.
• Promo with countdown: the timer only appears when a future end date is set.
• The theme is built on Salla's official Twilight components; keep your store on the latest version.

إذا واجهتك أي مشكلة أو رغبت في استفسار حول الثيم:

• البريد الإلكتروني للدعم: info@tech-station.com
• هاتف الدعم: ‎+966 50 380 6414
• واتساب (دعم مباشر): تواصل معنا عبر واتساب
• مركز مساعدة سلة: help.salla.sa
• توثيق سلة للثيمات: docs.salla.dev

عند التواصل معنا يُرجى إرفاق:

1. رابط متجرك.
2. اسم الثيم والإصدار.
3. وصف المشكلة وخطوات تكرارها.
4. لقطة شاشة للمشكلة.
5. نوع الجهاز والمتصفح.

مدة الاستجابة: خلال يومَي عمل.

<div align="center">

ثيم شَهِي — Shahi Theme

</div>

If you run into a problem or have a question about the theme:

• Support email: info@tech-station.com
• Support phone: ‎+966 50 380 6414
• WhatsApp (live support): Chat with us on WhatsApp
• Salla Help Centre: help.salla.sa
• Salla theme documentation: docs.salla.dev

When contacting us, please include:

1. Your store URL.
2. The theme name and version.
3. A description of the problem and steps to reproduce it.
4. A screenshot of the problem.
5. Your device and browser.

Response time: within two business days.

<div align="center">

Shahi Theme — ثيم شَهِي

</div>