Displaying Pods Custom Settings Pages

Overview

You can access Custom Settings Pages for display in your theme using Pods Templates, WordPress functions or with our Pods Functions Calls.

Using Pods Templates

When you’re using a Pods Template, you’ll reference your fields in your Settings page with the standard magic tags {@field_name}. They work in the same ways as regular Pods Templates, but you won’t be able to use an Auto Template to display them, because there is no such thing as a single detail page for Custom Settings. You’ll either be using Pods Templates to display your Settings fields in a Widget or in WordPress pages using shortcodes.

Using WordPress Functions

Using the get_option function from WordPress, you will access your fields in your Custom Settings Pages created with Pods by combining the name of the Custom Settings Pod with the name of the field you’re trying to return, joining the two with an underscore. In the example below, my_settings is the name of the Custom Settings Pod, and field_from_settings is the custom field in that Pod.

$setting = get_option('my_settings_field_from_settings');

Display Pods Settings Pages using Pods Functions

You can also use the Pods API functions (pods and display) to display your Custom Settings information in a theme file. You can open the standard pods object and then use display to echo the data. In these situations, the loop is not necessary because you’re not accessing a loop; Settings Pages are only one level deep.

$settings = pods('my_settings');
echo $settings->display('field_from_settings');

Other Helpful Documentation on Displaying Pods

Access Rights in Pods

An overview of how Access Rights works in Pods

Displaying Custom Taxonomy Term Meta

To display the custom fields you’ve extended to your Custom Taxonomy, you’ll need to use the function get_term_meta. /* $term_id is the Taxonomy Term 'field_name' is the Custom Taxonomy term */ $field_value = get_term_meta( $term_id, 'field_name', true );` If you’re on a Taxonomy Archive page, you can use $pods = pods(); and Pods will automatically …

Read more

Displaying Pagination

Pagination of a list items is supported by Pods Blocks, Shortcodes, and Widgets.

Image & Media Fields Reference

Shows fields that differ in reference to Image & File Fields

Magic Tags

Show your content and custom fields inside our Pods Templates, like Magic!

Pod Page Template Hierarchy for Themes

Pods supports loading template files directly from the theme for a Pod Page. This requires using the Pod Pages component. ContentsPod Page Templates HierarchyCode referenceExample page URL path: “my/pod-page/*” (Page must be created first)Diagram Pod Page Templates Hierarchy Pod Page Templates can be automatically loaded from the theme when the Page Template dropdown is left …

Read more

Pod Template Hierarchy for Themes

Pods supports loading template files directly from the theme. There are two kinds of templates in Pods: ContentsPod Templates HierarchyExample template: “book-list” (Template must be created first)Plain Templates (Templates component inactive)Diagram Pod Templates Hierarchy Pod Templates can be automatically loaded from the theme when the template code is left empty AND the template name must …

Read more

Pods Blocks

Pods Blocks are available in the Block Editor. They are also available in the Widget Editor (WP 5.8+)

Pods Shortcode

Using our Shortcode to get content on your website is often the easiest method since you can drop these into a page, HTML block or HTML Widget.

Pods Templates

Create re-usable templates of content that you can put anywhere on your website using Pods Blocks, Pods Shortcodes, Pods Widgets, or automatically inserted in your Single & Archive Post Templates using Auto Templates.

Pods Widgets

Pods Widgets allow you to display fields, a single item, a list of items, and embed a form or template view. Pods Blocks are now recommended instead of using our Widgets.

Post Standard Fields Reference

Fields available to Posts, Pages and Custom Post Types (not including post_meta). Media Library is also a Custom Post Type

Taxonomy Fields Reference

Used for Category, Tags and Custom Taxonomy

Template Tags

Special handling for conditional output or looping through relationships, taxonomy or attached media.

User Fields Reference

User Fields available to Magic Tags when Extended and How to get to and access user_meta with PHP Methods.