$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

  • A review of weekly core updates, plus a simple recipe for a very effective listing cache—More
    24 June 2022
  • Weekly update: Making ProcessWire render pages at old WordPress URLs (or building a simple/custom URL router in PW): More
    17 June 2022
  • New post: ProcessWire now comes with just 1 site installation profile, the "blank" profile. It makes very few assumptions, making it a minimal though excellent starting point. Here’s how you might use it— More
    10 June 2022

Latest news

  • ProcessWire Weekly #424
    In the 424th issue of ProcessWire Weekly we'll check out the latest weekly update from Ryan, introduce a new third party module, and more. Read on!
    Weekly.pw / 25 June 2022
  • Starting a site with the “blank” profile
    ProcessWire 3.0.200+ comes with just 1 site installation profile, the site-blank profile. This profile makes very few assumptions, making it a minimal though excellent starting point. Here’s how you might use it. 
    Blog / 10 June 2022
  • 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