An open source WordPress plugin providing an all-in-one solution for effective academic blogging.
To my knowledge, there is not one citation plugin that exists for WordPress that does its job the way it should. Every other citation plugin uses WordPress shortcodes to render citations. Is that a bad thing. Yes. Here's why:
Once you commit to using a plugin that uses shortcodes to render content, you're stuck with it for the life of your website. If you uninstall that plugin, all posts which rely on the shortcodes from that plugin break. Additionally, if the person who wrote the plugin decides he/she no longer wants to support it and the shortcode API changes, all of your posts will break. This is unacceptable for academic writing.
This plugin generates plain, beautiful HTML and renders it at the time of insertion. There are zero shortcodes. There is zero chance of your posts breaking.
Need to write one long blog post with lots of references? Download this plugin, write the post, and then delete the plugin if you don't need it any longer. Freedom.
- Insert formatted references on the fly using digital identifiers (PMID or DOI).
- Manually insert formatted references from over 15 types of references.
- Import a full bibliography from your favorite reference manager using an exported
.ris
file. - Automatically format references for every citation style on planet earth (over 1300).
- Fully interactive reference list which lives beside the post editor.
- Search PubMed from the post editor and insert references instantly.
- Inline citations display full formatted references on the frontend when hovered with the mouse (or when tapped on mobile). No more scrolling down and losing your focus!
Click Here to Translate this Plugin
Translations for this plugin can be completed and submitted here. After submission of a translation, I'll try to update the plugin with your translations within 7 days.
If you'd like to contribute to this project, please read the contributor guide.
- Citing references at the same time the reference is added
- Citing references after the reference has been added
(feel free to request more)
PC/Linux | Mac | Action |
---|---|---|
ctrl-alt-r |
cmd-alt-r |
Open the Add References menu |
- Double click the heading to either
Cited Items
orUncited Items
to fully expand that list and simultaneously collapse the other.
- Click
Add References to Reference List
button [1b]. - Type a comma-separated list of one or more PMIDs or DOIs in the window that pops up [3].
- Click
Add Reference
[3c].
- Click
Add References to Reference List
button [1b]. - Click
Add Manually
button [3a]. - Select your citation type from the dropdown list on the top [4a].
- Fill out the details for as many contributors as you are able to.
- Fill out as much information about the reference as you can in the form below. Items highlighted in red are mandatory.
- When finished, click
Add Reference
.
Note: Currently, users are able to import entire reference lists using the widely available RIS format. This section assumes that you have already exported a
.ris
file from your reference manager, PubMed, or some other web service.
- Click the "hamburger menu" icon to open the secondary menu [1e].
- Click the
Import references from RIS file
button [2a]. - Click the
Choose File
button [5a] and select your.ris
file. - Click
Import
[5b] to import the references to youruncited
list.
Note: This action will delete references from your reference list, your bibliography, and all locations where it has been cited in the document. It will also adjust your inline citation numbers in your document automatically after the action has taken place.
- Click on one or more references in either the
Cited Items
orUncited Items
lists to select them. Selected items have a blue left border [6a,6b] - Click
Remove selected items from reference list
to remove the selected references [1c].
Note: This is the single-most destructive action that you can perform. Be very cautious when doing this as it will delete all traces of references that you have added to your reference list, document, and bibliography.
- Click the "hamburger menu" button to expose the secondary menu [1e].
- Click the
Delete all references
button [2c].
- Be sure the carat is located at the postion that you want your citation added in the document.
- Follow the same instructions for adding references automatically or adding references manually.
- Just before clicking
Add Reference
in the final step, be sure that theAttach Inline
checkbox [3d] is checked.
Note: References cited from the Uncited List will be brought into the cited list automatically as they are cited.
- Be sure the carat is located at the postion that you want your citation added in the document.
- Select all items that you'd like to cite at the current position (selected items have a blue left border [6a,6b]).
- Click
Insert Selected References
[1a].
- Navigate to the Academic Blogger's Toolkit options menu by clicking
Settings -> Academic Blogger's Toolkit
in the WordPress sidebar. - Choose a citation style from the dropdown menu.
- Click
Update
.
Note: Changing the citation style in the document will automatically adjust inline citations and the bibliography to match the newly chosen citation style.
- Click the "hamburger menu" button to expose the secondary menu [1e].
- Choose a citation style from the dropdown menu [2e].
-
Visit this link to create a fully custom citation style, or make tweaks to an existing style. Documentation for this service can be found here.
-
After creating your citation style, select
Style -> Save Style
in the toolbar. -
In the next window that pops up, select
Save to Disk
to save to your computer. -
Upload the file to your WordPress site using the WordPress Media Manager and copy the direct URL to the file.
-
Paste the URL in the field shown below.
Note: Selecting the radio button labelled
Use custom citation style by default
is completely optional. If checked, then the style will automatically be used as default for new posts. If not, you will still be able to choose the style from the reference list. -
Click Update.
Note: The URL will be verified by the plugin and converted from a URL to a path automatically. In other words, if you notice that the URL changes after clicking the Update button, that means everything worked!
-
The custom style will now be accessible from the reference list.
- Click the pin icon [1d] to toggle floating mode.
Note: During floating mode, the reference list will be resized dynamically to fit within the boundaries of your screen. This is by design. Without this, you would not be able to reach items below the lower margin of your screen.
The citation processor automatically sorts and inserts your citations based on how they are supposed to be sorted by your chosen citation style. In other words, each time that a citation is added to your document, EVERY citation within the document is checked and updated, where appropriate. If you attempt to move around citation numbers or alter the HTML generated by the processor in any way, the processor will fail.
If you find that the citation ordering is not the way that you like it, choose a different citation style.
# | Image |
---|---|
1. | |
2. | |
3. | |
4. | |
5. | |
6. |