Download the PHP package wp-forge/wp-loop without Composer
On this page you can find all versions of the php package wp-forge/wp-loop. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download wp-forge/wp-loop
More information about wp-forge/wp-loop
Files in wp-forge/wp-loop
Package wp-loop
Short Description A generator function that makes working with the WordPress loop a dream.
License GPL-2.0-or-later
Informations about the package wp-loop
WordPress Loop
A generator function that makes working with the WordPress loop a dream.
When will this land in WordPress core?
At the moment, that is unclear. However, you can follow the progress of this trac ticket.
Installation
- Run
composer require wp-forge/wp-loop
- Make sure you require the
vendor/autoload.php
file in your project.
Usage
Here are a few examples of how to use the wp_loop()
function:
With the Global WP_Query
Instance
With a Custom WP_Query
Instance
There is no need to run wp_reset_postdata()
after the loop. It is taken care of automatically, even if you break out of the loop early!
With an Array of WP_Post
Objects
With an Array of Post IDs
With an Iterator
Other Notes
The wp_loop()
function is meant to be used in a foreach
loop. If you need to check if there are results before looping, you can do that the way you normally would.
For example:
The wp_loop()
function goes one step further than the standard WordPress loop does and automatically sets and restores the global $post
object for each iteration.
For more details, read this blog post on Creating a Better WordPress Loop. The current implementation is a bit different, but the reasoning is laid out quite well.