Function Reference/did action

来自WordPress中文文档
跳转至: 导航搜索

Description

Retrieve the number of times an action is fired.

Usage

%%%<?php did_action( $tag ); ?>%%%

Parameters

tt$tag/tt
(string) (required) The name of the action hook.
Default: Nonenoinclude

div class=template-description style=padding: 0 1.5em; border: 1px solid #eeeeee; background-color: #f9f9f9

Notes

This template is for standardizing how parameters look in the Function Reference and in Template Tags. Here is an example of this template being called: prenowiki检查到模板循环:模板:Parameter/nowiki/pre 检查到模板循环:模板:Parameter

The usage of this template is below: prenowiki检查到模板循环:模板:Parameter/nowiki/pre Let's take a closer look at the parameters..

name
The name of the parameter.
datatype
The datatype that should be given for this parameter when called.
  • string
  • integer
  • boolean
  • mixed
description
A short description of the parameter.
importance
Set this parameter to optional if the parameter is optional. Otherwise, do not declare this parameter—it defaults to required.
  • required
  • optional
default
If this parameter is optional, ttdefault/tt is the value that will be used if the parameter is not declared.

wordpress.org.cn /div /noinclude

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 onlyincludecodewp-includes/plugin.php/code/onlyinclude

div class=template-description style=padding: 0 1.5em; border: 1px solid #eeeeee; background-color: #f9f9f9

Template Description

Link to the source code on http://core.trac.wordpress.org/browser/.

Parameters

  1. filename
  2. (option) path to codetag/code (version) or codetrunk/code. This option is only used for a new function.br /Default: codetrunk/code -- trunk is the latest bleeding edge development version of WordPress.

Usage

Link to the stable version: pre检查到模板循环:模板:Trac/pre

Link to trunk: pre检查到模板循环:模板:Trac/pre

/div

wordpress.org.cn.

Related

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

includeonlydiv style=clear:both; background-color:#F7F7F7; border:1px solid #CCCCCC; color:#000000; padding:7px; margin:0.5em auto 0.5em auto; vertical-align:middle;See also index of Function Reference and index of Template Tags./div/includeonlynoinclude

Description

This Template is used by Codex:Template Messages.

Usage

pre 检查到模板循环:模板:Message /pre

Result

检查到模板循环:模板:Message

/noinclude