note-for-developers.txt
2020-12-19T0609+0100
Last modified:  2021-01-01T2249+0100

Footnotes plugin for WordPress, v2.2.6 and later

Support for custom templates
‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾

Since v2.2.6, Footnotes supports custom templates.

Custom templates may be loaded from a sibling folder 'footnotes-custom'
or since v2.3.1 from a folder 'templates/footnotes/' in the active theme.

Priority order:
    1. active theme
    2. sibling folder
    3. internal

See footnotes/class/template.php:67..116


A.  Active theme
    ‾‾‾‾‾‾‾‾‾‾‾‾
Please create a folder 'templates/footnotes/' in your child theme and
store all your public custom templates for Footnotes directly therein.

Existing homonymous templates are loaded instead of their counterparts in
wp-content/plugins/footnotes/templates/public/.


B.  Sibling folder
    ‾‾‾‾‾‾‾‾‾‾‾‾‾‾
Please make a sibling of the "footnotes" folder called 'footnotes-custom' and
the same internal structure and file names as 'footnotes/templates/public/'.

Example for custom tooltips:

footnotes-custom
└── templates
    └── public
        ├── footnote.html
        └── tooltip.html

The timing parameters in the inline jQuery script 'tooltip.html' are already
configurable in the dashboard > Referrers and tooltips > Tooltip timing.