File: lib/plugins/function.mailto.php

Recommend this page to a friend!
  Classes of David Tamas  >  g-template-php  >  lib/plugins/function.mailto.php  >  Download  
File: lib/plugins/function.mailto.php
Role: Example script
Content type: text/plain
Description: Example script
Class: g-template-php
Process and render templates generating PHP code
Author: By
Last change:
Date: 2 years ago
Size: 5,240 bytes
 

 

Contents

Class file image Download
<?php
/**
 * gTemplate Plugins
 *
 * @package gTemplate
 * @subpackage Plugins
 */

/**
 * gTemplate {mailto} function plugin
 *
 * Type: function<br>
 * Name: mailto<br>
 * Date: May 21, 2002
 * Purpose: automate mailto address link creation, and optionally
 * encode them.<br>
 * Input:<br>
 * - address = e-mail address
 * - text = (optional) text to display, default is address
 * - encode = (optional) can be one of:
 * * none : no encoding (default)
 * * javascript : encode with javascript
 * * javascript_charcode : encode with javascript charcode
 * * hex : encode with hexidecimal (no javascript)
 * - cc = (optional) address(es) to carbon copy
 * - bcc = (optional) address(es) to blind carbon copy
 * - subject = (optional) e-mail subject
 * - newsgroups = (optional) newsgroup(s) to post to
 * - followupto = (optional) address(es) to follow up to
 * - extra = (optional) extra tags for the href link
 *
 * Examples:
 * <pre>
 * {mailto address="me@domain.com"}
 * {mailto address="me@domain.com" encode="javascript"}
 * {mailto address="me@domain.com" encode="hex"}
 * {mailto address="me@domain.com" subject="Hello to you!"}
 * {mailto address="me@domain.com" cc="you@domain.com,they@domain.com"}
 * {mailto address="me@domain.com" extra='class="mailto"'}
 * </pre>
 *
 * @version 1.0
 * @author Tamas David (G-Lex) <glex at mittudomain.info>
 * @link https://github.com/glex86/g-template-php G-Template Engine on Github
 *
 * @internal Some source codes are taken from Smarty
 * @internal author Monte Ohrt <monte at ohrt dot com>
 * @internal link http://smarty.net Smarty
 */
function tpl_function_mailto($params, &$gTpl) {
   
$extra = '';

    if (empty(
$params['address'])) {
       
$gTpl->trigger_error("mailto: missing 'address' parameter");
        return;
    } else {
       
$address = $params['address'];
    }

   
$text = $address;

   
// netscape and mozilla do not decode %40 (@) in BCC field (bug?)
    // so, don't encode it.
   
$search = array('%40', '%2C');
   
$replace = array('@', ',');
   
$mail_parms = array();
    foreach (
$params as $var => $value) {
        switch (
$var) {
            case
'cc':
            case
'bcc':
            case
'followupto':
                if (!empty(
$value))
                   
$mail_parms[] = $var . '=' . str_replace($search, $replace, rawurlencode($value));
                break;

            case
'subject':
            case
'newsgroups':
               
$mail_parms[] = $var . '=' . rawurlencode($value);
                break;

            case
'extra':
            case
'text':
                $
$var = $value;

            default:
        }
    }

   
$mail_parm_vals = '';
    for (
$i = 0; $i < count($mail_parms); $i++) {
       
$mail_parm_vals .= (0 == $i) ? '?' : '&';
       
$mail_parm_vals .= $mail_parms[$i];
    }
   
$address .= $mail_parm_vals;

   
$encode = (empty($params['encode'])) ? 'none' : $params['encode'];
    if (!
in_array($encode, array('javascript', 'javascript_charcode', 'hex', 'none'))) {
       
$gTpl->trigger_error("mailto: 'encode' parameter must be none, javascript or hex");
        return;
    }

    if (
$encode == 'javascript') {
       
$string = 'document.write(\'<a href="mailto:' . $address . '" ' . $extra . '>' . $text . '</a>\');';

       
$js_encode = '';
        for (
$x = 0; $x < strlen($string); $x++) {
           
$js_encode .= '%' . bin2hex($string[$x]);
        }

        return
'<script type="text/javascript">eval(unescape(\'' . $js_encode . '\'))</script>';
    } elseif (
$encode == 'javascript_charcode') {
       
$string = '<a href="mailto:' . $address . '" ' . $extra . '>' . $text . '</a>';

        for (
$x = 0, $y = strlen($string); $x < $y; $x++) {
           
$ord[] = ord($string[$x]);
        }

       
$_ret = "<script type=\"text/javascript\" language=\"javascript\">\n";
       
$_ret .= "<!--\n";
       
$_ret .= "{document.write(String.fromCharCode(";
       
$_ret .= implode(',', $ord);
       
$_ret .= "))";
       
$_ret .= "}\n";
       
$_ret .= "//-->\n";
       
$_ret .= "</script>\n";

        return
$_ret;
    } elseif (
$encode == 'hex') {

       
preg_match('!^(.*)(\?.*)$!', $address, $match);
        if (!empty(
$match[2])) {
           
$gTpl->trigger_error("mailto: hex encoding does not work with extra attributes. Try javascript.");
            return;
        }
       
$address_encode = '';
        for (
$x = 0; $x < strlen($address); $x++) {
            if (
preg_match('!\w!', $address[$x])) {
               
$address_encode .= '%' . bin2hex($address[$x]);
            } else {
               
$address_encode .= $address[$x];
            }
        }
       
$text_encode = '';
        for (
$x = 0; $x < strlen($text); $x++) {
           
$text_encode .= '&#x' . bin2hex($text[$x]) . ';';
        }

       
$mailto = "&#109;&#97;&#105;&#108;&#116;&#111;&#58;";
        return
'<a href="' . $mailto . $address_encode . '" ' . $extra . '>' . $text_encode . '</a>';
    } else {
       
// no encoding
       
return '<a href="mailto:' . $address . '" ' . $extra . '>' . $text . '</a>';
    }
}


For more information send a message to info at phpclasses dot org.