tina_mvc/helpers/tina_mvc_functions.php

In multisite, this is in tina-mvc/user_apps/multisite/example or tina-mvc/user_apps/default, in non multisite, in tina-mvc/user_apps/default.

This is an internal helper function. You don't generally need to call it.

Tina calls this whenever it encounters an error. Hack/override this to help you debug your applications

Recurses into arrays and objects

In case of error the locations we looked in are stored in $find_app_file_error for use in an error message later.

Makes links to arbitrary Tina MVC controllers. You should use this function in your widget and shortcode page controllers when there is no active Tina MVC page.

Uses the current active Tina MVC front end page controller.

For example, you want to call 'my-app/my-action' and your controller is accessed through the Tina MVC page 'tina-mvc', this function will return http://example.com/tina-mvc/my-app/my-action. This will fail when used from shortcodes and widgets (because they are not accessed through a Tina MVC page). In that case you can specify the absolute path to your controller by setting $absolute_controller_path to 'true'

This function can be called directly from with your controllers (for example if you want to do a browser header redirect) but is typically used in view files (templates) with get_controller_link() and get_abs_controller_link() functions

Emails are sent from this address

Wordpress has some funky ways of treating global $_POST and $_GET variables. Look at wp-settings.php (line 624 for v2.9.1):

// If already slashed, strip.
if ( get_magic_quotes_gpc() ) {
$_GET    = stripslashes_deep($_GET   );
$_POST   = stripslashes_deep($_POST  );
$_COOKIE = stripslashes_deep($_COOKIE);
}

// Escape with wpdb.
$_GET    = add_magic_quotes($_GET   );
$_POST   = add_magic_quotes($_POST  );
$_COOKIE = add_magic_quotes($_COOKIE);
$_SERVER = add_magic_quotes($_SERVER);

Tina assumes that you want to deal with unescaped data. If you want to store it in a DB then do your own escaping or use the $wpdb class (recommended)

Handy for adding js or css files using wp_enqueue_* functions

This is stored in the Wordpress option table as 'tina_mvc_settings'

Returns an instantiated object.

Handy for quick debugging when you can't use tmpr() or tmprd() but can view your PHP error logs instead

A convenient way of examining variables during development. $arg is passed by reference, so you cannot use a function return. To avoid this limitation use the following construct:

tina_mvc_print_r( ( $_a = some_function() ) )

This is safe to use when users can have multiple roles