UWAGA: Strona zawiera materiały archiwalne. Większość artykułów dotyczy Joomla! 1.0
Start arrow Programowanie arrow API arrow mosHTML::e-mailCloaking
mosHTML::e-mailCloaking Drukuj Email

Jest to prosta metoda maskowania adresu e-mail. Zwraca kod JavaScript, który zamienia adres e-mail na odnośnik z zamaskowanym, nieczytelnym dla robotów przeszukujących serwisy adresem mailowym.

Składnia

string e-mailCloaking ( string $address [, boolean $mailto [, string $text [, boolean $e-mail [, boolean $noscript ]]]] )

$address
jest adresem mailowym, który ma być zamaskowany.
$mailto
jest flagą. Jeśli przyjmuje wartość true wtedy klikalny link "mailto:" zostanie utworzony; w przeciwnym wypadku $address będzie pokazany, ale nie jako link. Ten parametr jest opcjonalny i jeśli zostanie pominięty, to przyjmie wartość true.
$text
jest tekstem wyświetlanym w linku dla użytkownika. Jeśli nic się nie wpisze, wtedy zmienna $address zostanie wyświetlona użytkownikowi. Ten parametr jest opcjonalny i jeśli zostanie pominięty, to przyjmie wartość pustego ciagu. (dlatego też wyświetlany tekst będzie wygladał nastepująco: $address).
$e-mail
jest flagą. Jeśli przyjmuje wartość true, wtedy wskazuje, że $text sam w sobie stanowi adres e-mail i dodatkowe środki ostrożności przeciwko przejmowaniu adresów mailowych mogą być przedsiębrane; inaczej $text jest postrzegany jako ciąg rozjemczy i tylko bazowe dekodowanie będzie zastosowane. Ten parametr jest opcjonalny i jeśli zostanie opuszczony będzie wskazywać domyślnie na true. Ten parametr został wprowadzony w wersji mambo 4.5.2.2.
$noscript
jest flagą. Jeśli przyjmuje wartość true, wtedy para tagów HTML <noscript> pozwoli na wyświetlenie ciągu zawierającego wiadomość, która może być wyświetlona na komputerach użytkowników, których przeglądarki nie obsługują skryptów, albo są one tymczasowo wyłączone. Zwrócony tekst jest pobierany z ZAMASKOWANEJ zmiennej językowej. Ten parametr jest opcjonalny, zatem w przypadku opuszczenia będzie przybierał wartość false. Ten parametr został wprowadzony w Joomla 1.1 z wcześniejszych wersji zawsze produkujących parę tagów <noscript>

Przykłady

Przykład 1: Użytkownik używa tylko adresu e-mail, bez żadnych parametrów. Użytkownik będzie widział adres e-mail jako link:

 
$address = 'john.doe @ w3c.org'; // UWAGA: bez spacji w adresie!
echo mosHTML::e-mailcloaking( $address );

co wyprodukuje cos takiego jak:

 
<script language='JavaScript' type='text/javascript'> 
<!-- 
var prefix = 'ma' + 'il' + 'to'; 
var path = 'hr' + 'ef' + '='; 
var addy39561 = 'john.doe' + '@' + 'w3c' + '.' + 'org'; 
document.write( '<a ' + path + '\'' + prefix + ':' + addy39561 + '\'>' ); 
document.write( addy39561 ); 
document.write( '<\/a>' ); 
//--> 
</script> 
<noscript> 
Ten adres e-mail jest chroniony przed spam-botami,
musisz miec wlaczona obsluge Javascript, aby go zobaczyc
</noscript>

Przyklad 2: W tym przypadku użytkownik ujrzy coś w stylu 'Jan Krolica':

 
$address = 'jan.krolica @ w3c.org'; // UWAGA: bez spacji w adresie!
$name = 'Jan Krolica';
echo mosHTML::e-mailcloaking( $address, true, $name, false );

co wyprodukuje cos takiego jak:

 
<script language='JavaScript' type='text/javascript'> 
<!-- 
var prefix = 'ma' + 'il' + 'to'; 
var path = 'hr' + 'ef' + '='; 
var addy38289 = 'jan.krolica' + '@' + 'w3c' + '.' + 'org'; 
var addy_text38289 = 'Jan Krolica';
document.write( '<a ' + path + '\'' + prefix + ':' + addy38289 + '\'>' ); 
document.write( addy_text38289 ); 
document.write( '<\/a>' ); 
//--> 
</script> 
<noscript> 
Ten adres e-mail jest chroniony przed spam-botami,
musisz miec wlaczona obsluge Javascript, aby go zobaczyc
</noscript>

Tłum. vj & zwiastun
Źródło: help.joomla.org - mosHTML::e-mailCloaking

Zmieniony ( 30.10.2005. )
 
« poprzedni artykuł   następny artykuł »