WordPress のテーマやプラグインを作成する際、ヘッダ部分に規約にそったルールでメタデータを記述する必要があります。

たとえばプラグインを作成する場合、ヘッダのコメントブロックに、少なくとも

Plugin Name: "プラグインの名前"

の一行が必要で、これがないとそのファイルがプラグインであると認識されませんよね。

また、これ以外にも Author や Description など、決まったキーワードとセットにして記述した文字列は、Wordpress のコアシステムがそれを正しく読み取って、必要に応じて管理画面に出力してくれます。

このときに用いられる、 get_file_data という関数は、自作のファイルを管理する際も用いることができるので、ライブラリを作成する場合など、予めルールを作ってそれにそって記述しておくといいと思いました。

get_file_data は、 /wp-includes/functions.php にあり、その中身は以下のとおり。

/**
 * Retrieve metadata from a file.
 *
 * Searches for metadata in the first 8kiB of a file, such as a plugin or theme.
 * Each piece of metadata must be on its own line. Fields can not span multple
 * lines, the value will get cut at the end of the first line.
 *
 * If the file data is not within that first 8kiB, then the author should correct
 * their plugin file and move the data headers to the top.
 *
 * @see http://codex.wordpress.org/File_Header
 *
 * @since 2.9.0
 * @param string $file Path to the file
 * @param array $default_headers List of headers, in the format array('HeaderKey' => 'Header Name')
 * @param string $context If specified adds filter hook "extra_{$context}_headers"
 */
function get_file_data( $file, $default_headers, $context = '' ) {
	// We don't need to write to the file, so just open for reading.
	$fp = fopen( $file, 'r' );

	// Pull only the first 8kiB of the file in.
	$file_data = fread( $fp, 8192 );

	// PHP will close file handle, but we are good citizens.
	fclose( $fp );

	if ( $context != '' ) {
		$extra_headers = apply_filters( "extra_{$context}_headers", array() );

		$extra_headers = array_flip( $extra_headers );
		foreach( $extra_headers as $key=>$value ) {
			$extra_headers[$key] = $key;
		}
		$all_headers = array_merge( $extra_headers, (array) $default_headers );
	} else {
		$all_headers = $default_headers;
	}

	foreach ( $all_headers as $field => $regex ) {
		preg_match( '/^[ \t\/*#@]*' . preg_quote( $regex, '/' ) . ':(.*)$/mi', $file_data, ${$field});
		if ( !empty( ${$field} ) )
			${$field} = _cleanup_header_comment( ${$field}[1] );
		else
			${$field} = '';
	}

	$file_data = compact( array_keys( $all_headers ) );

	return $file_data;
}