wp_list_authors() │ WP 1.2.0

Виводить список авторів блогу як посилання на їхні пости, якщо пости існують.

Також можна вказати висновок посилання на RSS-фід кожного автора та кількість записів у кожного автора.

Хуків немає.

Повертає

null|Строку. Нічого за echo = true. Список авторів при echo = false.

Шаблон використання

$ args = array (
	'orderby' => 'name',
	'order' => 'ASC',
	'number' => null,
	'optioncount' => false,
	'exclude_admin' => true,
	'show_fullname' => false,
	'hide_empty' => true,
	'echo' => true,
	'feed' => '',
	'feed_image' => '',
	'feed_type' => '',
	'style' => list,
	'html' => ''
);

wp_list_authors ($ args);

Використання

<?php wp_list_authors( $args ); ?>
$args
(масив)

Параметри, що відповідають за висновок.
За замовчуванням: встановлені

  • orderby (рядок)
    Поле по якому сортуватиметься результат. З версії 3.1. Доступні поля:

    • name– сортувати по імені, що відображається (поле display_name в таблиці users – за замовчуванням).
    • email– за адресою емаїл (поле таблиці user_email ).
    • url– за адресою URL user_url .
    • registered– По полю user_registered .
    • id– за ID користувача.
    • user_login– За логіном користувача (поле user_login ).
    • post_count– За кількістю записів у користувача.
      За замовчуванням: ‘name’

  • order (рядок)
    У якому порядку сортувати: ASC– по порядку, DESC– у зворотному порядку. З версії 3.1.
    За замовчуванням: ‘ASC’

  • number (число)
    Максимальна кількість користувачів, яка буде показана (ліміт). З версії 3.1.
    За замовчуванням: без обмежень

  • optioncount (логічний)
    Показувати кількість постів кожного користувача: 1 (true) – показувати, 0 (false) – не показувати.
    Типово: false

  • exclude_admin (логічний)
    Виключити зі списку реєстраційний запис з логіном admin: 1 (true) – виключити, 0 (false) – не виключати (за замовчуванням).
    Типово: false

  • show_fullname (логічний)
    Показувати повне ім’я (ім’я, прізвище) автора, якщо стоїть false, буде показано ім’я, яке вибрано для відображення.
    Типово: false

  • hide_empty (логічний)
    Не показувати авторів, у яких немає записів: 1 (true) – показувати, 0 (false) – не показувати.
    Типово: true

  • echo (логічний)
    Виводити на екран або повертати для обробки: 1 (true) – виводити, 0 (false) – повертати.
    Типово: true

  • feed (рядок)
    Текст для посилання на фід кожного автора, якщо текст не переданий на фід не буде виводитися.
    За замовчуванням: ”

  • feed_image (рядок)
    Нехай/посилання на картинку, яка буде показана як посилання на фід кожного автора. Альтернатива параметру feed.
    За замовчуванням: ”

  • feed_type (рядок)
    Тип фіда. Порожній рядок – фід встановлений на блозі за промовчанням, можливі значення: rss2, atom, rss, rdf.
    За замовчуванням: ”

  • style (рядок)
    У якому форматі відображатиметься список. За замовчуванням виводиться у форматі list– ul список, якщо вказати none, то автори будуть показані через кому. Цей параметр працює, лише якщо увімкнено параметр html.
    За замовчуванням: ‘list’

  • HTML (логічний)
    Включає або вимикає форматування HTML. За замовчуванням форматування увімкнено (true), якщо його вимкнути (false), то список буде виведений як посилання на авторів через кому.
    Типово: true

Приклади

0

#1 Отримаємо список авторів сайту

Список виводить авторів сайту, показуючи повне ім’я ( show_fullname=1 ) та кількість записів у кожного автора ( optioncount=1 ). Сортування відбувається у зворотному порядку ( order=DESC ) за кількістю записів кожного автора ( orderby=post_count ). Висновок обмежений трьома авторами ( number=3 ). Так само, за замовчуванням зі списку виключено автора з ніком admin , виключені автори, що не мають записів і не показуються посилання на RSS-фіди.

