Page_Base Class Reference

Inherited by Page.

List of all members.

Public Member Functions

 Page_Base ()
 set_module ($name)
 set_ajax ($enable=true)
 import_model ($name)
import_plugin ($name)
 redirect ($url)
 redirect_to_referrer ($default_url='')
 return_to_form ($url, $data, $errors=array())
 flash ($message)
 flash_get ()
 flash_isset ()
 flash_clear ()
 param ($key, $default='')
 params ()
 load_input ($req='')
 path_args ($shift=0)
 param_set ($key, $val)
 param_unset ($key)
 tget ($key)
 tset ($key, $var)
 tunset ($key)
 tisset ($key)
 set_layout ($filename)
 render_element ($pagename, $element, $args=array(), $merge_vars=true)
 fetch ($filename, $vars=array(), $language=false)
 render ($filename, $vars=array(), $layout='')
 render_string ($content, $vars=array(), $layout='')
 ajax_render ($filename, $jsvars=array())
 ajax_exec ($js='')
 GET ()
 POST ()
 PUT ()
 DELETE ()
 HEAD ()

Public Attributes

 $web
 $db
 $validator
 $sql
 $models
 $plugins
 $ajax
 $module_name
 $template
 $template_layout

Detailed Description

PRONTO WEB FRAMEWORK Copyright (C) 2006, Judd Vinet

Author:
Judd Vinet <jvinet@zeroflux.org>

Description: Base class for all page controllers (action/view in MVC terms).

Definition at line 12 of file page.php.


Member Function Documentation

Page_Base::ajax_exec ( js = ''  ) 

Convenience function to pass back JavaScript as an AJAX response.

Parameters:
string $js JavaScript to pass back via ajax_render()

Definition at line 467 of file page.php.

Page_Base::ajax_render ( filename,
jsvars = array() 
)

Convenience function to render a template for an AJAX call

Parameters:
string $filename Template file to render
array $jsvars Additional JavaScript variables to pass back

Definition at line 457 of file page.php.

Referenced by redirect_to_referrer(), render(), and return_to_form().

Page_Base::DELETE (  ) 

Definition at line 505 of file page.php.

Page_Base::fetch ( filename,
vars = array(),
language = false 
)

Convenience function to fetch a template

Parameters:
string $filename Template file to render
array $vars Additional variables to include in template
string $language I18N language to set before rendering template

Definition at line 415 of file page.php.

Page_Base::flash ( message  ) 

Set a flash message which will be displayed the next time a template is rendered

Parameters:
string $message

Definition at line 194 of file page.php.

Page_Base::flash_clear (  ) 

Clear any flash message

Definition at line 222 of file page.php.

Page_Base::flash_get (  ) 

Return the currently-set flash message.

Returns:
string

Definition at line 204 of file page.php.

Page_Base::flash_isset (  ) 

Check whether a flash message has been set.

Returns:
boolean

Definition at line 214 of file page.php.

Page_Base::GET (  ) 

The default GET action handler. To be overridden by subclasses.

Definition at line 481 of file page.php.

Page_Base::HEAD (  ) 

Definition at line 513 of file page.php.

Page_Base::import_model ( name  ) 

Instantiate one or more models and load them into the holder

Parameters:
string $name,... Name(s) of model(s) to import

Definition at line 98 of file page.php.

References Factory::model().

& Page_Base::import_plugin ( name  ) 

Import a plugin (aka "page plugin").

Parameters:
string $name Plugin name

Definition at line 113 of file page.php.

References Registry::get(), and Factory::plugin().

Page_Base::load_input ( req = ''  ) 

Process an entire associative array of parameters and return it

Parameters:
array $req Array to load variables from (default is URL/GET/POST)
Returns:
array

Definition at line 274 of file page.php.

References Registry::get().

Page_Base::Page_Base (  ) 

Constructor for all Page elements

Definition at line 31 of file page.php.

References Registry::get(), param(), set_ajax(), set_layout(), and set_module().

Referenced by Page::Page().

Page_Base::param ( key,
default = '' 
)

Fetch a variable from the request arguments, using a default if it doesn't exist

Parameters:
string $key Name of request variable to look for. The search order is URL,GET,POST, with latter variables overwriting the former.
string $default Default to use if variable is missing
Returns:
mixed

Definition at line 243 of file page.php.

References Registry::get().

Referenced by Page_Base(), and params().

Page_Base::param_set ( key,
val 
)

Set (or replace) a parameter in request argument list.

Parameters:
string $key
mixed $val

Definition at line 302 of file page.php.

References Registry::get(), and Registry::set().

Page_Base::param_unset ( key  ) 

Unset a parameter in request argument list.

Parameters:
string $key

Definition at line 314 of file page.php.

References Registry::get(), and Registry::set().

Page_Base::params (  ) 

Fetch a number of variables with a default of "" (empty string)

