Skip to content
Snippets Groups Projects
Select Git revision
  • e1469e00f8dbc09facecb4dba26400c83c50308a
  • master default protected
  • development
  • v10.4.1
  • lcm_nudge
  • m_lcm
  • flexpart_lcm
  • fix_GFS
  • optimise
  • fix_GFS_23
  • feature_gfs_fix
  • wetdepo_bugfix
  • feature/newWetDepo
  • tests
  • christine
  • split_mods
  • openmp
  • anne
  • release-10.4.1
  • dev
  • 10.4.1_pesei
  • v11_beta
  • v10.4
  • v10.4_beta
  • v10.4_alpha
  • v9.2.0.3
  • v9.2
  • FPv9.3.2e
  • FPv9.3.2d
  • FPv9.3.2c
  • FPv9.3.2b
  • v9.2.0.2_Yosemite
  • ICR-1008
  • v10.2beta
  • FPv9.3.2a
  • fp9.3.1-20170412-nc4-coded
  • fp9.3.1-20170408-nc4
  • devlan-20161106
  • FPv9.3.1f
  • FPv9.3.1e
  • FPv9.3.1d
41 results

calcpar.f90

Blame
  • Forked from Flexpart / Flexpart
    Source project has a limited visibility.
    cite_html.php 29.25 KiB
    <?php
    	// Project:    Web Reference Database (refbase) <http://www.refbase.net>
    	// Copyright:  Matthias Steffens <mailto:refbase@extracts.de> and the file's
    	//             original author(s).
    	//
    	//             This code is distributed in the hope that it will be useful,
    	//             but WITHOUT ANY WARRANTY. Please see the GNU General Public
    	//             License for more details.
    	//
    	// File:       ./cite/formats/cite_html.php
    	// Repository: $HeadURL: https://svn.code.sf.net/p/refbase/code/branches/bleeding-edge/cite/formats/cite_html.php $
    	// Author(s):  Matthias Steffens <mailto:refbase@extracts.de>
    	//
    	// Created:    10-Jun-06, 02:30
    	// Modified:   $Date: 2012-02-29 00:05:42 +0100 (Wed, 29 Feb 2012) $
    	//             $Author: msteffens $
    	//             $Revision: 1338 $
    
    	// This is a citation format file (which must reside within the 'cite/formats/' sub-directory of your refbase root directory). It contains a
    	// version of the 'citeRecords()' function that outputs a reference list from selected records in HTML format.
    	// 
    	// TODO: - use divs + CSS styling (instead of a table-based layout) for _all_ output (not only for 'viewType=Mobile')
    
    	// --------------------------------------------------------------------
    
    	// --- BEGIN CITATION FORMAT ---
    
    	function citeRecords($result, $rowsFound, $query, $queryURL, $showQuery, $showLinks, $rowOffset, $showRows, $previousOffset, $nextOffset, $wrapResults, $citeStyle, $citeOrder, $citeType, $orderBy, $headerMsg, $userID, $viewType)
    	{
    		global $databaseBaseURL; // these variables are defined in 'ini.inc.php'
    		global $useVisualEffects;
    		global $defaultDropDownFieldsEveryone;
    		global $defaultDropDownFieldsLogin;
    		global $defaultCiteStyle;
    		global $additionalFieldsCitationView;
    		global $displayResultsHeaderDefault;
    		global $displayResultsFooterDefault;
    		global $showLinkTypesInCitationView;
    		global $showFieldItemLinks;
    		global $maximumBrowseLinks;
    
    		global $loc; // '$loc' is made globally available in 'core.php'
    
    		global $client;
    		global $displayType;
    
    		$htmlData = ""; // make sure that our buffer variables are empty
    		$recordData = "";
    
    		// First, initialize some variables that we'll need later on
    		// Calculate the number of all visible columns (which is needed as colspan value inside some TD tags)
    		if ($showLinks == "1" && preg_match("/^(type|type-year|year)$/i", $citeOrder)) // in citation layout, we simply set it to a fixed value (either '1' or '2', depending on the values of '$showLinks' and '$citeOrder')
    			$NoColumns = 2; // first column: literature citation, second column: 'display details' link
    		else
    			$NoColumns = 1;
    
    		if (empty($displayType))
    			$displayType = $_SESSION['userDefaultView']; // get the default view for the current user
    
    		 // If the results footer is displayed, we increase the colspan value by 1 to account for the checkbox column:
    		if ((!preg_match("/^(Print|Mobile)$/i", $viewType)) AND (!preg_match("/^cli/i", $client)) AND ($wrapResults != "0") AND (!isset($displayResultsFooterDefault[$displayType]) OR (isset($displayResultsFooterDefault[$displayType]) AND ($displayResultsFooterDefault[$displayType] != "hidden"))))
    			$NoColumns++;
    
    		// Initialize array variables:
    		$yearsArray = array();
    		$typeTitlesArray = array();
    
    		// Define inline text markup to be used by the 'citeRecord()' function:
    		$markupPatternsArray = array("bold-prefix"        => "<b>",
    		                             "bold-suffix"        => "</b>",
    		                             "italic-prefix"      => "<i>",
    		                             "italic-suffix"      => "</i>",
    		                             "underline-prefix"   => "<u>",
    		                             "underline-suffix"   => "</u>",
    		                             "endash"             => "&#8211;",
    		                             "emdash"             => "&#8212;",
    		                             "ampersand"          => "&",
    		                             "double-quote"       => '"',
    		                             "double-quote-left"  => "&ldquo;",
    		                             "double-quote-right" => "&rdquo;",
    		                             "single-quote"       => "'",
    		                             "single-quote-left"  => "&lsquo;",
    		                             "single-quote-right" => "&rsquo;",
    		                             "less-than"          => "<",
    		                             "greater-than"       => ">",
    		                             "newline"            => "\n<br>\n"
    		                            );
    
    		// Defines field-specific search & replace 'actions' that will be applied to the actual citation
    		// for all those refbase fields that are listed in the corresponding 'fields' element:
    		// (These search and replace actions will be performed *in addition* to those specified globally
    		//  in '$searchReplaceActionsArray' (defined in 'ini.inc.php'). Same rules apply as for
    		//  '$searchReplaceActionsArray'.)
    		$fieldSpecificSearchReplaceActionsArray = array(
    		                                                array(
    		                                                      'fields'  => array("abstract"),
    		                                                      'actions' => array("/[\r\n]+/" => "\n<br>\n") // for the 'abstract' field, transform runs of newline ('\n') or return ('\r') characters into a single <br> tag
    		                                                     )
    		                                               );
    
    		// In addition, for the "more info" section, we also substitute contents of the below 'fields'
    		// with localized field values from variable '$loc'. Since the locales in '$loc' are already
    		// HTML encoded, we have to exclude these fields from any further HTML encoding (done below).
    		$fieldSpecificSearchReplaceActionsArray2 = $fieldSpecificSearchReplaceActionsArray;
    		$fieldSpecificSearchReplaceActionsArray2[] = array(
    		                                                  'fields'  => array("thesis", "approved", "marked", "copy", "selected"),
    		                                                  'actions' => array("/(.+)/e" => "\$loc['\\1']") // use localized field values (e.g., in case of german we display 'ja' instead of 'yes', etc)
    		                                                 );
    
    		static $encodingExceptionsArray = array("thesis", "approved", "marked", "copy", "selected");
    
    
    		// LOOP OVER EACH RECORD:
    		// Fetch one page of results (or less if on the last page)
    		// (i.e., upto the limit specified in $showRows) fetch a row into the $row array and ...
    		for ($rowCounter=0; (($rowCounter < $showRows) && ($row = @ mysql_fetch_array($result))); $rowCounter++)
    		{
    			$encodedRowData = $row; // we keep '$row' in its original (unencoded) form since unencoded data will be required by function 'linkifyFieldItems()' below
    
    			// NOTES: - Currently, HTML encoding and search & replace actions are applied separately
    			//          for the citation and the "more info" section underneath the citation. The
    			//          actions in this 'foreach' block concern the actual citation
    			//        - It might be better to pass the unencoded '$row' data to function 'citeRecord()'
    			//          which would then make calls to function 'encodeField()' individually for each
    			//          field (similar to as it is done it 'modsxml.inc.php')
    			foreach ($encodedRowData as $rowFieldName => $rowFieldValue)
    			{
    				// NOTES: - We HTML encode non-ASCII chars for all but the author & editor fields. The author & editor
    				//          fields are excluded here since these fields must be passed *without* HTML entities to the
    				//          'reArrangeAuthorContents()' function (which will then handle the HTML encoding by itself)
    				//        - Function 'encodeField()' will also apply any field-specific search & replace actions
    				$encodedRowData[$rowFieldName] = encodeField($rowFieldName, $rowFieldValue, $fieldSpecificSearchReplaceActionsArray, array("author", "editor")); // function 'encodeField()' is defined in 'include.inc.php'
    			}
    
    
    			// Order attributes according to the chosen output style & record type:
    			$record = citeRecord($encodedRowData, $citeStyle, $citeType, $markupPatternsArray, true); // function 'citeRecord()' is defined in the citation style file given in '$citeStyleFile' (which, in turn, must reside in the 'cite' directory of the refbase root directory), see function 'generateCitations()'
    
    
    			// Print out the current record:
    			if (!empty($record)) // unless the record buffer is empty...
    			{
    				// Print any section heading(s):
    				if (preg_match("/year|type/i", $citeOrder))
    				{
    					if (preg_match("/^Mobile$/i", $viewType))
    					{
    						$headingPrefix = "\n<div class=\"sect\">";
    
    						$headingSuffix = "</div>";
    					}
    					else
    					{
    						$headingPrefix = "\n<tr>"
    						               . "\n\t<td valign=\"top\" colspan=\"$NoColumns\">";
    
    						$headingSuffix = "</td>"
    						               . "\n</tr>";
    					}
    
    					list($yearsArray, $typeTitlesArray, $sectionHeading) = generateSectionHeading($yearsArray, $typeTitlesArray, $row, $citeOrder, $headingPrefix, $headingSuffix, "<h4>", "</h4>", "<h5>", "</h5>"); // function 'generateSectionHeading()' is defined in 'cite.inc.php'
    
    					$recordData .= $sectionHeading;
    				}
    
    				// Print out the record:
    				if (is_integer($rowCounter / 2)) // if we currently are at an even number of rows
    					$rowClass = "even";
    				else
    					$rowClass = "odd";
    
    				if (preg_match("/^(cli|inc)/i", $client) OR ($wrapResults == "0")) // we use absolute links for CLI clients, for include mechanisms, or when returning only a partial document structure
    					$baseURL = $databaseBaseURL;
    				else
    					$baseURL = "";
    
    				$recordPermaLink = $databaseBaseURL . "show.php?record=" . $row["serial"]; // generate a permanent link for the current record
    
    				if (preg_match("/^Mobile$/i", $viewType))
    				{
    					$recordData .= "\n<div class=\"" . $rowClass . "\">"
    					             . "\n\t<div class=\"citation\">" . $record . "</div>";
    				}
    				else
    				{
    					$recordData .= "\n<tr class=\"" . $rowClass . "\">";
    
    					// Print a column with a checkbox:
    					// Note: we omit the results footer in print/mobile view ('viewType=Print' or 'viewType=Mobile'), for CLI clients, and when outputting only a partial document structure ('wrapResults=0')!
    					if ((!preg_match("/^Print$/i", $viewType)) AND (!preg_match("/^cli/i", $client)) AND ($wrapResults != "0") AND (!isset($displayResultsFooterDefault[$displayType]) OR (isset($displayResultsFooterDefault[$displayType]) AND ($displayResultsFooterDefault[$displayType] != "hidden"))))
    					{
    						$recordData .= "\n\t<td align=\"center\" valign=\"top\" width=\"10\">";
    
    						// - Print a checkbox form element:
    						if (!isset($displayResultsFooterDefault[$displayType]) OR (isset($displayResultsFooterDefault[$displayType]) AND ($displayResultsFooterDefault[$displayType] != "hidden")))
    							$recordData .= "\n\t\t<input type=\"checkbox\" onclick=\"updateAllRecs();\" name=\"marked[]\" value=\"" . $row["serial"] . "\" title=\"" . $loc["selectRecord"] . "\">";
    
    						if (!empty($row["orig_record"]))
    						{
    							if (!isset($displayResultsFooterDefault[$displayType]) OR (isset($displayResultsFooterDefault[$displayType]) AND ($displayResultsFooterDefault[$displayType] != "hidden")))
    								$recordData .= "\n\t\t<br>";
    
    							if ($row["orig_record"] < 0)
    								$recordData .= "\n\t\t<img src=\"" . $baseURL . "img/ok.gif\" alt=\"(" . $loc["original"] . ")\" title=\"" . $loc["originalRecord"] . "\" width=\"14\" height=\"16\" hspace=\"0\" border=\"0\">";
    							else // $row["orig_record"] > 0
    								$recordData .= "\n\t\t<img src=\"" . $baseURL . "img/caution.gif\" alt=\"(" . $loc["duplicate"] . ")\" title=\"" . $loc["duplicateRecord"] . "\" width=\"5\" height=\"16\" hspace=\"0\" border=\"0\">";
    						}
    
    						// - Add <abbr> block which works as a microformat that allows applications to identify objects on web pages; see <http://unapi.info/specs/> for more info
    						$recordData .= "\n\t\t<div class=\"unapi\"><abbr class=\"unapi-id\" title=\"" . $recordPermaLink . "\"></abbr></div>";
    
    						$recordData .= "\n\t</td>";
    					}
    
    					// Print record data as a citation:
    					$recordData .= "\n\t<td id=\"ref" . $row["serial"] . "\" class=\"citation\" valign=\"top\">"
    					             . "\n\t\t" . $record;
    
    					// Display a triangle widget to show more info (keywords, abstract, etc) under each citation:
    					if (!empty($additionalFieldsCitationView))
    					{
    						// Map MySQL field names to localized column names:
    						$fieldNamesArray = mapFieldNames(); // function 'mapFieldNames()' is defined in 'include.inc.php'
    
    						if ($useVisualEffects == "yes")
    							$toggleVisibilityFunction = "toggleVisibilitySlide";
    						else
    							$toggleVisibilityFunction = "toggleVisibility";
    
    						$recordData .= "\n\t\t<div class=\"showhide\">"
    						             . "\n\t\t\t<a href=\"javascript:" . $toggleVisibilityFunction . "('moreinfo" . $row["serial"] . "','toggleimg" . $row["serial"] . "','toggletxt" . $row["serial"] . "','more%20info')\" title=\"" . $loc["LinkTitle_ToggleVisibility"] . "\">"
    						             . "<img id=\"toggleimg" . $row["serial"] . "\" class=\"toggleimg\" src=\"" . $baseURL . "img/closed.gif\" alt=\"" . $loc["LinkTitle_ToggleVisibility"] . "\" width=\"9\" height=\"9\" hspace=\"0\" border=\"0\">"
    						             . "</a>"
    						             . "\n\t\t</div>"
    						             . "\n\t\t<div id=\"moreinfo" . $row["serial"] . "\" class=\"moreinfo\" style=\"display: none;\">";
    
    						// Print additional fields:
    						foreach ($additionalFieldsCitationView as $field)
    						{
    							if (isset($row[$field]) AND !empty($row[$field]))
    							{
    								$recordData .= "\n\t\t\t<div class=\"" . $field . "\"><strong>" . $fieldNamesArray[$field] . ":</strong> ";
    
    								// Make field items into clickable search links:
    								if (in_array($displayType, $showFieldItemLinks))
    									// Note: Function 'linkifyFieldItems()' will also call function 'encodeField()' to HTML
    									//       encode non-ASCII chars and to apply any field-specific search & replace actions
    									$recordData .= linkifyFieldItems($field, $row[$field], $userID, $fieldSpecificSearchReplaceActionsArray2, $encodingExceptionsArray, "/\s*[;]+\s*/", "; ", $showQuery, $showLinks, $showRows, $citeStyle, $citeOrder, $wrapResults, $displayType, $viewType); // function 'linkifyFieldItems()' is defined in 'include.inc.php'
    								else // don't hotlink field items
    									$recordData .= encodeField($field, $row[$field], $fieldSpecificSearchReplaceActionsArray2, $encodingExceptionsArray); // function 'encodeField()' is defined in 'include.inc.php'
    
    								$recordData .= "</div>";
    							}
    						}
    
    						// Print a row with links for the current record:
    						$recordData .= "\n\t\t\t<div class=\"reflinks\">";
    
    						// - Print the record's permanent URL:
    						if (preg_match("/^inc/i", $client)) // we open links in a new browser window if refbase data are included somewhere else:
    							$target = " target=\"_blank\"";
    						else
    							$target = "";
    
    						$recordData .= "\n\t\t\t\t<div class=\"permalink\"><a href=\"" . $recordPermaLink . "\"" . $target . " title=\"" . $loc["LinkTitle_Permalink"] . "\">";
    
    						if (preg_match("/^Print$/i", $viewType)) // for print view, we use the URL as link title
    							$recordData .= $recordPermaLink;
    						else
    							$recordData .= $loc["PermalinkShort"];
    
    						$recordData .= "</a></div>";
    
    						// - Print additional links to cite/export the current record:
    						//   Note: we omit the additional links in print view ('viewType=Print')
    						if (!preg_match("/^Print$/i", $viewType))
    						{
    							// -- Print cite links:
    							if (isset($_SESSION['user_permissions']) AND preg_match("/allow_cite/", $_SESSION['user_permissions']) AND isset($_SESSION['user_cite_formats']))
    							{
    								$userCiteFormatsArray = preg_split("/ *; */", $_SESSION['user_cite_formats'], -1, PREG_SPLIT_NO_EMPTY); // get a list of the user's cite formats (the 'PREG_SPLIT_NO_EMPTY' flag causes only non-empty pieces to be returned)
    
    								$recordData .= "\n\t\t\t\t<div class=\"citelinks\">"
    								             . "&nbsp;|&nbsp;" . $loc["SaveCitation"] . ":";
    
    								foreach ($userCiteFormatsArray as $citeFormat)
    									if (!preg_match("/^html$/i", $citeFormat)) // for now, we exclude the "HTML" cite format (as it's not any different to the regular Citation view HTML output)
    										$recordData .= "\n\t\t\t\t\t&nbsp;<a href=\"" . $baseURL . generateURL("show.php", $citeFormat, array("record" => $row['serial']), true, "", "", $citeStyle, $citeOrder) . "\" title=\"" . $loc["LinkTitle_SaveCitationFormat_Prefix"] . $citeFormat . $loc["LinkTitle_SaveCitationFormat_Suffix"] . "\">" . $citeFormat . "</a>";
    
    								$recordData .= "\n\t\t\t\t</div>";
    							}
    
    							// -- Print export links:
    							if (isset($_SESSION['user_permissions']) AND preg_match("/allow_export|allow_batch_export/", $_SESSION['user_permissions']) AND isset($_SESSION['user_export_formats']))
    							{
    								$userExportFormatsArray = preg_split("/ *; */", $_SESSION['user_export_formats'], -1, PREG_SPLIT_NO_EMPTY); // get a list of the user's export formats
    
    								$recordData .= "\n\t\t\t\t<div class=\"exportlinks\">"
    								             . "&nbsp;|&nbsp;" . $loc["ExportRecord"] . ":";
    
    								foreach ($userExportFormatsArray as $exportFormat)
    									$recordData .= "\n\t\t\t\t\t&nbsp;<a href=\"" . $baseURL . generateURL("show.php", $exportFormat, array("record" => $row['serial'], "exportType" => "file"), true, "", "", $citeStyle) . "\" title=\"" . $loc["LinkTitle_ExportRecordFormat_Prefix"] . $exportFormat . $loc["LinkTitle_ExportRecordFormat_Suffix"] . "\">" . $exportFormat . "</a>";
    
    								$recordData .= "\n\t\t\t\t</div>";
    							}
    						}
    
    						$recordData .= "\n\t\t\t</div>"
    						             . "\n\t\t</div>";
    					}
    
    					$recordData .= "\n\t</td>";
    				}
    
    				// Display the regular links column:
    				if ($showLinks == "1")
    				{
    					if (preg_match("/^Mobile$/i", $viewType))
    						$recordData .= "\n\t<div class=\"links\">";
    					else
    						$recordData .= "\n\t<td class=\"links\" valign=\"top\" width=\"42\">";
    
    					// Print out available links:
    					// for Citation view, we'll use the '$showLinkTypesInCitationView' array that's defined in 'ini.inc.php'
    					// to specify which links shall be displayed (if available and if 'showLinks == 1')
    					// (for links of type DOI/URL/ISBN/XREF, only one link will be printed; order of preference: DOI, URL, ISBN, XREF)
    					$recordData .= printLinks($showLinkTypesInCitationView, $row, $showQuery, $showLinks, $wrapResults, $userID, $viewType, $orderBy); // function 'printLinks()' is defined in 'search.php'
    
    					if (preg_match("/^Mobile$/i", $viewType))
    						$recordData .= "\n\t</div>";
    					else
    						$recordData .= "\n\t</td>";
    				}
    
    				if (preg_match("/^Mobile$/i", $viewType))
    					$recordData .= "\n</div>";
    				else
    					$recordData .= "\n</tr>";
    			}
    		}
    
    
    		// OUTPUT RESULTS:
    
    		// Note: we omit the results header, browse links & query form for CLI clients, and when outputting only a partial document structure ('wrapResults=0')
    		if (!preg_match("/^cli/i", $client) AND ($wrapResults != "0"))
    		{
    			// Note: we also omit the results header in print/mobile view ('viewType=Print' or 'viewType=Mobile')
    			if ((!preg_match("/^(Print|Mobile)$/i", $viewType)) AND (!isset($displayResultsHeaderDefault[$displayType]) OR (isset($displayResultsHeaderDefault[$displayType]) AND ($displayResultsHeaderDefault[$displayType] != "hidden"))))
    			{
    				// Extract the first field from the 'WHERE' clause:
    				if (preg_match("/ WHERE [ ()]*(\w+)/i", $query))
    					$selectedField = preg_replace("/.+ WHERE [ ()]*(\w+).*/i", "\\1", $query);
    				else
    					$selectedField = "author"; // in the 'Search within Results" form, we'll select the 'author' field by default
    
    				// Map MySQL field names to localized column names:
    				$fieldNamesArray = mapFieldNames(true);
    				$localizedDropDownFieldsArray = array();
    
    				if (isset($_SESSION['loginEmail']) AND !empty($defaultDropDownFieldsLogin)) // if a user is logged in -AND- there were any additional fields specified...
    					$dropDownFieldsArray = array_merge($defaultDropDownFieldsEveryone, $defaultDropDownFieldsLogin); // ...add these additional fields to the list of fields visible in the dropdown menus of the results header
    				else
    					$dropDownFieldsArray = $defaultDropDownFieldsEveryone;
    
    				foreach ($dropDownFieldsArray as $field)
    				{
    					if (isset($fieldNamesArray[$field]))
    						$localizedDropDownFieldsArray[$field] = $fieldNamesArray[$field];
    					else // no localized field name exists, so we use the original field name
    						$localizedDropDownFieldsArray[$field] = $field;
    				}
    
    				// Get all citation styles for the current user:
    				if (!isset($_SESSION['user_styles']))
    					$citationStylesArray = array($defaultCiteStyle);
    				else
    				{
    					$citationStylesArray = array();
    
    					$citationStylesTempArray = preg_split("/ *; */", $_SESSION['user_styles']); // get the user's list of citation styles
    
    					foreach ($citationStylesTempArray as $citationStyle)
    						$citationStylesArray[$citationStyle] = $citationStyle;
    				}
    
    				// 2) Build forms containing options to show the user's groups, refine the search results or change the displayed columns:
    				//    TODO for 2b+2c: should we allow users to choose via the web interface which columns are included in the popup menus?
    
    				//    2a) Build a FORM with a popup containing the user's groups:
    				$formElementsGroup = buildGroupSearchElements("search.php", $queryURL, $query, $showQuery, $showLinks, $showRows, $citeStyle, $citeOrder, $displayType); // function 'buildGroupSearchElements()' is defined in 'include.inc.php'
    
    				//    2b) Build a FORM containing options to refine the search results:
    				//        Call the 'buildRefineSearchElements()' function (defined in 'include.inc.php') which does the actual work:
    				$formElementsRefine = buildRefineSearchElements("search.php", $queryURL, $showQuery, $showLinks, $showRows, $citeStyle, $citeOrder, $localizedDropDownFieldsArray, $selectedField, $displayType);
    
    				//    2c) Build a FORM containing display options (change citation style & sort order, or change the number of records displayed per page):
    				//        Call the 'buildDisplayOptionsElements()' function (defined in 'include.inc.php') which does the actual work:
    				$formElementsDisplayOptions = buildDisplayOptionsElements("search.php", $queryURL, $showQuery, $showLinks, $rowOffset, $showRows, $citeStyle, $citeOrder, $citationStylesArray, $citeStyle, 2, $displayType, $headerMsg);
    
    				$htmlData .= displayResultsHeader("search.php", $formElementsGroup, $formElementsRefine, $formElementsDisplayOptions, $displayType); // function 'displayResultsHeader()' is defined in 'results_header.inc.php'
    
    				//    and insert a divider line (which separates the results header from the browse links & results data below):
    				$htmlData .= "\n<hr class=\"resultsheader\" align=\"center\" width=\"93%\">";
    			}
    
    			// Build a TABLE with links for "previous" & "next" browsing, as well as links to intermediate pages
    			// call the 'buildBrowseLinks()' function (defined in 'include.inc.php'):
    			$BrowseLinks = buildBrowseLinks("search.php", $query, $NoColumns, $rowsFound, $showQuery, $showLinks, $showRows, $rowOffset, $previousOffset, $nextOffset, $wrapResults, $maximumBrowseLinks, "sqlSearch", "Cite", $citeStyle, $citeOrder, $orderBy, $headerMsg, $viewType);
    			$htmlData .= $BrowseLinks;
    
    			if (preg_match("/^Mobile$/i", $viewType))
    			{
    				// Extract the original OpenSearch/CQL query that was saved by 'opensearch.php' as a session variable:
    				if (isset($_SESSION['cqlQuery']))
    					$cqlQuery = $_SESSION['cqlQuery'];
    				else
    					$cqlQuery = "";
    
    				// Include an OpenSearch-style (CQL) query form:
    				$htmlData .= "\n<div id=\"queryform\">"
    						   . "\n\t<form action=\"opensearch.php\" method=\"GET\" name=\"openSearch\">"
    						   . "\n\t\t<input type=\"hidden\" name=\"formType\" value=\"openSearch\">"
    						   . "\n\t\t<input type=\"hidden\" name=\"submit\" value=\"" . $loc["ButtonTitle_Search"] . "\">"
    						   . "\n\t\t<input type=\"hidden\" name=\"viewType\" value=\"" . $viewType . "\">"
    						   . "\n\t\t<input type=\"hidden\" name=\"startRecord\" value=\"1\">"
    						   . "\n\t\t<input type=\"hidden\" name=\"maximumRecords\" value=\"" . $showRows . "\">"
    						   . "\n\t\t<input type=\"hidden\" name=\"recordSchema\" value=\"html\">"
    						   . "\n\t\t<input type=\"text\" name=\"query\" value=\"" . $cqlQuery . "\" size=\"25\" title=\"" . $loc["DescriptionEnterSearchString"] . "\">"
    						   . "\n\t\t<input type=\"submit\" name=\"submit\" value=\"" . $loc["ButtonTitle_Search"] . "\" title=\"" . $loc["DescriptionSearchDB"] . "\">"
    						   . "\n\t</form>"
    						   . "\n</div>";
    			}
    			elseif ((!preg_match("/^Print$/i", $viewType)) AND (!isset($displayResultsFooterDefault[$displayType]) OR (isset($displayResultsFooterDefault[$displayType]) AND ($displayResultsFooterDefault[$displayType] != "hidden"))))
    			{
    				// Include the 'queryResults' form:
    				$htmlData .= "\n<form action=\"search.php\" method=\"GET\" name=\"queryResults\">"
    						   . "\n<input type=\"hidden\" name=\"formType\" value=\"queryResults\">"
    						   . "\n<input type=\"hidden\" name=\"submit\" value=\"Cite\">" // provide a default value for the 'submit' form tag (then, if any form element is selected, hitting <enter> will act as if the user clicked the 'Cite' button)
    						   . "\n<input type=\"hidden\" name=\"originalDisplayType\" value=\"" . $displayType . "\">" // embed the original value of the '$displayType' variable
    						   . "\n<input type=\"hidden\" name=\"orderBy\" value=\"" . rawurlencode($orderBy) . "\">" // embed the current ORDER BY parameter so that it can be re-applied when displaying details
    						   . "\n<input type=\"hidden\" name=\"showQuery\" value=\"" . $showQuery . "\">" // embed the current value of '$showQuery' so that it's available on 'display details' (batch display) & 'cite'
    						   . "\n<input type=\"hidden\" name=\"showLinks\" value=\"" . $showLinks . "\">" // embed the current value of '$showLinks' so that it's available on 'display details' (batch display) & 'cite'
    						   . "\n<input type=\"hidden\" name=\"showRows\" value=\"" . $showRows . "\">" // embed the current value of '$showRows' so that it's available on 'display details' (batch display) & 'cite'
    						   . "\n<input type=\"hidden\" name=\"rowOffset\" value=\"" . $rowOffset . "\">" // embed the current value of '$rowOffset' so that it can be re-applied after the user pressed either of the 'Add' or 'Remove' buttons within the 'queryResults' form
    						   // Note: the inclusion of '$rowOffset' here is only meant to support reloading of the same results page again after a user clicked the 'Add' or 'Remove' buttons
    						   //       However, '$rowOffset' MUST NOT be set if the user clicked the 'Display' or 'Cite' button! Therefore we'll trap for this case at the top of the script.
    						   . "\n<input type=\"hidden\" name=\"sqlQuery\" value=\"" . $queryURL . "\">"; // embed the current sqlQuery so that it can be re-applied after the user pressed either of the 'Add' or 'Remove' buttons within the 'queryResults' form
    			}
    		}
    
    		// Output query results:
    		if (preg_match("/^Mobile$/i", $viewType))
    		{
    			$htmlData .= "\n<div id=\"citations\" class=\"results\">"
    			           . $recordData
    			           . "\n</div>";
    		}
    		else
    		{
    			$htmlData .= "\n<table id=\"citations\" class=\"results\" align=\"center\" border=\"0\" cellpadding=\"7\" cellspacing=\"0\" width=\"95%\" summary=\"This table holds the database results for your query\">"
    			           . $recordData
    			           . "\n</table>";
    		}
    
    		// Append the footer:
    		// Note: we omit the results footer & browse links in print/mobile view ('viewType=Print' or 'viewType=Mobile'), for CLI clients, and when outputting only a partial document structure ('wrapResults=0')!
    		if ((!preg_match("/^(Print|Mobile)$/i", $viewType)) AND (!preg_match("/^cli/i", $client)) AND ($wrapResults != "0"))
    		{
    			// Again, insert the (already constructed) BROWSE LINKS
    			// (i.e., a TABLE with links for "previous" & "next" browsing, as well as links to intermediate pages)
    			$htmlData .= $BrowseLinks;
    
    			// Build a results footer with form elements to cite, group or export all/selected records:
    			if (!isset($displayResultsFooterDefault[$displayType]) OR (isset($displayResultsFooterDefault[$displayType]) AND ($displayResultsFooterDefault[$displayType] != "hidden")))
    			{
    				if (isset($_SESSION['user_permissions']) AND ((isset($_SESSION['loginEmail']) AND preg_match("/allow_cite|allow_user_groups|allow_export|allow_batch_export/", $_SESSION['user_permissions'])) OR (!isset($_SESSION['loginEmail']) AND preg_match("/allow_cite/", $_SESSION['user_permissions'])))) // if the 'user_permissions' session variable does contain any of the following: 'allow_cite' -AND- if logged in, aditionally: 'allow_user_groups', 'allow_export', 'allow_batch_export'...
    					// ...Insert a divider line (which separates the results data from the forms in the footer):
    					$htmlData .= "\n<hr class=\"resultsfooter\" align=\"center\">";
    
    				// Call the 'buildResultsFooter()' function (which does the actual work):
    				$htmlData .= buildResultsFooter($showRows, $citeStyle, $citeOrder, $displayType, $headerMsg);
    			}
    		}
    
    		if ((!preg_match("/^(Print|Mobile)$/i", $viewType)) AND (!preg_match("/^cli/i", $client)) AND ($wrapResults != "0") AND (!isset($displayResultsFooterDefault[$displayType]) OR (isset($displayResultsFooterDefault[$displayType]) AND ($displayResultsFooterDefault[$displayType] != "hidden"))))
    		{
    			// Finish the form:
    			$htmlData .= "\n</form>";
    		}
    
    		return $htmlData;
    	}
    
    	// --- END CITATION FORMAT ---
    ?>