did_action( string $tag )

Retrieve the number of times an action is fired.


Description Description


Parameters Parameters

$tag

(string) (Required) The name of the action hook.


Top ↑

Return Return

(int) The number of times action hook $tag is fired.


Top ↑

Source Source

File: wp-includes/plugin.php

480
481
482
483
484
485
486
487
488
function did_action( $tag ) {
    global $wp_actions;
 
    if ( ! isset( $wp_actions[ $tag ] ) ) {
        return 0;
    }
 
    return $wp_actions[ $tag ];
}

Top ↑

Changelog Changelog

Changelog
Version Description
2.1.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Codex

    Example

    Using did_action() function to make sure custom meta field is only added during the first run since it can run multiple times.

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    function my_sticky_option()
    {
        global $post;
     
        // if the post is a custom post type and only during the first execution of the action quick_edit_custom_box
        if ( $post->post_type == 'custom_post_type' && did_action( 'quick_edit_custom_box' ) === 1 )
        {
    ?>
     
        <fieldset class="inline-edit-col-right">
            <div class="inline-edit-col">
                <label class="alignleft">
                    <input type="checkbox" name="sticky" value="sticky" />
                    <span class="checkbox-title">
                        <?php _e( 'Featured (sticky)', 'textdomain_string' ); ?>
                    </span>
                </label>
            </div>
        </fieldset>
    <?php
        } // endif;
    }
    // add the sticky option to the quick edit area
    add_action( 'quick_edit_custom_box', 'my_sticky_option' );

You must log in before being able to contribute a note or feedback.