mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-25 07:12:53 +02:00
Prior to about 2013, many class methods lacked even access modifiers which made the `@access` notations that much more useful. Now that we've gotten to a point where the codebase is more mature from a maintenance perspective and we can finally remove these notations. Notable exceptions to this change include standalone functions notated as private as well as some classes still considered to represent "private" APIs. See #41452. Built from https://develop.svn.wordpress.org/trunk@41161 git-svn-id: http://core.svn.wordpress.org/trunk@41001 1a063a9b-81f0-0310-95a4-ce76da25c4cd
322 lines
7.4 KiB
PHP
322 lines
7.4 KiB
PHP
<?php
|
|
/**
|
|
* List Table API: WP_Links_List_Table class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Administration
|
|
* @since 3.1.0
|
|
*/
|
|
|
|
/**
|
|
* Core class used to implement displaying links in a list table.
|
|
*
|
|
* @since 3.1.0
|
|
* @access private
|
|
*
|
|
* @see WP_List_Tsble
|
|
*/
|
|
class WP_Links_List_Table extends WP_List_Table {
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @see WP_List_Table::__construct() for more information on default arguments.
|
|
*
|
|
* @param array $args An associative array of arguments.
|
|
*/
|
|
public function __construct( $args = array() ) {
|
|
parent::__construct( array(
|
|
'plural' => 'bookmarks',
|
|
'screen' => isset( $args['screen'] ) ? $args['screen'] : null,
|
|
) );
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function ajax_user_can() {
|
|
return current_user_can( 'manage_links' );
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @global int $cat_id
|
|
* @global string $s
|
|
* @global string $orderby
|
|
* @global string $order
|
|
*/
|
|
public function prepare_items() {
|
|
global $cat_id, $s, $orderby, $order;
|
|
|
|
wp_reset_vars( array( 'action', 'cat_id', 'link_id', 'orderby', 'order', 's' ) );
|
|
|
|
$args = array( 'hide_invisible' => 0, 'hide_empty' => 0 );
|
|
|
|
if ( 'all' != $cat_id )
|
|
$args['category'] = $cat_id;
|
|
if ( !empty( $s ) )
|
|
$args['search'] = $s;
|
|
if ( !empty( $orderby ) )
|
|
$args['orderby'] = $orderby;
|
|
if ( !empty( $order ) )
|
|
$args['order'] = $order;
|
|
|
|
$this->items = get_bookmarks( $args );
|
|
}
|
|
|
|
/**
|
|
*/
|
|
public function no_items() {
|
|
_e( 'No links found.' );
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @return array
|
|
*/
|
|
protected function get_bulk_actions() {
|
|
$actions = array();
|
|
$actions['delete'] = __( 'Delete' );
|
|
|
|
return $actions;
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @global int $cat_id
|
|
* @param string $which
|
|
*/
|
|
protected function extra_tablenav( $which ) {
|
|
global $cat_id;
|
|
|
|
if ( 'top' != $which )
|
|
return;
|
|
?>
|
|
<div class="alignleft actions">
|
|
<?php
|
|
$dropdown_options = array(
|
|
'selected' => $cat_id,
|
|
'name' => 'cat_id',
|
|
'taxonomy' => 'link_category',
|
|
'show_option_all' => get_taxonomy( 'link_category' )->labels->all_items,
|
|
'hide_empty' => true,
|
|
'hierarchical' => 1,
|
|
'show_count' => 0,
|
|
'orderby' => 'name',
|
|
);
|
|
|
|
echo '<label class="screen-reader-text" for="cat_id">' . __( 'Filter by category' ) . '</label>';
|
|
wp_dropdown_categories( $dropdown_options );
|
|
submit_button( __( 'Filter' ), '', 'filter_action', false, array( 'id' => 'post-query-submit' ) );
|
|
?>
|
|
</div>
|
|
<?php
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @return array
|
|
*/
|
|
public function get_columns() {
|
|
return array(
|
|
'cb' => '<input type="checkbox" />',
|
|
'name' => _x( 'Name', 'link name' ),
|
|
'url' => __( 'URL' ),
|
|
'categories' => __( 'Categories' ),
|
|
'rel' => __( 'Relationship' ),
|
|
'visible' => __( 'Visible' ),
|
|
'rating' => __( 'Rating' )
|
|
);
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @return array
|
|
*/
|
|
protected function get_sortable_columns() {
|
|
return array(
|
|
'name' => 'name',
|
|
'url' => 'url',
|
|
'visible' => 'visible',
|
|
'rating' => 'rating'
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get the name of the default primary column.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @return string Name of the default primary column, in this case, 'name'.
|
|
*/
|
|
protected function get_default_primary_column_name() {
|
|
return 'name';
|
|
}
|
|
|
|
/**
|
|
* Handles the checkbox column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param object $link The current link object.
|
|
*/
|
|
public function column_cb( $link ) {
|
|
?>
|
|
<label class="screen-reader-text" for="cb-select-<?php echo $link->link_id; ?>"><?php echo sprintf( __( 'Select %s' ), $link->link_name ); ?></label>
|
|
<input type="checkbox" name="linkcheck[]" id="cb-select-<?php echo $link->link_id; ?>" value="<?php echo esc_attr( $link->link_id ); ?>" />
|
|
<?php
|
|
}
|
|
|
|
/**
|
|
* Handles the link name column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param object $link The current link object.
|
|
*/
|
|
public function column_name( $link ) {
|
|
$edit_link = get_edit_bookmark_link( $link );
|
|
printf( '<strong><a class="row-title" href="%s" aria-label="%s">%s</a></strong>',
|
|
$edit_link,
|
|
/* translators: %s: link name */
|
|
esc_attr( sprintf( __( 'Edit “%s”' ), $link->link_name ) ),
|
|
$link->link_name
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Handles the link URL column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param object $link The current link object.
|
|
*/
|
|
public function column_url( $link ) {
|
|
$short_url = url_shorten( $link->link_url );
|
|
echo "<a href='$link->link_url'>$short_url</a>";
|
|
}
|
|
|
|
/**
|
|
* Handles the link categories column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @global int $cat_id
|
|
*
|
|
* @param object $link The current link object.
|
|
*/
|
|
public function column_categories( $link ) {
|
|
global $cat_id;
|
|
|
|
$cat_names = array();
|
|
foreach ( $link->link_category as $category ) {
|
|
$cat = get_term( $category, 'link_category', OBJECT, 'display' );
|
|
if ( is_wp_error( $cat ) ) {
|
|
echo $cat->get_error_message();
|
|
}
|
|
$cat_name = $cat->name;
|
|
if ( $cat_id != $category ) {
|
|
$cat_name = "<a href='link-manager.php?cat_id=$category'>$cat_name</a>";
|
|
}
|
|
$cat_names[] = $cat_name;
|
|
}
|
|
echo implode( ', ', $cat_names );
|
|
}
|
|
|
|
/**
|
|
* Handles the link relation column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param object $link The current link object.
|
|
*/
|
|
public function column_rel( $link ) {
|
|
echo empty( $link->link_rel ) ? '<br />' : $link->link_rel;
|
|
}
|
|
|
|
/**
|
|
* Handles the link visibility column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param object $link The current link object.
|
|
*/
|
|
public function column_visible( $link ) {
|
|
if ( 'Y' === $link->link_visible ) {
|
|
_e( 'Yes' );
|
|
} else {
|
|
_e( 'No' );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles the link rating column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param object $link The current link object.
|
|
*/
|
|
public function column_rating( $link ) {
|
|
echo $link->link_rating;
|
|
}
|
|
|
|
/**
|
|
* Handles the default column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param object $link Link object.
|
|
* @param string $column_name Current column name.
|
|
*/
|
|
public function column_default( $link, $column_name ) {
|
|
/**
|
|
* Fires for each registered custom link column.
|
|
*
|
|
* @since 2.1.0
|
|
*
|
|
* @param string $column_name Name of the custom column.
|
|
* @param int $link_id Link ID.
|
|
*/
|
|
do_action( 'manage_link_custom_column', $column_name, $link->link_id );
|
|
}
|
|
|
|
public function display_rows() {
|
|
foreach ( $this->items as $link ) {
|
|
$link = sanitize_bookmark( $link );
|
|
$link->link_name = esc_attr( $link->link_name );
|
|
$link->link_category = wp_get_link_cats( $link->link_id );
|
|
?>
|
|
<tr id="link-<?php echo $link->link_id; ?>">
|
|
<?php $this->single_row_columns( $link ) ?>
|
|
</tr>
|
|
<?php
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Generates and displays row action links.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param object $link Link being acted upon.
|
|
* @param string $column_name Current column name.
|
|
* @param string $primary Primary column name.
|
|
* @return string Row action output for links.
|
|
*/
|
|
protected function handle_row_actions( $link, $column_name, $primary ) {
|
|
if ( $primary !== $column_name ) {
|
|
return '';
|
|
}
|
|
|
|
$edit_link = get_edit_bookmark_link( $link );
|
|
|
|
$actions = array();
|
|
$actions['edit'] = '<a href="' . $edit_link . '">' . __('Edit') . '</a>';
|
|
$actions['delete'] = "<a class='submitdelete' href='" . wp_nonce_url("link.php?action=delete&link_id=$link->link_id", 'delete-bookmark_' . $link->link_id) . "' onclick=\"if ( confirm( '" . esc_js(sprintf(__("You are about to delete this link '%s'\n 'Cancel' to stop, 'OK' to delete."), $link->link_name)) . "' ) ) { return true;}return false;\">" . __('Delete') . "</a>";
|
|
return $this->row_actions( $actions );
|
|
}
|
|
}
|