Get support for goetas/twital
If you're new to LTH, please see our FAQ for more information on what it is we do.
Support Options
Unfortunately, there are currently no active helpers for this repository on the platform. Until they become available, we reccomend the following actions:
View Open IssuesTake a look to see if anyone else has experienced the same issue as you and if they managed to solve it.
Open an IssueMake sure to read any relevant guidelines for opening issues on this repo before posting a new issue.
Sponsor directlyCheck out the page and see if there are any options to sponsor this project or it's developers directly.
goetas/twital
What is Twital?
Twital is a template engine built on top of Twig (a template engine for PHP and default template engine on Symfomy) that adds some shortcuts and makes Twig's syntax more suitable for HTML based (XML, HTML5, XHTML, SGML) templates. Twital takes inspiration from PHPTal, TAL and AngularJS or Vue.js (just for some aspects), mixing their language syntaxes with the powerful Twig templating engine system.
Twital is fully compatible with Twig, all Twig templates can be rendered using Twital.
To better understand the Twital's benefits, consider the following Twital template, which simply shows a list of users from an array:
<ul t:if="users">
<li t:for="user in users">
{{ user.name }}
</li>
</ul>
To do the same thing using Twig, you need:
{% if users %}
<ul>
{% for user in users %}
<li>
{{ user.name }}
</li>
{% endfor %}
</ul>
{% endif %}
As you can see, the Twital template is more readable, less verbose and and you don't have to worry about opening and closing block instructions (they are inherited from the HTML structure).
One of the main advantages of Twital is the implicit presence of control statements, which makes templates more readable and less verbose. Furthermore, it has all Twig functionalities, such as template inheritance, translations, looping, filtering, escaping, etc.
If some Twig functionality is not directly available for Twital, you can freely mix Twig and Twital syntaxes.
In the example below, we have mixed Twital and Twig syntaxes to use Twig custom tags:
<h1 t:if="users">
{% custom_tag %}
{{ someUnsafeVariable }}
{% endcustom_tag %}
</h1>
When needed, you can extend from a Twig template:
<t:extends from="layout.twig">
<t:block name="content">
Hello {{name}}!
</t:block>
</t:extends>
You can also extend from Twig a Twital template:
{% extends "layout.twital" %}
{% block content %}
Hello {{name}}!
{% endblock %}
A presentation of Twital features and advantages is available on this presentation.
Installation
The recommended ways install Twital is via Composer.
composer require goetas/twital
Documentation
Go here http://twital.readthedocs.org/ to read a more detailed documentation about Twital.
Getting started
First, you have to create a file that contains your template
(named for example demo.twital.html
):
<div t:if="name">
Hello {{ name }}
</div>
Afterwards, you have to create a PHP script that instantiate the required objects:
require_once '/path/to/composer/vendor/autoload.php';
use Goetas\Twital\TwitalLoader;
$fileLoader = new Twig_Loader_Filesystem('/path/to/templates');
$twitalLoader = new TwitalLoader($fileLoader);
$twig = new Twig_Environment($twitalLoader);
echo $twig->render('demo.twital.html', array('name' => 'John'));
That's it!
Symfony Users
If you are a Symfony user, you can add Twital to your project using the TwitalBundle.
The bundle integrates all most common functionalities as Assetic, Forms, Translations, Routing, etc.
Twig Users
Starting from version Twital 1.0.0, both twig 1.x and 2.x versions are supported.
Note
The code in this project is provided under the MIT license. For professional support contact goetas@gmail.com or visit https://www.goetas.com
Our Mission
We want to make open source more sustainable. The entire platform was born from this and everything we do is in aid of this.
From the Blog
Interesting Articles
-
Generating income from open source
Jun 23 • 8 min read
-
2023 State of OSS
Apr 23 • 45 min read ★
-
A funding experiment...
Aug 19 • 10 min read
-
But You Said I could
Aug 19 • 2 min read
Thank you for checking out LiveTechHelper |
2025 © lth-dev incorporated
p-e622a1a2