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

Latest news

  • ProcessWire Weekly #558
    In the 558th issue of ProcessWire Weekly we'll check out the blog post that introduces ProcessWire 3.0.244, share some recent ProcessWire highlights, and more. Read on!
    Weekly.pw / 18 January 2025
  • ProcessWire 3.0.244 new main/master version
    ProcessWire 3.0.244 is our newest main/master/stable version. It's been more than a year in the making and is packed with tons of new features, issue fixes, optimizations and more. This post covers all the details.
    Blog / 18 January 2025
  • Subscribe to weekly ProcessWire news

I just love the easy and intuitive ProcessWire API. ProcessWire rocks!” —Jens Martsch, Web developer