{version:type}

Description

Returns information about the running ActionApps installation: the AA version, the build stamp, or the PHP version. The optional type selects what to return; with no type, or with any value it does not know (the names are case-sensitive), you get the full string - ActionApps, the version, the build stamp in parentheses and the PHP version. The build stamp is the git commit and its date, written into the release tree when it is built; a tree checked out straight from the source repository has no stamp, so build, svn and svn2 are empty there and the full string says source checkout. svn and svn2 are kept only so that old templates keep working - since the move from SVN to git both return the short commit id. The output depends on the install, so examples here are illustrative. Until November 2026 the full string also ended with the visitor IP address (REMOTE_ADDR), and the Site module page cache could serve the page with the first visitor address to everyone else; an install not updated since still does that. The full string shows the exact PHP version, so for a public footer use aa (and php only when you really want to show it).

Parameters

type optional default full

What to return. Omit it, or pass a value not listed below, to get the full string. The names are case-sensitive, so AA also returns the full string.

Allowed values full (default) - ActionApps, the version, the build stamp in parentheses and the PHP version (until November 2026 also the visitor IP address); aa - the ActionApps version only, e.g. 2026.10; build - the git commit and its date, e.g. 1a2b3c4 2026-10-30 14:05, empty in a source checkout; php - the PHP version, e.g. 8.4.27; svn, svn2 - legacy names, both return the short commit id (empty in a source checkout)

Examples

virtual{version:aa}
Expected(the ActionApps version, for example 2026.10)
Actual2026.10
The bare ActionApps version string. Changes with each release, so it is install-dependent (shown here as the value this install returned).
virtual{version}
Expected(for example: ActionApps 2026.10 (source checkout), PHP 8.4.27)
ActualActionApps 2026.10 (source checkout), PHP 8.4.27
With no type you get the full string. It shows the exact PHP version, so use it in admin diagnostics rather than on public pages. Until November 2026 it also ended with the visitor IP address.
virtual{version:full}
Expected(the same string as with no type)
ActualActionApps 2026.10 (source checkout), PHP 8.4.27
Passing full explicitly is the same as the default. Any unrecognised type value also falls back to this full string.
virtual{version:php}
Expected(the PHP version, for example 8.4.27)
Actual8.4.27
The PHP version running the server. Install-dependent.
virtual[{version:build}]
Expected(for example [1a2b3c4 2026-10-30 14:05] on a built release; [] in a source checkout)
Actual[]
The git commit and its date, the same stamp the full string shows in parentheses. A tree checked out straight from the source repository, like this development install, has no stamp and prints nothing.
virtual{version:svn}
Expected(the short git commit id of the build, for example 1a2b3c4; empty in a source checkout)
svn used to print the SVN revision. Since the move to git it prints the short commit id of the build, so old templates keep working.
test{ifeq:{version:svn}:{version:svn2}:same:different}
Expectedsame
Actualsame
svn2 used to run svnversion over the whole tree. Both legacy names now return the same commit id, on every install.
test{ifeq:{version:AA}:{version}:same:different}
Expectedsame
Actualsame
Any type the command does not know - including a wrong case such as AA - falls back to the full string, so a typo does not give an error.
virtualRunning ActionApps {version:aa} on PHP {version:php}
Expected(for example: Running ActionApps 2026.10 on PHP 8.4.27)
ActualRunning ActionApps 2026.10 on PHP 8.4.27
A common real-world use: an admin diagnostics line naming the ActionApps and PHP versions. On a public footer prefer the aa version alone.