On this page

XPHP Variables

Site-wide Variables

Server Variables

Examples are from the URL https://www.myschool.edu/folder/my-page/?foo=bar

Variable Code Example
server_host <xphp var="server_host" /> www.myschool.edu
server_path <xphp var="server_path" /> /folder/my-page/index.php
server_file
server_basename
<xphp var="server_file" />
<xphp var="server_basename" />
index.php
server_filename <xphp var="server_filename" /> index
server_extension <xphp var="server_extension" /> php
server_dirname <xphp var="server_dirname" /> /folder/my-page
server_request_uri <xphp var="server_request_uri" /> /folder/my-page/?foo=bar
server_query_string <xphp var="server_query_string" /> foo=bar

Note: The special variable <xphp var="server_path_flat" /> returns the contents of server_dirname but with / replaced with - . This has been used in some legacy Jumpchart integrations and may not be too useful nowadays.

Page Variables

Variable Description Code
page_title Page title of current page <xphp var="page_title" />
page_last_modified Timestamp of last edit (ex., “Nov. 7th at 2:22pm”) <xphp var="page_last_modified" />
page_last_editor Name of user who last edited <xphp var="page_last_editor" />
page_description Description <xphp var="page_description" />
page_keywords List of keywords <xphp var="page_keywords" />
page_tags List of tags selected <xphp var="page_tags" />

Group Variables

Variable Description Code
group_title Group title
(uses “Public Name” if group has one,
otherwise uses the back-end group name)
<xphp var="group_title" />
group_directory Name of group directory <xphp var="group_directory" />
group_fullname Full name of group
(always uses back-end group name)
<xphp var="group_fullname" />
group_link Path to group <xphp var="group_link" />
group_gid Numeric value of the Group ID <xphp var="group_gid" />
group_navigation   <xphp var="group_navigation" />
group_breadcrumb   <xphp var="group_breadcrumb" />
group_twitter_name   <xphp var="group_twitter_name" />
group_twitter_link   <xphp var="group_twitter_link" />
group_twitter_feed   <xphp var="group_twitter_feed" />
group_facebook_name   <xphp var="group_facebook_name" />
group_facebook_link   <xphp var="group_facebook_link" />
group_facebook_feed   <xphp var="group_facebook_feed" />
group_instagram_name   <xphp var="group_instagram_name" />
group_instagram_link   <xphp var="group_instagram_link" />
group_instagram_feed   <xphp var="group_instagram_feed" />

Note: Groups that use the main navigation of another group also inherit all group_* variables from that group.

Using Page and Group Variables in an include:

When using a file widget, LiveWhale will include the full source code into your page, meaning you can use context-specific variables like <xphp var="group_title"/> . However, when you append any GET variables (?foo=bar) to a file widget path, LiveWhale will instead make an HTTP request for that URL and then use the response, meaning context-specific variables like <xphp var="group_title"/> won’t work in that include, since LiveWhale doesn’t see /_ingredients/includes/my-include.php as belonging to any particular group.

Time

Variable Code Example
server_date_month <xphp var="server_date_month" /> September
server_date_month_numeric <xphp var="server_date_month_numeric" /> 9
server_date_day <xphp var="server_date_day" /> Monday
server_date_day_of_year <xphp var="server_date_day_of_year" /> 255
server_date_date <xphp var="server_date_date" /> 12
server_date_year <xphp var="server_date_year" /> 2022
server_date_full <xphp var="server_date_full" /> Monday, September 9, 2022
server_time_full_12 <xphp var="server_time_full_12" /> 1:44pm
server_time_full_24 <xphp var="server_time_full_24" /> 13:44pm
server_time_hour_12 <xphp var="server_time_hour_12" /> 1
server_time_hour_24 <xphp var="server_time_hour_24" /> 13
server_time_minute <xphp var="server_time_minute" /> 44
server_time_ampm <xphp var="server_time_ampm" /> pm
server_time_timezone <xphp var="server_time_timezone" /> EDT

Tags

Variable Description Code
tag_title Returns only the title of tag <xphp var="tag_title" />
tag_links Returns the tag link <xphp var="tag_links" />

Details Template Variables

Please note, XPHP variables for details pages are prefixed with details_. If your site was built using LiveWhale 1.6 or before, you may see in your details templates some variable prefixed with events_, forms_, news_, etc. However, since LiveWhale 1.6.1, details_ is the correct prefix for those variables (others are supported for backwards compatibility).

