CodeIgniter Wiki

Modular Extensions - HMVC

2008-07-20T04:04:14-06:00

Category:Library | Category:Library -> Community | Category:Library -> Extensions | Category:Library -> HMVC

Modular Extensions - HMVC

Modular Extensions makes CodeIgniter modular. Modules are groups of independent CI components (typically, model, controller, view arranged in one application sub-directory) that can be dropped into CodeIgniter applications. HMVC stands for Hierarchical Model View Controller, which is a fancy way of saying nested modules!)

Module Controllers can be used as normal Controllers or HMVC Controllers and they can be used to help you build view partials.

Modular Extensions installation

1) Start with a clean CI install.
2) Set $config[’base_url’] correctly for your installation.
3) Access the URL domain/subdir/index.php/welcome => shows Welcome to CodeIgniter
4) Drop Modular Extensions libraries into application/libraries and application/helpers directories as specified.
5) Access the URL domain/subdir/index.php/welcome => shows Welcome to CodeIgniter
6) Create module directory structure application/modules/welcome/controllers.
7) Move controller application/controllers/welcome.php to application/modules/welcome/controllers/welcome.php.
8) Access the URL domain/subdir/index.php/welcome => shows Welcome to CodeIgniter
9) Create directory application/modules/welcome/views.
10) Move view application/views/welcome_message.php to application/modules/welcome/views/welcome_message.php
11) Access the URL domain/subdir/index.php/welcome => shows Welcome to CodeIgniter

You now have a running Modular Extensions installation.

Installation Guide Hints:
-Steps 1-3 tell you how to get a standard CI install working - if you have a clean/tested CI install, skip to step 4.
-Steps 4-5 show that normal CI still works after installing ME - it shouldn’t interfere with the normal CI setup.
-Steps 6-8 show ME working alongside CI - controller moved to the ME “welcome” module, the view file remains in the CI application/views directory - ME can find module resources in several places, including the application directory.
-Steps 9-11 show ME working with both controller and view in “welcome” module - there should be no files in the application/controllers or application/views directories.

FAQ

Q. What are modules, why should I use them?

A. http://en.wikipedia.org/wiki/Module

Q. What is Modular HMVC, why should I use it?

A. Modular HMVC = Multiple MVC triads

This is most useful when you need to load a view and its data within a view. Think about adding a shopping cart to a page. The shopping cart needs its own controller which may call a model to get cart data. Then the controller needs to load the data into a view. So instead of the main controller handling the page and the shopping cart, the shopping cart MVC can be loaded directly in the page. The main controller doesn’t need to know about it, and is totally isolated from it.

In CI we can’t call more than 1 controller per request. Therefore, to achieve HMVC, we have to simulate controllers. It can be done with libraries, or with this “Modular Extensions HMVC” contribution.

The differences between using a library and a “Modular HMVC” HMVC class is:
1) No need to get and use the CI instance within an HMVC class
2) HMVC classes are stored in a modules directory as opposed to the libraries directory.

Q. Is Modular Extensions HMVC the same as Matchbox?

A. Yes and No. Like Matchbox, ME makes modules “portable” to other installations. For example, if you make a nice self-contained model-controller-view set of files you can bring that MVC into another project by copying just one folder - everything is in one place instead of spread around model, view and controller folders.

ME is different from Matchbox because you can nest those modules. So, from another controller, you can get some of the nice output from the original, tidy MVC set without calling a controller via URI (i.e., another http call using file_get_contents() or curl). You can get controller output without having to go out through the http interface again.

Modular HMVC means modular MVC triads. Matchbox and Modular Extensions allows related controllers, models, libraries, views, etc. to be grouped together in module directories and used like a mini application. But, ME goes one step further and allows those modules to “talk” to each other.

Note:
You can find more FAQ at the wiki page Modular Extensions - FAQ

Features:

All controllers can contain an $autoload class variable, which holds an array of items to load prior to running the constructor. This can be used instead of module/config/autoload.php, however using the file takes precedence over the class variable.

Modules::run() output is buffered, so any data returned or output directly from the controller is caught and returned to the caller. In particular, $this->load->view() can be used as you would in a normal controller, without the need for return.

Controllers can be loaded as class variables of other controllers using $this->load->module(’module/controller’); or simply
$this->load->module(’module’); if the controller name matches the module name.

