Fetch an item from a Pod. If $id is null, it will return the next item in the list after running find(). You can rewind the list back to the start by using reset(). Providing an $id will fetch a specific item from a Pod, much like a call to pods(), and can handle either an id or slug.
Function Definition
public function fetch ( $id = null )
Source File: /pods/classes/Pods.php
Since: 2.0
Parameters
PARAMETER | TYPE | DETAILS |
---|---|---|
$id | (int) | ID or slug of the item to fetch |
Returns
(array) An array of fields from the row
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 />
Example 2
<?php // Fetch one specific item by ID, fetch() will return non-empty if it's found. if ( $pod->fetch( 123 ) ) { // We found a my_pod item with the ID 123. } // Fetch one specific item by slug, fetch() will return non-empty if it's found. if ( $pod->fetch( 'my-slug' ) ) { // We found a my_pod item with the slug 'my-slug'. }