register();
}
/**
* Registers widget.
*/
public function register() {
$widget_ops = [
'classname' => $this->widget_cssclass,
'description' => $this->widget_description,
];
parent::__construct( $this->widget_id, $this->widget_name, $widget_ops );
add_action( 'save_post', [ $this, 'flush_widget_cache' ] );
add_action( 'deleted_post', [ $this, 'flush_widget_cache' ] );
add_action( 'switch_theme', [ $this, 'flush_widget_cache' ] );
}
/**
* Checks for cached version of widget and outputs it if found.
*
* @param array $args
* @return bool
*/
public function get_cached_widget( $args ) {
if ( empty( $args['widget_id'] ) ) {
return false;
}
$cache = wp_cache_get( $this->widget_id, 'widget' );
if ( ! is_array( $cache ) ) {
$cache = [];
}
if ( isset( $cache[ $args['widget_id'] ] ) ) {
echo $cache[ $args['widget_id'] ]; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
return true;
}
return false;
}
/**
* Caches the widget.
*
* @param array $args
* @param string $content
*/
public function cache_widget( $args, $content ) {
if ( empty( $args['widget_id'] ) ) {
return;
}
$cache = wp_cache_get( $this->widget_id, 'widget' );
if ( ! is_array( $cache ) ) {
$cache = [];
}
$cache[ $args['widget_id'] ] = $content;
wp_cache_set( $this->widget_id, $cache, 'widget' );
}
/**
* Flushes the cache for a widget.
*/
public function flush_widget_cache() {
wp_cache_delete( $this->widget_id, 'widget' );
}
/**
* Updates a widget instance settings.
*
* @see WP_Widget->update
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$instance = $old_instance;
if ( ! $this->settings ) {
return $instance;
}
foreach ( $this->settings as $key => $setting ) {
$instance[ $key ] = isset( $new_instance[ $key ] ) ? sanitize_text_field( $new_instance[ $key ] ) : '';
}
$this->flush_widget_cache();
return $instance;
}
/**
* Displays widget setup form.
*
* @see WP_Widget->form
* @param array $instance
* @return void
*/
public function form( $instance ) {
if ( ! $this->settings ) {
return;
}
foreach ( $this->settings as $key => $setting ) {
$value = isset( $instance[ $key ] ) ? $instance[ $key ] : $setting['std'];
switch ( $setting['type'] ) {
case 'text':
?>
/>
settings ) ) {
foreach ( $this->settings as $key => $setting ) {
$defaults[ $key ] = null;
if ( isset( $setting['std'] ) ) {
$defaults[ $key ] = $setting['std'];
}
}
}
return $defaults;
}
/**
* Echoes the widget content.
*
* @see WP_Widget
*
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {}
}