Easy-to-follow video tutorials help you learn software, creative, and business skills.Become a member

Adding an optional header image function

From: WordPress: Building Themes from Scratch Using Underscores

Video: Adding an optional header image function

While displaying the title and tagline of your site This is done under the Include folder in the custom header template.

Adding an optional header image function

While displaying the title and tagline of your site with a nice color background is great, sometimes you want to add a header image as a background or maybe even replace the title with just the header image. That way you can display a company logo or your own custom graphic, or just add an image to add some flavor to your site. WordPress has a built in custom header image option that can be controlled from the admin panel or from the theme customizer. And we activated this feature when we enabled the custom header function.

Now we need to make that header image function actually work with our theme. So the first thing we need to do is go and configure the header image option to provide us with a header image that is the correct size for what we want. This is done under the Include folder in the custom header template. Here, you'll remember that if we scroll down, we'll find the section that says add_theme_support custom-header, and this is where we set up the custom header feature for our theme. The variables here allow us to set a default image, so if you want an image to always appear, if no image has been defined, then you can put the URL to that image in here.

I'm going to leave that blank. In the previous movie, we also set the default text color. So now we want to set the width, height and also whether or not the image can be of flexible height in the settings. So I've done some calculations, and tested with my design, and I've decided on a width of 280 pixels and a height of 300. And for this particular theme, I want to set flex height to false. That's because flex height allows you to upload an image, and then change the height of that image.

So you can imagine if you upload a very large image, then all the content on the page would be pushed down. So if you upload a very, very large image you would never see the content. You would just see the image. So I want to restrict the image height to 300 pixels. I'm going to set flex height defaults. Now I'll save the custom header file because I need to save my settings and then I need to add in the code that will display the actual header image in my header. So, of course, first I need to go and grab header.php. And find where I want to display the header image.

And the standard placement of the header image is usually above the site branding, so I'm going to make some space here, then I need to add in the actual code that will display the header image. And fortunately for us, that code has already been prepared for us by the people who created underscores. If you scroll all the way to the top of custom-header.php, you'll find the section that says you can add an optional customer header image to header.php like so and that it has some code. So all we need to do is copy out the code.

Paste it in, and I'll do some cleanup here by tabbing it in. And now you've added a conditional statement that says if there is a header image then set up a link that points to the whole URL and then display the header image. That means if we upload a header image to our site now, the header image will display. And if you click on the header image you're taken to the front page of the site. So, that's exactly the kind of behavior you want from a header image. Now I'm going to save header.php, go back to my site and reload the front page.

And nothing happens, that's because we currently don't have a header image. So, now we need to go to the back end. So I'll go to the WordPress toolbar and select Header. You can also go to the Dashboard and go to Appearance, and Header. And from here, I'm going to choose a file. And you see that right now, WordPress is asking for an image that is 1280 by 300. So I'll choose a file. And this is a much bigger image. So I'll upload a very large image. And because we specified a specific size, WordPress will now help us crop the image to that size.

So here I'm going to pull the crop down. To here, and then click Crop and Publish. And WordPress now creates a new image for us that is the correct size and I can save these changes and jump to the front page. And now we have a header image, at the very top. And if you click on the header image you go to the front page of the site. Now that we've added a new element to our template, we also need to style that element. because you'll notice right now, the header image is not floating center. It's off to the left hand side and it also has that pesky extra space on the bottom that all images have when you just add them in to the content.

So I'm going to go to my header.php file and then, inside my conditional statement, I'm going to add a new divider. And I'll give it the class, header-image. And then I'm going to shift in the anchor here, and I'm going to close my divider. And that way I can go to my CSS file, style.css, navigate to X.X, which is where we put the header. And here at the very top I'm going to add in a new class called header-image, and then I'll only target the image inside.

And here I'll set the display to block so that the padding on the bottom disappears. And I'll set margin to zero. So, no margin at the top or bottom and auto, so that it centers itself. I'll save style.css, reload my page, and now my header image is in the middle and there is no border on the bottom.

Show transcript

This video is part of

