Loops

Item hooks repeat during rendering, preview, and pagination; scope work to the intended loop.

Shared Hooks

$actionData['propertiesData'] contains loop properties. Item contexts can be posts, terms, or fields; check type:

add_filter('breakdance_loop_item_classes', function ($classes, $object, $objectType, $actionData) {
    if ($objectType === 'post' && $object instanceof WP_Post
        && $object->post_type === 'event') {
        $classes .= ' acme-event-item';
    }
    return $classes;
}, 10, 4);

Loop Builder Actions

Post Loop Builder emits breakdance_posts_loop_before_loop, breakdance_posts_loop_before_post, breakdance_posts_loop_after_post, breakdance_posts_loop_after_loop, and breakdance_posts_loop_after_pagination.

Term Loop Builder emits breakdance_terms_loop_before_loop, breakdance_terms_loop_before_term, breakdance_terms_loop_after_term, breakdance_terms_loop_after_loop, and breakdance_terms_loop_after_pagination.

Each receives $actionData and ignores returns; echo markup where needed. Item actions surround the wrapper. Empty branches may omit normal hooks, and other loop elements may not emit these hooks.

Posts List Actions

The Posts List element has its own hooks for inserting markup at specific points:

add_action('breakdance_posts_list_after_title', function () {
    echo '<p class="post-note">' . esc_html(get_the_date()) . '</p>';
});

These are the Posts List hooks documented on GitHub. They are separate from the Post Loop Builder hooks above.