0) {
$pluginName = $plugins[0];
}
else {
$pluginName = TOPICHUB_NO_RENDER_PLUGIN;
}
}
return ($pluginName!=TOPICHUB_NO_RENDER_PLUGIN) ? $pluginName : FALSE;
}
/**
* We need to make sure pass-by-reference works, so we can't func_get_args
**/
function topichubs_render_invoke($hook, &$arg0=null, &$arg1=null, &$arg2=null, &$arg3=null) {
$render_plugin = topichubs_render_plugin();
if (!empty($render_plugin)) {
$module = $render_plugin;
$function = $module .'_topichubs_render_'. $hook;
$result = $function($arg0, $arg1, $arg2, $arg3);
return $result;
} else {
return "#!#TH_RENDER_NO_IMPL#!#"; //None of the render implementation modules are enabled
}
}
/**
* Declare the views version we support (and provide views)
*/
function topichubs_views_api() {
return array(
'api' => 2.0,
'path' => drupal_get_path('module', 'topichubs') .'/views',
);
}
/**
* Implementation of hook_perm().
*/
function topichubs_perm() {
return array(
'administer topichubs',
);
}
/**
* Implementation of hook_menu().
*/
function topichubs_menu() {
$items = array();
$items['admin/content/topichubs'] = array(
'title' => 'Topic Hubs',
'description' => 'Topic Hubs',
'page callback' => 'topichubs_admin_overview',
'access arguments' => array('administer topichubs'),
'file' => 'topichubs.admin.inc',
);
$items['admin/content/topichubs/list'] = array(
'title' => 'List',
'description' => 'List all site Topic Hubs',
'type' => MENU_DEFAULT_LOCAL_TASK,
'weight' => 10,
);
$items['admin/content/topichubs/hot'] = array(
'title' => 'Hot Topics',
'description' => 'What Topics are Hot.',
'page callback' => 'topichubs_hot_topics_page',
'access arguments' => array('administer topichubs'),
'file' => 'topichubs.admin.inc',
'type' => MENU_LOCAL_TASK,
'weight' => 15,
);
$items['admin/content/topichubs/settings'] = array(
'title' => t('Settings'),
'description' => 'Configuration for Topic Hubs.',
'page callback' => 'drupal_get_form',
'page arguments' => array('topichubs_settings'),
'access arguments' => array('administer topichubs'),
'file' => 'topichubs.admin.inc',
'type' => MENU_LOCAL_TASK,
'weight' => 20,
);
if (_get_panels_version() >= 6300 && !variable_get('topichubs_panel_update_run', 0)) {
$items['admin/content/topichubs/update'] = array(
'title' => t('Update'),
'description' => 'Update existing Topic Hubs from Panels 2 to Panels 3.',
'page callback' => 'topichubs_update_page',
'access arguments' => array('administer topichubs'),
'file' => 'topichubs.admin.inc',
'type' => MENU_LOCAL_TASK,
'weight' => 25,
);
}
$items['node/%node/topichub'] = array(
'title' => 'Topic Hub Configuration',
'page callback' => 'drupal_get_form',
'page arguments' => array('topichubs_config_form', 1),
'access callback' => 'topichubs_access',
'access arguments' => array(1),
'weight' => 2,
'type' => MENU_LOCAL_TASK
);
$items_render = topichubs_render_invoke('menu');
if(is_array($items_render)) {
$items = array_merge($items, $items_render);
}
return $items;
}
/**
* Implementation of hook_access().
*/
function topichubs_access($node) {
return user_access('administer topichubs') && $node->type == 'topichub';
}
/**
* Implementation of hook_theme().
*/
function topichubs_theme() {
$themes = array();
$themes['topichubs_config_form'] = array(
'arguments' => array('form' => array()),
);
$plugins = topichubs_discover_plugins();
foreach ($plugins as $type => $definition) {
$themes["topichubs_{$type}"] = array(
'pattern' => "topichubs_{$type}__",
'arguments' => array('topichub' => NULL, 'items' => array()),
'path' => $definition['theme path'],
'template' => "topichubs-{$type}",
);
}
return $themes;
}
/**
* Implementation of hook_theme_registry_alter().
*
* This is so that it will look for the node-topichub.tpl.php file here too.
*/
function topichubs_theme_registry_alter(&$theme_registry) {
$modulepath = drupal_get_path('module', 'topichubs');
array_unshift($theme_registry['node']['theme paths'], $modulepath);
}
/**
* Implementation of hook_preprocess_node().
*
* This is so that it will look for the node-topichub-[nid].tpl.php
*/
function topichubs_preprocess_node(&$variables) {
$node = $variables['node'];
if($node->type == 'topichub') {
$variables['template_files'][] = 'node-' . $node->type . '-' . $node->nid;
}
}
/**
* Implementation of hook_nodeapi().
*/
function topichubs_nodeapi(&$node, $op, $param3 = NULL, $param4 = NULL) {
if ($node->type == 'topichub') {
switch ($op) {
case 'prepare':
topichubs_render_invoke('load', $node);
// covers add coming from hot topic page.
if (arg(1) == 'add' && isset($_GET['tid'])) {
$tid = $_GET['tid'];
$term = taxonomy_get_term($tid);
$node->title = "{$term->name} Topic Hub";
$node->topichub_tid = $tid;
}
break;
case 'load':
topichub_load($node);
topichubs_render_invoke('load', $node);
break;
case 'validate':
topichubs_render_invoke('validate', $node);
break;
case 'insert':
if(property_exists($node, 'topichub_tid')) {
$node->topichub->conditions = array(array($node->topichub_tid));
topichub_insert($node);
}
// Since calling topichub_insert is conditional, we have to call this outside that function
// This does a redirect too, so cal it last
topichubs_render_invoke('insert', $node);
break;
case 'update':
topichubs_render_invoke('update', $node);
break;
case 'delete':
topichubs_render_invoke('delete', $node);
topichub_delete($node->nid);
break;
case 'view':
if(topichub_is_initialized($node)) {
$res = topichubs_render_invoke('view', $node);
if ($res == '#!#TH_RENDER_NO_IMPL#!#') { //default, TPL_based implementationvai
$path = drupal_get_path('module', 'topichubs');
drupal_add_css("$path/topichubs.css");
topichub_view($node);
}
}
else {
drupal_set_message(t('Topic Hub not initialized. Please !config.', array('!config' => l('configure an expression', "node/{$node->nid}/topichub"))));
}
break;
}
}
}
/**
* Implementation of hook_taxonomy().
*
* Make sure deleted terms are removed from existing expressions
*/
function topichubs_taxonomy($op, $type, $data) {
if($op == 'delete' && $type == 'term') {
topichub_term_delete($data['tid']);
}
}
/**
* Implementation of hook_form_alter().
*
* If we are creating a Topic Hub form a Taxonomy Term, set the value for save processing
*/
function topichubs_form_alter(&$form, $form_state, $form_id) {
if($form_id == 'topichub_node_form'){
$node = $form['#node'];
if($node->topichub_tid) {
$form['topichub_tid'] = array(
'#type' => 'hidden',
'#value' => $node->topichub_tid,
);
}
topichubs_render_invoke('form', $node, $form);
}
}
/**
* Determine if a topichub has any conditions setup.
*/
function topichub_is_initialized($node) {
if(is_numeric($node)) {
$node = node_load($node);
}
else if (is_object($node) && is_numeric($node->nid)) {
return !empty($node->topichub->conditions);
}
return FALSE;
}
/**
* Lookup topichub data from the DB
*
* @param $node
* The node to load with configuration. It will populate an object property of topichub
* with the taxonomy expression and plugin configuration.
*/
function topichub_load(&$node) {
$result = db_query('SELECT * FROM {topichub} WHERE nid = %d', $node->nid);
if ($topichub = db_fetch_object($result)) {
$node->topichub = $topichub;
$node->topichub->config = unserialize($topichub->config);
$node->topichub->conditions = topichub_load_conditions($node->nid);
}
}
/**
* Lookup topichub condition from the DB
*
* @param $nid
* The node id to load the conditions.
*/
function topichub_load_conditions($nid) {
$result = db_query('SELECT * FROM {topichub_condition} WHERE nid = %d ORDER BY `condition` ASC, tcid ASC', $nid);
$conditions = array();
while($cond = db_fetch_object($result)) {
$conditions[$cond->condition][] = $cond->tid;
}
return $conditions;
}
/**
* Load all topichub data from providers.
*
* @param $node
* The node to load with data. It should have an object property of topichub which
* will get populated with a data array.
*/
function topichub_view(&$node) {
$plugins = topichubs_discover_plugins();
foreach ($plugins as $type => $def) {
$impl = _topichubs_new_handler_class($def);
if($impl) {
$impl->init($type, $def, $node, $node->topichub->config[$type]);
$node->topichub->data[$type] = $impl->execute();
}
}
return $node;
}
/**
* Insert topichub data.
*
* @param $node
* The node to persist. It should have an object property of topichub
*/
function topichub_insert($node) {
db_query("INSERT INTO {topichub} (nid, config) VALUES (%d, %b)", $node->nid, serialize($node->topichub->config));
topichub_insert_conditions($node->nid, $node->topichub->conditions);
}
/**
* Update topichub data.
*
* @param $node
* The node to persist. It should have an object property of topichub
*/
function topichub_update($node) {
db_query("UPDATE {topichub} SET config = %b WHERE nid = %d", serialize($node->topichub->config), $node->nid);
topichub_insert_conditions($node->nid, $node->topichub->conditions);
}
/**
* Insert condition data for the topichub expression.
*
* @param $nid
* Node ID
* @param $conditions
* Array of conditions and term IDs for each condition
*/
function topichub_insert_conditions($nid, $conditions) {
db_query("DELETE FROM {topichub_condition} WHERE nid = %d", $nid);
foreach($conditions as $key => $tids) {
foreach($tids as $tid) {
db_query("INSERT INTO {topichub_condition} (nid, `condition`, tid) VALUES (%d, %d, %d)", $nid, $key, $tid);
}
}
}
/**
* Remove topichub data.
*
* @param $nid
* The node to delete
*/
function topichub_delete($nid) {
db_query("DELETE FROM {topichub} WHERE nid = %d", $nid);
db_query("DELETE FROM {topichub_condition} WHERE nid = %d", $nid);
}
/**
* Topichub remove term from conditions. We also need to load the conditions and reorder them
* b/c the first condition might have only 1 term and if we remove it conditions woudl start ordering @ 1.
*
* @param $nid
* The node to delete
*/
function topichub_term_delete($tid) {
$result = db_query("SELECT DISTINCT(nid) FROM {topichub_condition} WHERE tid = %d", $tid);
db_query("DELETE FROM {topichub_condition} WHERE tid = %d", $tid);
while($cond = db_fetch_object($result)) {
$conditions = topichub_load_conditions($cond->nid);
$conditions = array_merge($conditions);
topichub_insert_conditions($cond->nid, $conditions);
}
}
/**
* Form for configuring a Topic Hub.
* This form allows for the building of a taxonomy
* expression (in conjunction with topichubs.js). It also provides the configuration
* options for each of the enabled Topic Hub plugins.
*/
function topichubs_config_form(&$form_state, $node) {
$path = drupal_get_path('module', 'topichubs');
drupal_add_css("$path/topichubs-admin.css");
drupal_add_js("$path/topichubs.js");
// Add image as an array so the JS can always use [0]. Somethign wierd was happening where
// the multistep form was setting this value twice and causign the JS to barf when adding
// a term to the UI. This way it is always an array and even if there are many, [0] works.
drupal_add_js(array(
'topichubs' => array(
'delete_img' => array(theme('image', "$path/images/delete.gif")),
)
), 'setting');
topichub_load($node);
$form = array();
$form['#node'] = $node;
$form['nid'] = array(
'#type' => 'hidden',
'#value' => $node->nid,
);
_topichub_plugin_expression_form($form, $form_state, $node);
_topichub_plugin_config_form($form, $form_state, $node);
$form['#tree'] = TRUE;
$form['submit'] = array(
'#type' => 'submit',
'#value' => t('Save'),
);
return $form;
}
/**
* Render the Topic Hub Expression Builder form.
*/
function _topichub_plugin_expression_form(&$form, &$form_state, $node) {
$conditions = $form_state['storage']['conditions'];
if(!isset($conditions)) {
$conditions = array();
if(is_array($node->topichub->conditions)) {
foreach($node->topichub->conditions as $cond => $tids) {
$conditions[$cond] = implode(',', $tids);
}
}
}
$form['expression']['help'] = array(
'#type' => 'markup',
'#value' => t('Content meeting any of the following conditions will be included in this Topic Hub. Adding multiple terms will make a specific condition more stringent. Adding conditions will broaden the context of your Topic Hub by increasing the likelyhood of matching. Be careful, large expressions can have a significant performance penalty.'),
);
$form['expression']['buttons']['add_condition'] = array(
'#type' => 'submit',
'#value' => t('New Condition'),
'#submit' => array('topichubs_config_form_add_condition'),
'#skip_validate' => TRUE,
);
$vocab_options = array('' => '