Tùy chọn (Preferences)

Cấu hình toàn bộ addin — API keys, model AI, ngôn ngữ UI, hành vi mặc định.

Mở dialog

DVD Addin → nhóm Thông tin → split-button Tác giả → menu Tùy chọn.

Dialog Preferences chia thành tabs theo nhóm chức năng.

Tab General

Ngôn ngữ UI

• Vietnamese (mặc định).
• English.

Đổi → toàn bộ ribbon button label + dialog text đổi theo. Lưu vào %APPDATA%\DVDAddin\lang.txt + HKCU registry.

Auto-check update

• Tick (mặc định) → mỗi lần load addin, check phiên bản mới.
• Bỏ tick → bạn tự kiểm tra qua menu.

Telemetry

• Tick → gửi anonymous usage stats về dvdpm.net (giúp prioritize features).
• Bỏ tick → không gửi gì.

Tab Text and Number

Default Translate language

Set mặc định khi mở dialog Translate:

• From: auto (Detect language).
• To: Vietnamese (configurable).

Auto-detect symbol in italic apply

Khi áp dụng italic cho dòng dịch, addin tự detect symbol (/ hoặc \n) bằng cách:

• Tick → đọc cell đầu tiên, detect ký tự nào xuất hiện.
• Bỏ tick → phải set symbol thủ công.

Multilevel numbering format

Default cho dialog Đánh số đa cấp:

• Decimal (1.1.1) — mặc định.
• Roman (I.A.1).
• Letter (A.1.a).

Tab AI Models

Service chính

Đặt service mặc định cho Translate và AI Assistant:

• Google (free, không cần key).
• Gemini (mặc định cho AI).
• OpenAI / Groq / Cerebras.

Models per service

Service	Model default	Khuyến nghị
Gemini	gemini-2.5-flash	gemini-2.5-flash-lite (nhanh) hoặc gemini-2.5-pro (chính xác)
OpenAI	gpt-4o-mini	gpt-4o (chính xác hơn, đắt hơn)
Groq	llama-3.3-70b-versatile	mixtral-8x7b-32768 (context lớn)
Cerebras	llama3.1-8b	llama3.1-70b (chính xác hơn)

Temperature

• 0.0 — deterministic, output giống nhau mỗi lần. Phù hợp data transformation.
• 0.5 — cân bằng (mặc định).
• 0.7-1.0 — creative. Phù hợp viết nội dung mới.

Khuyên dùng 0.5 cho Translate, 0.3 cho AI Assistant (đỡ hallucination).

Tab API Keys

Manage tất cả API keys ở 1 nơi:

Service	Where to get	Mẹo
Gemini	aistudio.google.com/apikey	Free tier 1500 req/ngày
OpenAI	platform.openai.com/api-keys	Cần card credit
Groq	console.groq.com/keys	Free tier rộng
Cerebras	cloud.cerebras.ai	Free tier limited

Click Show để xem key đầy đủ (mặc định ẩn). Update để thay key mới. Test connection để verify key.

Keys lưu trong registry HKCU\Software\DVD\DVDAddin\API Keys (plain text — Windows DPAPI sẽ wrap trong tương lai).

Tab Email

Transport mặc định

• Outlook (mặc định).
• SMTP.
• EML file only.

SMTP config (nếu chọn SMTP)

• Host / Port / Username / Password / Use SSL.
• Hỗ trợ Gmail, Outlook.com, Yahoo, hoặc SMTP server riêng.

Signature

Paste HTML hoặc plain text. Sẽ chèn vào cuối body mọi email gửi qua Send Email.

Ví dụ HTML signature:

<p>Trân trọng,<br>
<strong>Đặng Văn Đằng</strong><br>
Project Manager — XYZ Construction<br>
📞 +84 xxx xxxxxx<br>
✉️ dang@xyz.com<br>
🌐 <a href="https://dvdpm.net">dvdpm.net</a></p>

Tab Cells and Rows

Default join separator

Khi dùng Join Text hoặc Join Merged:

• / (mặc định) — space-slash-space.
• , , , ; , \n, custom.

Merge AutoFit padding

Default cell padding (point) khi auto-fit merged cell row height. Mặc định 0. Tăng nếu cell bị quá khít (1-3 points).

Tab Graphics

Default rectangle color

Màu mặc định cho Draw Rectangle.

Picture click-to-enlarge

Toggle: khi click ảnh trong sheet, mở popup full-size?

• Tick → mở popup.
• Bỏ tick → click bình thường (Excel select).

Tab File and Print

Default PDF folder

Folder mặc định cho Batch Print → Export PDF.

PDF merger threads

Số thread khi PdfSharp gộp PDF. Mặc định 4. Tăng nếu máy mạnh, giảm nếu RAM thấp.

Default print copies

Số bộ in mặc định khi Batch Print → In.

Tab Schedule (DVD Cons tab)

Gantt chart default columns

Mapping cột mặc định khi vẽ Gantt — Predecessor cột nào, Duration cột nào, ...

Auto-calc toggle initial

Mặc định ON khi mở workbook mới.

Time format

Format cho ngày trên Gantt label: dd/MM/yyyy / dd/MM / MMM yyyy.

Reset toàn bộ Preferences

Click Reset to defaults (góc dưới dialog) → xóa tất cả settings trong HKCU\Software\DVD\DVDAddin\Preferences\* → restart Excel.

API keys + license KHÔNG bị xóa.

Sự kiện PreferencesChanged

Khi user click Save trong Preferences, một static event PreferencesChanged được phát ra trong addin. Các dialog modeless (Translate, AI Assistant) tự subscribe → reload UI ngay không cần restart Excel.

Liên quan

• Bản quyền — kích hoạt license.
• Translate — dùng AI key đã config ở đây.
• Send Email — dùng SMTP/signature đã config ở đây.