Events

Variable Description Code
id Events ID (ex., 4) <xphp var="details_id" />
parent The ID of the parent event, in the case of a shared or linked copy <xphp var="details_parent" />
gid Group ID <xphp var="event_gid" />
title Title of event <xphp var="details_title" />
status Hidden or Live Status is returned <xphp var="details_status" />
is_canceled Returns true or false is event is cancelled <xphp var="details_is_canceled" />
summary Summary <xphp var="details_summary" />
description Description <xphp var="details_desciption" />
views Number of views <xphp var="details_views" />
date_dt 2014-11-22 14:00:00 <xphp var="details_date_dt" />
date2_dt 2014-11-22 17:00:00 <xphp var="details_date2_dt" />
timezone Timezone <xphp var="details_timezone" />
is_all_day Returns true/false if event is all day <xphp var="details_is_all_day" />
repeats Returns true/false if a repeating event <xphp var="details_repeats" />
repeats_from Starting date (2014-11-22 14:00:00) <xphp var="details_repeats_from" />
repeats_until Ending date (2014-11-29 14:00:00) <xphp var="details_repeats_until" />
repeats_occurrences   <xphp var="details_repeats_occurrences" />
has_registration Returns true or false if there is registration <xphp var="details_has_registration" />
registration_owner_email Email of registration owner <xphp var="details_registration_owner_email" />
has_wait_list Returns true/false if event has a waiting list <xphp var="details_has_wait_list" />
last_modified Timestamp of last edit (ex., “Nov. 7th at 2:22pm”) <xphp var="details_last_modifed" />
url URL to event <xphp var="details_url" />
source   <xphp var="details_source" />
cost Cost of event <xphp var="details_cost" />
contact_info Contact Information <xphp var="details_contact_info" />
is_starred Returns true/false if event is starred <xphp var="details_is_starred" />
subscription_id Subscription ID <xphp var="details_subscription_id" />
subscription_status   <xphp var="details_subscription_status" />
location Location title and address <xphp var="details_location" />
location_latitude Latitude coordinate of locations (ex., 41.40338) <xphp var="details_location_latitude" />
location_longitude Longitude coordinate of locations (ex., 2.17403) <xphp var="details_location_longitude" />
tags List of tags selected <xphp var="details_tags" />
image   <xphp var="details_image" />
group_title   <xphp var="details_group_title" />
has_comments   <xphp var="details_has_comments" />
registration_instructions   <xphp var="details_registration_instructions" />
registration Displays registration instructions, registration form, and any additional RSVP forms that are attached (1.6+) <xphp var="details_registration"/>
is_paid True/false if this is a paid event <xphp var="details_is_paid" />
payment_price Cost of event <xphp var="details_payment_price" />
payment_method Method of payment <xphp var="details_payment_method" />
style   <xphp var="details_style" />
group_fullname Fullname of group event is stored <xphp var="details_group_fullname" />
group_directory Directory path of event’s group <xphp var="details_group_directory" />
tags_calendar List of tags selected <xphp var="details_tags_calendar" />
gateway   <xphp var="details_gateway" />
registration_open   <xphp var="details_registration_open" />
last_editor Name of user who last edited <xphp var="details_last_editor" />
rsvp_form Displays RSVP form <xphp var="details_rsvp_form" />
images   <xphp var="details_images" />
related_content Related Content (galleries, web links, etc..) <xphp var="details_related_content" />
date_ts Returns in the following format: 1416664800 <xphp var="details_date_ts" />
date_utc Starting date/time (2014-11-22 14:00:00) <xphp var="details_date_utc" />
date_time Time (12:00pm - 12:45pm) <xphp var="details_date_time" />
start_time Start time (12:00pm) <xphp var="details_start_time" />
date Date and Time (12:00pm - 12:45pm CST December 3) <xphp var="details_date" />
date2_time End Time (12:45pm) <xphp var="details_date2_time" />
image_src URL of uploaded image <xphp var="details_image_src" />
hero_image Displays large version of upload image <xphp var="details_hero_image" />
thumbnail_href URL of thumbnail <xphp var="details_thumbnail_href" />
thumbnail Displays thumbnail <xphp var="details_thumbnail" />
ical Displays “Download ical event” link <xphp var="details_ical" />
ical_link URL to ical feed <xphp var="details_ical_link" />
timestamp Start date in following format: 1416664800 <xphp var="details_timestamp" />
timestamp_end End date in following format: 1416675600 <xphp var="details_timestamp_end" />
share Returns true/false if shared to other groups <xphp var="details_share" />
cal_date Displays in stack format:
Nov
22
<xphp var="details_cal_date" />
save_to_calendar Displays “Add to Calendar” button <xphp var="details_save_to_calendar" />
canonical_url The full canonical URL of the details page (LiveWhale 2.8.0+) <xphp var="details_canonical_url" />

