Page Display Configuration

To configure what is displayed on a particular WordPress template, use the Page Display sub-menu for the type of page that you want to setup.

The Page Display sub-menu is used to:

• Choose which WordPress header and footer you want to be used for the template in question.
• Set values for the following Page Level items and specify whether or not they should be shown:
  1. The Kicker
  2. The Headline / Title
  3. The Byline
  4. The Subtitle
  5. The Summary
  6. The Above Posts Content Area
  7. The Post List Area
  8. The Below Posts Content Area
  9. The Footer
• Choose which tags will be used for any Title, Subtitle, and/or Summary that is displayed
• Choose where the Subtitle and/or Summary will be displayed
• Set the maximum number of posts to display
• Note whether you want full posts (or teasers if you are using the <!–more–> tag), excerpts, or summaries to be displayed in the post list area.
• Specify an initial number of posts that you want to be displayed in their entirety, even if you are making good use of the <!–more> tag.

---

Page Variables

When building the below sections, many of them allow the use of Page Level Variables, which are tags you can place into them to have The Privateer replace the tags with specific values dynamically.

The following variables are currently usable by page level fields:

1. %blog_name%
   • This will be replaced with the name of your blog
2. %blog_desc%
   • This will be replaced with your blog tagline.
3. %blog_link%
   • This will be replaced with your blog title as a link to your blogs homepage.
4. %post_title%
   • This will be replaced with the title of the current page or post
   • This should only be used on Single Page and Single Post templates.
5. %post_subtitle%
   • This will be replaced with the current page or posts subtitle, if any is specified.
   • This should only be used on Single Page and Single Post templates
6. %page_title%
   • This will be replaced with the current wordpress post or page title on the single post and single page templates OR the currently specified page title on other page templates.
7. %page_subtitle%
   • This will be replaced with the current wordpress post or page subtitle on the single post and single page templates OR the currently specified page subtitle on other page templates.
8. %author_name%
   • This will be replaced with the author name for items in question.
   • This only works on Single Post, Single Page, and Author Archive templates.
9. %category_name%
   • This will be replaced with the name of the category for items in question.
   • This only works on the Single Post and Category Archive templates.
10. %category_desc%
    • This will be replaced with the category description
    • This only works on the Single Post and Category Archive templates.
11. %tag_name%
    • This will be replaced by the tag name
    • Only works on Single Post and Tag Archive templates
12. %tag_desc%
    • This will be replaced by the tag description
    • Only works on Single Post and Tag Archive templates
13. %search_terms%
    • This will be replaced by the users search words
    • Only works on the Search Page template.
14. %day%
    • This will be replaced by the day
    • Only works on date archive templates when results are limited to a particular date.
15. %month%
    • This will be replaced by the month
    • Only works on date archive templates when results are limited to a particular month.
16. %year%
    • This will be replaced by the year
    • Only works on year archive templates when results are limited to a particular year.
17. %archive_type%
    • This will be replaced by the type of archive being viewed.
    • Only works on archive templates (date, tag, author, category)
    • Returns Tag, Category, Date, or Author
18. %post_summary%
    • This is replaced by the currently set wordpress post or page summary, if any is specified or the excerpt if none is set.
    • Works only on the Single Page and Single Post templates.
19. %post_excerpt%
    • This is replaced by the current wordpress post or page objects excerpt.
    • Works only on the Single Page and Single Post templates.

---

The WordPress Header

Here you can choose which WordPress header template you want to be displayed for the current template type.

The items in this list are populated by scanning the theme directory for header-X.php files, which can be used as alternatives to the header.php file.

If, instead of customizing your header.php file to make tweaks, you copy it, change the name to header-something.php, and then select that header in your templates, you should not have to worry about your customizations being overridden when installing theme updates.

---

The Page Kicker

In The Privateer, each page template type can have a custom kicker set, which is displayed above the page title.

Creating a Page Kicker

• Enter the text you want to use for the kicker.
• Use any Page Level Variables ( see above ) as wanted.

Displaying the Kicker

• Create a kicker.
• Ensure that the check box to the left of the kicker is checked.

---

The Page Title

Here you can set a custom page level title and choose what kind of html tag you want to display the page title as.

Creating a Page Title

