XPHP is an ever-growing library of scripting statements that you can use for powerful template control, widget behaviors, and more in LiveWhale.

In the below statements, you can use any of the XPHP variables from the XPHP Dictionary, or item-specific variables in widget results and details pages (i.e., "profiles_45" might be one of your custom profile fields).

XPHP Logic Operations

If/Then Example

The following examples demonstrate first, a simple check (is variable “X” empty?) and a more complicated one, using some of the tricks from the conditional functions below.

<xphp content="true">
   <if var="X" value=""/>
     <content>
        <!– do something here –>
     </content>
</xphp>

<xphp content="true">
   <if var="server_path" value="{group_directory}index.php"/>
     <content>
        <!– show this if it's the group homepage –>
     </content>
</xphp>

Whatever is in-between <content></content> will be shown if the if statement is true. It could be simple HTML, a widget, or more XPHP code.

If/Then Shorthand

The above syntax can be shortened to <xphp if . For example:

<xphp if="X">Variable X exists.</xphp>
<xphp if="X" value="Y">Variable X has value Y.</xphp>
<xphp if="X" matches="Y">Variable X contains the text Y.</xphp>

If/Else Example

Below is an example using If/Else in xphp to display a default image in your profile details page when the person does not have a photo:

<xphp content="true">
  <if var="profiles_image"/>
    <content>
      <xphp var="profiles_image"/>
    </content>
  <else content="true">
    <content>
      <img src="/path/to/default_image.png"/>
    </content>
  </else>
</xphp>

In this example, we see we can use <xphp var="foo"/> to display an XPHP variable directly.

AND & OR Operators

By default, XPHP if statements are treated as ANDs when two or more variables must meet the conditions set, but you can switch to an OR relationship with the addition of only one attribute on the surrounding <xphp> tag.

<!– the default AND state –>
<xphp content="true">
  <if var="a"/>
  <if var="b"/>
    <content>
      <p>A and B are both non-empty.</p>
    </content>
</xphp>

<!– with the addition of the ifmode="or" attribute, the comparison becomes an OR –>
<xphp content="true" ifmode="or">
  <if var="a"/>
  <if var="b"/>
    <content>
      <p>Either A or B is non-empty.</p>
    </content>
</xphp>

XPHP Conditional Functions

You can alter the <if> statements above, mixing and matching from the following library, to execute all sorts of logical tests:

Using other variables (POST, GET) in your if statements

By default, the above tests will check for your variables in the XPHP Dictionary (also known as $_GLOBALS in PHP). You can use the type attribute to check variables from server, get, or post.

Checking for elements on the page

You can also use XPHP to check for certain elements in the source code of the current page, using the has_element function. Your check can match any valid single CSS selector in the following forms:

<if has_element="span"/>
<if has_element="#aaa"/>
<if has_element=".bbb"/>
<if has_element="span#aaa"/>
<if has_element="span.bbb"/>
<if has_element="span#aaa.bbb"/>
<if has_element="#aaa.bbb"/>
<if has_element="#aaa.bbb.ccc"/>

This is especially useful if, for example, you want a section of your page to display only if <div id="sidebar"> exists ( <if has_element="div#sidebar"/> ).

Note: The element must exist in the page before the <if> statement in question is reached. This may mean, if you have other page changes being output from another XPHP statement, it could not be caught by this logical test.

XPHP Tools

In addition to the above conditional statements and logical tests, XPHP has several tools that you can use to make your website more responsive, intelligent, or fun.

Advanced: Extracting specific HTML elements from an XPHP variable

Sometimes you may want to extract only a specific HTML object from an existing XPHP variable. In LiveWhale, you can use selector="" in your <xphp> variables (and, in widget formats, with <field> variables) to do just that.

This advanced tool supports the XPath syntax (cheatsheet). selector="//foo will grab the element <foo> wherever it appears. See below for some examples.

Timely Content

You can use XPHP to show content before/after a certain date, or daily before/after a certain time.

You can define timely content with the simple attributes start and end . You can also preview timely content from other dates/times by adding ?lw_preview_date= to your URL. e.g., /my-page/?lw_preview_date=April 7

You can use any PHP-readable date/time strings in your schedules and preview links (dates, dates with times, or just times for daily repeating schedules).

<xphp content="true" end="2020-11-28">
<content>Countdown to our Day of Giving...</content>
</xphp>
<xphp content="true" start="2020-11-28">
<content>Today is Day of Giving!</content>
</xphp>

<xphp content="true" end="12pm">
<content>Good morning!</content>
</xphp>
<xphp content="true" start="12pm" end="5pm">
<content>Good afternoon!</content>
</xphp>
<xphp content="true" start="5pm">
<content>Good night!</content>
</xphp>

In LiveWhale 2.18.0+, you can also use scheduled/timely content in shorthand:

<xphp before="12pm">Good morning!</xphp>
<xphp after="12pm">Good evening!</xphp>

Using XPHP Variables Inside Quotes

You can use the following XHTML-friendly syntax to place XPHP variables inside other XPHP or HTML tags and attributes. You do so by replacing <xphp var="my_variable" /> with %%​xphp_my_variable%% . For example, if you have <xphp var="start_date" /> set, you can use:

<xphp content="true" after_date="">
<content>Today is Day of Giving!</content>
</xphp>

Or even in simpler cases, you can use the %% format where you want to nest XPHP code inside other tags:

This is the URL: <xphp var="href" />
<a href="">Read more</a>

Note, this syntax only works for individual XPHP variables and not for larger chunks of XPHP logic.

Specifying Type and Cast

Whether using the normal <xphp syntax or the in-quotes %%xphp_%% format, you can also request variables of alternate types (GET, POST, COOKIE, SERVER) and casts (dashed, encoded, decoded, text, urlencoded, obfuscated, uppercase, lowercase, uppercase-first, uppercase-words, int, bool, float, string).

When in quotes, the format is %%xphp_variable|TYPE|CAST:value%% with |TYPE and |CAST:value both being optional. You can also use multiple casts by separating them with spaces. A few examples are below:

XPHP Cast Dictionary

You can also re-cast variables in widget formats—for example, by replacing {title_clean} with <field var="title_clean" cast="uppercase"/> .

XPHP Variables

Different XPHP variables get populated depending on context. For a full list, see the XPHP Variables Dictionary.