'default_value',
);
/**
* Provides the field's setting form.
*
* This function corresponds to the hook_field_formatter_settings_form()
* function of the Drupal Field API.
*
* The settings form appears on the 'Manage Display' page of the content
* type administration page. This function provides the form that will
* appear on that page.
*
* To add a validate function, please create a static function in the
* implementing class, and indicate that this function should be used
* in the form array that is returned by this function.
*
* This form will not be displayed if the formatter_settings_summary()
* function does not return anything.
*
* param $field
* The field structure being configured.
* param $instance
* The instance structure being configured.
* param $view_mode
* The view mode being configured.
* param $form
* The (entire) configuration form array, which will usually have no use
* here. Typically for reference only.
* param $form_state
* The form state of the (entire) configuration form.
*
* @return
* A Drupal Form array containing the settings form for this field.
*/
public function settingsForm($view_mode, $form, &$form_state) {
}
/**
* Provides the display for a field
*
* This function corresponds to the hook_field_formatter_view()
* function of the Drupal Field API.
*
* This function provides the display for a field when it is viewed on
* the web page. The content returned by the formatter should only include
* what is present in the $items[$delta]['values] array. This way, the
* contents that are displayed on the page, via webservices and downloaded
* into a CSV file will always be identical. The view need not show all
* of the data in the 'values' array.
*
* @param $element
* @param $entity_type
* @param $entity
* @param $langcode
* @param $items
* @param $display
*
* @return
* An element array compatible with that returned by the
* hook_field_formatter_view() function.
*/
public function view(&$element, $entity_type, $entity, $langcode, $items, $display) {
// Get the settings
$settings = $display['settings'];
$field_name = $this->field['field_name'];
// Get any subfields and the header label. Shift the array because the
// results should already be the value of the fisrt entry.
$rd_field_name = $this->instance['settings']['data_info']['rd_field_name'];
$subfields = explode(',', $rd_field_name);
$header_label = $this->getHeaderLabel($subfields);
$flabel = array_shift($subfields);
// Get the site logo if one is provided
$site_logo = $this->instance['settings']['data_info']['site_logo'];
if ($site_logo) {
$site_logo = file_load($site_logo);
}
// Get the site name where the data came from.
$site_id_ws = $this->instance['settings']['data_info']['remote_site'];
$site = db_select('tripal_sites', 'ts')
->fields('ts', array('name', 'url'))
->condition('ts.id', $site_id_ws)
->execute()
->fetchObject();
$content = '
';
if (is_object($site_logo)) {
$content .= '
';
}
$content .= t('This content provided by !site.',
array('!site' => l($site->name, $site->url, array('attributes' => array("target" => '_blank')))));
$content .= '
';
$rows = array();
foreach ($items as $index => $item) {
$remote_entity_label = $item['remote_entity']['label'];
$remote_entity_page = $item['remote_entity']['ItemPage'];
$link = t('View !data on %site',
array('!data' => l('this content', $remote_entity_page, array('attributes' => array('target' => '_blank'))),
'%site' => $site->name));
$value = $item['value'];
if (!$value) {
continue;
}
$headers = array('');
// If this is a collection then handle it as a list of members.
if (array_key_exists('members', $value)) {
foreach ($value['members'] as $subvalue) {
$subvalue = $this->refineSubValue($subvalue, $subfields, $header_label);
$rows[] = array($subvalue);
}
}
else {
if (count($subfields) > 0) {
$subvalue = $this->refineSubValue($value, $subfields, $header_label);
$rows[] = array($subvalue);
}
else {
if (array_key_exists($flabel, $value)) {
$rows[] = array(l($value[$flabel], $remote_entity_page, array('attributes' => array('target' => '_blank'))));
}
else {
$value['Link'] = l('View content on ' . $site->name, $remote_entity_page, array('attributes' => array('target' => '_blank')));
$rows[] = array($value);
}
}
}
}
$has_sub_tables = FALSE;
for ($i = 0; $i < count($rows); $i++) {
if (is_array($rows[$i][0])) {
$rows[$i][0] = $this->createTable($rows[$i]);
$has_sub_tables = TRUE;
}
}
// If we don't have tables for each row then we'll put everything into
// a table.
if (!$has_sub_tables) {
$headers = array($header_label . '(s)');
$content .= theme_table(array(
'header' => $headers,
'rows' => $rows,
'attributes' => array(
'class' => 'tripal-remote--data-field-table',
),
'sticky' => FALSE,
'caption' => "",
'colgroups' => array(),
'empty' => 'There are no results.',
));
}
else {
for ($i = 0; $i < count($rows); $i++) {
if (count($rows) > 1) {
$content .= '' . $header_label . ' ' . ($i + 1) . '';
}
$content .= $rows[$i][0];
}
}
// Return the content for this field.
$element[0] = array(
'#type' => 'markup',
'#markup' => '' . $content . '
',
);
}
/**
* Retrieves the header label given the subfields criteria.
*
* @param $subfields
* An array of the sequence of subfields.
*/
private function getHeaderLabel($subfields) {
$subfield = array_shift($subfields);
$header_label = ucwords(preg_replace('/_/', ' ', $subfield));
if (count($subfields) > 0) {
$header_label .= ' ' . $this->getHeaderLabel($subfields);
}
return $header_label;
}
/**
* Adjusts the items array to contain only the section/subsection desired.
*
* The field settings can indicate a field with sub fields that should
* be displayed (e.g. organism,genus or relationship,clause). We want
* to adjust the item to only include what the user requested.
*
* @param $values
* @param $subfields
*/
private function refineSubValue($values, $subfields) {
// Remove unwanted elements.
unset($values['@id']);
unset($values['@context']);
unset($values['@type']);
unset($values['remote_entity']);
$subfield = array_shift($subfields);
if (array_key_exists($subfield, $values)) {
if (is_array($values[$subfield]) and count($subfields) > 0) {
return $this->refineSubvalue($values[$subfield], $subfields);
}
else {
return $values[$subfield];
}
}
else {
return $values;
}
}
/**
* A recursive function for displaying an item in a table.
*
* @param $item
* An item from the $items array passed to the view() function.
* @return
* An HTML formatted Table.
*/
private function createTable($item, &$pkey = '', &$rows = array(), $depth = 0) {
foreach ($item as $key => $value) {
// Skip JSON-LD keys.
if (preg_match('/^\@/', $key)) {
continue;
}
$key = preg_replace('/_/', ' ', $key);
$key = ucwords($key);
if ($pkey) {
$key = $pkey . ' ' . $key;
}
if (is_array($value)) {
$this->createTable($value, $key, $rows, $depth + 1);
}
else {
$rows[] = array(
'data'=> array(
$key,
$value
),
'no_striping' => TRUE,
);
}
}
if ($depth == 0) {
$headers = array('Data Type', 'Value');
return theme_table(array(
'header' => $headers,
'rows' => $rows,
'attributes' => array(
'class' => 'tripal-remote--data-field-table',
),
'sticky' => FALSE,
'caption' => "",
'colgroups' => array(),
'empty' => 'There are no results.',
));
}
}
/**
* A recursive function for creating an HTML dictionary list from
* the results for the item provided.
*
* @param $item
* An item from the $items array passed to the view() function.
* @return
* An HTML formatted DL.
*/
private function createDL($item, &$pkey = '', &$content= '', $depth = 0) {
if ($depth == 0) {
$content = '';
}
foreach ($item as $key => $value) {
// Skip JSON-LD keys.
if (preg_match('/^\@/', $key)) {
continue;
}
$key = preg_replace('/_/', ' ', $key);
$key = ucwords($key);
if ($pkey) {
$key = $pkey . ' ' . $key;
}
if (is_array($value)) {
$this->createDL($value, $key, $content, $depth + 1);
}
else {
$content .= '- ' . $key . ' :
- ' . $value . '
';
}
}
if ($depth == 0) {
$content .= '
';
return $content;
}
}
/**
* A recursive function for creating an HTML dictionary list from
* the results for the item provided.
*
* @param $item
* An item from the $items array passed to the view() function.
* @return
* An HTML formatted DL.
*/
private function createNestedDL($item) {
$content = '';
foreach ($item as $key => $value) {
// Skip JSON-LD keys.
if (preg_match('/^\@/', $key)) {
continue;
}
$key = preg_replace('/_/', ' ', $key);
$key = ucwords($key);
if (is_array($value)) {
$value = $this->createDL($value);
}
$content .= '- ' . $key . '
- ' . $value . '
';
}
$content .= '
';
return $content;
}
/**
* Provides a summary of the formatter settings.
*
* This function corresponds to the hook_field_formatter_settings_summary()
* function of the Drupal Field API.
*
* On the 'Manage Display' page of the content type administration page,
* fields are allowed to provide a settings form. This settings form can
* be used to allow the site admin to define how the field should be
* formatted. The settings are then available for the formatter()
* function of this class. This function provides a text-based description
* of the settings for the site developer to see. It appears on the manage
* display page inline with the field. A field must always return a
* value in this function if the settings form gear button is to appear.
*
* See the hook_field_formatter_settings_summary() function for more
* information.
*
* @param $field
* @param $instance
* @param $view_mode
*
* @return string
* A string that provides a very brief summary of the field settings
* to the user.
*
*/
public function settingsSummary($view_mode) {
}
}