Download the PHP package bertptrs/marty without Composer
On this page you can find all versions of the php package bertptrs/marty. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download bertptrs/marty
More information about bertptrs/marty
Files in bertptrs/marty
Package marty
Short Description Smarty view renderer for the Mako framework
License MIT
Homepage http://bertptrs.nl/marty/
Informations about the package marty
Marty
Marty is a simple Smarty view renderer for the Mako framework.
Requirements
Marty has been tested on all current Mako versions. Any other version may work, but has not been tested. Unit tests are run against PHP 7.0 and up. Smarty 3 or 4 is required, but will be pulled in as part of the installation.
Installation
Marty can be added to your Mako project using composer! Just add it to your requirements
Usage
Once installed, you will need to add it to your packages list. You do
this by adding it to the "Web" packages. This is located in the file
app/config/application.php
.
This enables the Smarty View renderer for every view with the ".tpl" file extension.
Configuration
Configuration can be done by changing the marty::smarty
configuration.
Just refer to the Mako documentation on package
configuration
for details.
The configuration properties are as follows:
Configuration property | Type | Description | Default |
---|---|---|---|
smarty.templateDir | string | The location to find smarty templates. | Your app/views directory. |
smarty.compileDir | string | The location to store compiled templates. | A new directory smarty in your app/storage directory. |
smarty.pluginDirs | string[] | A list of directories to search for smarty plugins. | An empty array. |
Plugins
Marty supports the plugin structure offered by Smarty, and extends it to use the dependency injector offered by the Mako framework.
Plugin dirs can be added to the config. The structure for plugins can be found in the Smarty Documentation. Due to the fact that Mako resolves parameters by name, Smarty plugin parameters should have their names as specified in the documentation. This means that the parameters should be named as follows:
- Template functions:
- parameters should be named
$params
- The smarty template should be named
$template
- parameters should be named
- Modifiers:
- The input data should be named
$value
- Any other values will be stored in array
$params
in order.
- The input data should be named
- Block functions:
- Call parameters should be named
$params
- The block content should be named
$content
- The template reference should be named
$template
- The repetition flag should be named
$repeat
.
- Call parameters should be named
- Compiler functions:
- Call parameters should be named
$params
- The Smarty reference should be named
$smarty
- Call parameters should be named
As an example, we can build a small plugin that uses the I18n module of the framework.
Then, we can use your plugin like this:
Contributing
If there are any features in Smarty that cannot (easily) be used in the current package, or if there are Mako features that are hard to bind to Smarty, feel free to file an issue or a pull request.
Code style and such are ran using GrumPHP. Make sure that your files are in accordance to those rules.
All versions of marty with dependencies
smarty/smarty Version ^3 || ^4
mako/framework Version ^6.0 || ^7.0 || ^8.0