__( 'Displays a language switcher', 'polylang' ),
'customize_selective_refresh' => true,
)
);
}
/**
* Displays the widget
*
* @since 0.1
*
* @param array $args Display arguments including before_title, after_title, before_widget, and after_widget.
* @param array $instance The settings for the particular instance of the widget
*/
public function widget( $args, $instance ) {
// Sets a unique id for dropdown
$instance['dropdown'] = empty( $instance['dropdown'] ) ? 0 : $args['widget_id'];
if ( $list = pll_the_languages( array_merge( $instance, array( 'echo' => 0 ) ) ) ) {
$title = empty( $instance['title'] ) ? '' : $instance['title'];
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );
echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput
if ( $title ) {
echo $args['before_title'] . $title . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput
}
if ( $instance['dropdown'] ) {
echo '';
echo $list; // phpcs:ignore WordPress.Security.EscapeOutput
} else {
echo "\n"; // phpcs:ignore WordPress.Security.EscapeOutput
}
echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput
}
}
/**
* Updates the widget options
*
* @since 0.4
*
* @param array $new_instance New settings for this instance as input by the user via form()
* @param array $old_instance Old settings for this instance
* @return array Settings to save or bool false to cancel saving
*/
public function update( $new_instance, $old_instance ) {
$instance = array( 'title' => sanitize_text_field( $new_instance['title'] ) );
foreach ( array_keys( PLL_Switcher::get_switcher_options( 'widget' ) ) as $key ) {
$instance[ $key ] = ! empty( $new_instance[ $key ] ) ? 1 : 0;
}
return $instance;
}
/**
* Displays the widget form
*
* @since 0.4
*
* @param array $instance Current settings
*/
public function form( $instance ) {
// Default values
$instance = wp_parse_args( (array) $instance, array_merge( array( 'title' => '' ), PLL_Switcher::get_switcher_options( 'widget', 'default' ) ) );
// Title
printf(
'',
esc_attr( $this->get_field_id( 'title' ) ),
esc_html__( 'Title:', 'polylang' ),
esc_attr( $this->get_field_name( 'title' ) ),
esc_attr( $instance['title'] )
);
foreach ( PLL_Switcher::get_switcher_options( 'widget' ) as $key => $str ) {
printf(
'',
esc_attr( $this->get_field_id( $key ) ),
esc_attr( $this->get_field_name( $key ) ),
checked( $instance[ $key ], true, false ),
esc_html( $str ),
in_array( $key, array( 'show_names', 'show_flags', 'hide_current' ) ) ? sprintf( ' class="no-dropdown-%s"', esc_attr( $this->id ) ) : '',
( ! empty( $instance['dropdown'] ) && in_array( $key, array( 'show_names', 'show_flags', 'hide_current' ) ) ? ' style="display:none;"' : '' ),
esc_attr( 'pll-' . $key )
);
}
// FIXME echoing script in form is not very clean
// but it does not work if enqueued properly :
// clicking save on a widget makes this code unreachable for the just saved widget ( ?! )
$this->admin_print_script();
}
/**
* Add javascript to control the language switcher options
*
* @since 1.3
*/
public function admin_print_script() {
static $done = false;
if ( $done ) {
return;
}
$done = true;
?>