PerchAPI_SubmittedForm

When a Perch-templated form is submitted, Perch adds the submitted data along with other information to an instance of the PerchAPI_SubmittedForm class and use it as the function argument when calling the specified app’s form handler function.

<perch:form id="comment" app="company_app" method="post"></perch:form>

Your app’s form handler function must be added as a runtime function. It should be called {your_app_ID}_form_handler:

function company_app_form_handler($SubmittedForm) {}

Properties

Example

function company_app_form_handler($SubmittedForm) {
    if($SubmittedForm->validate()) {
        switch($SubmittedForm->formID) {
            case 'comment':
            // submission came from <perch:form id="comment" app="company_app"></perch:form>
            break;

            case 'register':
            // submission came from <perch:form id="register" app="company_app"></perch:form>
            break;
        }
    }
}