attachment_submitbox_metadata

函数


      attachment_submitbox_metadata ( No parameters )

定义位置

wp-admin/includes/media.php , line 3273

相关方法: attachment_submit_meta_box wp_get_attachment_metadata wp_update_attachment_metadata wp_generate_attachment_metadata attachment_id3_data_meta_box

引入: 3.5.0

弃用: -

attachment_submitbox_metadata: 这个函数用来在保存文章编辑界面时保存附件的元数据: 当一个文章被保存时，它会被调用。

在发布元数据框中显示不可编辑的附件元数据。

function attachment_submitbox_metadata() {

$post = get_post();

$attachment_id = $post->ID;

$file = get_attached_file( $attachment_id );

$filename = esc_html( wp_basename( $file ) );

$media_dims = '';

$meta = wp_get_attachment_metadata( $attachment_id );

if ( isset( $meta['width'], $meta['height'] ) ) {

$media_dims .= "<span id='media-dims-$attachment_id'>{$meta['width']} × {$meta['height']}</span> ";

}

/** This filter is documented in wp-admin/includes/media.php */

$media_dims = apply_filters( 'media_meta', $media_dims, $post );

$att_url = wp_get_attachment_url( $attachment_id );

$author = new WP_User( $post->post_author );

$uploaded_by_name = __( '(no author)' );

$uploaded_by_link = '';

if ( $author->exists() ) {

$uploaded_by_name = $author->display_name ? $author->display_name : $author->nickname;

$uploaded_by_link = get_edit_user_link( $author->ID );

}

<?php if ( $uploaded_by_link ) { ?>

<?php _e( 'Uploaded by:' ); ?> <a href="<?php echo $uploaded_by_link; ?>"><strong><?php echo $uploaded_by_name; ?></strong></a>

<?php } else { ?>

<?php _e( 'Uploaded by:' ); ?> <strong><?php echo $uploaded_by_name; ?></strong>

<?php } ?>

</div>

<?php

if ( $post->post_parent ) {

$post_parent = get_post( $post->post_parent );

if ( $post_parent ) {

$uploaded_to_title = $post_parent->post_title ? $post_parent->post_title : __( '(no title)' );

$uploaded_to_link = get_edit_post_link( $post->post_parent, 'raw' );

<?php if ( $uploaded_to_link ) { ?>

<?php _e( 'Uploaded to:' ); ?> <a href="<?php echo $uploaded_to_link; ?>"><strong><?php echo $uploaded_to_title; ?></strong></a>

<?php } else { ?>

<?php _e( 'Uploaded to:' ); ?> <strong><?php echo $uploaded_to_title; ?></strong>

<?php } ?>

</div>

<?php

}

</span>

</div>

<?php _e( 'File name:' ); ?> <strong><?php echo $filename; ?></strong>

</div>

<?php _e( 'File type:' ); ?>

<?php

if ( preg_match( '/^.*?.(w+)$/', get_attached_file( $post->ID ), $matches ) ) {

echo esc_html( strtoupper( $matches[1] ) );

list( $mime_type ) = explode( '/', $post->post_mime_type );

if ( 'image' !== $mime_type && ! empty( $meta['mime_type'] ) ) {

if ( "$mime_type/" . strtolower( $matches[1] ) !== $meta['mime_type'] ) {

echo ' (' . $meta['mime_type'] . ')';

}

} else {

echo strtoupper( str_replace( 'image/', '', $post->post_mime_type ) );

}

</strong>

</div>

<?php

$file_size = false;

if ( isset( $meta['filesize'] ) ) {

$file_size = $meta['filesize'];

} elseif ( file_exists( $file ) ) {

$file_size = wp_filesize( $file );

}

if ( ! empty( $file_size ) ) {

<?php _e( 'File size:' ); ?> <strong><?php echo size_format( $file_size ); ?></strong>

</div>

<?php

}

if ( preg_match( '#^(audio|video)/#', $post->post_mime_type ) ) {

$fields = array(

'length_formatted' => __( 'Length:' ),

'bitrate' => __( 'Bitrate:' ),

);

/**

* Filters the audio and video metadata fields to be shown in the publish meta box.

* The key for each item in the array should correspond to an attachment

* metadata key, and the value should be the desired label.

* @since 3.7.0

* @since 4.9.0 Added the `$post` parameter.

* @param array $fields An array of the attachment metadata keys and labels.

* @param WP_Post $post WP_Post object for the current attachment.

$fields = apply_filters( 'media_submitbox_misc_sections', $fields, $post );

foreach ( $fields as $key => $label ) {

if ( empty( $meta[ $key ] ) ) {

continue;

}

<?php echo $label; ?>

<?php

switch ( $key ) {

case 'bitrate':

echo round( $meta['bitrate'] / 1000 ) . 'kb/s';

if ( ! empty( $meta['bitrate_mode'] ) ) {

echo ' ' . strtoupper( esc_html( $meta['bitrate_mode'] ) );

}

break;

default:

echo esc_html( $meta[ $key ] );

break;

}

</strong>

</div>

<?php

}

$fields = array(

'dataformat' => __( 'Audio Format:' ),

'codec' => __( 'Audio Codec:' ),

);

/**

* Filters the audio attachment metadata fields to be shown in the publish meta box.

* The key for each item in the array should correspond to an attachment

* metadata key, and the value should be the desired label.

* @since 3.7.0

* @since 4.9.0 Added the `$post` parameter.

* @param array $fields An array of the attachment metadata keys and labels.

* @param WP_Post $post WP_Post object for the current attachment.

$audio_fields = apply_filters( 'audio_submitbox_misc_sections', $fields, $post );

foreach ( $audio_fields as $key => $label ) {

if ( empty( $meta['audio'][ $key ] ) ) {

continue;

}

<?php echo $label; ?> <strong><?php echo esc_html( $meta['audio'][ $key ] ); ?></strong>

</div>

<?php

}

if ( $media_dims ) {

<?php _e( 'Dimensions:' ); ?> <strong><?php echo $media_dims; ?></strong>

</div>

<?php

}

if ( ! empty( $meta['original_image'] ) ) {

<?php _e( 'Original image:' ); ?>

<?php echo esc_html( wp_basename( wp_get_original_image_path( $attachment_id ) ) ); ?>

</a>

</div>

<?php

}

function attachment_submitbox_metadata() {
	$post          = get_post();
	$attachment_id = $post->ID;

	$file     = get_attached_file( $attachment_id );
	$filename = esc_html( wp_basename( $file ) );

	$media_dims = '';
	$meta       = wp_get_attachment_metadata( $attachment_id );

	if ( isset( $meta['width'], $meta['height'] ) ) {
		$media_dims .= "<span id='media-dims-$attachment_id'>{$meta['width']}&nbsp;&times;&nbsp;{$meta['height']}</span> ";
	}
	/** This filter is documented in wp-admin/includes/media.php */
	$media_dims = apply_filters( 'media_meta', $media_dims, $post );

	$att_url = wp_get_attachment_url( $attachment_id );

	$author = new WP_User( $post->post_author );

	$uploaded_by_name = __( '(no author)' );
	$uploaded_by_link = '';

	if ( $author->exists() ) {
		$uploaded_by_name = $author->display_name ? $author->display_name : $author->nickname;
		$uploaded_by_link = get_edit_user_link( $author->ID );
	}
	?>
	<div class="misc-pub-section misc-pub-uploadedby">
		<?php if ( $uploaded_by_link ) { ?>
			<?php _e( 'Uploaded by:' ); ?> <a href="<?php echo $uploaded_by_link; ?>"><strong><?php echo $uploaded_by_name; ?></strong></a>
		<?php } else { ?>
			<?php _e( 'Uploaded by:' ); ?> <strong><?php echo $uploaded_by_name; ?></strong>
		<?php } ?>
	</div>

	<?php
	if ( $post->post_parent ) {
		$post_parent = get_post( $post->post_parent );
		if ( $post_parent ) {
			$uploaded_to_title = $post_parent->post_title ? $post_parent->post_title : __( '(no title)' );
			$uploaded_to_link  = get_edit_post_link( $post->post_parent, 'raw' );
			?>
			<div class="misc-pub-section misc-pub-uploadedto">
				<?php if ( $uploaded_to_link ) { ?>
					<?php _e( 'Uploaded to:' ); ?> <a href="<?php echo $uploaded_to_link; ?>"><strong><?php echo $uploaded_to_title; ?></strong></a>
				<?php } else { ?>
					<?php _e( 'Uploaded to:' ); ?> <strong><?php echo $uploaded_to_title; ?></strong>
				<?php } ?>
			</div>
			<?php
		}
	}
	?>

	<div class="misc-pub-section misc-pub-attachment">
		<label for="attachment_url"><?php _e( 'File URL:' ); ?></label>
		<input type="text" class="widefat urlfield" readonly="readonly" name="attachment_url" id="attachment_url" value="<?php echo esc_attr( $att_url ); ?>" />
		<span class="copy-to-clipboard-container">
			<button type="button" class="button copy-attachment-url edit-media" data-clipboard-target="#attachment_url"><?php _e( 'Copy URL to clipboard' ); ?></button>
			<span class="success hidden" aria-hidden="true"><?php _e( 'Copied!' ); ?></span>
		</span>
	</div>
	<div class="misc-pub-section misc-pub-filename">
		<?php _e( 'File name:' ); ?> <strong><?php echo $filename; ?></strong>
	</div>
	<div class="misc-pub-section misc-pub-filetype">
		<?php _e( 'File type:' ); ?>
		<strong>
		<?php

		if ( preg_match( '/^.*?.(w+)$/', get_attached_file( $post->ID ), $matches ) ) {
			echo esc_html( strtoupper( $matches[1] ) );
			list( $mime_type ) = explode( '/', $post->post_mime_type );
			if ( 'image' !== $mime_type && ! empty( $meta['mime_type'] ) ) {
				if ( "$mime_type/" . strtolower( $matches[1] ) !== $meta['mime_type'] ) {
					echo ' (' . $meta['mime_type'] . ')';
				}
			}
		} else {
			echo strtoupper( str_replace( 'image/', '', $post->post_mime_type ) );
		}

		?>
		</strong>
	</div>

	<?php

	$file_size = false;

	if ( isset( $meta['filesize'] ) ) {
		$file_size = $meta['filesize'];
	} elseif ( file_exists( $file ) ) {
		$file_size = wp_filesize( $file );
	}

	if ( ! empty( $file_size ) ) {
		?>
		<div class="misc-pub-section misc-pub-filesize">
			<?php _e( 'File size:' ); ?> <strong><?php echo size_format( $file_size ); ?></strong>
		</div>
		<?php
	}

	if ( preg_match( '#^(audio|video)/#', $post->post_mime_type ) ) {
		$fields = array(
			'length_formatted' => __( 'Length:' ),
			'bitrate'          => __( 'Bitrate:' ),
		);

		/**
		 * Filters the audio and video metadata fields to be shown in the publish meta box.
		 *
		 * The key for each item in the array should correspond to an attachment
		 * metadata key, and the value should be the desired label.
		 *
		 * @since 3.7.0
		 * @since 4.9.0 Added the `$post` parameter.
		 *
		 * @param array   $fields An array of the attachment metadata keys and labels.
		 * @param WP_Post $post   WP_Post object for the current attachment.
		 */
		$fields = apply_filters( 'media_submitbox_misc_sections', $fields, $post );

		foreach ( $fields as $key => $label ) {
			if ( empty( $meta[ $key ] ) ) {
				continue;
			}

			?>
			<div class="misc-pub-section misc-pub-mime-meta misc-pub-<?php echo sanitize_html_class( $key ); ?>">
				<?php echo $label; ?>
				<strong>
				<?php

				switch ( $key ) {
					case 'bitrate':
						echo round( $meta['bitrate'] / 1000 ) . 'kb/s';
						if ( ! empty( $meta['bitrate_mode'] ) ) {
							echo ' ' . strtoupper( esc_html( $meta['bitrate_mode'] ) );
						}
						break;
					default:
						echo esc_html( $meta[ $key ] );
						break;
				}

				?>
				</strong>
			</div>
			<?php
		}

		$fields = array(
			'dataformat' => __( 'Audio Format:' ),
			'codec'      => __( 'Audio Codec:' ),
		);

		/**
		 * Filters the audio attachment metadata fields to be shown in the publish meta box.
		 *
		 * The key for each item in the array should correspond to an attachment
		 * metadata key, and the value should be the desired label.
		 *
		 * @since 3.7.0
		 * @since 4.9.0 Added the `$post` parameter.
		 *
		 * @param array   $fields An array of the attachment metadata keys and labels.
		 * @param WP_Post $post   WP_Post object for the current attachment.
		 */
		$audio_fields = apply_filters( 'audio_submitbox_misc_sections', $fields, $post );

		foreach ( $audio_fields as $key => $label ) {
			if ( empty( $meta['audio'][ $key ] ) ) {
				continue;
			}

			?>
			<div class="misc-pub-section misc-pub-audio misc-pub-<?php echo sanitize_html_class( $key ); ?>">
				<?php echo $label; ?> <strong><?php echo esc_html( $meta['audio'][ $key ] ); ?></strong>
			</div>
			<?php
		}
	}

	if ( $media_dims ) {
		?>
		<div class="misc-pub-section misc-pub-dimensions">
			<?php _e( 'Dimensions:' ); ?> <strong><?php echo $media_dims; ?></strong>
		</div>
		<?php
	}

	if ( ! empty( $meta['original_image'] ) ) {
		?>
		<div class="misc-pub-section misc-pub-original-image word-wrap-break-word">
			<?php _e( 'Original image:' ); ?>
			<a href="<?php echo esc_url( wp_get_original_image_url( $attachment_id ) ); ?>">
				<?php echo esc_html( wp_basename( wp_get_original_image_path( $attachment_id ) ) ); ?>
			</a>
		</div>
		<?php
	}
}

常见问题

FAQs

如何使用get_users获取所有用户列表？
要使用` get_users `函数获取所有用户列表，可以按照以下步骤进行：

1. 使用` get_users `函数调用获取用户列表：

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
$users = get_users();
$users = get_users();
```
$users = get_users();
```
2. 您可以按需使用参数来过滤结果。例如，您可以通过角色、用户ID、用户登录名等过滤用户列表。以下是一个根据用户角色为过滤条件的示例：

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
$users = get_users( array(
'role' => 'subscriber' // 将角色名称替换为您要过滤的角色
) );
$users = get_users( array( 'role' => 'subscriber' // 将角色名称替换为您要过滤的角色 ) );
```
$users = get_users( array(
    'role' => 'subscriber' // 将角色名称替换为您要过滤的角色
) );
```
在上述示例中，将` role `参数设置为所需的角色名称来过滤用户列表。

3. 您可以使用循环遍历获取的用户列表，并访问每个用户的属性。例如，以下示例将显示每个用户的用户名和电子邮件地址：

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
foreach( $users as $user ) {
echo '用户名：' . $user->user_login . ', 电子邮件：' . $user->user_email . ;
}
foreach( $users as $user ) { echo '用户名：' . $user->user_login . ', 电子邮件：' . $user->user_email . ; }
```
foreach( $users as $user ) {
    echo '用户名：' . $user->user_login . ', 电子邮件：' . $user->user_email . ;
}
```
在上述示例中，通过` $user->user_login `和` $user->user_email `访问每个用户的用户名和电子邮件地址。

请注意，` get_users `函数默认返回所有用户，并可以根据需要使用更多参数进行过滤。您可以参阅WordPress官方文档中的` get_users `函数文档，了解更多可用参数和用法示例。

总结起来，使用` get_users `函数获取所有用户列表的步骤是：
1. 调用` get_users `函数获取用户列表。
2. 使用可选的过滤参数，根据需要过滤用户列表。
3. 使用循环遍历用户列表，并访问每个用户的属性。
如何使用WP_PLUGIN_DIR和WP_PLUGIN_URL定义插件的目录和URL？
在WordPress中，可以使用WP_PLUGIN_DIR和WP_PLUGIN_URL常量来定义插件的目录路径和URL。

1. `WP_PLUGIN_DIR`：这是一个常量，用于定义插件的目录路径（文件系统路径）。您可以使用以下代码在插件文件中访问该常量：

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
$plugin_dir = WP_PLUGIN_DIR . '/your-plugin-folder/';
$plugin_dir = WP_PLUGIN_DIR . '/your-plugin-folder/';
```
$plugin_dir = WP_PLUGIN_DIR . '/your-plugin-folder/';
```
在上述代码中，将"your-plugin-folder"替换为您插件的实际文件夹名称。使用该常量，您可以获取插件文件的完整路径。

2. `WP_PLUGIN_URL`：这是一个常量，用于定义插件的URL（用于在网页上访问插件文件）。以下是一个使用该常量的示例：

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
$plugin_url = WP_PLUGIN_URL . '/your-plugin-folder/';
$plugin_url = WP_PLUGIN_URL . '/your-plugin-folder/';
```
$plugin_url = WP_PLUGIN_URL . '/your-plugin-folder/';
```
同样，请将"your-plugin-folder"替换为您插件的实际文件夹名称。使用该常量，您可以获取插件在网页上的完整URL。

请注意，`WP_PLUGIN_DIR`和`WP_PLUGIN_URL`常量在WordPress版本2.6之后引入。从WordPress 5.5版本开始，这两个常量被标记为过时（deprecated），因为WordPress更倾向于使用新的插件文件结构。如果您正在开发新插件，建议使用新的插件文件结构和相关函数。

在新的插件文件结构中，可以使用以下函数来获取插件的目录路径和URL：

- `plugin_dir_path()`：获取插件目录路径。
- `plugin_dir_url()`：获取插件URL。

这些函数会自动将插件的版本、多站点和SSL等考虑因素纳入计算。

总结起来，使用`WP_PLUGIN_DIR`和`WP_PLUGIN_URL`常量定义插件的目录和URL的方法是：

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
$plugin_dir = WP_PLUGIN_DIR . '/your-plugin-folder/';
$plugin_url = WP_PLUGIN_URL . '/your-plugin-folder/';
$plugin_dir = WP_PLUGIN_DIR . '/your-plugin-folder/'; $plugin_url = WP_PLUGIN_URL . '/your-plugin-folder/';
```
$plugin_dir = WP_PLUGIN_DIR . '/your-plugin-folder/';
$plugin_url = WP_PLUGIN_URL . '/your-plugin-folder/';
```
但请注意，这两个常量已被标记为过时，建议使用新的插件文件结构和相关函数来获取插件的路径和URL。
如何使用PHP在WordPress中添加自定义功能？
使用PHP在WordPress中添加自定义功能可以通过以下方式实现：
- 创建一个自定义插件，将功能代码添加到插件中。
- 使用WordPress的钩子系统，将自定义功能绑定到适当的钩子上。
- 在主题文件中添加自定义功能代码，例如functions.php文件。
- 使用WordPress的短代码功能，将自定义功能封装为短代码。
- 使用WordPress的插件或主题编辑器，将自定义功能代码添加到适当的位置。
下面是一个实操示例。

要在WordPress中添加自定义功能，可以按照以下步骤使用PHP编写并添加自定义功能：
1. 打开WordPress安装目录中的主题文件夹，通常位于wp-content/themes/下，找到正在使用的主题文件夹。
2. 在主题文件夹中，可以创建一个名为functions.php的文件。如果该文件已经存在，可以直接编辑它。
3. 在functions.php文件中，可以使用PHP代码添加自定义功能。以下是一些常见的示例：
  Plain text
  Copy to clipboard
  Open code in new window
  EnlighterJS 3 Syntax Highlighter
  // 添加自定义功能示例
  // 1. 创建自定义短代码
  function custom_shortcode() {
  return '这是我的自定义短代码内容';
  }
  add_shortcode('custom', 'custom_shortcode');
  // 2. 自定义小工具
  function custom_widget() {
  echo '这是我的自定义小工具内容';
  }
  register_widget('custom_widget');
  // 3. 自定义菜单
  function custom_menu() {
  register_nav_menu('custom-menu', '自定义菜单');
  }
  add_action('after_setup_theme', 'custom_menu');
  // 4. 自定义页面模板
  function custom_page_template() {
  /* Template Name: 自定义模板 */
  // 自定义模板的内容和样式
  }
  // 添加自定义功能示例 // 1. 创建自定义短代码 function custom_shortcode() { return '这是我的自定义短代码内容'; } add_shortcode('custom', 'custom_shortcode'); // 2. 自定义小工具 function custom_widget() { echo '这是我的自定义小工具内容'; } register_widget('custom_widget'); // 3. 自定义菜单 function custom_menu() { register_nav_menu('custom-menu', '自定义菜单'); } add_action('after_setup_theme', 'custom_menu'); // 4. 自定义页面模板 function custom_page_template() { /* Template Name: 自定义模板 */ // 自定义模板的内容和样式 }
```
// 添加自定义功能示例

// 1. 创建自定义短代码
function custom_shortcode() {
    return '这是我的自定义短代码内容';
}
add_shortcode('custom', 'custom_shortcode');

// 2. 自定义小工具
function custom_widget() {
    echo '这是我的自定义小工具内容';
}
register_widget('custom_widget');

// 3. 自定义菜单
function custom_menu() {
    register_nav_menu('custom-menu', '自定义菜单');
}
add_action('after_setup_theme', 'custom_menu');

// 4. 自定义页面模板
function custom_page_template() {
    /* Template Name: 自定义模板 */
    // 自定义模板的内容和样式
}
```
4. 编辑完functions.php文件后，保存并上传到WordPress主题文件夹中。
请注意，修改主题文件可以在主题更新时丢失，因此建议在进行任何更改之前备份functions.php文件。此外，为避免不必要的错误和冲突，建议在添加自定义功能前先了解WordPress开发文档和最佳实践，以确保正确、安全地实现所需的自定义功能。
如何进行WordPress数据库查询优化？
进行WordPress数据库查询优化可以通过以下方式实现：
- 使用WordPress提供的内置查询函数，例如 WP_Query 、 get_posts 等。
- 使用适当的查询参数和过滤器，减少查询次数和数据量。
- 编写自定义的数据库查询语句，使用适当的索引和缓存。
- 优化数据库服务器配置和性能。
- 定期清理和优化数据库表。
如何使用do_action来触发一个钩子函数？
使用 do_action 函数可以触发一个钩子函数。do_action 函数的参数与要触发的钩子函数的参数相同。

例如，触发save_post钩子函数的代码如下：

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
do_action( 'save_post', $post_ID, $post );
do_action( 'save_post', $post_ID, $post );
```
do_action( 'save_post', $post_ID, $post );
```
这里，$post_ID 和 $post 是传递给钩子函数的参数。
如何使用wp_get_current_user获取当前登录用户的信息？
使用 wp_get_current_user 获取当前登录用户的信息：

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
$current_user = wp_get_current_user();

// 获取当前用户的ID
$user_id = $current_user->ID;

// 获取当前用户的用户名
$user_login = $current_user->user_login;

// 获取当前用户的邮箱
$user_email = $current_user->user_email;

// 获取当前用户的显示名称
$display_name = $current_user->display_name;
$current_user = wp_get_current_user(); // 获取当前用户的ID $user_id = $current_user->ID; // 获取当前用户的用户名 $user_login = $current_user->user_login; // 获取当前用户的邮箱 $user_email = $current_user->user_email; // 获取当前用户的显示名称 $display_name = $current_user->display_name;
```
$current_user = wp_get_current_user();  
  
// 获取当前用户的ID  
$user_id = $current_user->ID;  
  
// 获取当前用户的用户名  
$user_login = $current_user->user_login;  
  
// 获取当前用户的邮箱  
$user_email = $current_user->user_email;  
  
// 获取当前用户的显示名称  
$display_name = $current_user->display_name;
```

attachment_submitbox_metadata

常见问题

相关文章