wp_link_category_checklist

Outputs a link category checklist element.

Description

wp_link_category_checklist( (int) $link_id = 0 ); 

Parameters (1)

0. $link_id — Optional. (int)
The link id.

Usage

  1. if ( !function_exists( 'wp_link_category_checklist' ) ) { 
  2.     require_once ABSPATH . '/wp-admin/includes/template.php'; 
  3. } 
  4.   
  5. // The link id. 
  6. $link_id = -1; 
  7.   
  8. // NOTICE! Understand what this does before running. 
  9. $result = wp_link_category_checklist($link_id); 
  10.     

Defined (1)

The function is defined in the following location(s).

/wp-admin/includes/template.php  
  1. function wp_link_category_checklist( $link_id = 0 ) { 
  2.     $default = 1; 
  3.  
  4.     $checked_categories = array(); 
  5.  
  6.     if ( $link_id ) { 
  7.         $checked_categories = wp_get_link_cats( $link_id ); 
  8.         // No selected categories, strange 
  9.         if ( ! count( $checked_categories ) ) { 
  10.             $checked_categories[] = $default; 
  11.         } 
  12.     } else { 
  13.         $checked_categories[] = $default; 
  14.     } 
  15.  
  16.     $categories = get_terms( 'link_category', array( 'orderby' => 'name', 'hide_empty' => 0 ) ); 
  17.  
  18.     if ( empty( $categories ) ) 
  19.         return; 
  20.  
  21.     foreach ( $categories as $category ) { 
  22.         $cat_id = $category->term_id; 
  23.  
  24.         /** This filter is documented in wp-includes/category-template.php */ 
  25.         $name = esc_html( apply_filters( 'the_category', $category->name ) ); 
  26.         $checked = in_array( $cat_id, $checked_categories ) ? ' checked="checked"' : ''; 
  27.         echo '<li id="link-category-', $cat_id, '"><label for="in-link-category-', $cat_id, '" class="selectit"><input value="', $cat_id, '" type="checkbox" name="link_category[]" id="in-link-category-', $cat_id, '"', $checked, '/> ', $name, "</label></li>"; 
  28.     } 
  29. }