banana split

docs/fr/programmers/plugins/plugins-inserts.xml

@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision$ -->
+   <sect1 id="plugins.inserts"><title>Insertions</title>
+    <para>
+    Les plugins d'insertion sont utilis<69>s pour impl<70>menter les fonctions
+    qui sont appel<65>es par les balises 
+    <link linkend="language.function.insert"><command>insert</command></link>
+    dans les templates.
+    </para>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>string <function>smarty_insert_<replaceable>name</replaceable></function></funcdef>
+      <paramdef>array <parameter>$params</parameter></paramdef>
+      <paramdef>object <parameter>&amp;$smarty</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+    Le premier param<61>tre pass<73> a la fonction est une tableau associatif
+    d'attributs. Vous pouvez acc<63>der a ces valeurs soit directement, par exemple
+    <varname>$params['start']</varname>, soit en utilisant
+    <varname>extract($params)</varname> pour les importer dans la table
+    des symboles.
+    </para>
+    <para>
+    La fonction d'insertion est suppos<6F>e retourner le r<>sultat qui sera
+    substitu<74> a la balise <command>insert</command> dans le template.
+    </para>    
+    <example>
+     <title>plugin d'insertion</title>
+     <programlisting>
+&lt;?php
+/*
+ * Smarty plugin
+ * ------------------------------------------------------------- 
+ * Fichier :  insert.time.php
+ * Type :     temps
+ * Nom :      time
+ * R<>le :     Insert la date/heure courante conform<72>ment
+ *            au format
+ * -------------------------------------------------------------
+ */
+function smarty_insert_time($params, &amp;$smarty)
+{
+    if (empty($params['format'])) {
+        $smarty->trigger_error("insert time: missing 'format' parameter");
+        return;
+    }
+
+    $datetime = strftime($params['format']);
+    return $datetime;
+}
+?&gt;</programlisting>
+    </example>
+</sect1>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->