Since: 2.0
display
Return the output for a field. If you want the raw value for use in PHP for custom manipulation, you will want to use field() instead. This function will automatically convert arrays into a list of text such as “Rick, John, and Gary”
Function Definition
Parameters
Parameter | Type | Details |
---|---|---|
$name | (string|array) | The field name, or an associative array of parameters |
$single | (boolean) | (optional) For tableless fields, to return an array or the first |
Additional Parameter Options
Returns
(string|null|false) The output from the field, null if the field doesn't exist, false if no value returned for tableless fields
Examples
Example 1
<?php
// We have a "books" Pod with "category" and "the_author"
// as single-select relationship fields, related to
// "categories" and "authors" Pods
$params = array(
'where' => 't.name LIKE "%rings%"',
'limit' => -1 // Return all rows
);
// Create and find in one shot
$books = pods( 'books', $params );
if ( 0 < $books->total() ) {
while ( $books->fetch() ) {
?>
<h2><?php echo $books->display( 'name' ); ?></h2>
<p>Author: <?php echo $books->display( 'the_author' ); ?></p>
<br />
<p>Category: <?php echo $books->display( 'category' ); ?></p>
<br />
<?php
} // end of books loop
} // end of found books
The above example will output:
<h2>The Lord of the Rings</h2>
<p>Author: J. R. R. Tolkien</p>
<br />
<p>Category: Fiction</p>
<br />