Files
smarty/docs/id/designers/language-custom-functions/language-function-fetch.xml
2007-09-18 17:45:46 +00:00

140 lines
4.0 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<sect1 id="language.function.fetch">
<title>{fetch}</title>
<para>
<varname>{fetch}</varname> dipakai untuk mengambil file dari sistem file
lokal, http, atau ftp dan menampilkan konten.
</para>
<itemizedlist>
<listitem><para>
Jika nama file diawali dengan
<parameter>http://</parameter>, halaman situs web akan diambil dan
ditempilkan.
<note>
<para>
Ini tidak akan mendukung pengalihan http, pastikan untuk menyertakan
garis miring terakhir pada halaman web yang anda ambil bila
diperlukan.
</para>
</note>
</para></listitem>
<listitem><para>
Jika nama file diawali dengan <parameter>ftp://</parameter>, file akan
di-download dari server ftp dan ditampilkan.
</para></listitem>
<listitem><para>
Untuk file lokal, harus memberikan baik path file sistem lengkap ataupun
path relatif ke naskah php yang dijalankan.
<note>
<para>
Jika template <link linkend="variable.security">
<parameter>$security</parameter></link>
dihidupkan dan anda sedang mengambil file dari sistem file lokal,
<varname>{fetch}</varname> hanya akan membolehkan file dari dalam
salah satu yang didefinisikan dalam
will only allow files from within one of the defined
<link linkend="variable.secure.dir">direktori aman</link>.
</para>
</note>
</para></listitem>
<listitem><para>
Jika atribut <parameter>assign</parameter> disetel, output fungsi
<varname>{fetch}</varname> akan ditempatkan ke variabel template
ini daripada ke template.
</para></listitem>
</itemizedlist>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Nama Atribut</entry>
<entry>Type</entry>
<entry>Diperlukan</entry>
<entry>Default</entry>
<entry>Deskripsi</entry>
</row>
</thead>
<tbody>
<row>
<entry>file</entry>
<entry>string</entry>
<entry>Ya</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>File, http atau situs ftp untuk diambil</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Tidak</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Variabel template yang akan ditempati</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<example>
<title>contoh {fetch}</title>
<programlisting>
<![CDATA[
{* sertakan beberapa javascript dalam template anda *}
{fetch file='/export/httpd/www.example.com/docs/navbar.js'}
{* sertakan beberapa teks cuaca dalam template anda dari situs web lain *}
{fetch file='http://www.myweather.com/68502/'}
{* ambil file headline berita via ftp *}
{fetch file='ftp://user:password@ftp.example.com/path/to/currentheadlines.txt'}
{* sama seperti di atas tapi dengan variabel *}
{fetch file="ftp://`$user`:`$password`@`$server`/`$path`"}
{* tempatkan konten yang diambil ke variabel template *}
{fetch file='http://www.myweather.com/68502/' assign='weather'}
{if $weather ne ''}
<div id="weather">{$weather}</div>
{/if}
]]>
</programlisting>
</example>
<para>
Lihat juga
<link linkend="language.function.capture"><varname>{capture}</varname></link>,
<link linkend="language.function.eval"><varname>{eval}</varname></link>,
<link linkend="language.function.assign"><varname>{assign}</varname></link>
dan
<link linkend="api.fetch"><varname>fetch()</varname></link>.
</para>
</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
-->