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

Changing the Single Post Template content structure

From: WordPress: Building Themes from Scratch Using Underscores

Video: Changing the Single Post Template content structure

With the framework of our theme, the header, the sidebar, and This is another example of these dry development principles.

Changing the Single Post Template content structure

With the framework of our theme, the header, the sidebar, and the footer, complete, it's time to start focusing on the main content. And here you can start in many different places. Personally, I like to start with the single post template and work my way through it from top all the way to the bottom and set up all the content and style it, and then move on to the index templates. That way, I can use the mark up and the styling from the single post templates in my index templates and I don't have to write as much code. This is another example of these dry development principles.

If I go back and look at my designs, you'll see my single post starts out with a comma separated list of the categories at the top. Then the title then the post met out which says written by and then the author name, the date, and the comment. And on wide screens it's shifted to the left and on smaller screens is displaying below the title. Then we have the main content itself and then at the bottom we have a list of tags with tag icons next to each of the tags. When I look at the output of the single pulse in WordPress, I see that the underscore's template is currently outputting the content in a different way from what I want.

You'll see it starts with a title. Then we have the pulse meta, but it's formatted differently. Then we have the Content. And then here at the bottom we have a footer section that has the category list, a tag list, and also a link to the permalink and the Edit button. So what I need to do now is go and reorganize all this content so that it stacks in the right order in the markup before I can start applying styles to it. Earlier in the course, I explained how the WordPress template hierarchy works. And you may remember that the single post template is managed by single.php.

If I go to single.php, I see that single.php is actually just a scaffolding for the single post. It sets up my header. It sets up the primary area, which is where my content is going to display. Then it has a loop and within the loop, it first calls a template part called content single and this is where all the content is. Then it displays a post navigation which navigates us to the previous or next post. Then it displays the comments and finally displays the side bar and the footer. So if I want to edit the actual content I need to go to content-single.php.

So I'm going to open that template instead. And here you see the content displayed. Here we start with a title, then we have the meta contents, then we have the content itself, and then we have the footer which displays the category list in a coma separated list, the tag list in a coma separated list, and then it wraps this in some text so that it displays nicely. What I could do now is take the existing elements here and reorganize them in this template so that they display the way I want. So I'm going to start by taking the category list, which is already a comma separated list, which you can see here.

So this variable here defines the separator as a comma. And I'm going to move this up to the entry header section. See here I'm going to make some space and then of course I can go down here and copy out the code, but I also need to make a bunch of changes to it. So instead, I've prepared a code snippet for you. So if you go to the cold snippets, you'll see in the top here we have a code snippet that outputs the categories. So I'll paste that code snippet in. And you'll see that this works the same way as the cold snippet below. So here we have a variable cold category list defined so this is a WordPress function that gets the category list.

It's comma separated and then what I do is I run another function that comes with underscores that's called categorized blog. Which basically tests whether or not there is more than one category. Because if there's only one category in the whole blog, then there's no point in showing a list of categories. So this test to see if there's more than one category, then display the following. And then I take the category list that I got up here and I display it within a divider. That has the class category list. That way the category list will display at the top and then we get the title.

I'm going to leave the post meta for a later movie, so for now, I'm going to change the display at the bottom here to only display the tags because right now you see it displays the categories and the tags and a bunch of other stuff. So I'm going to take out all of this. So that all that's left inside the footer is this edit post link. Then I'll go back to my code snippets, and I'll copy out this single line of code here and paste it in instead. And what happens here is I'm using the same function as I did before. Although this time I'm saying instead of getting the category list get the tag list.

Then I'm using the mark up as follows. The first variable sets the first tag that you display. So it's an unordered list. With a list item, and within that list item, I'm displaying the tag icon that I got from Font Awesome. Then, in between each list item, I close one list item and start a new one, and then again insert the Font Awesome icon. And then at the very end I close the last list item and close the unordered list. So this code will output and unordered list of tags with the tag icon from font awesome displaying next to it.

Now I can save my new content single template and go and reload my page. And now we start the page with a list of categories, then the title, and the post meta. Then the content itself, and then we end with and an un-ordered list of each of the tags, and the edit button. So now the overall structure of my content matches what I have in my design. Next I need to change the output of this function that creates the post meta.

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 preferencesfrom 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.

Are you sure you want to delete this note?


Your file was successfully uploaded.

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.