Action uncanny-automator

automator_action_been_process_further

Fires after an Automator action has been processed and is ready for further execution steps.

add_action( 'automator_action_been_process_further', $callback, 10, 1 );

Description

Fires after an action has been flagged to be processed further within the Uncanny Automator recipe execution. Developers can use this hook to trigger custom logic based on an action's 'process_further' status. This is an internal hook and should generally not be modified directly.

Usage

add_action( 'automator_action_been_process_further', 'your_function_name', 10, 1 );

Parameters

$action (mixed): This parameter contains an array of data related to the action that has just been processed and may require further processing.

Examples

<?php

/**
 * Example of using the 'automator_action_been_process_further' hook.
 *
 * This function logs details about an action that is about to be processed further.
 * It's useful for debugging or tracking the flow of Uncanny Automator recipes.
 *
 * @param array $action The action data array. Expected to be an array.
 */
function my_automator_log_action_further_processing( $action ) {
    // Ensure the $action parameter is an array before proceeding.
    if ( ! is_array( $action ) ) {
        error_log( 'automator_action_been_process_further received non-array $action parameter.' );
        return;
    }

    // Log the action ID and title for clarity.
    $action_id   = isset( $action['ID'] ) ? $action['ID'] : 'N/A';
    $action_title = isset( $action['title'] ) ? $action['title'] : 'Unnamed Action';

    // You could also log other relevant details from the $action array if needed.
    // For example: $recipe_id = isset($action['recipe_id']) ? $action['recipe_id'] : 'N/A';

    error_log( sprintf(
        'Uncanny Automator: Action "%s" (ID: %s) is being processed further.',
        $action_title,
        $action_id
    ) );

    // This is an action hook, so no return value is necessary.
}
add_action( 'automator_action_been_process_further', 'my_automator_log_action_further_processing', 10, 1 );

Placement

This code should be placed in the functions.php file of your active theme, a custom plugin, or using a code snippets plugin.

Source Code

src/core/lib/process/class-automator-recipe-process-complete.php:433

'args'        => $action_args,
			);

			$action = apply_filters( 'automator_before_action_executed', $action, $args );

			if ( isset( $action['process_further'] ) ) {

				do_action( 'automator_action_been_process_further', $action );

				if ( false === $action['process_further'] ) {
					$action = apply_filters( 'automator_action_complete_action_skipped', $action, $args );
					Automator()->wp_error->add_error( 'complete_action', 'Action was skipped by uap_before_action_executed filter' );

					return false;
				}