EDIT

  if(isset($registration_dto->nameRef) && $registration_dto->nameRef){

      $office_class_attribute = registration_institution_class_attribute($registration);

function registration_institution_class_attribute($registration_dto)

/**

 * Creates markup for a list of SpecimenTypedesignationDTO

 *

 * @param array $specimen_typedesignation_dtos

 *  The SpecimenTypedesignationDTOs to be rendered

 *

 * @return string

 *   The markup.

 */

function render_specimen_typedesignation_dto($specimen_typedesignation_dtos,  $enclosing_tag = 'ul', $element_tag =  'li', $link_to_specimen_page = true){

  // need to add element to render path since type designations

  // need other name render template

  RenderHints::pushToRenderStack('typedesignations');

  $out = '<' . $enclosing_tag .' class="typeDesignations">';

  $separator = ',';

  if (!empty($specimen_typedesignation_dtos)) {

    // usort($specimen_type_designations, "compare_specimen_type_designation"); // FIXME create compare function for SpecimenTypedesignationDTO

    foreach ($specimen_typedesignation_dtos as $std_dto) {

      $type_citation_markup = '';

      if (!empty($std_dto->source->citation)) {

        $citation_footnote_str = cdm_reference_markup($std_dto->source->citation, null, false, true);

        $author_team = cdm_ws_get(CDM_WS_REFERENCE_AUTHORTEAM, $std_dto->source->citation->uuid);

        if (!empty($author_team->titleCache)) {

          $year = @timePeriodToString($std_dto->source->citation->datePublished, true, 'YYYY');

          $authorteam_str = $author_team->titleCache . ($year ? ' ' : '') . $year;

          if ($authorteam_str == $std_dto->source->citation->titleCache) {

            $citation_footnote_str = '';

          }

        } else {

          $authorteam_str = $citation_footnote_str;

          // no need for a footnote in case in case it is used as replacement for missing author teams

          $citation_footnote_str = '';

        }

        // for being registered a typedesignation MUST HAVE a citation, so it is save to handle the

        // Registration output in the conditional block which has been checked that the citation is present

        $registration_markup = render_registrations($std_dto->registrations);

        $citation_footnote_str .= ($citation_footnote_str ? ' ' : '') . $registration_markup;

        $footnote_key_markup = '';

        if ($citation_footnote_str) {

          // footnotes should be rendered in the parent element so we

          // are relying on the FootnoteListKey set there

          $_fkey2 = FootnoteManager::addNewFootnote(RenderHints::getFootnoteListKey(), $citation_footnote_str);

          $footnote_key_markup = render_footnote_key($_fkey2, $separator, TRUE);

        }

        $type_citation_markup .= '&nbsp;(' . t('designated by') . '&nbsp;<span class="typeReference">' . $authorteam_str . '</span>';

        if (!empty($std_dto->source->citationMicroReference)) {

          $type_citation_markup .= ': ' . trim($std_dto->source->citationMicroReference);

        }

        $type_citation_markup .= $footnote_key_markup . ')';

      }

      $out .= '<'. $element_tag .' class="' . html_class_attribute_ref($std_dto) . '">';

      $out .= type_designation_dto_status_label_markup($std_dto) . $type_citation_markup;

      $derivedUnitFacadeInstance = null;

      if (isset($std_dto->typeSpecimen)) {

        $derivedUnitFacadeInstance = cdm_ws_get(CDM_WS_DERIVEDUNIT_FACADE, $std_dto->typeSpecimen->uuid);

      }

      if (!empty($derivedUnitFacadeInstance->titleCache)) {

        $specimen_markup = $derivedUnitFacadeInstance->titleCache;

        if($link_to_specimen_page && isset($derivedUnitFacadeInstance->specimenLabel) && $derivedUnitFacadeInstance->specimenLabel){

          $specimen_markup = str_replace($derivedUnitFacadeInstance->specimenLabel, l($derivedUnitFacadeInstance->specimenLabel, path_to_specimen($std_dto->typeSpecimen->uuid)), $specimen_markup);

        }

        RenderHints::setAnnotationsAndSourceConfig(annotations_and_sources_config_typedesignations());

        $annotations_and_sources = handle_annotations_and_sources($derivedUnitFacadeInstance);

        $out .= ': <span class="' . html_class_attribute_ref($std_dto->typeSpecimen) . '">'

          . $specimen_markup

          . '</span>'; // . ': ' . theme('cdm_specimen', array('specimenTypeDesignation' => $derivedUnitFacadeInstance));

        if(!empty($derivedUnitFacadeInstance->preferredStableUri)){

          $out .= ' ' . l($derivedUnitFacadeInstance->preferredStableUri, $derivedUnitFacadeInstance->preferredStableUri, array('absolute' => true));

        }

        $out .= $annotations_and_sources->footNoteKeysMarkup();

      }

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

    }

  }

  return $out;

}

 *    The CDM TypeDesignation entities

/**

 * Creates markup for the status of a type designation DTO.

 * In case the status or its representation is missing the label will be set to "Type"

 *

 * @param $type_designation

 * @return string

 */

function type_designation_dto_status_label_markup($type_designation)

{

  return '<span class="type-status">'

    . ((isset($type_designation->typeStatus_L10n)) ? ucfirst($type_designation->typeStatus_L10n) : t('Type')) . '</span>'

    ;

}

                if (isset($typeDesignation->typeStatus_L10n)) {

                    $type_status[] = $typeDesignation->typeStatus_L10n;

 * Creates render array items for FieldUnitDTO or DerivateDTO.

 * @return array

 *    An array which can be used in render arrays to be passed to the

 * theme_table() and theme_list().

 * Renders a FieldUnitDTO or DerivateDTO

 * @param object $specimen_or_observation_dto

 *   A FieldUnitDTO or DerivateDTO object

 * @return string

 *   the supplied render array $derivatives to which the composition of the

 *   supplied

 *

 * @throws \Exception

function compose_cdm_specimen_or_observation_tree_entry($specimen_or_observation_dto) {

    if (is_object($specimen_or_observation_dto)) {

        $type_label = $specimen_or_observation_dto->recordBase;

        RenderHints::setFootnoteListKey($type_label . '-' . $specimen_or_observation_dto->uuid);

        if (isset($specimen_or_observation_dto->specimenTypeDesignations)) {

            foreach ($specimen_or_observation_dto->specimenTypeDesignations as $typeDesignation) {

                if (isset($typeDesignation->typeStatus_L10n)) {

                    $type_status[] = $typeDesignation->typeStatus_L10n;

        foreach (get_object_vars($specimen_or_observation_dto) as $field => $value) {

                                '#markup' => render_specimen_typedesignation_dto($value),

                            'galleryName' => $specimen_or_observation_dto->uuid,

            '#attributes' => array('class' => html_class_attribute_ref($specimen_or_observation_dto)),

        $pathToSpecimen = path_to_specimen($specimen_or_observation_dto->uuid);

 * @param array $specimens_or_observations

 *  Array of SpecimenOrObservation or fieldUnitDTOs

function order_specimens_or_observations_by_date_and_type($specimens_or_observations)

  if(is_array($specimens_or_observations)){

    foreach ($specimens_or_observations as &$occurrence) {

      $typeDesignationsPager = cdm_ws_get(CDM_WS_OCCURRENCE . '/$0/specimenTypeDesignations', $occurrence->uuid);

      if (isset($typeDesignationsPager->count) && $typeDesignationsPager->count > 0) {

        $type_specimens[] = $occurrence;

      } else {

        $other_occurrences[] = $occurrence;

      }

  $specimens_or_observations = array_merge($type_specimens, $other_occurrences);

  return $specimens_or_observations;

 * @param array $fieldUnitDTOs

  $fieldUnitDTOs = null;

  $specimensOrObservations = array();

  $current_view_mode = variable_get(CDM_SPECIMEN_LIST_VIEW_MODE, CDM_SPECIMEN_LIST_VIEW_MODE_DEFAULT);

  if ($current_view_mode == CDM_SPECIMEN_LIST_VIEW_MODE_OPTION_DERIVATE_TABLE || $current_view_mode == CDM_SPECIMEN_LIST_VIEW_MODE_OPTION_DERIVATE_TREE){

    if(($current_view_mode == CDM_SPECIMEN_LIST_VIEW_MODE_OPTION_DERIVATE_TABLE)){

    else if(($current_view_mode == CDM_SPECIMEN_LIST_VIEW_MODE_OPTION_DERIVATE_TREE)){ // FIXME this seems to be wrong

 *   @param reference

 *      The entity to be rendered

 *  @param string $microReference

 *      The citation detail like page number

 *  @param boolean doTextLink

 *  @param boolean doIconLink

/**

 * Creates a HTML representations for a CDM ReferenceDTO object

 *

 * In terms of rendering the entity and dto are interchangeable,

 * therefore this method simply delegates to the according entity method.

 *

 *  @param $reference_dto

 *      The dto to be rendered

 *  @param string $microReference

 *      The citation detail like page number

 *  @param boolean doTextLink

 *      Show the citation string as link to the reference page. This option does not affect links to the reference URI or DOI.

 *      These links are always created when this data is available

 *  @param boolean doIconLink

 *      Append an icon to the citation string which links to the reference page, links to the reference URI or DOI are always

 *      created when this data is available

 *

 * @return string

 *    the markup for the referenceDTO

 *

 */

function cdm_reference_dto_markup($reference_dto, $microReference = NULL, $doTextLink = FALSE, $doIconLink = FALSE) {

  return cdm_reference_markup($reference_dto, $microReference, $doTextLink, $doIconLink);

}

        // -------------------------------------------------------------------------------------------

        // Germany, Berlin, alt. 165 m, 52°31'1.2"N, 13°21'E (WGS84), 28 Mar 2016, Ehrenberg D047.

        assertEquals("Ehrenberg, C.G.", dl1.joinedDescriptionElementText("Collector:"));

        // -------------------------------------------------------------------------------------------

        // Germany, Berlin, alt. 165 m, 52°31'1.2"N, 13°21'E (WGS84), 28 Mar 2016, Ehrenberg D047.