WordPress-Simple-MVC-Framework-Plugin-Mode

A simple MVC framework for Wordpress, support static class methods, merged with Smarty Template. WordPress-Simple-MVC-Framework-Plugin-Mode is under MIT Copyright (c) 2012 Zhehai He [email protected] version 0.92

For theme mode user, please check https://github.com/hezachary/WordPress-Simple-MVC-Framework

Structure Updates:

a. Starts from 0.92, WordPress-Simple-MVC-Framework core code locates as Wordpress Plugin. Developer can setup local and community.

b. ini is different, in your function.php

    <?php
    /**
     * Please define CONFIG_PATH as you config directory
     **/
    define('CONFIG_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR.'config');
    //Then Load the mvc plugin 
    do_action('simple_mvc_framework');
    ?>

Installation:

a. Please copy all the file to your \wp-contentplugin\simple-mvc-framework directory.

Example:

Your project plunin : \wp-content\plugins

The MVC framework : \wp-content\plugins\simple-mvc-framework

After you install the mvc, the mvc.ini.php is at \wp-content\plugins\simple-mvc-framework\mvc.ini.php

b. Active the plugin Simple MVC Framework in Admin - Plugin Panel

c. Copy the theme directory under \wp-content\plugins\simple-mvc-framework\themes to your \wp-content\themes directory.

Or you can just study the source code under it to developing your own mvc themes.

d. The MVC also supports Zend Framework and Smarty by default, to install them, please:

1. Zend Framework - Copy all the Zend framework files in \core\libs\Zend
2. Smarty - Copy all the Smarty files in \core\libs\Smarty -- http://www.smarty.net/download

Settings:

a. Please read the file comments in config directory I. For Url Rewrite: router.config.php http://codex.wordpress.org/Class_Reference/WP_Rewrite

How to use:

a. In you functions.php:

    <?php
    /**
     * Please define CONFIG_PATH as you config directory
     **/
    define('CONFIG_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR.'config');
    //Then Load the mvc from plugin 
    do_action('simple_mvc_framework');
    
    //Init image sizes your want
    ImageModel::loadImageSize(mvc::app()->aryImageSizeList);
    //For admin panel can see all size images
    ImageModel::loadAdmin(mvc::app()->aryImageSizeList);
    
    //Add extra router rules as you need, please install plugin 'Rewrite Rules Inspector' to active and verify the router rules
    UrlModel::loadRule(mvc::app()->aryRouterList);
    
    //Load extra Taxonomy
    TaxonomyModel::loadTaxonomy(mvc::app()->aryTaxonomyList);
    
    /**
     * For load image via cloudfront cdn
     * @usage: 
     * $aryImageAttr = cdn_get_attachment_image_src($intImageId, $size);
     * echo '<img src="'.aryImageAttr[0].'" alt=""/>';
     **/
    function cdn_get_attachment_image_src($intImageId, $size='thumbnail', $icon = false){
        return ImageModel::wp_get_attachment_image_src($intImageId, $size, $icon, mvc::app()->aryCDNSettings['cloudfront_host']);
    }
    /**
     * For easy debug
     **/
    function _d($value, $blnDumpValues = true, $blnDieAfterDebug = false){
        $debug_backtrace = debug_backtrace();
        ToolsExt::_d($value,$blnDumpValues,$blnDieAfterDebug, $debug_backtrace);
    }
    ?>

b. Please check all the php script files under config directory, especially config\path.config.php: community -> core //If it does not have array key, mvc will locate the directory under it's plugin folder. // return array( 'local' => 'THE/PATH/TO/YOUR/LOCAL/FILE', 'community', //If you do not have `community` code, you can remove this line 'core' ); ?>

b. In your theme files, example: page.php run('page', $post); ?>

How to developing:

a. Load local class first:

1. \wp-content\plugins\simple-mvc-framework\core\ is for core code
2. \wp-content\themes\YOUR-THEME\config\ is for project config
3. \wp-content\themes\YOUR-THEME\local\ is for project code
4. If local and core have same files and classes, local will be loaded. This rule almost apply to all the classes and files.

b. Locate class by CamelCase:

1. Last CamelCase name becomes the base load folder
2. Classname1Classname2Classname3, will be loaded in :

i. classname3\Classname1Classname2Classname3 - right

ii. classname3\classname1\Classname2Classname3 - right

iii. classname3\classname1\classname2\Classname3 - wrong

c. Controler:

1. Use post-type as controler name:

i. mvc::app()->run('page', $post) will load controlers\PageController.class.php

2. Use static method load($objPage, $blnAjax, $aryClassName) to locate proper class to ini the controler object.

Please read : framework\core\base\ControllerBase.class.php comments for public static function load

Samples:

            \wp-content\plugins\simple-mvc-framework\core\controlers\PageController.class.php
            \wp-content\plugins\simple-mvc-framework\core\controlers\page\HomeController.class.php
            \wp-content\plugins\simple-mvc-framework\core\controlers\page\HomeStatusController.class.php

3. Use Post Name (post-slug) as \page\ controller sub name, [-] will be replace with [] The name conversion in code: preg_replace('/\W/', '', ucfirst(strtolower($post_name)))

   Samples:

           Post name [product-detail]
            - Controller Location: \framework\local\controlers\page\Product_detailController.class.php
            - In file Class: class PageProduct_detailController extends ControllerBase { ... }
   

   Caution:

           Do not use any invalid value name as Post Name, such as:
            - 2way-drive - wrong
            - 10-speed-bicycle - wrong
            - drive-2way - right
   

4. Retrieve values from defined source with simple filter:

i. Like most modern mvc, WordPress-Simple-MVC-Framework also supports simple way to pass value direct from PHP magic global values

Such as: $_GET, $_POST, etc

The data source bases on supplied info in comments for the method

There are two types format involved: @packed and (@source + @param + @param + @param + ... etc)

Example: core\controlers\page\HomeStatusController.class.php

            /**
             * @source $_GET
             * @param $page_id int # you can only put native type here, no object type
             **/
            public function ajax($page_id)
            
            /**
             * @packed
             * If you use packed, please defined the source (in lower case) as the paramater
             * In here, it is `$post` - public function form(array $post)
             **/
            public function form(array $post){//Inline area support auto convert array

Reminder: If you use Wordpress Url Rewrite, the value will auto pass into the packed data or the source you defined

4. Router for choose a method in a controler:

i. $_REQUEST['r'] is the name of the method in controler

Example: `$_REQUEST['r'] = 'form'`, `$objControler->form(array $post)`

ii. By default, $objControler->index() will be called, if nothing matches the router defined controler

5. Load View:

i. Please use $this->strTemplateName to define view file.

ii. All the view files are under \wp-content\themes\YOUR-THEME\local\views\ directory

6. Load the Controller as you want, such as - use it in a plugin, or a cron job:

i. Create you custom Controller base and Controller, example: \wp-content\themes\YOUR-THEME\local\controlers\my_custom_admin\TestController.class.php

ii. In the code to load the controller:

            $objTest = new stdClass();
            $objTest->router = 'Test'; //The controller you want to load
            mvc::app()->resetRouter('the_method');//The method you want to load
            echo mvc::app()->run('my_custom_admin', $objTest);//pass in the controler base and object, export page as string
            exit();

7. Suggestion about ACL (Access Control Lists):

i. Use the controller entry as the filter:

            public static function load($objPage, $blnAjax, $aryClassName){
                //you may put you logical in here
                //decided to load current controller or redirect
                //example:
                if(is_user_logged_in()){
                    parent::load($objPage, $blnAjax, get_class(), get_class());
                }else{
                    $aryUrlQuery['redirect_to'] = urlencode($_SERVER['REQUEST_URI']);
                    wp_redirect(str_replace('http://', 'http://', get_permalink(get_page_by_path('/login')->ID)).'?'.http_build_query($aryUrlQuery));
                    exit();
                }
            }

d. Model, you can write any model you want, the rules is same as above 4.b

e. WordPress-Simple-MVC-Framework only supports Smarty as view at the moment, for all the smarty files, please name the extension as .tpl uner \views\

f. View:

1. All the view files is under [\wp-content\themes\YOUR-THEME\local\views] directory

2. WordPress-Simple-MVC-Framework only support Smarty as view at the moment, all the smarty files please name the extension as [.tpl] uner [\views]

Build-in useful extension:

a. Data Validate + Filter Ext, please read the comments in :\wp-content\plugins\simple-mvc-framework\core\extensions\DataValidateExt.class.php

b. Mobile Dectect Ext, please read the comments in :\wp-content\plugins\simple-mvc-framework\core\extensions\MobileDectectExt.class.php

c. Tools Ext: \wp-content\plugins\simple-mvc-framework\core\extensions\ToolsExt.class.php

1. Build array tree:

       $aryTest = ToolsExt::arySetNode($aryTest, $aryTest);
       $aryTree = ToolsExt::arySetTree($aryTest);
   

2. Retrieve User IP

       ToolsExt::retrieveUserIp();
   

3. Debug + Tracing

       ToolsExt::_d($value, $blnDumpValues = true, $blnDieAfterDebug = false);
   

Widgets for smarty template:

a. Suggestion for smarty template : {NavWidget::main($data_try_to_send_to, 'widget.you_want_to_call.tpl', $blnAjax, $blnSuccess, $aryExtratrue)}

b. Example for PHP: \wp-content\plugins\simple-mvc-framework\core\widgets\NavWidget.class.php

About AJAX:

a. Ajax is supported by default, in - mvc::app()->run('controler_base_name', $data, $blnAjax) $blnAjax = true will pass back the result in json format:

{html : 'export data you want', success : true/false, extra_data_name : extra_data_value, extra_data_name : extra_data_value, etc}

Mobile Site Solution:

a. Please access mvc->app()->is_mobile for determin mobile or not. Then update the mvc->app()->view_path = 'mobile-view' to change the mobile view directory.

b. Or, if you use W3 Total Cache (or any other plugin), and use the plugin to shift between themes, you can create a mobile theme. Please check the sample theme mvc-mobile for detail (function.php, config\config.php).

Extra suggestion:

a. Use as much Wordpress default supported function as possible, such as: $wpdb for db operation, wp_mail() for sending email

b. If you are looking some more powerful tools, you may install Zend framework. It has lots useful tools.

The WP plugins highly recommanded for developing with WordPress-Simple-MVC-Framework

a. Advanced Custom Fields

b. CPT-onomies: Using Custom Post Types as Taxonomies

c. Rewrite Rules Inspector

I hope you enjoy the framework.

If you have any suggestion or find any bug, please contact me: [email protected]

Cheers,

Zac