``` * **Badges:** **`openBadge({{ badge.id }})`** ```html Example:

``` **⚠️For Missions and Badges, you will need to specify the type:** ``` {% assign missions = missions | where: "type", 'mission' %} {% assign badges = badges | where: "type", 'badge' %} ``` * **Store: `openStore({{ item.id }})`** ```html Example:

``` * **Levels: `openLevel({{level.id}})`** ```html Example:

``` * **Bonuses: `openBonus({{ bonus.bonus_id }})`** ```html Example:

``` * **Tournaments: `openTournament({{ tournament.instance_id}})`** ```html Example:

``` * **Tournament Instance: `tournamentOptIn({{ tournament.instance_id }})`** ```html {% assign tournament = singleTournament %} {% assign user_registered = tournament.is_user_registered %}

{% if user_registered %} You are registered {% else %} Join tournament {% endif %}

``` This allows you to show only one specific tournament and makes it easy to highlight only the tournament leaderboard, prize pool, or related games, or a combination of all of them. **How it works:** * Select ‘Tournament Instance’ – Choose the newly added entity data called ‘Tournament instance’. * Select the Tournament – Once a tournament is selected, the system automatically chooses the appropriate run based on the status of the run: * **Started:** The highest priority run is selected. * **Open for registration:** If no run is in the 'Started' status, the run with the 'Open for registration' status will be displayed. * **Last finished:** If there are no Started or Open for registration runs, the last finished run is used. * **Both Started and Open for registration exist:** The Started run takes priority. * **Mini-games: `openMiniGame({{ game.id }})`** ```html Example:

``` * **Jackpots: `openJackpot({{ jackpot.jp_template_id }})`** ```html Example:

``` * **Raffles: `openRaffle({{ raffle.id }})`** ```html Example:

{% assign myRaffles = raffles %} {% for r in myRaffles limit: 3 %}

{% endfor %}

``` ```html Show only specific Raffle: {% assign section_raffles_123 = raffles | where: "custom_section_id", 123 %} ``` * **Raffle Instance: `raffleDrawOptIn({{ draw.id }})`** ```html Example:

Single Raffle

{% assign raffle = singleRaffle %}

{% if raffle.description %}

{% endif %}

Max tickets count: {{ raffle.max_tickets_count }}

{% assign sorted_draws = raffle.draws | sort: "execution_ts" %}

Raffle draws

{% for draw in sorted_draws %} {% assign user_optedIn = draw.user_opted_in %}

{% if draw.requires_optin %}

{% if user_optedIn %} Opted in {% else %} Opt in {% endif%}

{% endif%}

{% endfor %}

``` ### Liquid Params Liquid Params is a parameter for deep links used in Liquid Custom Sections. This allows you to pass custom parameters via deep links and access them directly inside your Liquid code. Example of deep-link using `liquidParams:` * `dp:gf_section&id=123&liquidParams={"instance_id":21,"register":true}` This deep link opens the tournament with ID 21 and automatically registers the user. You can find more deep link examples in the deep link [documentation.](https://help.smartico.ai/welcome/products/general-concepts/deep-links#list-of-deep-links-supported-out-of-the-box) The liquidParams object is parsed and exposed inside the Liquid custom section. It is available in raw Liquid data -> **‘Show data source’** and in the liquid code. You can pass different parameters such as `"instance_id": 704519, "section": "players"` . Use the following script in your Liquid code to read and apply these parameters: {% hint style="info" %} * For newly created Liquid Custom Sections, this script is added automatically, so no action is needed. * For existing Liquid Custom Sections, you’ll need to add the script manually to the Liquid code. {% endhint %} ```html ``` ### **Deep link usage:** You can trigger deep links using the dp() function in HTML elements like buttons: ```html ``` You can see all deep links [here](https://help.smartico.ai/welcome/products/general-concepts/deep-links) ### **Client action usage in the Liquid section:** You can configure a 'Client action' event to trigger, for example, an automation rule and give points/games to the players. ```html clientAction(actionValue, payload) where actionValue is a string (name of the action) payload - object, you can pass anything you want here Example in HTML:

Click here

``` Read more about 'Client action' event [here](https://help.smartico.ai/welcome/products/general-concepts/client-action-event) ### Smartico API usage in the Liquid section: You can access the Smartico API directly within Liquid Custom Sections. This allows you to build a fully customized UI for gamification features, including mini-games, missions, badges, tournaments, and in-store items. By leveraging the API within your Liquid code, you have complete creative control over how these features are presented and integrated into your site. API documentation: ```javascript try { const miniGames = await _smartico.api.getMiniGames(); console.log('MiniGames:', miniGames); const profile = await _smartico.api.getUserProfile(); console.log('Profile:', profile); const tournaments = await _smartico.api.getTournamentsList(); console.log('Tournaments:', tournaments); const tournamentInstanceInfo = await _smartico.api.getTournamentInstanceInfo(707553); console.log("tournamentInstanceInfo", tournamentInstanceInfo); const storeItemsHistory = await _smartico.api.getStorePurchasedItems({limit: 20, offset: 0}); console.log("storeItemsHistory", storeItemsHistory); const miniGamesHistory = await _smartico.api.getMiniGamesHistory({limit: 20, offset: 0}); console.log("miniGamesHistory", miniGamesHistory); } catch (err) { console.error('API error:', err); } ```