$sanitizer->fieldSubfield() method

Sanitize as a field name but with optional subfield(s) like “field.subfield”

  • Periods must be present to indicate subfield(s), otherwise behaves same as fieldName() sanitizer.
  • By default allows just one subfield. To allow more, increase the $limit argument.
  • To allow any quantity of subfields, specify -1.
  • To reduce a field.subfield... combo to just field specify 0 for limit argument.
  • Maximum length of returned string is (128 + ($limit * 128)).

Available since version 3.0.126.

Example

echo $sanitizer->fieldSubfield('a.b.c'); // outputs: a.b (default behavior)
echo $sanitizer->fieldSubfield('a.b.c', 2); // outputs: a.b.c
echo $sanitizer->fieldSubfield('a.b.c', 0); // outputs: a
echo $sanitizer->fieldSubfield('a.b.c', -1); // outputs: a.b.c (any quantity)
echo $sanitizer->fieldSubfield('foo bar.baz'); // outputs: foo_bar.baz
echo $sanitizer->fieldSubfield('foo bar baz'); // outputs: foo_bar_baz

Usage

// basic usage
$string = $sanitizer->fieldSubfield(string $value);

// usage with all arguments
$string = $sanitizer->fieldSubfield(string $value, int $limit = 1);

Arguments

NameType(s)Description
valuestring

Value to sanitize

limit (optional)int

Max allowed quantity of subfields, or use -1 for any quantity (default=1).

Return value

string


$sanitizer methods and properties

API reference based on ProcessWire core version 3.0.200

Twitter updates

  • New TinyMCE 6.2.0 Inputfield released for ProcessWire— More
    28 October 2022
  • This week we take a look at a new rich text editor for ProcessWire, why we chose it, some highlights, screenshots, and why we think you’ll like it— More
    21 October 2022
  • This week we have ProcessWire 3.0.206 on the dev branch and a new version of the ProDevTools UserActivity module, which we'll take a closer look at in this post— More
    7 October 2022

Latest news

  • ProcessWire Weekly #447
    In the 447th issue of ProcessWire Weekly we'll share the latest core updates, introduce a new third party module called RockVideoThumbnailGrabber, and more. Read on!
    Weekly.pw / 3 December 2022
  • New rich text editor for ProcessWire
    This week we take a look at a new rich text editor for ProcessWire, why we chose it, some highlights, screenshots, and why we think you’ll like it.
    Blog / 21 October 2022
  • Subscribe to weekly ProcessWire news

“…building with ProcessWire was a breeze, I really love all the flexibility the system provides. I can’t imagine using any other CMS in the future.” —Thomas Aull