Liquid Tags: Insites

The following code will run all the log queries in the background, not earlier than 0.5 minute (30 seconds) since the execution. You will only have access to variables
explicitly provided to the background tag: "data" and "hey". Note that you will not have access to the "my_data" variable. Also note
that the result of this background tag will not be rendered, and you will not have access to any variable inside the background tag.

{% assign my_data = { "hello": "world" } %}
{% assign not_available_in_background = "You will not see me" %}
{% background priority: "low", delay: 0.5, max_attempts: 3, source_name: "my custom job", data: my_data, hey: "hello" %}
  {% log not_available_in_background %} {% comment %}Will be null, as this variable was not passed to the background tag {% endcomment %}
  {% log data %} {% comment %}You will see { "hello": "world" }, as it was provided to the background tag{% endcomment %}
  {% log hey %} {% comment %}You will see "hello" as it was provided to the background tag{% endcomment %}
  {% log context %} {% comment %}You will copy the current request context and make it available in the background{% endcomment %}
  {% assign not_available_outside = "You will not see me" %}
  {{ not_available_outside }} {% comment %}This variable will be rendered in the background, meaning you won't see anything on the page{% endcomment %}
{% endbackground %}
{{ not_available_outside }} {% comment %}This will be blank, because the assign will happen in the background - you won't have access to it here{% endcomment %}

{% cache "this is my key", expire: 20 %}

    {% for i in (1..100) %}
      {{ 18 | random_string }}
    {% endfor %}

{% endcache %}

{%- capture pagesUpdatedAtJson -%}
  {%- cache pagesUpdatedAtCache -%}
    {%- graphql g = "pages_updated_at" | hash_dig: "admin_pages", "results" -%}
    {{- g | json -}}
  {%- endcache -%}
{%- endcapture -%}
{%- assign pagesUpdatedAt = pagesUpdatedAtJson | parse_json -%}
{%- export pagesUpdatedAt, namespace: "nav" -%}

{% content_for "header" %}
  Hello world
{% endcontent_for %}

{% context language: "de" %}

{% liquid
  assign a = "value for a"
  assign b = "value for b"
  export a, b, namespace: "my_hash"
%}

{{ context.exports.my_hash }} => { "a": "value for a", "b": "value for b" }
{% assign company = {
  "name": "Insites",
  "technologies": ["liquid", "graphql"],
  "countries": { "USA": 5, "Poland": 5, "Romania": 2 }
} %}

{% export company, namespace: "data" %}

{{ context.exports.data }} =>
  {"company"=>{"name"=>"Insites", "technologies"=>["liquid", "graphql"], "countries"=>{"USA"=>5, "Poland"=>5, "Romania"=>2}}}
{{ context.exports.data.company.technologies }} => liquidgraphql
{{ context.exports.data.company.name }} => Insites

{% form %}
  {{ form_builder }}
{% endform %}

{% form html-id: "someid", html-novalidate: true, html-class: "big-form green-form", html-data-user-id: "12345", html-multipart: false %}
{% endform %}

{% function res = "path/to/my/partial", arg1: "hello" %}

# path/to/my/partial
{% liquid
  assign res = "hello" | append: foo | append: " " | append: context.location.host
  return res
%}
# path/to/my/partial

{% liquid
  assign foo = "hello"
  function res = "path/to/my/partial", foo: foo, context: context
%}

Invoke query "get_records" and store the result in variable "g":
{% graphql g = "get_records", record_id: context.params.slug2 %}

Chain filters to extract results in one line:
{% graphql g = "get_records", record_id: context.params.slug2 | hash_fetch: "records" | hash_fetch: "results" %}

Pass all arguments at once as a hash to have graphql tag in one line and/or compose arguments hash dynamically:
{% assign arguments = {
  "record_id": context.params.slug2,
  "user_id": context.params.user_id
} %}

{% graphql g = "get_records", args: arguments %}

Pass all arguments at once as a JSON string:

{% capture arguments %}
{
   "per_page": 20,
   "page": 2
}
{% endcapture %}

