ePortal::Utils - useful global wide functions.

- NAME
- SYNOPSIS
- METHODS

- `logline(loglevel,string,...)`
- `pick_lang(hash)`
- href( uri, key => value, ...)
- plink(text, parameters, ...)
- empty_table( param => value )
- empty_tr( param => value )
- empty_td( param => value )
- img( param => value )
- `filter_html($content)`

- AUTHOR

# 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"

## empty_table( param => value )

Constructs HTML code to create empty table 100% width. A background of the table is filled with 1 pixel in size transparent picture. Parameters passed as hash are:

height table height in pixels

bgcolor HTML compatible color value

black adjust background picture and color values to make the table completly black

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

## empty_tr( param => value )

Contructs HTML code for empty row of table. Parameters passed as hash are:

height height in pixels

colspan make a cell as colspan. Used in multicolumn tables

bgcolor HTML compatible color value

black adjust all parameters to make the row completely black

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

## empty_td( param => value )

Contructs HTML code for empty cell of table. Parameters passed as hash are:

height height in pixels

width width in pixels

colspan make a cell as coluln span.

bgcolor HTML compatible color value

black adjust all parameters to make the row completely black

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

## 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>