wp_schedule_single_event( int $timestamp, string $hook, array $args = array(), bool $wp_error = false ): bool|WP_Error

使用示例

• 示例1

  计划一小时后的事件

  function do_this_in_an_hour() {
  
      // do something
  }
  add_action( 'my_new_event','do_this_in_an_hour' );
  
  // put this line inside a function, 
  // presumably in response to something the user does
  // otherwise it will schedule a new event on every page visit
  
  wp_schedule_single_event( time() + 3600, 'my_new_event' );
  
  // time() + 3600 = one hour from now.

• 示例2

  用参数计划一小时后的事件

  function do_this_in_an_hour( $arg1, $arg2, $arg3 ) {
      // do something
  }
  add_action( 'my_new_event', 'do_this_in_an_hour', 10, 3 );
  
  // put this line inside a function, 
  // presumably in response to something the user does
  // otherwise it will schedule a new event on every page visit
  
  wp_schedule_single_event( time() + 3600, 'my_new_event', array( $arg1, $arg2, $arg3 ) );
  
  // time() + 3600 = one hour from now.

• 示例3

  文档中说：“请注意，除非为每个计划的事件传递唯一的$args值，否则将忽略使用相同的动作钩子在现有事件发生后10分钟内的计划任务事件。”

  代码显示，否则，$args上没有重复检查，只有10分钟的时间。。

• 示例4

  在计划时考虑使用WordPress的time常量。

  例子：

  wp_schedule_single_event( time() + (DAY_IN_SECONDS * 5), 'some_hook_name', array( $arg1, $arg2, $arg3 ) );

  安排5天后将发生的事件。