shortcodes<\/a>, and use its attributes to define conditions. The content between the shortcodes will only be displayed if all defined conditions are met.<\/p>\n\nDefining conditions<\/h4>\n\n
Conditions are defined by setting the attributes of the shortcode in the following format:<\/p>\n\n
[if <type>=<condition>]\n Conditional content\n[\/if]\n<\/code><\/pre>\n\nA basic example:<\/p>\n\n
[if qs=\"product-type:shoes\"]\n Thank you for buying shoes\n[\/if]\n<\/code><\/pre>\n\nThe text in this example will only be displayed if the current URL has a GET paramater of \"product-type\" with the value \"shoes\".<\/p>\n\n
Available condition types are:<\/p>\n\n
\nqs<\/code><\/strong> - Match on the key\/value pair of the defined query string\/GET parameter. Query string conditions are formatted like this:<\/p>\n\n[if qs=\"<qskey>:<qsvalue>\"] \u2026 [\/if]\n\nqskey is the name of the query string variable and `qsvalue` the value to test for. For example, the condition `qs=\"product-type:2\"` will match `?product-type=2`.\n<\/code><\/pre><\/li>\nreferrer<\/code><\/strong> - To check on the current referrer. The condition will be true if HTTP_REFERER<\/code> contains <value><\/code>. The match doesn't need to be exact, so if a user arrives from google and <value><\/code> is set to \"google.com\" the condition will be true.<\/p><\/li>\nrole<\/code><\/strong> - Matches the current user's role. The match needs to be exact so \"admin\" will not match \"administrator\". Use role<\/code> with and empty value if you want to match users that are not logged in.<\/p><\/li>\n<\/ul>\n\nExamples<\/h4>\n\n
Display content based on query string:<\/p>\n\n
[if qs=\"utm_source:partner-site\"]\n This content is only displayed if the current URL contains a GET paramater 'utm_source' with value 'partner-site'\n [\/if]<\/p>\n\n
Display content based on referrer:<\/p>\n\n
[if referrer=\"www.google.com\"]\n This content is only displayed if the referring URL contains 'www.google.com'\n[\/if]\n<\/code><\/pre>\n\nDisplay content based on user role:<\/p>\n\n
[if role=\"editor\"]\n This content is only displayed if the user is logged in with the role 'editor'\n[\/if]\n<\/code><\/pre>\n\nSetting multiple conditions and combining condition types:<\/p>\n\n
[if referrer=\"www.example.com\" qs=\"utm_source:partner-site\"]\n This content is displayed to users coming from example.com who clicked on a link originating from our RSS feed.\n[\/if]\n<\/code><\/pre>\n\nMatching with `exact` or `contain`<\/h4>\n\n
By default query string conditions are matched on the exact value as defined in the shortcode. For looser 'wildcard' matching you can add a match<\/code> attribute with the value contain<\/code>:<\/p>\n\n[if qs=\"product-type:cashmere-\" match=\"contain\"]\n Good choice! Cashmere is a wonderful fabric.\n[\/if]\n<\/code><\/pre>\n\nThis will match both ?product-type=cashmere-sweater<\/code> and ?product-type=cashmere-coat<\/code><\/p>\n\nMatching on multiple values<\/h4>\n\n
You can have a condition match on multiple values by using the semicolon as a seperator when defining allowed values. Example:<\/p>\n\n
[if qs=\"product-type:shoes;coat\"]\n This text is displayed for people who bought either a nice pair of shoes or a great fashionable coat.\n[\/if]\n<\/code><\/pre>\n\nNesting `if` statements<\/h4>\n\n
You can nest statements but you have to use iteration. This has to do with the limitations of the built-in shortcode API.<\/p>\n\n
[if qs=\"tonight:the-night\"]\n\n Tonight's the night.\n\n [if2 qs=\"future:beautiful\"]\n\n We create our own destiny every day we live.\n\n [\/if2]\n\n [if2 qs=\"future:platic\"]\n\n I see sheets of plastic in your future.\n\n [\/if2]\n\n[\/if]\n<\/code><\/pre>\n\nYou can nest up to if4 (4 levels).<\/p>\n\n\n
\n- Upload the 'wp-conditional-content' folder to your plugins directory<\/li>\n
- Activate the plugin through the 'Plugins' menu in your WordPress admin<\/li>\n
- You can now use the [if] shortcode in your post content. Read the documentation for details.<\/li>\n<\/ol>\n\n\n
\n- Can I use `else` statements?<\/dt>\n
Not yet, but it's on the to-do list<\/p><\/dd>\n
- I have a request for a certain condition I want to be able to check.<\/dt>\n
Great, feel free to send me your suggestion through Twitter: @bvandreunen<\/a><\/p><\/dd>\n\n<\/dl>\n\n\n\n- 0.1 First release<\/li>\n<\/ul>","raw_excerpt":"Allows you to use shortcodes as if statements in your content to display text only if certain conditions are met.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/52962","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=52962"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/superinteractive"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=52962"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=52962"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=52962"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=52962"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=52962"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=52962"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}