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

Latest news

  • ProcessWire Weekly #518
    The 518th issue of ProcessWire Weekly brings in all the latest news from the ProcessWire community. Modules, sites, and more. Read on!
    Weekly.pw / 13 April 2024
  • ProFields Table Field with Actions support
    This week we have some updates for the ProFields table field (FieldtypeTable). These updates are primarily focused on adding new tools for the editor to facilitate input and management of content in a table field.
    Blog / 12 April 2024
  • 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.