Action Hooks

add_action('plugins_loaded', 'my_custom_function');

function my_custom_function() {
    // Your code here
    // Runs after all plugins are loaded
}

add_action('fl_builder_init_ui', 'my_builder_ui_init');

function my_builder_ui_init() {
    // Add custom UI elements
    // Enqueue custom scripts/styles for the builder
}

add_action('fl_builder_ui_enqueue_scripts', 'my_custom_ui_assets');

function my_custom_ui_assets() {
    wp_enqueue_script(
        'my-builder-script',
        plugin_dir_url(__FILE__) . 'js/builder-custom.js',
        array('jquery'),
        '1.0.0',
        true
    );
}

add_action('wp_enqueue_scripts', 'my_layout_assets', 12);

function my_layout_assets() {
    // Enqueue after builder's assets (priority 11)
    if (FLBuilderModel::is_builder_enabled()) {
        wp_enqueue_style('my-layout-styles', ...);
    }
}

add_action('fl_before_sortable_enqueue', 'my_before_sortable');

function my_before_sortable() {
    // Customize sortable behavior
    // Deregister conflicting scripts
}

add_action('fl_builder_before_save_layout', 'validate_layout_before_save', 10, 2);

function validate_layout_before_save($post_id, $publish) {
    // Validate layout data
    // Log saving activity
    // Trigger external integrations
}

add_action('fl_builder_after_save_layout', 'after_layout_save', 10, 2);

function after_layout_save($post_id, $publish) {
    if ($publish) {
        // Clear custom caches
        // Send notifications
        // Sync with external systems
    }
}

add_action('fl_builder_render_content_start', 'before_render_content');

function before_render_content() {
    // Set up rendering context
    // Initialize custom data
}

add_action('fl_builder_before_render_content', 'add_before_content');

function add_before_content() {
    echo '<div class="my-custom-wrapper">';
}

add_action('fl_builder_after_render_content', 'add_after_content');

function add_after_content() {
    echo '</div><!-- .my-custom-wrapper -->';
}

add_action('fl_builder_render_content_complete', 'after_content_complete');

function after_content_complete() {
    // Clean up rendering context
    // Output analytics code
}

add_action('fl_did_render_content_filter', 'post_render_actions');

function post_render_actions() {
    // Actions after content is filtered
}

add_action('fl_builder_before_render_nodes', 'setup_nodes');

function setup_nodes() {
    // Initialize node-specific data
}

add_action('fl_builder_after_render_nodes', 'cleanup_nodes');

function cleanup_nodes() {
    // Clean up node-specific data
}

add_action('fl_builder_before_render_rows', 'before_rows', 10, 1);

function before_rows($rows) {
    // $rows is an array of row objects
    // Prepare row data
}

add_action('fl_builder_after_render_rows', 'after_rows', 10, 1);

function after_rows($rows) {
    // Clean up after rows
}

add_action('fl_builder_before_render_row', 'before_row', 10, 2);

function before_row($row, $groups) {
    // $row: row object
    // $groups: column groups in this row
    echo '<div class="custom-row-wrapper" data-row-id="' . $row->node . '">';
}

add_action('fl_builder_after_render_row', 'after_row', 10, 2);

function after_row($row, $groups) {
    echo '</div><!-- .custom-row-wrapper -->';
}

add_action('fl_builder_before_render_row_bg', 'before_row_bg', 10, 1);

function before_row_bg($row) {
    // Add custom background elements
}

add_action('fl_builder_after_render_row_bg', 'after_row_bg', 10, 1);

function after_row_bg($row) {
    // Add overlays or effects
}

add_action('fl_builder_before_render_column_group', 'before_col_group', 10, 2);

function before_col_group($group, $cols) {
    // $group: column group object
    // $cols: array of column objects
}

add_action('fl_builder_after_render_column_group', 'after_col_group', 10, 2);

function after_col_group($group, $cols) {
    // Clean up column group
}

add_action('fl_builder_before_render_column', 'before_column', 10, 1);

function before_column($col) {
    // Add custom column wrappers
}

add_action('fl_builder_after_render_column', 'after_column', 10, 1);

function after_column($col) {
    // Close custom column wrappers
}

add_action('fl_builder_before_render_modules', 'before_modules', 10, 2);

function before_modules($nodes, $col_id) {
    // $nodes: array of module objects
    // $col_id: parent column ID
}

add_action('fl_builder_after_render_modules', 'after_modules', 10, 2);

function after_modules($nodes, $col_id) {
    // Clean up module rendering
}

add_action('fl_builder_before_render_module', 'before_module', 10, 1);

function before_module($module) {
    // Add custom module wrappers
    echo '<div class="custom-module-wrapper">';
}

add_action('fl_builder_after_render_module', 'after_module', 10, 1);

function after_module($module) {
    echo '</div><!-- .custom-module-wrapper -->';
}

add_action('fl_builder_render_module_html_before', 'before_module_html', 10, 3);

function before_module_html($type, $settings, $module) {
    // Modify context before module template
}

add_action('fl_builder_render_module_html_after', 'after_module_html', 10, 3);

function after_module_html($type, $settings, $module) {
    // Clean up after module template
}

add_action('fl_builder_hidden_node', 'handle_hidden_node', 10, 1);

function handle_hidden_node($node) {
    // Handle hidden nodes
    // Log hidden elements
}

add_action('fl_builder_render_custom_css_for_editing', 'custom_editor_css');

function custom_editor_css() {
    echo '<style>.fl-builder-custom { color: red; }</style>';
}

add_action('fl_builder_after_render_css', 'after_css_render');

function after_css_render() {
    // Minify CSS
    // Add critical CSS
}

add_action('fl_builder_pre_render_global_css', 'before_global_css');

function before_global_css() {
    // Modify global CSS context
}

add_action('fl_ajax_before_call_action', 'before_ajax', 10, 1);

function before_ajax($action) {
    // Log AJAX requests
    error_log('BB AJAX Action: ' . $action);
}

add_action('fl_ajax_before_save_settings', 'before_save', 10, 1);

function before_save($args) {
    // Validate settings before save
}

add_action('fl_ajax_after_save_layout', 'after_save_layout', 10, 1);

function after_save_layout($args) {
    // Clear caches
    // Trigger webhooks
}

add_action('fl_builder_render_content_complete', 'add_analytics_tracking');

function add_analytics_tracking() {
    if (FLBuilderModel::is_builder_active()) {
        return; // Don't track in builder
    }
    
    ?>
    <script>
        // Track page view with builder content
        gtag('event', 'builder_page_view', {
            'post_id': <?php echo get_the_ID(); ?>
        });
    </script>
    <?php
}

add_action('fl_builder_after_save_layout', 'log_layout_changes', 10, 2);

function log_layout_changes($post_id, $publish) {
    $user = wp_get_current_user();
    $log_entry = sprintf(
        '[%s] User %s %s layout for post %d',
        current_time('mysql'),
        $user->display_name,
        $publish ? 'published' : 'saved draft of',
        $post_id
    );
    
    error_log($log_entry);
}

add_action('fl_builder_before_render_module', 'add_module_analytics_wrapper');
add_action('fl_builder_after_render_module', 'close_module_analytics_wrapper');

function add_module_analytics_wrapper($module) {
    echo '<div class="module-track" data-module-type="' . $module->slug . '">';
}

function close_module_analytics_wrapper($module) {
    echo '</div>';
}