Question

wp_link_category_checklist( int $link_id )

Outputs a link category checklist element.

---

description

---

参数

$link_id

(int) (Required)

---

源代码

File: wp-admin/includes/template.php

function wp_link_category_checklist( $link_id = 0 ) {
	$default = 1;

	$checked_categories = array();

	if ( $link_id ) {
		$checked_categories = wp_get_link_cats( $link_id );
		// No selected categories, strange
		if ( ! count( $checked_categories ) ) {
			$checked_categories[] = $default;
		}
	} else {
		$checked_categories[] = $default;
	}

	$categories = get_terms( 'link_category', array( 'orderby' => 'name', 'hide_empty' => 0 ) );

	if ( empty( $categories ) )
		return;

	foreach ( $categories as $category ) {
		$cat_id = $category->term_id;

		/** This filter is documented in wp-includes/category-template.php */
		$name = esc_html( apply_filters( 'the_category', $category->name ) );
		$checked = in_array( $cat_id, $checked_categories ) ? ' checked="checked"' : '';
		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>";
	}
}

---

更新日志

Version	description
2.5.1	Introduced.

---

相关函数

Uses

• wp-admin/includes/bookmark.php: wp_get_link_cats()
• wp-includes/category-template.php: the_category
• wp-includes/formatting.php: esc_html()
• wp-includes/taxonomy.php: get_terms()
• wp-includes/plugin.php: apply_filters()

---

Used By

• wp-admin/includes/deprecated.php: dropdown_link_categories()
• wp-admin/includes/meta-boxes.php: link_categories_meta_box()

---

User Contributed Notes