BBCODE_CREATE(3)							 1							  BBCODE_CREATE(3)

bbcode_create - Create a BBCode Resource

SYNOPSIS

       resource bbcode_create ([array  $bbcode_initial_tags = NULL])

DESCRIPTION

	This function returns a new BBCode Resource used to parse BBCode strings.

PARAMETERS

	      o $bbcode_initial_tags
		- An associative array containing the tag names as keys and parameters required to correctly parse BBCode as their value. The fol-
		lowing key/value pairs are supported:

		     o$flags optional - a flag set based on the BBCODE_FLAGS_* constants.

		     o$type required - an int indicating the type of tag. Use the BBCODE_TYPE_* constants.

		     o$open_tag required - the HTML replacement string for the open tag.

		     o$close_tag required - the HTML replacement string for the close tag.

		     o$default_arg optional - use this value as the default argument if none is provided and tag_type is of type OPTARG.

		     o$content_handling optional - Gives the callback used for modification of the content.  Object  Oriented  Notation  supported
		     only since 0.10.1 callback prototype is string name
		       (string $content, string $argument)

		     o$param_handling optional - Gives the callback used for modification of the argument. Object Oriented Notation supported only
		     since 0.10.1 callback prototype is string name
		       (string $content, string $argument)

		     o$childs optional - List of accepted children for the tag. The format of the list is a comma separated string.  If  the  list
		     starts with ! it will be the list of rejected children for the tag.

		     o$parent optional - List of accepted parents for the tag. The format of the list is a comma separated string.

RETURN VALUES

	Returns a BBCode_Container

EXAMPLES

       Example #1

	      bbcode_create(3) example

	      <?php
	      $arrayBBCode=array(
		  ''=>	       array('type'=>BBCODE_TYPE_ROOT,	'childs'=>'!i'),
		  'i'=>        array('type'=>BBCODE_TYPE_NOARG, 'open_tag'=>'<i>',
				  'close_tag'=>'</i>', 'childs'=>'b'),
		  'url'=>      array('type'=>BBCODE_TYPE_OPTARG,
				  'open_tag'=>'<a href="{PARAM}">', 'close_tag'=>'</a>',
				  'default_arg'=>'{CONTENT}',
				  'childs'=>'b,i'),
		  'img'=>      array('type'=>BBCODE_TYPE_NOARG,
				  'open_tag'=>'<img src="', 'close_tag'=>'" />',
				  'childs'=>''),
		  'b'=>        array('type'=>BBCODE_TYPE_NOARG, 'open_tag'=>'<b>',
				  'close_tag'=>'</b>'),
	      );
	      $text=<<<EOF
	      [b]Bold Text[/b]
	      [i]Italic Text[/i]
	      [url]http://www.php.net/[/url]
	      [url=http://pecl.php.net/][b]Content Text[/b][/url]
	      [img]http://static.php.net/www.php.net/images/php.gif[/img]
	      [url=http://www.php.net/]
	      [img]http://static.php.net/www.php.net/images/php.gif[/img]
	      [/url]
	      EOF;
	      $BBHandler=bbcode_create($arrayBBCode);
	      echo bbcode_parse($BBHandler,$text);
	      ?>

	      The above example will output:

	      <b>Bold Text</b>
	      [i]Italic Text[/i]
	      <a href="http://www.php.net/">http://www.php.net/</a>
	      <a href="http://pecl.php.net/"><b>Content Text</b></a>
	      <img src="http://static.php.net/www.php.net/images/php.gif" />
	      <a href="http://www.php.net/">
	      [img]http://static.php.net/www.php.net/images/php.gif[/img]
	      </a>

PHP Documentation Group 													  BBCODE_CREATE(3)