wp-admin/includes/class-wp-links-list-table.php

   1 <?php
   2 /**
   3  * List Table API: WP_Links_List_Table class
   4  *
   5  * @package WordPress
   6  * @subpackage Administration
   7  * @since 3.1.0
   8  */
   9
  10 /**
  11  * Core class used to implement displaying links in a list table.
  12  *
  13  * @since 3.1.0
  14  * @access private
  15  *
  16  * @see WP_List_Tsble
  17  */
  18 class WP_Links_List_Table extends WP_List_Table {
  19
  20         /**
  21          * Constructor.
  22          *
  23          * @since 3.1.0
  24          * @access public
  25          *
  26          * @see WP_List_Table::__construct() for more information on default arguments.
  27          *
  28          * @param array $args An associative array of arguments.
  29          */
  30         public function __construct( $args = array() ) {
  31                 parent::__construct( array(
  32                         'plural' => 'bookmarks',
  33                         'screen' => isset( $args['screen'] ) ? $args['screen'] : null,
  34                 ) );
  35         }
  36
  37         /**
  38          *
  39          * @return bool
  40          */
  41         public function ajax_user_can() {
  42                 return current_user_can( 'manage_links' );
  43         }
  44
  45         /**
  46          *
  47          * @global int    $cat_id
  48          * @global string $s
  49          * @global string $orderby
  50          * @global string $order
  51          */
  52         public function prepare_items() {
  53                 global $cat_id, $s, $orderby, $order;
  54
  55                 wp_reset_vars( array( 'action', 'cat_id', 'link_id', 'orderby', 'order', 's' ) );
  56
  57                 $args = array( 'hide_invisible' => 0, 'hide_empty' => 0 );
  58
  59                 if ( 'all' != $cat_id )
  60                         $args['category'] = $cat_id;
  61                 if ( !empty( $s ) )
  62                         $args['search'] = $s;
  63                 if ( !empty( $orderby ) )
  64                         $args['orderby'] = $orderby;
  65                 if ( !empty( $order ) )
  66                         $args['order'] = $order;
  67
  68                 $this->items = get_bookmarks( $args );
  69         }
  70
  71         /**
  72          * @access public
  73          */
  74         public function no_items() {
  75                 _e( 'No links found.' );
  76         }
  77
  78         /**
  79          *
  80          * @return array
  81          */
  82         protected function get_bulk_actions() {
  83                 $actions = array();
  84                 $actions['delete'] = __( 'Delete' );
  85
  86                 return $actions;
  87         }
  88
  89         /**
  90          *
  91          * @global int $cat_id
  92          * @param string $which
  93          */
  94         protected function extra_tablenav( $which ) {
  95                 global $cat_id;
  96
  97                 if ( 'top' != $which )
  98                         return;
  99 ?>
 100                 <div class="alignleft actions">
 101 <?php
 102                         $dropdown_options = array(
 103                                 'selected' => $cat_id,
 104                                 'name' => 'cat_id',
 105                                 'taxonomy' => 'link_category',
 106                                 'show_option_all' => get_taxonomy( 'link_category' )->labels->all_items,
 107                                 'hide_empty' => true,
 108                                 'hierarchical' => 1,
 109                                 'show_count' => 0,
 110                                 'orderby' => 'name',
 111                         );
 112
 113                         echo '<label class="screen-reader-text" for="cat_id">' . __( 'Filter by category' ) . '</label>';
 114                         wp_dropdown_categories( $dropdown_options );
 115                         submit_button( __( 'Filter' ), 'button', 'filter_action', false, array( 'id' => 'post-query-submit' ) );
 116 ?>
 117                 </div>
 118 <?php
 119         }
 120
 121         /**
 122          *
 123          * @return array
 124          */
 125         public function get_columns() {
 126                 return array(
 127                         'cb'         => '<input type="checkbox" />',
 128                         'name'       => _x( 'Name', 'link name' ),
 129                         'url'        => __( 'URL' ),
 130                         'categories' => __( 'Categories' ),
 131                         'rel'        => __( 'Relationship' ),
 132                         'visible'    => __( 'Visible' ),
 133                         'rating'     => __( 'Rating' )
 134                 );
 135         }
 136
 137         /**
 138          *
 139          * @return array
 140          */
 141         protected function get_sortable_columns() {
 142                 return array(
 143                         'name'    => 'name',
 144                         'url'     => 'url',
 145                         'visible' => 'visible',
 146                         'rating'  => 'rating'
 147                 );
 148         }
 149
 150         /**
 151          * Get the name of the default primary column.
 152          *
 153          * @since 4.3.0
 154          * @access protected
 155          *
 156          * @return string Name of the default primary column, in this case, 'name'.
 157          */
 158         protected function get_default_primary_column_name() {
 159                 return 'name';
 160         }
 161
 162         /**
 163          * Handles the checkbox column output.
 164          *
 165          * @since 4.3.0
 166          * @access public
 167          *
 168          * @param object $link The current link object.
 169          */
 170         public function column_cb( $link ) {
 171                 ?>
 172                 <label class="screen-reader-text" for="cb-select-<?php echo $link->link_id; ?>"><?php echo sprintf( __( 'Select %s' ), $link->link_name ); ?></label>
 173                 <input type="checkbox" name="linkcheck[]" id="cb-select-<?php echo $link->link_id; ?>" value="<?php echo esc_attr( $link->link_id ); ?>" />
 174                 <?php
 175         }
 176
 177         /**
 178          * Handles the link name column output.
 179          *
 180          * @since 4.3.0
 181          * @access public
 182          *
 183          * @param object $link The current link object.
 184          */
 185         public function column_name( $link ) {
 186                 $edit_link = get_edit_bookmark_link( $link );
 187                 printf( '<strong><a class="row-title" href="%s" aria-label="%s">%s</a></strong>',
 188                         $edit_link,
 189                         /* translators: %s: link name */
 190                         esc_attr( sprintf( __( 'Edit &#8220;%s&#8221;' ), $link->link_name ) ),
 191                         $link->link_name
 192                 );
 193         }
 194
 195         /**
 196          * Handles the link URL column output.
 197          *
 198          * @since 4.3.0
 199          * @access public
 200          *
 201          * @param object $link The current link object.
 202          */
 203         public function column_url( $link ) {
 204                 $short_url = url_shorten( $link->link_url );
 205                 echo "<a href='$link->link_url'>$short_url</a>";
 206         }
 207
 208         /**
 209          * Handles the link categories column output.
 210          *
 211          * @since 4.3.0
 212          * @access public
 213          *
 214          * @global $cat_id
 215          *
 216          * @param object $link The current link object.
 217          */
 218         public function column_categories( $link ) {
 219                 global $cat_id;
 220
 221                 $cat_names = array();
 222                 foreach ( $link->link_category as $category ) {
 223                         $cat = get_term( $category, 'link_category', OBJECT, 'display' );
 224                         if ( is_wp_error( $cat ) ) {
 225                                 echo $cat->get_error_message();
 226                         }
 227                         $cat_name = $cat->name;
 228                         if ( $cat_id != $category ) {
 229                                 $cat_name = "<a href='link-manager.php?cat_id=$category'>$cat_name</a>";
 230                         }
 231                         $cat_names[] = $cat_name;
 232                 }
 233                 echo implode( ', ', $cat_names );
 234         }
 235
 236         /**
 237          * Handles the link relation column output.
 238          *
 239          * @since 4.3.0
 240          * @access public
 241          *
 242          * @param object $link The current link object.
 243          */
 244         public function column_rel( $link ) {
 245                 echo empty( $link->link_rel ) ? '<br />' : $link->link_rel;
 246         }
 247
 248         /**
 249          * Handles the link visibility column output.
 250          *
 251          * @since 4.3.0
 252          * @access public
 253          *
 254          * @param object $link The current link object.
 255          */
 256         public function column_visible( $link ) {
 257                 if ( 'Y' === $link->link_visible ) {
 258                         _e( 'Yes' );
 259                 } else {
 260                         _e( 'No' );
 261                 }
 262         }
 263
 264         /**
 265          * Handles the link rating column output.
 266          *
 267          * @since 4.3.0
 268          * @access public
 269          *
 270          * @param object $link The current link object.
 271          */
 272         public function column_rating( $link ) {
 273                 echo $link->link_rating;
 274         }
 275
 276         /**
 277          * Handles the default column output.
 278          *
 279          * @since 4.3.0
 280          * @access public
 281          *
 282          * @param object $link        Link object.
 283          * @param string $column_name Current column name.
 284          */
 285         public function column_default( $link, $column_name ) {
 286                 /**
 287                  * Fires for each registered custom link column.
 288                  *
 289                  * @since 2.1.0
 290                  *
 291                  * @param string $column_name Name of the custom column.
 292                  * @param int    $link_id     Link ID.
 293                  */
 294                 do_action( 'manage_link_custom_column', $column_name, $link->link_id );
 295         }
 296
 297         public function display_rows() {
 298                 foreach ( $this->items as $link ) {
 299                         $link = sanitize_bookmark( $link );
 300                         $link->link_name = esc_attr( $link->link_name );
 301                         $link->link_category = wp_get_link_cats( $link->link_id );
 302 ?>
 303                 <tr id="link-<?php echo $link->link_id; ?>">
 304                         <?php $this->single_row_columns( $link ) ?>
 305                 </tr>
 306 <?php
 307                 }
 308         }
 309
 310         /**
 311          * Generates and displays row action links.
 312          *
 313          * @since 4.3.0
 314          * @access protected
 315          *
 316          * @param object $link        Link being acted upon.
 317          * @param string $column_name Current column name.
 318          * @param string $primary     Primary column name.
 319          * @return string Row action output for links.
 320          */
 321         protected function handle_row_actions( $link, $column_name, $primary ) {
 322                 if ( $primary !== $column_name ) {
 323                         return '';
 324                 }
 325
 326                 $edit_link = get_edit_bookmark_link( $link );
 327
 328                 $actions = array();
 329                 $actions['edit'] = '<a href="' . $edit_link . '">' . __('Edit') . '</a>';
 330                 $actions['delete'] = "<a class='submitdelete' href='" . wp_nonce_url("link.php?action=delete&amp;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>";
 331                 return $this->row_actions( $actions );
 332         }
 333 }