A.N.R.GHG Publishing Toolkit

An AMP compatible toolbox to help complete WordPress. Core features include:

• Security by locking the login dialog
• HTML partial including
• Thank You and other messages
• Date information: published, updated, first published, meta tags
• Paragraph links and list item links
• Heading links
• Table of contents
• Notes and sources in two lists
• Reference lists, bibliographies
• Webfont loading
• Templates for messages, notes, sources, references
• Exporting and importing settings, templates and custom options
• Backing up the settings and templates
• Customize anchors and slugs programmatically

Notice about Language support: While American English is supported natively, British English support is at 100% (generated). French and Spanish with all sublocales supported by WordPress benefit from internal translation, currently at 18% and 6% respectively. About one in four string instances are in sync with WordPress Core.

The A.N.R.GHG Publishing Toolkit can load and filter HTML partials from the file system, and it addresses the challenge to do by HTML and CSS things that used to be done by JavaScript, which was one reason the internet loaded slowly on mobiles and consumed more resources than with AMP technology. So far, the A.N.R.GHG Publishing Toolkit is not yet up to its full design goal, but it already can:

Security

• Protect WordPress websites against password leak effectiveness, by hampering the login process depending on the value of a constant defined in a mini-plugin (editable on the hosting platform);
• Make that constant configurable so that in multisite networks, individual sites may be toggled independently;
• Extend authentication cookie lifespans to a configurable period of time, for example until the day after the next scheduled login rush;
• Display the login activation status with an icon in the Admin bar;
• Blank the login dialog out if it is convenient to access the WordPress Admin area through the hosting platform exclusively.
• CAUTION: Unless the hosting provider has set up VPS level security, shared hosting is prone to being hacked by web shell even if only a single one of the websites sharing the same server’s home directory is compromised. Therefore, the A.N.R.GHG Publishing Toolkit’s security feature is efficient only on websites hosted on a dedicated server, a Virtual Private Server (VPS), or shared hosting with VPS level security set up by the hosting provider.

HTML partials

• Include locally stored HTML partials directly from the file system;
• Replace optional placeholders with CSS classes and a configurable value;
• Enable updating the partials in bulk by FTP, rather than individual Custom HTML blocks or reusable blocks;
• Solve the issue of size, since posts containing too much code cannot be saved.

Thank You message

• Display a configurable message after posts and/or pages;
• Help with activating and configuring the message on a per-page basis in the Post Meta box;
• Make available a set of rich text messages configured in the Template editor;
• Provide a block to configure an unlimited number of messages right in the post or page.

Date information

• Display the last modified date at post/page start or end;
• Display the published date at the start or end of pages where WordPress does not display it natively;
• Optionally add a freely configurable field about where the post was first published;
• Add date meta tags (may be useful if not already added by an SEO plugin).

Paragraph links

• Add a fragment identifier in a configurable link prepended to every paragraph and list item;
• Use position independent identifiers derived from the content;
• Use the custom ‘HTML anchor’ for all paragraphs that it has been configured for, further improving identifier stability;
• Keep the identifiers fully localized also when using a non-Latin script, for legible display in the URL bar.

Heading links

• Add localized and optionally stable fragment identifiers and hyperlinks to headings.

Table of contents

• Number the headings by CSS in appended or prepended position with a backlink to the table of contents;
• Replace the appended number with a generic arrow if numbers are not desired next to headings;
• List the headings in a table of contents, that the heading numbers link back to;
• Optionally collapse and expand the table of contents from the label, also when JavaScript is off;
• Insert a table of contents automatically in all posts with a configurable minimum number of headings;
• Deactivate the table of contents for a particular post or page in the added Meta box;
• Add a table of contents if the Table of contents block is present;
• Use a configurable string as an alternative positioner in the Classic Editor to override the configured default position;
• Configure its label for all posts in the settings, and for a particular post in the Post Meta box or in the block, or by adding an argument in the code;

Notes and sources

