Part Layout Item – PageCells Responsive Framework

The part is a multi-purpose layout item that has many variations. It represents an individual function that generates a specific piece of the WordPress content that can be further customized using the Configuration Options described below. Most of the time the defaults are all that are needed but PageCells gives you the ability to make low-level changes that would normally require custom PHP code.

Adding Parts

From the Layout Items panel on the top right of the Theme Options page, drag the Part Icon over to the Row, Container or Loop Drop Zone where you want it to appear.

Positioning Parts

Once a Part is added to a section, you can drag the Part to change its position on the Theme Options page. Parts can be dragged across sections or simply repositioned in the same section.

Deleting Parts

Click the red Trash Can Icon on the right side of the Part to delete it. An alert will appear to confirm that is really what you want to do.

Part CSS

Unlike the other Layout Items, Parts do not have their own CSS attributes. If you need apply CSS classes to an individual part, create a Container Layout Item, drag the Part into the Container, and apply the styles to that Container.

Individual elements that are rendered by the Part may have CSS classes associated with them that can be customized using the Child Theme Configurator.

Part Options

Click the blue Wrench Icon next to the Part Name to open the Part Options panel.

Part Type

Each part contains a select menu that lets you choose the specific function you want the Part to perform. Once a Part Type is selected, the configuration options change to specific controls for that Part Type.

Custom

The Custom Part Type lets you either include an existing Template Part or enter Raw HTML.

Template Part

If you want the part to include a specific Template Part enter it here without the .php extension.

Raw HTML

Enter HTML code to be displayed in the Part’s location on the page.

PageCells can automatically generate a list of links following the hierarchy of the current Page, Post or Archive being displayed. The output can be further customized using the controls below.

Delimiter

Enter the character that separates each of the “breadcrumbs.”

Before Current

Enter the HTML displayed before the last “breadcrumb” in the list.

After Current

Enter the HTML displayed after the last “breadcrumb” in the list.

If you want a link to the Home Page to appear on all Breadcrumb lists, enable this option.

For Pages content that is divided across multiple pages, this label appears at the end of the list.

Archive Title

You can customize the title that appears when WordPress displays content from a list of Posts. Each Default Template can have a different version of the title.

Search Text

This title appears on search results.

Tag Text

this title appears on lists of Posts for a given Post Tag.

Category Text

This title appears on lists of Posts for a given Category.

Author Text

This title appears on lists of Posts for a given Author.

Day Text

This title appears on lists of Posts for a given Day.

Month Text

This title appears on lists of Posts for a given Month.

Year Text

This title appears on lists of Posts for a given Year.

Default Text

This title appears on lists of Posts when none of the other titles is appropriate for the request.

Code Before

Enter the HTML to appear before the Archive Title, typically a headline tag (e.g., <h2>).

Code After

Enter the HTML to appear after the Archive Title, typically a headline closing tag (e.g., </h2>).

Post Title

This part displays the Post Title wrapped in the HTML you specify.

Before Title (single)

Enter the HTML to appear before the Post Title on singular templates, typically a headline tag (e.g., <h2>).

After Title (single)

Enter the HTML to appear after the Post Title on singular templates, typically a headline closing tag (e.g., </h2>).

Before Title (archive)

Enter the HTML to appear before the Post Title on archive templates, typically a headline tag (e.g., <h2>).

After Title (archive)

Enter the HTML to appear after the Post Title on archive templates, typically a headline closing tag (e.g., </h2>).

Site Title

This Part displays the title specified under Settings > General in the WordPress admin.

If you want the Site Title to link to the Home Page, enable this option.

Before Title

Enter the HTML to appear before the Site Title, typically a headline tag (e.g., <h2>).

After Title

Enter the HTML to appear after the Site Title, typically a headline closing tag (e.g., </h2>).

Archive Navigation

This option determines how WordPress will apply paging when there is a large number of Posts returned for an archive.
Page Links
Displays numbered links to each page of Posts.
Prev/Next
Displays links to the previous and next pages of Posts in the order they were sorted (date by default).

Previous Text

Enter the text to display for the link to the previous page of Posts.

Next Text

Enter the text to display for the link to the next page of Posts.

Archive Description

For Author, Category, Tag and other Taxonomy archives, this Part displays the description content corresponding to the term or user if it exists. In the case of Author archives, you can further customize the output using the next two options.

Author Title

Enter custom HTML used to render the Author Title using printf format. The %s token is a placeholder for the Author’s display name as configured under the User profile in the WordPress admin.

Avatar Size

Enter the width of the Avatar image, in pixels. If Avatars are not being used, this value is ignored.

This Part displays links to any Taxonomies (i.e., Categories, Tags, etc.) associated with the current Post.

Taxonomies

Select the taxonomies you want the Part to display, if they exist.

  • Categories
  • Tags
  • Any Taxonomy
Label text

Text to display before the list, e.g. “Posted in:”

Show taxonomy name

