diff --git a/docs/ru/programmers/api-functions/api-append-by-ref.xml b/docs/ru/programmers/api-functions/api-append-by-ref.xml index ef266dee..d121eb40 100644 --- a/docs/ru/programmers/api-functions/api-append-by-ref.xml +++ b/docs/ru/programmers/api-functions/api-append-by-ref.xml @@ -1,45 +1,49 @@ - + - - append_by_ref - - - void append_by_ref - string varname - mixed var - - - void append_by_ref - string varname - mixed var - boolean merge - - - - This is used to append values to the templates by reference. - If you append a variable by reference then change its - value, the appended value sees the change as well. For objects, - append_by_ref() also avoids an in-memory copy of the appended object. - See the PHP manual on variable referencing for an in-depth - explanation. If you pass the optional third parameter of true, - the value will be merged with the current array instead of appended. - - - Technical Note - - The merge parameter respects array keys, so if you merge two - numerically indexed arrays, they may overwrite each other or result in - non-sequential keys. This is unlike the array_merge() function of PHP - which wipes out numerical keys and renumbers them. - - - - append_by_ref - -// appending name/value pairs + + + append_by_ref + + + void append_by_ref + string varname + mixed var + + + void append_by_ref + string varname + mixed var + boolean merge + + + + Эта функция используется для добавления значений к шаблону по ссылке. + Если вы добавляете переменную по ссылке то, соответсвенно, можете + изменять значение переменной, на которую она ссылается. Для объектов, + append_by_ref() так же помогает избежать их копирования в памяти. + Смотрите руководство PHP на предмет ссылок на переменные для более глубокого + пояснения. Если вы устанавливаете необязательный третий параметр в true, + то значение не добавляется, а сливается с текущим массивом. + + + Техническое замечание + + Параметр слияния связан с ключами массива, поэтому, если вы объеденяете + два не ассоциативных массива, они могут переписать некоторые значения друг друга или + выдать массив с непоследовательными ключами. В этом заключается некоторое отличие + от функции array_merge() в PHP, которая удаляет нумерацию ключей и перенумеровывает их. + + + + append_by_ref + +append_by_ref("Name",$myname); -$smarty->append_by_ref("Address",$address); - +$smarty->append_by_ref("Address",$address); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-append.xml b/docs/ru/programmers/api-functions/api-append.xml index 953cb5da..d1c12f2c 100644 --- a/docs/ru/programmers/api-functions/api-append.xml +++ b/docs/ru/programmers/api-functions/api-append.xml @@ -1,51 +1,55 @@ - + - - append - - - void append - mixed var - - - void append - string varname - mixed var - - - void append - string varname - mixed var - boolean merge - - - - This is used to append an element to an assigned array. If you append - to a string value, it is converted to an array value and then - appended to. You can explicitly pass name/value pairs, or associative - arrays containing the name/value pairs. If you pass the optional third - parameter of true, the value will be merged with the current array - instead of appended. - - - Technical Note - - The merge parameter respects array keys, so if you merge two - numerically indexed arrays, they may overwrite each other or result in - non-sequential keys. This is unlike the array_merge() function of PHP - which wipes out numerical keys and renumbers them. - - - - append - -// passing name/value pairs + + + append + + + void append + mixed var + + + void append + string varname + mixed var + + + void append + string varname + mixed var + boolean merge + + + + Функция используется для добавления элемента в назначенный (assigned) массив. + Если вы добавляете к строковому значению, оно конвертируется в значение + массива, и, затем добавляется. Вы можете передавать пары имя/значение + явно, или в виде ассоциативного массива, состоящего из пар имя/значение. + Если вы устанавливаете необязательный третий + параметр в true, то значение будет не добавлено, а слито с текущим массивом. + + + Техническое замечание + + Параметр слияния связан с ключами массива, поэтому, если вы + объеденяете два не ассоциативных массива, они могут переписать + некоторые значения друг друга или выдать массив с непоследовательными + ключами. В этом заключается некоторое отличие от функции array_merge() + в PHP, которая удаляет нумерацию ключей и перенумеровывает их. + + + + append + +append("Name","Fred"); $smarty->append("Address",$address); - -// passing an associative array -$smarty->append(array("city" => "Lincoln","state" => "Nebraska")); - +// передача ассоциативного массива +$smarty->append(array("city" => "Lincoln","state" => "Nebraska")); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-assign-by-ref.xml b/docs/ru/programmers/api-functions/api-assign-by-ref.xml index 8519671d..23013be2 100644 --- a/docs/ru/programmers/api-functions/api-assign-by-ref.xml +++ b/docs/ru/programmers/api-functions/api-assign-by-ref.xml @@ -1,36 +1,42 @@ - + - - assign_by_ref - - - void assign_by_ref - string varname - mixed var - - - - This is used to assign values to the templates by reference instead of - making a copy. See the PHP manual on variable referencing for an explanation. - - - Technical Note - - This is used to assign values to the templates by reference. - If you assign a variable by reference then change its - value, the assigned value sees the change as well. For objects, - assign_by_ref() also avoids an in-memory copy of the assigned object. - See the PHP manual on variable referencing for an in-depth - explanation. - - - - assign_by_ref - -// passing name/value pairs + + + assign_by_ref + + + void assign_by_ref + string varname + mixed var + + + + Эта функция используется для передачи значения переменной + в шаблон по ссылке, вместо создания ее копии. Смотрите + руководство PHP на предмет ссылок на переменные для + более глубокого пояснения. + + + Техническое замечание + + Функция используется для передачи значения в шаблон по ссылке. + Если вы назначаете переменную по ссылке, то имеете возможность + менять значение переменной, на которую она ссылается. + Что касается объектов, то assign_by_ref() помогает избежать + копирования переданных в шаблон объектов в памяти. + Смотрите руководство PHP на предмет ссылок на переменные. + + + + assign_by_ref + +assign_by_ref("Name",$myname); -$smarty->assign_by_ref("Address",$address); - +$smarty->assign_by_ref("Address",$address); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-assign.xml b/docs/ru/programmers/api-functions/api-assign.xml index 89974511..14c0169f 100644 --- a/docs/ru/programmers/api-functions/api-assign.xml +++ b/docs/ru/programmers/api-functions/api-assign.xml @@ -1,33 +1,37 @@ - + - - assign - - - void assign - mixed var - - - void assign - string varname - mixed var - - - - This is used to assign values to the templates. You can - explicitly pass name/value pairs, or associative arrays - containing the name/value pairs. - - - assign - -// passing name/value pairs + + + assign + + + void assign + mixed var + + + void assign + string varname + mixed var + + + + Функция используется для присвоения значений в шаблонах. Вы можете + явно передавать пары имя/значение, или ассоциативные массивы, + содержащие пары имя/значение. + + + assign + +assign("Name","Fred"); $smarty->assign("Address",$address); -// passing an associative array -$smarty->assign(array("city" => "Lincoln","state" => "Nebraska")); - +// передача ассоциативного массива +$smarty->assign(array("city" => "Lincoln","state" => "Nebraska")); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-clear-all-assign.xml b/docs/ru/programmers/api-functions/api-clear-all-assign.xml index 593adb3d..68ffab4b 100644 --- a/docs/ru/programmers/api-functions/api-clear-all-assign.xml +++ b/docs/ru/programmers/api-functions/api-clear-all-assign.xml @@ -1,22 +1,26 @@ - + - - clear_all_assign - - - void clear_all_assign - - - - - This clears the values of all assigned variables. - - -clear_all_assign - -// clear all assigned variables -$smarty->clear_all_assign(); - + + + clear_all_assign + + + void clear_all_assign + + + + + Очищает все ранее присвоенные значения переменных. + + + clear_all_assign + +clear_all_assign(); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-clear-all-cache.xml b/docs/ru/programmers/api-functions/api-clear-all-cache.xml index f1750d7a..b9a4bd39 100644 --- a/docs/ru/programmers/api-functions/api-clear-all-cache.xml +++ b/docs/ru/programmers/api-functions/api-clear-all-cache.xml @@ -1,24 +1,28 @@ - + - - clear_all_cache - - - void clear_all_cache - int expire time - - - - This clears the entire template cache. As an optional - parameter, you can supply a minimum age in seconds the cache - files must be before they will get cleared. - - -clear_all_cache - -// clear the entire cache -$smarty->clear_all_cache(); - + + + clear_all_cache + + + void clear_all_cache + int expire time + + + + Очищает кэш шаблона целиком. В качестве необязательного + параметра, вы можете указать минимальное время в секундах, + которое должно пройти перед тем, как кэш будет очищен. + + + clear_all_cache + +clear_all_cache(); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-clear-assign.xml b/docs/ru/programmers/api-functions/api-clear-assign.xml index b9a94c57..d53c6c48 100644 --- a/docs/ru/programmers/api-functions/api-clear-assign.xml +++ b/docs/ru/programmers/api-functions/api-clear-assign.xml @@ -1,26 +1,30 @@ - + - - clear_assign - - - void clear_assign - string var - - - - This clears the value of an assigned variable. This - can be a single value, or an array of values. - - -clear_assign - -// clear a single variable + + + clear_assign + + + void clear_assign + string var + + + + Очищает присвоенное ранее значение переменной. Это может быть + как обычная переменная, так и массив некоторых значений. + + + clear_assign + +clear_assign("Name"); -// clear multiple variables -$smarty->clear_assign(array("Name","Address","Zip")); - +// очистить значения несколько переменных +$smarty->clear_assign(array("Name","Address","Zip")); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-clear-cache.xml b/docs/ru/programmers/api-functions/api-clear-cache.xml index 1afb37a7..4c9e0d55 100644 --- a/docs/ru/programmers/api-functions/api-clear-cache.xml +++ b/docs/ru/programmers/api-functions/api-clear-cache.xml @@ -1,34 +1,41 @@ - + - - clear_cache - - voidclear_cache - stringtemplate - stringcache id - stringcompile id - intexpire time - - - This clears the cache for a specific template. If you have - multiple caches for this template, you can clear a specific - cache by supplying the cache id as the second parameter. You - can also pass a compile id as a third parameter. You can "group" - templates together so they can be removed as a group. See the - caching section for more - information. As an optional fourth parameter, you can supply a - minimum age in seconds the cache file must be before it will - get cleared. - - -clear_cache - -// clear the cache for a template + + + clear_cache + + voidclear_cache + stringtemplate + stringcache id + stringcompile id + intexpire time + + + Очищает кэш указанного шаблона. Если у вас есть + несколько кэшированных копий шаблона, вы можете + очистить конкретную копию, указав cache id в + качестве второго параметра. Вы так же можете передать + compile id в качестве третьего параметра или + "сгруппировать" шаблоны вместе и удалить группу. + Для получения дополнительной информации, смотрите + раздел "Кэширование". + В качестве необязательного четвертого параметра вы + можете указать минимальное время в секундах, в + течение которого кэш будет существовать перед очисткой. + + + clear_cache + +clear_cache("index.tpl"); -// clear the cache for a particular cache id in an multiple-cache template -$smarty->clear_cache("index.tpl","CACHEID"); - +// очистить кэшированную копию с конкретным cache id +// при множественном кэшировании шаблона +$smarty->clear_cache("index.tpl","CACHEID"); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-clear-compiled-tpl.xml b/docs/ru/programmers/api-functions/api-clear-compiled-tpl.xml index 77e6ea7a..2121de81 100644 --- a/docs/ru/programmers/api-functions/api-clear-compiled-tpl.xml +++ b/docs/ru/programmers/api-functions/api-clear-compiled-tpl.xml @@ -1,27 +1,32 @@ - + - - clear_compiled_tpl - - - void clear_compiled_tpl - string tpl_file - - - - This clears the compiled version of the specified template - resource, or all compiled template files if one is not specified. - This function is for advanced use only, not normally needed. - - -clear_compiled_tpl - -// clear a specific template resource + + + clear_compiled_tpl + + + void clear_compiled_tpl + string tpl_file + + + + Очищает указанную откомпилированную версию шаблона, + или все откомпилированные файлы шаблона если ничего не указано. + Эта функция только для опытных пользователей и обычно в ее + использовании необходимости нет. + + + clear_compiled_tpl + +clear_compiled_tpl("index.tpl"); -// clear entire compile directory -$smarty->clear_compiled_tpl(); - +// очистить всю директорию с откомпилированными шаблонами +$smarty->clear_compiled_tpl(); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-clear-config.xml b/docs/ru/programmers/api-functions/api-clear-config.xml index 3c1a8b8c..79faaaf6 100644 --- a/docs/ru/programmers/api-functions/api-clear-config.xml +++ b/docs/ru/programmers/api-functions/api-clear-config.xml @@ -1,24 +1,29 @@ - + - - clear_config - - voidclear_config - stringvar - - - This clears all assigned config variables. If a variable name is - supplied, only that variable is cleared. - - -clear_config - -// clear all assigned config variables. + + + clear_config + + voidclear_config + stringvar + + + Функция очищает все назначенные конфигурационные + переменные. Если передано имя переменной, + значит очищается только она. + + + clear_config + +clear_config(); -// clear one variable -$smarty->clear_config('foobar'); - +// очищаем только одну переменную +$smarty->clear_config('foobar'); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-config-load.xml b/docs/ru/programmers/api-functions/api-config-load.xml index cce6d5c2..7b1dfcae 100644 --- a/docs/ru/programmers/api-functions/api-config-load.xml +++ b/docs/ru/programmers/api-functions/api-config-load.xml @@ -1,38 +1,43 @@ - + - - config_load - - voidconfig_load - stringfile - stringsection - - - This loads config file data and assigns it to the template. This - works identical to the template config_load - function. - - - Technical Note - - As of Smarty 2.4.0, assigned template variables are kept across - invocations of fetch() and display(). Config vars loaded from - config_load() are always global scope. Config files are also - compiled for faster execution, and respect the force_compile and compile_check settings. - - - -config_load - -// load config variables and assign them + + + config_load + + voidconfig_load + stringfile + stringsection + + + Функция загружает данные из файла конфигурации + (config file) и помещает их в шаблон. Это + аналог функции шаблона + config_load. + + + Техническое замечание + + Как в Smarty 2.4.0, переменные шаблона подставляются при + вызове fetch() или display(). Кофигурационные переменные, + загружаемые при вызове config_load() всегда глобальны. + Для повышения скорости работы, конфигурационные файлы тоже + компилируются и к ним применительны force_compile и compile_check настройки. + + + + config_load + +config_load('my.conf'); -// load a section -$smarty->config_load('my.conf','foobar'); - +// загрузка секции конфигурационного файла +$smarty->config_load('my.conf','foobar'); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-display.xml b/docs/ru/programmers/api-functions/api-display.xml index 0ea10688..6ef656c8 100644 --- a/docs/ru/programmers/api-functions/api-display.xml +++ b/docs/ru/programmers/api-functions/api-display.xml @@ -1,44 +1,48 @@ - + - - display - - voiddisplay - stringtemplate - stringcache_id - stringcompile_id - - - This displays the template. Supply a valid template resource - type and path. As an optional second parameter, you can pass a - cache id. See the caching - section for more information. - - - As an optional third parameter, you can pass a compile id. This - is in the event that you want to compile different versions of - the same template, such as having separate templates compiled - for different languages. Another use for compile_id is when you - use more than one $template_dir but only one $compile_dir. Set - a separate compile_id for each $template_dir, otherwise - templates of the same name will overwrite each other. You can - also set the $compile_id variable once - instead of passing this to each call to display(). - - -display - + + + display + + voiddisplay + stringtemplate + stringcache_id + stringcompile_id + + + Функция отоброжает шаблон. Укажите верный типtemplate resource + и путь. В качестве необязательного второго параметра, + вы можете передать cache id. Смотрите раздел + "Кэширование" для дополнительной информации. + + + В качестве необязательного третьего параметра, можно + передать compile id. Это необходимо в том случае, если + вы хотите скомпилировать разные версии одного и того + же шаблона, например для того, чтобы иметь различные + откомпилированные версии шаблона для различных языков. + Также, compile_id может быть полезен в том случае, если + более чем один $template_dir но только один $compile_dir. + В таком случае, установите различные compile_id для каждого + $template_dir, иначе, шаблоны, имеющие одинаковые номера + перезапишут друг друга. Также, вы можете установить переменную + $compile_id однажды, + вместо того, чтобы передавать ее при каждом вызове display(). + + + display + +caching = true; -// only do db calls if cache doesn't exist +// обращаемся к базе только в случае отсутствия кэша if(!$smarty->is_cached("index.tpl")) { - // dummy up some data + // подставляем некоторые данные $address = "245 N 50th"; $db_data = array( "City" => "Lincoln", @@ -52,30 +56,34 @@ if(!$smarty->is_cached("index.tpl")) } -// display the output -$smarty->display("index.tpl"); - - - Use the syntax for template resources to - display files outside of the $template_dir directory. - - -function display template resource examples - -// absolute filepath +// отображаем вывод +$smarty->display("index.tpl"); +]]> + + + + Используйте синтаксис template resources для + отображения файлов, находящихся вне $template_dir директории. + + + Примеры отображения шаблонов из различных ресурсов + +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) +// абсолютный путь Windows (ОБЯЗАТЕЛЬНО используйте префикс "file:") $smarty->display("file:C:/www/pub/templates/header.tpl"); -// include from template resource named "db" -$smarty->display("db:header.tpl"); - - +// вставка из ресурса под названием "db" +$smarty->display("db:header.tpl"); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-fetch.xml b/docs/ru/programmers/api-functions/api-fetch.xml index 927db6ca..1f9a344f 100644 --- a/docs/ru/programmers/api-functions/api-fetch.xml +++ b/docs/ru/programmers/api-functions/api-fetch.xml @@ -1,46 +1,50 @@ - + - - fetch - - stringfetch - stringtemplate - stringcache_id - stringcompile_id - - - This returns the template output instead of displaying it. - Supply a valid template resource - type and path. As an optional second parameter, you can pass a - cache id. See the caching - section for more information. - - - As an optional third parameter, you can pass a compile id. This - is in the event that you want to compile different versions of - the same template, such as having separate templates compiled - for different languages. Another use for compile_id is when you - use more than one $template_dir but only one $compile_dir. Set - a separate compile_id for each $template_dir, otherwise - templates of the same name will overwrite each other. You can - also set the $compile_id variable once - instead of passing this to each call to fetch(). - - -fetch - + + + fetch + + stringfetch + stringtemplate + stringcache_id + stringcompile_id + + + Функция возвращает вывод шаблона вместо его отображения на экран. + Укажите верный тип template resource + и путь. В качестве необязательного второго параметра можно передать + cache id. Смотрите раздел + "Кэширование" для получения дополнительной информации. + + + В качестве необязательного третьего параметра, можно + передать compile id. Это необходимо в том случае, если + вы хотите скомпилировать разные версии одного и того же + шаблона, например для того, чтобы иметь различные + откомпилированные версии шаблона для различных языков. + Также, compile_id может быть полезен в том случае, если + более чем один $template_dir но только один $compile_dir. + В таком случае, установите различные compile_id для каждого + $template_dir, иначе, шаблоны, имеющие одинаковые номера + перезапишут друг друга. Также, вы можете установить переменную + $compile_id однажды, + вместо того, чтобы передавать ее при каждом вызове fetch(). + + + fetch + +caching = true; -// only do db calls if cache doesn't exist +// обращаемся к БД только если отсутствует кэш if(!$smarty->is_cached("index.tpl")) { - // dummy up some data + // присваиваем некоторые значения $address = "245 N 50th"; $db_data = array( "City" => "Lincoln", @@ -54,13 +58,15 @@ if(!$smarty->is_cached("index.tpl")) } -// capture the output +// перехватываем вывод $output = $smarty->fetch("index.tpl"); -// do something with $output here +// здесь выполняем какие либо действия с $output -echo $output; - +echo $output; +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-get-config-vars.xml b/docs/ru/programmers/api-functions/api-get-config-vars.xml index 0c9e0fe1..220d1742 100644 --- a/docs/ru/programmers/api-functions/api-get-config-vars.xml +++ b/docs/ru/programmers/api-functions/api-get-config-vars.xml @@ -1,27 +1,31 @@ - + - - get_config_vars - - arrayget_config_vars - stringvarname - - - This returns the given loaded config variable value. If no parameter - is given, an array of all loaded config variables is returned. - - -get_config_vars - -// get loaded config template var 'foo' + + + get_config_vars + + arrayget_config_vars + stringvarname + + + Возвращает значение переданной конфигурационной переменной. Если ни одного + параметра не передавалось, то будет возвращен массив всех конфигурационных переменных. + + + get_config_vars + +get_config_vars('foo'); -// get all loaded config template vars +// получаем все загруженные конфигурационные переменные шаблона $config_vars = $smarty->get_config_vars(); -// take a look at them -print_r($config_vars); - +// смотрим что у нас получилось +print_r($config_vars); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-get-registered-object.xml b/docs/ru/programmers/api-functions/api-get-registered-object.xml index 4e668928..7025557c 100644 --- a/docs/ru/programmers/api-functions/api-get-registered-object.xml +++ b/docs/ru/programmers/api-functions/api-get-registered-object.xml @@ -1,29 +1,33 @@ - + - - get_registered_object - - - array get_registered_object - string object_name - - - - This returns a reference to a registered object. This is useful - from within a custom function when you need direct access to a - registered object. - - -get_registered_object - -function smarty_block_foo($params, &$smarty) { - if (isset[$params['object']]) { - // get reference to registered object - $obj_ref =& $smarty->&get_registered_object($params['object']); - // use $obj_ref is now a reference to the object - } -} - + + + get_registered_object + + + array get_registered_object + string object_name + + + + Возвращает ссылку на зарегестрированный объект. Может быть полезно в случае + необходимости получения прямого доступа к + зарегестрированному объекту. + + + get_registered_object + +&get_registered_object($params['object']); + // теперь используем $obj_ref как ссылку на объект + } +} +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-get-template-vars.xml b/docs/ru/programmers/api-functions/api-get-template-vars.xml index 14191ae8..20ce3f8a 100644 --- a/docs/ru/programmers/api-functions/api-get-template-vars.xml +++ b/docs/ru/programmers/api-functions/api-get-template-vars.xml @@ -1,27 +1,31 @@ - + - - get_template_vars - - arrayget_template_vars - stringvarname - - - This returns the given assigned variable value. If no parameter - is given, an array of all assigned variables is returned. - - -get_template_vars - -// get assigned template var 'foo' + + + get_template_vars + + arrayget_template_vars + stringvarname + + + Возвращает значение переменной. Если параметров нет, + то возвращается массив со всеми назначенными переменными. + + + get_template_vars + +get_template_vars('foo'); -// get all assigned template vars +// получаем все назначенные переменные шаблона $tpl_vars = $smarty->get_template_vars(); -// take a look at them -print_r($tpl_vars); - +// поглядим что из этого вышло +print_r($tpl_vars); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-is-cached.xml b/docs/ru/programmers/api-functions/api-is-cached.xml index 036cc2f3..889f90ce 100644 --- a/docs/ru/programmers/api-functions/api-is-cached.xml +++ b/docs/ru/programmers/api-functions/api-is-cached.xml @@ -1,45 +1,52 @@ - + - - is_cached - - - void is_cached - string template - [string cache_id] - - - - This returns true if there is a valid cache for this template. - This only works if caching is set to true. - - -is_cached - + + + is_cached + + + void is_cached + string template + [string cache_id] + + + + Возвращает true если существует кэш для указанного шаблона. + Работает только в том случае, если значениеcaching установлено в true. + + + is_cached + +caching = true; if(!$smarty->is_cached("index.tpl")) { - // do database calls, assign vars here + // обращаемся к БД, назначаем переменные } -$smarty->display("index.tpl"); - - - You can also pass a cache id as an optional second parameter - in case you want multiple caches for the given template. - - -is_cached with multiple-cache template - +$smarty->display("index.tpl"); +]]> + + + + Так же вы можете передавать cache id в качестве необязательного второго + параметра, если у вас используется множественное кэширование шаблона. + + + is_cached при множественном кэшировании шаблона + +caching = true; if(!$smarty->is_cached("index.tpl","FrontPage")) { - // do database calls, assign vars here + // обращаемся к БД, назначаем переменные } -$smarty->display("index.tpl","FrontPage"); - +$smarty->display("index.tpl","FrontPage"); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-load-filter.xml b/docs/ru/programmers/api-functions/api-load-filter.xml index b9288b91..a2a43483 100644 --- a/docs/ru/programmers/api-functions/api-load-filter.xml +++ b/docs/ru/programmers/api-functions/api-load-filter.xml @@ -1,27 +1,31 @@ - + - - load_filter - - - void load_filter - string type - string name - - - - This function can be used to load a filter plugin. The first - argument specifies the type of the filter to load and can be one - of the following: 'pre', 'post', or 'output'. The second argument - specifies the name of the filter plugin, for example, 'trim'. - - -loading filter plugins - -$smarty->load_filter('pre', 'trim'); // load prefilter named 'trim' -$smarty->load_filter('pre', 'datefooter'); // load another prefilter named 'datefooter' -$smarty->load_filter('output', 'compress'); // load output filter named 'compress' - + + + load_filter + + + void load_filter + string type + string name + + + + Эта функция может быть использована для загрузки плагина фильтра. Первый аргумент + определяет тип загружаемого фильтра и может быть одним из следующих: + 'pre', 'post', или 'output'. Второй аргумент + определяет имя плагина фильтра, к примеру, 'trim'. + + + Загрузка плагинов фильтров + +load_filter('pre', 'trim'); // загружаем префильтр под названием 'trim' +$smarty->load_filter('pre', 'datefooter'); // загружаем еще один префильтр - 'datefooter' +$smarty->load_filter('output', 'compress'); // загружаем фильтр вывода 'compress' +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-register-block.xml b/docs/ru/programmers/api-functions/api-register-block.xml index 794ccc19..e1acf03c 100644 --- a/docs/ru/programmers/api-functions/api-register-block.xml +++ b/docs/ru/programmers/api-functions/api-register-block.xml @@ -1,22 +1,23 @@ - + - - register_block - - - void register_block - string name - string impl - - - - Use this to dynamically register block functions plugins. - Pass in the block function name, followed by the PHP - function name that implements it. - - -register_block - + + + register_block + + + void register_block + string name + string impl + + + + Используйте для динамической регистрации плагинов + блоковых функций. В качестве аргументов передаются + имя блоковой функции и имя функции, реализующей ее. + + + register_block + register_block("translate", "do_translation"); function do_translation ($params, $content, &$smarty) { if ($content) { $lang = $params['lang']; - // do some translation with $content + // выполняем перевод $content echo $translation; } } @@ -37,8 +38,8 @@ function do_translation ($params, $content, &$smarty) { Hello, world! {/translate} ]]> - - + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-register-compiler-function.xml b/docs/ru/programmers/api-functions/api-register-compiler-function.xml index cd69ddaf..ad56c12f 100644 --- a/docs/ru/programmers/api-functions/api-register-compiler-function.xml +++ b/docs/ru/programmers/api-functions/api-register-compiler-function.xml @@ -1,19 +1,19 @@ - + - - register_compiler_function - - - void register_compiler_function - string name - string impl - - - - Use this to dynamically register a compiler function plugin. - Pass in the compiler function name, followed by the PHP - function that implements it. - + + + register_compiler_function + + + void register_compiler_function + string name + string impl + + + + Используется для динамической регистрации плагина функции компилятора. + Передается наименование функции компилятора, далее список функций. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-register-function.xml b/docs/ru/programmers/api-functions/api-register-function.xml index 0dc5bf19..4658755e 100644 --- a/docs/ru/programmers/api-functions/api-register-function.xml +++ b/docs/ru/programmers/api-functions/api-register-function.xml @@ -1,22 +1,23 @@ - + - - register_function - - - void register_function - string name - string impl - - - - Use this to dynamically register template function plugins. - Pass in the template function name, followed by the PHP - function name that implements it. - - -register_function - + + + register_function + + + void register_function + string name + string impl + + + + Используется для динамической регистрации плагинов функций шаблона. + Передается наименование функции шаблона и наименование выполняемой функции. + + + register_function + +register_function("date_now", "print_current_date"); function print_current_date ($params) { @@ -26,9 +27,11 @@ function print_current_date ($params) { echo strftime($format,time()); } -// now you can use this in Smarty to print the current date: {date_now} -// or, {date_now format="%Y/%m/%d"} to format it. - +// теперь вы можете использовать ее в Smarty чтобы вывести текущую дату: {date_now} +// или {date_now format="%Y/%m/%d"} чтобы задать формат. +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-register-modifier.xml b/docs/ru/programmers/api-functions/api-register-modifier.xml index 879f6870..83f0eca9 100644 --- a/docs/ru/programmers/api-functions/api-register-modifier.xml +++ b/docs/ru/programmers/api-functions/api-register-modifier.xml @@ -1,28 +1,31 @@ - + - - register_modifier - - - void register_modifier - string name - string impl - - - - Use this to dynamically register modifier plugin. Pass in the - template modifier name, followed by the PHP function that it - implements it. - - -register_modifier - -// let's map PHP's stripslashes function to a Smarty modifier. + + + register_modifier + + + void register_modifier + string name + string impl + + + + Используйте функцию для динамической регистрации плагина модификатора. В функцию + передаются имя модификатора и имя функции, реализующей его. + + + register_modifier + +register_modifier("sslash","stripslashes"); -// now you can use {$var|sslash} to strip slashes from variables - +// теперь можно использовать {$var|sslash} чтобы вырезать слеши из переменной +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-register-object.xml b/docs/ru/programmers/api-functions/api-register-object.xml index df8e6333..8a06d27e 100644 --- a/docs/ru/programmers/api-functions/api-register-object.xml +++ b/docs/ru/programmers/api-functions/api-register-object.xml @@ -1,21 +1,22 @@ - + - - register_object - - - void register_object - string object_name - object $object - array allowed methods/properties - boolean format - - - - This is to register an object for use in the templates. See the - object section - of the manual for examples. - + + + register_object + + + void register_object + string object_name + object $object + array allowed methods/properties + boolean format + + + + Функция регестрирует объект для использования в шаблоне. Смотрите + раздел "Объекты" + для примеров. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-register-outputfilter.xml b/docs/ru/programmers/api-functions/api-register-outputfilter.xml index a4a8cc7a..a73795f1 100644 --- a/docs/ru/programmers/api-functions/api-register-outputfilter.xml +++ b/docs/ru/programmers/api-functions/api-register-outputfilter.xml @@ -1,20 +1,21 @@ - + - - register_outputfilter - - - void register_outputfilter - string function_name - - - - Use this to dynamically register outputfilters to operate on - a template's output before it is displayed. See - template output - filters - for more information on how to set up an output filter function. - + + + register_outputfilter + + + void register_outputfilter + string function_name + + + + Используйте функцию для динамической регистрации фильтров + вывода, чтобы управлять выводом шаблона перед тем, как он + будет показан в браузере. Смотрите + фильтры вывода + шаблонов для дополнительной информации. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-register-postfilter.xml b/docs/ru/programmers/api-functions/api-register-postfilter.xml index c5702d3b..f5dd7860 100644 --- a/docs/ru/programmers/api-functions/api-register-postfilter.xml +++ b/docs/ru/programmers/api-functions/api-register-postfilter.xml @@ -1,19 +1,20 @@ - + - - register_postfilter - - - void register_postfilter - string function_name - - - - Use this to dynamically register postfilters to run templates - through after they are compiled. See template postfilters for - more information on how to setup a postfiltering function. - + + + register_postfilter + + + void register_postfilter + string function_name + + + + Используйте функцию для динамической регистрации постфильтров, + в целях управления выводом шаблонов уже после их компиляции. + Смотрите постфильтры + шаблонов для получения дополнительной информации. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-register-prefilter.xml b/docs/ru/programmers/api-functions/api-register-prefilter.xml index d6f1d249..262dfb64 100644 --- a/docs/ru/programmers/api-functions/api-register-prefilter.xml +++ b/docs/ru/programmers/api-functions/api-register-prefilter.xml @@ -1,19 +1,20 @@ - + - - register_prefilter - - - void register_prefilter - string function_name - - - - Use this to dynamically register prefilters to run templates - through before they are compiled. See template prefilters for - more information on how to setup a prefiltering function. - + + + register_prefilter + + + void register_prefilter + string function_name + + + + Используйте функцию для динамической регистрации префильтра, + в целях управления содержимым вывода шаблона перед его компиляцией. + Смотрите префильтры + шаблонов для дополнительной информации. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-register-resource.xml b/docs/ru/programmers/api-functions/api-register-resource.xml index 6cde9f82..033f6f42 100644 --- a/docs/ru/programmers/api-functions/api-register-resource.xml +++ b/docs/ru/programmers/api-functions/api-register-resource.xml @@ -1,30 +1,32 @@ - + - - register_resource - - - void register_resource - string name - array resource_funcs - - - - Use this to dynamically register a resource plugin with Smarty. - Pass in the name of the resource and the array of PHP functions - implementing it. See - template resources - for more information on how to setup a function for fetching - templates. - - -register_resource - + + + register_resource + + + void register_resource + string name + array resource_funcs + + + + Используйте эту функцию, чтобы динамически зарегистрировать + плагин ресурса в Smarty. Передается имя ресурса и массив PHP-функций. + Смотрите template resources + для дополнительной информации. + + + register_resource + +register_resource("db", array("db_get_template", "db_get_timestamp", "db_get_secure", - "db_get_trusted")); - + "db_get_trusted")); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-template-exists.xml b/docs/ru/programmers/api-functions/api-template-exists.xml index 1e9e32e4..df2dab28 100644 --- a/docs/ru/programmers/api-functions/api-template-exists.xml +++ b/docs/ru/programmers/api-functions/api-template-exists.xml @@ -1,18 +1,19 @@ - + - - template_exists - - - bool template_exists - string template - - - - This function checks whether the specified template exists. It can - accept either a path to the template on the filesystem or a - resource string specifying the template. - + + + template_exists + + + bool template_exists + string template + + + + Эта функция проверяет, существует ли определенный шаблон. + Здесь можно указать путь к шаблону в файловой системе или + строку ресурса, соответствующую шаблону. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-trigger-error.xml b/docs/ru/programmers/api-functions/api-trigger-error.xml index 7e779e00..137a9763 100644 --- a/docs/ru/programmers/api-functions/api-trigger-error.xml +++ b/docs/ru/programmers/api-functions/api-trigger-error.xml @@ -1,20 +1,22 @@ - + - - trigger_error - - - void trigger_error - string error_msg - [int level] - - - - This function can be used to output an error message using Smarty. - level parameter can be one of the values - used for trigger_error() PHP function, i.e. E_USER_NOTICE, - E_USER_WARNING, etc. By default it's E_USER_WARNING. - + + + trigger_error + + + void trigger_error + string error_msg + [int level] + + + + Эта функция может быть использована для вывода сообщения об + ошибке средствами Smarty. Параметр level + может быть равен одному из значений, используемых для PHP-функции + trigger_error(), т.е. E_USER_NOTICE, E_USER_WARNING, и др. + По умолчанию установлено значение E_USER_WARNING. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-unregister-block.xml b/docs/ru/programmers/api-functions/api-unregister-block.xml index ea7be58e..ec1a7326 100644 --- a/docs/ru/programmers/api-functions/api-unregister-block.xml +++ b/docs/ru/programmers/api-functions/api-unregister-block.xml @@ -1,17 +1,18 @@ - + - - unregister_block - - - void unregister_block - string name - - - - Use this to dynamically unregister block function plugin. - Pass in the block function name. - + + + unregister_block + + + void unregister_block + string name + + + + Используйте функцию для динамической дерегистрации плагина блоковой функции. + В качестве аргумента передается имя функции. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-unregister-compiler-function.xml b/docs/ru/programmers/api-functions/api-unregister-compiler-function.xml index 1b21c409..ca4a9e09 100644 --- a/docs/ru/programmers/api-functions/api-unregister-compiler-function.xml +++ b/docs/ru/programmers/api-functions/api-unregister-compiler-function.xml @@ -1,17 +1,19 @@ - + - - unregister_compiler_function - - - void unregister_compiler_function - string name - - - - Use this to dynamically unregister a compiler function. Pass in - the name of the compiler function. - + + + unregister_compiler_function + + + void unregister_compiler_function + string name + + + + Используйте функцию для динамической дерегистрации + функции компиляции. В качестве аргумента передается + имя функции компиляции. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-unregister-function.xml b/docs/ru/programmers/api-functions/api-unregister-function.xml index 85db1e86..9c5ab29b 100644 --- a/docs/ru/programmers/api-functions/api-unregister-function.xml +++ b/docs/ru/programmers/api-functions/api-unregister-function.xml @@ -1,24 +1,28 @@ - + - - unregister_function - - - void unregister_function - string name - - - - Use this to dynamically unregister template function plugin. - Pass in the template function name. - - -unregister_function - -// we don't want template designers to have access to system files + + + unregister_function + + + void unregister_function + string name + + + + Используйте функцию для динамической деригистрации плагина функции шаблона. + В качестве аргумента передается имя функции шаблона. + + + unregister_function + +unregister_function("fetch"); - +$smarty->unregister_function("fetch"); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-unregister-modifier.xml b/docs/ru/programmers/api-functions/api-unregister-modifier.xml index 09243e1c..a95a5d7c 100644 --- a/docs/ru/programmers/api-functions/api-unregister-modifier.xml +++ b/docs/ru/programmers/api-functions/api-unregister-modifier.xml @@ -1,24 +1,29 @@ - + - - unregister_modifier - - - void unregister_modifier - string name - - - - Use this to dynamically unregister modifier plugin. Pass in the - template modifier name. - - -unregister_modifier - + + + unregister_modifier + + + void unregister_modifier + string name + + + + Используйте функцию для динамической дерегистрации + плагина модификатора. В качестве аргумента передается + имя модификатора. + + + unregister_modifier + +unregister_modifier("strip_tags"); - +$smarty->unregister_modifier("strip_tags"); +]]> + + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-unregister-object.xml b/docs/ru/programmers/api-functions/api-unregister-object.xml index d9007b0f..3f6bedf4 100644 --- a/docs/ru/programmers/api-functions/api-unregister-object.xml +++ b/docs/ru/programmers/api-functions/api-unregister-object.xml @@ -1,16 +1,17 @@ - + - - unregister_object - - - void unregister_object - string object_name - - - - Use this to unregister an object. - + + + unregister_object + + + void unregister_object + string object_name + + + + Используется для дерегистрации объекта. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-unregister-outputfilter.xml b/docs/ru/programmers/api-functions/api-unregister-outputfilter.xml index c3438f7d..8a1646ce 100644 --- a/docs/ru/programmers/api-functions/api-unregister-outputfilter.xml +++ b/docs/ru/programmers/api-functions/api-unregister-outputfilter.xml @@ -1,16 +1,17 @@ - + - - unregister_outputfilter - - - void unregister_outputfilter - string function_name - - - - Use this to dynamically unregister an output filter. - + + + unregister_outputfilter + + + void unregister_outputfilter + string function_name + + + + Используйте функцию для динамической дерегистрации фильтра вывода. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-unregister-postfilter.xml b/docs/ru/programmers/api-functions/api-unregister-postfilter.xml index cca256d1..7ae6807a 100644 --- a/docs/ru/programmers/api-functions/api-unregister-postfilter.xml +++ b/docs/ru/programmers/api-functions/api-unregister-postfilter.xml @@ -1,16 +1,17 @@ - + - - unregister_postfilter - - - void unregister_postfilter - string function_name - - - - Use this to dynamically unregister a postfilter. - + + + unregister_postfilter + + + void unregister_postfilter + string function_name + + + + Используйте функцию для динамической дерегистрации постфильтра. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-unregister-prefilter.xml b/docs/ru/programmers/api-functions/api-unregister-prefilter.xml index 60be265a..4aab43bb 100644 --- a/docs/ru/programmers/api-functions/api-unregister-prefilter.xml +++ b/docs/ru/programmers/api-functions/api-unregister-prefilter.xml @@ -1,16 +1,17 @@ - + - - unregister_prefilter - - - void unregister_prefilter - string function_name - - - - Use this to dynamically unregister a prefilter. - + + + unregister_prefilter + + + void unregister_prefilter + string function_name + + + + Используйте для динамической дерегистрации префильтра. + \ No newline at end of file +--> diff --git a/docs/ru/programmers/api-functions/api-unregister-resource.xml b/docs/ru/programmers/api-functions/api-unregister-resource.xml index 6c776f49..84a40857 100644 --- a/docs/ru/programmers/api-functions/api-unregister-resource.xml +++ b/docs/ru/programmers/api-functions/api-unregister-resource.xml @@ -1,22 +1,26 @@ - + - - unregister_resource - - - void unregister_resource - string name - - - - Use this to dynamically unregister a resource plugin. Pass in the - name of the resource. - - -unregister_resource - -$smarty->unregister_resource("db"); - + + + unregister_resource + + + void unregister_resource + string name + + + + Используйте функцию для динамической дерегистрации + плагина ресурса. В качестве аргумента передается имя ресурса. + + + unregister_resource + +unregister_resource("db"); +]]> + + \ No newline at end of file +-->