วิธีสร้าง ERPNext Custom App ฉบับสมบูรณ์ 2026

App Title (default: My Custom App): My Custom App
App Description: Custom ERPNext modules for my business
App Publisher: Your Company Name
App Email: [email protected]
App Icon (default: octicon octicon-file-directory):
App Color (default: grey): #3498db
App License (default: MIT): MIT

apps/my_custom_app/
├── my_custom_app/
│   ├── __init__.py
│   ├── hooks.py              # สำคัญ! กำหนดพฤติกรรมของ App
│   ├── modules.txt           # รายชื่อ modules
│   ├── patches.txt           # database patches
│   ├── templates/
│   └── my_custom_app/        # module หลัก
│       ├── __init__.py
│       └── doctype/
├── setup.py
├── requirements.txt
└── README.md

frappe
erpnext
my_custom_app

my_custom_app/my_custom_app/doctype/custom_project_task/

{
  "name": "Custom Project Task",
  "module": "My Custom App",
  "doctype": "DocType",
  "engine": "InnoDB",
  "is_submittable": 1,
  "naming_rule": "By fieldname",
  "autoname": "field:task_name",
  "fields": [
    {
      "fieldname": "task_name",
      "fieldtype": "Data",
      "label": "Task Name",
      "reqd": 1,
      "unique": 1
    },
    {
      "fieldname": "description",
      "fieldtype": "Text Editor",
      "label": "Description"
    },
    {
      "fieldname": "column_break_1",
      "fieldtype": "Column Break"
    },
    {
      "fieldname": "status",
      "fieldtype": "Select",
      "label": "Status",
      "options": "Open\nIn Progress\nCompleted\nCancelled",
      "default": "Open"
    },
    {
      "fieldname": "priority",
      "fieldtype": "Select",
      "label": "Priority",
      "options": "Low\nMedium\nHigh\nCritical",
      "default": "Medium"
    },
    {
      "fieldname": "assigned_to",
      "fieldtype": "Link",
      "label": "Assigned To",
      "options": "User"
    },
    {
      "fieldname": "due_date",
      "fieldtype": "Date",
      "label": "Due Date"
    },
    {
      "fieldname": "project",
      "fieldtype": "Link",
      "label": "Project",
      "options": "Project"
    }
  ],
  "permissions": [
    {
      "role": "System Manager",
      "read": 1,
      "write": 1,
      "create": 1,
      "delete": 1,
      "submit": 1,
      "cancel": 1
    }
  ]
}

# my_custom_app/my_custom_app/doctype/custom_project_task/custom_project_task.py
 
import frappe
from frappe.model.document import Document
from frappe.utils import getdate, nowdate
 
class CustomProjectTask(Document):
    def validate(self):
        """ตรวจสอบข้อมูลก่อนบันทึก"""
        self.validate_due_date()
        self.set_priority_color()
 
    def validate_due_date(self):
        """ตรวจสอบว่า Due Date ไม่ใช่วันที่ผ่านมาแล้ว"""
        if self.due_date and getdate(self.due_date) < getdate(nowdate()):
            frappe.throw("Due Date ต้องไม่ใช่วันที่ผ่านมาแล้ว")
 
    def set_priority_color(self):
        """กำหนดสีตาม Priority"""
        color_map = {
            "Low": "green",
            "Medium": "blue",
            "High": "orange",
            "Critical": "red"
        }
        self.priority_color = color_map.get(self.priority, "grey")
 
    def on_submit(self):
        """เมื่อ Submit document"""
        self.notify_assigned_user()
 
    def notify_assigned_user(self):
        """ส่ง notification ไปยังผู้รับผิดชอบ"""
        if self.assigned_to:
            frappe.publish_realtime(
                event="new_task_assigned",
                message={
                    "task": self.name,
                    "task_name": self.task_name,
                    "assigned_by": frappe.session.user
                },
                user=self.assigned_to
            )

# my_custom_app/hooks.py
 
app_name = "my_custom_app"
app_title = "My Custom App"
app_publisher = "Your Company"
app_description = "Custom ERPNext modules"
app_version = "1.0.0"
 
# Document Events - Override พฤติกรรมของ Doctype อื่น
doc_events = {
    "Sales Invoice": {
        "on_submit": "my_custom_app.events.sales_invoice.on_submit",
        "on_cancel": "my_custom_app.events.sales_invoice.on_cancel"
    },
    "Customer": {
        "after_insert": "my_custom_app.events.customer.after_insert"
    }
}
 
# Scheduled Tasks - งานที่รันอัตโนมัติ
scheduler_events = {
    "daily": [
        "my_custom_app.tasks.daily.check_overdue_tasks"
    ],
    "hourly": [
        "my_custom_app.tasks.hourly.sync_external_data"
    ]
}
 
