Scheduled Content

An entry with a post date in the future, or an expiry date, changes the site at that moment without anyone saving anything. Speedy knows when.

While a page is built, Craft notes the soonest moment any element on it goes live or expires. Speedy saves that time with the page, and clears and rebuilds the page when it comes.

For example, /news lists News entries. An entry is scheduled for 9 am tomorrow, so /news is cleared at 9 am and rebuilt with it.

If a visitor arrives in the moment between the page expiring and its rebuild, they get the old copy (X-Speedy: STALE) while the new one is built in the background, so nobody waits. After 10 minutes, an expired page is built fresh instead.

How it’s run

Speedy queues a delayed job for the next moment a page expires. That works with no setup, as long as your queue runs.

For exact timing on busy sites, add the cron command too. It clears whatever has expired, then stops:

* * * * * php /path/to/craft speedy/expire

See Cron and queue.

Time-limited pages

For pages that should be rebuilt on a timer, such as one showing the weather, see Pages with live data.