EDIT

<?php

/**

 * @file

 * footnote functions.

 *

 * @copyright

 *   (C) 2007-2020 EDIT

 *   European Distributed Institute of Taxonomy

 *   http://www.e-taxonomy.eu

 *

 *   The contents of this module are subject to the Mozilla

 *   Public License Version 1.1.

 * @see http://www.mozilla.org/MPL/MPL-1.1.html

 *

 * @author

 *   - Andreas Kohlbecker <a.kohlbecker@BGBM.org>

 */

/**

 * Creates the footnotes for the given CDM instance.

 *

 * Footnotes are created for annotations and original sources whereas the resulting footnote keys depend on the

 * parameters $footnote_list_key_suggestion and $is_bibliography_aware, see parameter $footnote_list_key_suggestion

 * for more details.

 *

 * possible keys for

 *     - annotation footnotes:

 *       - $footnote_list_key_suggestion

 *       - "BIBLIOGRAPHY" (when !$is_bibliography_aware && bibliography_settings['enabled'] == 1 )

 *       - "BIBLIOGRAPHY-$footnote_list_key_suggestion" (when !$is_bibliography_aware && bibliography_settings['enabled'] == 0 )

 *       - $footnote_list_key_suggestion (when $is_bibliography_aware)

 *

 *   A CDM entity

 *   Optional parameter. The separator string to concatenate the footnote ids, default is ','

 * @param $footnote_list_key_suggestion string

 *    Optional parameter. If this parameter is left empty (null, 0, "") the footnote key will be determined by the nested

 *    method calls by calling RenderHints::getFootnoteListKey(). NOTE: the footnote key for annotations will be set to

 *    RenderHints::getFootnoteListKey().'-annotations'.

 *    $is_bibliography_aware is set TRUE.

 *    Create a link to the reference pages for sources when TRUE.

 * @param bool $do_link_to_name_used_in_source

 *    Create a link to the name pages for name in source when TRUE.

 * @param bool $is_bibliography_aware

 *    Put source references into the bibliography when this param is TRUE.

 *    by bibliography_footnote_list_key() when

 *    $is_bibliography_aware is set TRUE.

  $footnote_list_key_suggestion = null,

  $do_link_to_reference = FALSE,

  $do_link_to_name_used_in_source = FALSE,

  $is_bibliography_aware = FALSE

){

  // Annotations as footnotes.

  // Source references as footnotes.

  if($is_bibliography_aware){

    $bibliography_settings = get_bibliography_settings();

    $sources_footnote_list_key = bibliography_footnote_list_key($footnote_list_key_suggestion);

    $original_source_footnote_tag = $bibliography_settings['enabled'] == 1 ? 'div' : null; // null will cause bibliography_footnote_list_key to use the default

  } else {

    $sources_footnote_list_key = $footnote_list_key_suggestion;

    if(!$sources_footnote_list_key) {

      RenderHints::getFootnoteListKey();

    }

    $original_source_footnote_tag = NULL;

  }

  foreach ($sources as $source) {

    if (_is_original_source_type($source)) {

      $fn_key = FootnoteManager::addNewFootnote(

        $sources_footnote_list_key,

        render_original_source(

          $source,

          $do_link_to_reference,

          $do_link_to_name_used_in_source

        ),

        $original_source_footnote_tag

      );

      // Ensure uniqueness of the footnote keys.

        $footnote_keys[] = $fn_key;

      }

  }

  // Sort and render footnote keys.

  asort($footnote_keys);

/**

 * Fetches the list of visible annotations for each of the cdm entities and returns the footnote keys for them.

 *

 * The footnotes are passed to the FootnoteManager in order to store the annotations and to create the footnote keys.

 *

 * @see cdm_fetch_visible_annotations()

 *

 * @param array $cdm_entities

 *   An array of CdmBase instances.

 * @param $footnote_list_key_suggestion string

 *    optional parameter. If this parameter is left empty (null, 0, "") the footnote key will be determined be set to

 * @return array of footnote keys

 * @deprecated unused, needs to be removed

  $foot_note_keys = [];

  foreach ($cdm_entities as $cdm_entity) {

  return $foot_note_keys;

}

/**

 * Fetches the list of visible annotations for the cdm entity or for the comparable

 * object and returns the footnote keys.

 *

 * The footnotes are passed to the FootnoteManager in order to store the

 * annotations and to create the footnote keys.

 * @param stdClass $cdm_entity

 *   A single CdmBase instance ore comparable object.

 * @param $footnote_list_key_suggestion string

 *    optional parameter. If this parameter is left empty (null, 0, "") the footnote key will be determined be set to

 *    RenderHints::getFootnoteListKey().'-annotations' otherwise the supplied key will be used.

 * @return array of footnote keys

 *

 * @see cdm_fetch_visible_annotations()

 */

  $foot_note_keys = [];

    $footnote_list_key = $footnote_list_key_suggestion;

  } else {

  // Adding the footnotes keys.

  $annotations = cdm_fetch_visible_annotations($cdm_entity);

  if (is_array($annotations)) {

    foreach ($annotations as $annotation) {

      $foot_note_keys[] = FootnoteManager::addNewFootnote($footnote_list_key, $annotation->text);

    }

  }

  return $foot_note_keys;

}

 * Created and registers footnotes in the FootnoteManager and returns the

 * footnote keys as markup.

 *

 * The following cdm cdm classes are annotatable:

 *

 * - DescriptionElementBase

 * - EventBase

 * - HomotypicalGroup

 * - IdentifiableEntity

 * - DescriptionBase

 * - IdentifiableMediaEntity

 * - Media

 * - Sequence

 * - TaxonBase

 * - TaxonName

 * - TaxonomicTree

 * - TermBase

 * - LanguageStringBase

 * - ReferencedEntityBase

 * - NomenclaturalStatus

 * - OriginalSourceBase

 * - RelationshipBase

 * - TypeDesignationBase

 * - TaxonNode

 * - WorkingSet

 *

 * @param array $cdm_entities

 *   An array of CdmBase instances.

 * @param $footnote_list_key_suggestion string

 *    optional parameter. If this parameter is left empty (null, 0, "") the

 *   footnote key will be determined be set to

 *   RenderHints::getFootnoteListKey().FOOTNOTE_KEY_SUFFIX_ANNOTATIONS otherwise the supplied

 *   key will be used.

 *

 * @return string

 *   The markup.