<?php wp_list_authors('show_fullname=1&optioncount=1&orderby=post_count&order=DESC&number=3'); ?>

В результаті ми отримаємо щось подібне:

Andrew Anderson (48)
Harriett Smith (42)
Sally Smith (29)

нотатки

  • Global. wpdb. $wpdb WordPress database abstraction object.

список змін

З версії 1.2.0Введено.

wp list authors WP 6.0.2

wp-includes/author-template.php 
function wp_list_authors( $args = '' ) {
	Global $wpdb;

	$defaults = array(
		'orderby' => 'name',
		'order' => 'ASC',
		'number' => '',
		'optioncount' => false,
		'exclude_admin' => true,
		'show_fullname' => false,
		'hide_empty' => true,
		'feed' => '',
		'feed_image' => '',
		'feed_type' => '',
		'echo' => true,
		'style' => 'list',
		'html' => true,
		'exclude' => '',
		'include' => '',
	);

	$ args = wp_parse_args ($ args, $ defaults);

	$ return = '';

	$query_args = wp_array_slice_assoc( $args, array( 'orderby', 'order', 'number', 'exclude', 'include' ) );
	$query_args['fields'] = 'ids';
	$ authors = get_users ($ query_args);

	$author_count = array();
	foreach ((array) $wpdb->get_results( "SELECT DISTINCT post_author, COUNT(ID) AS count FROM $wpdb->posts WHERE " . get_private_posts_cap_sql( 'post' ) . ' GROUP BY post_author' ) as $row )
		$author_count[ $row->post_author ] = $row->count;
	}
	foreach ( $authors as $author_id ) {
		$posts = isset($author_count[$author_id])? $author_count[$author_id]: 0;

		if ( ! $posts && $args['hide_empty'] ) {
			continue;
		}

		$ author = get_userdata ($ author_id);

		if ( $args['exclude_admin'] && 'admin' === $author->display_name ) {
			continue;
		}

		if ( $args['show_fullname'] && $author->first_name && $author->last_name ) {
			$name = "$author->first_name $author->last_name";
		} else {
			$name = $author->display_name;
		}

		if ( ! $args['html'] ) {
			$return. = $name. ', ';

			continue; // Не потрібно, щоб отримати процес HTML.
		}

		if ( 'list' === $args['style'] ) {
			$return .= '<li>';
		}

		$link = sprintf(
			'<a href="%1$s" title="%2$s">%3$s</a>',
			esc_url( get_author_posts_url( $author->ID, $author->user_nicename ) ),
			/* translators: %s: Author's display name. */
			esc_attr( sprintf( __( 'Posts by %s' ), ​​$author->display_name ) ),
			$name
		);

		if ( ! empty( $args['feed_image'] ) || ! empty( $args['feed'] ) ) {
			$link. = '';
			if ( empty( $args['feed_image'] ) ) {
				$link .= '(';
			}

			$link .= '<a href="' . get_author_feed_link( $author->ID, $args['feed_type'] ) . '"';

			$ alt = '';
			if ( ! empty( $args['feed'] ) ) {
				$alt = 'alt="' . esc_attr( $args['feed'] ) . '"';
				$name = $args['feed'];
			}

			$link .= '>';

			if ( ! empty( $args['feed_image'] ) ) {
				$link .= '<img src="' . esc_url( $args['feed_image'] ) . '" style="border: none;"' . $alt . '/>';
			} else {
				$link.=$name;
			}

			$link .= '</a>';

			if ( empty( $args['feed_image'] ) ) {
				$link .= ')';
			}
		}

		if ( $args['optioncount'] ) {
			$link .= '(' . $posts . ')';
		}

		$return. = $link;
		$return .= ( 'list' === $args['style'] ) ? '</li>' : ', ';
	}

	$ return = rtrim ($ return, ', ');

	if ( $args['echo'] ) {
		echo $return;
	} else {
		return $return;
	}
}

Список (wp_list списки)

Решта

Автори

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *