Title: WP Display Header
Author: Konstantin Obenland
Published: <strong>2011 年 3 月 28 日</strong>
Last modified: 2023 年 10 月 28 日

---

搜索插件

![](https://ps.w.org/wp-display-header/assets/banner-772x250.jpg?rev=2820999)

**该插件尚未通过WordPress的最新3个主要版本进行测试**。 当与较新版本的WordPress一起
使用时，可能不再受到维护或支持，并且可能会存在兼容性问题。

![](https://s.w.org/plugins/geopattern-icon/wp-display-header_7f969c.svg)

# WP Display Header

 作者：[Konstantin Obenland](https://profiles.wordpress.org/obenland/)

[下载](https://downloads.wordpress.org/plugin/wp-display-header.7.zip)

 * [详情](https://cn.wordpress.org/plugins/wp-display-header/#description)
 * [评价](https://cn.wordpress.org/plugins/wp-display-header/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/wp-display-header/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/wp-display-header/#developers)

 [支持](https://wordpress.org/support/plugin/wp-display-header/)

## 描述

This plugin lets you specify a header image for each post, page, custom post type
or archive page individually, from your default headers and custom headers.

It adds a meta box in the post edit screens with the header selection and a settings
field in the edit profile and each taxonomy edit screen.
 If no specific header 
is specified for a post it will fall back to the default selection. There is no 
change of template files necessary as this plugin hooks in the existing WordPress
API to unfold its magic.

Thanks to Erik T. for the idea to this plugin!

## 屏幕截图

 * [[
 * The meta box in the main column.
 * [[
 * The meta box in the side column.

## 安装

 1. Download WP Display Header.
 2. Unzip the folder into the `/wp-content/plugins/` directory
 3. 通过WordPress的“插件”菜单激活插件

## 常见问题

### What do I need in the `header.php` file to make the plugin work seamlessly?

To make it work in your `header.php` file all you need is a `header_image()` call
like so:

    ```
    <img src="<?php header_image(); ?>" width="<?php echo get_custom_header()->width; ?>" height="<?php echo get_custom_header()->height; ?>" alt="" />
    ```

See TwentyTwelve’s `header.php` for reference.

### Plugin Filter Hooks

**wpdh_show_default_header** (_bool_)

> Whether to show the default header (true) or to look for a specifically selected
> header for the current request.

**wpdh_get_header_posts** (_array_)

> All attachments with the meta key `_header_image`. An array with the query vars.

**wpdh_get_headers** (_array_)

> The array with all registered headers.

**wpdh_get_active_post_header** (_string_)

> The url to the currently active header image.

## 评价

![](https://secure.gravatar.com/avatar/412fdfb2acd3997d4b974a88ee2bf327cc2b4c8f06a34719427f5738f0152cd5?
s=60&d=retro&r=g)

### 󠀁[Simple and efficient](https://wordpress.org/support/topic/simple-and-efficient-221/)󠁿

 [pouicpouic](https://profiles.wordpress.org/pouicpouic/) 2019 年 5 月 2 日

This plugin does exactly what it promises, smooth and problem free.

![](https://secure.gravatar.com/avatar/991ad4508632de77075421d50b5837692194ce0fdb5f5bd43c749d1b5ec3689e?
s=60&d=retro&r=g)

### 󠀁[Does a fine job](https://wordpress.org/support/topic/does-a-fine-job-2/)󠁿

 [fuchsr](https://profiles.wordpress.org/fuchsr/) 2019 年 3 月 23 日

On my site I like to show a different hero graphic on each page, reflecting the 
specific contents of that page. The theme I’m using doesn’t allow me to choose different
header images. It uses the same on all pages. I tried a lot of plugins but this 
one was the only one that truly did the job. I found a couple of issues eg a header
image is available for selection but when I select it, the page shows the default
header instead. I was able to “fix” these issues but deleting the header images 
and re-uploading them. Would love to see an option to randomly pick headers based
on categories. Eg, I’d like one page to display a header picked from “Category A”
and another page show a header from “Category B”, with the headers randomly picked
from each respective category when pages are loaded.

![](https://secure.gravatar.com/avatar/ab69f1d45c1cbd238ed4c8cca82148231d65db2ad6610c3589407794d7054a46?
s=60&d=retro&r=g)

### 󠀁[Perfectly integrated in WP, works great](https://wordpress.org/support/topic/perfectly-integrated-in-wp-works-great/)󠁿

 [kingbolo](https://profiles.wordpress.org/kingbolo/) 2019 年 1 月 22 日

One of the best plugins for this job. Integrates perfectly in WordPress and it looks
that it belongs there. (and probably should).

![](https://secure.gravatar.com/avatar/a37c8ea760465d6e0b4035ba9ecc137ba6c3d2c90881c35bb8cc628840dcd2a7?
s=60&d=retro&r=g)

### 󠀁[Only uploading could be improved](https://wordpress.org/support/topic/only-uploading-could-be-improved/)󠁿

 [Sudrien](https://profiles.wordpress.org/sudrien/) 2019 年 1 月 19 日

WP Display Header works with the standard header_image(); system. As of 5.0.3, UPLOADING
header images seems a bit inconsistent, as it does not seem you can do that while
editing a page, but otherwise works well.

![](https://secure.gravatar.com/avatar/456cfe559d4536d5228cf61c9ae0e80ebbba5c4e0eaf88f2e3998a4989e3693a?
s=60&d=retro&r=g)

### 󠀁[Nice Plugin – Just works](https://wordpress.org/support/topic/nice-plugin-just-works/)󠁿

 [Dennis Booker](https://profiles.wordpress.org/dabooker/) 2018 年 4 月 23 日

I’ve looked through lots of postings and articles to find a way to have custom headers
and this plugin does just that. I’m using WP 4.9.5 and theme Twenty Seventeen and
no problems. Thanks.

![](https://secure.gravatar.com/avatar/f8889f9b5d0841dab38a9efeeb3c695d33532cd114d50be77265b16cb23bafce?
s=60&d=retro&r=g)

### 󠀁[Works great on WordPress.com](https://wordpress.org/support/topic/does-not-work-at-all-on-wordpress-com/)󠁿

 [r6123603680](https://profiles.wordpress.org/r6123603680/) 2017 年 10 月 27 日

Initially, I thought this was yet another plugin featured in the plugin directory
for WordPress.com doesn’t actually work there. As it turns out, it works perfectly
but you have to edit your pages through the legacy wp-admin console, not the main
editor. It works great – you just select “none” for the header image and voila!

 [ 阅读所有28条评价 ](https://wordpress.org/support/plugin/wp-display-header/reviews/)

## 贡献者及开发者

「WP Display Header」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ Konstantin Obenland ](https://profiles.wordpress.org/obenland/)

「WP Display Header」插件已被翻译至 2 种本地化语言。 感谢[所有译者](https://translate.wordpress.org/projects/wp-plugins/wp-display-header/contributors)
为本插件所做的贡献。

[帮助将「WP Display Header」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/wp-display-header)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/wp-display-header/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/wp-display-header/)，或通过[RSS](https://plugins.trac.wordpress.org/log/wp-display-header/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/wp-display-header/)。

## 更新日志

#### 7

 * Fixes a bug where posts pages would not load their assigned header image. See
   https://github.com/obenland/wp-display-header/issues/3
 * Updated utility class.
 * Tested for WordPress 6.1.

#### 6

 * Fixed a bug where srcset information for header images overrode custom header
   selections.

#### 5

 * Maintenance release.
 * Updated code to adhere to WordPress Coding Standards.
 * Tested for WordPress 5.0.

#### 4

 * Fixed a bug where styles were not enqueued correctly in wp-admin.
 * Now correctly displays the selection for header images on term edit pages again.
 * Tested for WordPress 4.6.0.

#### 3

 * Maintenance release.
 * Some minor code cleanups.
 * Tested for WordPress 4.4.0.

#### 2.2.0

 * Maintenance release.
 * Some minor code cleanups.
 * Tested for WordPress 4.0.

#### 2.1.0

 * Added an option to not display a header at all.
 * Updated utility class.
 * Tested for WordPress 3.6.

#### 2.0.1

 * Fixed a bug, where the fallback to the default header did not work. Props carloscorrela.

#### 2.0.0

 * **IMPORTANT**: Version 2.0.0 breaks compatibility with WordPress versions **prior**
   to 3.2!
 * Added the header selection field to Taxonomy and Author Edit screens.
 * Fixed a minor bug for themes that have no header images registered.

#### 1.5.3

 * Improved user experience when current theme does not support custom headers, 
   on activation of the plugin.
 * Deprecated settings functions for WP Save Custom Header in preparation for overhaul
   in v2.0.0.
 * Updated utility class.

#### 1.5.2

 * Fixed a bug, where a selected header wouldn’t override the default selection 
   on posts pages.

#### 1.5.1

 * Specific headers can now be reverted by selecting the default header.

#### 1.5

 * Adjusted meta box layout to WordPress core.
 * Transfered CSS in external file.
 * Updated FAQ section. Props Brian.
 * Tested for WordPress 3.3.1.

#### 1.4

 * Added support for WordPress 3.2 core header uploads.

#### 1.3

 * Tested for WordPress 3.2-beta
 * Fixed a minor bug where a PHP warning was issued in the edit-post-screen, when
   there are no header images registered.

#### 1.2.1

 * WordPress Plugin Repository update bug.

#### 1.2

 * Tested for WordPress 3.1.2.
 * Now a custom folder name can be specified. See: Settings > Media.
 * Added Italian translation. Props Pietro Rossi.

#### 1.1

 * Tested for WordPress 3.1.1
 * Adopted [WP Save Custom Header](https://wordpress.org/extend/plugins/wp-save-custom-header/)
   multisite capability.
 * Made HTML W3C valid.

#### 1.0

 * Initial Release.

## 额外信息

 *  版本 **7**
 *  最后更新：**2 年前**
 *  活跃安装数量 **7,000+**
 *  WordPress 版本 ** 3.2 或更高版本 **
 *  已测试的最高版本为 **6.4.8**
 *  语言
 * [Dutch](https://nl.wordpress.org/plugins/wp-display-header/) 、 [English (US)](https://wordpress.org/plugins/wp-display-header/)
   和 [Ukrainian](https://uk.wordpress.org/plugins/wp-display-header/).
 *  [翻译成简体中文](https://translate.wordpress.org/projects/wp-plugins/wp-display-header)
 * 标签
 * [admin](https://cn.wordpress.org/plugins/tags/admin/)[custom header](https://cn.wordpress.org/plugins/tags/custom-header/)
   [custom header image](https://cn.wordpress.org/plugins/tags/custom-header-image/)
   [header](https://cn.wordpress.org/plugins/tags/header/)[header-image](https://cn.wordpress.org/plugins/tags/header-image/)
 *  [高级视图](https://cn.wordpress.org/plugins/wp-display-header/advanced/)

## 评级

 4.5 星（最高 5 星）。

 *  [  22 条 5 星评价     ](https://wordpress.org/support/plugin/wp-display-header/reviews/?filter=5)
 *  [  1 条 4 星评价     ](https://wordpress.org/support/plugin/wp-display-header/reviews/?filter=4)
 *  [  2 条 3 星评价     ](https://wordpress.org/support/plugin/wp-display-header/reviews/?filter=3)
 *  [  0 条 2 星评价     ](https://wordpress.org/support/plugin/wp-display-header/reviews/?filter=2)
 *  [  2 条 1 星评价     ](https://wordpress.org/support/plugin/wp-display-header/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/wp-display-header/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/wp-display-header/reviews/)

## 贡献者

 *   [ Konstantin Obenland ](https://profiles.wordpress.org/obenland/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/wp-display-header/)

## 捐助

您愿意支持这个插件的发展吗?

 [ 捐助此插件 ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=MWUA92KA2TL6Q)