Question

Warning: This function has been deprecated. Use wp_list_bookmarks() instead.

get_links_list( string $order = 'name' )

Output entire list of links by category.

---

description

Output a list of all links, listed by category, using the settings in $wpdb->linkcategories and output it as a nested HTML unordered list.

---

参数

$order

(string) (Optional) Sort link categories by 'name' or 'id'

Default value: 'name'

---

源代码

File: wp-includes/deprecated.php

function get_links_list($order = 'name') {
	_deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_bookmarks()' );

	$order = strtolower($order);

	// Handle link category sorting
	$direction = 'ASC';
	if ( '_' == substr($order,0,1) ) {
		$direction = 'DESC';
		$order = substr($order,1);
	}

	if ( !isset($direction) )
		$direction = '';

	$cats = get_categories(array('type' => 'link', 'orderby' => $order, 'order' => $direction, 'hierarchical' => 0));

	// Display each category
	if ( $cats ) {
		foreach ( (array) $cats as $cat ) {
			// Handle each category.

			// Display the category name
			echo '  <li id="linkcat-' . $cat->term_id . '" class="linkcat"><h2>' . apply_filters('link_category', $cat->name ) . "</h2>\n\t<ul>\n";
			// Call get_links() with all the appropriate params
			get_links($cat->term_id, '<li>', "</li>", "\n", true, 'name', false);

			// Close the last category
			echo "\n\t</ul>\n</li>\n";
		}
	}
}

---

更新日志

Version	description
2.1.0	Use wp_list_bookmarks()
1.0.1	Introduced.

---

相关函数

Uses

• wp-includes/deprecated.php: get_links()
• wp-includes/category.php: get_categories()
• wp-includes/functions.php: _deprecated_function()
• wp-includes/plugin.php: apply_filters()
• wp-includes/bookmark-template.php: link_category

---

User Contributed Notes