Twig Functions & Filters

PteroCA provides custom Twig functions and filters available in all theme templates (panel, landing, and email contexts). These are defined in the core Twig extensions and can be used in any template.

Global Functions

get_currency()

Returns the configured internal currency name (e.g., "USD", "EUR").

{{ get_currency() }}
{# Output: USD #}

Returns: string Throws: Exception if internal currency is not configured.

---

get_default_theme_colors()

Returns the default theme colors for light and dark mode.

{% set colors = get_default_theme_colors() %}
{{ colors['default_theme_light_mode_color'] }}
{{ colors['default_theme_dark_mode_color'] }}

Returns: array — associative array with light and dark mode color setting values.

---

get_app_version()

Returns the current PteroCA application version.

<footer>PteroCA v{{ get_app_version() }}</footer>
{# Output: PteroCA v0.6.3 #}

Returns: string

---

get_logo()

Returns the path to the site logo. If a custom logo has been uploaded in settings, returns the uploaded logo path; otherwise returns the default logo.

<img src="{{ get_logo() }}" alt="Logo">

Returns: string — URL path (e.g., /uploads/settings/logo.png or /assets/img/logo/logo.png).

---

get_favicon()

Returns the path to the site favicon. If a custom favicon has been uploaded, returns the uploaded path; otherwise returns the default.

<link rel="icon" href="{{ get_favicon() }}">

Returns: string — URL path (e.g., /uploads/settings/favicon.ico or /assets/img/favicon/favicon.ico).

---

get_title()

Returns the configured site title.

<title>{{ get_title() }}</title>

Returns: string

---

get_site_url()

Returns the configured site URL.

<a href="{{ get_site_url() }}">Home</a>

Returns: string

---

show_email_verification_alert()

Returns whether the email verification alert should be shown. True when email verification is set to "required" or "optional" in settings.

{% if show_email_verification_alert() %}
    <div class="alert alert-warning">Please verify your email address.</div>
{% endif %}

Returns: bool

---

get_captcha_site_key()

Returns the Google reCAPTCHA site key if captcha is enabled, or null if disabled.

{% set captcha_key = get_captcha_site_key() %}
{% if captcha_key %}
    <div class="g-recaptcha" data-sitekey="{{ captcha_key }}"></div>
{% endif %}

Returns: string|null

---

use_pterodactyl_panel_as_client_panel()

Returns whether PteroCA is configured to redirect users to the Pterodactyl panel instead of using its own client area.

{% if use_pterodactyl_panel_as_client_panel() %}
    <a href="{{ get_pterodactyl_panel_url() }}">Go to Panel</a>
{% endif %}

Returns: bool

---

get_pterodactyl_panel_url(path)

Returns the Pterodactyl panel URL, optionally appending a path.

<a href="{{ get_pterodactyl_panel_url('/server/' ~ server.id) }}">Manage in Pterodactyl</a>

Parameter	Type	Default	Description
path	string	''	Path to append to the panel URL

Returns: string

---

is_pterodactyl_sso_enabled()

Returns whether Pterodactyl SSO (Single Sign-On) is enabled.

{% if is_pterodactyl_sso_enabled() %}
    <a href="{{ path('sso_redirect') }}">Login via Pterodactyl</a>
{% endif %}

Returns: bool

---

is_manage_in_pterodactyl_button_enabled()

Returns whether the "Manage in Pterodactyl" button should be shown on server pages.

{% if is_manage_in_pterodactyl_button_enabled() %}
    <a href="{{ get_pterodactyl_panel_url('/server/' ~ server.uuid) }}" class="btn btn-primary">
        Manage in Pterodactyl
    </a>
{% endif %}

Returns: bool

---

template_asset(path)

Resolves an asset path relative to the current theme's assets directory. The resulting path follows the pattern /assets/theme/{current-theme}/{path}.

<link rel="stylesheet" href="{{ template_asset('css/main.css') }}">
<script src="{{ template_asset('js/app.js') }}"></script>
<img src="{{ template_asset('images/logo.svg') }}" alt="Logo">

Parameter	Type	Description
path	string	Relative path within the theme's assets directory

Returns: string — full public URL to the asset.

---

get_current_template_options()

Returns the current template's configuration options as a TemplateOptionsDTO object, parsed from the theme's template.json file.

{% set options = get_current_template_options() %}
{{ options.name }}
{{ options.version }}

Returns: TemplateOptionsDTO

---

plugin_asset(pluginName, path)

Resolves an asset path for a specific plugin's assets.

<link rel="stylesheet" href="{{ plugin_asset('my-plugin', 'css/styles.css') }}">
<script src="{{ plugin_asset('my-plugin', 'js/app.js') }}"></script>

Parameter	Type	Description
pluginName	string	The plugin identifier
path	string	Relative path within the plugin's assets directory

Returns: string — full public URL to the plugin asset.

---

get_custom_head_scripts(context)

Returns custom head scripts configured in settings for the given context.

{% set scripts = get_custom_head_scripts('panel') %}
{% if scripts %}
    {{ scripts|raw }}
{% endif %}

Parameter	Type	Default	Description
context	string	'panel'	Either 'panel' or 'landing'; any other value defaults to 'panel'

Returns: string|null

---

get_price_separators()

Returns the configured decimal and thousands separators for price formatting.

{% set separators = get_price_separators() %}
{# separators.decimal, separators.thousands #}

Returns: array — with keys decimal and thousands.

Filters

format_bytes

Converts a byte count into a human-readable string (e.g., KB, MB, GB).

{{ server.memory|format_bytes }}
{# Output: 1.50 GB #}

{{ server.disk|format_bytes }}
{# Output: 25.00 GB #}

Parameter	Type	Default	Description
precision	int	2	Number of decimal places

---

app_date

Formats a DateTimeInterface value using the application's configured date format.

{{ server.expiresAt|app_date }}
{# Output depends on configured format, e.g.: 2026-03-15 14:30 #}

---

format_price

Formats a numeric price value using the application's configured price format (decimal and thousands separators).

{{ product.price|format_price }}
{# Output: 9.99 #}

{{ order.total|format_price }}
{# Output: 1,234.56 #}

Server Permission Functions

These functions are available in server-related templates to check Pterodactyl server permissions for the current user. They operate on a ServerPermissionCollection object.

hasServerPermission(permissionCollection, permission)

Checks if the user has a specific server permission.

{% if hasServerPermission(permissions, 'control.start') %}
    <button>Start Server</button>
{% endif %}

Parameter	Type	Description
permissionCollection	ServerPermissionCollection|null	The permission collection
permission	string	The permission to check (e.g., 'control.start')

Returns: bool

---

hasAllServerPermissions(permissionCollection, permissions)

Checks if the user has all of the specified permissions.

{% if hasAllServerPermissions(permissions, ['control.start', 'control.stop', 'control.restart']) %}
    <div class="power-controls">...</div>
{% endif %}

Parameter	Type	Description
permissionCollection	ServerPermissionCollection|null	The permission collection
permissions	string[]	Array of permissions to check

Returns: bool

---

hasAnyServerPermission(permissionCollection, permissions)

Checks if the user has any of the specified permissions.

{% if hasAnyServerPermission(permissions, ['backup.create', 'backup.delete']) %}
    <a href="#">Backups</a>
{% endif %}

Parameter	Type	Description
permissionCollection	ServerPermissionCollection|null	The permission collection
permissions	string[]	Array of permissions to check

Returns: bool

---

hasServerPermissionInCategory(permissionCollection, category)

Checks if the user has any permission within a given category.

{% if hasServerPermissionInCategory(permissions, 'database') %}
    <a href="#">Databases</a>
{% endif %}

Parameter	Type	Description
permissionCollection	ServerPermissionCollection|null	The permission collection
category	string	The permission category (e.g., 'control', 'database', 'backup')

Returns: bool

---

hasAllServerPermissionsInCategory(permissionCollection, category)

Checks if the user has all permissions within a given category.

{% if hasAllServerPermissionsInCategory(permissions, 'file') %}
    <span class="badge">Full File Access</span>
{% endif %}

Parameter	Type	Description
permissionCollection	ServerPermissionCollection|null	The permission collection
category	string	The permission category

Returns: bool

Security Filters

safe_html

Sanitizes HTML content using Symfony's HtmlSanitizer, removing potentially dangerous elements while preserving safe HTML markup.

{{ product.description|safe_html }}
{{ page.content|safe_html }}

This filter is safe for HTML output (marked with is_safe: ['html']), so the sanitized result is rendered as HTML. Use this instead of |raw when displaying user-provided HTML content.

Returns: string — sanitized HTML. Returns empty string if input is null or empty.

Related Guides

• Twig Guide - General Twig templating guide

• Theme Structure - File organization

• Styling - CSS organization and best practices

• Overriding Templates - Customize specific templates