Weak hands cannot be planted, meager skills have no foundation. Shallow wisdom is futile, how can one hope for a good name?扰扰从役倦，屑屑身事微。少壮轻年月，迟暮惜光辉。
0,
'progress' => 0,
'currentTask' => null,
];
/**
* Update the status of the upgrade.
*
* @param array{total?:int|null,progress?:int|null,curentTask?:string|null} $status Status to update.
*
* @return void
*/
public function update_status( $status ) {
$defaults = [
'total' => 0,
'progress' => 0,
'currentTask' => null,
];
// Merge with existing status.
$status = wp_parse_args(
$status,
$this->status ? (array) $this->status : []
);
// Update status (merge with defaults).
$this->status = array_merge( $defaults, $status );
}
/**
* Update the status of the current task.
*
* @param array{total?:int,progress?:int,curentTask?:string}|null $task_status Status to update.
*
* @return void
*/
public function update_task_status( $task_status ) {
$defaults = [
'name' => '',
'total' => 0,
'progress' => 0,
];
if ( null === $task_status ) {
// Reset current task.
$this->status['currentTask'] = null;
} else {
// Merge with existing status.
$task_status = wp_parse_args(
$task_status,
$this->status['currentTask'] ? (array) $this->status['currentTask'] : []
);
// Update status (merge with defaults).
$this->status['currentTask'] = array_merge( $defaults, $task_status );
}
}
/**
* Send an event to the client.
*
* @param string $event Event name.
* @param mixed $data Data to send.
*
* @return void
*/
public function send_event( $event, $data = [] ) {
// Always send the status.
$data['status'] = $this->status;
if ( ! empty( $data['message'] ) ) {
plugin( 'logging' )->log( $data['message'] );
}
$data = \wp_json_encode( $data );
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo "event: {$event}" . PHP_EOL;
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo "data: {$data}" . PHP_EOL;
echo PHP_EOL;
$this->flush_buffers();
}
/**
* Start the upgrade process.
*
* @param int $total Number of upgrades.
* @param string $message Message to send.
*
* @return void
*/
public function start_upgrades( $total, $message = null ) {
$this->update_status( [
'total' => $total,
'progress' => 0,
'currentTask' => null,
] );
$this->send_event( 'upgrades:start', [
'message' => $message ? $message : __( 'Starting upgrades...', 'popup-maker' ),
] );
}
/**
* Complete the upgrade process.
*
* @param string $message Message to send.
*
* @return void
*/
public function complete_upgrades( $message = null ) {
$this->update_status( [
'progress' => $this->status['total'],
'currentTask' => null,
] );
$this->send_event( 'upgrades:complete', [
'message' => $message ? $message : __( 'Upgrades complete.', 'popup-maker' ),
] );
}
/**
* Start a task.
*
* @param string $name Task name.
* @param int $task_steps Number of steps in the task.
* @param string $message Message to send.
*
* @return void
*/
public function start_task( $name, $task_steps = 1, $message = null ) {
$this->update_task_status( [
'name' => $name,
'progress' => 0,
'total' => $task_steps,
] );
$this->send_event( 'task:start', [
'message' => $message ? $message : $name,
] );
}
/**
* Update the progress of the current task.
*
* @param int $progress Progress of the task.
*
* @return void
*/
public function update_task_progress( $progress ) {
$this->update_task_status( [
'progress' =>