{% graphql g = "get_records", args: arguments %}

Invoke inline query and store the result in variable "g". This is recommended for one-time used queries.

{% graphql g, id: context.params.slug2, message: "new message" %}
  mutation set_message($id: ID!, $message: String!) {
    record_update(
      id: $id
      record: {
        table: "message"
        properties: [{ name: "message", value: $message }]
      }
    ) {
      id
      message: property(name: "message")
    }
  }
{% endgraphql %}

{% include_form "signup_form" %}

{% include_form "edit_user", id: user.id %}

{% include_form "manager_invite_to_interview", parent_resource_id: "invitation", user: g.user %}

{% log "hello world" %}

{% log params, type: "request-params" %}

{% log user.id, type: "debug" %}

{% log context.current_user, type: "error" %}

{% log context.current_user, type: "error", env: "staging" %}

{% assign data = response.body | parse_json %}
{{ data.id }}

{% assign car = { "type": "SUV", "gearbox": "AT" } %}

{{ car }} => {"type"=>"SUV", "gearbox"=>"AT"}
{{ car.type }} => SUV

{% assign cars = [
  { "maker": "Honda", "model": "CRX" },
  { "maker": "Subaru", "model": "Forester" },
  { "maker": "Lexus", "model": "LFA" }
] %}

{% assign color = "red" %}
{% assign car = 'Mazda "5"' %}
{% assign data = { "color": color, "car": car, "nested": { "price": 100 } } %}

{{ data }} => {"color":"red","car":"Mazda \"5\"","nested":{"price":100}}

{% liquid
  assign invokable_script = '<script>alert("I will be executed")</script>'
  assign malicious_script = '<script>alert("I should be escaped")</script>'
%}
{% capture result %}
  {{ malicious_script }}{{ invokable_script | html_safe }}
{% endcapture %}
{% print result %}

{% redirect_to "/dashboard" %}

{% redirect_to "https://example.com/signup" %}

{% redirect_to "/dashboard", status: 301 %}

{% response_headers '{"foo": "bar"}' %}

{% response_headers '{"Content-Type": "application/json", "X-Frame-Options": "somevalue"}' %}

{% response_status 204 %}

{% response_status 404 %}

{% liquid
  assign result = 1 | plus: 3
  return result
%}

{% session foo = "bar" %}
{{ context.session | json }} => { "foo": "bar" }

{% assign bar = "42" %}
{% session foo = bar %}
{{ context.session | json }} => { "foo": "42" }

{% session foo = null %}
{{ context.session | json }} => {}

{% session foo = blank %}
{{ context.session | json }} => {}

{% sign_in user_id: "12345" %}

{% form %}
  {% spam_protection "recaptcha_v2" %}
{% endform %}

{% form %}
  {% spam_protection "recaptcha_v3", action: "signup" %}
{% endform %}

{% form %}
  {% spam_protection "hcaptcha" %}
{% endform %}

theme_search_paths:
  - theme/{{ context.constants.MY_THEME | default: "custom" }}
  - theme/simple

When you render a partial using theme_render

{% theme_render_rc "product" %}

The system will try to render theme/custom/product, and if it does not exist, it will fallback to theme/simple/product (if it also does not exist, the missing partial error is raised)

{% transaction timeout: 5 %}
  {% graphql order = "orders/create", data: order_data %}
  {% if order.errors %}
    {% rollback %}
  {% endif %}
{% endtransaction %}

{% liquid
  transaction
    graphql order = "orders/create", data: order_data
    if order.errors
      rollback
    endif
  endtransaction
%}

{% liquid
  try
    include template_path
  catch err
    unless err.message contains "can't find partial"
      log err, type: "error when including template file"
    endunless
    include fallback_template_path
  endtry
%}

Use this in a liquid view first. Then you can use yield inside the layout (for example) or another subsequently rendered view, like below:
{% content_for "greeting" %}Hello world{% endcontent_for %}

# another_file.liquid
{% yield "greeting" %}