• Enter the title you want to be displayed.
• Use any Page Level Variables (see above) as wanted.

Displaying the Page Title

• Select the HTML Tag that you want the page title to be displayed in.
• Make sure the check box to the left is checked.

---

The Page Subtitle

Here you can setup a subtitle for the page template.

Setting up the subtitle text.

• Enter the text you want to use in the box provided.
• Specify the tag that you want to have the subtitle wrapped in.
• Use any Page Level Variables (see above) as wanted.

Showing or Hiding the Subtitle

For a subtitle to be displayed:

1. The subtitle must not be empty
2. You must have the Put Subtitle In entry set to something other than None

---

The Page Summary

If you want a page level summary placed on the template, you can set one with the above displayed options.

Creating a Summary

• Enter the text you want shown as the summary.
• Use any Page Level Variables (see above) as wanted.

Displaying the Summary

• Make sure to create a summary
• Make sure that you have a tag set to display the summary in.
• Set Show Summary In to something other than None.

---

The Page Byline

You can create a byline by using the above displayed options.

The Byline is shown beneath the Page Title.

Creating a Byline

• Enter the text you want for the byline in the box shown.
• Use any variables displayed above, as needed.

Displaying the Byline

• Create a Byline
• Make sure that the check box next to it is checked.

---

The Above Posts Content Area

You can place extra content above the post list on the page by using the above options.

Creating the Above Post Content

• Enter the html and/or javascript that you want to use into the box displayed.
• You can use custom tags from plugins which make use of content filters ( e.g. <!–tag-name–> ), but normal php will not work here.

Displaying the Above Post Content

• Create the Above Post Content.
• Make sure that the check box next to it is checked.

---

The Post Listing Area

You can use this to decide whether or not posts should be displayed on the template.

Primarily, this is for temporarily disabling posts on a particular template, but might be of use if you are wanting to use an external tool to display content.

For example, if you want to use google adword search to display content within your page, you might place the code for it within the Above Post Content Area or Below Post Content Area and turn posts off here.

---

The Below Posts Content Area

You can use the above displayed settings to add extra content underneath the post listing area of the template.

This can be handy for displaying banners, widgets, etc.

Creating the Below Posts Content

• Enter the html and/or javascript that you want displayed beneath the post list.
• You can use WordPress plugin tags ( e.g. <!–tagname–> ), but php itself will not work here.

Displaying the Below Post Content Area

• Setup the content to be displayed
• Make sure that the check box next to it is checked.

---

The Page Footer

You can place a Footer at the very bottom of your pages using the above options.

Creating a Footer

• Enter the information you want displayed in your footer into the box shown above.
• Use any of the Page Level Variables displayed higher up, as wanted.

Displaying the Footer

• Create the footer.
• Make sure that the check box to the left of it is checked.

---

The WordPress Footer Selector

Here you can specify an alternative wordpress footer to display for the template.

In WordPress, footer.php is used by default, but you can use alternatives by creating footer-somename.php files in this themes root directory ( /wp-content/themes/privateer ).

In The Privateer, the footer handles the left sidebar area and the page footer.

If you want to customize the footer.php file, you might consider copying it, renaming it to something ( perhaps footer-custom.php ), and then selecting it on the template pages that you want to use it on. By doing so you can avoid accidentally overwriting your customizations if you update the theme.

---

The Post Display Settings

The post display settings are used to configure how posts are to be displayed in the post list area.

Max Posts To Show

This is used to specify the maximum number of posts you want displayed.

If you set this to zero, 100 will be assumed to ensure that the full number of posts you have set within wordpress will be shown.

Show Type

This determines how posts on the template will be shown.

Currently available options include:

• Full Posts
  • Displays the entire post or page object, or, if a <!–more–> tag was used within the post or page, displays only the portion before it.
• Excerpts
  • Displays the excerpt, which consists of the first so many characters of the post without any html.
• Summary
  • Displays any hand crafted summary you have made for the post or page object.
  • If no summary is set, this will display the excerpt instead.

Show First X Posts as Full Posts

This will display the initial number of posts specified completely, without paying any attention to the <!–more–> tag.

Set this equal to the number of posts to be displayed to make all posts shown be shown fully.

Set this to zero to have force the template to display all wordpress post or page objects as specified above.