Download the PHP package dd/evolutioncms-snippets-ddif without Composer

(MODX)EvolutionCMS.snippets.ddIf

This snippet compares different values and returns required chunk or string.

Requires

• PHP >= 5.6
• (MODX)EvolutionCMS >= 1.1
• (MODX)EvolutionCMS.libraries.ddTools >= 0.60

Installation

Using (MODX)EvolutionCMS.libraries.ddInstaller

Just run the following PHP code in your sources or Console:

• If ddIf is not exist on your site, ddInstaller will just install it.
• If ddIf is already exist on your site, ddInstaller will check it version and update it if needed.

Manually

1. Elements → Snippets: Create a new snippet with the following data

1. Snippet name: ddIf.
2. Description: <b>2.3.1</b> This snippet compares different values and returns required chunk or string..
3. Category: Core.
4. Parse DocBlock: no.
5. Snippet code (php): Insert content of the ddIf_snippet.php file from the archive.

2. Elements → Manage Files

1. Create a new folder assets/snippets/ddIf/.
2. Extract the archive to the folder (except ddIf_snippet.php).

Parameters description

• operand1

  • Desctription: The first operand for comparing.
    An empty unparsed placeholder (like '[+somePlaceholder+]') will be interpretated as empty string ('').
  • Valid values: string
  • Required

• operand2

  • Desctription: The second operand for comparing.
  • Valid values: string
  • Default value: ''

• operator

  • Desctription: Comparing operator.
    Values are case insensitive (the following names are equal: 'isNumeric', 'isnumeric', 'ISNUMERIC', etc).
  • Valid values:
    • '=='
    • '!='
    • '>'
    • '<'
    • '<='
    • '>='
    • 'bool'
    • 'inArray'
    • 'isNumeric'
    • 'isWhitespace' — checks if operand1 is just white space (an empty string is also considered as white space)
    • 'isIncludes' — case-sensitive check if operand1 contains operand2
  • Default value: '=='

• trueChunk

  • Desctription: This value is returning if result is true. Available placeholders:
    • [+ddIfParams.operand1+] — contains operand1 value.
    • [+ddIfParams.operand2+] — contains operand2 value.
    • [+ddIfParams.operator+] — contains operator value.
    • [+any placeholders from the placeholders parameter+]
  • Valid values:
    • stringChunkName
    • string — use inline templates starting with @CODE:
  • Default value: ''

• falseChunk

  • Desctription: This value is returning if result is false. Available placeholders:
    • [+ddIfParams.operand1+] — contains operand1 value.
    • [+ddIfParams.operand2+] — contains operand2 value.
    • [+ddIfParams.operator+] — contains operator value.
    • [+any placeholders from the placeholders parameter+]
  • Valid values:
    • stringChunkName
    • string — use inline templates starting with @CODE:
  • Default value: ''

• placeholders

  • Desctription: Additional data has to be passed into the trueChunk and falseChunk.
    Nested objects and arrays are supported too:
    • {"someOne": "1", "someTwo": "test" } => [+someOne+], [+someTwo+].
    • {"some": {"a": "one", "b": "two"} } => [+some.a+], [+some.b+].
    • {"some": ["one", "two"] } => [+some.0+], [+some.1+].
  • Valid values:
    • stringJsonObject — as JSON
    • stringHjsonObject — as HJSON
    • stringQueryFormatted — as Query string
    • It can also be set as a native PHP object or array (e. g. for calls through $modx->runSnippet):
      • arrayAssociative
      • object
  • Default value: —
• debugTitle
  • Desctription: The title for the System Event log if debugging is needed.
    Just set it and watch the System Event log.
  • Valid values: string
  • Default value: —

Examples

String comparison

Returns:

Checks if a value exists in an array

Returns:

Check if operand1 contains operand2

Returns:

Checks if a operand1 value is number or not

Returns:

Checks if a operand1 value is just white space or not

Any number of spaces / tabs / new lines / etc are considered as white space. An empty string is also considered as white space.

Returns:

If operand1 contains any non-whitespace characters, falseString will be returned.

Returns:

Number comparison and pass additional data to chunks

Code of the general_good chunk:

Code of the general_goodInexpensive chunk:

Let [*general_price*] be equal to 120, then the snippet returns:

Run the snippet through \DDTools\Snippet::runSnippet without DB and eval

Links

• Home page
• Telegram chat
• Packagist
• GitHub