smarty/docs/ja/designers/language-custom-functions/language-function-mailto.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2602 Maintainer: takagi Status: ready -->
<!-- CREDITS: mat-sh,daichi,joe -->
<sect1 id="language.function.mailto">
 <title>{mailto}</title>
  <para>
   <varname>{mailto}</varname> は、<literal>mailto:</literal>
   リンクの作成とメールアドレスのエンコードを自動的に行います。
   メールアドレスをエンコードすることで、
   アドレス収集ソフトがあなたのサイトからメールアドレスを取得することを困難にします。
  <note>
  <title>テクニカルノート</title>
  <para>
   Javascript がおそらく一番徹底したエンコードを行いますが、
   hexエンコードも使用する事が出来ます。
  </para>
 </note>
 </para>

 <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>属性名</entry>
     <entry>型</entry>
     <entry>必須</entry>
     <entry>デフォルト</entry>
     <entry>概要</entry>
    </row>
   </thead>
   <tbody>
    <row>
     <entry>address</entry>
     <entry>string</entry>
     <entry>Yes</entry>
     <entry><emphasis>n/a</emphasis></entry>
     <entry>メールアドレス</entry>
    </row>
    <row>
     <entry>text</entry>
     <entry>string</entry>
     <entry>No</entry>
     <entry><emphasis>n/a</emphasis></entry>
     <entry>表示するテキスト。デフォルトではメールアドレス。</entry>
    </row>
    <row>
     <entry>encode</entry>
     <entry>string</entry>
     <entry>No</entry>
     <entry><emphasis>none</emphasis></entry>
     <entry>メールアドレスのエンコード方法。
      <literal>none</literal>、
      <literal>hex</literal>、<literal>javascript</literal>
      あるいは <literal>javascript_charcode</literal>
      のいずれか。</entry>
    </row>
    <row>
     <entry>cc</entry>
     <entry>string</entry>
     <entry>No</entry>
     <entry><emphasis>n/a</emphasis></entry>
     <entry>カーボンコピーにあたるメールアドレス。 複数の場合はカンマによって区切られる。
     </entry>
    </row>
    <row>
     <entry>bcc</entry>
     <entry>string</entry>
     <entry>No</entry>
     <entry><emphasis>n/a</emphasis></entry>
     <entry>ブラインドカーボンコピーにあたるメールアドレス。
      複数の場合はカンマによって区切られる。</entry>
    </row>
    <row>
     <entry>subject</entry>
     <entry>string</entry>
     <entry>No</entry>
     <entry><emphasis>n/a</emphasis></entry>
     <entry>メールの件名</entry>
    </row>
    <row>
     <entry>newsgroups</entry>
     <entry>string</entry>
     <entry>No</entry>
     <entry><emphasis>n/a</emphasis></entry>
     <entry>投稿するニュースグループ。複数の場合はカンマによって区切られる。</entry>
    </row>
    <row>
     <entry>followupto</entry>
     <entry>string</entry>
     <entry>No</entry>
     <entry><emphasis>n/a</emphasis></entry>
     <entry>フォローアップするメールアドレス。複数の場合はカンマによって区切られる。</entry>
    </row>
    <row>
     <entry>extra</entry>
     <entry>string</entry>
     <entry>No</entry>
     <entry><emphasis>n/a</emphasis></entry>
     <entry>リンクする際に渡したい特別な情報（例えばスタイルシートクラス）。</entry>
    </row>
   </tbody>
  </tgroup>
 </informaltable>


 <example>
  <title>{mailto} のサンプルと、その結果</title>
  <programlisting>
<![CDATA[
{mailto address="me@example.com"}
<a href="mailto:me@example.com" >me@example.com</a>

{mailto address="me@example.com" text="send me some mail"}
<a href="mailto:me@example.com" >send me some mail</a>

{mailto address="me@example.com" encode="javascript"}
<script type="text/javascript" language="javascript">
   eval(unescape('%64%6f% ... snipped ...%61%3e%27%29%3b'))
</script>

{mailto address="me@example.com" encode="hex"}
<a href="mailto:%6d%65.. snipped..3%6f%6d">&#x6d;&..snipped...#x6f;&#x6d;</a>

{mailto address="me@example.com" subject="Hello to you!"}
<a href="mailto:me@example.com?subject=Hello%20to%20you%21" >me@example.com</a>

{mailto address="me@example.com" cc="you@example.com,they@example.com"}
<a href="mailto:me@example.com?cc=you@example.com%2Cthey@example.com" >me@example.com</a>

{mailto address="me@example.com" extra='class="email"'}
<a href="mailto:me@example.com" class="email">me@example.com</a>

{mailto address="me@example.com" encode="javascript_charcode"}
<script type="text/javascript" language="javascript">
    <!--
    {document.write(String.fromCharCode(60,97, ... snipped ....60,47,97,62))}
    //-->
</script>
]]>
</programlisting>
 </example>
 <para>
 <link linkend="language.modifier.escape"><varname>escape</varname></link>、
 <link linkend="language.function.textformat"><varname>{textformat}</varname></link>
 および
 <link linkend="tips.obfuscating.email">E-mail アドレスを混乱させる</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
 -->