get_post_stati() │ WP 3.0.0

Отримує всі існуючі статуси постів як масиву імен чи масиву об’єктів.

Працює на основі глобальної змінної $wp_post_statuses , яка містить повну інформацію про статуси у вигляді масиву об’єктів.

Працює на основі:
Хуків немає.

Повертає

Строку[]|stdClass[]. масив імен або масив об’єктів залежить від параметра $output .

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

get_post_stati ($ args, $ output, $ operator);
$args
(рядок/масив)
Масив – ключ => значення (
key=>value), які мають зустрічатися в отримуваних статусах.


За замовчуванням: array()
$output
(рядок)
Виводити імена чи об’єкти. names – виведе імена, у будь-якому іншому випадку об’єкти.


За замовчуванням: ‘names’
$operator
(рядок)
Логічний оператор фільтра $args. “or” шукатиме будь-який параметр із зазначених у $args у статусів. “and” буде шукати одночасно всі зазначені параметри статусу.


За замовчуванням: ‘and’

Приклади

0

#1 Отримаємо імена всіх видів статусів на блозі:

$stati = get_post_stati();

/* $stati =
Array (
	[publish] => publish
	[future] => future
	[draft] => draft
	[pending] => pending
	[private] => private
	[trash] => trash
	[auto-draft] => auto-draft
	[inherit] => inherit
)
*/
0

#2 Отримаємо об’єкти всіх видів статусів на блозі:

$stati = get_post_stati(0, 'a');

$stati міститиме:

Array
(
	[publish] => stdClass Object
		(
			[label] => Published
			[label_count] => Array
				(
					[0] => Published (%s)
					[1] => Published (%s)
					[singular] => Published (%s)
					[Plural] => Published (%s)
					[context] =>
					[domain] =>
				)

			[exclude_from_search] =>
			[_builtin] => 1
			[public] => 1
			[internal] =>
			[protected] =>
			[private] =>
			[publicly_queryable] => 1
			[show_in_admin_status_list] => 1
			[show_in_admin_all_list] => 1
			[name] => publish
		)

	[future] => stdClass Object
		(
			[label] => Scheduled
			[label_count] => Array
				(
					[0] => Scheduled (%s)
					[1] => Scheduled (%s)
					[singular] => Scheduled (%s)
					[Plural] => Scheduled (%s)
					[context] =>
					[domain] =>
				)

			[exclude_from_search] =>
			[_builtin] => 1
			[public] =>
			[internal] =>
			[protected] => 1
			[private] =>
			[publicly_queryable] =>
			[show_in_admin_status_list] => 1
			[show_in_admin_all_list] => 1
			[name] => future
		)

	[draft] => stdClass Object
		(
			[label] => Draft
			[label_count] => Array
				(
					[0] => Draft (%s)
					[1] => Drafts (%s)
					[singular] => Draft (%s)
					[plural] => Drafts (%s)
					[context] =>
					[domain] =>
				)

			[exclude_from_search] =>
			[_builtin] => 1
			[public] =>
			[internal] =>
			[protected] => 1
			[private] =>
			[publicly_queryable] =>
			[show_in_admin_status_list] => 1
			[show_in_admin_all_list] => 1
			[name] => draft
		)

	[pending] => stdClass Object
		(
			[label] => Pending
			[label_count] => Array
				(
					[0] => Pending (%s)
					[1] => Pending (%s)
					[singular] => Pending (%s)
					[Plural] => Pending (%s)
					[context] =>
					[domain] =>
				)

			[exclude_from_search] =>
			[_builtin] => 1
			[public] =>
			[internal] =>
			[protected] => 1
			[private] =>
			[publicly_queryable] =>
			[show_in_admin_status_list] => 1
			[show_in_admin_all_list] => 1
			[name] => pending
		)

	[private] => stdClass Object
		(
			[label] => Private
			[label_count] => Array
				(
					[0] => Private (%s)
					[1] => Private (%s)
					[singular] => Private (%s)
					[plural] => Private (%s)
					[context] =>
					[domain] =>
				)

			[exclude_from_search] =>
			[_builtin] => 1
			[public] =>
			[internal] =>
			[protected] =>
			[private] => 1
			[publicly_queryable] =>
			[show_in_admin_status_list] => 1
			[show_in_admin_all_list] => 1
			[name] => private
		)

	[trash] => stdClass Object
		(
			[label] => Trash
			[label_count] => Array
				(
					[0] => Trash (%s)
					[1] => Trash (%s)
					[singular] => Trash (%s)
					[Plural] => Trash (%s)
					[context] =>
					[domain] =>
				)

			[exclude_from_search] => 1
			[_builtin] => 1
			[public] =>
			[internal] => 1
			[protected] =>
			[private] =>
			[publicly_queryable] =>
			[show_in_admin_status_list] => 1
			[show_in_admin_all_list] =>
			[name] => trash
		)

	[auto-draft] => stdClass Object
		(
			[label] => auto-draft
			[label_count] => Array
				(
					[0] => auto-draft
					[1] => auto-draft
				)

			[exclude_from_search] => 1
			[_builtin] => 1
			[public] =>
			[internal] => 1
			[protected] =>
			[private] =>
			[publicly_queryable] =>
			[show_in_admin_status_list] =>
			[show_in_admin_all_list] =>
			[name] => auto-draft
		)

	[inherit] => stdClass Object
		(
			[label] => inherit
			[label_count] => Array
				(
					[0] => inherit
					[1] => inherit
				)

			[exclude_from_search] =>
			[_builtin] => 1
			[public] =>
			[internal] => 1
			[protected] =>
			[private] =>
			[publicly_queryable] =>
			[show_in_admin_status_list] =>
			[show_in_admin_all_list] =>
			[name] => inherit
		)

)
0

#3 Отримаємо статуси з потрібними параметрами (фільтр статусів)

У цьому вся прикладі ми отримаємо імена статусів у яких встановлено параметр publicly_queryable , тобто. ті статуси, які беруть участь у пошуку по сайту:

$stati = get_post_stati( [ 'publicly_queryable'=>true ], 'names' );

/* $stati =
Array(
	[publish] => publish
)
*/
0

#4 Приклад, що показує, як працює параметр $operator

Вкажемо 2 параметри масиву $args. or – виведе статуси у яких зустрічається або перший чи другий, а and виведе статуси у яких зустрічаються обидва параметри:

$stati = get_post_stati(
	[ 'show_in_admin_status_list'=>true, 'protected'=>true ],
	'names',
	'or'
);

/* $stati =
Array (
	[publish] => publish
	[future] => future
	[draft] => draft
	[pending] => pending
	[private] => private
	[trash] => trash
)
*/

і те саме з “and”:

$stati = get_post_stati(
	[ 'show_in_admin_status_list'=>true, 'protected'=>true ],
	'names',
	'and'
);

/* $stati =
Array (
	[future] => future
	[draft] => draft
	[pending] => pending
)
*/

нотатки

список змін

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

Код get_post_stati() WP 6.0.2

wp-includes/post.php 
function get_post_stati( $args = array(), $output = 'names', $operator = 'and' ) {
	global $wp_post_statuses;

	$field = ('names' === $output)? 'name': false;

	return wp_filter_object_list( $wp_post_statuses, $args, $operator, $field );
}

statuses (статус запису коментаря користувача)

Решта

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

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