Expand all | Collapse all
  1. 10m 55s
    1. Welcome
      1m 4s
    2. What to know before you start this course
      2m 40s
    3. How this course and the lesson files work
      3m 12s
    4. Introducing Simone: A preview of the final project
      3m 59s
  2. 21m 28s
    1. Installing and running WordPress on your computer
      3m 53s
    2. Getting and installing Underscores
      4m 11s
    3. Installing WordPress Theme Unit Test data
      4m 18s
    4. Installing the Developer plugin
      2m 58s
    5. Installing and setting up NetBeans or another IDE
      6m 8s
  3. 16m 15s
    1. Designing for mobile, content, and style
      4m 52s
    2. How do WordPress themes work?
      4m 48s
    3. Understanding the WordPress template hierarchy
      2m 19s
    4. Underscores: An overview
      4m 16s
  4. 37m 5s
    1. Setting up style.css
      4m 47s
    2. Configuring baseline settings and functions
      6m 6s
    3. Enabling custom fonts and font icons
      5m 44s
    4. Applying global styles
      5m 11s
    5. Styling basic layout components
      6m 19s
    6. Making the site layout responsive
      8m 58s
  5. 23m 18s
    1. Styling the default header
      6m 25s
    2. Hiding the site title and tagline
      5m 32s
    3. Adding an optional header image function
      5m 23s
    4. Placing the header image behind the site title
      5m 58s
  6. 40m 55s
    1. Setting up menus
      3m 12s
    2. Styling the menu
      7m 42s
    3. Using Superfish for accessible menus
      8m 0s
    4. Making the menu responsive
      7m 3s
    5. Creating a custom social media menu
      5m 51s
    6. Styling the menu with icons from Font Awesome
      9m 7s
  7. 18m 9s
    1. Adding the search form
      6m 27s
    2. Adding the search icon
      6m 55s
    3. Adding show/hide functionality to the search form with jQuery
      4m 47s
  8. 33m 20s
    1. Adding a widgetized area to the footer
      7m 10s
    2. Using the Monster widget plugin to test all widgets
      2m 11s
    3. Styling the footer
      3m 6s
    4. General widget styling
      5m 33s
    5. Adding custom styles to specific widgets
      7m 34s
    6. Using Masonry to make footer widgets responsive
      7m 46s
  9. 54m 49s
    1. Changing the Single Post Template content structure
      5m 54s
    2. Changing the output of meta elements
      7m 2s
    3. Styling the Single Post Template
      7m 57s
    4. Making post meta responsive
      6m 21s
    5. Styling blockquotes
      5m 39s
    6. Creating pull quotes and pull images
      5m 1s
    7. Working with image captions
      4m 27s
    8. Working with image galleries
      4m 57s
    9. Single-post navigation
      7m 31s
  10. 30m 23s
    1. Working with the comments template
      8m 42s
    2. Using Gravatars in comments
      2m 42s
    3. Styling comments
      7m 26s
    4. Highlighting post author comments
      3m 36s
    5. Styling the comment form and messages
      7m 57s
  11. 18m 43s
    1. How do featured images (post thumbnails) work?
      2m 57s
    2. Defining featured image sizes
      3m 30s
    3. Generating new featured images with a plugin
      1m 46s
    4. Adding featured images to a template
      5m 7s
    5. Styling the featured image
      5m 23s
  12. 1h 2m
    1. The index template hierarchy
      2m 21s
    2. Customizing and styling index templates
      10m 10s
    3. Displaying excerpts or full content on index pages
      3m 6s
    4. Adding a custom Read More link
      3m 48s
    5. Adding featured images
      4m 0s
    6. Creating custom pagination navigation
      6m 4s
    7. Highlighting Sticky Posts
      2m 55s
    8. Creating custom post format templates
      5m 30s
    9. Highlighting the most recent post in the index template
      7m 22s
    10. Embracing modular design
      2m 29s
    11. Working with archive.php
      5m 54s
    12. Customizing the search results and the 404 template
      8m 28s
  13. 9m 7s
    1. Styling pages
      3m 4s
    2. Creating custom page templates
      6m 3s
  14. 4m 30s
    1. Adding editor styles to match front-end styles
      4m 30s
  15. 2m 20s
    1. Further learning
      2m 20s

Start learning today

Get unlimited access to all courses for just $25/month.

