mirror of
				https://github.com/smarty-php/smarty.git
				synced 2025-11-03 22:01:36 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			50 lines
		
	
	
		
			1.8 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			50 lines
		
	
	
		
			1.8 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
# {append}
 | 
						|
 | 
						|
`{append}` is used for creating or appending template variable arrays
 | 
						|
**during the execution of a template**.
 | 
						|
 | 
						|
## Attributes
 | 
						|
 | 
						|
| Attribute | Required   | Description                                                                                        |
 | 
						|
|-----------|------------|----------------------------------------------------------------------------------------------------|
 | 
						|
| var       |            | The name of the variable being assigned                                                            |
 | 
						|
| value     |            | The value being assigned                                                                           |
 | 
						|
| index     | (optional) | The index for the new array element. If not specified the value is append to the end of the array. |
 | 
						|
| scope     | (optional) | The scope of the assigned variable: parent, root or global. Defaults to local if omitted.          |
 | 
						|
 | 
						|
## Option Flags
 | 
						|
 | 
						|
| Name    | Description                                         |
 | 
						|
|---------|-----------------------------------------------------|
 | 
						|
| nocache | Assigns the variable with the 'nocache' attribute   | 
 | 
						|
 | 
						|
> **Note**
 | 
						|
>
 | 
						|
> Assignment of variables in-template is essentially placing application
 | 
						|
> logic into the presentation that may be better handled in PHP. Use at
 | 
						|
> your own discretion.
 | 
						|
 | 
						|
## Examples
 | 
						|
 | 
						|
```smarty
 | 
						|
{append var='name' value='Bob' index='first'}
 | 
						|
{append var='name' value='Meyer' index='last'}
 | 
						|
// or 
 | 
						|
{append 'name' 'Bob' index='first'} {* short-hand *}
 | 
						|
{append 'name' 'Meyer' index='last'} {* short-hand *}
 | 
						|
 | 
						|
The first name is {$name.first}.<br>
 | 
						|
The last name is {$name.last}.
 | 
						|
```
 | 
						|
      
 | 
						|
The above example will output:
 | 
						|
 | 
						|
 | 
						|
    The first name is Bob.
 | 
						|
    The last name is Meyer.
 | 
						|
 | 
						|
      
 | 
						|
 | 
						|
See also [`append()`](#api.append) and
 | 
						|
[`getTemplateVars()`](#api.get.template.vars).
 |