Event Hook: `add_beforesave()` in Merciglobal Cloud ERP

📘 Overview

The add_beforesave() event hook in Merciglobal Cloud ERP allows developers to inject custom logic before a new record is saved to the database. It is typically used for validation, data manipulation, or conditional blocking of the save operation.

🧩 Syntax

function {tablename}_add_beforesave() {
    global $data;
    // Your custom logic here
    return false; // return true to allow save, false to abort
}

🔢 Parameters

global $data: This global variable contains the data that is about to be saved.

🔁 Return Values

Return Value	Description
`true`	Proceed with saving the record.
`false`	Cancel the save operation.

💡 Common Use Cases

✅ Validation: Ensure required fields meet certain criteria.
✅ Authorization: Verify if the user has permission to add the data.
✅ Data Cleanup: Modify fields (e.g., trimming whitespace).
✅ Block Save: Halt saving based on conditions.

🧪 Example: Prevent Save if Email is Missing

function customer_add_beforesave() {
    global $data;
    if (empty($data['email'])) {
        msg("Email address is required.");
        return false;
    }
    return true;
}

🛠️ Developer Tips

🔐 Use msg() to inform users why saving was blocked.
🧾 Function name must strictly follow: {tablename}_add_beforesave()
🧪 Test thoroughly in a staging environment.

✅ Best Practices

Keep the function lightweight and focused.
Avoid complex or time-consuming operations.
Use logs for debugging complex validations.

add_aftersave() – Executes after a successful save.
edit_beforesave() – Applies logic before updating existing records.

📌 Conclusion

The add_beforesave() hook is essential for enforcing data quality and business rules in Merciglobal Cloud ERP. Proper use ensures that only valid, authorized data enters your ERP, enhancing overall system integrity.

Master the hook. Elevate your ERP. 🛡️🚀

Event Hook: add_beforesave() in Merciglobal Cloud ERP