remote__data_formatter.inc

File

tripal_ws/includes/TripalFields/remote__data/remote__data_formatter.inc
View source
  1. <?php
  2. class remote__data_formatter extends WebServicesFieldFormatter {
  3. // The default label for this field.
  4. public static $default_label = 'Remote Data';
  5. // The list of field types for which this formatter is appropriate.
  6. public static $field_types = array('remote__data');
  7. // The list of default settings for this formatter.
  8. public static $default_settings = array(
  9. 'setting1' => 'default_value',
  10. );
  11. /**
  12. * Provides the field's setting form.
  13. *
  14. * This function corresponds to the hook_field_formatter_settings_form()
  15. * function of the Drupal Field API.
  16. *
  17. * The settings form appears on the 'Manage Display' page of the content
  18. * type administration page. This function provides the form that will
  19. * appear on that page.
  20. *
  21. * To add a validate function, please create a static function in the
  22. * implementing class, and indicate that this function should be used
  23. * in the form array that is returned by this function.
  24. *
  25. * This form will not be displayed if the formatter_settings_summary()
  26. * function does not return anything.
  27. *
  28. * param $field
  29. * The field structure being configured.
  30. * param $instance
  31. * The instance structure being configured.
  32. * param $view_mode
  33. * The view mode being configured.
  34. * param $form
  35. * The (entire) configuration form array, which will usually have no use
  36. * here. Typically for reference only.
  37. * param $form_state
  38. * The form state of the (entire) configuration form.
  39. *
  40. * @return
  41. * A Drupal Form array containing the settings form for this field.
  42. */
  43. public function settingsForm($view_mode, $form, &$form_state) {
  44. }
  45. /**
  46. * Provides the display for a field
  47. *
  48. * This function corresponds to the hook_field_formatter_view()
  49. * function of the Drupal Field API.
  50. *
  51. * This function provides the display for a field when it is viewed on
  52. * the web page. The content returned by the formatter should only include
  53. * what is present in the $items[$delta]['values] array. This way, the
  54. * contents that are displayed on the page, via webservices and downloaded
  55. * into a CSV file will always be identical. The view need not show all
  56. * of the data in the 'values' array.
  57. *
  58. * @param $element
  59. * @param $entity_type
  60. * @param $entity
  61. * @param $langcode
  62. * @param $items
  63. * @param $display
  64. *
  65. * @return
  66. * An element array compatible with that returned by the
  67. * hook_field_formatter_view() function.
  68. */
  69. public function view(&$element, $entity_type, $entity, $langcode, $items, $display) {
  70. // Get the settings
  71. $settings = $display['settings'];
  72. $field_name = $this->field['field_name'];
  73. // Get any subfields and the header label. Shift the array because the
  74. // results should already be the value of the fisrt entry.
  75. $rd_field_name = $this->instance['settings']['data_info']['rd_field_name'];
  76. $subfields = explode(',', $rd_field_name);
  77. $header_label = $this->getHeaderLabel($subfields);
  78. $flabel = array_shift($subfields);
  79. // Get the site logo if one is provided
  80. $site_logo = $this->instance['settings']['data_info']['site_logo'];
  81. if ($site_logo) {
  82. $site_logo = file_load($site_logo);
  83. }
  84. // Get the site name where the data came from.
  85. $site_id_ws = $this->instance['settings']['data_info']['remote_site'];
  86. $site = db_select('tripal_sites', 'ts')
  87. ->fields('ts', array('name', 'url'))
  88. ->condition('ts.id', $site_id_ws)
  89. ->execute()
  90. ->fetchObject();
  91. $content = '<p>';
  92. if (is_object($site_logo)) {
  93. $content .= '<img class="tripal-remote--data-field-logo" src="' . file_create_url($site_logo->uri) . '"><br/>';
  94. }
  95. $content .= t('This content provided by !site.',
  96. array('!site' => l($site->name, $site->url, array('attributes' => array("target" => '_blank')))));
  97. $content .= '</p>';
  98. $rows = array();
  99. foreach ($items as $index => $item) {
  100. $remote_entity_label = $item['remote_entity']['label'];
  101. $remote_entity_page = $item['remote_entity']['ItemPage'];
  102. $link = t('View !data on %site',
  103. array('!data' => l('this content', $remote_entity_page, array('attributes' => array('target' => '_blank'))),
  104. '%site' => $site->name));
  105. $value = $item['value'];
  106. if (!$value) {
  107. continue;
  108. }
  109. $headers = array('');
  110. // If this is a collection then handle it as a list of members.
  111. if (array_key_exists('members', $value)) {
  112. foreach ($value['members'] as $subvalue) {
  113. $subvalue = $this->refineSubValue($subvalue, $subfields, $header_label);
  114. $rows[] = array($subvalue);
  115. }
  116. }
  117. else {
  118. if (count($subfields) > 0) {
  119. $subvalue = $this->refineSubValue($value, $subfields, $header_label);
  120. $rows[] = array($subvalue);
  121. }
  122. else {
  123. if (array_key_exists($flabel, $value)) {
  124. $rows[] = array(l($value[$flabel], $remote_entity_page, array('attributes' => array('target' => '_blank'))));
  125. }
  126. else {
  127. $value['Link'] = l('View content on ' . $site->name, $remote_entity_page, array('attributes' => array('target' => '_blank')));
  128. $rows[] = array($value);
  129. }
  130. }
  131. }
  132. }
  133. $has_sub_tables = FALSE;
  134. for ($i = 0; $i < count($rows); $i++) {
  135. if (is_array($rows[$i][0])) {
  136. $rows[$i][0] = $this->createTable($rows[$i]);
  137. $has_sub_tables = TRUE;
  138. }
  139. }
  140. // If we don't have tables for each row then we'll put everything into
  141. // a table.
  142. if (!$has_sub_tables) {
  143. $headers = array($header_label . '(s)');
  144. $content .= theme_table(array(
  145. 'header' => $headers,
  146. 'rows' => $rows,
  147. 'attributes' => array(
  148. 'class' => 'tripal-remote--data-field-table',
  149. ),
  150. 'sticky' => FALSE,
  151. 'caption' => "",
  152. 'colgroups' => array(),
  153. 'empty' => 'There are no results.',
  154. ));
  155. }
  156. else {
  157. for ($i = 0; $i < count($rows); $i++) {
  158. if (count($rows) > 1) {
  159. $content .= '<span class="tripal-remote--data-field-table-label">' . $header_label . ' ' . ($i + 1) . '</span>';
  160. }
  161. $content .= $rows[$i][0];
  162. }
  163. }
  164. // Return the content for this field.
  165. $element[0] = array(
  166. '#type' => 'markup',
  167. '#markup' => '<div class="tripal-remote--data-field">' . $content . '</div>',
  168. );
  169. }
  170. /**
  171. * Retrieves the header label given the subfields criteria.
  172. *
  173. * @param $subfields
  174. * An array of the sequence of subfields.
  175. */
  176. private function getHeaderLabel($subfields) {
  177. $subfield = array_shift($subfields);
  178. $header_label = ucwords(preg_replace('/_/', ' ', $subfield));
  179. if (count($subfields) > 0) {
  180. $header_label .= ' ' . $this->getHeaderLabel($subfields);
  181. }
  182. return $header_label;
  183. }
  184. /**
  185. * Adjusts the items array to contain only the section/subsection desired.
  186. *
  187. * The field settings can indicate a field with sub fields that should
  188. * be displayed (e.g. organism,genus or relationship,clause). We want
  189. * to adjust the item to only include what the user requested.
  190. *
  191. * @param $values
  192. * @param $subfields
  193. */
  194. private function refineSubValue($values, $subfields) {
  195. // Remove unwanted elements.
  196. unset($values['@id']);
  197. unset($values['@context']);
  198. unset($values['@type']);
  199. unset($values['remote_entity']);
  200. $subfield = array_shift($subfields);
  201. if (array_key_exists($subfield, $values)) {
  202. if (is_array($values[$subfield]) and count($subfields) > 0) {
  203. return $this->refineSubvalue($values[$subfield], $subfields);
  204. }
  205. else {
  206. return $values[$subfield];
  207. }
  208. }
  209. else {
  210. return $values;
  211. }
  212. }
  213. /**
  214. * A recursive function for displaying an item in a table.
  215. *
  216. * @param $item
  217. * An item from the $items array passed to the view() function.
  218. * @return
  219. * An HTML formatted Table.
  220. */
  221. private function createTable($item, &$pkey = '', &$rows = array(), $depth = 0) {
  222. foreach ($item as $key => $value) {
  223. // Skip JSON-LD keys.
  224. if (preg_match('/^\@/', $key)) {
  225. continue;
  226. }
  227. $key = preg_replace('/_/', ' ', $key);
  228. $key = ucwords($key);
  229. if ($pkey) {
  230. $key = $pkey . ' ' . $key;
  231. }
  232. if (is_array($value)) {
  233. $this->createTable($value, $key, $rows, $depth + 1);
  234. }
  235. else {
  236. $rows[] = array(
  237. 'data'=> array(
  238. $key,
  239. $value
  240. ),
  241. 'no_striping' => TRUE,
  242. );
  243. }
  244. }
  245. if ($depth == 0) {
  246. $headers = array('Data Type', 'Value');
  247. return theme_table(array(
  248. 'header' => $headers,
  249. 'rows' => $rows,
  250. 'attributes' => array(
  251. 'class' => 'tripal-remote--data-field-table',
  252. ),
  253. 'sticky' => FALSE,
  254. 'caption' => "",
  255. 'colgroups' => array(),
  256. 'empty' => 'There are no results.',
  257. ));
  258. }
  259. }
  260. /**
  261. * A recursive function for creating an HTML dictionary list from
  262. * the results for the item provided.
  263. *
  264. * @param $item
  265. * An item from the $items array passed to the view() function.
  266. * @return
  267. * An HTML formatted DL.
  268. */
  269. private function createDL($item, &$pkey = '', &$content= '', $depth = 0) {
  270. if ($depth == 0) {
  271. $content = '<dl class="tripal-remote--data-field-dl">';
  272. }
  273. foreach ($item as $key => $value) {
  274. // Skip JSON-LD keys.
  275. if (preg_match('/^\@/', $key)) {
  276. continue;
  277. }
  278. $key = preg_replace('/_/', ' ', $key);
  279. $key = ucwords($key);
  280. if ($pkey) {
  281. $key = $pkey . ' ' . $key;
  282. }
  283. if (is_array($value)) {
  284. $this->createDL($value, $key, $content, $depth + 1);
  285. }
  286. else {
  287. $content .= '<dt>' . $key . '&nbsp;:&nbsp;</dt><dd>' . $value . '</dd>';
  288. }
  289. }
  290. if ($depth == 0) {
  291. $content .= '</dl>';
  292. return $content;
  293. }
  294. }
  295. /**
  296. * A recursive function for creating an HTML dictionary list from
  297. * the results for the item provided.
  298. *
  299. * @param $item
  300. * An item from the $items array passed to the view() function.
  301. * @return
  302. * An HTML formatted DL.
  303. */
  304. private function createNestedDL($item) {
  305. $content = '<dl>';
  306. foreach ($item as $key => $value) {
  307. // Skip JSON-LD keys.
  308. if (preg_match('/^\@/', $key)) {
  309. continue;
  310. }
  311. $key = preg_replace('/_/', ' ', $key);
  312. $key = ucwords($key);
  313. if (is_array($value)) {
  314. $value = $this->createDL($value);
  315. }
  316. $content .= '<dt>' . $key . '</dt><dd>' . $value . '</dd>';
  317. }
  318. $content .= '</dl>';
  319. return $content;
  320. }
  321. /**
  322. * Provides a summary of the formatter settings.
  323. *
  324. * This function corresponds to the hook_field_formatter_settings_summary()
  325. * function of the Drupal Field API.
  326. *
  327. * On the 'Manage Display' page of the content type administration page,
  328. * fields are allowed to provide a settings form. This settings form can
  329. * be used to allow the site admin to define how the field should be
  330. * formatted. The settings are then available for the formatter()
  331. * function of this class. This function provides a text-based description
  332. * of the settings for the site developer to see. It appears on the manage
  333. * display page inline with the field. A field must always return a
  334. * value in this function if the settings form gear button is to appear.
  335. *
  336. * See the hook_field_formatter_settings_summary() function for more
  337. * information.
  338. *
  339. * @param $field
  340. * @param $instance
  341. * @param $view_mode
  342. *
  343. * @return string
  344. * A string that provides a very brief summary of the field settings
  345. * to the user.
  346. *
  347. */
  348. public function settingsSummary($view_mode) {
  349. }
  350. }