BB Code Enhancements - Cel PHP in Custom BBCode

This addon allows for PHP-Code to be used in Custom BBCodes

It offers a framework for the easy integration and sharing of custom BBCodes that are based on PHP processing of the data entered by the user. It could, for example, be used to develop BBCodes that use multiple options or to poll database information. It does allow for the Admin to use PHP in the Backend - it does, of course, not allow this to forum visitors.

You need to know PHP to use this Addon to develop your own PHP based bbcodes, however it would be possible to share them as an extension to this addon.


Installation:
- install the product file - done.


Using PHP in Custom BBCodes:
Create your Custom BBCode as always, and just put your PHP into the Replacement box (where the HTML used to go).

Just remember two things:

• Your code needs to start with <?php
• You need to return the result of your code.

If you're unsure what that means, read the php manual on eval() and look at the evaltest example in the second post.

For coders: include instead of eval
If you'd rather store the PHP for your new BBCodes in the file system for ease of development, that's possible, too:

• create a folder called "custombbcodes" in your forum root
• in that folder, create a php file that copies your BBCode Tag Name (ie. if your tag name is "includetest", the file needs to be called "includetest.php"). That's where your PHP goes.
• in the Replacement box in the Custom BBCode Dialog, just put the word "include", nothing else
• Since there's no eval() here, no need to return the result. Instead, it needs to go into $parsed.There's also an includetest example in the second post.

No Support for your PHP-Code!

### See the example BBCodes in the second post (click)! ###

### Don't forget to click install! ###
(No support if you don't)

[cellarius]

PHP BBCode Examples:

To test them, go to AdminCP->Custom BB Codes->Add new BB Code and fill in the form:

--------------------------------------------------------------------

• Title: evaltest
• BBCode Tag Name: evaltest
• Replacement:

PHP Code:

<?php
/* 
Please note: 
  
- available variables: 
    param => $value, option => $option
    remember: [bbcode=option]param[/bbcode] 

- pass your result via return (as needed for PHP eval)
    so end your code with return $my_result */

$my_result = "Test per eval (here no option was used):  "; 
$my_result .= "Parameter: <strong>" . $value . "</strong>";

return $my_result; ?>

• Example: [evaltest]Hello World![/evaltest]
• Use {option}: No

--------------------------------------------------------------------

• Title: includetest
• BBCode Tag Name: includetest
• Replacement:

[code]include[code]

• Example: [includetest="World!"]Hello![/includetest]
• Use {option}: Yes

Additionally, you need to create a directory called custombbcodes, and in it create a file called includetest.php with the following code:

PHP Code:

<?php
    /* 
Please note:
   
- available variables: 
    param => $value, option => $option
    remember: [bbcode=option]param[/bbcode] 
- all output needs to go to $parsed
    no return statement needed (different from direct eval method)
    so don't use echo "Hello World", but $parsed = "Hello World"
*/

$parsed = "Test per include (here option was used): ";
$parsed .= "Parameter = <strong>" . $value . "</strong>, ";
$parsed .= "Option = <strong>" . $option . "</strong>";

--------------------------------------------------------------------

[AttalaEA]

Please I don't understand what this Mod is doing since I am a beginner can you please give us a simple clarification?

Thank You

[cellarius]

If you're not familiar with PHP this addon probably is not for you. It allows you to use PHP code when processing BBCodes, so you are much more free when it comes to what you can do with BBCodes. You could do BBCodes with multiple options, for example, or poll your database for information. But you'd need to write the code for that yourself, this offers just the framework to run that code.

[radiofranky]

this is what i'm looking for. T

[cellarius]

Then mark as installed

[mishwar222]

Nice work! thank you

I need a little help please. I am trying to make bbcode with three options. I need the pop up form for the option to have three text areas for three inputs. It is ok with me if the contents of those areas got in one string after submitting them. I can divide them in the php file. is this possible? if not is there anyway to make a pop up form of my own?

[lemonadesoda]

cellarius, this looks really useful! But could you kindly review your OP and possibly add more info, and clarify some potentially confusing language. Simplify your sentence construction so that someone who has english as a second language can understand 100%.

Same goes for your examples post. A more interesting third example would be great too! The magic is in the write up! Not just the code :-)

[Kyojii]

If you needed to do a query with the value is it already sanitized?

[cellarius]

Havn't checked that. Just give it a try.