Any loaded module controller can then be used like a library, ie: $this->module_controller->do_stuff(), but it has access to its own models and libraries independently from the caller.

Module controllers can have independent methods, located in a module/methods directory, these methods act as libraries extending their parent controller and have access to the parent controller features.

Loading a method is achieved from a module controller by using $this->load->method(’method’); or from a view by using modules:run(), if the method name is not defined in the controller then the method subclass will be loaded and its own index() method will be called, however if the controller actually has the method, it will be called as normal.

Controllers also have a instance() method that can be used instead of get_instance() in libraries and helpers etc.
ie: $ci = controller::instance();

Of course all module controllers are accessible from the URL via module/controller/method or simply module/method if the module and controller names match.

However if you add the _remap() method to your controllers you can prevent unwanted access to them and redirect or flag an error as you like.

Download

Download version 4.0: File:modular extensions 4032.zip (final)
Download new version 4.2: File:modular extensions 4206.zip

Note: Version 4.2 is not backward compatible with version 4.0

View Partials

Your modules output will be buffered by the modules::run() function and the explicit return used in earlier versions is no longer required.

Using a Module as a view partial from within a view is as easy as writing:


echo modules::run('module', $data, 'method') ?>

The $data and ‘method’ above are optional. The default method is index.

Tips and Tricks:

Using language files
application/modules/home/language/home_lang.php
Put this in your controller-file:


$this->load->language('home');

On your view-file:


echo $this->lang->line('name');?>

If you want to specify the language of the language-file you are going to use, you can alter the first line in something like:


$this->load->language('home','english');

Using debug
The debug_helper has two debug methods you might like to look at.

debug($any_object); will display the $any_object and list its loaded libraries, using $this will display the current module.

debug_in($any_object) or debug_in($any_array) will do a full dump on the subject.

NOTE:
If you debug_in() the CodeIgniter Core ($CI), you will get a page full of recursive arrays. This is not an issue because most of the recursions are only references back into $CI core objects.

Issues

Do not use the MY_Controller extension in your application/libraries directory. This will cause CodeIgniter to bypass loading Modular Extensions and modules will not function. If you need to run methods in a base controller define them in another module controller and use the controller autoload functionality.

MY_ prefixed resources are not loaded by ME when they are inside the module directory (e.g., MY_directory_helper.php is not loaded when it is in the modulename/helpers directory). This is because ME doesn’t check for MY_ extensions in modules. To get new functionality using helpers, plugins, models, etc… either make a new named file and load that resource or put your MY_ prefixed resource up in the requisite application directory (helpers for a MY_ helper, libraries for a MY_ library, etc...).

NOTE:
Do you get notices or error-messages? You might want to have a look at the wiki page
Modular Extensions - Notices and errors as well.

Masterpages for CodeIgniter

2008-07-18T21:15:50-06:00

Category:Library:Views Category:Library:Community

Note: This is a PHP5 library.

application/libraries/MasterPage.php

if ( ! defined ( 'BASEPATH' ) ) exit ( 'No direct script access allowed.' );
/**
 * @author Kim Johansson 
 * @copyright Copyright (c) 2008, Kim Johansson
 *
 * @version 0.0.1
 */
class MasterPage {
    private $masterPage = '';
    private $contentPages = array ( );
    private $ci = null;

    /**
     * @access public
     * @param string $masterPage Optional file to use as MasterPage.
     */
    public function __construct ( $masterPage = '' ) {
        $this->CI = get_instance ( );
        if ( ! empty ( $masterPage ) )
            $this->setMasterPage ( $masterPage );
    }

    /**
     * @access public
     * @param string $masterPage File to use as MasterPage.
     */
    public function setMasterPage ( $masterPage ) {
        // Check if the supplied masterpage exists.
        if ( ! file_exists ( APPPATH . 'views/' . $masterPage . EXT ) )
            throw new Exception ( APPPATH . 'views/' . $masterPage . EXT );
        $this->masterPage = $masterPage;
    }

    /**
     * @access public
     * @return string The current MasterPage.
     */
    public function getMasterPage ( ) {
        return $this->masterPage;
    }

    /**
     * @access public
     * @param string $file The view file to add.
     * @param string $tag The tag in the MasterPage it should match.
     * @param mixed $content The content to be used in the view file.
     */
    public function addContentPage ( $file, $tag, $content = array ( ) ) {
        $this->contentPages[$tag] = $this->CI->load->view ( $file, $content, true );
    }

