Pagefiles::tags() method

Get list of tags for all files in this Pagefiles array, or return files matching given tag(s)

This method can either return a list of all tags available, or return all files matching the given tag or tags (an alias of findTag method).

Example

// Get string of all tags
$tagsString = $page->files->tags();

// Get array of all tags
$tagsArray = $page->files->tags(true);

// Find all files matching given tag
$pagefiles = $page->files->tags('foobar'); 

Usage

// basic usage
$string = $pagefiles->tags();

// usage with all arguments
$string = $pagefiles->tags($value = null);

Arguments

NameType(s)Description
value (optional)bool, string, array

Specify one of the following:

  • Omit to return all tags as a string.
  • Boolean true if you want to return tags as an array (rather than string).
  • Boolean false to return tags as an array, with lowercase enforced.
  • String if you want to return files matching tags (See Pagefiles::findTag() method for usage)
  • Array if you want to return files matching tags (See Pagefiles::findTag() method for usage)

Return value

string array Pagefiles

Returns all tags as a string or an array, or Pagefiles matching given tag(s). When a tags array is returned, it is an associative array where the key and value are both the tag (keys are always lowercase).

See Also


Pagefiles methods and properties

API reference based on ProcessWire core version 3.0.137

Twitter updates

  • New post: An introductory look at ProcessWire LoginRegisterPro, a module for providing new user registration, secure logins, profile editing, and more— More
    13 December 2019
  • ProcessWire 3.0.146 on the dev branch contains about 22 commits with a combination of useful upgrades and issue report resolutions, more details in this forum post: More
    22 November 2019
  • ProcessWire 3.0.144 and 3.0.145 add improved field template context override settings and include a new Inputfields API, along with numerous other issue fixes, optimizations and improvements to the core. More
    8 November 2019

Latest news

  • ProcessWire Weekly #292
    In the 292nd issue of ProcessWire Weekly we're going to cover three new modules – Login Register Pro, FieldtypeImageFromPage, and PwQuickFixes – as well as introduce a very interesting new site of the week. Read on!
    Weekly.pw / 14 December 2019
  • Login Register Pro
    This week we’ll take a look at LoginRegisterPro — a new module that provides an all-in-one, self contained module for providing new user registration, secure logins, profile editing, and more. It does this all in a manner that is reliable, efficient, comprehensive and secure.
    Blog / 13 December 2019
  • Subscribe to weekly ProcessWire news

“To Drupal, or to ProcessWire? The million dollar choice. We decided to make an early switch to PW. And in retrospect, ProcessWire was probably the best decision we made. Thanks are due to ProcessWire and the amazing system and set of modules that are in place.” —Unni Krishnan, Founder of PigtailPundits