$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 #548
    In the 548th issue of ProcessWire Weekly we're going to check out a couple of new third party modules, introduce the latest ProcessWire core updates, and more. Read on!
    Weekly.pw / 9 November 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

“Yesterday I sent the client a short documentation for their ProcessWire-powered website. Today all features already used with no questions. #cmsdoneright—Marc Hinse, Web designer/developer