Просмотр файла manual-ru/plugins.html

Размер файла: 6.76Kb
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  4. <title>Chapter 16. Плагины - расширение функциональности Smarty</title>
  5. <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
  6. <link rel="home" href="index.html" title="Руководство по Smarty">
  7. <link rel="up" href="smarty.for.programmers.html" title="Part III. Smarty для программистов">
  8. <link rel="prev" href="template.resources.html" title="Ресурсы">
  9. <link rel="next" href="plugins.naming.conventions.html" title="Соглашение об именах">
  10. </head>
  11. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  12. <div class="navheader">
  13. <table width="100%" summary="Navigation header">
  14. <tr><th colspan="3" align="center">Chapter 16. Плагины - расширение функциональности Smarty</th></tr>
  15. <tr>
  16. <td width="20%" align="left">
  17. <a accesskey="p" href="template.resources.html">Prev</a> </td>
  18. <th width="60%" align="center">Part III. Smarty для программистов</th>
  19. <td width="20%" align="right"> <a accesskey="n" href="plugins.naming.conventions.html">Next</a>
  20. </td>
  21. </tr>
  22. </table>
  23. <hr>
  24. </div>
  25. <div class="chapter" title="Chapter 16. Плагины - расширение функциональности Smarty">
  26. <div class="titlepage"><div><div><h2 class="title">
  27. <a name="plugins"></a>Chapter 16. Плагины - расширение функциональности Smarty</h2></div></div></div>
  28. <div class="toc">
  29. <p><b>Table of Contents</b></p>
  30. <dl>
  31. <dt><span class="sect1"><a href="plugins.html#plugins.howto">Как работают плагины</a></span></dt>
  32. <dt><span class="sect1"><a href="plugins.naming.conventions.html">Соглашение об именах</a></span></dt>
  33. <dt><span class="sect1"><a href="plugins.writing.html">Написание плагинов</a></span></dt>
  34. <dt><span class="sect1"><a href="plugins.functions.html">Функции шаблона</a></span></dt>
  35. <dt><span class="sect1"><a href="plugins.modifiers.html">Модификаторы</a></span></dt>
  36. <dt><span class="sect1"><a href="plugins.block.functions.html">Блоковые функции</a></span></dt>
  37. <dt><span class="sect1"><a href="plugins.compiler.functions.html">Функции компилятора</a></span></dt>
  38. <dt><span class="sect1"><a href="plugins.prefilters.postfilters.html">Префильтры/Постфильтры</a></span></dt>
  39. <dt><span class="sect1"><a href="plugins.outputfilters.html">Фильтры вывода</a></span></dt>
  40. <dt><span class="sect1"><a href="plugins.resources.html">Ресурсы</a></span></dt>
  41. <dt><span class="sect1"><a href="plugins.inserts.html">Вставки</a></span></dt>
  42. </dl>
  43. </div>
  44. <p>
  45. Архитектура версии 2.0 позволяет внедрять плагины, которыми являются
  46. практически все настраиваемые элементы функционала Smarty. Сюда входят:
  47. </p>
  48. <div class="itemizedlist"><ul class="itemizedlist" type="disc" compact>
  49. <li class="listitem">функции</li>
  50. <li class="listitem">модификаторы</li>
  51. <li class="listitem">блоковые функции</li>
  52. <li class="listitem">функции компилятора</li>
  53. <li class="listitem">префильтры</li>
  54. <li class="listitem">постфильтры</li>
  55. <li class="listitem">фильтры вывода</li>
  56. <li class="listitem">ресурсы</li>
  57. <li class="listitem">вставки</li>
  58. </ul></div>
  59. <p>
  60. За исключением ресурсов, в целях обратной совместимости с
  61. предыдущими версиями, сохранена возможность регистрации функций
  62. посредством register_* API.
  63. Если вы не используете API, а вместо этого модифицируете свойства
  64. <code class="literal">$custom_funcs</code>, <code class="literal">$custom_mods</code> и
  65. некоторые другие напрямую, тогда вам придется подогнать ваши скрипты под
  66. использование API или преобразовать добавленную вами функциональность в
  67. плагины.
  68. </p>
  69. <div class="sect1" title="Как работают плагины">
  70. <div class="titlepage"><div><div><h2 class="title" style="clear: both">
  71. <a name="plugins.howto"></a>Как работают плагины</h2></div></div></div>
  72. <p>
  73. Плагины загружаются только по необходимости. Только те модификаторы,
  74. функции, ресурсы и т.д., которые используются в шаблоне, будут
  75. загружены. К тому же, каждый плагин загружается только один раз,
  76. даже если у вас есть несколько экземпляров Smarty, работающих
  77. в пределах одного запроса.
  78. </p>
  79. <p>
  80. Пре/постфильтры и фильтры вывода заслуживают отдельного упоминания.
  81. Так как они не упоминаются в шаблонах, они должны быть зарегистрированы
  82. и загружены неявно через API-функции ещё до обработки шаблона.
  83. Порядок выполнения нескольких фильтров одного типа зависит от
  84. порядка, в котором они регистрировались или загружались.
  85. </p>
  86. <p>
  87. <a class="link" href="variable.plugins.dir.html" title="$plugins_dir">Директория плагинов</a>
  88. может быть строкой, содержащей путь, или массивом, содержащим
  89. множество путей. Чтобы установить плагин, просто поместите его
  90. в одну из этих директорий и Smarty автоматически будет его использовать.
  91. </p>
  92. </div>
  93. </div>
  94. <div class="navfooter">
  95. <hr>
  96. <table width="100%" summary="Navigation footer">
  97. <tr>
  98. <td width="40%" align="left">
  99. <a accesskey="p" href="template.resources.html">Prev</a> </td>
  100. <td width="20%" align="center"><a accesskey="u" href="smarty.for.programmers.html">Up</a></td>
  101. <td width="40%" align="right"> <a accesskey="n" href="plugins.naming.conventions.html">Next</a>
  102. </td>
  103. </tr>
  104. <tr>
  105. <td width="40%" align="left" valign="top">Ресурсы </td>
  106. <td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
  107. <td width="40%" align="right" valign="top"> Соглашение об именах</td>
  108. </tr>
  109. </table>
  110. </div>
  111. </body>
  112. </html>