$sanitizer->selectorValueAdvanced() method

Sanitize selector value for advanced text search operator (#=)

The advanced text search operator #= supports some characters that are typically excluded from selector values, so this method enables you to prepare a selector value for use with it. This method should not be used for sanitizing any other kinds of selector values.

Characters that have meaning to the advanced text search operator include +-*()" and thus their appearance in the $value argument is assumed to be a command rather than text to search for. Though note that non-matching double quotes or parenthesis are removed.

Note: If double quotes are used in your selector value, this method will convert them to matching parenthesis, i.e. +"phrase" gets converted to +(phrase).

Available since version 3.0.182.

Usage

// basic usage
$bool = $sanitizer->selectorValueAdvanced($value);

// usage with all arguments
$bool = $sanitizer->selectorValueAdvanced($value, array $options = []);

Arguments

NameType(s)Description
valuestring, array
options (optional)array

See options for Sanitizer::selectorValue() method

Return value

bool mixed string

See Also


$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

“We chose ProcessWire because of its excellent architecture, modular extensibility and the internal API. The CMS offers the necessary flexibility and performance for such a complex website like superbude.de. ProcessWire offers options that are only available for larger systems, such as Drupal, and allows a much slimmer development process.” —xport communication GmbH