Pagefiles::getTag() method

Return the first Pagefile that matches the given tag or NULL if no match

Given tag may be any of the following:

  • foo (single tag): Will return the first Pagefile object having the specified tag.
  • foo|bar|baz (multiple OR tags): Will return first Pagefile object having at least one of the tags listed.
  • foo,bar,baz (multiple AND tags): Will return first Pagefile object having ALL of the tags listed (since 3.0.17).
  • ['foo','bar','baz'] (multiple AND tags array): Same as above but can be specified as an array (since 3.0.17).

Usage

$pagefile = $pagefiles->getTag(string $tag);

Arguments

NameType(s)Description
tagstring

Return value

Changelog

  • 3.0.17 Added support for multiple AND tags and allow tag specified as an array.

See Also


Pagefiles methods and properties

API reference based on ProcessWire core version 3.0.244

Latest news

  • ProcessWire Weekly #558
    In the 558th issue of ProcessWire Weekly we'll check out the blog post that introduces ProcessWire 3.0.244, share some recent ProcessWire highlights, and more. Read on!
    Weekly.pw / 18 January 2025
  • ProcessWire 3.0.244 new main/master version
    ProcessWire 3.0.244 is our newest main/master/stable version. It's been more than a year in the making and is packed with tons of new features, issue fixes, optimizations and more. This post covers all the details.
    Blog / 18 January 2025
  • Subscribe to weekly ProcessWire news

I just love the easy and intuitive ProcessWire API. ProcessWire rocks!” —Jens Martsch, Web developer