Conditional Custom Fields Shortcode

You can control how it sort the items (when there’s more than one) using the sort attribute (default is nosort ). By default, it would compare them using PHP’s comparison operator (i.e. try to cast them into numeric values, or compare them as strings if that failed). However, you can force a type cast by specifying the type attribute (default is auto ).

Display Single Value

If display multiple values is not what you want it to do, you can use [cf single="true"] to force it to display only the first value. Combining what we have learned so far, you can display a single random value by [cf single="true" sort="random"] .

Summary

Syntax for [cf] shortcode: (default values in parenthesis)

[cf "field-name" default="" placeholder="%value%" single="(false)|true" separator="," sort="(nosort)|asc|dsc|random" type="string|int|integer|float|bool|boolean|date|(auto)"](OPTIONAL) template[/cf]

Conditionals

Conditionals tags is what makes this plugin unique. Here is a list of them:

[if-cf-def "custom field name"] Do this when "custom field name" is defined for this page/post [/if-cf-def] [if-cf-ndef "custom field name"] Do this when "custom field name" is NOT defined for this page/post [/if-cf-ndef] [if-cf-eq "custom field name" "value"] Do this when "custom field name" == "value" [/if-cf-eq] [if-cf-neq "custom field name" "value"] Do this when "custom field name" != "value" [/if-cf-neq] [if-cf-lt "custom field name" "value"] Do this when "custom field name" < "value" [/if-cf-lt] [if-cf-gt "custom field name" "value"] Do this when "custom field name" > "value" [/if-cf-gt] [if-cf-let "custom field name" "value"] Do this when "custom field name" <= "value" [/if-cf-let] [if-cf-get "custom field name" "value"] Do this when "custom field name" >= "value" [/if-cf-get]

More detailed documentations will be published soon. In the mean time, check out the following examples and the comments in the PHP code to get a rough idea.

Examples

[if-cf-get "deadline" "today" type="date"] Submit your application <a href='[cf "submit-link"]'>here</a>. [/if-cf-get] [if-cf-lt "deadline" "today" type="date"] Sorry we regret that we cannot take anymore applications. [/if-cf-lt] [if-cf-def "discounted-price" "discount-expires" logic="and"] This product is on discount, get it now for [cf "discounted-price" /] [cf "discount-expires" default="for a limited time"]before %value%[/cf]! [/if-cf-def]

Please note: It seems that there is a serious bug in WordPress’ shortcode parser that prevents shortcodes from functioning correctly in certain occasions. The developers are hard at work to get this fixed before the 2.8.3 release. (See #10082 ) Therefore, please do not report any parser related bugs for the moment. (e.g. the shortcode is displayed on the actual page)