diff options
Diffstat (limited to 'vendor/smarty/smarty/docs/appendixes')
| -rw-r--r-- | vendor/smarty/smarty/docs/appendixes/tips.md | 332 | ||||
| -rw-r--r-- | vendor/smarty/smarty/docs/appendixes/troubleshooting.md | 120 |
2 files changed, 0 insertions, 452 deletions
diff --git a/vendor/smarty/smarty/docs/appendixes/tips.md b/vendor/smarty/smarty/docs/appendixes/tips.md deleted file mode 100644 index b0ea40cc7..000000000 --- a/vendor/smarty/smarty/docs/appendixes/tips.md +++ /dev/null @@ -1,332 +0,0 @@ -Tips & Tricks {#tips} -============= - -Blank Variable Handling {#tips.blank.var.handling} -======================= - -There may be times when you want to print a default value for an empty -variable instead of printing nothing, such as printing ` ` so that -html table backgrounds work properly. Many would use an -[`{if}`](#language.function.if) statement to handle this, but there is a -shorthand way with Smarty, using the -[`default`](#language.modifier.default) variable modifier. - -> **Note** -> -> "Undefined variable" errors will show an E\_NOTICE if not disabled in -> PHP\'s [`error_reporting()`](&url.php-manual;error_reporting) level or -> Smarty\'s [`$error_reporting`](#variable.error.reporting) property and -> a variable had not been assigned to Smarty. - - - {* the long way *} - {if $title eq ''} - - {else} - {$title} - {/if} - - {* the short way *} - {$title|default:' '} - - - -See also [`default`](#language.modifier.default) modifier and [default -variable handling](#tips.default.var.handling). - -Default Variable Handling {#tips.default.var.handling} -========================= - -If a variable is used frequently throughout your templates, applying the -[`default`](#language.modifier.default) modifier every time it is -mentioned can get a bit ugly. You can remedy this by assigning the -variable its default value with the -[`{assign}`](#language.function.assign) function. - - - {* do this somewhere at the top of your template *} - {assign var='title' value=$title|default:'no title'} - - {* if $title was empty, it now contains the value "no title" when you use it *} - {$title} - - - -See also [`default`](#language.modifier.default) modifier and [blank -variable handling](#tips.blank.var.handling). - -Passing variable title to header template {#tips.passing.vars} -========================================= - -When the majority of your templates use the same headers and footers, it -is common to split those out into their own templates and -[`{include}`](#language.function.include) them. But what if the header -needs to have a different title, depending on what page you are coming -from? You can pass the title to the header as an -[attribute](#language.syntax.attributes) when it is included. - -`mainpage.tpl` - When the main page is drawn, the title of "Main Page" -is passed to the `header.tpl`, and will subsequently be used as the -title. - - - {include file='header.tpl' title='Main Page'} - {* template body goes here *} - {include file='footer.tpl'} - - - -`archives.tpl` - When the archives page is drawn, the title will be -"Archives". Notice in the archive example, we are using a variable from -the `archives_page.conf` file instead of a hard coded variable. - - - {config_load file='archive_page.conf'} - - {include file='header.tpl' title=#archivePageTitle#} - {* template body goes here *} - {include file='footer.tpl'} - - - -`header.tpl` - Notice that "Smarty News" is printed if the `$title` -variable is not set, using the [`default`](#language.modifier.default) -variable modifier. - - - <html> - <head> - <title>{$title|default:'Smarty News'}</title> - </head> - <body> - - - -`footer.tpl` - - - </body> - </html> - - - -Dates {#tips.dates} -===== - -As a rule of thumb, always pass dates to Smarty as -[timestamps](&url.php-manual;time). This allows template designers to -use the [`date_format`](#language.modifier.date.format) modifier for -full control over date formatting, and also makes it easy to compare -dates if necessary. - - - {$startDate|date_format} - - - -This will output: - - - Jan 4, 2009 - - - - - {$startDate|date_format:"%Y/%m/%d"} - - - -This will output: - - - 2009/01/04 - - - -Dates can be compared in the template by timestamps with: - - - {if $order_date < $invoice_date} - ...do something.. - {/if} - - - -When using [`{html_select_date}`](#language.function.html.select.date) -in a template, the programmer will most likely want to convert the -output from the form back into timestamp format. Here is a function to -help you with that. - - - <?php - - // this assumes your form elements are named - // startDate_Day, startDate_Month, startDate_Year - - $startDate = makeTimeStamp($startDate_Year, $startDate_Month, $startDate_Day); - - function makeTimeStamp($year='', $month='', $day='') - { - if(empty($year)) { - $year = strftime('%Y'); - } - if(empty($month)) { - $month = strftime('%m'); - } - if(empty($day)) { - $day = strftime('%d'); - } - - return mktime(0, 0, 0, $month, $day, $year); - } - ?> - - - -See also [`{html_select_date}`](#language.function.html.select.date), -[`{html_select_time}`](#language.function.html.select.time), -[`date_format`](#language.modifier.date.format) and -[`$smarty.now`](#language.variables.smarty.now), - -WAP/WML {#tips.wap} -======= - -WAP/WML templates require a php [Content-Type -header](&url.php-manual;header) to be passed along with the template. -The easist way to do this would be to write a custom function that -prints the header. If you are using [caching](#caching), that won\'t -work so we\'ll do it using the [`{insert}`](#language.function.insert) -tag; remember `{insert}` tags are not cached! Be sure that there is -nothing output to the browser before the template, or else the header -may fail. - - - <?php - - // be sure apache is configure for the .wml extensions! - // put this function somewhere in your application, or in Smarty.addons.php - function insert_header($params) - { - // this function expects $content argument - if (empty($params['content'])) { - return; - } - header($params['content']); - return; - } - - ?> - - - -your Smarty template *must* begin with the insert tag : - - - {insert name=header content="Content-Type: text/vnd.wap.wml"} - - <?xml version="1.0"?> - <!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml"> - - <!-- begin new wml deck --> - <wml> - <!-- begin first card --> - <card> - <do type="accept"> - <go href="#two"/> - </do> - <p> - Welcome to WAP with Smarty! - Press OK to continue... - </p> - </card> - <!-- begin second card --> - <card id="two"> - <p> - Pretty easy isn't it? - </p> - </card> - </wml> - - - -Componentized Templates {#tips.componentized.templates} -======================= - -Traditionally, programming templates into your applications goes as -follows: First, you accumulate your variables within your PHP -application, (maybe with database queries.) Then, you instantiate your -Smarty object, [`assign()`](#api.assign) the variables and -[`display()`](#api.display) the template. So lets say for example we -have a stock ticker on our template. We would collect the stock data in -our application, then assign these variables in the template and display -it. Now wouldn\'t it be nice if you could add this stock ticker to any -application by merely including the template, and not worry about -fetching the data up front? - -You can do this by writing a custom plugin for fetching the content and -assigning it to a template variable. - -`function.load_ticker.php` - drop file in -[`$plugins directory`](#variable.plugins.dir) - - - <?php - - // setup our function for fetching stock data - function fetch_ticker($symbol) - { - // put logic here that fetches $ticker_info - // from some ticker resource - return $ticker_info; - } - - function smarty_function_load_ticker($params, $smarty) - { - // call the function - $ticker_info = fetch_ticker($params['symbol']); - - // assign template variable - $smarty->assign($params['assign'], $ticker_info); - } - ?> - - - -`index.tpl` - - - {load_ticker symbol='SMARTY' assign='ticker'} - - Stock Name: {$ticker.name} Stock Price: {$ticker.price} - - - -See also [`{include_php}`](#language.function.include.php), -[`{include}`](#language.function.include) and -[`{php}`](#language.function.php). - -Obfuscating E-mail Addresses {#tips.obfuscating.email} -============================ - -Do you ever wonder how your email address gets on so many spam mailing -lists? One way spammers collect email addresses is from web pages. To -help combat this problem, you can make your email address show up in -scrambled javascript in the HTML source, yet it it will look and work -correctly in the browser. This is done with the -[`{mailto}`](#language.function.mailto) plugin. - - - <div id="contact">Send inquiries to - {mailto address=$EmailAddress encode='javascript' subject='Hello'} - </div> - - - -> **Note** -> -> This method isn\'t 100% foolproof. A spammer could conceivably program -> his e-mail collector to decode these values, but not likely\.... -> hopefully..yet \... wheres that quantum computer :-?. - -See also [`escape`](#language.modifier.escape) modifier and -[`{mailto}`](#language.function.mailto). diff --git a/vendor/smarty/smarty/docs/appendixes/troubleshooting.md b/vendor/smarty/smarty/docs/appendixes/troubleshooting.md deleted file mode 100644 index fe012c12c..000000000 --- a/vendor/smarty/smarty/docs/appendixes/troubleshooting.md +++ /dev/null @@ -1,120 +0,0 @@ -Troubleshooting -=============== - -Smarty/PHP errors {#smarty.php.errors} -================= - -Smarty can catch many errors such as missing tag attributes or malformed -variable names. If this happens, you will see an error similar to the -following: - - - Warning: Smarty: [in index.tpl line 4]: syntax error: unknown tag - '%blah' - in /path/to/smarty/Smarty.class.php on line 1041 - - Fatal error: Smarty: [in index.tpl line 28]: syntax error: missing section name - in /path/to/smarty/Smarty.class.php on line 1041 - - - -Smarty shows you the template name, the line number and the error. After -that, the error consists of the actual line number in the Smarty class -that the error occurred. - -There are certain errors that Smarty cannot catch, such as missing close -tags. These types of errors usually end up in PHP compile-time parsing -errors. - - - Parse error: parse error in /path/to/smarty/templates_c/index.tpl.php on line 75 - - - -When you encounter a PHP parsing error, the error line number will -correspond to the compiled PHP script, NOT the template itself. Usually -you can look at the template and spot the syntax error. Here are some -common things to look for: missing close tags for -[`{if}{/if}`](#language.function.if) or -[`{section}{/section}`](#language.function.if), or syntax of logic -within an `{if}` tag. If you can\'t find the error, you might have to -open the compiled PHP file and go to the line number to figure out where -the corresponding error is in the template. - - - Warning: Smarty error: unable to read resource: "index.tpl" in... - or - Warning: Smarty error: unable to read resource: "site.conf" in... - -- The [`$template_dir`](#variable.template.dir) is incorrect, doesn\'t - exist or the file `index.tpl` is not in the `templates/` directory - -- A [`{config_load}`](#language.function.config.load) function is - within a template (or [`configLoad()`](#api.config.load) has been - called) and either [`$config_dir`](#variable.config.dir) is - incorrect, does not exist or `site.conf` is not in the directory. - -<!-- --> - - - Fatal error: Smarty error: the $compile_dir 'templates_c' does not exist, - or is not a directory... - - - -- Either the [`$compile_dir`](#variable.compile.dir)is incorrectly - set, the directory does not exist, or `templates_c` is a file and - not a directory. - -<!-- --> - - - Fatal error: Smarty error: unable to write to $compile_dir '.... - - - -- The [`$compile_dir`](#variable.compile.dir) is not writable by the - web server. See the bottom of the [installing - smarty](#installing.smarty.basic) page for more about permissions. - -<!-- --> - - - Fatal error: Smarty error: the $cache_dir 'cache' does not exist, - or is not a directory. in /.. - - - -- This means that [`$caching`](#variable.caching) is enabled and - either; the [`$cache_dir`](#variable.cache.dir) is incorrectly set, - the directory does not exist, or `cache/` is a file and not a - directory. - -<!-- --> - - - Fatal error: Smarty error: unable to write to $cache_dir '/... - - - -- This means that [`$caching`](#variable.caching) is enabled and the - [`$cache_dir`](#variable.cache.dir) is not writable by the web - server. See the bottom of the [installing - smarty](#installing.smarty.basic) page for permissions. - -<!-- --> - - - Warning: filemtime(): stat failed for /path/to/smarty/cache/3ab50a623e65185c49bf17c63c90cc56070ea85c.one.tpl.php - in /path/to/smarty/libs/sysplugins/smarty_resource.php - - - -- This means that your application registered a custom error hander - (using [set\_error\_handler()](&url.php-manual;set_error_handler)) - which is not respecting the given `$errno` as it should. If, for - whatever reason, this is the desired behaviour of your custom error - handler, please call - [`muteExpectedErrors()`](#api.mute.expected.errors) after you\'ve - registered your custom error handler. - -See also [debugging](#chapter.debugging.console). |