دموهای آماده 10

مرکز اعلان‌ها

همه اعلان‌ها خوانده شد
مشاهده تمام اعلان‌ها

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

آیا به بک‌اند نیاز دارد؟ نه. همه صفحات با داده نمونه کار می‌کنند. برای اتصال به API واقعی بخش اتصال به API را ببینید.

عمومی

آیا از React/Vue هم می‌توانم استفاده کنم؟ قالب خالص HTML/CSS/JS است. می‌توانید باندل را در یک پروژه React هم بارگذاری کنید، اما مزیت اصلی قالب این است که به فریم‌ورک گره نخورده است.

چند صفحه دارد؟ ۲۰۶ صفحه مستقل (۱۰ داشبورد، ۷۸ اپلیکیشن، ۴۷ جدول فهرست، ۲۱ صفحه UI Kit، ۲۳ مستند، ۱۶ صفحه سیستمی، ۱۱ صفحه احراز هویت) به‌همراه صفحه محصول و صفحه پیش‌نمایش.

آیا فونت‌ها با مجوز آزاد هستند؟ بله. فونت Vazirmatn با مجوز SIL OFL و آیکن‌های Bootstrap Icons با مجوز MIT عرضه می‌شوند. جزئیات در اعتبارها.

ظاهر و تم

چطور رنگ سازمانی خودم را بگذارم؟ در src/scss/base/_palettes.scss یک پالت جدید بسازید و data-primary را روی آن تنظیم کنید. بخش شخصی‌سازی تم را ببینید.

چطور لوگو را عوض کنم؟ فایل public/assets/logo.svg (و نسخه‌های logo-dark.svg و logo-mark.svg و favicon.svg) را با طرح خودتان جایگزین کنید؛ نام‌ها را تغییر ندهید.

حالت تاریک برای همه کامپوننت‌ها کار می‌کند؟ بله. تم تاریک با توکن‌ها ساخته شده، نه با بازنویسی کامپوننت‌ها؛ پس هر جزء جدیدی هم که با توکن بسازید خودکار پشتیبانی می‌شود.

چطور اندازه فونت را عوض کنم؟ از پنل شخصی‌سازی یا theme.set('fontSize', 'lg'). از نسخه ۱.۱ چیدمان، تراکم و سبک منو روی مقدار آزموده‌شده ثابت‌اند و از پنل شخصی‌سازی حذف شده‌اند تا پوسته هیچ‌وقت به‌هم نریزد.

داده و جدول‌ها