    /**
     * @access public
     * @param array $content Optional content to be added to the MasterPage.
     */
    public function show ( $content = array ( ) ) {
        // Get the content of the MasterPage and replace all matching tags with their
        // respective view file content.
        $masterPage = $this->CI->load->view ( $this->masterPage, $content, true );
        foreach ( $this->contentPages as $tag => $content ) {
            $masterPage = str_replace ( '. ucfirst ( strtolower ( $tag ) ) . ' />',
            $content, $masterPage );
        }

        // Finally, print the data.
        echo $masterPage;
    }
}
?>

Usage:

In the controller:

class MyController extends Controller {
    public function __construct ( ) {
        parent::__construct ( );
        $this->load->library ( 'masterpage' );
    }

    public function index ( ) {
        $this->masterpage->setMasterPage ( 'masterpage_default' );
        // content_index is the view file to use.
        // content is the tag in the masterpage file we want to replace.
        $this->masterpage->addContentPage ( 'content_index', 'content' );

        // Show the masterpage to the world!
        $this->masterpage->show ( );
    }
}

The masterpage:
application/views/masterpage_default.php

<html>
    <head>
        <title>title>
    head>

    <body>

<mp:Content />
    body>
html>

The viewfile:
application/views/content_index.php


<h1>Hello world!h1>

That’s about it, if you want to know more, just email me at hagbarddenstore _at_ gmail _dot_ com.

KNDB Session

2008-07-17T08:31:19-06:00

Category:Library -> Session

Native Session makes good use of PHP’s native session handling abilities, but it does not allow the use of a database for session storage. KNDB Session (which stands for Kirilisa’s Native Database session) is a hybrid which is based upon Native Session (with some notable changes) but allows use of databases via PHP’s ability to store sessions in a DB.

Overview

- KNDB Session is based on Native Session but has database functionality built in.
- Should be compatible with Codeignitor version 1.54 and 1.6.
- Designed as drop-in replacement for CI’s bundled session library.
- Allows you to access values from single-dimensional arrays & objects stored in the session
- Config options and flash data are supported (with exception of session encryption).
- When using with a database, only the session_id is stored in a cookie. Any other data is stored in the database.
- When using without a database, only the session_id is stored in a cookie. Any other data is stored in a file on the server (as PHP does natively).
- KNDB Session is written for PHP5 but could be slightly altered to work with PHP4 (most notably the regenerate_id() method)

Differences between KNDB Session and Native Session

- Allows use of a database for session storage
- Keeps track of both sess_expiration and sess_time_to_update (in config) and thus distinguishes between session id needing regeneration and the session actually expiring (Native session considered sess_expiration as the time needed to regenerate a session id and never expires the session)
- Added method all_userdata() to get all session data: this method is in CI’s bundled session library but missing from Native Session
- Allows you to access values from single-dimensional arrays & objects stored in the session
- Made some changes to regenerate_id() method to shorten code and a fix potential bug there

Required Database Structure

CREATE TABLE sessions (                                                                                                                           
session_id varchar(32) NOT NULL,                                                                                                                  
session_last_access int(10) unsigned,                                                                                                             
session_data text,                                                                                                                                
PRIMARY KEY (session_id)                                                                                                                          
);

Example Configuration (/system/application/config/config.php)

$config['sess_cookie_name']            = 'CISESSION';
$config['sess_expiration']            = 7200;
$config['sess_encrypt_cookie']        = FALSE;
$config['sess_table_name']            = 'sessions';
$config['sess_match_ip']            = TRUE;
$config['sess_match_useragent']        = TRUE;
$config['sess_use_database']        = TRUE;
$config['sess_time_to_update']        = 300;

Usage

- Place the code in a file named Session.php in your /system/application/libraries/ directory.
- Use this lib as if you would CI’s bundled session library.

Changelog

March 31, 2008: Added ability for values to be retrieved from single-dimensional arrays in the session
April 10, 2008: Added ability for values to be retrieved from objects in the session

Code

if (!defined('BASEPATH')) exit('No direct script access allowed');
/**
 * Code Igniter
 *
 * An open source application development framework for PHP 4.3.2 or newer
 *
 * @package     CodeIgniter
 * @author      Elise Bosse
 * @copyright   Copyright (c) 2008, E.Bosse
 * @license     http://www.codeignitor.com/user_guide/license.html
 * @link        http://www.codeigniter.com
 * @since       Version 1.2
 * @filesource
 */

