diff --git a/QUICK_START b/QUICK_START new file mode 100644 index 00000000..ac3982f2 --- /dev/null +++ b/QUICK_START @@ -0,0 +1,86 @@ +This is a simple guide to get Smarty setup and running quickly. The online +documentation includes a very thorough explanation of a Smarty installation. +This guide is meant to be a quick and painless way of getting Smarty working, +and nothing more. The guide assumes you are familiar with the UNIX system +environment. Windows users will need to make adjustments where necessary. + +INSTALL SMARTY LIBRARY FILES + +Copy the Smarty library files to your system. In our example, we place them in +/usr/local/lib/php/Smarty/ + +$> gtar -ztvf Smarty-2.6.7.tar.gz +$> cp -r Smarty-2.6.7/libs /usr/local/lib/php/Smarty + + +SETUP SMARTY DIRECTORIES + +You will need four directories setup for Smarty to work. These files are for +templates, compiled templates, cached templates and config files. You may or +may not use caching or config files, but it is a good idea to set them up +anyways. It is also recommended to place them outside of the web server +document root. The web server PHP user will need write access to the cache and +compile directories as well. + +In our example, the document root is /web/www.domain.com/docs and the +web server username is "nobody". We will keep our Smarty files under +/web/www.domain.com/smarty + +$> cd /web/www.domain.com +$> mkdir smarty +$> mkdir smarty/templates +$> mkdir smarty/templates_c +$> mkdir smarty/cache +$> mkdir smarty/configs +$> chown nobody:nobody smarty/templates_c +$> chown nobody:nobody smarty/cache +$> chmod 775 smarty/templates_c +$> chmod 775 smarty/cache + + +SETUP SMARTY PHP SCRIPTS + +Now we setup our application in the document root: + +$> cd /web/www.domain.com/docs +$> mkdir myapp +$> cd myapp +$> vi index.php + +Edit the index.php file to look like the following: + +assign('name', 'Ned'); +$smarty->display('index.tpl'); + +?> + + +SET SMARTY TEMPLATE + +$> vi /web/www.domain.com/smarty/templates/index.tpl + +Edit the index.tpl file with the following: + + + +Smarty + + +Hello, {$name}! + + + + + +Now go to your new application through the web browser, +http://www.domain.com/myapp/index.php in our example. You should see the text +"Hello Ned!" in your browser. + +Once you get this far, you can continue on to the Smarty Crash Course to learn +a few more simple things, or on to the documentation to learn it all.