aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/smarty/smarty/docs/programmers/api-functions/api-display.md
blob: 59726195e8eab42b553356742b2fead5a39d2279 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
display()

displays the template

Description
===========

void

display

string

template

string

cache\_id

string

compile\_id

This displays the contents of a template. To return the contents of a
template into a variable, use [`fetch()`](#api.fetch). Supply a valid
[template resource](#resources) type and path. As an optional second
parameter, you can pass a `$cache_id`, see the [caching
section](#caching) for more information.

PARAMETER.COMPILEID


    <?php
    include(SMARTY_DIR.'Smarty.class.php');
    $smarty = new Smarty();
    $smarty->setCaching(true);

    // only do db calls if cache doesn't exist
    if(!$smarty->isCached('index.tpl')) {

      // dummy up some data
      $address = '245 N 50th';
      $db_data = array(
                   'City' => 'Lincoln',
                   'State' => 'Nebraska',
                   'Zip' => '68502'
                 );

      $smarty->assign('Name', 'Fred');
      $smarty->assign('Address', $address);
      $smarty->assign('data', $db_data);

    }

    // display the output
    $smarty->display('index.tpl');
    ?>

       

Use the syntax for [template resources](#resources) to display files
outside of the [`$template_dir`](#variable.template.dir) directory.


    <?php
    // absolute filepath
    $smarty->display('/usr/local/include/templates/header.tpl');

    // absolute filepath (same thing)
    $smarty->display('file:/usr/local/include/templates/header.tpl');

    // windows absolute filepath (MUST use "file:" prefix)
    $smarty->display('file:C:/www/pub/templates/header.tpl');

    // include from template resource named "db"
    $smarty->display('db:header.tpl');
    ?>

       

See also [`fetch()`](#api.fetch) and
[`templateExists()`](#api.template.exists).