Forms

Variable Description Code
title Form Title <xphp var="details_title" />
last_modified Timestamp of last edit (ex., “Nov. 7th at 2:22pm”) <xphp var="details_last_modified" />
last_editor Name of user who last edited <xphp var="details_last_editor" />
tags List of tags selected <xphp var="details_tags" />
group_title Title of group forms is stored in <xphp var="details_group_title" />
canonical_url The full canonical URL of the details page (LiveWhale 2.8.0+) <xphp var="details_canonical_url" />

Galleries

Variable Description Code
id Gallery ID <xphp var="details_id" />
title Gallery Title <xphp var="details_title" />
date Gallery Date entered in field (11/06/2014) <xphp var="details_date" />
description Description <xphp var="details_description" />
image Displays image <xphp var="details_image" />
thumbnails Displays all thumbnail images <xphp var="details_thumbnails" />
thumbnail Displays thumbnail <xphp var="details_thumbnail" />
thumbnail_href URL to thumbnail <xphp var="details_thumbnail_href" />
location Returns Title and address of location <xphp var="details_location" />
location_title Location title <xphp var="details_location_title" />
location_latitude Latitude coordinate of locations (ex., 41.40338) <xphp var="details_location_latitude" />
location_longitude Longitude coordinate of locations (ex., 2.17403) <xphp var="details_location_longitude" />
galleryphotos   <xphp var="details_galleryphotos" />
related_content Related Content (galleries, web links, etc..) <xphp var="details_related_content" />
share Returns true/false if shared to other groups <xphp var="details_share" />
gid Numerical value of Group ID (ex., 4) <xphp var="details_gid" />
group_title Name of group gallery is stored in <xphp var="details_group_title" />
group_directory Directory path to group <xphp var="details_group_directory" />
status Returns Hidden or Live status <xphp var="details_status" />
views Number of views of gallery <xphp var="details_views" />
url URL to gallery <xphp var="details_url" />
last_modified Timestamp of last edit (ex., “Nov. 7th at 2:22pm”) <xphp var="details_last_modified" />
has_comments Returns true/false if comments exist <xphp var="details_has_comments" />
last_editor Name of user who last edited <xphp var="details_last_editor" />
details_url   <xphp var="details_details_url" />
tags List of tags selected <xphp var="details_tags" /> ​ ​
canonical_url The full canonical URL of the details page (LiveWhale 2.8.0+) <xphp var="details_canonical_url" />

News

Variable Description Code
id News ID <xphp var="details_id" />
gid Group ID <xphp var="details_gid" />
group_title Group name <xphp var="details_group_title" />
group_directory Directory path to group <xphp var="details_group_directory" />
headline Headine <xphp var="details_headline" />
summary Summary of the news story <xphp var="details_summary" />
date News date (ex., May 17, 2017) <xphp var="details_date" />
date_dt News datetime (ex., 2017-11-07 06:00:00) <xphp var="details_date_dt" />
body News story body <xphp var="details_body" />
url URL to the news story <xphp var="details_url" />
status Hidden or Live news story <xphp var="details_status" />
views Number of views of story received <xphp var="details_views" />
last_modified Timestamp of last edit (ex., “Nov. 7th at 2:22pm”) <xphp var="details_last_modified" />
has_comments Returns true or false if comments exist <xphp var="details_has_comments" />
last_editor Name of user who last edited the story <xphp var="details_last_editor" />
details_url   <xphp var="details_details_url" />
tags List of starred tags selected <xphp var="details_tags" />
location Name and address of location <xphp var="details_location" />
location_title Name of location <xphp var="details_location_title" />
location_longitude Longitude coordinate of locations (ex., 2.17403) <xphp var="details_location_longitude" />
related_content Related Content (galleries, web links, etc..) <xphp var="details_related_content" />
date Story date entered in date field <xphp var="details_date" />
thumbnail Displays thumbnail image <xphp var="details_thumbnail" />
thumbnail_href URL to thumbnail image (available in 1.6) <xphp var="details_thumbnail_href" />
image Displays the uploaded image <xphp var="details_image" />
contactinfo Information entered in Contact Information field <xphp var="details_contactinfo" />
share Returns true/false if shared to other groups <xphp var="details_share" />
views Returns the number of views from Google Analytics (LW 1.5.1+) <xphp var="details_views" /> ​
canonical_url The full canonical URL of the details page (LiveWhale 2.8.0+) <xphp var="details_canonical_url" />