// ------------------------------------------------------------------------

/**
 * Session class using native PHP session features and hardened against session fixation.
 * Non-database part is based upon Dariusz Debowczyk's Native session library with some updates.
 * The DB part makes use of PHP's session_set_save_handler() functionality
 * This library is written for PHP 5 but it could be altered a bit to make it work in PHP4
 *
 * @package     CodeIgniter
 * @subpackage  Libraries
 * @category    Sessions
 * @author      Elise Bosse
 * @link        http://www.codeigniter.com/user_guide/libraries/sessions.html
 * @class link  http://codeigniter.com/wiki/KNDB_Session/
 */

/**
 * If using a database, create the following database table and make sure config file is set properly
 *
 * CREATE TABLE sessions (
 * session_id varchar(32) NOT NULL,
 * session_last_access int(10) unsigned,
 * session_data text,
 * PRIMARY KEY (session_id)
 * );
*/

class CI_Session {

  private $_lifetime; 
  private $_sess_id_ttl;
  private $_match_ip;
  private $_match_useragent;
  private $_sess_db;  
  private $_useDB;
  private $_sess_table;
  private $_flash_key = 'flash'; // prefix for "flash" variables (eg. flash:new:message)

  function __construct()
  {
    $this->object =& get_instance();

    // set config variables
    $this->_lifetime = $this->object->config->item('sess_expiration');
    $this->_sess_id_ttl = $this->object->config->item('sess_time_to_update');
    $this->_match_ip = $this->object->config->item('sess_match_ip');
    $this->_match_useragent = $this->object->config->item('sess_match_useragent');
    $this->_useDB = $this->object->config->item('sess_use_database');
    $this->_sess_table = $this->object->config->item('sess_table_name');

    log_message('debug', "Session Class Initialized");

    $this->_sess_run();
  }

  /**
   * Starts up the session system for current request
   */
  function _sess_run()
  {
    // Set session table and register this object as the session handler, if using databases
    if ($this->_useDB == TRUE) {
      session_set_save_handler(array(&$this, "_open"), array(&$this, "_close"), array(&$this, "_read"),
                   array(&$this, "_write"),array(&$this, "_destroy"),array(&$this, "_gc"));
    }

    session_start();

    // if no lifetime set in config, set to 2 years
    if (!is_numeric($this->_lifetime) || $this->_lifetime <= 0) {
      $this->_lifetime = (60*60*24*365*2);
    }

    // if no session ID regeneration time set in config, set to 30 minutes
    if (!is_numeric($this->_sess_id_ttl) || $this->_sess_id_ttl <= 0) {
      $this->_sess_id_ttl = 1800;
    }

    // check if session has expired
    if ($this->_session_expired()) {
      $this->sess_destroy();
      return FALSE;
    }

    // match IP address if necessary
    if ($this->_match_ip == TRUE) {
      if ($this->_ips_match() == FALSE) {
    $this->sess_destroy();
    return FALSE;
      }
    }
    
    // match user agent if necessary
    if ($this->_match_useragent == TRUE) {
      if ($this->_useragents_match() == FALSE) {
    $this->sess_destroy();
    return FALSE;
      }
    }

    // regenerate session id if necessary
    // session data stays the same, but old session storage is destroyed
    if ( $this->_sess_id_expired() ) {      
      $this->regenerate_id();
    }

    // delete old flashdata (from last request)
    $this->_flashdata_sweep();

    // mark all new flashdata as old (data will be deleted before next request)
    $this->_flashdata_mark();

    // finally, set last access time to now
    $this->set_userdata('sess_last_access', time());
  }

  /**
   * Checks if session has expired
   */
  function _session_expired()
  {
    // if this is the first time coming in, initialize access time
    if (!$this->userdata('sess_last_access')) {
      $this->set_userdata('sess_last_access', time());
      return FALSE;
    }

    $delta = time() - $this->userdata('sess_last_access');

    if ($delta  >=  $this->_lifetime ) {
      return true; 
    }

    return false;
  }

  /**
   * Checks if stored IP matches current IP
   */
  function _ips_match() {
    // if this is the first time coming in, initialize IP address
    if (!$this->userdata('sess_ip_address')) {
      $this->set_userdata('sess_ip_address',  $this->object->input->ip_address());
      return TRUE;
    }    

    return $this->userdata('sess_ip_address') == $this->object->input->ip_address();
  }

