$fields->findByTag() method

Return all fields that have the given $tag

Returns an associative array of ['field_name' => 'field_name'] if $getFieldNames argument is true, or ['field_name => Field instance] if not (which is the default).

Available since version 3.0.106.

Usage

// basic usage
$array = $fields->findByTag(string $tag);

// usage with all arguments
$array = $fields->findByTag(string $tag, bool $getFieldNames = false);

Arguments

NameType(s)Description
tagstring

Tag to find fields for

getFieldNames (optional)bool

If true, returns array of field names rather than Field objects (default=false).

Return value

array

Array of Field objects, or array of field names if requested. Array keys are always field names.


$fields methods and properties

API reference based on ProcessWire core version 3.0.236

Latest news

  • ProcessWire Weekly #554
    In the 554th issue of ProcessWire Weekly we'll check out the latest core updates, introduce a couple of new third party modules, and more. Read on!
    Weekly.pw / 21 December 2024
  • Custom Fields Module
    This week we look at a new ProFields module named Custom Fields. This module provides a way to rapidly build out ProcessWire fields that contain any number of subfields/properties within them.
    Blog / 30 August 2024
  • Subscribe to weekly ProcessWire news

“I am currently managing a ProcessWire site with 2 million+ pages. It’s admirably fast, and much, much faster than any other CMS we tested.” —Nickie, Web developer