Pagefile::hasTag() method

Does this file have the given tag(s)?

Example

$file = $page->files->first();

if($file->hasTag('foobar')) {
  // file has the "foobar" tag
}

if($file->hasTag("foo|baz")) {
  // file has either the foo OR baz tag
}

if($file->hasTag("foo,baz")) {
 // file has both the foo AND baz tags (since 3.0.17)
}

Usage

$bool = $pagefile->hasTag(string $tag);

Arguments

NameType(s)Description
tagstring

Specify one of the following:

  • Single tag without whitespace.
  • Multiple tags separated by a "|" to determine if Pagefile has at least one of the tags.
  • Multiple tags separated by a comma to determine if Pagefile has all of the tags. (since 3.0.17)

Return value

bool string

True if it has the given tag(s), false if not.

  • If multiple tags were specified separated by a "|", then if at least one was present, this method returns the found tag.
  • If multiple tags were specified separated by a space or comma, and all tags are present, it returns true. (since 3.0.17)

Changelog

  • 3.0.17 Added support for AND mode, where multiple tags can be specified and all must be present to return true.
  • 3.0.17 OR mode now returns found tag rather than boolean true.

See Also


Pagefile methods and properties

API reference based on ProcessWire core version 3.0.178

Twitter updates

  • Today a new version of FormBuilder has been released in the FormBuilder support board (our 50th version) and it has a lot of interesting new features, which we’ll take a closer look at in this post— More
    11 June 2021
  • ProcessWire 3.0.179 adds great new admin theme customization tools that put you in full control over the Uikit admin styles— More
    28 May 2021
  • ProcessWire updates for week of 21 May 2021— More
    22 May 2021

Latest news

  • ProcessWire Weekly #370
    In the 370th issue of ProcessWire Weekly we're going to check out the latest version of the commercial FormBuilder module, introduce a couple of brand new third party modules, and more. Read on!
    Weekly.pw / 12 June 2021
  • ProcessWire FormBuilder v50 updates
    Today a new version of FormBuilder has been released in the FormBuilder support board (our 50th version) and it has a lot of interesting new features, which we'll take a closer look at in this post.
    Blog / 11 June 2021
  • 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.