function render_entities_annotations_as_footnote_keys(array $cdm_entities, $footnote_list_key =null){

  // check if footnotes for annotations are disabled completely

  if (variable_get('cdm_dataportal_annotations_footnotes', CDM_DATAPORTAL_ALL_FOOTNOTES)) {

    return '';

  }

  $markup = '';

  $footNoteKeys = cdm_entities_annotations_footnote_keys($cdm_entities, $footnote_list_key);

  foreach ($footNoteKeys as $a) {

    $markup .= render_footnote_key($a, ($markup ? ',' : ''));

  }

  return $markup;

}

 * Creates markup for an array of foot note keys

 *

 * @param array $footnote_keys

 * @param string $separator

 *

 * @return string

 */

  $footnotes_markup = '';

  foreach ($footnote_keys as $foot_note_key) {

    try {

      drupal_set_message("Exception: " . $e->getMessage(), 'error');

    }

  }

  return $footnotes_markup;

}

/**

 * Create markup for the footnotes mapped to the $footnoteListKey.

 *

 * @param null $footnote_list_key

 *  The footnote list key, see RenderHints::getFootnoteListKey()

 * @param $element_tag

 *  The tag for the footnote element

 *

 * @return string

 */

    return '';

  }

/**

 * Creates markup for a foot note key

 *

 * @param null $footnoteKey

 * @param string $separator

 * @param bool $separator_off

 *

 * @return string

 *   The footnote key markup

 */

  if (!is_object($footnoteKey) or !isset($footnoteKey->footnoteListKey)) {

    return '';

  }

  if (variable_get('cdm_dataportal_all_footnotes', CDM_DATAPORTAL_ALL_FOOTNOTES)) {

    return '';

  }

  if ($separator_off) {

    $separator = '';

  }

  $out = '<span class="footnote-key footnote-key-' . $footnoteKey->keyStr . ' member-of-footnotes-' . $footnoteKey->footnoteListKey . '">'

    . $separator . '<a href="#footnote-' . $footnoteKey->keyStr . '">' . $footnoteKey->keyStr . '</a>' . '</span>';

  return $out;

}

/**

 * @param null $footnoteKey

 * @param null $footnoteText

 * @param string $enclosing_tag

 *   default is 'span'

 *

 * @return string

 */

  if($enclosing_tag == null){

    $enclosing_tag = 'span';

  }

  return '<' . $enclosing_tag . ' class="footnote footnote-' . $footnoteKey . '">'

    . '<a name="footnote-' . $footnoteKey . '"></a>'

    . '<span class="footnote-anchor">' . $footnoteKey . '.</span>&nbsp;' . $footnoteText

    . '</' . $enclosing_tag . '>';

}

/**

 * Create markup for the footnotes mapped to the $footnoteListKey.

 *

 * @param null $footnote_list_key

 *  The footnote list key, see RenderHints::getFootnoteListKey()

 * @param $element_tag

 *  The tag for the footnote element

 *

 * @return string

  if (variable_get('cdm_dataportal_all_footnotes', CDM_DATAPORTAL_ALL_FOOTNOTES)) {

    return '';

  }

  $out = '<' . $element_tag . ' class="footnotes footnotes-' . $footnote_list_key . ' ">'

    . FootnoteManager::renderFootnoteList($footnote_list_key)

    . '</' . $element_tag . '>';

  FootnoteManager::removeFootnoteList($footnote_list_key);

  return $out;

}

/**

 * Renders the footnotes for annotations and sources, etc.

 *

 * @param string $footnote_list_key

 *    RenderHints::getFootnoteListKey() will be used if this parameter is undefined.

 * @param string $enclosingTag

 *    Default tag is 'span'

 *

 * @return string

 *    The markup string

  if (variable_get('cdm_dataportal_all_footnotes', CDM_DATAPORTAL_ALL_FOOTNOTES)) {

    return '';

  }

  if(!$footnote_list_key){

    $footnote_list_key = RenderHints::getFootnoteListKey();

  }

  $out = '<' . $enclosingTag . ' class="footnotes footnotes-' . $footnote_list_key . ' ">'

  return $out;

}