If you want to display the Taxonomy Name before each group of links, enable this option.

This Part displays links for Posts that are separated into multiple pages using the <!--nextpage--> Quicktag.

Next or Number

You can choose to show a list of numbers to link to all sub-pages or just links to the previous and next sub-page.
Number
If you want to display page numbers, enable this option.
Next
If you want to display previous and next links, enable this option.

Previous Text

Enter the text to display for the link to the previous sub-page.

Next Text

Enter the text to display for the link to the next sub-page.

Code Before

Enter the HTML to appear before all the page links.

Before Text

Enter the text to display before all the page links.

Code After

Enter the HTML to appear after all the page links.

Enter the HTML to appear before each sub-page link.

Enter the HTML to appear after each sub-page link.

You can display links to the previous and next Post in the order they are sorted (date by default).

Previous Text

Enter the text to display for the link to the previous Post.

Next Text

Enter the text to display for the link to the next Post.

Post Meta

This Part displays byline information about a Post based on the options below.

Format

This option contains tokens that determine the byline information and the order it is displayed. To display the Post Date with a link to other Posts on that date, enter %%date%%. To display the Author with a link to other Posts by that Author, enter %%author%%. The default format is %%date%% %%author%%

Date Label

Enter the text to display before the Date, e.g., “Posted on”

Author Label

Enter the text to display before the Author, e.g., “by”

Author Title

Enter the content of the Author link title (visible when hovering over the link), e.g., “View all posts by”

If you want to display a link to the current Post’s Comments, enable this option.

Content

This Part displays the main content of the current Post.

More Text

Enter the text for the “More” link when the Post is truncated (if necessary).

Stop at more tag

If you want WordPress to truncate the Post when it encounters the <!--more--> Quicktag, enable this option.

Excerpt

This Part displays the Post Excerpt if it exists, otherwise it displays the main content up to the first <!--more--> Quicktag it finds. If no <!--more--> exists, it displays the first n words of the main content, where n is the Excerpt Length specified below.

More Text

Enter the text for the “More” link that appears when the Post is longer than the excerpt. The default is “Read More.”

Excerpt Length

Enter the number of words to display from the main Content when no excerpt exists. If no value is entered the default length of 55 is used.

Author Meta

For individual Posts, this Part displays the description content corresponding to the Author’s user profile if it exists. You can further customize the output using the next two options.

Author Title

Enter custom HTML used to render the Author Title using printf format. The %s token is a placeholder for the Author’s display name as configured under the User profile in the WordPress admin.

Avatar Size

Enter the width of the Avatar image, in pixels. If Avatars are not being used, this value is ignored.

Comments

This Part displays the standard WordPress comments template. You can further customize the behavior using the options below.

This option determines how WordPress will apply paging when there is a large number of Comments for a Post.
Page Links
Displays numbered links to each page of Comments.
Prev/Next
Displays links to the previous and next pages of Comments chronologically.

Comment Type

PageCells separates Pings and Comments into separate lists. You can filter comments to show one or both of these lists.
Comments
Only show comments (no pings or trackbacks).
Pings/Trackbacks
Only show pings (no comments)
Both
Show all comments, separated by type.

Show “comments closed” message

If you want to display a message when comments are disabled for a Post, enable this option.

Site Header Image

This Part displays the Custom Header Image uploaded under Appearance > Header. If no image exists, no output is generated.

If you want the header image to link to the Home Page, enable this option.

If the current Post has a Featured Image assigned to it, this Part will display it wherever the Part is located in the layout. If no Featured Image exists for the Post, no output is generated.

Size

Specify the size of the Image most appopriate for the context. To make sure the image fills the space consistently, use the image size that matches the widest width the surrounding container will probabl be.

  • Thumbnail
  • Medium
  • Large
  • Full

Site Tagline

This Part displays the Tagline specified under Settings > General in the WordPress admin.

Before Tagline

Enter the HTML to appear before the Site Tagline, typically a headline tag (e.g., <h2>).

After Tagline

Enter the HTML to appear after the Site Tagline, typically a headline closing tag (e.g., </h2>).

Shortcode

This Part displays the output from any supported shortcode you specify.

Shortcode

Enter the shortcode you wish to include, including the brackets, e.g., [shortcode_name option1="value"]

Data Field

This Part displays a Custom Data Field you specify. If no data exists for the current Post, no output is generated.

Field

This corresponds to the meta_name (field) you wish to display.

Use Content Filter

If you want WordPress to apply the same formatting it uses for the main content, enable this option.

Search Form

This part displays the standard WordPress search form.

Tutorial

In this video we discuss the Part Layout Item, the various parts and their purpose in the overall design using the PageCells Responsive Theme Framework.

Need More Help? Contact Us!

Maintaining our reputation for excellent support is very important to us, so please do not hesitate to ask any question about this or any of our other plugins, large or small. You can also use the Child Theme Configurator Support Forum on WordPress.org. Don't forget to give us 5 stars!