[Milen]

In XenForo 2 , <xf:if> is a conditional template tag that is used to check a condition in XenForo templates. It allows for dynamically showing or hiding elements based on certain logic.

Syntax​

<xf:if is="$condition">
    <!-- The code here will be executed if the condition is true -->
</xf:if>

It can also contain <xf:else /> if you want to display something else on false :

<xf:if is="$condition">
    <!-- Code if condition is true -->
<xf:else />
    <!-- Code if condition is false -->
</xf:if>

Usage examples​

Example 1: Checking if the user is logged in to their account​

<xf:if is="$xf.visitor.user_id">
    <p>Hello, {$xf.visitor.username}!</p>
<xf:else />
    <p>Please <a href="{{ link('login') }}">log in</a> to your account.</p>
</xf:if>

Explanation:

• $xf.visitor.user_id checks if there is a logged in user.
• If there is, it shows "Hello, {username}!"
• If not, it shows a login link.

Example 2: Checking if the user is an administrator

<xf:if is="$xf.visitor.is_admin">
    <p>You are the administrator!</p>
</xf:if>

Explanation:

• $xf.visitor.is_admin returns true if the user is an admin.

Example 3: Checking a user group

<xf:if is="in_array(3, $xf.visitor.user_group_ids)">
    <p>You are part of the VIP group!</p>
</xf:if>

Explanation:

• in_array(3, $xf.visitor.user_group_ids) checks if the user is in a group with ID 3 .

Example 4: Show a button only if the user has permissions for a given action

<xf:if is="$xf.visitor.hasPermission('forum', 'postThread')">
    <a href="{{ link('forums/post-thread') }}" class="button">Create a new topic</a>
</xf:if>

Explanation:

• $xf.visitor.hasPermission('forum', 'postThread') checks if the user has permission to create threads.

Example 5: Checking a value in a variable

<xf:set var="$showMessage" value="1" />

<xf:if is="$showMessage">
    <p>This message is displayed.</p>
</xf:if>

Explanation:

• With <xf:set> we set the value of $showMessage = 1.
• <xf:if> checks if $showMessage is true (other than 0, false, or empty ).

---

⚠ Important:​

1. <xf:if> does not support complex logical operators directly – &&, || and ! should be used only for simple checks.
2. If you have complex conditions , it is recommended to process them in PHP code and pass them as a variable in the template.
3. Nested <xf:if> are allowed , but use them carefully to avoid complicating your code.