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

Latest news

  • ProcessWire Weekly #553
    In the 553rd issue of ProcessWire Weekly we'll check out the latest weekly update from Ryan, introduce a new third party module called Text Synthesis, and more. Read on!
    Weekly.pw / 14 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

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