English
资源说明：Simplate is a simple PHP template engine to seprate application logic and content from its presentation.
#{@Simplate}
---
### What is Simplate?
Simplate (Simple Template) is a simple PHP template engine to seprate application logic and content from its presentation.
#### Why another PHP template engine?
Well, I created Simplate for my own project, but decided to share with everyone.
I was also tired of all those bloated PHP template system, with steep learning curve that create another language on top of PHP. Really?!
So this one is smaller, it consists of one PHP file. It is not bloated and contains some useful methods and tricks. And above all, it's damn simple.
#### And who created it?
Me. Mardix. You can follow me [@mardix](http://twitter.com/mardix), or check out my github: [mardix.github.com](http://mardix.github.com/) to check out some of my other code that you may want to fork.
So Holla!
---
## {@Simplate for Developers}
Simplate use PHP 5.3 or later, and can be extended for your needs. But by default it comes with everything you need.
On the PHP side, developer can assign variables, include templates, create loops, create embeded loops, create filters etc...
#### Public methods
>***setDir($dirPath)*** : to set the root dir
>***assign($key,$value)*** : to assign variables.
>***assignJSON($key,$Arrayvalue)*** : to assign and array that will be passed as JSON
>***addFile($tplName,$filename)***: To add a template file that will be include with the tag ` `
>***stripComments(bool)***: to strip all HTML comments from the page. You can also use `` to do conditional statements, loops, include, macros and more.
To keep Simplate markup tags consisitent with HTML, Simplate use opening and close tags like the following
` ` or `` ``
Conditional statement allow to make some test before executing some piece of code. It can be use to include, show parts of data
Let's say we assign a variable called Number as 7 -> `Simplate::assign("Number",7);`
``
> `Will execute this part if Number is an odd number`
>``
>`Will execute if Number == 4`
>``
>`All failed show this piece`
` `
#### Built-in conditional test
The built in condition return true when test pass.
>***.is(number|string)*** or ***equals(number|string)*** : To test the equality
>***.not(number|string)*** : inequality
>***.null()*** or ***empty()*** : Test if null
>***.startsWith(val)*** : if starts with val
>***.endsWith(val)*** : if ends with val
>***.match(val)*** : if contains val
>***.even()*** : if a number is even
>***.odd()*** : if a number is odd
>***.gt(number)*** if it's greater than number
>***.gte(number)*** if it's greater than or equals number
>***.lt(number)*** if it's lesser than number
>***.lte(number)*** if it's lesser than or equals number
But you can force a conditional statement to be negative by adding ! in front of it.
Let's say the Number is 7, so it's an odd number. We can negate a test like the following
>``
Which means, test if Number is not odd.
### Each loop ``
It allows to loop over an array set on the PHP side with `Simplate::each("eachName",Array)`
``
>`{@Name}`
` `
### InEach loop ``
It allows to loop over an array set on the PHP side with `Simplate::each("eachName",Array)`, where there is a key that was itself and each with the key name ineachName
``
>`{@Name}`
>``
>>`{@Name}`
>` `
` `
@TODO: more doc
#### Macros
Macros are instruction from the template that will execute some commands on the PHP such as show errors, return data as JSON
@TODO: more doc
Please refer to the example directory for examples
[@mardix](http://twitter.com/mardix)
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
