# get_plugin_data()

URL: https://chugunov.pro/api-wordpress/functions/get_plugin_data/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 1.5.0.

## Сигнатура

```php
get_plugin_data( string $plugin_file, bool $markup = true, bool $translate = true ): array
```

## Описание

Каждый заголовок плагина должен располагаться на отдельной строке. Описание плагина не должно содержать переносов строк, иначе будет отображена только часть описания.
Ниже приведён вариант, отформатированный для наглядности.
/*
Plugin Name: Название плагина.
Plugin URI: Домашняя страница плагина.
Description: Описание плагина.
Author: Имя автора плагина.
Author URI: Ссылка на сайт автора.
Version: Версия плагина.
Text Domain: Необязательно. Уникальный идентификатор, должен совпадать с тем, что используется в
load_plugin_textdomain().
Domain Path: Необязательно. Полезно только если переводы расположены в
папке выше базового пути плагина. Например, если файлы .mo
расположены в папке locale, то Domain Path будет "/locale/" и
должен начинаться с косой черты. По умолчанию — базовая папка, в которой
расположен плагин.
Network: Необязательно. Укажите "Network: true", чтобы требовать активации плагина
на всех сайтах установки. Это не позволит активировать плагин
на отдельном сайте при включённом режиме Multisite.
Requires at least: Необязательно. Укажите минимальную требуемую версию WordPress.
Requires PHP: Необязательно. Укажите минимальную требуемую версию PHP.
* / # Уберите пробел, чтобы закрыть комментарий.Считываются первые 8 КБ файла, и если данные плагина не помещаются в эти первые 8 КБ, автору плагина следует исправить плагин и переместить заголовки с данными плагина в начало.
Предполагается, что файл плагина имеет права, позволяющие скриптам читать файл. Однако это не проверяется, и файл открывается только для чтения.

## Параметры

- `$plugin_file` `string` — обязательный. Абсолютный путь к главному файлу плагина.
- `$markup` `bool` — необязательный, по умолчанию `true`. Нужно ли применять HTML-разметку к возвращаемым данным.
- `$translate` `bool` — необязательный, по умолчанию `true`. Нужно ли переводить возвращаемые данные.

## Возвращаемое значение

`array` — Name stringНазвание плагина. Должно быть уникальным. PluginURI stringURI плагина. Version stringВерсия плагина. Description stringОписание плагина. Author stringИмя автора плагина. AuthorURI stringАдрес сайта автора плагина (если задан). TextDomain stringTextdomain плагина. DomainPath stringОтносительный путь к каталогу плагина с файлами .mo. Network boolМожет ли плагин быть активирован только в рамках всей сети. RequiresWP stringМинимальная требуемая версия WordPress. RequiresPHP stringМинимальная требуемая версия PHP. UpdateURI stringИдентификатор плагина для целей обновления, должен быть URI. RequiresPlugins stringСписок слагов плагинов с dot org, разделённых запятыми. Title stringНазвание плагина и ссылка на сайт плагина (если задана). AuthorName stringИмя автора плагина.

## Исходный код

Файл: `wp-admin/includes/plugin.php:74`

```php
function get_plugin_data( $plugin_file, $markup = true, $translate = true ) {

	$default_headers = array(
		'Name'            => 'Plugin Name',
		'PluginURI'       => 'Plugin URI',
		'Version'         => 'Version',
		'Description'     => 'Description',
		'Author'          => 'Author',
		'AuthorURI'       => 'Author URI',
		'TextDomain'      => 'Text Domain',
		'DomainPath'      => 'Domain Path',
		'Network'         => 'Network',
		'RequiresWP'      => 'Requires at least',
		'RequiresPHP'     => 'Requires PHP',
		'UpdateURI'       => 'Update URI',
		'RequiresPlugins' => 'Requires Plugins',
		// Site Wide Only is deprecated in favor of Network.
		'_sitewide'       => 'Site Wide Only',
	);

	$plugin_data = get_file_data( $plugin_file, $default_headers, 'plugin' );

	// Site Wide Only is the old header for Network.
	if ( ! $plugin_data['Network'] && $plugin_data['_sitewide'] ) {
		/* translators: 1: Site Wide Only: true, 2: Network: true */
		_deprecated_argument( __FUNCTION__, '3.0.0', sprintf( __( 'The %1$s plugin header is deprecated. Use %2$s instead.' ), '<code>Site Wide Only: true</code>', '<code>Network: true</code>' ) );
		$plugin_data['Network'] = $plugin_data['_sitewide'];
	}
	$plugin_data['Network'] = ( 'true' === strtolower( $plugin_data['Network'] ) );
	unset( $plugin_data['_sitewide'] );

	// If no text domain is defined fall back to the plugin slug.
	if ( ! $plugin_data['TextDomain'] ) {
		$plugin_slug = dirname( plugin_basename( $plugin_file ) );
		if ( '.' !== $plugin_slug && ! str_contains( $plugin_slug, '/' ) ) {
			$plugin_data['TextDomain'] = $plugin_slug;
		}
	}

	if ( $markup || $translate ) {
		$plugin_data = _get_plugin_data_markup_translate( $plugin_file, $plugin_data, $markup, $translate );
	} else {
		$plugin_data['Title']      = $plugin_data['Name'];
		$plugin_data['AuthorName'] = $plugin_data['Author'];
	}

	return $plugin_data;
}
```

## История изменений

- 6.5.0 — Added support for Requires Plugins header.
- 5.8.0 — Added support for Update URI header.
- 5.3.0 — Added support for Requires at least and Requires PHP headers.
- 1.5.0 — Introduced.

## Связанные

Использует: [`_get_plugin_data_markup_translate`](https://chugunov.pro/api-wordpress/functions/_get_plugin_data_markup_translate/), [`get_file_data`](https://chugunov.pro/api-wordpress/functions/get_file_data/), [`plugin_basename`](https://chugunov.pro/api-wordpress/functions/plugin_basename/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`_deprecated_argument`](https://chugunov.pro/api-wordpress/functions/_deprecated_argument/).
Используется в: `WP_REST_Templates_Controller::get_wp_templates_author_text_field`, `WP_REST_Plugins_Controller::create_item`, [`validate_plugin_requirements`](https://chugunov.pro/api-wordpress/functions/validate_plugin_requirements/), [`wp_ajax_delete_plugin`](https://chugunov.pro/api-wordpress/functions/wp_ajax_delete_plugin/), [`wp_ajax_update_plugin`](https://chugunov.pro/api-wordpress/functions/wp_ajax_update_plugin/), `WP_Automatic_Updater::update`, `Plugin_Upgrader::bulk_upgrade`, `Plugin_Upgrader::check_package`, [`get_dropins`](https://chugunov.pro/api-wordpress/functions/get_dropins/), [`is_network_only_plugin`](https://chugunov.pro/api-wordpress/functions/is_network_only_plugin/), [`get_plugins`](https://chugunov.pro/api-wordpress/functions/get_plugins/), [`get_mu_plugins`](https://chugunov.pro/api-wordpress/functions/get_mu_plugins/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/get_plugin_data/