ویرایش قالب چاپ (HTML/Handlebars)

این راهنما نشان می‌دهد چگونه با ویرایش کد HTML و Handlebars که نحوه نمایش و داده‌هایی که در اسناد شما نمایش داده می‌شوند را کنترل می‌کند، قالب چاپ را سفارشی کنید.

قبل از شروع:

• شما باید اجازه مدیریت تنظیمات چاپ را داشته باشید (معمولاً برای کاربران ادمین یا کسانی با نقش "ادمین" در دسترس است).
• شما باید آشنایی اولیه با برچسب‌های HTML (مثل <div>، <p>، <h1>) و سبک‌دهی CSS (رنگ، فونت، فاصله) داشته باشید.
• اگر مطمئن نیستید یک متغیر یا تابع در نوع سند شما وجود دارد، راهنمای متغیرها و توابع را بررسی کنید.
• اگر تغییرات قابل توجهی انجام می‌دهید، نسخه‌ای از قالب خود را در جای دیگری ذخیره کنید؛ هر وقت می‌توانید نسخه پیش‌فرض را بازگردانید.

مراحل:

1. صفحه قالب‌ها را باز کنید. به تنظیمات → قالب‌های چاپ بروید.

2. قالبی را برای ویرایش انتخاب کنید. روی نام یا ردیف قالب کلیک کنید (مثلاً "فاکتور – پیش‌فرض" یا "رسید فروش – دری").

3. وارد نمای ویرایشگر شوید. کد قالب در ویرایشگر باز می‌شود و markup HTML در سمت چپ و پیش‌نمایش زندہ در سمت راست نمایش داده می‌شود (در صورت دسترسی).

4. بخشی را که می‌خواهید تغییر دهید، پیدا کنید. ویرایش‌های رایج عبارتند از:

   • اضافه کردن آرم: برچسب <img> یا نظر <!-- Logo --> را جستجو کنید و آن را اضافه یا تغییر دهید.
   • تغییر رنگ‌ها: صفات style= یا بلوک <style> را پیدا کنید و مقادیر رنگ را به‌روز کنید (مثلاً color: #333333 یا background-color: #ffffff).
   • افزودن یا حذف فیلدها: متغیرهای {{field_name}} را اضافه کنید یا ردیف‌های HTML حاوی فیلدهای نامطلوب را حذف کنید.
   • ترجمه متن: هر متن انگلیسی ساده (مثل "شماره فاکتور" یا "تاریخ سر‌رسید") را به زبان دلخواه ترجمه کنید.

5. تغییرات خود را انجام دهید. HTML یا متن را به‌طور لازم تغییر دهید. اگر فیلد جدید اضافه می‌کنید، از نحوی Handlebars {{variable_name}} برای درج داده‌های پویا استفاده کنید (راهنمای متغیرها را برای گزینه‌های در دسترس ببینید).

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

7. قالب خود را ذخیره کنید. دکمه ذخیره را کلیک کنید. تغییرات شما اکنون برای تمام چاپ‌های آینده این نوع سند اعمال می‌شوند.

نکات و اشتباهات رایج:

• ساختار HTML را خراب نکنید. هر برچسب باز مثل <div> باید برچسب بسته‌ای </div> داشته باشد. اگر برچسب را حذف می‌کنید، قسمت‌های باز و بسته را حذف کنید.
• Handlebars را فقط برای داده‌ها استفاده کنید. همیشه از {{variable_name}} برای فیلدهای اسناد (نام مشتری، شماره فاکتور، کل‌ها) استفاده کنید. هرگز داده‌های مشتری را hardcode یا مقدار را فرض نکنید.
• با داده‌های نمونه تست کنید. پس از ذخیره‌سازی، یک سند واقعی را چاپ کنید یا با استفاده از سند آزمایشی یک پیش‌نمایش تولید کنید. این تأیید می‌کند که طراحی و داده‌ها صحیح‌اند.
• در صورت عدم اطمینان بازگردانید. اگر ویرایش‌های شما قالب را خراب کنند یا اشتباه به نظر برسند، از تابع بازگردانی برای بازگشت به قالب پیش‌فرض استفاده کنید.