# Override Whitelisted Methods
override_whitelisted_methods = {
    "frappe.client.get_count": "my_custom_app.overrides.custom_get_count"
}
 
# Fixtures - ข้อมูลที่ต้อง export ไปกับ App
fixtures = [
    {"dt": "Custom Field", "filters": [["module", "=", "My Custom App"]]},
    {"dt": "Property Setter", "filters": [["module", "=", "My Custom App"]]},
    {"dt": "Role", "filters": [["name", "in", ["Custom Task Manager"]]]},
]
 
# Website Route Rules
website_route_rules = [
    {"from_route": "/tasks/<task>", "to_route": "task_detail"},
]

import frappe
 
def on_submit(doc, method):
    """ทำงานเมื่อ Sales Invoice ถูก Submit"""
    # เพิ่ม loyalty points ให้ลูกค้า
    add_loyalty_points(doc)
 
    # ส่ง notification
    send_invoice_notification(doc)
 
def add_loyalty_points(doc):
    """คำนวณและเพิ่ม loyalty points"""
    points = doc.grand_total // 100  # 1 point ต่อ 100 บาท
 
    if points > 0:
        frappe.get_doc({
            "doctype": "Loyalty Point Entry",
            "customer": doc.customer,
            "points": points,
            "invoice": doc.name
        }).insert(ignore_permissions=True)
 
def send_invoice_notification(doc):
    """ส่ง email แจ้งเตือนใบแจ้งหนี้"""
    frappe.sendmail(
        recipients=[doc.contact_email],
        subject=f"ใบแจ้งหนี้ {doc.name}",
        template="invoice_notification",
        args={"doc": doc}
    )
 
def on_cancel(doc, method):
    """ทำงานเมื่อ Sales Invoice ถูก Cancel"""
    # ยกเลิก loyalty points
    cancel_loyalty_points(doc)

// my_custom_app/public/js/custom_project_task.js
 
frappe.ui.form.on('Custom Project Task', {
    refresh: function(frm) {
        // เพิ่มปุ่ม custom
        if (frm.doc.status === 'Open') {
            frm.add_custom_button(__('Start Task'), function() {
                frm.set_value('status', 'In Progress');
                frm.save();
            }, __('Actions'));
        }
 
        if (frm.doc.status === 'In Progress') {
            frm.add_custom_button(__('Complete Task'), function() {
                frm.set_value('status', 'Completed');
                frm.save();
            }, __('Actions'));
        }
    },
 
    priority: function(frm) {
        // เปลี่ยนสี indicator ตาม priority
        const colors = {
            'Critical': 'red',
            'High': 'orange',
            'Medium': 'blue',
            'Low': 'green'
        };
        frm.set_indicator_formatter('priority', (doc) => colors[doc.priority]);
    },
 
    due_date: function(frm) {
        // แจ้งเตือนถ้า due date ใกล้จะถึง
        if (frm.doc.due_date) {
            const due = frappe.datetime.str_to_obj(frm.doc.due_date);
            const today = frappe.datetime.str_to_obj(frappe.datetime.nowdate());
            const diff = frappe.datetime.get_diff(due, today);
 
            if (diff <= 3 && diff >= 0) {
                frappe.show_alert({
                    message: __('Due date is approaching! Only {0} days left.', [diff]),
                    indicator: 'orange'
                });
            }
        }
    }
});

# hooks.py
fixtures = [
    # Export Custom Fields ทั้งหมดของ Module นี้
    {
        "dt": "Custom Field",
        "filters": [["module", "=", "My Custom App"]]
    },
 
    # Export Property Setters (การแก้ไข properties ของ field เดิม)
    {
        "dt": "Property Setter",
        "filters": [["module", "=", "My Custom App"]]
    },
 
    # Export Roles ที่สร้างขึ้น
    {
        "dt": "Role",
        "filters": [["name", "in", ["Custom Task Manager", "Task User"]]]
    },
 
    # Export Workflow
    {
        "dt": "Workflow",
        "filters": [["document_type", "=", "Custom Project Task"]]
    },
 
    # Export Print Format
    {
        "dt": "Print Format",
        "filters": [["doc_type", "=", "Custom Project Task"]]
    }
]

# my_custom_app/install.py
import frappe
from frappe.custom.doctype.custom_field.custom_field import create_custom_fields
 
def after_install():
    custom_fields = {
        "Customer": [
            {
                "fieldname": "loyalty_tier",
                "fieldtype": "Select",
                "label": "Loyalty Tier",
                "options": "Bronze\nSilver\nGold\nPlatinum",
                "insert_after": "customer_group"
            }
        ]
    }
    create_custom_fields(custom_fields)