  /**
   * Checks if stored user agent matches current user agent
   */
  function _useragents_match() {
    // if this is the first time coming in, initialize user agent
    if (!$this->userdata('sess_useragent')) {
      $this->set_userdata('sess_useragent', trim(substr($this->object->input->user_agent(), 0, 50)));
      return TRUE;
    }    

    return $this->userdata('sess_useragent') == trim(substr($this->object->input->user_agent(), 0, 50));
  }


  /**
   * Checks if session id needs regenerating
   */
  function _sess_id_expired()
  {
    // if this is the first time coming in, initialize regenerated time
    if (!$this->userdata('sess_last_regenerated')) {
      $this->set_userdata('sess_last_regenerated', time());
      return false;
    }

    $delta = time() - $this->userdata('sess_last_regenerated');

    if ( $delta >=  $this->_sess_id_ttl ) { 
      return true;
    }

    return false;
  }


  /**
   * Regenerates session id
   */
  function regenerate_id()
  {
    // regenerate session id and store it
    // $delete_old_session parameter works in PHP5 only! 
    session_regenerate_id(TRUE);

    // update the session generation time
    $this->set_userdata('sess_last_regenerated', time());
  }


  /**
   * Destroys the session and erases session storage
   */
  function sess_destroy()
  {
    session_unset();
    if ( isset( $_COOKIE[session_name()] ) )
      {
    //@@@ was having trouble just using setcookie() because it wasn't unsetting fast enough
    unset($_COOKIE[session_name()]);
    setcookie(session_name(), '', time()-42000, '/'); //@@@
      }

    session_destroy();
  }


  /**                                                                                                                                             
   * returns the session id of the current session                                                                                                
   */
  function get_sess_id() {
    return session_id();
  }


  /**
   * Reads given session attribute value: single variable, element of single dimensional array, or property of object
   * I was kind of of two minds about whether the object bit should be implemented
   * so you can take out that logic if you wish
   */    
  function userdata($item, $subitem=null)
  {
    // this item is in an array
    if ($subitem) {
      if ($subitem == 'session_id'){ //added for backward-compatibility                                                                           
        return session_id();
      } else {
        // array vs. object: handled differently
        if (isset($_SESSION[$item])) {
          if (is_array($_SESSION[$item])) return (!isset($_SESSION[$item][$subitem])) ? false : $_SESSION[$item][$subitem];
          if (is_object($_SESSION[$item])) return (!isset($_SESSION[$item]->$subitem)) ? false : $_SESSION[$item]->$subitem;
          return false;
        }
      }
    }

    // this item is not in an array
    else {
      if($item == 'session_id'){ //added for backward-compatibility
        return session_id();
      } else {
        return ( ! isset($_SESSION[$item])) ? false : $_SESSION[$item];
      }
    }

  }

  /**
   * Returns all session data
   */    
  function all_userdata()
  {
    if (isset($_SESSION['session_id'])) { //added for backward-compatibility
      $_SESSION['session_id'] = session_id();
    }
    return $_SESSION;
  }

  /**
   * Sets session attributes to the given values
   */
  function set_userdata($newdata = array(), $newval = '')
  {
    if (is_string($newdata))
      {
    $newdata = array($newdata => $newval);
      }

    if (count($newdata) > 0)
      {
    foreach ($newdata as $key => $val)
      {
        $_SESSION[$key] = $val;
      }
      }
  }

  /**
   * Erases given session attributes
   */
  function unset_userdata($newdata = array())
  {
    if (is_string($newdata))
      {
    $newdata = array($newdata => '');
      }

    if (count($newdata) > 0)
      {
    foreach ($newdata as $key => $val)
      {
        unset($_SESSION[$key]);
      }
      }
  }


/**
* Sets "flash" data which will be available only in next request (then it will
* be deleted from session). You can use it to implement "Save succeeded" messages
* after redirect.
*/
  function set_flashdata($key, $value)
  {
    $flash_key = $this->_flash_key.':new:'.$key;
    $this->set_userdata($flash_key, $value);
  }

  /**
   * Keeps existing "flash" data available to next request.
   */
  function keep_flashdata($key)
  {
    $old_flash_key = $this->_flash_key.':old:'.$key;
    $value = $this->userdata($old_flash_key);

    $new_flash_key = $this->_flash_key.':new:'.$key;
    $this->set_userdata($new_flash_key, $value);
  }

