aboutsummaryrefslogtreecommitdiffstats
path: root/include/smarty/README
blob: 13ff7609ca041d98903317dbc1badca7a2fb5ce4 (plain)
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
83
84
85
86
NAME:

    Smarty - the PHP compiling template engine

VERSION: 2.6.22

AUTHORS:
    
    Monte Ohrt <monte at ohrt dot com>
    Andrei Zmievski <andrei@php.net>

MAILING LISTS:

    We have a few mailing lists. "discussion" for you to share your ideas or ask
	questions, "developers" for those interested in the development efforts of Smarty,
	and "svn" for those that would like to track the updates made in the svn
	repository.

    send a blank e-mail message to:
      smarty-discussion-subscribe@googlecode.com(subscribe to the general discussion list)
      smarty-discussion-unsubscribe@googlecode.com (unsubscribe from the general discussion list)
      smarty-discussion-digest-subscribe@googlecode.com (subscribe to digest)
      smarty-discussion-digest-unsubscribe@googlecode.com (unsubscribe from digest)
      smarty-developers-subscribe@googlecode.com (subscribe to the dev list)
      smarty-developers-unsubscribe@googlecode.com (unsubscribe from the dev list)
      smarty-svn-subscribe@googlecode.com (subscribe to the svn list)
      smarty-svn-unsubscribe@googlecode.com (unsubscribe from the svn list)

    You can also browse the mailing list archives at
    http://groups.google.com/group/smarty-discussion
    http://groups.google.com/group/smarty-developers

    and the OLD list archives at
    http://marc.theaimsgroup.com/?l=smarty&r=1&w=2

SYNOPSIS:

    require("Smarty.class.php");

    $smarty = new Smarty;

    $smarty->assign("Title","My Homepage");
    $smarty->assign("Names",array("John","Gary","Gregg","James"));

    $smarty->display("index.tpl");


DESCRIPTION:

    What is Smarty?

    Smarty is a template engine for PHP. Many other template engines for PHP
    provide basic variable substitution and dynamic block functionality.
    Smarty takes a step further to be a "smart" template engine, adding
    features such as configuration files, template functions, and variable
    modifiers, and making all of this functionality as easy as possible to
    use for both programmers and template designers. Smarty also converts
    the templates into PHP scripts, eliminating the need to parse the
    templates on every invocation. This makes Smarty extremely scalable and
    manageable for large application needs.

    Some of Smarty's features:

    * it is extremely fast
    * no template parsing overhead, only compiles once.
	* it is smart about recompiling only the template files that have
	  changed.
    * the template language is remarkably extensible via the plugin
      architecture.
    * configurable template delimiter tag syntax, so you can use
      {}, {{}}, <!--{}-->, or whatever you like.
    * built-in caching of template output.
    * arbitrary template sources (filesystem, databases, etc.)
    * template if/elseif/else/endif constructs are passed to the PHP parser,
      so the if syntax can be as simple or as complex as you like.
    * unlimited nesting of sections, conditionals, etc. allowed
    * it is possible to embed PHP code right in your template files,
      although not recommended and doubtfully needed since the engine
      is so customizable.
    * and many more.

COPYRIGHT:
    Copyright (c) 2001-2005 New Digital Group, Inc. All rights reserved.
    This software is released under the GNU Lesser General Public License.
    Please read the disclaimer at the top of the Smarty.class.php file.