# automatorwp/5.8.5/includes/actions.php

AutomatorWP – No-Code Workflow Automation, Integration & Webhooks Plugin, now with AI, version 5.8.5. 371 lines.

- Page: https://pluginprobe.com/plugins/automatorwp/5.8.5/code/includes/actions.php
- Raw: https://pluginprobe.com/plugins/automatorwp/5.8.5/raw/includes/actions.php
- Modified: 2026-08-20T08:53:54+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/automatorwp/5.8.5/code/includes/actions.php#L10-L20`.

```php
<?php
/**
 * Actions
 *
 * @package     AutomatorWP\Actions
 * @author      AutomatorWP <contact@automatorwp.com>, Ruben Garcia <rubengcdev@gmail.com>
 * @since       1.0.0
 */
// Exit if accessed directly
if( !defined( 'ABSPATH' ) ) exit;

/**
 * Registers a new action
 *
 * @since 1.0.0
 *
 * @param string    $action The action key
 * @param array     $args   The action arguments
 */
function automatorwp_register_action( $action, $args ) {

    $args = wp_parse_args( $args, array(
        'integration'       => '',
        'label'             => '',
        'select_option'     => '',
        'show_in_selector'  => true,
        'edit_label'        => '',
        'options'           => array(),
        'tags'              => array(),
    ) );

    /**
     * Filter to extend registered action arguments
     *
     * @since 1.0.0
     *
     * @param array     $args   The action arguments
     * @param string    $action The action key
     *
     * @return array
     */
    $args = apply_filters( 'automatorwp_register_action_args', $args, $action );

    // Sanitize options setup
    foreach( $args['options'] as $option => $option_args ) {

        if( in_array( $option, array( 'action', 'nonce', 'id', 'item_type', 'option_name' ) ) ) {
            _doing_it_wrong( __FUNCTION__, sprintf( __( 'Action "%s" has the option key "%s" that is not allowed', 'automatorwp' ), $action, $option ), null );
            return;
        }

    }

    $log_duplications = apply_filters( 'automatorwp_log_duplications', false );

    if( $log_duplications && isset( AutomatorWP()->actions[$action] ) ) {
        error_log( sprintf( __( 'Possible action duplication with the key "%s"', 'automatorwp' ), $action ) );
    }

    AutomatorWP()->actions[$action] = $args;

}

/**
 * Get registered actions
 *
 * @since 1.0.0
 *
 * @return array
 */
function automatorwp_get_actions() {

    return AutomatorWP()->actions;

}

/**
 * Get an action
 *
 * @since 1.0.0
 *
 * @param string $action
 *
 * @return array|false
 */
function automatorwp_get_action( $action ) {

    $action_args = ( isset( AutomatorWP()->actions[$action] ) ? AutomatorWP()->actions[$action] : false );

    /**
     * Available filter to override the action args
     *
     * @since 1.0.0
     *
     * @param array|false $action_args
     * @param string $action
     *
     * @return array|false
     */
    return apply_filters( 'automatorwp_get_action', $action_args, $action );

}

/**
 * Get an integration actions
 *
 * @since 1.0.0
 *
 * @param string    $integration    The integration key
 * @param array     $filters        Filters to filter triggers by args
 *
 * @return array
 */
function automatorwp_get_integration_actions( $integration, $filters = array() ) {

    $actions = array();

    foreach( AutomatorWP()->actions as $action => $args ) {

        if( $args['integration'] !== $integration ) {
            continue;
        }

        // If filters defined, apply them
        if( is_array( $filters ) && ! empty( $filters ) ) {

            $pass_filters = true;

            foreach( $filters as $filter_key => $filter_value ) {

                // Check if argument exists
                if( ! isset( $args[$filter_key] ) ) {
                    $pass_filters = false;
                }

                // Check if argument value matches
                if( $args[$filter_key] !== $filter_value ) {
                    $pass_filters = false;
                }

            }

            // Skip this item if filters not passed
            if( ! $pass_filters ) {
                continue;
            }
        }

        $actions[$action] = $args;

    }

    /**
     * Available filter to extend integration actions
     *
     * @since 1.0.0
     *
     * @param array     $actions
     * @param string    $integration
     *
     * @return array
     */
    return apply_filters( 'automatorwp_get_integration_actions', $actions, $integration );

}

/**
 * Get the action object data
 *
 * @param int       $action_id      The action ID
 * @param string    $output         Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which correspond to
 *                                  a object, an associative array, or a numeric array, respectively. Default OBJECT.
 * @return array|stdClass|null
 */
function automatorwp_get_action_object( $action_id, $output = OBJECT ) {

    ct_setup_table( 'automatorwp_actions' );

    $action = ct_get_object( $action_id );

    ct_reset_setup_table();

    return $action;

}

/**
 * Get the action object data
 *
 * @param int       $action_id      The action ID
 * @param string    $meta_key       Optional. The meta key to retrieve. By default, returns
 *                                  data for all keys. Default empty.
 * @param bool      $single         Optional. Whether to return a single value. Default false.
 *
 * @return mixed                    Will be an array if $single is false. Will be value of meta data field if $single is true.
 */
function automatorwp_get_action_meta( $action_id, $meta_key = '', $single = false ) {

    ct_setup_table( 'automatorwp_actions' );

    $meta_value = ct_get_object_meta( $action_id, $meta_key, $single );

    ct_reset_setup_table();

    return $meta_value;

}

/**
 * Get the action's automation object
 *
 * @since 1.0.0
 *
 * @param int $action_id    The action ID
 *
 * @return stdClass|false   The automation object or false
 */
function automatorwp_get_action_automation( $action_id ) {

    $action = automatorwp_get_action_object( $action_id );

    if( ! $action ) {
        return false;
    }

    $automation = automatorwp_get_automation_object( $action->automation_id );

    return $automation;

}

/**
 * Get the action's stored options
 *
 * @since 1.0.0
 *
 * @param int   $action_id      The action ID
 * @param bool  $single_level   The level of options array, if is set to try, only option fields will be returned
 *
 * @return array                The action options.
 *                              Stored options format wit $single_level=true:
 *                              array(
 *                                  'field_id' => 'value'
 *                              )
 *                              Stored options format wit $single_level=false:
 *                              array(
 *                                  'option' => array(
 *                                      'field_id' => 'value'
 *                                  )
 *                              )
 */
function automatorwp_get_action_stored_options( $action_id, $single_level = true ) {

    $object = automatorwp_get_action_object( $action_id );

    if( ! $object ) {
        return array();
    }

    $action = automatorwp_get_action( $object->type );

    if( ! $action ) {
        return array();
    }

    ct_setup_table( 'automatorwp_actions' );

    $options = array();
 
    foreach( $action['options'] as $option => $option_args ) {

        if( ! isset( $option_args['fields'] ) ) {
            continue;
        }

        if( ! $single_level ) {
            $options[$option] = array();
        }

        foreach( $option_args['fields'] as $field_id => $field ) {

            $value = ct_get_object_meta( $object->id, $field_id, true );

            // Fallback to default attribute if value is empty
            if( ( $value === '' || $value === null ) && isset( $field['default'] ) ) {
                $value = $field['default'];
            }

            if( isset( $field['option_custom'] ) && $field['option_custom']     // If option_custom is enabled
                && $value === $field['option_custom_value']                     // Value is setup to use the custom value
                && isset( $option_args['fields'][$field_id . '_custom'] ) ) {   // Isset the custom field
                $value = ct_get_object_meta( $object->id, $field_id . '_custom', true );
            }

            if( $single_level ) {
                $options[$field_id] = $value;
            } else {
                $options[$option][$field_id] = $value;
            }


        }

    }

    ct_reset_setup_table();

    return $options;

}

/**
 * Check if action is in use
 *
 * @since 1.4.3
 *
 * @param string $action
 *
 * @return bool
 */
function automatorwp_is_action_in_use( $action ) {

    $actions_in_user = automatorwp_get_actions_in_use();

    // Check if this action is not in use
    return (bool) in_array( $action, $actions_in_user );

}

/**
 * Get all actions in use
 *
 * @since 1.4.3
 *
 * @return array
 */
function automatorwp_get_actions_in_use() {

    global $wpdb;

    $ct_table = ct_setup_table( 'automatorwp_actions' );

    // Check if table exists, just to avoid issues on first install
    if( ! $ct_table->db->exists() ) {
        ct_reset_setup_table();
        return array();
    }

    $cache = automatorwp_get_cache( 'actions_in_use', false, false );

    // If result already cached, return it
    if( is_array( $cache ) ) {
        ct_reset_setup_table();
        return $cache;
    }

    $actions_in_use = array();
    $results = $wpdb->get_results( "SELECT t.type FROM {$ct_table->db->table_name} AS t GROUP BY t.type" );

    ct_reset_setup_table();

    if( is_array( $results ) && count( $results ) ) {
        $actions_in_use = wp_list_pluck( $results, 'type' );
    }

    // Cache function result
    automatorwp_set_cache( 'actions_in_use', $actions_in_use );

    return $actions_in_use;

}
```