feature #5948 Add mode to search all/any terms

[tasiot]

Follow up to #5948

This PR add a searchMode option in Crud to set if the search is an AND or OR operator between terms.

[tasiot]

IMO the default search mode should be SearchMode::ALL_TERMS but for compatibility reasons I set ANY_TERMS as default.

Must I set ALL_TERMS as default?

[bytes-commerce]

If I understand your PR correctly, ALL_TERMS would be correct search mode by default. Correct me if I am wrong. It means: Condition A and Condition B must match in order to display. Correct? If yes, I'd second your opinion here. Otherwise, maybe the owner wants to have the last word here. 🤔

[tasiot]

Yes, it is.

When you type once word ANY_TERMS and ALL_TERMS are identical.
But with many words (=terms), all terms must be found: the word1 must be found in field1 or field2 or field3 but the word2 must also be found in field1, field2 or field3.

According my documentation:

$crud
    // match any terms (default mode)
    // term1 in (field1 or field2) or term2 in (field1 or field2)
    ->setSearchMode(SearchMode::ANY_TERMS)
    // force to match all the terms
    // term1 in (field1 or field2) and term2 in (field1 or field2)
    ->setSearchMode(SearchMode::ALL_TERMS)
;

[bytes-commerce]

Then I absolutely agree with you. 👍 Thank you very much for explaining it once again.

[tasiot]

I just pushed a new commit to set ALL_TERMS as default.

I've kept it as a separate commit in case the owner wants to use ANY_TERMS as default like now.

[javiereguiluz]

This is finally merged! Roland, thanks for this contribution. I played a bit with it and it worked nicely. I hope it's useful for other people too. Cheers!