{"id":1622635,"date":"2020-05-13T14:24:10","date_gmt":"2020-05-13T14:24:10","guid":{"rendered":"https:\/\/toolset.com\/?post_type=course-lesson&p=1622635"},"modified":"2021-01-19T07:06:46","modified_gmt":"2021-01-19T07:06:46","slug":"extending-form-functionality-with-hooks","status":"publish","type":"course-lesson","link":"https:\/\/toolset.com\/fr\/course-lesson\/extending-form-functionality-with-hooks\/","title":{"rendered":"Extending Form Functionality with Hooks"},"content":{"rendered":"\n

Toolset Forms API allows you to hook into different events of submitting a form. For example, you can add a custom action right before saving or processing any form data, but after the form was validated. <\/p>\n\n\n\n

Or, you could add a custom type of an event that triggers notifications. The possibilities are limitless.<\/p>\n\n\n\n

To use the Toolset Forms API, you will need a good knowledge of PHP.<\/p><\/blockquote>\n\n\n\n

Adding custom PHP from the WordPress admin<\/h2>\n\n\n\n

Toolset allows you to add any custom PHP code directly from the WordPress admin. This is great because you don’t have to create a child theme to add custom PHP code. You also don’t need to edit any PHP files.<\/p>\n\n\n\n

Use the following steps to add custom PHP code to your site:<\/p>\n\n\n\n

  1. Go to the Toolset<\/strong> \u2192 Settings<\/strong> page and click the Custom Code<\/strong> tab.<\/li>
  2. To add a code snippet, click the Add new<\/strong> button, type in the name (slug), and click Create<\/strong>.<\/li>
  3. Your snippet is created and listed on the page. Click on its name to edit its options and add code to it.<\/li><\/ol>\n\n\n\n

    Check out the related page to learn more about using Toolset to add custom code<\/a>.<\/p>\n\n\n\n

    Examples of using the Forms API<\/h2>\n\n\n\n

    To help you get started, let’s take a look at some of the common uses of Forms API.<\/p>\n\n\n\n

    Create a post when registering a user<\/h3>\n\n\n\n

    After using a Toolset User form to register a user, you might need to automatically create a custom post for this new user. For example, when someone registers on the site about events, you could create a separate post in the “attendees” post type.<\/p>\n\n\n\n

    To achieve this, you can use the cred_save_data<\/a> API hook:<\/p>\n\n\n\n\n

    \n Create a post when registering a user<\/a>\n
    \n 
    add_action('cred_save_data', 'my_save_data_action',10,2);\r\nfunction my_save_data_action($post_id, $form_data) {\r\n    if ($form_data['id']==9999) {     \/\/ replace with your form's ID\r\n    {  \r\n         \/\/ Create new entry after registration.\r\n         $my_post = array(\r\n             'post_title'\t=> 'Attendee',  \/\/ adjust the title\r\n             'post_content'  => '',\r\n             'post_status'   => 'publish',\r\n             'post_author'   => 1,  \/\/ adjust post_author if\/as required\r\n             'post_type' => 'attendees'   \/\/ replace with the slug of your post type\r\n    );\r\n       \r\n    \/\/ Insert the post into the database\r\n    wp_insert_post( $my_post );\r\n    }\r\n}<\/pre>\n