{internal:class_name}

Description

Experimental extension hook. Dispatches to a named AA PHP class: it calls that class static internal_expand method, passing the current item content plus any extra colon-separated arguments. Used inside admin views to surface computed, non-stored values - for example a scheduled task next-run time, or a count of recent log entries. Three conditions must all hold: there is a current item, the class is already loaded in memory (no autoload is attempted), and the class defines a static internal_expand method. If any condition fails the command outputs the literal text qqq. Only a small set of internal classes implement this method (AA_Plannedtask and AA_Log); it is an admin-side mechanism, not a general content tag, and by design must never expose sensitive data. Because output depends on the live item and runtime state, results are never cached and are not guaranteed across versions.

Parameters

class_name required

Name of the AA PHP class to dispatch to. The class must already be loaded (no autoload is attempted) and must define a public static internal_expand method. If the class is missing or has no such method, the command outputs the literal text qqq.

param... optional

Zero or more extra colon-separated arguments passed on to internal_expand after the item content. The first argument usually selects the sub-operation (for example computedtime, scheduledto, count). Meaning and count depend on the target class.

Examples

virtual{internal:AA_Log:count:CSN:RSS:3600}

Expected(a number, e.g. 0)

Actual0

Dispatches to AA_Log::count: number of CSN-type log entries whose selector is RSS in the last 3600 seconds. Output depends on live log data, so this is illustrative, not a fixed test.

test[{internal:}]

Expected[qqq]

Actual[qqq]

An empty class name fails the class check the same way, so the fallback qqq is returned.

test[{internal:zids}]

Expected[qqq]

Actual[qqq]

zids is a real, loaded AA class but it has no static internal_expand method, so the command still falls back to qqq. Only classes that implement the method (AA_Plannedtask, AA_Log) produce real output.

virtual{internal:AA_Plannedtask:computedtime}

Expected(a date-time, e.g. 2026-06-04 12:00:00, or -- when not scheduled)

Actualqqq

Used inside the cron task admin list, where the current item is a planned task. Shows the task computed next-run time. Needs that admin context and live state, so it is illustrative.

test[{internal:NoSuchClass}]

Expected[qqq]

Actual[qqq]

When the named class is not loaded, the command outputs the literal text qqq. The brackets make the empty-vs-literal result visible.

← All expressions