vBulletin LTS

• Encapsulation - encapsulating essentially hides an implementation of a certain method from client code.

Take the following example: I want to determine if a user has permission to do a certain action. Normally, you would simply have:

PHP Code:

          
if(!($permissions['myhackpermissions'] & $vbulletin->bf_ugp['myhackpermissions']['candosomething']))
{
    print_no_permission();
} 


If wrapped in a facade class, you would have something like:

PHP Code:

if(!$this->bridge->permission(‘candosomething’))
  {
             // User doesn't have permission
  } 


See how simple that looks?

The actual implementation of the permission checking would be in the facade class, but it is only the interface that matters. Now instead of sprinkling vBulletin version specific code throughout your system, you are only providing an interface to that specific implementation.

So what happens when vBulletin releases a new major version and the implementation changes? That brings us to our next reason.

• Inheritance - Inheritance provides a way to avoid code duplication and get the most of encapsulation.

Let us go back to the previous permission example. Here is the implementation of the permission method:

PHP Code:

class facade 
 {
           function facade()
           {
                // Some required initialization for vBulletin backend and global variables.
           }
           function permission($option)
           {
                  // Ternary for readability purposes only...
                  return ($permissions[PRODUCT_ID . ‘permissions’] & $vbulletin->bf_ugp[PRODUCT_ID . ‘permissions’][$option]) ? true : false;

           }
   } 


This class is a simple facade with a permission method to encapsulate the data. Now pretend vBulletin 4.0 is released and the entire permission handling is now altered. Instead of having to go through all the hassle of finding and editing the version specific code throughout your modification, you can simple utilize inheritance to update the methods that need to be altered.

PHP Code:

class facade_40 extends facade 
{
      function permission($option)
       {
                // 4.0 specific permission handling
       }

} 


Then at the start of the client code you can determine which class to create:

PHP Code:

if ( //vBulletin version == 4.0 )
{
    $this->bridge = new facade_40()
}
else {
     $this->bridge = new facade();
}

// Code code code.....

if($this->bridge->permission('candosomething'))
{
    //More code 
} 


The example above would normally be a little more dynamic. Listed in the suggested readings below, PHP 5 Objects, Design and Practice list some patterns that help with object generation.

The point of the example is that the code above does not care if $this->bridge is facade or facade_40...the code will continue to function as long as the interface remains. This is an integral concept of OO programming called Polymorphism.

When an upgrade of vBulletin requires that you alter your code, you no longer have to update every single file with the new implementation: Just extend your facade class and add support for proper object generation based on vBulletin version; ultimately saving time from tedious code alterations when you could be adding new, exciting features to your modification.

• Global Variables - Due to the architecture of vBulletin, with a facade type implementation, you may have to globalize some of the default variables that run across vBulletin such as $vbulletin, $phrase, $style, $permissions ...etc...etc...

This type of initialization of global variables will most likely be done within the constructor or initialization function.

As with any global variables, you must take good note not to override any essential data.

• Object Oriented Approach - The Facade pattern requires the use of classes and objects to gain the benefits of encapsulation, inheritance, and composition.

Implementing a facade would require more than one class, so it important that you fully understand OO before implementing any type of design pattern. Do not just use OO because it seems popular to do.