tripal_views_integration.inc 29 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746
  1. <?php
  2. /**
  3. * Purpose: Provide Guidance to new Tripal Admin
  4. *
  5. * @return
  6. * HTML Formatted text
  7. *
  8. * @ingroup tripal_views_integration
  9. */
  10. function tripal_views_description_page() {
  11. $text .= '<h3>Tripal Views Quick Links:</h3>';
  12. $text .= "<ul>
  13. <li><a href=\"".url("admin/tripal/views/integration/mviews") . "\">List of integrated tables</a></li>
  14. <li><a href=\"".url("admin/tripal/views/integration/mviews/new"). "\">Integrate a new table</a></li>
  15. </ul>";
  16. $text .= '<h3>Views Integration Description:</h3>';
  17. $text .= '<p>Tripal Views provides an interface for integrating <a href="http://drupal.org/project/views">Drupal Views</a>
  18. with Tripal materialized views. This will allow site administrators to create custom queries for the materialized views
  19. and in turn provide custom content pages, custom blocks and custom search forms. The forms allow a site administrator
  20. to select a materialized view and associate other Chado tables on which the view can join. Usage of this module requires
  21. a good understanding of foreign-key relationships in Chado.
  22. </p>';
  23. $text .= '<h3>Setup Instructions:</h3>';
  24. $text .= '<p>After installation of the Tripal core module. The following tasks should be performed
  25. <ol>
  26. <li><b>Set Permissions</b>: To allow access to site administrators for this module, simply
  27. <a href="'.url('admin/user/permissions').'">assign permissions</a> to the appropriate user roles for the
  28. permission type "manage tripal_views_integration". </li>
  29. </ol>
  30. </p>';
  31. $text .= '<h3>Usage Instructions:</h3>';
  32. $text .= "<p>To use Tripal Views integration follow these steps:
  33. <ol>
  34. <li><b>Identify or create a materialized view:</b> Using the <a href=\"".url("admin/tripal/views/mviews") . "\">
  35. Tripal materialized View</a> interface, identify the view you would like to integrate or create a new one.</li>
  36. <li><b>Setup the Views Integration</b>: Navigate to the <a href=\"".url("admin/tripal/views/integration/mviews/new") . "\">
  37. Tripal views integration setup page</a> to integrate the selected materialized view. Provide a user friendly name
  38. and description to help you remember the purpose for integrating the view. Next, select the view you want to integrate
  39. from the provided select box. If your materialized view has fields that can join with other Chado tables, you may
  40. provide those relationships in the provided form. Finally, if your fields require a special handler for display, you
  41. may select it from the drop down provided</li>
  42. <li><b>Create custom pages/block/search form</b>: After saving setup information from step 2 above, you will be redirected to the
  43. Drupal Views interface</a> where you can create a custom page, block or search form.</li>
  44. <li><b>Review your integrated views</b>: A page providing a
  45. <a href=\"".url("admin/tripal/views/integration/mviews/list") . "\">list of all integrated views</a> is provided. You may
  46. view this page to see all integrated views, but also to remove any unwanted integrations.</li>
  47. </ol>
  48. </p>";
  49. return $text;
  50. }
  51. /**
  52. *
  53. * @ingroup tripal_views_integration
  54. */
  55. function tripal_views_integration_setup_list(){
  56. $header = array('', 'Drupal Views Type Name', 'Table Name', 'Is Mview', 'Comment','');
  57. $rows = array();
  58. // get the list of materialized views
  59. $tviews = db_query('SELECT * FROM {tripal_views}');
  60. while($tview = db_fetch_object($tviews)){
  61. if($tview->mview_id){
  62. // get the materialized view
  63. $sql = "SELECT * FROM {tripal_mviews} WHERE mview_id = %d";
  64. $mview = db_fetch_object(db_query($sql,$tview->mview_id));
  65. $rows[] = array(
  66. l('Edit',"admin/tripal/views/integration/edit/".$tview->setup_id) ,
  67. $tview->name,
  68. $mview->mv_table,
  69. 'Yes',
  70. $tview->comment,
  71. l('Delete',"admin/tripal/views/integration/delete/".$tview->setup_id),
  72. );
  73. } else {
  74. $rows[] = array(
  75. l('Edit',"admin/tripal/views/integration/edit/".$tview->setup_id) ,
  76. $tview->name,
  77. $tview->table_name,
  78. 'No',
  79. $tview->comment,
  80. l('Delete',"admin/tripal/views/integration/delete/".$tview->setup_id),
  81. );
  82. }
  83. }
  84. $rows[] = array(
  85. 'data' => array(
  86. array('data' => l('Add a new entry',"admin/tripal/views/integration/new") . " | " .
  87. l("Create View",'admin/build/views/add'),
  88. 'colspan' => 6),
  89. )
  90. );
  91. return theme('table', $header, $rows);
  92. }
  93. /**
  94. *
  95. * @ingroup tripal_views_integration
  96. */
  97. function tripal_views_integration_delete($setup_id){
  98. db_query("DELETE FROM {tripal_views} WHERE setup_id = %d",$setup_id);
  99. db_query("DELETE FROM {tripal_views_handlers} WHERE setup_id = %d",$setup_id);
  100. db_query("DELETE FROM {tripal_views_join} WHERE setup_id = %d",$setup_id);
  101. drupal_set_message("Record Deleted");
  102. drupal_goto('admin/tripal/views/integration');
  103. }
  104. /**
  105. *
  106. * @ingroup tripal_views_integration
  107. */
  108. function tripal_views_integration_form(&$form_state, $setup_id = NULL){
  109. $form = array();
  110. $data = array();
  111. $form['#cache'] = TRUE;
  112. // ahah_helper requires us to register the form with it's module
  113. ahah_helper_register($form, $form_state);
  114. // if a setup_id is provided then we want to get the form defaults
  115. $setup_obj = array();
  116. if(isset($setup_id)){
  117. // get the deafult setup values
  118. $sql = "SELECT * FROM {tripal_views} WHERE setup_id = %d";
  119. $setup_obj = db_fetch_object(db_query($sql,$setup_id));
  120. $mview_id = $setup_obj->mview_id;
  121. $table_name = $setup_obj->table_name;
  122. $form_state['storage']['mview_id'] = $mview_id;
  123. $form_state['storage']['table_name'] = $table_name;
  124. // get the default join settings and handlers
  125. $sql = "SELECT * FROM {tripal_views_join} WHERE setup_id = %d";
  126. $query = db_query($sql,$setup_id);
  127. $default_joins = array();
  128. while ($join = db_fetch_object($query)){
  129. $default_joins[$join->base_field]['left_table'] = $join->left_table;
  130. $default_joins[$join->base_field]['left_field'] = $join->left_field;
  131. }
  132. // get the default handlers
  133. $sql = "SELECT * FROM {tripal_views_handlers} WHERE setup_id = %d";
  134. $query = db_query($sql,$setup_id);
  135. $default_handlers = array();
  136. while ($handler = db_fetch_object($query)){
  137. $default_handlers[$handler->column_name][$handler->handler_type]['handler_name'] = $handler->handler_name;
  138. $default_handlers[$handler->column_name][$handler->handler_type]['arguments'] = $handler->arguments;
  139. }
  140. // add in the setup_id for the form so we know this is an update not an insert
  141. $form['setup_id'] = array(
  142. '#type' => 'hidden',
  143. '#value' => $setup_id,
  144. );
  145. }
  146. // add a fieldset for the MView & Chado table selectors
  147. $form['base_table_type'] = array(
  148. '#type' => 'fieldset',
  149. '#title' => 'Base Table',
  150. '#description' => 'Please select either a materialized view or a Chado table for integration with '.
  151. 'Drupal Views. In Drupal Views terminology, the selected table becomes the "base table". '.
  152. 'After you select a table from either list, the fields from that table will appear below '.
  153. 'and you can specify other tables to join with and handlers.',
  154. );
  155. // build the form element that lists the materialized views
  156. $query = db_query("SELECT mview_id,name FROM {tripal_mviews} ORDER BY name");
  157. $mview_tables = array();
  158. $mview_tables['0'] = 'Select';
  159. while ($mview = db_fetch_object($query)){
  160. $mview_tables[$mview->mview_id] = $mview->name;
  161. }
  162. $form['base_table_type']['mview_id'] = array(
  163. '#title' => t('Materialized View'),
  164. '#type' => 'select',
  165. '#options' => $mview_tables,
  166. '#description' => 'Which materialized view to use.',
  167. '#default_value' => $setup_obj->mview_id,
  168. '#ahah' => array(
  169. 'path' => ahah_helper_path(array('view_setup_table')),
  170. 'wrapper' => 'table-rows-div',
  171. 'effect' => 'fade',
  172. 'event' => 'change',
  173. 'method' => 'replace',
  174. ),
  175. );
  176. // build the form element for the Chado tables
  177. $chado_tables = tripal_core_get_chado_tables();
  178. $chado_tables = array_merge(array('Select',), $chado_tables);
  179. $form['base_table_type']['table_name'] = array(
  180. '#title' => t('Chado Table'),
  181. '#type' => 'select',
  182. '#options' => $chado_tables,
  183. '#description' => 'Which Chado table to use.',
  184. '#default_value' => $setup_obj->table_name,
  185. '#ahah' => array(
  186. 'path' => ahah_helper_path(array('view_setup_table')),
  187. 'wrapper' => 'table-rows-div',
  188. 'effect' => 'fade',
  189. 'event' => 'change',
  190. 'method' => 'replace',
  191. ),
  192. );
  193. $form['views_type'] = array(
  194. '#type' => 'fieldset',
  195. '#title' => 'View Type',
  196. '#description' => 'Here you can provide the "type" of View you want to create.',
  197. );
  198. // field for the name of the
  199. $form['views_type']['row_name'] = array(
  200. '#title' => t('View Type Name'),
  201. '#type' => 'textfield',
  202. '#default_value' => $setup_obj->name,
  203. '#size' => 60,
  204. '#maxlength' => 128,
  205. '#description' => 'Provide the view type name. This is the name that will appear in '.
  206. 'the Drupal Views interface when adding a new view. The view type name '.
  207. 'must be unique.',
  208. '#required' => TRUE,
  209. );
  210. if(isset($setup_id)){
  211. $form['row_name']['#attributes'] = array('readonly' => 'readonly');
  212. }
  213. $form['views_type']['row_description'] = array(
  214. '#title' => t('Comment'),
  215. '#type' => 'textarea',
  216. '#description' => '(Optional). Provide any details regarding this setup you would like. This '.
  217. 'description will appear when selecting a type for a new Drupal View',
  218. '#required' => FALSE,
  219. );
  220. // we need a div block where the table fields will get put when the
  221. // AHAH callback is made
  222. $form['view_setup_table'] = array(
  223. '#type' => 'item',
  224. '#prefix' => '<div id="table-rows-div">',
  225. '#suffix' => '</div>',
  226. );
  227. // add the fieldset for the table fields, but only if the $mview_id or $table_name
  228. // is set. The only times these values are set is if we're editing an existing
  229. // record or if the AHAH callback is being made.
  230. if ($form_state['storage']['mview_id'] or $form_state['storage']['table_name']){
  231. $mview_id = $form_state['storage']['mview_id'];
  232. $table_name = $form_state['storage']['table_name'];
  233. $form['view_setup_table'] = array(
  234. '#type' => 'fieldset',
  235. '#title' => 'Join Selection',
  236. '#prefix' => '<div id="fieldset-table-rows-wrapper">',
  237. '#suffix' => '</div>',
  238. );
  239. // get the columns in this materialized view. They are separated by commas
  240. // where the first word is the column name and the rest is the type
  241. $columns = array();
  242. if($mview_id){
  243. $sql = "SELECT mv_specs FROM {tripal_mviews} WHERE mview_id = %d";
  244. $mview = db_fetch_object(db_query($sql,$mview_id));
  245. $columns = explode(",",$mview->mv_specs);
  246. } else {
  247. $table_desc = module_invoke_all('chado_'.$table_name.'_schema');
  248. $fields = $table_desc['fields'];
  249. // iterate through the columns and build the format
  250. // compatible with the code below. The column name is first followed
  251. // by the type with a separating space
  252. foreach($fields as $column => $attrs){
  253. $columns[] = "$column ".$attrs['type'];
  254. }
  255. }
  256. $i=1;
  257. $form['view_setup_table']["instructions"] = array(
  258. '#type' => 'markup',
  259. '#value' => "Select an optional table to which the fields of the ".
  260. "materialized view can join. If a field does not need to ".
  261. "join you may leave the selection blank.",
  262. );
  263. $data['field_types'] = array();
  264. // get the list of chado tables to join on
  265. $chado_join_tables = tripal_core_get_chado_tables();
  266. $chado_join_tables = array_merge(array('Select a Join Table',), $chado_join_tables);
  267. // get list of all handlers
  268. $all_handlers = tripal_views_integration_discover_handlers();
  269. $handlers_fields = array();
  270. $handlers_filters = array();
  271. $handlers_sort = array();
  272. $handlers_arguments = array();
  273. $handlers_join = array();
  274. $handlers_rel = array();
  275. $handlers_fields[0] = "Select a field handler";
  276. $handlers_filters[0] = "Select a filter handler";
  277. $handlers_sort[0] = "Select a sort handler";
  278. $handlers_argument[0] = "Select an argument handler";
  279. $handlers_join[0] = "Select a join handler";
  280. $handlers_rel[0] = "Select a relationship handler";
  281. foreach($all_handlers as $handler){
  282. if(preg_match("/views_handler_field/",$handler)){
  283. $handlers_fields[$handler] = $handler;
  284. }
  285. if(preg_match("/views_handler_filter/",$handler)){
  286. $handlers_filters[$handler] = $handler;
  287. }
  288. if(preg_match("/views_handler_sort/",$handler)){
  289. $handlers_sort[$handler] = $handler;
  290. }
  291. if(preg_match("/views_handler_argument/",$handler)){
  292. $handlers_argument[$handler] = $handler;
  293. }
  294. if(preg_match("/views_handler_join/",$handler)){
  295. $handlers_join[$handler] = $handler;
  296. }
  297. if(preg_match("/views_handler_relationship/",$handler)){
  298. $handlers_rel[$handler] = $handler;
  299. }
  300. }
  301. // generate a unique $table_id for keeping track of the table
  302. if($mview_id){
  303. $table_id = $mview_id;
  304. } else {
  305. $table_id = $table_name;
  306. }
  307. // now iterate through the columns of the materialized view or
  308. // chado table and generate the join and handler fields
  309. foreach ($columns as $column){
  310. $column = trim($column); // trim trailing and leading spaces
  311. preg_match("/^(.*?)\ (.*?)$/",$column,$matches);
  312. $column_name = $matches[1];
  313. $column_type = $matches[2];
  314. $form['view_setup_table']["fields_start_$table_id-$i"] = array(
  315. '#type' => 'markup',
  316. '#value' => "<div class=\"fields-new-row\">",
  317. );
  318. $form['view_setup_table']["fields_name_$table_id-$i"] = array(
  319. '#type' => 'markup',
  320. '#attributes' => array('class' => 'fields-column-name'),
  321. '#value' => "<div class=\"column-id\">".
  322. "<span class=\"column-name\">$column_name</span>".
  323. "<br><span class=\"column-type\">$column_type</span>".
  324. "</div>".
  325. "<div class=\"column-form-fields\"><div class=\"column-one\">",
  326. );
  327. $data['field_types'][$column_name] = $column_type;
  328. // set the default values for the join table and columns
  329. $default_join_table = 0;
  330. $default_join_field = 0;
  331. if(isset($setup_id) && !isset($form_state['storage']["fields_join_$table_id-$i"])){
  332. $default_join_table = $default_joins[$column_name]['left_table'];
  333. $default_join_field = $default_joins[$column_name]['left_field'];
  334. $form_state['storage']["fields_join_$table_id-$i"] = $default_join_table;
  335. $form_state['storage']["fields_join_column_$table_id-$i"] = $default_join_field;
  336. }
  337. else{
  338. $default_join_table = $form_state['storage']["fields_join_$table_id-$i"];
  339. $default_join_field = $form_state['storage']["fields_join_column_$table_id-$i"];
  340. }
  341. $form['view_setup_table']["fields_join_$table_id-$i"] = array(
  342. '#type' => 'select',
  343. '#prefix' => "<div class=\"fields-column-join\">",
  344. '#suffix' => "</div>",
  345. '#options' => $chado_join_tables,
  346. '#required' => FALSE,
  347. '#default_value' => $default_join_table,
  348. '#ahah' => array(
  349. 'path' => ahah_helper_path(array("view_setup_table","fields_join_column_$table_id-$i")),
  350. 'wrapper' => "fields-column-join-column-$table_id-$i",
  351. 'effect' => 'fade',
  352. 'event' => 'change',
  353. 'method' => 'replace',
  354. ),
  355. );
  356. $columns = array();
  357. if($default_join_table){
  358. $table_desc = module_invoke_all('chado_'.$default_join_table.'_schema');
  359. foreach ($table_desc['fields'] as $column => $def){
  360. $columns[$column] = $column;
  361. }
  362. } else {
  363. $columns = array('Select Join Column');
  364. }
  365. $form['view_setup_table']["fields_join_column_$table_id-$i"] = array(
  366. '#type' => 'select',
  367. '#prefix' => " <div id=\"fields-column-join-column-$table_id-$i\" class=\"fields-column-join-column\">",
  368. '#suffix' => "</div></div>",
  369. '#options' => $columns,
  370. '#required' => FALSE,
  371. '#default_value' => $default_join_field
  372. );
  373. // create the handler fields
  374. $default_field_handler = 0;
  375. if(isset($setup_id) && !isset($form_state['storage']["fields_field_handler_$table_id-$i"])){
  376. $default_field_handler = $default_handlers[$column_name]['field']['handler_name'];
  377. $form_state['storage']["fields_field_handler_$table_id-$i"] = $default_field_handler;
  378. }
  379. else {
  380. $default_field_handler = $form_state['storage']["fields_field_handler_$table_id-$i"];
  381. }
  382. $form['view_setup_table']["fields_field_handler_$table_id-$i"] = array(
  383. '#type' => 'select',
  384. '#prefix' => "<div class=\"column-two\">".
  385. "<div class=\"fields-field-handler\">",
  386. '#suffix' => "</div>",
  387. '#options' => $handlers_fields,
  388. '#required' => FALSE,
  389. '#default_value' => $default_field_handler,
  390. );
  391. $default_filter_handler = 0;
  392. if(isset($setup_id) && !isset($form_state['storage']["fields_filter_handler_$table_id-$i"])){
  393. $default_filter_handler = $default_handlers[$column_name]['filter']['handler_name'];
  394. $form_state['storage']["fields_filter_handler_$table_id-$i"]= $default_filter_handler;
  395. }
  396. else {
  397. $default_filter_handler = $form_state['storage']["fields_filter_handler_$table_id-$i"];
  398. }
  399. $form['view_setup_table']["fields_filter_handler_$table_id-$i"] = array(
  400. '#type' => 'select',
  401. '#prefix' => "<div class=\"fields-filter-handler\">",
  402. '#suffix' => "</div>",
  403. '#options' => $handlers_filters,
  404. '#required' => FALSE,
  405. '#default_value' => $default_filter_handler,
  406. );
  407. $default_sort_handler = 0;
  408. if(isset($setup_id) && !isset($form_state['storage']["fields_sort_handler_$table_id-$i"])){
  409. $default_sort_handler = $default_handlers[$column_name]['sort']['handler_name'];
  410. $form_state['storage']["fields_sort_handler_$table_id-$i"] = $default_sort_handler;
  411. }
  412. else {
  413. $default_sort_handler = $form_state['storage']["fields_sort_handler_$table_id-$i"];
  414. }
  415. $form['view_setup_table']["fields_sort_handler_$table_id-$i"] = array(
  416. '#type' => 'select',
  417. '#prefix' => "<div class=\"fields-sort-handler\">",
  418. '#suffix' => "</div>",
  419. '#options' => $handlers_sort,
  420. '#required' => FALSE,
  421. '#default_value' => $default_sort_handler,
  422. );
  423. $default_argument_handler = 0;
  424. if(isset($setup_id) && !isset($form_state['storage']["fields_argument_handler_$table_id-$i"])){
  425. $default_argument_handler = $default_handlers[$column_name]['argument']['handler_name'];
  426. $form_state['storage']["fields_argument_handler_$table_id-$i"]=$default_argument_handler ;
  427. }
  428. else {
  429. $default_argument_handler = $form_state['storage']["fields_argument_handler_$table_id-$i"];
  430. }
  431. $form['view_setup_table']["fields_argument_handler_$table_id-$i"] = array(
  432. '#type' => 'select',
  433. '#prefix' => "<div class=\"fields-argument-handler\">",
  434. '#suffix' => "</div>",
  435. '#options' => $handlers_argument,
  436. '#required' => FALSE,
  437. '#default_value' => $default_argument_handler,
  438. );
  439. $default_relationship_handler = 0;
  440. if(isset($setup_id) && !isset($form_state['storage']["fields_relationship_handler_$table_id-$i"])){
  441. $default_relationship_handler = $default_handlers[$column_name]['relationship']['handler_name'];
  442. $form_state['storage']["fields_relationship_handler_$table_id-$i"]=$default_relationship_handler;
  443. }
  444. else {
  445. $default_relationship_handler = $form_state['storage']["fields_relationship_handler_$table_id-$i"];
  446. }
  447. $form['view_setup_table']["fields_relationship_handler_$table_id-$i"] = array(
  448. '#type' => 'select',
  449. '#prefix' => "<div class=\"fields-relationship-handler\">",
  450. '#suffix' => "</div>",
  451. '#options' => $handlers_rel,
  452. '#required' => FALSE,
  453. '#default_value' => $default_relationship_handler,
  454. );
  455. $default_join_handler = 0;
  456. if(isset($setup_id) && !isset($form_state['storage']["fields_join_handler_$table_id-$i"])){
  457. $default_join_handler = $default_handlers[$column_name]['join']['handler_name'];
  458. $form_state['storage']["fields_join_handler_$table_id-$i"]=$default_join_handler;
  459. }
  460. else {
  461. $default_join_handler = $form_state['storage']["fields_join_handler_$table_id-$i"];
  462. }
  463. $form['view_setup_table']["fields_join_handler_$table_id-$i"] = array(
  464. '#type' => 'select',
  465. '#prefix' => "<div class=\"fields-join-handler\">",
  466. '#suffix' => "</div></div>",
  467. '#options' => $handlers_join,
  468. '#required' => FALSE,
  469. '#default_value' => $default_join_handler,
  470. );
  471. $form['view_setup_table']["fields_end_$i"] = array(
  472. '#type' => 'markup',
  473. '#value' => "</div></div>",
  474. );
  475. $i++;
  476. }
  477. $form['view_setup_table']['save'] = array(
  478. '#type' => 'submit',
  479. '#value' => t('Save'),
  480. );
  481. $data['row_count'] = $i - 1;
  482. }
  483. //use this to put values into $form_state['values']
  484. $form['data'] = array();
  485. //need to find out if storing $form['data'][$key]['#value'] = $value <- is an issue
  486. //since it will give me errors if i try to stare an array instead of $value
  487. //and yet $value can be an array ie "field_types"
  488. foreach ($data as $key => $value) {
  489. $form['data'][$key] = array(
  490. '#type' => 'hidden',
  491. '#value' => $value,
  492. );
  493. }
  494. $form['#redirect'] = 'admin/tripal/views/integration';
  495. return $form;
  496. }
  497. /**
  498. *
  499. * @ingroup tripal_views_integration
  500. */
  501. function tripal_views_integration_form_validate($form, &$form_state){
  502. $name_array = explode(" ", $form_state['values']['row_name']);
  503. $mview_id = $form_state['values']['mview_id'];
  504. $table_name = $form_state['values']['table_name'];
  505. // if(count($name_array) > 1){
  506. // form_set_error($form_state['values']['row_name'], 'The View type name must be a single word only.');
  507. // }
  508. if($mview_id and $table_name){
  509. form_set_error($form_state['values']['mview_id'], 'Please select either a materialized view or a Chado table but not both');
  510. }
  511. if(!$mview_id and !$table_name){
  512. form_set_error($form_state['values']['mview_id'], 'Please select either a materialized view or a Chado table');
  513. }
  514. // TODO: do we need to require that a handler be set for each field and each type of handler?
  515. }
  516. /**
  517. *
  518. * @ingroup tripal_views_integration
  519. */
  520. function tripal_views_integration_form_submit($form, &$form_state){
  521. $name = $form_state['values']['row_name'];
  522. $mview_id = $form_state['values']['mview_id'];
  523. $table_name = $form_state['values']['table_name'];
  524. $setup_id = $form_state['values']['setup_id'];
  525. if($mview_id){
  526. $table_id = $mview_id;
  527. } else {
  528. $table_id = $table_name;
  529. }
  530. // If this is for a materialized view then we want to add/update that record
  531. $tripal_views_record = array();
  532. if($mview_id){
  533. // get details about this mview
  534. $sql = "SELECT * FROM {tripal_mviews} WHERE mview_id = $mview_id";
  535. $mview = db_fetch_object(db_query($sql));
  536. // build the record for insert/update
  537. $tripal_views_record = array(
  538. 'mview_id' => $mview_id,
  539. 'name' => $name,
  540. 'comment' => $form_state['values']['row_description'],
  541. );
  542. }
  543. // if a chado table then...
  544. if($table_name){
  545. // build the record for insert/update
  546. $tripal_views_record = array(
  547. 'table_name' => $table_name,
  548. 'name' => $name,
  549. 'comment' => $form_state['values']['row_description'],
  550. );
  551. }
  552. // perform the insert or update
  553. if(!$setup_id){ // this is an insert
  554. if(!drupal_write_record('tripal_views', $tripal_views_record)){
  555. drupal_set_message("Failed to add record.");
  556. return;
  557. }
  558. } else { // this is an update
  559. $tripal_views_record['setup_id'] = $setup_id;
  560. if(!drupal_write_record('tripal_views', $tripal_views_record,array('setup_id'))){
  561. drupal_set_message("Failed to update record.");
  562. return;
  563. }
  564. }
  565. // if this is an update then clean out the existing joins and handlers so we can add new ones
  566. if($setup_id){
  567. db_query("DELETE FROM {tripal_views_join} WHERE setup_id = %d",$setup_id);
  568. db_query("DELETE FROM {tripal_views_handlers} WHERE setup_id = %d",$setup_id);
  569. }
  570. // iterate through the columns of the form and add
  571. // the joins if provided, and the handlers
  572. $i = 1;
  573. foreach ($form_state['values']['field_types'] as $key => $value){
  574. // first add the join if it exists
  575. $left_table = $form_state['values']["fields_join_$table_id-$i"];
  576. $left_column = $form_state['values']["fields_join_column_$table_id-$i"];
  577. if($left_column){
  578. $view_join_record = array(
  579. 'setup_id' => $tripal_views_record['setup_id'],
  580. 'base_table' => $mview->mv_table,
  581. 'base_field' => $key,
  582. 'left_table' => $left_table,
  583. 'left_field' => $left_column,
  584. );
  585. // write the new joins to the database
  586. drupal_write_record('tripal_views_join', $view_join_record);
  587. }
  588. // add the hanlders
  589. $handlers = array('filter','field','sort','argument','join','relationship');
  590. foreach($handlers as $handler){
  591. $handler_name = $form_state['values']["fields_".$handler."_handler_$table_id-$i"];
  592. if($handler_name){
  593. $handler_record = array(
  594. 'setup_id' => $tripal_views_record['setup_id'],
  595. 'column_name' => $key,
  596. 'handler_type' => $handler,
  597. 'handler_name' => $handler_name,
  598. );
  599. drupal_write_record('tripal_views_handlers', $handler_record);
  600. }
  601. }
  602. $i++;
  603. }
  604. if($setup_id){
  605. drupal_set_message('Record Updated');
  606. } else {
  607. drupal_set_message('Record Added');
  608. }
  609. // now clear all the caches so that Drupal views picks up our chages
  610. views_invalidate_cache();
  611. }
  612. /**
  613. *
  614. * @ingroup tripal_views_integration
  615. */
  616. function tripal_views_integration_discover_handlers() {
  617. $handlers = array();
  618. // Get handlers from all modules.
  619. foreach (module_implements('views_handlers') as $module) {
  620. $function = $module . '_views_handlers';
  621. $result = $function();
  622. if (!is_array($result)) {
  623. continue;
  624. }
  625. foreach ($result['handlers'] as $handler => $parent){
  626. $handlers[] = $handler;
  627. }
  628. }
  629. // these handlers are hard coded because I could not
  630. // get the views_handlers() function to be called
  631. // in the code above. However, we will be creating
  632. // Chado wrappers for many of these and once that work
  633. // is done these will no longer be needed.
  634. // argument handlers
  635. $handlers[] = 'views_handler_argument';
  636. $handlers[] = 'views_handler_argument_numeric';
  637. $handlers[] = 'views_handler_argument_formula';
  638. $handlers[] = 'views_handler_argument_date';
  639. $handlers[] = 'views_handler_argument_string';
  640. $handlers[] = 'views_handler_argument_many_to_one';
  641. $handlers[] = 'views_handler_argument_null';
  642. // field handlers
  643. $handlers[] = 'views_handler_field';
  644. $handlers[] = 'views_handler_field_date';
  645. $handlers[] = 'views_handler_field_boolean';
  646. $handlers[] = 'views_handler_field_markup';
  647. $handlers[] = 'views_handler_field_xss';
  648. $handlers[] = 'views_handler_field_url';
  649. $handlers[] = 'views_handler_field_file_size';
  650. $handlers[] = 'views_handler_field_prerender_list';
  651. $handlers[] = 'views_handler_field_numeric';
  652. $handlers[] = 'views_handler_field_custom';
  653. $handlers[] = 'views_handler_field_counter';
  654. // filter handlers
  655. $handlers[] = 'views_handler_filter';
  656. $handlers[] = 'views_handler_filter_equality';
  657. $handlers[] = 'views_handler_filter_string';
  658. $handlers[] = 'views_handler_filter_boolean_operator';
  659. $handlers[] = 'views_handler_filter_boolean_operator_string';
  660. $handlers[] = 'views_handler_filter_in_operator';
  661. $handlers[] = 'views_handler_filter_numeric';
  662. $handlers[] = 'views_handler_filter_float';
  663. $handlers[] = 'views_handler_filter_date';
  664. $handlers[] = 'views_handler_filter_many_to_one';
  665. // relationship handlers
  666. $handlers[] = 'views_handler_relationship';
  667. // sort handlers
  668. $handlers[] = 'views_handler_sort';
  669. $handlers[] = 'views_handler_sort_formula';
  670. $handlers[] = 'views_handler_sort_date';
  671. $handlers[] = 'views_handler_sort_menu_hierarchy';
  672. $handlers[] = 'views_handler_sort_random';
  673. return $handlers;
  674. }