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.160

Twitter updates

  • ProcessWire 3.0.161 adds support for selector operator stacking, enabling you automatically broaden searches in a single pages.find() call— More
    26 June 2020
  • ProcessWire 3.0.160 adds powerful new text-searching operators, bringing a new level of power to page-finding API calls, especially when it comes to search engine type queries. Post also includes a demo search engine where you can test it all out live— More
    19 June 2020
  • Preview of ProcessWire 3.0.160 with auto-enable of two-factor authentication, new version of TfaEmail and TfaTotp, and new selector operators coming next week. More
    12 June 2020

Latest news

  • ProcessWire Weekly #320
    In the 320th issue of ProcessWire Weekly we're going to check out the latest core updates (ProcessWire 3.0.161), a new third party module called Fieldtype Runtime only, an IndieWeb themed article from Francesco Schwarz, and more. Read on!
    Weekly.pw / 27 June 2020
  • Powerful new text-searching abilities in 3.0.160
    In ProcessWire 3.0.160 we’ve got some major upgrades and additions to our text-search abilities. This brings a whole new level of power to $pages->find() and similar API calls, especially when it comes to search engine type queries.
    Blog / 19 June 2020
  • Subscribe to weekly ProcessWire news

“Indeed, if ProcessWire can be considered as a CMS in its own right, it also offers all the advantages of a CMF (Content Management Framework). Unlike other solutions, the programmer is not forced to follow the proposed model and can integrate his/her ways of doing things.” —Guy Verville, Spiria Digital Inc.