* @license Apache License, Version 2.0
*/
/**
* Include Praized Core Wordpress Class
*/
require_once(dirname(realpath(__FILE__)).'/praized-wp-core/PraizedWP.php');
/**
* Praized Community: class
*
* @package PraizedCommunity
* @since 0.1
*/
class PraizedCommunity extends PraizedWP {
/**
* PraizedTools version
* @var string
* @since 1.0.4
*/
var $version = '2.0';
/**
* Valid Praized Community URL routes
* @var array
* @since 0.1
*/
var $_routes = array(
'merchants',
'places',
'users',
'oauth',
'actions',
'questions',
'answers',
'help',
'communities'
);
/**
* Fully qualified URL where the Praized Community plugin starts taking over the WP install
* @var mixed String or NULL
* @since 0.1
*/
var $trigger_url;
/**
* Keeps track of if the current page is a merchant listing route
* @var boolean
* @since 0.1
*/
var $_route_is_merchants = FALSE;
/**
* Keeps track of if the current page is a tag-based merchant listing route
* @var boolean
* @since 0.1
*/
var $_route_is_tag = FALSE;
/**
* Keeps track of if the current page is a single merchant route
* @var boolean
* @since 0.1
*/
var $_route_is_merchant = FALSE;
/**
* Keeps track of if the current page is a single user route
* @var boolean
* @since 0.1
*/
var $_route_is_user = FALSE;
/**
* Keeps track of if the current page is an action listing route
* @var boolean
* @since 1.5
*/
var $_route_is_actions = FALSE;
/**
* Keeps track of if the current page is a questions listing route
* @var boolean
* @since 1.6
*/
var $_route_is_questions = FALSE;
/**
* Keeps track of if the current page is a single question route
* @var boolean
* @since 1.6
*/
var $_route_is_question = FALSE;
/**
* Keeps track of if the current page is a single answer route
* @var boolean
* @since 1.6
*/
var $_route_is_answer = FALSE;
/**
* Keeps track of if the current page is the Praized help route
* @var boolean
* @since 1.7
*/
var $_route_is_help = FALSE;
/**
* Keeps track of if the current page is the sub-communities route
* @var boolean
* @since 2.0
*/
var $_route_is_communities = FALSE;
/**
* API object holder: Community data
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_community = FALSE;
/**
* API object holder: Pagination data
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_pagination = FALSE;
/**
* API object holder: Authenticated user related data in vote nodes and such
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_auth_self = FALSE;
/**
* API object holder: Targeted user related data in vote nodes and such
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_auth_target = FALSE;
/**
* API object holder: Merchants data (collection)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_merchants = FALSE;
/**
* Keeps track of which merchant we're dealing with in $this->tpt_merchants_loop()
* @var integer
* @since 0.1
*/
var $tpt_merchant_index = 0;
/**
* API object holder: Merchant data (single)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_merchant = FALSE;
/**
* Keeps track of if there is another merchant to be processed in $this->tpt_merchants_loop()
* @var boolean
* @since 0.1
*/
var $tpt_has_next_merchant = FALSE;
/**
* API object holder: User data (single)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_user = FALSE;
/**
* API object holder: Merchant tag data (collection)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_tags = FALSE;
/**
* Keeps track of which merchant tag we're dealing with in $this->tpt_tags_loop()
* @var integer
* @since 0.1
*/
var $tpt_tag_index = 0;
/**
* API object holder: Merchant tag data (single)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_tag = FALSE;
/**
* Keeps track of if there is another merchant tag to be processed in $this->tpt_tags_loop()
* @var boolean
* @since 0.1
*/
var $tpt_has_next_tag = FALSE;
/**
* API object holder: Merchant sponsored link data (collection)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_splinks = FALSE;
/**
* Keeps track of which merchant sponsored link we're dealing with in $this->tpt_splinks_loop()
* @var integer
* @since 0.1
*/
var $tpt_splink_index = 0;
/**
* API object holder: Merchant sponsored link data (single)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_splink = FALSE;
/**
* Keeps track of if there is another merchant sponsored link to be processed in $this->tpt_splinks_loop()
* @var boolean
* @since 0.1
*/
var $tpt_has_next_splink = FALSE;
/**
* API object holder: Merchant sponsored image data (collection)
* @var mixed boolean FALSE or object
* @since 1.7
*/
var $tpt_spimages = FALSE;
/**
* Keeps track of which merchant sponsored image we're dealing with in $this->tpt_spimages_loop()
* @var integer
* @since 1.7
*/
var $tpt_spimage_index = 0;
/**
* API object holder: Merchant sponsored image data (single)
* @var mixed boolean FALSE or object
* @since 1.7
*/
var $tpt_spimage = FALSE;
/**
* Keeps track of if there is another merchant sponsored image to be processed in $this->tpt_spimages_loop()
* @var boolean
* @since 1.7
*/
var $tpt_has_next_spimage = FALSE;
/**
* API object holder: Merchant or user comment data (collection)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_comments = FALSE;
/**
* Keeps track of which merchant or user comment we're dealing with in $this->tpt_comments_loop()
* @var integer
* @since 0.1
*/
var $tpt_comment_index = 0;
/**
* API object holder: Merchant or user comment data (single)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_comment = FALSE;
/**
* Keeps track of if there is another merchant or user comment to be processed in $this->tpt_comments_loop()
* @var boolean
* @since 0.1
*/
var $tpt_has_next_comment = FALSE;
/**
* API object holder: Merchant or user favorites/bookmarks data (collection)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_favorites = FALSE;
/**
* Keeps track of which merchant or user favorite/bookmark we're dealing with in $this->tpt_favorites_loop()
* @var integer
* @since 0.1
*/
var $tpt_favorite_index = 0;
/**
* API object holder: Merchant or user favorite/bookmark data (single)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_favorite = FALSE;
/**
* Keeps track of if there is another merchant or user favorite/bookmark to be processed in $this->tpt_favorites_loop()
* @var boolean
* @since 0.1
*/
var $tpt_has_next_favorite = FALSE;
/**
* API object holder: Merchant or user votes data (collection)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_votes = FALSE;
/**
* Keeps track of which merchant or user vote we're dealing with in $this->tpt_votes_loop()
* @var integer
* @since 0.1
*/
var $tpt_vote_index = 0;
/**
* API object holder: Merchant or user vote data (single)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_vote = FALSE;
/**
* Keeps track of if there is another merchant or user vote to be processed in $this->tpt_votes_loop()
* @var boolean
* @since 0.1
*/
var $tpt_has_next_vote = FALSE;
/**
* API object holder: Friends data (collection)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_friends = FALSE;
/**
* Keeps track of which friend we're dealing with in $this->tpt_friends_loop()
* @var integer
* @since 0.1
*/
var $tpt_friend_index = 0;
/**
* API object holder: Friend data (single)
* @var mixed boolean FALSE or object
* @since 0.1
*/
var $tpt_friend = FALSE;
/**
* Keeps track of if there is another friend to be processed in $this->tpt_friends_loop()
* @var boolean
* @since 0.1
*/
var $tpt_has_next_friend = FALSE;
/**
* API object holder: Actions data (collection)
* @var mixed boolean FALSE or object
* @since 1.5
*/
var $tpt_actions = FALSE;
/**
* Keeps track of which action we're dealing with in $this->tpt_actions_loop()
* @var integer
* @since 1.5
*/
var $tpt_action_index = 0;
/**
* API object holder: Action data (single)
* @var mixed boolean FALSE or object
* @since 1.5
*/
var $tpt_action = FALSE;
/**
* Keeps track of if there is another action to be processed in $this->tpt_actions_loop()
* @var boolean
* @since 1.5
*/
var $tpt_has_next_action = FALSE;
/**
* API object holder: Questions data (collection)
* @var mixed boolean FALSE or object
* @since 1.6
*/
var $tpt_questions = FALSE;
/**
* Keeps track of which question we're dealing with in $this->tpt_questions_loop()
* @var integer
* @since 1.6
*/
var $tpt_question_index = 0;
/**
* API object holder: Question data (single)
* @var mixed boolean FALSE or object
* @since 1.6
*/
var $tpt_question = FALSE;
/**
* Keeps track of if there is another question to be processed in $this->tpt_questions_loop()
* @var boolean
* @since 1.6
*/
var $tpt_has_next_question = FALSE;
/**
* API object holder: Answers data (collection)
* @var mixed boolean FALSE or object
* @since 1.6
*/
var $tpt_answers = FALSE;
/**
* Keeps track of which answer we're dealing with in $this->tpt_answers_loop()
* @var integer
* @since 1.6
*/
var $tpt_answer_index = 0;
/**
* API object holder: Answer data (single)
* @var mixed boolean FALSE or object
* @since 1.6
*/
var $tpt_answer = FALSE;
/**
* Keeps track of if there is another answer to be processed in $this->tpt_answers_loop()
* @var boolean
* @since 1.6
*/
var $tpt_has_next_answer = FALSE;
/**
* API object holder: Hub communities data (collection)
* @var mixed boolean FALSE or object
* @since 2.0
*/
var $tpt_hub_communities = FALSE;
/**
* Keeps track of which hub community we're dealing with in $this->tpt_hub_community_loop()
* @var integer
* @since 2.0
*/
var $tpt_hub_community_index = 0;
/**
* API object holder: Hub community data (single)
* @var mixed boolean FALSE or object
* @since 2.0
*/
var $tpt_hub_community = FALSE;
/**
* Keeps track of if there is another hub community to be processed in $this->tpt_hub_community_loop()
* @var boolean
* @since 2.0
*/
var $tpt_has_next_hub_community = FALSE;
/**
* Stores the Praized remote file include content to be used in the aproriate template
* @var string
* @since 1.7
*/
var $tpt_help_content = FALSE;
/**
* Stores the missing fields when dealing with forms with required fields
* @var array
* @since 2.0
*/
var $tpt_missing_fields = array();
/**
* Stores the unique identifier used in the reset password and email confirmation logic
* @var mixed boolean FALSE or string
* @since 2.0
*/
var $tpt_confirmation_key = FALSE;
/**
* Stores the values of _POST when a form needs to be resubmitted for the lightbox login to kick in
* @var array
* @since 2.0
*/
var $_repost = array();
/**
* Search form widget identifier string
* @var string
* @since 0.1
*/
var $_wdgt_search_form_key;
/**
* Praized session widget identifier string
* @var string
* @since 0.1
*/
var $_wdgt_auth_nav_key;
/**
* Praized navigation widget identifier string
* @var string
* @since 1.7
*/
var $_wdgt_section_nav_key;
/**
* Constructor
*
* @return PraizedCommunity
* @since 0.1
* @see PraizedWP::PraizedWP()
*/
function PraizedCommunity() {
PraizedWP::PraizedWP('praized-community');
if ( ! isset($this->_config['trigger']) || empty($this->_config['trigger']) )
$this->_config['trigger'] = '/praized';
if ( ! isset($this->_config['oauth_consumer_key']) )
$this->_config['oauth_consumer_key'] = '';
if ( ! isset($this->_config['oauth_consumer_secret']) )
$this->_config['oauth_consumer_secret'] = '';
if ( ! isset($this->_config['map_api_key']) )
$this->_config['map_api_key'] = '';
if ( ! isset($this->_config['map_width']) )
$this->_config['map_width'] = '';
if ( ! isset($this->_config['map_height']) )
$this->_config['map_height'] = '';
if ( ! isset($this->_config['map_zoom_level']) )
$this->_config['map_zoom_level'] = '';
if ( ! isset($this->_config['default_view']) )
$this->_config['default_view'] = 'places';
if ( ! isset($this->_config['default_query']) )
$this->_config['default_query'] = '';
if ( ! isset($this->_config['default_location']) )
$this->_config['default_location'] = '';
if ( ! isset($this->_config['overlay_login']) )
$this->_config['overlay_login'] = FALSE;
$this->_wdgt_search_form_key = $this->_wdgt_key . '_search_form';
$this->_wdgt_auth_nav_key = $this->_wdgt_key . '_auth_nav';
$this->_wdgt_section_nav_key = $this->_wdgt_key . '_section_nav';
}
/**
* Checks if there are any version specific messages/warnings to be displayed
* to the admin user to let them know about new features, etc. Supports
* cumulative versions, in case the user skipped a few versions.
*
* @return void
* @since 1.7
*/
function _upgrade_notices() {
if ( $this->_clear_upgrade_notices() )
return;
if ( ! ( $last_upgrade = $this->_get_wp_option('last_upgrade') ) )
$last_upgrade = 0;
$notices = array();
// Version 2.0
if ( version_compare($this->version, '2.0', '>=') && $last_upgrade < strtotime('2009-04-26') ) {
$v = 'v2.0';
$notices[$v] = sprintf(
$this->__('Be sure to try the new, less intrusive overlay login functionality (see "Behavior and Interface Options" in the plugin\'s admin screen .'),
$this->_admin_url,
$this->_plugin_name,
$this->_plugin_name
);
$notices[$v] .= ' ';
$notices[$v] .= $this->__('We have also updated the default layout for place and user profiles with a tabbed interface, which you might want to syncronize with IF you had previously opted to customize the said templates for your own blog.');
}
// Version 1.7
if ( version_compare($this->version, '1.7', '>=') && $last_upgrade < strtotime('2009-01-01') ) {
$v = 'v1.7';
$notices[$v] = sprintf(
$this->__('Please note that we\'ve added a new sidebar widget .'),
$this->_admin_url . '/widgets.php'
);
$notices[$v] .= ' ';
$notices[$v] .= $this->__('We\'ve removed the main sections links from the existing "Praized: Session " widget and separated them in their own "Praized: Sections " widget so you have more control over their placement.');
}
if ( ! empty($notices) ) {
$this->_queue_upgrade_notices($notices);
}
}
/**
* Admin tools "constructor"
*
* @since 0.1
*/
function admin_tools() {
// Config-level error, warning and notification handling
if ( ! strstr($_SERVER['QUERY_STRING'], $this->_plugin_name) && ( ! $this->_config['community'] || ! $this->_config['api_key'] ) ) {
// Prompt the admin user to configure the newly activated plugin.
add_action('admin_notices', array(&$this, 'wp_action_install_warning'));
return;
} else if ( ! empty($this->_config['community']) && ! empty($this->_config['api_key']) ) {
// See if there are any upgrade notifications and display them as necessary.
$this->_upgrade_notices();
}
if ( count($_POST) > 0 ) {
if ( strstr($_GET['page'], $this->_plugin_name) && isset($_POST['community']) ) {
// Plugin config save
$missing_val_msg = $this->__('Please submit a value for the "%s" form field.');
// error checking
if ( empty($_POST['community']) )
$this->errors[] = sprintf( $missing_val_msg, $this->__('Community') );
if ( empty($_POST['api_key']) )
$this->errors[] = sprintf( $missing_val_msg, $this->__('API Key') );
if ( empty($_POST['oauth_consumer_key']) )
$this->errors[] = sprintf( $missing_val_msg, $this->__('OAuth Consumer Key') );
if ( empty($_POST['oauth_consumer_secret']) )
$this->errors[] = sprintf( $missing_val_msg, $this->__('OAuth Consumer Secret') );
if ( empty($_POST['trigger']) )
$this->errors[] = sprintf( $missing_val_msg, $this->__('URL Trigger') );
// error reporting
if ( count($this->errors) > 0 ) {
add_action( 'admin_notices', array(&$this, 'wp_action_admin_errors') );
} else {
if ( empty($_POST['trigger']) )
$_POST['trigger'] = '/praized';
$this->_save_config();
$this->_save_wp_option('last_upgrade', time());
}
} else {
// Search form widget config save
if( isset($_POST[$this->_wdgt_search_form_key . '_title']) ) {
$this->widget_search_form_options_save();
}
// Auth nav widget config save
if( isset($_POST[$this->_wdgt_auth_nav_key . '_title']) ) {
$this->widget_auth_nav_options_save();
}
// Section nav widget config save
if( isset($_POST[$this->_wdgt_section_nav_key . '_title']) ) {
$this->widget_section_nav_options_save();
}
}
}
add_action('admin_menu', array(&$this, 'wp_action_admin_menu'));
}
/**
* Displays an admin notice to prompt the administrator(s) to configure the plugin.
*
* @since 0.1
*/
function wp_action_install_warning() {
$this->_load_praized();
echo '';
printf(
$this->__('Thank you for installing the Praized Community plugin. To finalize the installation, please take the time to configure the last few details and request your Praized API key .'),
$this->_admin_url . '/options-general.php?page=' . $this->_plugin_name . '/' . $this->_plugin_name . '.php',
$this->Praized->praizedLinks['api_request']
);
echo '
';
echo "\n";
}
/**
* WP action: Admin menu handling
*
* @since 0.1
*/
function wp_action_admin_menu() {
$name = 'Praized Community';
add_options_page(
$this->__($name),
$this->__($name),
9,
$this->_plugin_name . '/' . $this->_plugin_name . '.php',
array(&$this, 'wp_options_page')
);
}
/**
* Praized plugin configuration page
*
* @since 0.1
*/
function wp_options_page() {
$form = ( count($this->_config_form) > 0 ) ? $this->_config_form : $this->_config;
$permalink_structure = get_option('permalink_structure');
if ( empty($permalink_structure) ) {
$this->errors[] = sprintf(
$this->__('Please be sure to use mod_rewrite and, by extension, "nice URLs" (ie: not "Default") in the WordPress permalink structure to setup your Praized Community.
'),
$this->_admin_url
);
$this->wp_action_admin_errors();
} else {
$this->_load_praized();
require_once($this->_includes . '/php/config.php');
}
}
/**
* WP Widget: Search form option form
*
* @since 0.1
*/
function widget_search_form_options_form() {
$widget_id = $this->_wdgt_search_form_key;
$config = $this->_get_wp_option($widget_id);
if ( !is_array($config) )
$config = array();
$field_id = $widget_id . '_title';
echo ''.$this->__('Widget Title').': '.' ';
echo '
';
}
/**
* WP Widget: Search form option save process
*
* @since 0.1
*/
function widget_search_form_options_save() {
$widget_id = $this->_wdgt_search_form_key;
// Note: _save_wp_option() sanitizes the content
$this->_save_wp_option($widget_id, array(
'title' => $_POST[$widget_id . '_title']
));
}
/**
* WP Widget: Auth nav form option form
*
* @since 0.1
*/
function widget_auth_nav_options_form() {
$widget_id = $this->_wdgt_auth_nav_key;
$config = $this->_get_wp_option($widget_id);
if ( !is_array($config) )
$config = array();
$field_id = $widget_id . '_title';
echo ''.$this->__('Widget Title').': '.' ';
echo '
';
}
/**
* WP Widget: Auth nav option save process
*
* @since 0.1
*/
function widget_auth_nav_options_save() {
$widget_id = $this->_wdgt_auth_nav_key;
// Note: _save_wp_option() sanitizes the content
$this->_save_wp_option($widget_id, array(
'title' => $_POST[$widget_id . '_title']
));
}
/**
* WP Widget: Section nav option form
*
* @since 1.7
*/
function widget_section_nav_options_form() {
$widget_id = $this->_wdgt_section_nav_key;
$config = $this->_get_wp_option($widget_id);
if ( !is_array($config) )
$config = array();
$field_id = $widget_id . '_title';
echo ''.$this->__('Widget Title').': '.' ';
echo '
';
}
/**
* WP Widget: Section nav option save process
*
* @since 1.7
*/
function widget_section_nav_options_save() {
$widget_id = $this->_wdgt_section_nav_key;
// Note: _save_wp_option() sanitizes the content
$this->_save_wp_option($widget_id, array(
'title' => $_POST[$widget_id . '_title']
));
}
/**
* Display tools "constructor"
*
* @since 0.1
*/
function display_tools() {
$this->_load_praized();
// WP 2.3+
if ( function_exists('redirect_canonical') )
add_filter('redirect_canonical', array(&$this, 'wp_filter_redirect_canonical'));
add_filter('wp_title', array(&$this, 'wp_filter_page_title'));
add_action('template_redirect', array(&$this, 'wp_action_template_redirect'));
add_action('wp_head', array(&$this, 'wp_action_template_head'));
add_action('wp_footer', array(&$this, 'wp_action_template_footer'));
}
/**
* Tests if the current URL is a Praized route
*
* @return mixed Boolean FALSE or String route.
* @since 0.1
*/
function _route_test() {
$trigger = $this->_config['trigger'];
if ( substr($trigger, 0, 1) != '/' )
$trigger = '/' . $trigger;
$this->trigger_url = $this->_site_url . $trigger;
if ( preg_match('|^' . $this->trigger_url . '(.*)$|', $this->_script_uri, $matches) ) {
$this->trigger_url = preg_replace('|/$|', '', $this->trigger_url);
return $matches[1];
} else {
return FALSE;
}
}
/**
* Contextual page header/title string generation
*
* @param string $separator Defaults to "»"
* @return string
*/
function page_header($separator = '»') {
$header = '';
if ( $this->_route_is_merchants ) {
if ( isset($_GET['q']) && empty($_GET['q']) && isset($_GET['l']) && empty($_GET['l']) ) {
// We still need users to be able to overwrite the defaults and submit an
// "Everything + Everywhere" query, but only when the form is truly submitted.
$query = ucfirst($this->__('everything'));
$location = ucfirst($this->__('everywhere'));
} else {
$query = $this->tpt_search_query(FALSE);
if ( empty($query) )
$query = ucfirst($this->__('everything'));
$location = $this->tpt_search_location(FALSE);
if ( empty($location) )
$location = ucfirst($this->__('everywhere'));
}
$tag = $this->tpt_search_tag(FALSE);
if ( ! empty($tag) )
$tag = ' ' . $separator . ' ' . $this->__('Tag') . ': ' . $tag;
$header .= sprintf(
'%s %s %s%s',
ucfirst($query),
$separator,
ucfirst($location),
$tag
);
} else if ( $this->_route_is_merchant && $this->tpt_has_merchant() ) {
$name = $this->tpt_attribute_helper('merchant', 'name', FALSE);
$city = $this->tpt_attribute_helper('merchant', 'location->city->name', FALSE);
$p_code = $this->tpt_attribute_helper('merchant', 'location->postal_code', FALSE);
$country = $this->tpt_attribute_helper('merchant', 'location->country->name', FALSE);
if ( ! ($region = $this->tpt_attribute_helper('merchant', 'location->regions->state', FALSE)) ) {
$region = $this->tpt_attribute_helper('merchant', 'location->regions->province', FALSE);
}
$header .= sprintf(
'%s (%s%s%s%s)',
$name,
( $city ) ? $city . ( ($region || $p_code || $country) ? ', ' : '') : '',
( $region ) ? $region . ( ($p_code || $country) ? ', ' : '') : '',
( $p_code ) ? $p_code . ( ($country) ? ', ' : '') : '',
( $country ) ? $country : ''
);
} else if ( $this->_route_is_user && $this->tpt_has_user() ) {
$display_name = $this->tpt_attribute_helper('user', 'display_name', FALSE);
$header = ( ! $display_name ) ? $login : $display_name;
} else if ( $this->_route_is_actions && $this->tpt_has_actions() ) {
$header = $this->__('The Local Buzz');
} else if ( $this->_route_is_questions && $this->tpt_has_questions() ) {
$header = $this->__('Local Questions & Answers');
} else if ( $this->_route_is_question && $this->tpt_has_question() ) {
$answer_count = (int) $this->tpt_attribute_helper('question', 'answer_count', FALSE);
$answer_count .= ( $answer_count < 2 ) ? ' ' . $this->__('answer') : ' ' . $this->__('answers');
$header = $this->__('Question:') . ' ' . $this->tpt_attribute_helper('question', 'content', FALSE) . ' (' . $answer_count . ')';
} else if ( $this->_route_is_answer && $this->tpt_has_answer() ) {
$header = $this->__('Answer:') . ' ' . $this->tpt_attribute_helper('answer', 'content', FALSE);
}
return $header;
}
/**
* Cancelling WP 2.3+ canonical redirects, but only if/when conflicting with the Praized integration
*
* @return mixed Boolean FALSE or String url.
* @since 0.1
*/
function wp_filter_redirect_canonical($content) {
if ( FALSE !== $this->_route_test() )
return FALSE;
else
return $content;
}
/**
* Trigger-based API routing and template handling.
*
* @since 0.1
*/
function wp_action_template_redirect() {
if ( FALSE !== ( $route = $this->_route_test() ) ) {
$this->_reroute($route);
}
}
/**
* WP action: processed when wp_head() is called in templates
*
* @since 0.1
*/
function wp_action_template_head() {
if ( $css = $this->_css() )
echo $css;
printf(
' ' . "\n",
$this->_plugin_dir_url,
$this->version
);
// UI scripts
printf(
'' . "\n",
$this->_plugin_dir_url,
$this->version
);
}
/**
* WP action: processed when wp_head() is called in templates
*
* @since 0.1
*/
function wp_action_template_footer() {
// Login LightBox init call handling
if ( $this->_config['overlay_login'] ) {
printf(
'' . "\n",
$this->Praized->praizedLinks['static'],
$this->version
);
if ( ! $this->Praized->isAuthorized() ) {
if ( ! empty($this->_repost) ) {
$repost_form_id = 'praized_repost_form';
unset($this->_repost['repost']); // just to be safe
echo '';
}
printf(
'',
$this->trigger_url,
$this->Praized->praizedLinks['auth']
);
if ( ! empty($this->_repost) ) {
printf(
'',
$repost_form_id
);
}
} else {
printf(
'',
$this->trigger_url,
$this->Praized->praizedLinks['auth']
);
// Vote Button include
printf(
'' . "\n",
$this->_plugin_dir_url,
$this->version
);
}
return;
} else {
// Vote Button include
printf(
'' . "\n",
$this->_plugin_dir_url,
$this->version
);
}
}
/**
* WP action: adds geo meta tags to single merchant template when wp_head() is called
*
* @since 2.0
*/
function wp_action_template_head_geo_meta(){
if ( ! $this->_route_is_merchant || ! is_object($this->tpt_merchant) )
return;
$merchant = $this->tpt_merchant;
if ( ! empty($merchant->location->latitude ) && ! empty($merchant->location->longitude) ) {
printf(
' %s',
$merchant->location->latitude,
$merchant->location->longitude,
"\n"
);
}
if ( ! empty($merchant->location->regions->state) )
$region_name = $merchant->location->regions->state;
elseif ( ! empty($merchant->location->regions->province) )
$region_name = $merchant->location->regions->province;
else
$region_name = '';
if ( ! empty($merchant->location->city->name ) && ! empty($region_name) ) {
printf(
' %s',
$merchant->location->city->name,
$region_name,
"\n"
);
}
}
/**
* WP action: adds geo RDF to single merchant template when wp_footer() is called
*
* @since 2.0
*/
function wp_action_template_footer_geo_rdf(){
if ( ! $this->_route_is_merchant || ! is_object($this->tpt_merchant) )
return;
$merchant = $this->tpt_merchant;
if ( ! empty($merchant->location->latitude ) && ! empty($merchant->location->longitude) ) {
print "\n".''."\n";
print "\t\n";
printf(
'%s%s %s %s',
"\t\t",
$merchant->location->latitude,
$merchant->location->longitude,
"\n"
);
print "\t \n";
print " \n";
}
}
/**
* WP filter: Generate SEO friendly page titles
*
* @param string $content Content sent by WP
* @since 0.1
*/
function wp_filter_page_title($content) {
$separator = '»';
$header = $this->page_header($separator);
return ( $header ) ? $content . ' ' . $separator . ' ' . $header : $content;
}
/**
* Resets the WP 404-related flags and checks (is_404(), http header, etc)
*
* @since 1.0.2
*/
function _reset_404() {
global $wp_query;
if ( is_object($wp_query) )
$wp_query->is_404 = FALSE;
status_header('200');
}
/**
* Reroutes to the appropriate action and by extension, template.
*
* @param string $route EG: /merchants/search
* @since 0.1
*/
function _reroute($route) {
/**
* Make sure to not hijack the entire wordpress install when
* $this->trigger_url is set to the site's root (/).
*/
if ( $this->_config['trigger'] == '/' && $route != '/' && ! empty($route) ) {
$parts = explode('/', trim($route,'/'));
if ( ! $parts[0] || ! in_array($parts[0], $this->_routes) )
return;
}
/**
* Default only to the merchant route when at the root of $this->trigger_url
*/
if ( empty($route) || ($route == '/') ) {
$route = ( empty($this->_config['default_view']) || ! in_array($this->_config['default_view'], $this->_routes) )
? '/places'
: '/' . $this->_config['default_view'];
}
$parts = explode('/', trim($route,'/'));
/**
* If we're still really not in one of the Praized integration routes,
* then just return and let WP handle the request. Allows for sub-pages
* to $this->trigger_url, if not conflicting with the expected routes.
*/
if ( ! isset($parts[0]) || ! in_array($parts[0], $this->_routes) )
return;
// form repost logic, see $this->_repost_form()
if ( ! empty($_POST['repost']) && $this->_config['overlay_login'] && ! $this->Praized->isAuthorized() ) {
unset($_POST['repost']);
$this->_repost = $_POST;
$_POST = array();
}
switch ($parts[0]) {
case 'merchants':
case 'places':
$this->_route_merchants($parts);
break;
case 'users':
$this->_route_user($parts);
break;
case 'oauth':
if ( ! empty($_GET['return_to']) && stristr(rawurldecode($_GET['return_to']), $this->trigger_url) )
$callback = $_GET['return_to'];
else if ( ! empty($_SERVER["HTTP_REFERER"]) && stristr($_SERVER["HTTP_REFERER"], $this->trigger_url) )
$callback = $_SERVER["HTTP_REFERER"];
else
$callback = $this->trigger_url;
if ( $parts[1] != 'login' )
$parts[1] = 'logout';
if ( $this->Praized->isAuthorized() ) {
$this->_preserve_post(FALSE);
// The following is to cope with users that are already logged in,
// but try to complete login handshake process again. Was especially
// problematic when using the lightbox login.
if ( $parts[1] == 'login' ) {
if ( $_GET['i'] == 'signon' ) {
print '\n";
exit;
} else {
wp_redirect($callback);
}
}
}
$this->Praized->session($callback, $parts[1]);
break;
case 'actions':
$this->_route_actions($parts);
break;
case 'questions':
$this->_route_questions($parts);
break;
case 'answers':
$this->_route_answer($parts);
break;
case 'help':
$this->_route_help($parts);
break;
case 'communities':
$this->_route_communities($parts);
break;
default:
// falls back to standard WP 404
break;
}
}
/**
* Preserve the search query (q, l, t) when appropriate
*
* @param array $query Query string as associative array
* @return array
* @since 0.1
*/
function _preserve_query($query = array()) {
if ( ! is_array($query) )
$query = array();
if ( isset($_GET['q']) && ! empty($_GET['q']) )
$query['q'] = urlencode($this->stripper($_GET['q']));
if ( isset($_GET['l']) && ! empty($_GET['l']) )
$query['l'] = urlencode($this->stripper($_GET['l']));
if ( isset($_GET['tag']) && ! empty($_GET['tag']) ) {
$query['t'] = urlencode($this->stripper($_GET['tag']));
} else if ( isset($_GET['category']) && ! empty($_GET['category']) ) {
$query['t'] = urlencode($this->stripper($_GET['category']));
} else if ( isset($_GET['t']) && ! empty($_GET['t']) ) {
$query['t'] = urlencode($this->stripper($_GET['t']));
}
return $query;
}
/**
* Standard cookie name to be used with $this->_preserve_post()
*
* @return string
* @since 1.6
*/
function _preserve_post_cookie_name() {
return 'praized_'.$this->_config['community'].'_post_holder';
}
/**
* Tries to conserve the _POST vars in a cookie to be retrieved later (used when eg: posting questions or answers while not signed in).
*
* @param boolean $preserve true to save the cookie, false to delete it
* @return void
* @since 1.6
*/
function _preserve_post($preserve = TRUE) {
if ( ! headers_sent() ) {
$name = $this->_preserve_post_cookie_name();
if ( $preserve )
setcookie($name, serialize($_POST), 0, '/');
else
setcookie($name, '', time() - 3600, '/' );
} else {
if ( $preserve )
$_COOKIE[$name] = serialize($_POST);
else
unset($_COOKIE[$name]);
}
}
/**
* Returns a fully qualified permalink url based on the sent fq url or path.
*
* @param string $link Usually $this->tpt_merchant->permalink
* @param $type Link type (user, merchant, places)
* @return string
* @since 0.1
*/
function link_helper($link, $type = 'places') {
if ( ! strstr($link, '://') ) {
switch ( strtolower($type) ) {
case 'user':
$link = $this->trigger_url . '/users/' . ltrim($link, '/');
break;
case 'merchant':
$link = $this->trigger_url . '/merchants/' . ltrim($link, '/');
break;
case 'question':
$link = $this->trigger_url . '/questions/' . ltrim($link, '/');
break;
case 'answer':
$link = $this->trigger_url . '/answers/' . ltrim($link, '/');
break;
default:
$link = $this->trigger_url . '/places/' . ltrim($link, '/');
break;
}
$query = $this->_preserve_query();
if ( count($query) > 0 ) {
$qs = '?';
foreach ($query as $key => $val)
$qs .= urlencode($key).'='.urlencode(urldecode($val)).'&';
$link .= rtrim($qs, '&');
}
}
return $link;
}
/**
* Simple method to check for required field when submitting forms such as the user edit-level functionalities.
*
* @param array $required Array of required form field names to verify
* @return boolean TRUE if test passes, FALSE if some required values are missing
* @since 2.0
*/
function _test_required_fields($required) {
$valid = TRUE;
foreach ( $_POST as $key => $value ) {
if ( empty($value) && in_array($key, $required) ) {
$this->tpt_missing_fields[] = $key;
$valid = FALSE;
}
}
return $valid;
}
/**
* Template function: Prints errors found in required fields when dealing with forms such as user profile editing.
* Based on state of $PraizedCommunity->tpt_missing_fields.
*
* @return void
* @since 2.0
*/
function required_fields() {
if ( ! empty($this->tpt_missing_fields) || ! empty($this->errors) ) {
echo '';
echo '
'.$this->__('Validation Errors')." \n";
if ( ! empty($this->tpt_missing_fields) ) {
foreach ( $this->tpt_missing_fields as $field ) {
echo ''.$this->__('Missing value:').' '.ucfirst(str_replace('_', ' ', preg_replace('/^(user|setting)_/i', '', $field)))." \n";
}
}
if ( ! empty($this->errors) ) {
foreach ( $this->errors as $error ) {
echo ''.$this->__('Error:').' '.$error." \n";
}
}
if ( ! empty($_GET['updated']) && empty($_GET['message']) )
echo ''.$this->__('Your information was saved sucessfully')." \n";
echo ' '."\n";
} else if ( ! empty($_GET['updated']) || ! empty($this->notices) ) {
echo '';
echo '
'.$this->__('Confirmation')." \n";
if ( ! empty($_GET['updated']) && empty($_GET['message']) )
echo ''.$this->__('Your information was updated successfully.')." \n";
if ( ! empty($this->notices) ) {
foreach ( $this->notices as $notice ) {
echo ''.$this->__('Note:').' '.$notice." \n";
}
}
echo ' '."\n";
}
}
/**
* Handles the /merchants*, and /places* API routes
* (from $this->_reroute())
*
* @param array $route_parts Indexed array of the elements making the current API route (as def in $this->_reroute())
* @since 0.1
*/
function _route_merchants($route_parts) {
if ( ! isset($route_parts[1]) || empty($route_parts[1]) )
$route_parts[1] = 'search';
switch ($route_parts[1]) {
case 'search':
$this->_route_is_merchants = TRUE;
$this->_reset_404();
$this->template('merchants');
break;
case 'tag':
case 'category':
$this->_route_is_merchants = TRUE;
$this->_route_is_tag = TRUE;
unset($_GET['q']); // Special case for tags, not preserving the ?q
if ( ! isset($_GET['l']) && ! empty($this->_config['default_location']) )
$_GET['l'] = $this->_config['default_location'];
$query = $this->_preserve_query($_GET);
unset($query['tag']); // make sure we don't double-send
unset($query['category']); // make sure we don't double-send
$query['t'] = $route_parts[2];
$this->tpt_has_merchants($query);
$this->_reset_404();
$this->template('merchants');
break;
default:
/**
* Defaults to indiv merchant bc the url patterns
* are more difficult to match.
*/
$this->_route_merchant($route_parts);
break;
}
}
/**
* Handles the /merchants/{merchant_pid}* and /places/{merchant_permalink}* API routes
* (from $this->_reroute(), through $this->_route_merchants())
*
* @param array $route_parts Indexed array of the elements making the current API route (as def in $this->_reroute())
* @since 0.1
*/
function _route_merchant($route_parts) {
switch ( $route_parts[0] ) {
case 'places';
$identifier = '/' . implode('/', $route_parts);
if ( $identifier == '/' )
return;
break;
case 'merchants':
if ( empty($route_parts[1]) )
return;
$identifier = $route_parts[1];
break;
default:
return;
}
$mObj = $this->Praized->merchant();
// handles posting votes while not logged in to the praized network
if ( ( $identifier == $route_parts[1] ) && $this->Praized->isAuthorized() && isset($_GET['oauth_token']) && isset($_COOKIE[$this->_preserve_post_cookie_name()]) ) {
$_POST = unserialize(stripslashes($_COOKIE[$this->_preserve_post_cookie_name()]));
if ( isset($_POST['vote']) )
$route_parts[2] = 'votes'; // fallback because users can vote from any merchant-related route/views (lists, details, etc).
$this->_preserve_post(FALSE);
} else if ( isset($_COOKIE[$this->_preserve_post_cookie_name()]) ) {
$this->_preserve_post(FALSE);
}
switch ($route_parts[2]) {
case 'comments':
if ( count($_POST) > 0 ) {
if ( ! $this->Praized->isAuthorized() )
$this->_preserve_post();
$return = $mObj->commentAdd($identifier, $_POST);
if ( isset($return->merchant->permalink) )
$redirect = $return->merchant->permalink . '?tab=comments';
else if( isset($mObj->errors[401]) )
$redirect = $this->trigger_url . '/oauth/logout';
else
$redirect = $this->link_helper($identifier, 'merchant') . '?tab=comments';
wp_redirect($redirect);
exit;
}
$template = 'merchant_comments';
break;
case 'votes':
case 'votes.json':
if ( count($_POST) > 0 ) {
$this->_reset_404();
$errorString = '{ "redirect_url" : null, "code" : 422, "errors" : { %s } }';
if ( $_SERVER['HTTP_X_REQUESTED_WITH'] == 'XMLHTTPRequest') {
// JSON output
if ( ! $this->Praized->isAuthorized() ) {
$this->_preserve_post();
$return_to = ( strstr($identifier, '/') ) ? $this->trigger_url . $identifier : $this->link_helper($identifier, 'merchant');
echo '{ "redirect_url" : "' . $this->trigger_url . '/oauth/login?return_to=' . rawurlencode($return_to) . '", "code" : 401, "errors" : {} }';
} else if($m = $mObj->voteAdd($identifier, $_POST)) {
if ( $m->vote->merchant->votes->count ) {
echo '{';
echo ' "pos_count" : "' . $m->vote->merchant->votes->pos_count . '",';
echo ' "neg_count" : "' . $m->vote->merchant->votes->neg_count . '",';
echo ' "count" : "' . $m->vote->merchant->votes->count . '",';
echo ' "score" : "' . $m->vote->merchant->votes->score . '"';
echo '}';
} else {
printf($errorString, '"error" : "API succeeded but returned no merchant data."');
}
} else if( isset($mObj->errors[401]) ) {
echo '{ "redirect_url" : "' . $this->trigger_url . '/oauth/logout", "code" : 401, "errors" : {} }';
} else {
printf($errorString, '"error" : "Unknown Error"');
}
} else {
// Accessible vote form (ie: no JS)
if ( ! $this->Praized->isAuthorized() )
$this->_preserve_post();
$return = $mObj->voteAdd($identifier, $_POST);
if ( isset($return->vote->merchant->permalink) )
$redirect = $return->vote->merchant->permalink;
else if ( isset($return->merchant->permalink) )
$redirect = $return->merchant->permalink;
else if( isset($mObj->errors[401]) )
$redirect = $this->trigger_url . '/oauth/logout';
else
$redirect = $this->link_helper($identifier, 'merchant');
wp_redirect($redirect);
}
exit;
}
$template = 'merchant_votes';
break;
case 'favorites':
if ( isset($_POST['_action']) ) {
if ( $_POST['_action'] == 'delete' )
$return = $mObj->favoriteDelete($identifier, $_POST);
else
$return = $mObj->favoriteAdd($identifier, $_POST);
if ( isset($return->merchant->permalink) )
$redirect = $return->merchant->permalink;
else if( isset($mObj->errors[401]) )
$redirect = $this->trigger_url . '/oauth/logout';
else
$redirect = $this->link_helper($identifier, 'merchant');
wp_redirect($redirect);
exit;
}
$template = 'merchant_favorites';
break;
case 'taggings':
if ( count($_POST) > 0 ) {
if ( ! $this->Praized->isAuthorized() )
$this->_preserve_post();
$return = $mObj->tagAdd($identifier, $_POST);
if ( isset($return->merchant->permalink) )
$redirect = $return->merchant->permalink;
else if( isset($mObj->errors[401]) )
$redirect = $this->trigger_url . '/oauth/logout';
else
$redirect = $this->link_helper($identifier, 'merchant');
wp_redirect($redirect);
exit;
}
$template = 'merchant_taggings';
break;
case 'actions':
$template = 'merchant_actions';
break;
case 'communities':
$template = 'merchant_communities';
break;
default:
$template = 'merchant';
break;
}
if ( $merchant_object = $mObj->get($identifier, $_GET) ) {
if ( is_object($merchant_object) ) {
$this->_route_is_merchant = TRUE;
$this->_tpt_environment($merchant_object);
$this->_reset_404();
add_action('wp_head', array(&$this, 'wp_action_template_head_geo_meta'));
add_action('wp_footer', array(&$this, 'wp_action_template_footer_geo_rdf'));
$this->template($template);
}
}
}
/**
* Handles the /users* API routes
* (from $this->_reroute())
*
* @param array $route_parts Indexed array of the elements making the current API route (as def in $this->_reroute())
* @since 0.1
*/
function _route_user($route_parts) {
if ( $route_parts[0] != 'users' || empty($route_parts[1]) )
wp_redirect($this->trigger_url);
$identifier = $route_parts[1];
$uObj = $this->Praized->user();
switch ( $identifier ) {
case 'forgot_password':
case 'reset_password':
case 'resend_email_confirmation':
case 'confirm_email':
$this->tpt_confirmation_key = $route_parts[2];
$this->tpt_confirmation_error = false;
switch ( $identifier ) {
case 'forgot_password':
// Reset password: Step 1
if ( count($_POST) > 0 ) {
if ( $this->_test_required_fields(array('user_email')) ) {
if ( $response = $uObj->forgotPassword($_POST) ) {
$this->tpt_confirmation_message = sprintf(
$this->__('An email with instructions on how to complete your password reset was sent to %s.'),
$_POST['user_email']
);
} else {
$this->tpt_confirmation_error = true;
$this->tpt_confirmation_message = $this->__('No user with this e-mail was found. Please enter the same e-mail address you provided when you signed up');
}
} else {
$this->tpt_confirmation_error = true;
}
} else {
$this->tpt_confirmation_message = $this->__('Please enter the same e-mail address you provided when you signed up');
}
break;
case 'reset_password':
if ( empty($this->tpt_confirmation_key) )
wp_redirect($this->trigger_url);
// Reset password: Step 2
if ( count($_POST) > 0 ) {
if ( $this->_test_required_fields(array('user_password', 'user_password_confirmation')) ) {
if ( $response = $uObj->resetPassword($this->tpt_confirmation_key, $_POST) ) {
$this->tpt_confirmation_message = $this->__('Your password was reset successfully.');
} else {
$this->tpt_confirmation_error = true;
$this->tpt_confirmation_message = sprintf(
$this->__('We could not reset your password. Either the confirmation code is not valid or the passwords did not match. For any question, please contact us '),
'help@praized.com'
);
}
} else {
$this->tpt_confirmation_error = true;
}
}
break;
case 'resend_email_confirmation':
// confirm_email
if ( $response = $uObj->resendEmailConfirmation() ) {
$this->tpt_confirmation_message = sprintf(
$this->__('We have resent an email confirmation message to "%s"'),
$response->user->self->email
);
} else {
$this->tpt_confirmation_error = true;
$this->tpt_confirmation_message = sprintf(
$this->__('Sorry, but something went wrong. Please contact contact us '),
'help@praized.com'
);
}
break;
default:
if ( empty($this->tpt_confirmation_key) )
wp_redirect($this->trigger_url);
// confirm_email
if ( $response = $uObj->confirmEmail($this->tpt_confirmation_key) ) {
$this->tpt_confirmation_message = sprintf(
$this->__('Your email address "%s" has been confirmed'),
$response->user->self->email
);
} else {
$this->tpt_confirmation_error = true;
$this->tpt_confirmation_message = sprintf(
$this->__('We could not confirm your email address. Your email address is either already confirmed or the confirmation code is not valid. For any question, please contact us '),
'help@praized.com'
);
}
break;
}
$template = 'user_' . $identifier;
$this->template($template);
break;
default:
$mObj = $this->Praized->merchant();
switch ($route_parts[2]) {
case 'comments':
$template = 'user_comments';
break;
case 'votes':
$template = 'user_votes';
break;
case 'favorites':
if ( isset($_POST['_action']) && isset($_POST['pid']) && ! empty($_POST['pid']) ) {
if ( $_POST['_action'] == 'delete' )
$mObj->favoriteDelete($_POST['pid'], $_POST);
else
$mObj->favoriteAdd($_POST['pid'], $_POST);
if( isset($mObj->errors[401]) )
$redirect = $this->trigger_url . '/oauth/logout';
else
$redirect = $this->link_helper($this->Praized->currentUserLogin(), 'user');
wp_redirect($redirect);
exit;
}
$template = 'user_favorites';
break;
case 'friends':
if ( isset($_POST['_action']) ) {
if ( $_POST['_action'] == 'delete' )
$uObj->friendDelete($identifier, $_POST);
else
$uObj->friendAdd($identifier, $_POST);
if( isset($uObj->errors[401]) )
$redirect = $this->trigger_url . '/oauth/logout';
else
$redirect = $this->link_helper($this->Praized->currentUserLogin(), 'user');
wp_redirect($redirect);
exit;
}
$template = 'user_friends';
break;
case 'actions':
$template = 'user_actions';
break;
case 'edit':
$valid_tabs = array(
'account_info',
'avatar',
'password_change',
'notification_settings'
);
if ( isset($_GET['tab']) && $_GET['tab'] == 'avatar' ) {
if ( isset($_GET['remove_avatar']) && $_GET['remove_avatar'] == 1 ) {
if ( $uObj->avatarDelete() != FALSE )
wp_redirect($this->link_helper($this->Praized->currentUserLogin(), 'user') . '?tab=avatar&updated='.time());
else if ( ! empty($uObj->errors) )
$this->errors[] = $this->__('Sorry, but we could not delete your avatar at this time. Please try again later.');
} else if ( isset($_GET['updated']) ) {
if ( ! empty($_GET['message']) )
$this->errors[] = $this->stripper($_GET['message']);
else
$this->notices[] = $this->__('If you do not see any changes in your avatar yet, they will appear within a couple of minutes.');
}
} else if ( isset($_POST['tab']) && in_array($_POST['tab'], $valid_tabs) ) {
$redirect = FALSE;
switch ( $_POST['tab'] ) {
case $valid_tabs[1]:
// avatar delete
if ( $_POST['remove_avatar'] == 1 && $uObj->avatarDelete() )
$redirect = TRUE;
break;
case $valid_tabs[2]:
// password edit
$required = array('user_old_password', 'user_password', 'user_password_confirmation');
if ( $this->_test_required_fields($required) && $uObj->passwordEdit($identifier, $_POST) )
$this->notices[] = $this->__('Your password was updated successfully.');
break;
case $valid_tabs[3]:
if ( $_POST['setting_notify_by_twitter'] != 1 )
$_POST['setting_notify_by_twitter'] = 0;
if ( $_POST['setting_notify_by_email'] != 1 )
$_POST['setting_notify_by_email'] = 0;
if ( $_POST['setting_facebook_enabled'] != 1 )
$_POST['setting_facebook_enabled'] = 0;
if ( $_POST['setting_twitter_enabled'] == 1 ) {
$twitter_go = TRUE;
$twitter_test = $this->_test_required_fields(array('setting_twitter_username', 'setting_twitter_password'));
} else
$_POST['setting_twitter_enabled'] = 0;
if ( $_POST['setting_laconica_enabled'] == 1 ) {
$laconica_go = TRUE;
$laconica_test = $this->_test_required_fields(array('setting_laconica_site', 'setting_laconica_username', 'setting_laconica_password'));
} else
$_POST['setting_laconica_enabled'] = 0;
if ( $_POST['setting_friend_feed_enabled'] == 1 ) {
$friend_feed_go = TRUE;
$friend_feed_test = $this->_test_required_fields(array('setting_friend_feed_username', 'setting_friend_feed_remote_key'));
} else
$_POST['setting_friend_feed_enabled'] = 0;
if ( $_POST['setting_ping_fm_enabled'] == 1 ) {
$ping_fm_go = TRUE;
$ping_fm_test = $this->_test_required_fields(array('setting_ping_fm_application_key'));
} else
$_POST['setting_ping_fm_enabled'] = 0;
if ( $twitter_go && ! $twitter_test )
$redirect = FALSE;
else if ( $laconica_go && ! $laconica_test )
$redirect = FALSE;
else if ( $friend_feed_go && ! $friend_feed_test )
$redirect = FALSE;
else if ( $ping_fm_go && ! $ping_fm_test )
$redirect = FALSE;
else if ( $uObj->notificationsEdit($identifier, $_POST) ) {
$redirect = TRUE;
}
break;
default:
// $valid_tabs[0], profile edit
$required = array('user_email');
if ( $this->_test_required_fields($required) ) {
if ( ! preg_match('/^[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}$/i', $_POST['user_email'] ) )
$this->errors[] = $this->__('Sorry, but the email address you entered does not match a recognized format.');
else if ( $uObj->profileEdit($identifier, $_POST) )
$redirect = TRUE;
}
break;
}
if ( $redirect )
wp_redirect($this->link_helper($this->Praized->currentUserLogin(), 'user') . '?updated=true');
else if ( ! empty($uObj->errors) )
$this->errors[] = array_shift($uObj->errors);
}
$template = 'user_edit';
break;
case 'communities':
$template = 'user_communities';
break;
default:
$template = 'user';
break;
}
if ( $user_object = $uObj->get($identifier, $_GET) ) {
if ( is_object($user_object) ) {
$this->_route_is_user = TRUE;
$this->_tpt_environment($user_object);
$this->_reset_404();
$this->template($template);
}
}
break;
}
}
/**
* Handles the /actions* API routes
* (from $this->_reroute())
*
* @param array $route_parts Indexed array of the elements making the current API route (as def in $this->_reroute())
* @since 1.5
*/
function _route_actions($route_parts) {
// Leaving switch for future-proofing
switch ($route_parts[1]) {
default:
$this->_route_is_actions = TRUE;
$this->_reset_404();
$this->template('actions');
break;
}
}
/**
* Handles the /questions* API routes
* (from $this->_reroute())
*
* @param array $route_parts Indexed array of the elements making the current API route (as def in $this->_reroute())
* @since 1.6
*/
function _route_questions($route_parts) {
if ( ! isset($route_parts[1]) || empty($route_parts[1]) )
$route_parts[1] = '';
// Leaving switch for future-proofing
switch ($route_parts[1]) {
case '':
// handles posting questions while not logged in to the praized network
if ( $this->Praized->isAuthorized() && isset($_GET['oauth_token']) && isset($_COOKIE[$this->_preserve_post_cookie_name()]) ) {
$_POST = unserialize(stripslashes($_COOKIE[$this->_preserve_post_cookie_name()]));
$this->_preserve_post(FALSE);
} else if ( $this->Praized->isAuthorized() && ! empty($_POST) && ! isset($_POST['broadcast_services']) ) {
$_POST['broadcast_services'] = array('none');
}
if ( count($_POST) > 0 ) {
if ( ! $this->Praized->isAuthorized() ) {
$this->_preserve_post();
}
$qObj = $this->Praized->question();
$return = $qObj->add($_POST);
if ( isset($return->question->permalink) )
$redirect = $return->question->permalink;
else if( isset($qObj->errors[401]) )
$redirect = $this->trigger_url . '/oauth/logout';
else if ( isset($qObj->errors[422]) )
$this->errors = $qObj->errors;
if ( isset($redirect) ) {
wp_redirect($redirect);
exit;
}
}
$qObj = $this->Praized->questions();
if ( $questions_object = $qObj->get($_GET) ) {
if ( is_object($questions_object) ) {
$this->_route_is_questions = TRUE;
$this->_tpt_environment($questions_object);
$this->_reset_404();
$this->template('questions');
}
}
break;
default:
$this->_route_question($route_parts);
break;
}
}
/**
* Handles the /questions/{question_pid}* API routes
* (from $this->_reroute(), through $this->_route_questions())
*
* @param array $route_parts Indexed array of the elements making the current API route (as def in $this->_reroute())
* @since 1.6
*/
function _route_question($route_parts) {
if ( empty($route_parts[1]) )
wp_redirect($this->trigger_url);
$identifier = $route_parts[1];
// handles posting answers while not logged in to the praized network
if ( $this->Praized->isAuthorized() && isset($_GET['oauth_token']) && isset($_COOKIE[$this->_preserve_post_cookie_name()]) && $route_parts[2] == 'answers' ) {
$_POST = unserialize(stripslashes($_COOKIE[$this->_preserve_post_cookie_name()]));
$this->_preserve_post(FALSE);
}
if ( ! isset($route_parts[2]) || empty($route_parts[2]) )
$route_parts[2] = '';
else if ( $route_parts[2] == 'answers' && ( ! isset($route_parts[3]) || empty($route_parts[3]) ) && count($_POST) == 0 )
$route_parts[2] = $route_parts[3] = '';
switch ($route_parts[2]) {
case 'answers':
if ( count($_POST) > 0 ) {
if ( ! $this->Praized->isAuthorized() )
$this->_preserve_post();
$qObj = $this->Praized->question();
$return = $qObj->answerAdd($identifier, $_POST);
if ( isset($return->answer->question->permalink) )
$redirect = $return->answer->question->permalink;
else if ( isset($return->answer->permalink) )
$redirect = $return->answer->permalink;
else if( isset($qObj->errors[401]) )
$redirect = $this->trigger_url . '/oauth/logout';
else
$redirect = $this->link_helper($identifier, 'question');
wp_redirect($redirect);
exit;
}
$this->_route_answer($route_parts);
break;
default:
$qObj = $this->Praized->question();
if ( $question_object = $qObj->answers($identifier, $_GET) ) {
if ( is_object($question_object) ) {
$this->_route_is_question = TRUE;
if ( isset($question_object->user->login) )
$this->tpt_user = $question_object->user;
if ( isset($question_object->answers) )
$this->tpt_answers = $question_object->answers;
$this->_tpt_environment($question_object);
$this->_reset_404();
$this->template('question');
}
}
break;
}
}
/**
* Handles the /questions/{question_pid}/answers/{answer_pid} API routes
* (from $this->_reroute(), through $this->_route_question())
*
* @param array $route_parts Indexed array of the elements making the current API route (as def in $this->_reroute())
* @since 1.6
*/
function _route_answer($route_parts) {
if ( $route_parts[0] == 'answers' ) {
if ( empty($route_parts[1]) )
wp_redirect($this->trigger_url);
$identifier = $route_parts[1];
$alt_redirect = '../questions'; // should be path to questions list
} else if ( $route_parts[0] == 'questions' ) {
if ( empty($route_parts[3]) )
wp_redirect($this->trigger_url);
$identifier = $route_parts[3];
$alt_redirect = '../'; // should be path to parent question
} else {
wp_redirect($this->trigger_url);
}
$qObj = $this->Praized->question();
if ( $answer_object = $qObj->answer($identifier, $_GET) ) {
if ( ! is_object($answer_object) ) {
wp_redirect($alt_redirect);
exit;
}
if ( $_POST['_action'] == 'delete' ) {
$qObj->answerDelete($identifier, $_POST);
if ( isset($answer_object->answer->question->permalink) )
wp_redirect($answer_object->answer->question->permalink);
else
wp_redirect($alt_redirect);
exit;
}
$this->_route_is_answer = TRUE;
if ( isset($answer_object->answer->question) )
$this->tpt_question = $answer_object->answer->question;
if ( isset($answer_object->answer->user->login) )
$this->tpt_user = $answer_object->answer->user;
if ( isset($answer_object->answer->merchants) )
$this->tpt_merchants = $answer_object->answer->merchants;
$this->_tpt_environment($answer_object);
$this->_reset_404();
$this->template('answer');
} else {
wp_redirect($alt_redirect);
exit;
}
}
/**
* Handles the /help/ route
* (from $this->_reroute())
*
* @param array $route_parts Indexed array of the elements making the current API route (as def in $this->_reroute())
* @since 1.7
*/
function _route_help($route_parts) {
if ( $route_parts[0] != 'help' )
wp_redirect($this->trigger_url);
$instance_tpt = TEMPLATEPATH . '/' . $this->_plugin_name . '/help.html';
if ( defined('WPLANG') && WPLANG != '' && WPLANG != 'en' ) {
$tmp = str_replace('help.html', 'help-'.WPLANG.'.html', $instance_tpt);
if ( file_exists($tmp) )
$instance_tpt = $tmp;
unset($tmp);
}
if ( file_exists($instance_tpt) ) {
$this->tpt_help_content = file_get_contents($instance_tpt);
} else {
// If there is no custom, template-level help file, get the standard remote one from static.praized.com
$url = $this->Praized->praizedLinks['help_include'] . '?v=' . $this->version;
if ( defined('WPLANG') && WPLANG != '' && WPLANG != 'en' && isset($this->PraizedXHTML->themes[WPLANG]) )
$url = str_replace('index.html', 'index-'.WPLANG.'.html', $url);
$cache_key = md5($url);
if ( ! ( $this->tpt_help_content = wp_cache_get($cache_key, $this->_cache_key) ) ) {
if ( $this->tpt_help_content = $this->Praized->getHttp($url) ) {
wp_cache_set($cache_key, $this->tpt_help_content, $this->_cache_key, 86400);
}
}
}
if ( ! $this->tpt_help_content )
return;
$this->_route_is_help = TRUE;
$this->_reset_404();
$this->template('help');
}
/**
* Handles the /communities* API routes
* (from $this->_reroute())
*
* @param array $route_parts Indexed array of the elements making the current API route (as def in $this->_reroute())
* @since 2.0
*/
function _route_communities($route_parts) {
if ( ! isset($route_parts[1]) || empty($route_parts[1]) )
$route_parts[1] = '';
// Leaving switch for future-proofing
switch ($route_parts[1]) {
default:
$cObj = $this->Praized->communities();
if ( $comm_object = $cObj->get($_GET) ) {
if ( is_object($comm_object) ) {
$this->_route_is_communities = TRUE;
$this->_tpt_environment($comm_object);
if ( $this->tpt_community_is_hub() ) {
$this->_reset_404();
$this->template('communities');
}
}
}
break;
}
}
/**
* Sets the template environment with meta data such as the
* community's info, pagination, etc.
*
* @param object $target Praized object as returned by the Praized PHP lib.
* @return boolean
* @since 0.1
*/
function _tpt_environment($target) {
if ( ! isset($target->community) )
return FALSE;
foreach ( $target as $key => $value ) {
$tpt_key = 'tpt_' . $key;
if ( isset($this->$tpt_key) && ( is_object($target->$key) || is_array($target->$key) ) )
$this->$tpt_key = $value;
}
return TRUE;
}
/**
* Returns an array of the current user's configured broadcast services.
*
* @return mixed Boolean FALSE or Array
* @since 1.6
*/
function _user_broadcast_services() {
if ( ! ( $identifier = $this->Praized->currentUserLogin() ) )
return FALSE;
$uObj = $this->Praized->user();
if ( ! ( $data = $uObj->get($identifier) ) || ! isset($data->user) || ! isset($data->user->self) )
return FALSE;
if ( ! ( $self = $data->user->self ) || ! isset($self->broadcast_services) || ! is_array($self->broadcast_services) )
return FALSE;
return $self->broadcast_services;
}
/**
* Includes the appropriate blogger-defined (theme) or default template
*
* @param string $template Template id (EG: merchants for user-defined /themes/x/praized-community/merchants.php or default merchants.php)
* @param boolean Are we dealing with a template fragment instead of a full template
* @since 0.1
*/
function template($template, $fragment = false){
if ( ! is_object($this->Praized) )
$this->_load_praized();
if ( empty($template) || $template == '_' )
return FALSE;
$user_tpt = TEMPLATEPATH . '/' . $this->_plugin_name . '/' . $template . '.php';
$default_tpt = $this->_includes . '/php/templates/' . $template . '.php';
if ( file_exists($user_tpt) )
require($user_tpt);
else if ( file_exists($default_tpt) )
require($default_tpt);
else
return FALSE;
if ( ! $fragment )
exit;
}
/**
* Includes a user-defined or default template fragment (files starting with _ in template dir)
*
* @param string $fragment (EG: merchants for templates/_merchants.php or merchant/hcard for templates/merchant/_hcard.php)
* @since 0.1
*/
function fragment($fragment) {
if ( strstr($fragment, '/') )
$template = preg_replace('|(.*)/([^/]*)$|', '\1/_\2', $fragment);
else
$template = '_' . $fragment;
$this->template($template, true);
}
/**
* Template helper: returns and optionaly echos the desired API object attribute.
* Used as helper in the enabling of the template-level functions such as pzdc_merchant_name()
*
* @param string $parent Parent object id (EG: "merchant" for $this->tpt_merchant)
* @param string $attribute Parent object attribute chain (EG: "location->city->name" for $this->tpt_merchant->location->city->name)
* @param boolean $echo Should the output be written to STDOUT or simply returned
* @param string Optional endpoint (merchant pid/user login) identifier to be used instead of the $this->tpt_* holders
* @return mixed FALSE on error, usually a string on success, but depends on the requested attribute
* @see praized-community.php
* @since 0.1
*/
function tpt_attribute_helper($parent, $attribute, $echo = TRUE, $identifier = FALSE) {
if ( ! empty($identifier) ) {
switch ( $parent ) {
case 'merchant':
$this->tpt_has_merchant($identifier);
break;
case 'user':
$this->tpt_has_user($identifier);
break;
case 'friend':
$this->tpt_has_friend($identifier);
break;
}
}
if ( ! preg_match('/^tpt_/', $parent) )
$parent = 'tpt_' . $parent;
if ( ! isset($this->$parent) )
return FALSE;
// @note Cleaning up input in light of upcoming eval()
if ( ! preg_match('/^([a-zA-Z0-9_>-]*)?/', $attribute, $matches) || ! isset($matches[1]) )
return FALSE;
$ref = '$this->' . $parent . '->' . $matches[1];
eval('$out = ( isset('.$ref.') ) ? '.$ref.' : FALSE;');
if ( is_string($out) ) {
switch ( strtolower(trim($out)) ) {
case 'true':
$out = TRUE;
break;
case 'false':
$out = FALSE;
break;
}
}
if ( $echo )
echo $out;
return $out;
}
/**
* Template function: Tests if there are > 0 items in $this->tpt_merchants
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return mixed boolean FALSE or integer Merchant count
* @since 0.1
*/
function tpt_has_merchants($query = FALSE) {
if ( ! $this->tpt_merchants ) {
if ( ! is_array($query) ) {
$query = $_GET;
if ( isset($_GET['q']) && empty($_GET['q']) && isset($_GET['l']) && empty($_GET['l']) ) {
// We still need users to be able to overwrite the defaults and submit an
// "Everything + Everywhere" query, but only when the form is truly submitted.
$query['q'] = $query['l'] = ''; // Just for clarity
} else {
// Important to test against the original $_GET value in the ternary operator,
// or the query transformation (1st) will mess up the location transformation
// (2nd) done after...
if ( empty($query['q']) )
$query['q'] = ( ! empty($_GET['l']) ) ? '' : $this->_config['default_query'];
if ( empty($query['l']) )
$query['l'] = ( ! empty($_GET['q']) ) ? '' : $this->_config['default_location'];
}
}
$mObj = $this->Praized->merchants();
$response = $mObj->get($query);
if ( is_object($response) && is_array($response->merchants) )
$this->_tpt_environment($response);
}
if ( is_array($this->tpt_merchants) )
return count($this->tpt_merchants);
return FALSE;
}
/**
* Template function: Praized equivalent of the WP "the_loop" for the current merchants list, usually used in while loop
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean and sets $this->tpt_merchant if appropriate
* @since 0.1
*/
function tpt_merchants_loop($query = FALSE) {
$this->tpt_has_next_merchant = FALSE;
if ( $this->tpt_has_merchants($query) ) {
$merchants = $this->tpt_merchants;
if ( isset($merchants[$this->tpt_merchant_index]) ) {
$merchant = $merchants[$this->tpt_merchant_index];
$this->tpt_merchant = $merchant;
$this->tpt_tags = FALSE;
$this->tpt_tag_index = 0;
$this->tpt_tag = FALSE;
if ( isset($merchants[$this->tpt_merchant_index + 1]) )
$this->tpt_has_next_merchant = TRUE;
$this->tpt_merchant_index++;
return TRUE;
}
}
return FALSE;
}
/**
* Template function: Tests if there is a valid $this->tpt_merchant
*
* @param string Optional merchant pid identifier to be used instead of the $this->tpt_* holders
* @return boolean
* @since 0.1
*/
function tpt_has_merchant($identifier = FALSE) {
if ( ! $this->tpt_merchant ) {
if ( ! empty($identifier) ) {
$mObj = $this->Praized->merchant();
$response = $mObj->get($identifier);
if ( is_object($response) && isset($response->merchant) )
$this->_tpt_environment($response);
}
}
if ( is_object($this->tpt_merchant) && isset($this->tpt_merchant->pid) )
return TRUE;
return FALSE;
}
/**
* Template function: Tests if the current page is a single merchant page
*
* @return boolean
* @since 1.0.4
*/
function tpt_is_merchant_page() {
if ( $this->_route_is_merchant )
return TRUE;
return FALSE;
}
/**
* Template function: Tests if $this->tpt_tags truly has a tag list
*
* @return boolean
* @since 0.1
*/
function tpt_has_tags() {
if ( ! $this->tpt_tags ) {
$this->tpt_tags = ( isset($this->tpt_merchant->tags) && is_array($this->tpt_merchant->tags) )
? $this->tpt_merchant->tags
: FALSE;
}
if ( is_array($this->tpt_tags) )
return count($this->tpt_tags);
return FALSE;
}
/**
* Template function: Praized equivalent of the WP "the_loop" for the current merchant's tag list, usually used in while loop
*
* @return boolean and sets $this->tpt_merchant if appropriate
* @since 0.1
*/
function tpt_tags_loop() {
$this->tpt_has_next_tag = FALSE;
if ( $this->tpt_has_tags() ) {
$tag_list = $this->tpt_tags;
if ( isset($tag_list[$this->tpt_tag_index]) ) {
$tag = $tag_list[$this->tpt_tag_index];
$this->tpt_tag = $tag;
if ( isset($tag_list[$this->tpt_tag_index + 1]) )
$this->tpt_has_next_tag = TRUE;
$this->tpt_tag_index++;
return TRUE;
}
}
return FALSE;
}
/**
* Template function: Tests if $this->tpt_splinks truly has a sponsored
* links list. Will only work in the right views (ie: individual merchant
* show, not listings)
*
* @return boolean
* @since 0.1
*/
function tpt_has_splinks() {
if ( ! $this->_route_is_merchant )
return FALSE;
if ( ! $this->tpt_splinks ) {
if ( isset($this->tpt_merchant->sponsored_links) && is_array($this->tpt_merchant->sponsored_links) ) {
/**
* Mandatory extra loop to ensure we respect the sponsored link
* node's own order node to sort the list.
*/
$links = array();
foreach ( $this->tpt_merchant->sponsored_links as $link) {
if ( is_object($link) && isset($link->order) )
$links[$link->order] = $link;
}
$this->tpt_splinks = ( count($links) > 0 ) ? $links : FALSE;
}
}
if ( is_array($this->tpt_splinks) )
return count($this->tpt_splinks);
return FALSE;
}
/**
* Template function: Praized equivalent of the WP "the_loop" for the
* current merchant's sponsored link list, usually used in while loop.
* Will only work in the right views (ie: individual merchant show,
* not listings).
*
* @return boolean and sets $this->tpt_merchant if appropriate
* @since 0.1
*/
function tpt_splinks_loop() {
$this->tpt_has_next_splink = FALSE;
if ( $this->tpt_has_splinks() ) {
$splink_list = $this->tpt_splinks;
if ( isset($splink_list[$this->tpt_splink_index]) ) {
$splink = $splink_list[$this->tpt_splink_index];
$this->tpt_splink = $splink;
if ( isset($splink_list[$this->tpt_splink_index + 1]) )
$this->tpt_has_next_splink = TRUE;
$this->tpt_splink_index++;
return TRUE;
}
}
return FALSE;
}
/**
* Template function: Tests if $this->tpt_spimages truly has a sponsored
* image list. Will only work in the right views (ie: individual merchant
* show, not listings)
*
* @return boolean
* @since 1.7
*/
function tpt_has_spimages() {
if ( ! $this->_route_is_merchant )
return FALSE;
if ( ! $this->tpt_spimages ) {
if ( isset($this->tpt_merchant->sponsored_images) && is_array($this->tpt_merchant->sponsored_images) ) {
/**
* Mandatory extra loop to ensure we respect the sponsored image
* node's own order node to sort the list.
*/
$links = array();
foreach ( $this->tpt_merchant->sponsored_images as $link) {
if ( is_object($link) && isset($link->order) )
$links[$link->order] = $link;
}
$this->tpt_spimages = ( count($links) > 0 ) ? $links : FALSE;
}
}
if ( is_array($this->tpt_spimages) )
return count($this->tpt_spimages);
return FALSE;
}
/**
* Template function: Praized equivalent of the WP "the_loop" for the
* current merchant's sponsored image list, usually used in while loop.
* Will only work in the right views (ie: individual merchant show,
* not listings).
*
* @return boolean and sets $this->tpt_merchant if appropriate
* @since 1.7
*/
function tpt_spimages_loop() {
$this->tpt_has_next_spimage = FALSE;
if ( $this->tpt_has_spimages() ) {
$spimage_list = $this->tpt_spimages;
if ( isset($spimage_list[$this->tpt_spimage_index]) ) {
$spimage = $spimage_list[$this->tpt_spimage_index];
$this->tpt_spimage = $spimage;
if ( isset($spimage_list[$this->tpt_spimage_index + 1]) )
$this->tpt_has_next_spimage = TRUE;
$this->tpt_spimage_index++;
return TRUE;
}
}
return FALSE;
}
/**
* Template function: Tests if $this->tpt_comments truly has a comment list, or sets it.
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean
* @since 0.1
*/
function tpt_has_comments($query = FALSE) {
if ( ! $this->tpt_comments ) {
if ( is_array($query) )
$query = array_merge($_GET, $query);
else
$query = $_GET;
$mObj = $this->Praized->merchant();
$uObj = $this->Praized->user();
if ( $this->_route_is_merchant ) {
$response = $mObj->comments($this->tpt_merchant->pid, $query);
} else if ( $this->_route_is_user ) {
$response = $uObj->comments($this->tpt_user->login, $query);
} else {
$response = FALSE;
}
if ( is_object($response) )
$this->_tpt_environment($response);
}
if ( is_array($this->tpt_comments) )
return count($this->tpt_comments);
return FALSE;
}
/**
* Template function: Praized equivalent of the WP "the_loop" for the current merchant's comments list, usually used in while loop
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean and sets $this->tpt_merchant if appropriate
* @since 0.1
*/
function tpt_comments_loop($query = FALSE) {
$this->tpt_has_next_comment = FALSE;
if ( $this->tpt_has_comments($query) ) {
$comment_list = $this->tpt_comments;
if ( isset($comment_list[$this->tpt_comment_index]) ) {
$comment = $comment_list[$this->tpt_comment_index];
$this->tpt_comment = $comment;
if ( isset($comment->merchant) && $this->_route_is_user )
$this->tpt_merchant = $comment->merchant;
if ( isset($comment->user) && $this->_route_is_merchant )
$this->tpt_user = $comment->user;
if ( isset($comment_list[$this->tpt_comment_index + 1]) )
$this->tpt_has_next_comment = TRUE;
$this->tpt_comment_index++;
return TRUE;
}
}
return FALSE;
}
/**
* Template function: Tests if $this->tpt_favorites truly has a favorite list, or sets it.
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean
* @since 0.1
*/
function tpt_has_favorites($query = FALSE) {
if ( ! $this->tpt_favorites ) {
if ( is_array($query) )
$query = array_merge($_GET, $query);
else
$query = $_GET;
$mObj = $this->Praized->merchant();
$uObj = $this->Praized->user();
if ( $this->_route_is_merchant ) {
$response = $mObj->favorites($this->tpt_merchant->pid, $query);
} else if ( $this->_route_is_user ) {
$response = $uObj->favorites($this->tpt_user->login, $query);
} else {
$response = FALSE;
}
if ( is_object($response) ) {
if ( isset($response->users) && is_array($response->users) )
$this->tpt_favorites = $response->users;
else if ( isset($response->merchants) && is_array($response->merchants) )
$this->tpt_favorites = $response->merchants;
$this->_tpt_environment($response);
}
}
if ( is_array($this->tpt_favorites) )
return count($this->tpt_favorites);
return FALSE;
}
/**
* Template function: Praized equivalent of the WP "the_loop" for the current merchant's favorites list, usually used in while loop
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean and sets $this->tpt_merchant if appropriate
* @since 0.1
*/
function tpt_favorites_loop($query = FALSE) {
$this->tpt_has_next_favorite = FALSE;
if ( $this->tpt_has_favorites($query) ) {
$favorite_list = $this->tpt_favorites;
if ( isset($favorite_list[$this->tpt_favorite_index]) ) {
$favorite = $favorite_list[$this->tpt_favorite_index];
if ( $this->_route_is_merchant )
$this->tpt_user = $favorite;
if ( $this->_route_is_user )
$this->tpt_merchant = $favorite;
if ( isset($favorite_list[$this->tpt_favorite_index + 1]) )
$this->tpt_has_next_favorite = TRUE;
$this->tpt_favorite_index++;
return TRUE;
}
}
return FALSE;
}
/**
* Template function: Tests if $this->tpt_votes truly has a vote list, or sets it.
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean
* @since 0.1
*/
function tpt_has_votes($query = FALSE) {
if ( ! $this->tpt_votes ) {
if ( is_array($query) )
$query = array_merge($_GET, $query);
else
$query = $_GET;
$mObj = $this->Praized->merchant();
$uObj = $this->Praized->user();
if ( $this->_route_is_merchant ) {
$response = $mObj->votes($this->tpt_merchant->pid, $query);
} else if ( $this->_route_is_user ) {
$response = $uObj->votes($this->tpt_user->login, $query);
} else {
$response = FALSE;
}
if ( is_object($response) )
$this->_tpt_environment($response);
}
if ( is_array($this->tpt_votes) )
return count($this->tpt_votes);
return FALSE;
}
/**
* Template function: Praized equivalent of the WP "the_loop" for the current merchant's votes list, usually used in while loop
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean and sets $this->tpt_merchant if appropriate
* @since 0.1
*/
function tpt_votes_loop($query = FALSE) {
$this->tpt_has_next_vote = FALSE;
if ( $this->tpt_has_votes($query) ) {
$vote_list = $this->tpt_votes;
if ( isset($vote_list[$this->tpt_vote_index]) ) {
$vote = $vote_list[$this->tpt_vote_index];
$this->tpt_vote = $vote;
if ( isset($vote->merchant) && $this->_route_is_user )
$this->tpt_merchant = $vote->merchant;
if ( isset($vote->user) && $this->_route_is_merchant )
$this->tpt_user = $vote->user;
if ( isset($vote_list[$this->tpt_vote_index + 1]) )
$this->tpt_has_next_vote = TRUE;
$this->tpt_vote_index++;
return TRUE;
}
}
return FALSE;
}
/**
* Template function: Tests if there is a valid $this->tpt_user
*
* @param string Optional user login identifier to be used instead of the $this->tpt_* holders
* @return boolean
* @since 0.1
*/
function tpt_has_user($identifier = FALSE) {
if ( ! $this->tpt_user ) {
if ( ! empty($identifier) ) {
$uObj = $this->Praized->user();
$response = $uObj->get($identifier);
if ( is_object($response) && isset($response->user) )
$this->_tpt_environment($response);
}
}
if ( is_object($this->tpt_user) && isset($this->tpt_user->login) )
return TRUE;
return FALSE;
}
/**
* Template function: Tests if $this->tpt_friends truly has a friend list, or sets it.
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean
* @since 0.1
*/
function tpt_has_friends($query = FALSE) {
if ( ! $this->tpt_friends ) {
if ( is_array($query) )
$query = array_merge($_GET, $query);
else
$query = $_GET;
if ( $this->_route_is_user ) {
$uObj = $this->Praized->user();
$response = $uObj->friends($this->tpt_user->login, $query);
} else {
$response = FALSE;
}
if ( is_object($response) ) {
$this->tpt_friends = ( is_object($response) && is_array($response->users) )
? $response->users
: FALSE;
$this->_tpt_environment($response);
}
}
if ( is_array($this->tpt_friends) )
return count($this->tpt_friends);
return FALSE;
}
/**
* Template function: Praized equivalent of the WP "the_loop" for the current user's friends list, usually used in while loop
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean and sets $this->tpt_merchant if appropriate
* @since 0.1
*/
function tpt_friends_loop($query = FALSE) {
$this->tpt_has_next_friend = FALSE;
if ( $this->tpt_has_friends($query) ) {
$friend_list = $this->tpt_friends;
if ( isset($friend_list[$this->tpt_friend_index]) ) {
$friend = $friend_list[$this->tpt_friend_index];
$this->tpt_friend = $friend;
if ( isset($friend_list[$this->tpt_friend_index + 1]) )
$this->tpt_has_next_friend = TRUE;
$this->tpt_friend_index++;
return TRUE;
}
}
return FALSE;
}
/**
* Template function: Tests if there is a valid $this->tpt_friend
*
* @param string Optional merchant pid identifier to be used instead of the $this->tpt_* holders
* @return boolean
* @since 0.1
*/
function tpt_has_friend($identifier = FALSE) {
if ( ! $this->tpt_friend ) {
if ( ! empty($identifier) ) {
$uObj = $this->Praized->user();
$response = $uObj->get($identifier);
if ( is_object($response) && isset($response->user) ) {
$this->tpt_friend = ( is_object($response->user) && isset($response->user->login) )
? $response->user
: FALSE;
if ( ! $this->tpt_community )
$this->_tpt_environment($response);
}
}
}
if ( is_object($this->tpt_friend) && isset($this->tpt_friend->login) )
return TRUE;
return FALSE;
}
/**
* Template function: Tests if there are > 0 items in $this->tpt_actions
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return mixed boolean FALSE or integer Action count
* @since 1.5
*/
function tpt_has_actions($query = FALSE) {
if ( ! $this->tpt_actions ) {
if ( is_array($query) )
$query = array_merge($_GET, $query);
else
$query = $_GET;
if ( $this->_route_is_merchant ) {
$obj = $this->Praized->merchant();
$response = $obj->actions($this->tpt_merchant->pid, $query);
} else if ( $this->_route_is_user ) {
$obj = $this->Praized->user();
$response = $obj->actions($this->tpt_user->login, $query);
} else {
$obj = $this->Praized->actions();
$response = $obj->get($query);
}
if ( is_object($response) && is_array($response->actions) )
$this->_tpt_environment($response);
}
if ( is_array($this->tpt_actions) )
return count($this->tpt_actions);
return FALSE;
}
/**
* Template function: Praized equivalent of the WP "the_loop" for the current actions list, usually used in while loop
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean and sets $this->tpt_action if appropriate
* @since 1.5
*/
function tpt_actions_loop($query = FALSE) {
$this->tpt_has_next_action = FALSE;
if ( $this->tpt_has_actions($query) ) {
$actions = $this->tpt_actions;
if ( isset($actions[$this->tpt_action_index]) ) {
$action = $actions[$this->tpt_action_index];
$this->tpt_action = $action;
if ( isset($actions[$this->tpt_action_index + 1]) )
$this->tpt_has_next_action = TRUE;
$this->tpt_action_index++;
return TRUE;
}
}
return FALSE;
}
/**
* Template function: Tests if there is a valid $this->tpt_action
*
* @return boolean
* @since 1.5
*/
function tpt_has_action() {
if ( is_object($this->tpt_action) && isset($this->tpt_action->summary) )
return TRUE;
return FALSE;
}
/**
* Template function: Tests if there are > 0 items in $this->tpt_questions
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return mixed boolean FALSE or integer Question count
* @since 1.6
*/
function tpt_has_questions($query = FALSE) {
if ( ! $this->tpt_questions ) {
if ( is_array($query) )
$query = array_merge($_GET, $query);
else
$query = $_GET;
if ( $this->_route_is_merchant ) {
$obj = $this->Praized->merchant();
$response = $obj->questions($this->tpt_merchant->pid, $query);
} else if ( $this->_route_is_user ) {
$obj = $this->Praized->user();
$response = $obj->questions($this->tpt_user->login, $query);
} else {
$obj = $this->Praized->questions();
$response = $obj->get($query);
}
if ( is_object($response) && is_array($response->questions) )
$this->_tpt_environment($response);
}
if ( is_array($this->tpt_questions) )
return count($this->tpt_questions);
return FALSE;
}
/**
* Template function: Praized equivalent of the WP "the_loop" for the current questions list, usually used in while loop
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean and sets $this->tpt_action if appropriate
* @since 1.6
*/
function tpt_questions_loop($query = FALSE) {
$this->tpt_has_next_question = FALSE;
if ( $this->tpt_has_questions($query) ) {
$questions = $this->tpt_questions;
if ( isset($questions[$this->tpt_question_index]) ) {
$question = $questions[$this->tpt_question_index];
$this->tpt_question = $question;
if ( isset($question->user->login) )
$this->tpt_user = $question->user;
if ( isset($questions[$this->tpt_question_index + 1]) )
$this->tpt_has_next_question = TRUE;
$this->tpt_question_index++;
return TRUE;
}
}
return FALSE;
}
/**
* Template function: Tests if there is a valid $this->tpt_question
*
* @return boolean
* @since 1.6
*/
function tpt_has_question() {
if ( is_object($this->tpt_question) && isset($this->tpt_question->pid) ) {
if ( isset($this->tpt_question->answers) )
$this->tpt_answers = $this->tpt_question->answers;
if ( isset($this->tpt_question->user) )
$this->tpt_user = $this->tpt_question->user;
return TRUE;
}
return FALSE;
}
/**
* Template function: Tests if there are > 0 items in $this->tpt_answers
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return mixed boolean FALSE or integer Answer count
* @since 1.6
*/
function tpt_has_answers($query = FALSE) {
if ( ! $this->tpt_answers ) {
if ( is_array($query) )
$query = array_merge($_GET, $query);
else
$query = $_GET;
if ( $this->_route_is_merchant ) {
$obj = $this->Praized->merchant();
$response = $obj->answers($this->tpt_merchant->pid, $query);
} else if ( $this->_route_is_user ) {
$obj = $this->Praized->user();
$response = $obj->answers($this->tpt_user->login, $query);
} else if ( is_object($this->tpt_question) && isset($this->tpt_question->pid) ) {
$obj = $this->Praized->question();
$response = $obj->answers($this->tpt_question->pid);
}
if ( is_object($response) && is_array($response->answers) )
$this->_tpt_environment($response);
}
if ( is_array($this->tpt_answers) )
return count($this->tpt_answers);
return FALSE;
}
/**
* Template function: Praized equivalent of the WP "the_loop" for the current answers list, usually used in while loop
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean and sets $this->tpt_action if appropriate
* @since 1.6
*/
function tpt_answers_loop($query = FALSE) {
$this->tpt_has_next_answer = FALSE;
if ( $this->tpt_has_answers($query) ) {
$answers = $this->tpt_answers;
if ( isset($answers[$this->tpt_answer_index]) ) {
$answer = $answers[$this->tpt_answer_index];
$this->tpt_answer = $answer;
if ( isset($answer->user->login) )
$this->tpt_user = $answer->user;
if ( isset($answer->merchants) )
$this->tpt_merchants = $answer->merchants;
if ( isset($answers[$this->tpt_answer_index + 1]) )
$this->tpt_has_next_answer = TRUE;
$this->tpt_answer_index++;
return TRUE;
}
}
return FALSE;
}
/**
* Template function: Tests if there is a valid $this->tpt_answer
*
* @return boolean
* @since 1.6
*/
function tpt_has_answer() {
if ( is_object($this->tpt_answer) && isset($this->tpt_answer->pid) ) {
if ( isset($this->tpt_answer->merchants) )
$this->tpt_merchants = $this->tpt_answer->merchants;
if ( isset($this->tpt_answer->user) )
$this->tpt_user = $this->tpt_answer->user;
if ( isset($this->tpt_answer->question) )
$this->tpt_question = $this->tpt_answer->question;
return TRUE;
}
return FALSE;
}
/**
* Template function: Tests if there are > 0 items in $this->tpt_hub_communities
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return mixed boolean FALSE or integer Answer count
* @since 2.0
*/
function tpt_has_hub_communities($query = FALSE) {
if ( ! $this->tpt_hub_communities ) {
if ( is_array($query) )
$query = array_merge($_GET, $query);
else
$query = $_GET;
if ( $this->_route_is_merchant ) {
$obj = $this->Praized->merchant();
$response = $obj->communities($this->tpt_merchant->pid, $query);
} else if ( $this->_route_is_user ) {
$obj = $this->Praized->user();
$response = $obj->communities($this->tpt_user->login, $query);
} else if ( $this->_route_is_communities ) {
$obj = $this->Praized->communities();
$response = $obj->get();
}
if ( is_object($response) && is_array($response->communities) ) {
$response->hub_communities = $response->communities;
$this->_tpt_environment($response);
}
}
if ( is_array($this->tpt_hub_communities) )
return count($this->tpt_hub_communities);
return FALSE;
}
/**
* Template function: Praized equivalent of the WP "the_loop" for the current hub communities list, usually used in while loop
*
* @param array Optional query to overwrite the current context and force fetch other data
* @return boolean and sets $this->tpt_action if appropriate
* @since 2.0
*/
function tpt_hub_communities_loop($query = FALSE) {
$this->tpt_has_next_hub_community = FALSE;
if ( $this->tpt_has_hub_communities($query) ) {
$hub_communities = $this->tpt_hub_communities;
if ( isset($hub_communities[$this->tpt_hub_community_index]) ) {
$hub_community = $hub_communities[$this->tpt_hub_community_index];
$this->tpt_hub_community = $hub_community;
if ( isset($hub_communities[$this->tpt_hub_community_index + 1]) )
$this->tpt_has_next_hub_community = TRUE;
$this->tpt_hub_community_index++;
return TRUE;
}
}
return FALSE;
}
/**
* Template function: Tests if there is a valid $this->tpt_hub_community
*
* @return boolean
* @since 2.0
*/
function tpt_has_hub_community() {
if ( is_object($this->tpt_hub_community) && isset($this->tpt_hub_community->slug) )
return TRUE;
return FALSE;
}
/**
* Returns the content node of an answer, with the localized "deleted at" text instead of required
*
* @param boolean $echo
* @return string content
* @since 1.6
*/
function tpt_answer_content($echo = TRUE, $answer = FALSE) {
if ( ! $answer )
$answer = $this->tpt_answer;
if ( ! $answer || ! $answer->pid )
return FALSE;
if ( isset($answer->deleted_at) )
$out = $this->__('This answer has been deleted.');
else
$out = $answer->content;
if ( $echo )
echo $out;
return $out;
}
/**
* Returns an unordered list of merchants related to a specific answer.
*
* @param boolean $echo
* @return mixed Boolean FALSE or String unordered list of merchants
* @since 1.6
*/
function tpt_answer_merchants($echo = TRUE) {
if ( ! $this->tpt_answer || ! $this->tpt_answer->merchants || ! is_array($this->tpt_answer->merchants) || count($this->tpt_answer->merchants) < 1 )
return FALSE;
$merchants = $this->tpt_answer->merchants;
$out = '';
$out .= $this->tpt_merchants_simple_list($merchants);
if ( $echo )
echo $out;
return $out;
}
/**
* Template function: Vote button
*
* @param boolean $echo
* @param string $identifier Optional merchant PID, defauts to $this->tpt_merchant
* @return string
* @since 1.5
*/
function tpt_vote_button($echo = TRUE, $identifier = FALSE) {
if ( ! $this->tpt_has_merchant($identifier) )
return;
if ( ! $this->_load_praized() || ! $this->PraizedXHTML )
return;
$translations = array(
'must_login' => $this->__('You must login before you can vote! - Just click, we\'ll take you there and back!'),
'vote_up' => $this->__('Vote Up'),
'vote_down' => $this->__('Vote Down')
);
$theme_lang = '';
if ( defined('WPLANG') && WPLANG != '' && isset($this->PraizedXHTML->themes[WPLANG]) )
$theme_lang = WPLANG;
// The PraizedXHTML vote button template needs a comunity node to get the base url
$hack = new stdClass();
$hack->merchant = $this->tpt_merchant;
$hack->community = $this->tpt_community;
$out = $this->PraizedXHTML->xhtml($hack, 'vote_button', array('translations' => $translations, 'lang' => $theme_lang));
if ( $echo )
echo $out;
return $out;
}
/**
* Template function: Outputs a standard UL-based pagination toolbar from the currently instantiated $this->tpt_pagination
*
* @param array $options Pagination option overwrites, see PraizedCore::paginate
* @param boolean $echo
* @return mixed Boolean or String
* @since 0.1
*/
function tpt_paginate($options = array(), $echo = TRUE) {
if ( ! isset($this->tpt_pagination) || ! is_object($this->tpt_pagination) )
return FALSE;
if ( ! isset($options['prev_label']) || empty($options['prev_label']) )
$options['prev_label'] = $this->__('Previous');
if ( ! isset($options['next_label']) || empty($options['next_label']) )
$options['next_label'] = $this->__('Next');
$xhtml = $this->Praized->paginate($this->tpt_pagination, $options);
if ( ! empty($xhtml) ) {
if ( $echo )
echo $xhtml;
return $xhtml;
} else {
return FALSE;
}
}
/**
* Google map integration
* @see http://code.google.com/apis/maps/documentation/staticmaps/
*
* @param float $latitude
* @param float $longitude
* @param array $raw_params
* @param boolean $echo
* @return string
* @since 0.1
*/
function tpt_map($latitude, $longitude, $raw_params = array(), $caption = '', $echo = TRUE) {
if ( ! isset($this->_config['map_api_key']) || empty($this->_config['map_api_key']) || empty($latitude) || empty($longitude) )
return false;
if ( ! isset($raw_params['size']) && $this->_config['map_width'] != '' && $this->_config['map_height'] != '' )
$raw_params['size'] = intval($this->_config['map_width']) . 'x' . intval($this->_config['map_height']);
if ( ! isset($raw_params['zoom']) && $this->_config['map_zoom_level'] != '' )
$raw_params['zoom'] = intval($this->_config['map_zoom_level']);
$translations = array(
'img_title' => $this->__('click the map for a dynamic version'),
'img_alt' => $this->__('Google Map')
);
$out = $this->Praized->googleMap($this->_config['map_api_key'], $latitude, $longitude, $raw_params, $caption, $translations);
if ( $echo )
echo $out;
return $out;
}
/**
* Looks for the stats image url in the current merchant's data
* and echoes/returns an image tag or NULL. Will only work in
* the right views (ie: individual merchant show, not listings)
*
* @param boolean $echo
* @param string $identifier Optional merchant PID, defauts to $this->tpt_merchant
* @return mixed NULL or String
* @since 0.1
*/
function tpt_stats_img($echo = TRUE, $identifier = FALSE) {
if ( ! $this->_route_is_merchant || ! $this->tpt_has_merchant($identifier) )
return;
$mObj = $this->Praized->merchant();
$out = $mObj->statsImage($this->tpt_merchant);
if ( $echo )
echo $out;
return $out;
}
/**
* Praized.com merchant sharing integration
*
* @param boolean $echo
* @param string $identifier Optional merchant PID, defauts to $this->tpt_merchant
* @return mixed NULL or String
* @since 0.1
*/
function tpt_share($echo = TRUE, $identifier = FALSE) {
$mObj = $this->Praized->merchant();
$out = $mObj->share($this->tpt_merchant->pid);
if ( $echo )
echo $out;
return $out;
}
/**
* Praized.com twitter integration
*
* @param object $merchantData
* @return string Twitter URL with merchant data
* @since 1.0.4
*/
function tpt_twitter_link($echo = TRUE, $identifier = FALSE) {
if ( ! $this->_route_is_merchant || ! $this->tpt_has_merchant($identifier) )
return;
$mObj = $this->Praized->merchant();
$out = $mObj->twitterLink($this->tpt_merchant);
if ( $echo )
echo $out;
return $out;
}
/**
* Time distance helper
*
* @param mixed int|string $from Either a time in seconds, or a strtotime translatable string
* @param array $translations Translated captions, see source for keys and English captions.
* @param boolean $echo
* @return string How long ago was the $from from right now.
* @since 1.5
*/
function tpt_time_distance($from, $translations = array(), $echo = TRUE) {
$out = $this->Praized->timeDistance($from, $translations);
if ( $echo )
echo $out;
return $out;
}
/**
* Template function: Returns a simple of the passed merchants array.
*
* @param array $merchants
* @return string
* @since 1.6
*/
function tpt_merchants_simple_list($merchants) {
if ( ! is_array($merchants) || count($merchants) < 1 )
return '';
$out .= '';
foreach ( $merchants as $merchant ) {
$out .= '';
if ( $merchant->permalink )
$out .= ''.$merchant->name.' ';
else
$out .= $merchant->name;
if ( $location = $merchant->location ) {
$out .= ': ';
if ( $location->city->name ) {
$out .= $location->city->name;
if ( $location->regions->state || $location->regions->province || $location->country->name )
$out .= ', ';
}
if ( $location->regions->state || $location->regions->province ) {
$out .= ( $location->regions->state ) ? $location->regions->state : $location->regions->province;
if ( $location->country->name )
$out .= ', ';
}
if ( $location->country->name ) {
$out .= $location->country->name;
}
$out .= ' ';
}
$out .= ' ';
}
$out .= ' ';
return $out;
}
/**
* Template function: Returns a list of the current user's configured broadcast services as checkboxes.
*
* @param boolean $echo
* @return string
* @since 1.6
*/
function tpt_questions_user_broadcast_services($echo = TRUE) {
if ( ! ( $services = $this->_user_broadcast_services() ) )
return '';
$checkboxes = '';
foreach ( $services as $service ) {
if ( isset($service->service_type) && isset($service->name) ) {
$service_id = 'praized_broadcast_service_'.strtolower($service->service_type);
$checkboxes .= ' '
. ''.$service->name.' ';
}
}
if ( $echo )
echo $checkboxes;
return $checkboxes;
}
/**
* Template function: Current merchants search term (?q=)
*
* @param boolean $echo Defines if the output should be echoed or simpy returned, defaults to TRUE
* @return string
* @since 1.7
*/
function tpt_search_query($echo = TRUE) {
global $PraizedCommunity;
if ( isset($_GET['q']) && empty($_GET['q']) && isset($_GET['l']) && empty($_GET['l']) ) {
// We still need users to be able to overwrite the defaults and submit an
// "Everything + Everywhere" query, but only when the form is truly submitted.
$out = '';
} else {
$out = ( ! empty($_GET['q']) )
? pzdc_stripper($_GET['q'])
: ( ( ! empty($_GET['l']) )
? ''
: $PraizedCommunity->_config['default_query'] );
}
if ( $echo )
echo $out;
return $out;
}
/**
* Template function: Current merchants location query (?l=)
*
* @param boolean $echo Defines if the output should be echoed or simpy returned, defaults to TRUE
* @return string
* @since 1.7
*/
function tpt_search_location($echo = TRUE) {
global $PraizedCommunity;
if ( isset($_GET['q']) && empty($_GET['q']) && isset($_GET['l']) && empty($_GET['l']) ) {
// We still need users to be able to overwrite the defaults and submit an
// "Everything + Everywhere" query, but only when the form is truly submitted.
$out = '';
} else {
$out = ( ! empty($_GET['l']) )
? pzdc_stripper($_GET['l'])
: ( ( ! empty($_GET['q']) )
? ''
: $PraizedCommunity->_config['default_location'] );
}
if ( $echo )
echo $out;
return $out;
}
/**
* Template function: Current merchants tag search term (?t= or ?tag= or ?category= or from route)
*
* @param boolean $echo Defines if the output should be echoed or simpy returned, defaults to TRUE
* @return string
* @since 1.7
*/
function tpt_search_tag($echo = TRUE) {
if ( ! empty($_GET['t']) || ! empty($_GET['tag']) || ! empty($_GET['category']) ) {
$out = ( ! empty($_GET['t']) )
? $this->stripper($_GET['t'])
: ( ! empty($_GET['tag']) )
? $this->stripper($_GET['tag'])
: $this->stripper($_GET['category']);
} else if ( $this->_route_is_tag ) {
preg_match('/\/(tag|category)\/([^\/]*)/', $this->_script_uri, $matches);
if ( ! empty($matches[2]) )
$out = htmlspecialchars(urldecode($matches[2]));
}
if ( $echo )
echo $out;
return $out;
}
/**
* Template function: returns the info to be displayed between the search form and result
*
* @param boolean $echo
* @return string
* @since 1.7
*/
function tpt_search_results_info($echo = TRUE) {
$pagination = $this->tpt_pagination;
if ( ! $pagination || ! $pagination->total_entries || ! $this->_route_is_merchants )
return;
$total = intval($pagination->total_entries);
if ( $total >= 1000 )
$total .= '+';
// tag search supersedes true query search
$query = $this->tpt_search_tag(FALSE);
$query_format = $this->__('for the tag "%s "');
// if not in a tag search context, rollback to search query
if ( empty($query) ) {
$query = $this->tpt_search_query(FALSE);
$query_format = $this->__('for "%s "');
}
if ( ! empty($query) )
$query = sprintf($query_format, $query);
else
$query = 'for ' . $this->__('everything') . ' ';
$location = $this->tpt_search_location(FALSE);
$location_format = $this->__('in %s ');
if ( ! empty($location) )
$location = sprintf($location_format, $location);
else
$location = '' . $this->__('everywhere') . ' ';
$caption = sprintf(
$this->__('We found %s results %s %s.'),
$total,
$query,
$location
);
$caption = '' . $caption . '
';
if ( $echo )
echo $caption;
return $caption;
}
/**
* Template function: Returns an unordered list of merchants related to a specific structured question.
*
* @param boolean $echo
* @param string Optional question pid, or defaults to $this->tpt_question->pid
* @return mixed Boolean FALSE or String unordered list of related merchants
* @since 1.6
*/
function tpt_question_related_merchants($echo = TRUE, $identifier = FALSE) {
if ( ! $identifier ) {
if ( ! $this->tpt_question || ! $this->tpt_question->pid )
return FALSE;
$identifier = $this->tpt_question->pid;
}
$obj = $this->Praized->question();
$data = $obj->relatedMerchants($identifier);
if ( ! ($merchants = $data->merchants) || ! is_array($merchants) || count($merchants) < 1 )
return FALSE;
$out = '';
$out .= $this->tpt_merchants_simple_list($merchants);
if ( $echo )
echo $out;
return $out;
}
/**
* Template function: Returns the secret tokenized url for a user's avatar upload.
*
* @param boolean $echo
* @return mixed Boolean FALSE or String url
* @since 2.0
*/
function tpt_user_avatar_upload_url($echo = TRUE) {
$return_to = rawurlencode( $this->link_helper( $this->Praized->currentUserLogin() . '/edit?tab=avatar&updated=' . time(), 'user' ) );
$obj = $this->Praized->user();
$data = $obj->avatarUploadToken();
$url = $data->avatar->url. '&lang='. WPLANG .'&return_to=' . $return_to;
if ( $echo )
echo $url;
return $url;
}
/**
* Template function: Defines if a community is a hub or not
*
* @param object Community object as returned by the Praized API, defaults to $this->tpt_community
* @return Boolean
* @since 2.0
*/
function tpt_community_is_hub($community_object = FALSE) {
if ( ! $community_object || ! $community_object->slug )
$community_object = $this->tpt_community;
if ( isset($community_object->type) && strtolower($community_object->type) == 'hub' )
return TRUE;
return FALSE;
}
/**
* Widget: Search form
*
* @param array $args WP standard
* @since 0.1
*/
function widget_search_form($args = array()) {
// no need to show the search form when it's already shown in the main content area
if ( $this->_route_is_merchants || $this->_route_is_user || $this->_route_is_actions )
return;
extract($args);
$widget_id = $this->_wdgt_search_form_key;
$config = $this->_get_wp_option($widget_id);
echo $before_widget; // WP STANDARD
echo '';
$title = ( $config['title'] != '' ) ? $config['title'] : $this->__('Praized: Search');
echo $before_title; // WP STANDARD
echo '';
echo $after_title; // WP STANDARD
$this->template('_search_form', true);
echo "\n \n";
echo $after_widget; // WP STANDARD
}
/**
* Widget: Authorization (oauth) nav
*
* @param array $args WP standard
* @since 0.1
*/
function widget_auth_nav($args = array()) {
extract($args);
$widget_id = $this->_wdgt_auth_nav_key;
$config = $this->_get_wp_option($widget_id);
echo $before_widget; // WP STANDARD
echo '';
$title = ( $config['title'] != '' ) ? $config['title'] : $this->__('Praized: Session');
echo $before_title; // WP STANDARD
echo '';
echo $after_title; // WP STANDARD
$this->template('_auth_nav', true);
echo "\n \n";
echo $after_widget; // WP STANDARD
}
/**
* Widget: Section nav
*
* @param array $args WP standard
* @since 1.7
*/
function widget_section_nav($args = array()) {
extract($args);
$widget_id = $this->_wdgt_section_nav_key;
$config = $this->_get_wp_option($widget_id);
echo $before_widget; // WP STANDARD
echo '';
$title = ( $config['title'] != '' ) ? $config['title'] : $this->__('Praized: Sections');
echo $before_title; // WP STANDARD
echo '';
echo $after_title; // WP STANDARD
// this is only used when the widget is display outside of the praized
// community's path. Otherwise, $this->tpt_community is already set.
if ( ! $this->tpt_community && ( $response = $this->Praized->test() ) && ! empty($response->community->slug) )
$this->tpt_community = $response->community;
$this->template('_section_nav', true);
echo "\n \n";
echo $after_widget; // WP STANDARD
}
}
?>