داده‌ها را کجا عوض کنم؟ فایل‌های src/data/*.js. همه از یک مولد با بذر ثابت ساخته می‌شوند (src/data/rng.js)، پس خروجی تکرارپذیر است.

چطور یک جدول جدید بسازم؟ بخش جدول داده را ببینید؛ با data-datatable و data-resource در چند خط تمام می‌شود.

فیلتر و مرتب‌سازی سمت سرور چطور؟ پارامترهای page, perPage, search, sort, order و فیلترها در همان درخواست به API می‌روند؛ کافی است بک‌اند آن‌ها را بپذیرد.

ترجمه و تقویم

چطور زبان چهارم اضافه کنم؟ بخش چندزبانه — یک فایل دیکشنری و یک خط در index.js.

اعداد همیشه فارسی می‌مانند؟ در زبان فارسی بله. با theme.set('language', 'en') ارقام لاتین می‌شوند و جهت هم عوض می‌شود.

تقویم میلادی را چطور فعال کنم؟ theme.set('calendar', 'gregorian') یا گزینه «تقویم» در پنل شخصی‌سازی.

ساخت و انتشار

چرا npm run dev روی پورت ۵۱۷۳ اجرا می‌شود؟ پورت پیش‌فرض Vite است. با npm run dev -- --port 5180 عوض کنید.

چرا استایل‌ها در حالت توسعه اعمال نمی‌شوند؟ لینک استایل در src/partials/head.html با ?direct نوشته شده تا Vite آن را به‌عنوان CSS سرو کند. اگر این پارامتر حذف شود، فایل به‌صورت ماژول JS سرو می‌شود و صفحه بی‌استایل می‌ماند.

خروجی را کجا آپلود کنم؟ محتوای dist/. بخش استقرار را ببینید.

چطور بسته فروش را بسازم؟ npm run package — یک ZIP استاندارد با پوشه‌های html/, source/, documentation/, assets/, screenshots/, changelog/ می‌سازد.

پشتیبانی

آیا به‌روزرسانی‌ها رایگان است؟ دوره پشتیبانی و به‌روزرسانی در فایل LICENSE.txt توضیح داده شده است.

چطور اشکال گزارش کنم؟ با ایمیل پشتیبانی (supportEmail در src/config/config.js) و ذکر نسخه، مرورگر و مراحل بازتولید. قبل از ارسال، npm run qa:all را اجرا کنید و نتیجه را ضمیمه کنید.

نکته: پیش از طرح پرسش، بخش رفع اشکال را ببینید؛ پاسخ بیشتر مشکلات رایج همان‌جاست

FAQ

Does it need a backend? No. Every page works with sample data. To connect a real API, see API integration.

General

Can I use React/Vue too? The template is pure HTML/CSS/JS. You can load the bundle inside a React project, but the template's main advantage is that it is not tied to a framework.

How many pages does it have? 206 standalone pages (10 dashboards, 78 apps, 47 list tables, 21 UI Kit pages, 23 docs, 16 system pages, 11 authentication pages) plus the product page and the preview page.

Are the fonts freely licensed? Yes. The Vazirmatn font is released under the SIL OFL and Bootstrap Icons under MIT. Details in Credits.

Look and theme

How do I set my brand colour? Create a new palette in src/scss/base/_palettes.scss and set data-primary to it. See Theme customization.

How do I change the logo? Replace public/assets/logo.svg (and the logo-dark.svg, logo-mark.svg and favicon.svg variants) with your own design; do not rename them.

Does dark mode work for every component? Yes. The dark theme is built with tokens, not by overriding components, so any new element you build with tokens is supported automatically.

How do I change the font size? From the customizer or with theme.set('fontSize', 'lg'). Since version 1.1, layout, density and menu style are fixed at their tested values and have been removed from the customizer so the shell never breaks.

Data and tables

Where do I change the data? In the src/data/*.js files. All of them are built from one generator with a fixed seed (src/data/rng.js), so the output is reproducible.

How do I build a new table? See Data tables; with data-datatable and data-resource it takes a few lines.

What about server-side filtering and sorting? The page, perPage, search, sort, order and filter parameters are sent to the API in the same request; your backend just has to accept them.

Translation and calendar

How do I add a fourth language? See Localization — one dictionary file and one line in index.js.

Do numbers always stay Persian? In Persian, yes. In English the digits become Latin and in Arabic they become Arabic-Indic; the direction changes too.

How do I enable the Gregorian calendar? theme.set('calendar', 'gregorian') or the "Calendar" option in the customizer.

Build and release

Why does npm run dev run on port 5173? It is Vite's default port. Change it with npm run dev -- --port 5180.

Why are styles not applied in development? The stylesheet link in src/partials/head.html is written with ?direct so Vite serves it as CSS. If that parameter is removed, the file is served as a JS module and the page stays unstyled.

Where do I upload the output? The contents of dist/. See Deployment.

How do I build the sales package? npm run package — it produces a standard ZIP with the html/, source/, documentation/, assets/, screenshots/ and changelog/ folders.

Support

Are updates free? The support and update period is described in LICENSE.txt.

How do I report a bug? Via the support email (supportEmail in src/config/config.js), mentioning the version, browser and reproduction steps. Before sending, run npm run qa:all and attach the result.

Tip: before asking, check Troubleshooting; most common problems are answered there

الأسئلة الشائعة

هل يحتاج إلى واجهة خلفية؟ لا. جميع الصفحات تعمل ببيانات نموذجية. للربط بـ API حقيقية راجع قسم الربط بـ API.

عام

هل يمكنني استخدام React/Vue أيضاً؟ القالب مكتوب بـ HTML/CSS/JS خالص. يمكنك تحميل الحزمة داخل مشروع React، لكن الميزة الأساسية للقالب أنه غير مرتبط بإطار عمل.

كم صفحة يضم؟ ٢٠٦ صفحات مستقلة (١٠ لوحات تحكم، ٧٨ تطبيقاً، ٤٧ جدول قوائم، ٢١ صفحة UI Kit، ٢٣ وثيقة، ١٦ صفحة نظام، ١١ صفحة مصادقة) إضافة إلى صفحة المنتج وصفحة المعاينة.

هل الخطوط بترخيص حر؟ نعم. يُوزَّع خط Vazirmatn بترخيص SIL OFL وأيقونات Bootstrap Icons بترخيص MIT. التفاصيل في الإشادات.

المظهر والسمة

كيف أضع لون مؤسستي؟ أنشئ لوحة جديدة في src/scss/base/_palettes.scss واضبط data-primary عليها. راجع قسم تخصيص السمة.

كيف أغيّر الشعار؟ استبدل الملف public/assets/logo.svg (والنسخ logo-dark.svg وlogo-mark.svg وfavicon.svg) بتصميمك؛ ولا تغيّر الأسماء.

هل يعمل الوضع الداكن لجميع المكونات؟ نعم. السمة الداكنة مبنية بالرموز لا بإعادة كتابة المكونات؛ لذا يُدعم تلقائياً أي عنصر جديد تبنيه بالرموز.

كيف أغيّر حجم الخط؟ من لوحة التخصيص أو بـ theme.set('fontSize', 'lg'). منذ الإصدار ١٫١ صار التخطيط والكثافة ونمط القائمة ثابتة على القيم المختبرة وأُزيلت من لوحة التخصيص كي لا يختل الهيكل أبداً.

البيانات والجداول

أين أغيّر البيانات؟ في ملفات src/data/*.js. جميعها مبنية من مولّد واحد ببذرة ثابتة (src/data/rng.js)؛ لذا فالمخرجات قابلة للتكرار.

كيف أنشئ جدولاً جديداً؟ راجع قسم جداول البيانات؛ ينتهي الأمر في بضعة أسطر بـ data-datatable وdata-resource.

ماذا عن الفلترة والترتيب من جهة الخادم؟ تُرسَل المعاملات page وperPage وsearch وsort وorder والفلاتر في الطلب نفسه إلى API؛ ويكفي أن تقبلها الواجهة الخلفية.

الترجمة والتقويم

كيف أضيف لغة رابعة؟ قسم تعدد اللغات — ملف قاموس واحد وسطر واحد في index.js.

هل تبقى الأرقام فارسية دائماً؟ في الفارسية نعم. في الإنجليزية تصبح الأرقام لاتينية وفي العربية تصبح هندية عربية، ويتغير الاتجاه أيضاً.

كيف أفعّل التقويم الميلادي؟ theme.set('calendar', 'gregorian') أو خيار «التقويم» في لوحة التخصيص.

البناء والنشر

لماذا يعمل npm run dev على المنفذ ٥١٧٣؟ إنه المنفذ الافتراضي لـ Vite. غيّره بـ npm run dev -- --port 5180.

لماذا لا تُطبَّق الأنماط في وضع التطوير؟ كُتب رابط الأنماط في src/partials/head.html مع ?direct ليقدّمه Vite كملف CSS. إذا حُذف هذا المعامل، يُقدَّم الملف كوحدة JS وتبقى الصفحة بلا أنماط.

أين أرفع المخرجات؟ محتوى dist/. راجع قسم النشر.

كيف أبني حزمة البيع؟ npm run package — يُنشئ ملف ZIP قياسياً بالمجلدات html/ وsource/ وdocumentation/ وassets/ وscreenshots/ وchangelog/.

الدعم

هل التحديثات مجانية؟ مدة الدعم والتحديث موضحة في الملف LICENSE.txt.

كيف أبلّغ عن خطأ؟ عبر بريد الدعم (supportEmail في src/config/config.js) مع ذكر الإصدار والمتصفح وخطوات إعادة الإنتاج. قبل الإرسال نفّذ npm run qa:all وأرفق النتيجة.

ملاحظة: قبل طرح السؤال راجع قسم استكشاف الأخطاء؛ فإجابة معظم المشكلات الشائعة موجودة هناك