Barbie > Labyrinth > Labyrinth::MLUtils

Download:
Labyrinth-5.24.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 5.24   Source  

NAME ^

Labyrinth::MLUtils - Markup Language Utilities for Labyrinth.

SYNOPSIS ^

  use Labyrinth::MLUtils;

FUNCTIONS ^

HTML Tag handling

LegalTag

Returns TRUE or FALSE as to whether the given HTML tag is accepted by the system.

LegalTags

Returns the list of HTML tags that are accepted by the system.

CleanTags

For a given text string, attempts to clean the use of any HTML tags. Any HTML tags found that are not accepted by the system are encoded into HTML entities.

CleanHTML

For a given text string, removes all existence of any HTML tag. Mostly used in input text box cleaning.

SafeHTML

For a given text string, encodes all HTML tags to HTML entities. Mostly used in input textarea edit preparation.

CleanLink

Attempts to remove known spam style links.

CleanWords

Attempts to remove known profanity words.

LinkTitles

Given a XHTML snippet, will look for basic links and add title attributes. Titles are of rhe format 'External Site: $domain', where $domain is the domain used in the link.

Drop Down Boxes

DropDownList($opt,$name,@items)

Returns a dropdown selection box given a list of numbers. Can optionally pass a option value to be pre-selected. The name of the form element is used as both the element name and id.

DropDownListText($opt,$name,@items)

Returns a dropdown selection box given a list of strings. Can optionally pass a option value to be pre-selected. The name of the form element is used as both the element name and id.

DropDownRows($opt,$name,$index,$value,@items)

Returns a dropdown selection box given a list of rows. Can optionally pass a option value to be pre-selected. The name of the form element is used as both the element name and id. The 'index' and 'value' refence the field names within each row hash.

DropDownRowsText($opt,$name,$index,$value,@items)

Returns a dropdown selection box given a list of strings. Can optionally pass a option value to be pre-selected. The name of the form element is used as both the element name and id. The 'index' and 'value' refence the field names within each row hash.

DropDownMultiList($opts,$name,$count,@items)

Returns a dropdown multi-selection box given a list of strings. The name of the form element is used as both the element name and id. The default number of rows visible is 5, but this can be changed by providing a value for 'count'.

Can optionally pass an option value to be pre-selected. The option can be a comma separated list (as a single string) of values or an arrayref to a list of values.

DropDownMultiRows($opts,$name,$index,$value,$count,@items)

Returns a dropdown multi-selection box given a list of rows. The name of the form element is used as both the element name and id. The default number of rows visible is 5, but this can be changed by providing a value for 'count'. The 'index' and 'value' refence the field names within each row hash.

Can optionally pass an option value to be pre-selected. The option can be a comma separated list (as a single string) of values or an arrayref to a list of values.

Error Functions

ErrorText

Returns the given error string in a HTML span tag, with the configured error class, which by default is called "alert". In your CSS sytle sheet you will need to specify an appropriate class declaration, such as:

  .alert { color: red; font-weight: bold; }

Set the value of 'errorclass' in your site config file to change the class name used.

ErrorSymbol

Flags to the system that an error has occured and returns the configured error symbol, which by is the 'empty' symbol '∅', which can then be used as the error field indicator.

Set the value of 'errorsymbol' in your site config file to change the symbol used.

Protection Functions

LinkSpam

Checks whether any links exist in the given text that could indicate comment spam.

CSS Handling Code

create_inline_styles ( HASHREF )

Create inline CSS style sheet block. Key value pairs should match the label (tag, identifier or class patterns) and its contents. For example:

  my %css = ( '#label p' => 'font-weight: normal; color: #fff;' );

or

  my %css = ( '#label p' => { 'font-weight' => 'normal', 'color' => '#fff' } );

The exception to this is the label 'media', which can be used to specify the medium for which the CSS will be used. Typically these are 'screen' or 'print'.

HTML Demoroniser Code

demoroniser ( INPUT )

Given a string, will replace the Microsoft "smart" characters with sensible ACSII versions.

HTML Handling Code

The following functions disassemble and reassemble the HTML code snippets, validating and cleaning the code to fix any errors that may exist between the template and content of the database.

process_html ( INPUT [,LINE_BREAKS [,ALLOW]] )
escape_html ( INPUT )
unescape_html ( INPUT )
cleanup_attr_style
cleanup_attr_number
cleanup_attr_multilength
cleanup_attr_text
cleanup_attr_length
cleanup_attr_color
cleanup_attr_uri
cleanup_attr_tframe
cleanup_attr_trules
cleanup_html
cleanup_tag
cleanup_close
cleanup_cdata
cleanup_no_number
check_url_valid
cleanup_attr_inputtype
cleanup_attr_method
cleanup_attr_scriptlang
cleanup_attr_scripttype
strip_nonprintable

SEE ALSO ^

  Labyrinth

AUTHOR ^

Barbie, <barbie@missbarbell.co.uk> for Miss Barbell Productions, http://www.missbarbell.co.uk/

COPYRIGHT & LICENSE ^

  Copyright (C) 2002-2014 Barbie for Miss Barbell Productions
  All Rights Reserved.

  This module is free software; you can redistribute it and/or
  modify it under the Artistic License 2.0.
syntax highlighting: