wordpress/php-fpm/wordpress_files/plugins/polylang/settings/table-languages.php
2020-05-22 01:40:23 +00:00

273 lines
7.6 KiB
PHP

<?php
if ( ! class_exists( 'WP_List_Table' ) ) {
require_once ABSPATH . 'wp-admin/includes/class-wp-list-table.php'; // since WP 3.1
}
/**
* A class to create the languages table in Polylang settings
* Thanks to Matt Van Andel ( http://www.mattvanandel.com ) for its plugin "Custom List Table Example" !
*
* @since 0.1
*/
class PLL_Table_Languages extends WP_List_Table {
/**
* Constructor
*
* @since 0.1
*/
public function __construct() {
parent::__construct(
array(
'plural' => 'Languages', // Do not translate ( used for css class )
'ajax' => false,
)
);
}
/**
* Generates content for a single row of the table
*
* @since 1.8
*
* @param object $item The current item
*/
public function single_row( $item ) {
/**
* Filter the list of classes assigned a row in the languages list table
*
* @since 1.8
*
* @param array $classes list of class names
* @param object $item the current item
*/
$classes = apply_filters( 'pll_languages_row_classes', array(), $item );
echo '<tr' . ( empty( $classes ) ? '>' : ' class="' . esc_attr( implode( ' ', $classes ) ) . '">' );
$this->single_row_columns( $item );
echo '</tr>';
}
/**
* Displays the item information in a column ( default case )
*
* @since 0.1
*
* @param object $item
* @param string $column_name
* @return string
*/
public function column_default( $item, $column_name ) {
switch ( $column_name ) {
case 'locale':
case 'slug':
return esc_html( $item->$column_name );
case 'term_group':
case 'count':
return (int) $item->$column_name;
default:
return $item->$column_name; // flag
}
}
/**
* Displays the item information in the column 'name'
* Displays the edit and delete action links
*
* @since 0.1
*
* @param object $item
* @return string
*/
public function column_name( $item ) {
return sprintf(
'<a title="%s" href="%s">%s</a>',
esc_attr__( 'Edit this language', 'polylang' ),
esc_url( admin_url( 'admin.php?page=mlang&amp;pll_action=edit&amp;lang=' . $item->term_id ) ),
esc_html( $item->name )
);
}
/**
* Displays the item information in the default language
* Displays the 'make default' action link
*
* @since 1.8
*
* @param object $item
* @return string
*/
public function column_default_lang( $item ) {
$options = get_option( 'polylang' );
if ( $options['default_lang'] != $item->slug ) {
$s = sprintf(
'<div class="row-actions"><span class="default-lang">
<a class="icon-default-lang" title="%1$s" href="%2$s"><span class="screen-reader-text">%3$s</span></a>
</span></div>',
esc_attr__( 'Select as default language', 'polylang' ),
wp_nonce_url( '?page=mlang&amp;pll_action=default-lang&amp;noheader=true&amp;lang=' . $item->term_id, 'default-lang' ),
/* translators: accessibility text, %s is a native language name */
esc_html( sprintf( __( 'Choose %s as default language', 'polylang' ), $item->name ) )
);
/**
* Filter the default language row action in the languages list table
*
* @since 1.8
*
* @param string $s html markup of the action
* @param object $item
*/
$s = apply_filters( 'pll_default_lang_row_action', $s, $item );
} else {
$s = sprintf(
'<span class="icon-default-lang"><span class="screen-reader-text">%1$s</span></span>',
/* translators: accessibility text */
esc_html__( 'Default language', 'polylang' )
);
}
return $s;
}
/**
* Gets the list of columns
*
* @since 0.1
*
* @return array the list of column titles
*/
public function get_columns() {
return array(
'name' => esc_html__( 'Full name', 'polylang' ),
'locale' => esc_html__( 'Locale', 'polylang' ),
'slug' => esc_html__( 'Code', 'polylang' ),
'default_lang' => sprintf( '<span title="%1$s" class="icon-default-lang"><span class="screen-reader-text">%2$s</span></span>', esc_attr__( 'Default language', 'polylang' ), esc_html__( 'Default language', 'polylang' ) ),
'term_group' => esc_html__( 'Order', 'polylang' ),
'flag' => esc_html__( 'Flag', 'polylang' ),
'count' => esc_html__( 'Posts', 'polylang' ),
);
}
/**
* Gets the list of sortable columns
*
* @since 0.1
*
* @return array
*/
public function get_sortable_columns() {
return array(
'name' => array( 'name', true ), // sorted by name by default
'locale' => array( 'locale', false ),
'slug' => array( 'slug', false ),
'term_group' => array( 'term_group', false ),
'count' => array( 'count', false ),
);
}
/**
* Gets the name of the default primary column.
*
* @since 2.1
*
* @return string Name of the default primary column, in this case, 'name'.
*/
protected function get_default_primary_column_name() {
return 'name';
}
/**
* Generates and display row actions links for the list table.
*
* @since 1.8
*
* @param object $item The item being acted upon.
* @param string $column_name Current column name.
* @param string $primary Primary column name.
* @return string The row actions output.
*/
protected function handle_row_actions( $item, $column_name, $primary ) {
if ( $primary !== $column_name ) {
return '';
}
$actions = array(
'edit' => sprintf(
'<a title="%s" href="%s">%s</a>',
esc_attr__( 'Edit this language', 'polylang' ),
esc_url( admin_url( 'admin.php?page=mlang&amp;pll_action=edit&amp;lang=' . $item->term_id ) ),
esc_html__( 'Edit', 'polylang' )
),
'delete' => sprintf(
'<a title="%s" href="%s" onclick = "return confirm( \'%s\' );">%s</a>',
esc_attr__( 'Delete this language and all its associated data', 'polylang' ),
wp_nonce_url( '?page=mlang&amp;pll_action=delete&amp;noheader=true&amp;lang=' . $item->term_id, 'delete-lang' ),
esc_js( __( 'You are about to permanently delete this language. Are you sure?', 'polylang' ) ),
esc_html__( 'Delete', 'polylang' )
),
);
/**
* Filter the list of row actions in the languages list table
*
* @since 1.8
*
* @param array $actions list of html markup actions
* @param object $item
*/
$actions = apply_filters( 'pll_languages_row_actions', $actions, $item );
return $this->row_actions( $actions );
}
/**
* Sort items
*
* @since 0.1
*
* @param object $a The first object to compare
* @param object $b The second object to compare
* @return int -1 or 1 if $a is considered to be respectively less than or greater than $b.
*/
protected function usort_reorder( $a, $b ) {
$orderby = ! empty( $_GET['orderby'] ) ? sanitize_key( $_GET['orderby'] ) : 'name'; // phpcs:ignore WordPress.Security.NonceVerification
// Determine sort order
if ( is_numeric( $a->$orderby ) ) {
$result = $a->$orderby > $b->$orderby ? 1 : -1;
} else {
$result = strcmp( $a->$orderby, $b->$orderby );
}
// Send final sort direction to usort
return ( empty( $_GET['order'] ) || 'asc' === $_GET['order'] ) ? $result : -$result; // phpcs:ignore WordPress.Security.NonceVerification
}
/**
* Prepares the list of items for displaying
*
* @since 0.1
*
* @param array $data
*/
public function prepare_items( $data = array() ) {
$per_page = $this->get_items_per_page( 'pll_lang_per_page' );
$this->_column_headers = array( $this->get_columns(), array(), $this->get_sortable_columns() );
usort( $data, array( $this, 'usort_reorder' ) );
$total_items = count( $data );
$this->items = array_slice( $data, ( $this->get_pagenum() - 1 ) * $per_page, $per_page );
$this->set_pagination_args(
array(
'total_items' => $total_items,
'per_page' => $per_page,
'total_pages' => ceil( $total_items / $per_page ),
)
);
}
}