The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
ePortal-4.5
River stage zero No dependents
++
/ ePortal::Utils

NAME

ePortal::Utils - useful global wide functions.

SYNOPSIS

Some functions are very useful anywhere. They are collected here.

METHODS

logline(loglevel,string,...)

Record the string in error log. There are a number of loglevels:

  • emerg

    Emergencies - system is unusable: Object creation errors.

  • alert

    Action must be taken immediately.

  • crit

    Critical Conditions.

  • error

    Error conditions.

  • warn

    Warning conditions.

  • notice

    Normal but significant condition.

  • info

    Informational: Redirects.

  • debug

    Debug-level messages: ACL checking

pick_lang(hash)

 pick_lang( eng => "text in english",
            rus => "text in russian");

Chooses and returns a text for a current ePortal language.

href( uri, key => value, ...)

Constructs full URL with optional parameters.

uri is filename or URI to some file.

key-value pairs may be repeated. value may be array ref.

Returns a string like uri?key=value&key=value

plink(text, parameters, ...)

Constructs HTML code to make anchor like [link] (text in square brackets)

text is text to show as link.

Other parameters are passed directly to CGI::a() function. Most used are:

 -href => 'http://server/file.htm'
 -href => href('file.htm', param1 => value1)
 -class => "someclass"
 -target => "_top"
 -title => "floating title"

img( param => value )

Contructs HTML code for image tag. Parameters passed as hash are:

src required. URI to image.

width, height if not passed then Image::Size is used for calculation at runtime. These attributes are calculated only once for each apache child. They are cached for speed.

alt alternative text for the image

id ID of the image

Some parameters are used to construct Link from the image:

href, target, title, onClick - they are self-expanatory, passed to CGI::a() function.

Returns HTML string in scalar of array context. If used in void contxet then $m->out() is used to output the string immediately .

filter_html($content)

Filters a content to cut some HTML tags like <HTML>

Accept as parameter:

any text - filters this text

/path/filename - reads this file and filters it

$m - calls fetch_next() and filters the output

AUTHOR

Sergey Rusakov, <rusakov_sa@users.sourceforge.net>