  /**
   * Returns "flash" data for the given key.
   */
  function flashdata($key)
  {
    $flash_key = $this->_flash_key.':old:'.$key;
    return $this->userdata($flash_key);
  }

  /**
   * PRIVATE: Internal method - marks "flash" session attributes as 'old'
   */
  function _flashdata_mark()
  {
    foreach ($_SESSION as $name => $value)
      {
    $parts = explode(':new:', $name);
    if (is_array($parts) && count($parts) == 2)
      {
        $new_name = $this->_flash_key.':old:'.$parts[1];
        $this->set_userdata($new_name, $value);
        $this->unset_userdata($name);
      }
      }
  }

  /**
   * PRIVATE: Internal method - removes "flash" session marked as 'old'
   */
  function _flashdata_sweep()
  {
    foreach ($_SESSION as $name => $value)
      {
    $parts = explode(':old:', $name);
    if (is_array($parts) && count($parts) == 2 && $parts[0] == $this->_flash_key)
      {
        $this->unset_userdata($name);
      }
      }
  }




  /************* DATABASE METHODS ***************/
  function _open()
  {
    if ($this->_sess_db = mysql_connect($this->object->db->hostname, 
                    $this->object->db->username, 
                    $this->object->db->password)) {
      return mysql_select_db($this->object->db->database, $this->_sess_db);
    }
    
    return FALSE;
  }

  function _close()
  {
    if ($this->_sess_db) {
      return mysql_close($this->_sess_db);
    }

    return TRUE;
  }
  
  function _read($id)
  {
    $id = mysql_real_escape_string($id);
    
    $sql = "SELECT session_data FROM $this->_sess_table WHERE session_id = '$id'";
    
    if ($result = mysql_query($sql, $this->_sess_db)) {
      if (mysql_num_rows($result)) {
    $record = mysql_fetch_assoc($result);
    
    return $record['session_data'];
      }
    }
    
    return '';
  }
  
  function _write($id, $data)
  {
    $access = time();

    $id = mysql_real_escape_string($id);
    $access = mysql_real_escape_string($access);
    $data = mysql_real_escape_string($data);
    
    $sql = "REPLACE INTO $this->_sess_table VALUES ('$id', '$access', '$data')";
    
    return mysql_query($sql, $this->_sess_db);
  }
  