Parameters:
string $name,... Names of request variables to fetch
Returns:
mixed

Definition at line 258 of file page.php.

References param().

Page_Base::path_args ( shift = 0  ) 

Return an array of arguments from the request path, ignoring the first $shift elements

Parameters:
int $shift Number of elements to ignore
Returns:
array

Definition at line 291 of file page.php.

Page_Base::POST (  ) 

Definition at line 489 of file page.php.

Page_Base::PUT (  ) 

Definition at line 497 of file page.php.

Page_Base::redirect ( url  ) 

Issue a web redirect to a new relative URL

Parameters:
string $url

Definition at line 138 of file page.php.

Referenced by return_to_form().

Page_Base::redirect_to_referrer ( default_url = ''  ) 

Issue a web redirect to the HTTP referrer, falling back to '/' if the referrer is not present

Parameters:
string $default_url URL to redirect to if HTTP_REFERER is empty

Definition at line 149 of file page.php.

References ajax_render(), and url().

Referenced by return_to_form().

Page_Base::render ( filename,
vars = array(),
layout = '' 
)

Convenience function to render a template

Parameters:
string $filename Template file to render
array $vars Additional variables to include in template
string $layout Layout template to use. Empty string for default ($this->template_layout) or set to false for none.

Definition at line 426 of file page.php.

References ajax_render(), and template_layout.

Referenced by Page_Static::GET().

Page_Base::render_element ( pagename,
element,
args = array(),
merge_vars = true 
)

Fetch a page element. Page elements function like normal page controllers, except they can only be called by other page controllers and they return rendered content of some kind.

This method can be called through the Page class directly. Example: Page::render_element('MyPage', 'MyElement');

Parameters:
string $pagename Name of the page class to use (exclude the 'p' prefix)
string $element Name of the element to fetch
array $args Array of arguments to be passed to the element method
boolean $merge_vars If true, merge template variables from the the rendered element into the current page's scope.
Returns:
string Rendered content from the page element method

Definition at line 389 of file page.php.

References $args, Factory::page(), and tset().

Page_Base::render_string ( content,
vars = array(),
layout = '' 
)

Convenience function to render a string through a layout.

Parameters:
string $content Content to render
array $vars Additional variables to include in template
string $layout Layout template to use. Empty string for default ($this->template_layout) or set to false for none.

Definition at line 443 of file page.php.

References DS, and template_layout.

Page_Base::return_to_form ( url,
data,
errors = array() 
)

Used by form handlers to redirect back to the calling form after a failed validation or other errors.

Parameters:
string $url URL to redirect to (leave blank to use referrer)
array $data Form data
array $errors Form errors

Definition at line 168 of file page.php.

References ajax_render(), redirect(), and redirect_to_referrer().

Page_Base::set_ajax ( enable = true  ) 

Enable/Disable AJAX mode. When in AJAX mode, the Page::render() method will automatically call Page::ajax_render() instead. Also, debugging output will be disabled in AJAX mode.

Parameters:
boolean $enable Set to true to enable, false to disable.

Definition at line 80 of file page.php.

Referenced by Page_Base().

Page_Base::set_layout ( filename  ) 

Set the layout (base template) file.

Parameters:
string $filename

Definition at line 367 of file page.php.

References template_layout.

Referenced by Page_Base().

Page_Base::set_module ( name  ) 

Declare this controller (and template object) to be part of a Pronto module.

Parameters:
string $name Module name

Definition at line 67 of file page.php.

Referenced by Page_Base().

Page_Base::tget ( key  ) 

Convenience function for template variables

Parameters:
string $key
Returns:
mixed

Definition at line 332 of file page.php.

Page_Base::tisset ( key  ) 

Convenience function for template variables

Parameters:
string $key
Returns:
bool

Definition at line 358 of file page.php.

Page_Base::tset ( key,
var 
)

Convenience function for template variables

Parameters:
mixed $key
mixed $var

Definition at line 341 of file page.php.

Referenced by Page::Page(), and render_element().

Page_Base::tunset ( key  ) 

Convenience function for template variables

Parameters:
string $key

Definition at line 349 of file page.php.


Member Data Documentation

Page_Base::$ajax

Definition at line 20 of file page.php.

Page_Base::$db

Definition at line 15 of file page.php.

Page_Base::$models

Definition at line 18 of file page.php.

Page_Base::$module_name

Definition at line 22 of file page.php.

Page_Base::$plugins

Definition at line 19 of file page.php.

Page_Base::$sql

Definition at line 17 of file page.php.

Page_Base::$template

Definition at line 24 of file page.php.

Page_Base::$template_layout

Definition at line 25 of file page.php.

Page_Base::$validator

Definition at line 16 of file page.php.

Page_Base::$web

Definition at line 14 of file page.php.


The documentation for this class was generated from the following file:

Generated on Wed Jan 13 09:21:04 2010 for Pronto Framework by  doxygen 1.6.1