# automatorwp/6.0.3/integrations/formatter/includes/actions/format-string.php

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

- Page: https://pluginprobe.com/plugins/automatorwp/6.0.3/code/integrations/formatter/includes/actions/format-string.php
- Raw: https://pluginprobe.com/plugins/automatorwp/6.0.3/raw/integrations/formatter/includes/actions/format-string.php
- Modified: 2026-09-30T10:02:50+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/6.0.3/code/integrations/formatter/includes/actions/format-string.php#L10-L20`.

```php
<?php
/**
 * Format String
 *
 * @package     AutomatorWP\Integrations\Formatter\Actions\Format_String
 * @author      AutomatorWP <contact@automatorwp.com>, Ruben Garcia <rubengcdev@gmail.com>
 * @since       1.0.0
 */
// Exit if accessed directly

if( !defined( 'ABSPATH' ) ) exit;

class AutomatorWP_Formatter_Format_String extends AutomatorWP_Integration_Action {

    public $integration = 'formatter';
    public $action = 'formatter_format_string';
    public $formatted = '';

    /**
     * Register the trigger
     *
     * @since 1.0.0
     */
    public function register() {

        automatorwp_register_action( $this->action, array(
            'integration'       => $this->integration,
            'label'             => __( 'Convert string into format', 'automatorwp' ),
            'select_option'     => __( 'Convert <strong>string</strong> into <strong>format</strong>', 'automatorwp' ),
            /* translators: %1$s: String. %2$s: Format */
            'edit_label'        => sprintf( __( 'Convert %1$s into %2$s', 'automatorwp' ), '{string}', '{format}' ),
            'log_label'         => sprintf( __( 'Convert %1$s into %2$s', 'automatorwp' ), '{string}', '{format}' ),
            'options'           => array(
                'string' => array(
                    'default' => __( 'string', 'automatorwp' ),
                    'fields' => array(
                        'string' => array(
                            'name' => __( 'String:', 'automatorwp' ),
                            'desc' => __( 'String to format.', 'automatorwp' ),
                            'type' => 'text',
                            'default' => ''
                        ),
                     ) ),
                'format' => array(
                    'from'  => 'format',
                    'default' => __( 'format', 'automatorwp' ),
                    'fields' => array(
                        'format' => array(
                            'name' => __( 'Format:', 'automatorwp' ),
                            'type' => 'select',
                            'classes' => 'automatorwp-selector',
                            'options_cb' => 'automatorwp_formatter_get_string_formats',
                            'attributes' => array(
                                'data-placeholder'       => __( 'Select a format', 'automatorwp' ),
                            ),
                            'default' => '',
                        ),
                    )
                ),
            ),
            'tags'  => automatorwp_formatter_get_actions_string_tags()
        ) );

    }

    /**
     * Action execution function
     *
     * @since 1.0.0
     *
     * @param stdClass  $action             The action object
     * @param int       $user_id            The user ID
     * @param array     $action_options     The action's stored options (with tags already passed)
     * @param stdClass  $automation         The action's automation object
     */
    public function execute( $action, $user_id, $action_options, $automation ) {

        // Shorthand
        $string = $action_options['string'];
        $format = $action_options['format'];

        // Bail if not data
        if ( empty( $string ) ) {
            $this->result = __( 'Please, insert a string to be formatted', 'automatorwp' );
            return;
        }

        // Bail if not position
        if ( empty( $format ) ) {
            $this->result = __( 'Please, select a format', 'automatorwp' );
            return;
        }

        // Format string      
        $this->formatted = automatorwp_formatter_get_formatted_string( $format, $string );
        
        $this->result = sprintf( __( '%s', 'automatorwp' ), $this->formatted );

    }

    /**
     * Register required hooks
     *
     * @since 1.0.0
     */
    public function hooks() {

        // Log meta data
        add_filter( 'automatorwp_user_completed_action_log_meta', array( $this, 'log_meta' ), 10, 5 );

        // Log fields
        add_filter( 'automatorwp_log_fields', array( $this, 'log_fields' ), 10, 5 );

        parent::hooks();

    }

    /**
     * Action custom log meta
     *
     * @since 1.0.0
     *
     * @param array     $log_meta           Log meta data
     * @param stdClass  $action             The action object
     * @param int       $user_id            The user ID
     * @param array     $action_options     The action's stored options (with tags already passed)
     * @param stdClass  $automation         The action's automation object
     *
     * @return array
     */
    public function log_meta( $log_meta, $action, $user_id, $action_options, $automation ) {

        // Bail if action type don't match this action
        if( $action->type !== $this->action ) {
            return $log_meta;
        }

        // Store the action's result
        $log_meta['result'] = $this->result;
        $log_meta['formatted'] = ( isset( $this->formatted ) ? $this->formatted : '' );

        return $log_meta;
    }

    /**
     * Action custom log fields
     *
     * @since 1.0.0
     *
     * @param array     $log_fields The log fields
     * @param stdClass  $log        The log object
     * @param stdClass  $object     The trigger/action/automation object attached to the log
     *
     * @return array
     */
    public function log_fields( $log_fields, $log, $object ) {

        // Bail if log is not assigned to an action
        if( $log->type !== 'action' ) {
            return $log_fields;
        }

        // Bail if action type don't match this action
        if( $object->type !== $this->action ) {
            return $log_fields;
        }

        $log_fields['result'] = array(
            'name' => __( 'Result:', 'automatorwp' ),
            'type' => 'text',
        );

        return $log_fields;
    }

}

new AutomatorWP_Formatter_Format_String();
```