WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/did action

Contents

Description

Retrieve the number of times an action is fired.

Usage

<?php did_action$tag ); ?>

Parameters

$tag
(string) (required) The name of the action hook.
Default: None

Return Values

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

Examples

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

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' );

Notes

  • Uses global: (unknown type) $wp_actions

Change Log

Since: 2.1

Source File

did_action() is located in wp-includes/plugin.php.

Related

Actions: has_action(), add_action(), do_action(), do_action_ref_array(), did_action(), remove_action(), remove_all_actions()

See also index of Function Reference and index of Template Tags.