Become a member
Sometimes @lynda teaches me how to use a program and sometimes Lynda.com changes my life forever. @JosefShutter
@lynda lynda.com is an absolute life saver when it comes to learning todays software. Definitely recommend it! #higherlearning @Michael_Caraway
@lynda The best thing online! Your database of courses is great! To the mark and very helpful. Thanks! @ru22more
Got to create something yesterday I never thought I could do. #thanks @lynda @Ngventurella
I really do love @lynda as a learning platform. Never stop learning and developing, it’s probably our greatest gift as a species! @soundslikedavid
@lynda just subscribed to lynda.com all I can say its brilliant join now trust me @ButchSamurai
@lynda is an awesome resource. The membership is priceless if you take advantage of it. @diabetic_techie
One of the best decision I made this year. Buy a 1yr subscription to @lynda @cybercaptive
guys lynda.com (@lynda) is the best. So far I’ve learned Java, principles of OO programming, and now learning about MS project @lucasmitchell
Signed back up to @lynda dot com. I’ve missed it!! Proper geeking out right now! #timetolearn #geek @JayGodbold
Share a link to this course

What are exercise files?

Exercise files are the same files the author uses in the course. Save time by downloading the author's files instead of setting up your own files, and learn by following along with the instructor.

Can I take this course without the exercise files?

Yes! If you decide you would like the exercise files later, you can upgrade to a premium account any time.

Become a member Download sample files See plans and pricing

Please wait... please wait ...
Upgrade to get access to exercise files.

Exercise files video

How to use exercise files.

Learn by watching, listening, and doing, Exercise files are the same files the author uses in the course, so you can download them and follow along Premium memberships include access to all exercise files in the library.

Exercise files

Exercise files video

How to use exercise files.

For additional information on downloading and using exercise files, watch our instructional video or read the instructions in the FAQ .

This course includes free exercise files, so you can practice while you watch the course. To access all the exercise files in our library, become a Premium Member.

Are you sure you want to mark all the videos in this course as unwatched?

This will not affect your course history, your reports, or your certificates of completion for this course.

Mark all as unwatched Cancel


You have completed WordPress: Building Themes from Scratch Using Underscores.

Return to your organization's learning portal to continue training, or close this page.

Become a member to add this course to a playlist

Join today and get unlimited access to the entire library of video courses—and create as many playlists as you like.

Get started

Already a member ?

Become a member to like this course.

Join today and get unlimited access to the entire library of video courses.

Get started

Already a member?

Exercise files

Learn by watching, listening, and doing! Exercise files are the same files the author uses in the course, so you can download them and follow along. Exercise files are available with all Premium memberships. Learn more

Get started

Already a Premium member?

Exercise files video

How to use exercise files.

Ask a question

Thanks for contacting us.
You’ll hear from our Customer Service team within 24 hours.

Please enter the text shown below:

The classic layout automatically defaults to the latest Flash Player.

To choose a different player, hold the cursor over your name at the top right of any lynda.com page and choose Site preferences from the dropdown menu.

Continue to classic layout Stay on new layout
Exercise files

Access exercise files from a button right under the course name.

Mark videos as unwatched

Remove icons showing you already watched videos if you want to start over.

Control your viewing experience

Make the video wide, narrow, full-screen, or pop the player out of the page into its own window.

Interactive transcripts

Click on text in the transcript to jump to that spot in the video. As the video plays, the relevant spot in the transcript will be highlighted.

Learn more, save more. Upgrade today!

Get our Annual Premium Membership at our best savings yet.

Upgrade to our Annual Premium Membership today and get even more value from your lynda.com subscription:

“In a way, I feel like you are rooting for me. Like you are really invested in my experience, and want me to get as much out of these courses as possible this is the best place to start on your journey to learning new material.”— Nadine H.

Thanks for signing up.

We’ll send you a confirmation email shortly.

Sign up and receive emails about lynda.com and our online training library:

Here’s our privacy policy with more details about how we handle your information.

Keep up with news, tips, and latest courses with emails from lynda.com.

Sign up and receive emails about lynda.com and our online training library:

Here’s our privacy policy with more details about how we handle your information.

submit Lightbox submit clicked
Terms and conditions of use

We've updated our terms and conditions (now called terms of service).Go
Review and accept our updated terms of service.