Profiles

Variable Description Code
id Numerical profile id (ex., 7) <xphp var="details_id" />
gid Numerical group id the profile is stored <xphp var="details_gid" />
tid Numerical profile type id <xphp var="details_tid" />
group_title Name of the group the profile is stored. (ex., Admissions) <xphp var="details_group_title" />
group_directory URL path to the group (ex., http://localhost.edu/admissions) <xphp var="details_group_directory" />
parent   <xphp var="details_parent" />
url URL path to profile <xphp var="details_url" />
status Hidden or Live <xphp var="details_status" />
firstname First name (ex., “Jane”) <xphp var="details_firstname" />
middlename Middle name (ex., “Ann”) <xphp var="details_middlename" />
lastname last name (ex., “Smith”) <xphp var="details_firstname" />
title Returns data entered in title field (ex., “Director of Marketing”) <xphp var="details_title" />
name Full name is returned (“Jane Ann Smith”) <xphp var="details_name" />
style Returns the profile style (ex., person) <xphp var="details_style" />
description Returns data entered in Description field <xphp var="details_description" />
description_location   <xphp var="details_description_location" />
last_modifed Timestamp of last edit (ex., “Nov. 7th at 2:22pm”) <xphp var="details_last_modified" />
contact_info Returns data entered into the Contact Information field <xphp var="details_contact_info" />
contact_info_location   <xphp var="details_contact_info_location" />
views Number of profile views <xphp var="details_views" />
last_editor Returns name of the person who last edited the profile. <xphp var="details_last_editor" />
details_url   <xphp var="details_details_url" />
tags List of tags are displayed <xphp var="details_tags" />
location_title Location Title <xphp var="details_location_title" />
location_latitude Latitude coordinate of locations (ex., 41.40338) <xphp var="details_location_latitiude" />
location_longitude Longitude coordinate of locations (ex., 2.17403) <xphp var="details_location_longitude" />
type Returns the profile type name (ex., Faculty) <xphp var="details_type" />
images Returns a collection of profile’s images upload <xphp var="details_images" />
related_content Related Content (galleries, web links, etc..) <xphp var="details_related_content" />
thumbnail_href URL to the image thumbnail <xphp var="details_thumbnail_href" />
thumbnail Displays the thumbnail image <xphp var="details_thumbnail" />
image Displays the uploaded image <xphp var="details_image" />
body Returns all data entered and set as “body” in profile type <xphp var="details_body" />
sidebar Returns all data entered and set as “sidebar” in profile type <xphp var="details_sidebar" />
share Returns true/false if shared to other groups <xphp var="details_share" />
canonical_url The full canonical URL of the details page (LiveWhale 2.8.0+) <xphp var="details_canonical_url" />

Blurbs

Variable Description Code
id Numerical blurb id (ex., 7) <xphp var="details_id" />
gid Numerical group id the blurb is stored <xphp var="details_gid" />
tid Numerical blurb type id <xphp var="details_tid" />
group_title Name of the group the blurb is stored. (ex., Admissions) <xphp var="details_group_title" />
status Hidden or Live <xphp var="details_status" />
title Returns data entered in title field <xphp var="details_title" />
body Returns data entered in body field <xphp var="details_body" />
last_modifed Timestamp of last edit (ex., “Nov. 7th at 2:22pm”) <xphp var="details_last_modified" />
last_editor Returns name of the person who last edited the blurb. <xphp var="details_last_editor" />
tags List of tags are displayed <xphp var="details_tags" />
canonical_url The full canonical URL of the details page (LiveWhale 2.8.0+) <xphp var="details_canonical_url" />