@@ -72,7 +103,8 @@
در این بخش می‌توانید با استفاده از زبان قالب‌بندی Twig و HTML/CSS، قالب فاکتور سفارشی خود را طراحی کنید.
- برای جلوگیری از مشکلات امنیتی، رندر کدها در Sandbox انجام می‌شود؛ بنابراین تنها بخشی از امکانات Twig مجاز است.
+ برای جلوگیری از مشکلات امنیتی، رندر کدها در Sandbox انجام می‌شود؛ بنابراین تنها بخشی از امکانات
+ Twig مجاز است.
- تگ‌های مجاز: if و for
@@ -94,7 +126,9 @@
-
business: اطلاعات کسب‌وکار
- business.name, business.tel, business.mobile, business.addressbusiness.name, business.tel, business.mobile,
+ business.address
+ business.shenasemeli, business.codeeghtesadi
@@ -102,22 +136,31 @@
doc: اطلاعات سند
doc.code, doc.date- در فروش:
doc.taxPercent, doc.discountPercent, doc.discountType
+ - در فروش:
doc.taxPercent, doc.discountPercent,
+ doc.discountType
+
-
person: اطلاعات مشتری/طرف حساب
- person.name, person.mobile, person.tel, person.addressperson.name, person.mobile, person.tel,
+ person.address
+
-
rows: آرایه اقلام فاکتور (هر ردیف یک شیء)
- row.commodity.name, row.commodity.code (ممکن است commodity تهی باشد)row.commodity.name, row.commodity.code (ممکن است
+ commodity
+ تهی باشد)row.commodityCount (و برای سازگاری قدیمی: row.commdityCount)row.des, row.bs, row.bd (در خرید/برگشت از خرید)، row.tax, row.discount- در فروش/برگشت از فروش:
row.showPercentDiscount, row.discountPercent
+ row.des, row.bs, row.bd (در خرید/برگشت از خرید)،
+ row.tax, row.discount
+ - در فروش/برگشت از فروش:
row.showPercentDiscount, row.discountPercent
+
-
@@ -146,40 +189,41 @@
{% if person %}
-<p>مشتری: {{ person.name | escape }}</p>
-{% endif %}
+ <p>مشتری: {{ person.name | escape }}</p>
+ {% endif %}
-<table width="100%" cellspacing="0" cellpadding="6" border="1">
- <thead>
- <tr>
- <th>#</th>
- <th>کالا</th>
- <th>تعداد</th>
- <th>فی توضیح</th>
- <th>مالیات</th>
- <th>تخفیف</th>
- </tr>
- </thead>
- <tbody>
- {% for item in rows %}
- <tr>
- <td>{{ loop.index }}</td>
- <td>{{ item.commodity.name ?? '-' }}</td>
- <td>{{ item.commodityCount }}</td>
- <td>{{ item.des | escape }}</td>
- <td>{{ item.tax | number_format(0, '.', ',') }}</td>
- <td>
- {% if item.showPercentDiscount %}
- {{ item.discountPercent }}%
- {% else %}
- {{ item.discount | number_format(0, '.', ',') }}
- {% endif %}
- </td>
- </tr>
- {% endfor %}
- </tbody>
-</table>
-
+ <table width="100%" cellspacing="0" cellpadding="6"
+ border="1">
+ <thead>
+ <tr>
+ <th>#</th>
+ <th>کالا</th>
+ <th>تعداد</th>
+ <th>فی توضیح</th>
+ <th>مالیات</th>
+ <th>تخفیف</th>
+ </tr>
+ </thead>
+ <tbody>
+ {% for item in rows %}
+ <tr>
+ <td>{{ loop.index }}</td>
+ <td>{{ item.commodity.name ?? '-' }}</td>
+ <td>{{ item.commodityCount }}</td>
+ <td>{{ item.des | escape }}</td>
+ <td>{{ item.tax | number_format(0, '.', ',') }}</td>
+ <td>
+ {% if item.showPercentDiscount %}
+ {{ item.discountPercent }}%
+ {% else %}
+ {{ item.discount | number_format(0, '.', ',') }}
+ {% endif %}
+ </td>
+ </tr>
+ {% endfor %}
+ </tbody>
+ </table>
+
@@ -193,36 +237,41 @@
<div class="invoice-template">
- <h2 style="text-align:center">{{ business.name }}</h2>
- <div>شماره فاکتور: {{ doc.code }} | تاریخ: {{ doc.date }}</div>
- {% if person %}<div>مشتری: {{ person.name }} | موبایل: {{ person.mobile }}</div>{% endif %}
+ <h2 style="text-align:center">{{ business.name }}</h2>
+ <div>شماره فاکتور: {{ doc.code }} | تاریخ: {{ doc.date }}</div>
+ {% if person %}<div>مشتری: {{ person.name }} | موبایل: {{ person.mobile }}</div>{% endif %}
- <table width="100%" cellspacing="0" cellpadding="6" border="1" style="margin-top:10px">
- <thead><tr><th>#</th><th>کالا</th><th>تعداد</th><th>شرح</th><th>مالیات</th><th>تخفیف</th></tr></thead>
- <tbody>
- {% for r in rows %}
- <tr>
- <td>{{ loop.index }}</td>
- <td>{{ r.commodity.name ?? '-' }}</td>
- <td>{{ r.commodityCount }}</td>
- <td>{{ r.des }}</td>
- <td>{{ r.tax | number_format(0, '.', ',') }}</td>
- <td>{% if r.showPercentDiscount %}{{ r.discountPercent }}%{% else %}{{ r.discount | number_format(0, '.', ',') }}{% endif %}</td>
- </tr>
- {% endfor %}
- </tbody>
- </table>
+ <table width="100%" cellspacing="0" cellpadding="6"
+ border="1" style="margin-top:10px">
+ <thead><tr><th>#</th><th>کالا</th><th>تعداد</th><th>شرح</th><th>مالیات</th><th>تخفیف</th></tr></thead>
+ <tbody>
+ {% for r in rows %}
+ <tr>
+ <td>{{ loop.index }}</td>
+ <td>{{ r.commodity.name ?? '-' }}</td>
+ <td>{{ r.commodityCount }}</td>
+ <td>{{ r.des }}</td>
+ <td>{{ r.tax | number_format(0, '.', ',') }}</td>
+ <td>{% if r.showPercentDiscount %}{{ r.discountPercent }}%{% else %}{{ r.discount |
+ number_format(0, '.', ',') }}{% endif %}</td>
+ </tr>
+ {% endfor %}
+ </tbody>
+ </table>
- <div style="margin-top:10px;text-align:right">
- {% if discount %}<div>جمع تخفیف: {{ discount | number_format(0, '.', ',') }}</div>{% endif %}
- {% if transfer %}<div>هزینه ارسال/انتقال: {{ transfer | number_format(0, '.', ',') }}</div>{% endif %}
- </div>
+ <div style="margin-top:10px;text-align:right">
+ {% if discount %}<div>جمع تخفیف: {{ discount | number_format(0, '.', ',') }}</div>{% endif
+ %}
+ {% if transfer %}<div>هزینه ارسال/انتقال: {{ transfer | number_format(0, '.', ',')
+ }}</div>{% endif %}
+ </div>
- {% if note %}
- <div style="margin-top:12px;border-top:1px dashed #ccc;padding-top:8px">{{ note | escape }}</div>
- {% endif %}
-</div>
-
+ {% if note %}
+ <div style="margin-top:12px;border-top:1px dashed #ccc;padding-top:8px">{{ note | escape
+ }}</div>
+ {% endif %}
+ </div>
+
@@ -235,9 +284,10 @@
در خرید/برگشت از خرید، مقادیر ردیف‌ها شامل bs و bd نیز هستند.
{% for r in rows %}
- <div>{{ loop.index }}. {{ r.commodity.name ?? '-' }} | تعداد: {{ r.commodityCount }} | شرح: {{ r.des }} | بدهکار: {{ r.bd }} | بستانکار: {{ r.bs }}</div>
-{% endfor %}
-
+ <div>{{ loop.index }}. {{ r.commodity.name ?? '-' }} | تعداد: {{ r.commodityCount }} | شرح: {{
+ r.des }} | بدهکار: {{ r.bd }} | بستانکار: {{ r.bs }}</div>
+ {% endfor %}
+
@@ -250,8 +300,12 @@
- از اجرای جاوااسکریپت، توابع سیستم یا درخواست‌های خارجی در قالب پرهیز شده و امکان‌پذیر نیست.
- - برای جلوگیری از خطاهای سازگاری، از commodityCount استفاده کنید (هرچند برای سازگاری commdityCount نیز پشتیبانی می‌شود).
- - به دلیل Sandbox، دسترسی به متد/پراپرتی‌های آبجکت‌ها محدود است؛ از داده‌های آرایه‌ای فراهم‌شده استفاده کنید.
+ - برای جلوگیری از خطاهای سازگاری، از commodityCount استفاده کنید (هرچند برای سازگاری
+ commdityCount نیز پشتیبانی می‌شود).
+
+ - به دلیل Sandbox، دسترسی به متد/پراپرتی‌های آبجکت‌ها محدود است؛ از داده‌های آرایه‌ای فراهم‌شده
+ استفاده
+ کنید.
@@ -264,9 +318,13 @@
- - خطای «Key X does not exist»: نام کلید را با فهرست بالا تطبیق دهید؛ برای تعداد از
commodityCount استفاده کنید.
- - عدم نمایش اطلاعات مشتری: ابتدا بررسی کنید
person تهی نباشد: {% if person %} ... {% endif %}
- - به‌هم‌ریختگی چاپ: از CSS ساده و سازگار با چاپ استفاده کنید؛ عرض جدول‌ها و اندازه فونت‌ها را کنترل کنید.
+ - خطای «Key X does not exist»: نام کلید را با فهرست بالا تطبیق دهید؛ برای تعداد از
+
commodityCount استفاده کنید.
+
+ - عدم نمایش اطلاعات مشتری: ابتدا بررسی کنید
person تهی نباشد: {% if person %} ... {%
+ endif %}
+ - به‌هم‌ریختگی چاپ: از CSS ساده و سازگار با چاپ استفاده کنید؛ عرض جدول‌ها و اندازه فونت‌ها را کنترل
+ کنید.
@@ -282,90 +340,96 @@
فروش (نمونه ساده)
<div class="invoice-template">
- <h3 style="text-align:center">{{ business.name }}</h3>
- <div>کد: {{ doc.code }} | تاریخ: {{ doc.date }}</div>
- {% if person %}<div>مشتری: {{ person.name }}</div>{% endif %}
- <table width="100%" border="1" cellspacing="0" cellpadding="6" style="margin-top:8px">
- <thead><tr><th>#</th><th>کالا</th><th>تعداد</th><th>شرح</th><th>مالیات</th><th>تخفیف</th></tr></thead>
- <tbody>
- {% for r in rows %}
- <tr>
- <td>{{ loop.index }}</td>
- <td>{{ r.commodity.name ?? '-' }}</td>
- <td>{{ r.commodityCount }}</td>
- <td>{{ r.des }}</td>
- <td>{{ r.tax | number_format(0, '.', ',') }}</td>
- <td>{% if r.showPercentDiscount %}{{ r.discountPercent }}%{% else %}{{ r.discount | number_format(0, '.', ',') }}{% endif %}</td>
- </tr>
- {% endfor %}
- </tbody>
- </table>
- {% if note %}<div style="margin-top:8px">{{ note | escape }}</div>{% endif %}
-</div>
+ <h3 style="text-align:center">{{ business.name }}</h3>
+ <div>کد: {{ doc.code }} | تاریخ: {{ doc.date }}</div>
+ {% if person %}<div>مشتری: {{ person.name }}</div>{% endif %}
+ <table width="100%" border="1" cellspacing="0"
+ cellpadding="6" style="margin-top:8px">
+ <thead><tr><th>#</th><th>کالا</th><th>تعداد</th><th>شرح</th><th>مالیات</th><th>تخفیف</th></tr></thead>
+ <tbody>
+ {% for r in rows %}
+ <tr>
+ <td>{{ loop.index }}</td>
+ <td>{{ r.commodity.name ?? '-' }}</td>
+ <td>{{ r.commodityCount }}</td>
+ <td>{{ r.des }}</td>
+ <td>{{ r.tax | number_format(0, '.', ',') }}</td>
+ <td>{% if r.showPercentDiscount %}{{ r.discountPercent }}%{% else %}{{ r.discount |
+ number_format(0, '.', ',') }}{% endif %}</td>
+ </tr>
+ {% endfor %}
+ </tbody>
+ </table>
+ {% if note %}<div style="margin-top:8px">{{ note | escape }}</div>{% endif %}
+ </div>
خرید (نمونه ساده)
<div class="invoice-template">
- <h3 style="text-align:center">{{ business.name }}</h3>
- <div>کد: {{ doc.code }} | تاریخ: {{ doc.date }}</div>
- {% if person %}<div>فروشنده: {{ person.name }}</div>{% endif %}
- <table width="100%" border="1" cellspacing="0" cellpadding="6" style="margin-top:8px">
- <thead><tr><th>#</th><th>کالا</th><th>تعداد</th><th>شرح</th><th>بدهکار</th><th>بستانکار</th></tr></thead>
- <tbody>
- {% for r in rows %}
- <tr>
- <td>{{ loop.index }}</td>
- <td>{{ r.commodity.name ?? '-' }}</td>
- <td>{{ r.commodityCount }}</td>
- <td>{{ r.des }}</td>
- <td>{{ r.bd | number_format(0, '.', ',') }}</td>
- <td>{{ r.bs | number_format(0, '.', ',') }}</td>
- </tr>
- {% endfor %}
- </tbody>
- </table>
-</div>
+ <h3 style="text-align:center">{{ business.name }}</h3>
+ <div>کد: {{ doc.code }} | تاریخ: {{ doc.date }}</div>
+ {% if person %}<div>فروشنده: {{ person.name }}</div>{% endif %}
+ <table width="100%" border="1" cellspacing="0"
+ cellpadding="6" style="margin-top:8px">
+ <thead><tr><th>#</th><th>کالا</th><th>تعداد</th><th>شرح</th><th>بدهکار</th><th>بستانکار</th></tr></thead>
+ <tbody>
+ {% for r in rows %}
+ <tr>
+ <td>{{ loop.index }}</td>
+ <td>{{ r.commodity.name ?? '-' }}</td>
+ <td>{{ r.commodityCount }}</td>
+ <td>{{ r.des }}</td>
+ <td>{{ r.bd | number_format(0, '.', ',') }}</td>
+ <td>{{ r.bs | number_format(0, '.', ',') }}</td>
+ </tr>
+ {% endfor %}
+ </tbody>
+ </table>
+ </div>
برگشت از خرید (نمونه ساده)
<div class="invoice-template">
- <h3 style="text-align:center">{{ business.name }}</h3>
- <div>کد: {{ doc.code }} | تاریخ: {{ doc.date }}</div>
- <table width="100%" border="1" cellspacing="0" cellpadding="6" style="margin-top:8px">
- <thead><tr><th>#</th><th>کالا</th><th>تعداد</th><th>شرح</th><th>بدهکار</th><th>بستانکار</th></tr></thead>
- <tbody>
- {% for r in rows %}
- <tr>
- <td>{{ loop.index }}</td>
- <td>{{ r.commodity.name ?? '-' }}</td>
- <td>{{ r.commodityCount }}</td>
- <td>{{ r.des }}</td>
- <td>{{ r.bd | number_format(0, '.', ',') }}</td>
- <td>{{ r.bs | number_format(0, '.', ',') }}</td>
- </tr>
- {% endfor %}
- </tbody>
- </table>
-</div>
+ <h3 style="text-align:center">{{ business.name }}</h3>
+ <div>کد: {{ doc.code }} | تاریخ: {{ doc.date }}</div>
+ <table width="100%" border="1" cellspacing="0"
+ cellpadding="6" style="margin-top:8px">
+ <thead><tr><th>#</th><th>کالا</th><th>تعداد</th><th>شرح</th><th>بدهکار</th><th>بستانکار</th></tr></thead>
+ <tbody>
+ {% for r in rows %}
+ <tr>
+ <td>{{ loop.index }}</td>
+ <td>{{ r.commodity.name ?? '-' }}</td>
+ <td>{{ r.commodityCount }}</td>
+ <td>{{ r.des }}</td>
+ <td>{{ r.bd | number_format(0, '.', ',') }}</td>
+ <td>{{ r.bs | number_format(0, '.', ',') }}</td>
+ </tr>
+ {% endfor %}
+ </tbody>
+ </table>
+ </div>
برگشت از فروش (نمونه ساده)
<div class="invoice-template">
- <h3 style="text-align:center">{{ business.name }}</h3>
- <div>کد: {{ doc.code }} | تاریخ: {{ doc.date }}</div>
- <table width="100%" border="1" cellspacing="0" cellpadding="6" style="margin-top:8px">
- <thead><tr><th>#</th><th>کالا</th><th>تعداد</th><th>شرح</th><th>مالیات</th><th>تخفیف</th></tr></thead>
- <tbody>
- {% for r in rows %}
- <tr>
- <td>{{ loop.index }}</td>
- <td>{{ r.commodity.name ?? '-' }}</td>
- <td>{{ r.commodityCount }}</td>
- <td>{{ r.des }}</td>
- <td>{{ r.tax | number_format(0, '.', ',') }}</td>
- <td>{% if r.showPercentDiscount %}{{ r.discountPercent }}%{% else %}{{ r.discount | number_format(0, '.', ',') }}{% endif %}</td>
- </tr>
- {% endfor %}
- </tbody>
- </table>
-</div>
+ <h3 style="text-align:center">{{ business.name }}</h3>
+ <div>کد: {{ doc.code }} | تاریخ: {{ doc.date }}</div>
+ <table width="100%" border="1" cellspacing="0"
+ cellpadding="6" style="margin-top:8px">
+ <thead><tr><th>#</th><th>کالا</th><th>تعداد</th><th>شرح</th><th>مالیات</th><th>تخفیف</th></tr></thead>
+ <tbody>
+ {% for r in rows %}
+ <tr>
+ <td>{{ loop.index }}</td>
+ <td>{{ r.commodity.name ?? '-' }}</td>
+ <td>{{ r.commodityCount }}</td>
+ <td>{{ r.des }}</td>
+ <td>{{ r.tax | number_format(0, '.', ',') }}</td>
+ <td>{% if r.showPercentDiscount %}{{ r.discountPercent }}%{% else %}{{ r.discount |
+ number_format(0, '.', ',') }}{% endif %}</td>
+ </tr>
+ {% endfor %}
+ </tbody>
+ </table>
+ </div>
@@ -448,16 +512,45 @@