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
public function display ( $name, $single = null )
Source File: /pods/classes/Pods.php
Since: 2.0
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
OPTION | TYPE | DEFAULT | DETAILS |
---|---|---|---|
name | (string) | $name | The field name |
orderby | (string) | null | (optional) For tableless fields, you can choose to return an array of items in a specific order |
single | (bool) | $single | (optional) For tableless fields, to return the whole array or the just the first item |
in_form | (bool) | false | (optional) For internal use. If set to true, always return a full array of data |
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
$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 />