  function _destroy($id)
  {
    $id = mysql_real_escape_string($id);
    
    $sql = "DELETE FROM $this->_sess_table WHERE session_id = '$id'";

    return mysql_query($sql, $this->_sess_db) or die("failed to delete
");
  }
  
  function _gc($max)
  {
    $old = time() - $max;
    $old = mysql_real_escape_string($old);
    
    $sql = "DELETE FROM $this->_sess_table WHERE session_last_access < '$old'";
    
    return mysql_query($sql, $this->_sess_db);
  }


}
?>

JTaby CRUD System

2008-07-17T08:31:08-06:00

Category:Library -> CodeGenerators | Category:Library -> Community

Introduction

Hello Everyone,
I’ve been working with CI for 3 months now and as soon as I built my first project, I noticed that something was missing: A backend generator. So I started working on one for my own project then I noticed that it was generic enough and flexible enough to reworked as a bunch of libraries working together. Then while browsing the forums, I kept seeing requests from people who need a way to generate a backend for themselves, or their clients. After seeing how my client reacted to the system, I decided to release the system and share it with everyone, so, here goes:

Current Release: 1.2.1

IMPORTANT NOTE: Please make sure you have the latest version, the previous versions had bugs which could possible present security holes.

There are two versions to download: The basic, and the full. The full comes with CI bundled, the basic does not. However, the full comes with a CI bug fixed which used to cause an error when global xss filtering is on.

To install the basic version, just drag & drop the files/folders into their respective folders (as shown in the directory structure of the zip)

Resources

Live Demo (username: demo, password: demo)
Documentation
Download JTabyBackend Basic (932 KB)
Download link (With CI Bundled - contains a bug fix) (1.2 MB)
Setup video
Forum

The zip also contains CodeIgniter (latest release). The video should be sufficient to help you setup the system and play with it. It shouldn’t take you longer than 1 hour to figure how everything works, it’s quite simple: Just look at the bundled examples.

Main System Features

- Transparent multi-level login
- Validation
- Unified messaging system
- on-the-fly form generation
- Extremely rapid development (~40 lines per controller)

Version 1.2.1 Changelog:
- Fixes a bug which triggered a “Cannot redeclare class TextBox” in PHP4

New Features in version 1.2:
- Sorting
- Multiple fields in list view
- Bug fixes of all sorts

Notes

- It has come to my attention (Athfar, #codeigniter on irc.freenode.net) that IE7 is PMS’ing about the CSS, so instead of fixing it, I’m going to do what any die-hard OCD’er would do, and redesign the whole thing, make it brighter and happier :)
- Please note that this is the first time I release open-source code like this, so let me know if I’m doing this wrong.
- I’m working on getting a hosting account to host the file and a demo.
- The video takes a bit to load, but once it’s loaded, it should play fine.

Get Cache File Contents

2008-07-17T08:30:49-06:00

Category:Library -> Cache | Category:Library -> Community

Here is an extension for the Output Library that aims to retrieve cached file contents and let you do fragment caching.

You just have to create a file called MY_Output.php in the system/application/libraries folder and put this code in the file :

class MY_Output extends CI_Output {

    function My_Output()
    {
        parent::CI_Output();
    }

    function get_cached_file($url) {
            $CI =& get_instance();

            /* defines cache path */
            $cache_path = "system/cache/";
            if(strlen($CI->config->item('cache_path')) > 0) {
                $cache_path = $CI->config->item('cache_path');
            }

            /* retreives cache file */
            $cached_url = base_url().$CI->config->item('index_page')."/".$url;
            $cached_file = $cache_path.md5($cached_url);

            /* checks if cached file exists */
            
            if(file_exists($cached_file)) {
        
                /* gets cached content and removes timestamp */
                
                $handle = fopen($cached_file, "r")
                $contents = fread($handle, filesize($cached_file));
                fclose($handle);
                $timestamp_pos = strpos($contents, "--->");
                $contents = substr($contents, ($timestamp_pos + 4));
                return $contents;
        
            }
        
            return FALSE;
    }
}

?>

Then the usage is pretty simple. Imagine you’ve called the $this->output->cache(); function from the sample_controller, within the sample_method, then you would access this fragment this way:


http://www.yoursite.com/sample_controller/sample_method/

Then you can use the new get_cached_file function to get the cached contents of this page. And you can do it this way:


$this->output->get_cached_file('sample_controller/sample_method')

AJAX for CodeIgniter

2008-07-17T08:29:46-06:00

Category:Library -> Community | Category:Library -> AJAX

AJAX for CodeIgniter is a CodeIgniter library that provides you with AJAX functionality for your CodeIgniter web applications. It comes with simple to use AJAX helpers that you can directly put in use in your apps.o AJAX fr CodeIgniter includes both Prototype and Scriptaculous helpers. This is compatible with CodeIgniter 1.5.1.

Download: File:AJAX-for-CodeIgniter.zip

Download: File:AJAX-for-CodeIgniter v2.zip (with fixed bug)

Below is a quick and simple how-to-use article. For code references and full class documentation, please read the full user guide that comes with the zip file (follow the above link to download).

Enjoy this release.
- siric

How to use AJAX for CodeIgniter?

Place the AJAX library in the following directory (default libraries directory):


www-root/system/libraries/

Place the javascript files in your www root directory. For example:


www-root/javascript/

If you use mod_rewrite, make sure you allow the javascript directory to be accessed. To do this, set up your .htaccess file to look something like this:

RewriteEngine on
RewriteCond $1 !^(index\.php|images|stylesheets|javascript)
RewriteRule ^(.*)$ /index.php/$1 [L]

Then, simply include whichever javascript files you would like to use in your html file:

<script src="javascript/prototype.js" type="text/javascript">
<script src="javascript/effects.js" type="text/javascript">
<script src="javascript/dragdrop.js" type="text/javascript">
<script src="javascript/controls.js" type="text/javascript">

Finally, load up the AJAX library as you would with any other CodeIgniter library. There are two possible ways to do this. Directly from within your controller:


$this->load->library('ajax');

Or, auto-load the AJAX library from within system/application/config/autoload.php:


$autoload['libraries'] = array('database', 'session', 'ajax');

Then all you need to do to use an AJAX helper is to call $this->ajax. For example:

echo $this->ajax->link_to_remote("Login", array('url' => '/login', 'update' => 'divblock'));