PHPackages                             youcanshop/liquid - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Templating & Views](/categories/templating)
4. /
5. youcanshop/liquid

ActiveLibrary[Templating & Views](/categories/templating)

youcanshop/liquid
=================

Liquid template engine for themes.

v2.0.0(2mo ago)17.3k↓35.7%MITPHPPHP ^7.4 || ^8.0CI passing

Since Nov 17Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/youcan-shop/liquid)[ Packagist](https://packagist.org/packages/youcanshop/liquid)[ Docs](https://github.com/youcan-shop/liquid)[ RSS](/packages/youcanshop-liquid/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (7)Versions (8)Used By (0)

Liquid template engine for PHP [![CI](https://github.com/kalimatas/php-liquid/actions/workflows/tests.yaml/badge.svg)](https://github.com/kalimatas/php-liquid/actions/workflows/tests.yaml) [![Coverage Status](https://camo.githubusercontent.com/a9ff94064ab5197f0b7690647965a449e1924c58699b61d1e6276318b7fb004c/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6b616c696d617461732f7068702d6c69717569642f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/kalimatas/php-liquid?branch=master) [![Total Downloads](https://camo.githubusercontent.com/b0d4f3703e5d137139614ad6cb916f64bd178c1b6a7d2c6f38a74a0203255753/68747470733a2f2f706f7365722e707567782e6f72672f6c69717569642f6c69717569642f646f776e6c6f6164732e737667)](https://packagist.org/packages/liquid/liquid)
================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#liquid-template-engine-for-php---)

A PHP version of Ruby's Liquid Template Engine for YouCan Shop theme development.
 Liquid allows you to create flexible and dynamic themes for [e-commerce stores](https://youcan.shop/en).

Why Use Liquid?
---------------

[](#why-use-liquid)

- Seperate compiling and rendering stages for improved performance.
- Simple syntax for creating dynamic templates.
- Create reusable components

Installation
------------

[](#installation)

Install via Composer:

```
composer require liquid/liquid
```

### Example Usage

[](#example-usage)

```
require 'vendor/autoload.php';
use Liquid\Template;

$template = new Template();
$template->parse('Hello, {{ name }}!');
echo $template->render(['name' => 'world']);
```

Creating YouCan Themes
----------------------

[](#creating-youcan-themes)

Liquid uses a combination of [objects](https://developer.youcan.shop/themes/objects/introduction), [tags](https://developer.youcan.shop/themes/tags/if), and [filters](https://developer.youcan.shop/themes/filters/currency/money) inside template files to display dynamic content.

### What does it look like?

[](#what-does-it-look-like)

```
  {% if user %}
    Welcome back, {{ user.name }}!
  {% else %}
    Welcome to our store!
  {% endif %}

  {{ product.title }}
  {{ product.description }}
  Price: {{ product.price | money }}

```

1. **Output Tags `({{ }})`**: used to display content.
2. **Logic Tags `({% %})`**: used to perform actions such as conditions and loops.
3. **Filters `(|)`**: used to format the output of variables
4. **Variables**: used to store data that can be rendered in templates.

For more information, visit the [YouCan Theme Documentation](https://developer.youcan.shop/themes/introduction).

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance88

Actively maintained with recent releases

Popularity25

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 91.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~213 days

Total

5

Last Release

61d ago

Major Versions

v1.1.2 → v2.0.02026-03-18

PHP version history (2 changes)v1.0.0PHP ^7.4 || ^8.2

v2.0.0PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/4e77e863a88494fe41ab35f0d3fa40d08172040ea801aa558672af608da4e1e1?d=identicon)[Whyounes](/maintainers/Whyounes)

---

Top Contributors

[![azuradara](https://avatars.githubusercontent.com/u/95413644?v=4)](https://github.com/azuradara "azuradara (11 commits)")[![salouakd](https://avatars.githubusercontent.com/u/155442357?v=4)](https://github.com/salouakd "salouakd (1 commits)")

---

Tags

templateliquidyoucan

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/youcanshop-liquid/health.svg)

```
[![Health](https://phpackages.com/badges/youcanshop-liquid/health.svg)](https://phpackages.com/packages/youcanshop-liquid)
```

###  Alternatives

[phpoffice/phpword

PHPWord - A pure PHP library for reading and writing word processing documents (OOXML, ODF, RTF, HTML, PDF)

7.6k34.7M186](/packages/phpoffice-phpword)[rize/uri-template

PHP URI Template (RFC 6570) supports both expansion & extraction

420137.3M46](/packages/rize-uri-template)[liquid/liquid

Liquid template engine for PHP

1854.8M25](/packages/liquid-liquid)[simexis/laravel-liquid

Liquid template engine for Laravel

181.5k](/packages/simexis-laravel-liquid)[larablocks/pigeon

A more flexible email message builder for Laravel 5 including chained methods, reusable message configurations, and message layout and template view management.

143.7k](/packages/larablocks-pigeon)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)