InputfieldTextTags::tagsArray() method

Static utility function to convert a tags string to an array of [ 'tag' => 'label' ]

There isn’t currently a dedicated FieldtypeTextTags module, so if you want to convert a string of tags (as would be returned from a $page “text” field value) you can use this static helper method to convert the string of tags to an array of labels indexed by tag.

Note: returned tags and labels are entity-encoded when current $page API var output formatting is ON.

Example

$field = $fields->get('tags'); // tags field using FieldtypeText
$tags = $page->get('tags'); // page value (string of tags, i.e. "foo bar baz")
$labels = InputfieldTextTags::tagsArray($field, $tags);
foreach($labels as $tag => $label) {
  echo "<li>$tag: $label</li>";
}

Usage

// basic usage
$array = InputfieldTextTags::tagsArray(Field $field);

// usage with all arguments
$array = InputfieldTextTags::tagsArray(Field $field, $tags = null);

Arguments

NameType(s)Description
fieldField
tags (optional)string, array, null

Return value

array


InputfieldTextTags methods and properties

API reference based on ProcessWire core version 3.0.248

Latest news

  • ProcessWire Weekly #582
    The 582nd issue of ProcessWire Weekly brings in all the latest news from the ProcessWire community. Modules, sites, and more. Read on!
    Weekly.pw / 5 July 2025
  • New ProcessWire admin redesign
    When you upgrade to ProcessWire 3.0.248 or newer (currently the dev branch), you’ll immediately notice something new and beautiful…
    Blog / 9 May 2025
  • Subscribe to weekly ProcessWire news

“The end client and designer love the ease at which they can update the website. Training beyond how to log in wasn’t even necessary since ProcessWire’s default interface is straightforward.” —Jonathan Lahijani