Helpers PHP

FlowKit expone helpers PHP en la clase Flowtitude_Helpers (alias Flowtitude\Helpers) para tareas recurrentes de seguridad, assets y layout.


Seguridad

Cifrado AES-256

Para almacenar claves de API u otros valores sensibles en opciones de WordPress:

use Flowtitude\Helpers;

// Guardar
$encrypted = Helpers::encrypt($api_key);
update_option('mi_plugin_key', $encrypted);

// Leer
$api_key = Helpers::decrypt(get_option('mi_plugin_key'));

Hash de integridad

Todos los archivos críticos se validan con SHA-256 (nunca MD5). Si necesitas el mismo patrón:

Helpers::hash_file($path);

Assets

Encolar por panel

FlowKit carga scripts condicionalmente por pantalla admin. Para aprovechar el mismo patrón en tu código:

add_action('admin_enqueue_scripts', function ($hook) {
    if (!Helpers::is_flowkit_panel($hook, 'ecommerce')) {
        return;
    }
    wp_enqueue_script('mi-script', plugin_dir_url(__FILE__) . 'admin.js', [], '1.0');
});

Prioridad de enqueue en Bricks

En frontend, los scripts que deban cargar después de Bricks usan prioridad alta:

add_action('wp_enqueue_scripts', 'mi_script_loader', 1000000);

Sanitización y output

FlowKit enforce las buenas prácticas de WordPress. Helpers no reinventa: sigue usando las funciones core.

esc_html($input)
esc_attr($value)
esc_url($url)
wp_kses_post($html)
sanitize_text_field($_POST['field'])
sanitize_key($_POST['action'])

Y para SQL custom:

$wpdb->prepare("SELECT * FROM table WHERE id = %d", $id);

AJAX y nonces

Patrón estándar para endpoints AJAX desde el admin:

add_action('wp_ajax_mi_accion', function () {
    check_ajax_referer('mi-nonce-action', 'nonce');

    if (!current_user_can('manage_options')) {
        wp_send_json_error('Forbidden', 403);
    }

    $value = sanitize_text_field($_POST['value'] ?? '');
    wp_send_json_success(['result' => $value]);
});

Nunca saltes nonces ni capabilities

Todos los endpoints AJAX y formularios deben verificar nonce y capability. FlowKit lo hace en su core; tu código custom debe seguir el mismo patrón.

Referencia completa

La lista de helpers crece con cada release. El código fuente vive en inc/class-flowtitude-helpers.php del theme instalado — es la fuente de verdad.