• Parse inline notes and sources and display them either as descriptive endnotes or as bibliographic endnotes depending on their delimiters;
• Process sources nested in notes;
• Show notes and sources in responsive, adaptative and configurable rich tooltips when hovering their inline anchor;
• Support six numbering systems including Eastern Arabic digits to help distinguish notes from sources;
• Register notes and sources on the fly for reuse across a post or page;
• Store notes and sources as templates for reuse across the website;
• Display additional text around reused notes and sources;
• Handle multiple notes and/or sources reused in a single instance;
• Parse the notes and sources delimiters as freely configured also using non-Latin script or punctuation only;
• Support switching complement delimiters midway, parsing older posts for the previous ones while the current ones are processed in posts from a configurable ID on;
• Save the current delimiters with each post, so that delimiters may be reconfigured at any time and are valid in new posts;
• Parse post-specific sets of delimiters configured in the Post Meta box;
• Display complements in a number of columns (up to three) configurable for notes and sources separately, and responsively with respect to mobiles;
• List complements section-wise at each instance of the block in the Block Editor, or alternatively, of a configurable positioner code in the Classic Editor;
• Defer complement lists to the footer of a particular post, or do so for all posts unless specified otherwise;
• Post-process the web page to move complement lists from the built-in WordPress default position below the footer to within the footer;
• Specify the writing direction in complement lists and anchor tooltips for notes and for sources separately on a per-post basis in the added Post Meta box, or per instance in the block (Block Editor) or the positioner code (Classic Editor);
• Display a complement in a new tab or window using its URL even when lists are collapsed by default;
• Keep complement lists collapsed except for the target item after clicking an anchor, so as to not distract from the other features and information;
• Optionally expand the full list on clicking any anchor as it is useful for ibid notation;
• Combine identical complements to a single item, and enumerate the related anchors in a tooltip shown on hovering its number in the list;
• Display a warning if an opening delimiter is unbalanced, quoting the context for easy location.

Reference lists

• Display lists of references in the post or page;
• Optionally make them collapsible, and display them collapsed or expanded at page load;
• Help with configuring reference lists in the ‘Reference list’ block with settings for label, display and writing direction.

Web fonts

• Load web fonts with preconnect after pasting their URL into a text area in the settings;
• The Google Web Fonts repository is linked from the Settings page;
• One example URL is provided out of the box, but the switch is off by default.

Templates

• Help with editing and storing templates that can be used as messages, as notes and as sources, and in reference lists;
• Bulk-edit saved templates on the fly in the templates list.

Export/import

• Export and import templates and settings;
• Export and import freely defined options (this comes in handy when using plugins not providing export and import features);
• Restore any state using a datestamped file from the backup feature, and prevent accidental data loss.

Backup

• Automatically back up templates and settings both at accessing and saving these pages;
• Restore any state using the import feature, and prevent accidental data loss.

Anchors and slugs

• Help with configuring the rules used to generate fragment identifiers, and optionally page slugs;
• Allow for uppercase, custom conversions, configurable maximum length.
• Support custom conversions;
• Make the maximum length configurable.

Excerpts

• Mitigate the effect of not using shortcodes, but versatile and internationalized delimiters instead.

Interoperability

• Integrate with Elementor;
• Integrate with Advanced Custom Fields.

Character conversions

• Optionally deactivate WordPress default behavior based on WPTexturize, so that ASCII quotation marks stay as-is also outside code areas.

Category pages and taxonomies

• Activate rich-text term descriptions.

Scrolling

• Use a configurable scroll offset and optional CSS smooth scrolling.

CSS

• Add the post or page slug as a class to the body element to ease customizing the aspect of specific pages.

HTML

• Clean up errand meta tags and remove stray meta elements on public pages.

User interface

• Provide 4 Gutenberg blocks to help with configuring messages, reference lists, note and source lists, and the table of contents;
• Add a configurable Post Meta box for a more fine-grained configuration of various features;
• Display settings in a single, fully searchable page with three levels of verbosity;
• Add optional Admin submenu or menu items;
• Provide an internal header menu.

Planned features

• A format converter for Markdown ➔ WordPress;
• A converter for .docx files;
• An accessible emoji feature.

Concept

The A.N.R.GHG Publishing Toolkit aims to be one more Swiss Army knife to help complete any WordPress installation while reducing greenhouse gas emissions in multiple ways:

• Thanks to AMP compatibility for a faster, less resource consuming web;
• With streamlined processes at its end in a slim code base without external style sheets;
• Through its commitment to web hosting with renewable energy ever since the first months;
• By developing in a local WordPress stack on a laptop powered with 100% renewable energy from the local grid operator;
• Being developed by a vegetalian, because going vegan is the single biggest way to reduce our impact on planet Earth, per Oxford University research and helps terminate animal torture.

Beyond being fully AMP compatible, the A.N.R.GHG Publishing Toolkit’s features for the public pages stay functional where JavaScript is turned off, with one limitation: Expanding the table of contents from a heading backlink requires one click more.