Linking to records
From refbase
This page shows how to provide links to particular records or search result sets and how to control the database output:
Important: Please note that the features described below refer to refbase-0.9.0 or greater and may not be present in earlier versions.
The given links are all working examples which you can try out.
Contents |
Permanent record links
If you display a record in details view, you'll notice a link below each record saying "Permanent link to this record". You can copy this URL to directly link to a particular record. The URL looks like this:
show.php?record=xxx
where xxx is the serial number of the record that's displayed in the record's serial field. E.g., to link to a record with serial number '12', use:
show.php?record=12
Displaying all records in a database
If you want to give someone a link that simply displays all records in the database, you can use
show.php?records=all
Linking to a fixed list of records
In order to provide a link that points someone to a fixed list of records in your database, you can use:
show.php?records=xxx,xxx,...,xxx
where xxx is again the record's serial number. You may use any non-digit character(s) to delimit between multiple serial numbers. Here's an example for records with serial numbers '1', '12', '437' and '21234':
show.php?records=1,12,437,21234
Displaying records of a particular author
You can use the show.php script in conjunction with the author parameter to build a link that points to all records of a particular author. E.g., here's a link that shows all records where the author field contains 'mock':
show.php?author=mock
Note that, in this example, there are some duplicate record entries. If these duplicates have been flagged in the database, you can omit them by adding without=dups to your URL:
show.php?author=mock&without=dups
It's also possible to present only a subset of the author's records. E.g., this will display all unique records by 'Mock' that were published in year 2002:
show.php?author=mock&without=dups&year=2002
Or, to give another example, this will display all unique records by 'Mock' whose title field contains 'photo':
show.php?author=mock&without=dups&title=photo
Displaying records that contain a particular word
Besides the author, year and title fields, you can also query other fields such as keywords, abstract, area or the type field. As an example, the link below will display all records whose title contains 'plankton' and where the keywords field contains 'antarctic' and the abstract contains 'primary production':
show.php?title=plankton&keywords=antarctic&abstract=primary production
And here's another one which will show all records where the area field contains 'greenland' and the type field contains 'chapter':
show.php?area=greenland&type=chapter
Controlling the output of found results
The show.php script allows you to control how found records are displayed on screen. E.g., it's easy to change the number of records that are returned per page. Here's again one of the above examples which shows all unique records by 'Mock' but we'll instruct the database to return 10 records per page:
show.php?author=mock&without=dups&showRows=10
Same as above, but records are displayed in details view and with only one record per page:
show.php?author=mock&without=dups&showRows=1&submit=Display
And here's the same result set in cite view, showing 20 records per page:
show.php?author=mock&without=dups&showRows=20&submit=Cite
Again, same as above, but this time in print view and without any links:
show.php?author=mock&without=dups&showRows=20&submit=Cite&viewType=Print&showLinks=0
You can change the citation style and sort order. In this example, citations are formatted according to the citation style "J Glaciol" and are sorted by resource type:
show.php?author=mock&without=dups&showRows=20&submit=Cite&citeStyle=J Glaciol&citeOrder=type
You can also output citations as RTF, PDF, LaTeX or structured/plain text:
show.php?author=mock&without=dups&showRows=20&submit=Cite&citeStyle=J Glaciol&citeOrder=type&citeType=RTF show.php?author=mock&without=dups&showRows=20&submit=Cite&citeStyle=J Glaciol&citeOrder=type&citeType=PDF show.php?author=mock&without=dups&showRows=20&submit=Cite&citeStyle=J Glaciol&citeOrder=type&citeType=LaTeX show.php?author=mock&without=dups&showRows=20&submit=Cite&citeStyle=J Glaciol&citeOrder=type&citeType=Markdown show.php?author=mock&without=dups&showRows=20&submit=Cite&citeStyle=J Glaciol&citeOrder=type&citeType=ASCII
You can even provide links that directly return all search results in export formats such as Endnote, RIS, BibTeX or XML:
show.php?author=mock&without=dups&submit=Export&exportFormat=Endnote show.php?author=mock&without=dups&submit=Export&exportFormat=RIS show.php?author=mock&without=dups&submit=Export&exportFormat=BibTeX show.php?author=mock&without=dups&submit=Export&exportFormat=ODF XML&exportType=xml show.php?author=mock&without=dups&submit=Export&exportFormat=MODS XML&exportType=xml show.php?author=mock&without=dups&showRows=20&submit=Export&exportFormat=SRW XML&exportType=xml
Same records returned as a file download:
show.php?author=mock&without=dups&submit=Export&exportFormat=Endnote&exportType=file show.php?author=mock&without=dups&submit=Export&exportFormat=RIS&exportType=file show.php?author=mock&without=dups&submit=Export&exportFormat=BibTeX&exportType=file show.php?author=mock&without=dups&submit=Export&exportFormat=ODF XML&exportType=file show.php?author=mock&without=dups&submit=Export&exportFormat=MODS XML&exportType=file show.php?author=mock&without=dups&showRows=20&submit=Export&exportFormat=SRW XML&exportType=file
