BBCODE_ADD_SMILEY(3)							 1						      BBCODE_ADD_SMILEY(3)

bbcode_add_smiley - Adds a smiley to the parser

SYNOPSIS

       bool bbcode_add_smiley (resource  $bbcode_container, string  $smiley, string  $replace_by)

DESCRIPTION

	Adds a smiley to the parser

PARAMETERS

	      o $bbcode_container
		- BBCode_Container resource, returned by bbcode_create(3).

	      o $smiley
		- The string that will be replaced when found.

	      o $replace_by
		- The string that replace smiley when found.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      bbcode_add_smiley(3) usage example

	      <?php
	      /*
	       * Prepare the rule set
	       */
	      $arrayBBCode=array(
		  ''=>	       array('type'=>BBCODE_TYPE_ROOT,
				     'childs'=>'!i'),
		  'b'=>        array('type'=>BBCODE_TYPE_NOARG,
				     'open_tag'=>'<b>',
				     'close_tag'=>'</b>'),
		  'u'=>        array('type'=>BBCODE_TYPE_NOARG,
				     'open_tag'=>'<u>',
				     'close_tag'=>'</u>',
				     'flags'=>BBCODE_FLAGS_SMILEYS_OFF),
		  'i'=>        array('type'=>BBCODE_TYPE_NOARG,
				     'open_tag'=>'<i>',
				     'close_tag'=>'</i>',
				     'childs'=>'b'),
	      );
	      /*
	       * Parsed Text
	       */
	      $text=<<<EOF
	      [i] No parse Test [/i] :)
	      [b] Parsed, with smiley :( [/b]
	      [u] Parsed, with no smiley :D [/u]
	      EOF;
	      /*
	       * Init the parser
	       */
	      $BBHandler=bbcode_create($arrayBBCode);
	      /*
	       * Add Smiley rules to parser
	       */
	      bbcode_add_smiley($BBHandler, ":)", "<img src="smiley.gif" alt=":)" />");
	      bbcode_add_smiley($BBHandler, ":(", "<img src="sad.gif" alt=":(" />");
	      bbcode_add_smiley($BBHandler, ":D", "<img src="happy.gif" alt=":D" />");
	      bbcode_add_smiley($BBHandler, ":p", "<img src="tong.gif" alt=":p" />");
	      bbcode_add_smiley($BBHandler, ":|", "<img src="special.gif" alt=":|" />");
	      bbcode_add_smiley($BBHandler, ":6:", "<img src="six.gif" alt=":6:" />");
	      /*
	       * Parse the text
	       */
	      echo bbcode_parse($BBHandler,$text);
	      ?>

	      The above example will output:

	      <i> No parse Test </i> <img src="smiley.gif" alt=":)" />
	      <b> Parsed, with smiley <img src="sad.gif" alt=":(" /> </b>
	      <u> Parsed, with no smiley :D </u>

PHP Documentation Group 												      BBCODE_ADD_SMILEY(3)