PHP Classes

File: readme.txt

Recommend this page to a friend!
  Classes of Sergey Romanov   HTML Editor   readme.txt   Download  
File: readme.txt
Role: Documentation
Content type: text/plain
Description: description, references, installation, changelog
Class: HTML Editor
Compose and output HTML documents
Author: By
Last change:
Date: 20 years ago
Size: 8,299 bytes
 

Contents

Class file image Download
[DESCRIPTION] The HTML_Editor is meant to dynamically compose and output HTML documents. It provides functions to add many different types of the HTML elements to the document that is being composed. Using HTML_Editor with classes like the PEAR::HTML_Table and PEAR::HTML_Forms or other PEAR::HTML_* classes it provides a complete interface to create HTML documents of any complication or parts of HTML formatted text on the fly. With this class you can create any tags enclosed text like(P, H(1-6), B, LI, UL, SPAN, etc) with any of attributes. You can also create link, image, meta tags. If you use PHP 5 you can reformat the output with the tidy extension. There is tidy.cnf file included with all options available and you can customize it as you like to change output. this class also include very simple CSS creation class. It is called CSS_Editor. It has 3 main methods. setElement, setProperties, getCss. example of use 1 $css = new CSS_Editor; 2 3 $h1 = $css->setElement('H1'); 4 5 $array = ( 6 'color' => '#663399', 7 'font-weight' => 'bold' 8 ); 9 $css->setProperties($h1, $array); 10 11 $a = $css->setElement(); 12 $css->setProperties($a, array('text-decoration' => 'none')); 13 14 $text_css = $css->getCss(); in this example first we create new class in line 1, then in line 3 create an element H1 for formating <H1> tag. than in lines 5-8 we create array of formatting properties and set these properties to H1 element in line 9. Another element with pseudo class is created in line 11. it could be not only 'a:hover' but link to id '#my_link' or class '.my_link'. In line 12 we set property for 'a:hover' element. And finally in line 14 we get all this as a formated string that would looks like this: H1{ color:#663399; font-weight:bold; } a:hover{ text-decoration:none; } [INSTALLATION] to install this class simple copy html_editor.php to your include or lib directory. see section [EXAMPLES] [Tidy] For php5 there is feature build-in for formating output with tidy. This uses tidy.cfg. This file content all setting available for tidy. You just customize it the way you need. The tidy.cfg file must be in the same directory as html_editor.php. [EXAMPLES] to use HTML_Editor simply call it from directory you have coped it to using require_once. see example.php. [REFERENCES] integer = newDocument([string = $title]); this function create new document and return pointer to this document that is used almost in any other function. example: $html = new HTML_Editor; $doc1 = $html->newDocument('This is the Title'); void addMeta(integer = $doc, array = $meta); this method inserts name/content meta tags in to the document $doc = integer that point on document that is created by newDocument() function; $meta = array that content meta data example: $meta = array( 'author' => 'Sergey Romanov', 'generator' => 'HTML-Kit', 'keywords' => 'html_editor, php, etc..', 'description' => 'use HTML_Editor for improving you programming speed' ); $html->addMeta($doc1, $meta); void addMetaHttp(integer = $doc, array = $meta); this method insert into document http meta tags. $doc = integer that point on document that is created by newDocument() function; $meta = array that content http meta data $meta_http = array( 'content-type' => 'text/html; charset=windows-1251' ); $html->addMetaHttp($doc1, $meta_http); string = makeImg(string = $src [,array = $options]); this method return string that content <img ..> tag. It can than be inserted to the document $src = image source $options = array of additional attributes, example: $ico = $html->makeImg('/images/register_ico.gif', array('border'=>'0')); string = makeLink(string = $href, string = $lable [, array = $options]); this method return string that content <a ..>..</a> tag. It can than be inserted to the document $href = string link href $lable = string link text $options = array of additional attributes, example: $ico = $html->makeLink('http://msn.com', 'Go to MSN', array('title'=>'this is link to MSN sitr')); void = addHeadAdditions(integer = $doc1, string = $text); this function inserts into <head></head> section additional code. This is useful if you want insert <style></style> or <script></script> tags into head section. $doc = integer that point on document that is created by newDocument() function; $test = string you want to insert to head section void = setBodyAttr($doc, $attr); this method set attributes for body tag $doc = integer that point on document that is created by newDocument() function; $attr = array set of attributes. example: $ba = array( 'margintop' => '0', 'marginwidth' => '0' ); $html->setBodyAttr($doc, $ba); viod = writeHtml(integer = $doc, string = $tag, string = $string [, array = $attributes]); this method writes text($string) to the end of document($doc) enclosed in tag($tag) $doc = integer that point on document that is created by newDocument() function; $tag = string tag in which $text is enclosed $text = string text to write to document $attributes = array of attributes for tag example: $html->writeHtml($doc, 'H1', 'This will appear as header 1'); $html->writeHtml($doc, 'P', 'and this will be a paragraph under header.'); string = getHtml( string = $tag, string = $string [, array = $attributes]); this is the same as writeHtml() method but this is not writing to document but return. This is useful to prepare parts of html formated text for displaying or inserting to the document. $tag = string tag in which $text is enclosed $text = string text to write to document $attributes = array of attributes for tag string = highlightText(string = $tag , string = holder, string = $text [, array = $attr]); this method provide you possibility to insert html tags into the text and return formated text. $tag = string tag to insert $holder = string what to highlight $text = in which text to highlight example: $text = 'This is an example text'; $text = $editor->highlightText('B',' is ',$text, array('class'=>'test')); $text = $editor->highlightText('i',' example ',$text); after that $text will contect This <B class="test">is</B> an <i>example</i> text string = docGet(integer = $doc); this method return html document with head, body sections ready to display. $doc = integer which document to return example: echo $html->docGet($doc); void = docSave(integer = $doc, string = $path); this method save document in path specified. $doc = integer which document to save $path = string the path document to save to. example: $html->docSave($doc, '/www/htdocs/dir/my.html'); header('location:/dir/my.html'); string = docShow($doc); just print document specified by $doc [TO DO] method setBodyAttr() - the method that will allow to set attributes for tag <body> [CHANGE LOG] [2-Aug-2004] v.0.0.2 The error that have appeared on php4.x.x have been fixed. Added 2 new functions fixed (tidy.cfg not fond) error with php5