pkg_xbfootnotetag v1.2.0 
27th January 2022  J3

xbFootnoteTag plugins are now withdrawn and replaced by xbRefs.

If you have xbFootnoteTag installed and in use please follow the following simple steps to upgrade:

  1. If you don't mind loosing all your existing {​xbref...} shortcodes then simply uninstall xbFootnoteTag package and install xbRefs.
  2. If you wish to preserve existing references then first update to the final version (v1.2.0) of xbFoototeTag. (link above)
    1. On the xbFootnoteTag Content plugin options there is a new option to not remove shortcodes on uninstall. Make sure this is set and save the options
    2. It is now safe to uninstall xbFootnoteTag - your shortcodes will be visible on the site pages until you install and enable the xbRefs Plugins package
    3. Install xbRefs Plugins package
    4. Check and save the options for both plugins and enable them. (there are some new and changed options so pay attention!)
  3. That's all

 xbRefs Plugins have several bug fixes and minor enhancements from xbFootnoteTag v1.0.1 in the initial v1.9.0, xbRefs v2.0 will be available soon with further new feature and a new component - xbRefMan - is in development to provide admin tools for managing references and simple site views listing all references in articles. See the xbRefMan article for proposed details.

pkg_plugins_xbrefs v1.9.0 
27th January 2022  J3

xbFootnoteTag was originally created to assist with creating and maintaining references, or other recurring snippets of information in articles. As well as generating conventional footnotes (linked by either a number or a citation title) since we are in a hypertext environment it makes sense to provide an option to have the reference appear as a popover either instead of or as well as a footnote (footnotes work better if the article gets printed).

Documentation  Demo Page

The title and text for the footnote can be taken from Joomla Tags - this makes it easy to reuse the same information across different articles. In addition, if the tags used for references are also added to the article as article tags then standard (or customised) tag views can be used to build a references page for the entire site listing all articles referencing a tag, or all tags referenced by each article.

Alternatively plain text can be entered for the title and description to be used as a one-off footnote. 

As well as use for academic style references the ability to use tag content for a popover is very handy for acronyms and definitions.

The extension is a Package containing two interdependent plugins - an editor extension button xbFootnoteTagBtn, and a system content plugin xbFootnoteTagCon.

The button works with both TinyMCE and JCE (and should work with other editors but is not tested against them) and generates a shortcode - {​xbref ... } {/xbref} which the content plugin converts into the appropriate combination of footnote and popover when the full article is displayed. (Footnotes are not wanted in views which only display the intro text for an article like a blog summary page)

Roadmap

Improvements and bug fixes

  1. Improve tag selection routine

Possible New features

  1. Option to create new tag from the button dialogue when entering plain text title and description
  2. Additional views in Article Manager to manage shortcodes and reference tags including import from BibTex file.
  3.  Option to convert shortcodes to text on uninstall - for J3 this might have to be a separate xbArtMan function as there is no way to reliably trap uninstall

Changelog

v1.2.0 27th January 2022 FINAL VERSION - replace with xbRefs
    minor bug fixes and changes to prepare for upgrade to xbRefs
1.2.0 21.0.1 17th July 2019
    Fixed bug in content plugin causing rare invalid SQL error
v1.0.0 FIRST RELEASE VERSION 
    If you have acquired any earlier version please uninstall and start afresh with this version