Singular layout type (Themer)
The Singular theme layout is a type of content layout in Theme Builder that can be applied to single posts and pages.
Special behavior of the Singular theme layout
The Singular layout behaves differently from the other templates because it is the only layout that touches the content area of the page.
Here are the special properties of the Singular theme layout:
- It can apply to single Posts or Pages, but it works best with Posts or custom post types.
- It applies to the part of the page between the header and footer. The header and footer will either come from the theme or from a Header or Footer theme layout.
- It can display metadata about the post: title, author, date, category, comments, post navigation, featured image, plus one area for the post content.
- The content area of a post is the only part of the theme layout that can be edited in individual Posts or Pages, and that content must be edited in the native WordPress text editor, not Page Builder.
- There can only be one Post content for a post or page. If you include more than one Post Content module in a theme layout, the content from the post or page will repeat in both instances.
If you'd like a short refresher on the WordPress content area and parts of the page under theme control, see the primer in the Related Article below.
Singular layout template
The best way to illustrate these points is by showing a screenshot of the initial layout that you see when you create a Singular layout. It contains most of the post information and post content that you'd want for a single Post. This initial layout makes it quick and easy to move the modules around or delete them to display what you want and where you want it.
- It's easier to design a Singular layout if you already have a Post or a test Posts created. You can preview that post as you work and see the information that will appear from each post.
- If you ever want to revert to this default layout, click the Templates button when you're editing the theme layout in Page Builder.
Initial layout: under the hood
The Singular initial layout has most of the modules you'd use to lay out a single post page, specifically:
- Two rows, one for the post title area with an image, the other for the rest of the content on the page.
- For the post title row, there's a background photo set to the Featured Image field connection, as shown in the following screenshot. There's also a dark row overlay set to 50% opacity. Text color is set to white.
- The post title is placed in a Heading module, with the Post Title field connection in the Heading field.
- The Post Info module displays date, author name, number of comments, and terms (categories or tags), in that order. You can display all, some, or none of these four types of information. To change the order you can line up a series of Post Info modules, each of which contains only one info type. Or, you can just use code to do that.
- The Post Content module is the content that you'd write into the WordPress text editor, and in fact that's just how you'll add the Post content to individual Posts controlled by this layout.
Note: You can't use Page Builder within the Post Content area because it breaks the theme layout. You'll use the native WordPress text editor, where you can add text, images, shortcodes, and some code.
- The HTML module contains code to display the Post categories.
- The Author Bio module
- The Post Navigation module displays the previous and next posts.
- The Comments module displays the standard information about Post comments. You cannot configure which information is displayed. You can only configure what's typically on the Advanced tab of a module: margins, responsive display conditions, visibility, animation, and custom ID or class names.
The same layout appears if you assign the template to Pages rather than Posts, and the Post modules and field connections don't work for Pages, so you'll have to delete all of those and create your own layout for Pages. However, the Singular theme layout applied to Pages has limited flexibility, in that there can only be one content area, in which you enter content in a single area using the WordPress editor.
Special Post Modules category for the Singular theme layout
When you edit the Singular theme layout in Page Builder there's a special content category called Posts modules. Most of these modules are used in the initial layout for the Singular theme.
See the Related Articles for a description of each of these modules.