Description
The Paragraph Level IDs plugin adds an ‘id’ attribute to each paragraph tag in a blog post, giving the author and readers additional functionality.
So for example, <p> becomes <p id=”para1234-5″>.
These additions allow anyone to link directly to that paragraph in the post. This is especially useful for long tracts of text, academic writing, and legal documents.
Road Map
In the future I hope to make the following improvements.
- Streamline the code so it is at its most efficient and smallest file size.
- Further customisation options for the id
- A degree of backwards compatibility and localisation for other languages
- An option so this feature is only applied to the post types specified.
I would welcome any advice, offers of support, bug-testing, forking the project and troubleshooting to help make these extra features possible.
Acknowledgements
My friend @strangerpixel overhauled the 0.2 code for this 1.0 release.
The comment by s_ha_dum in [this Stack Exchange thread] (https://wordpress.stackexchange.com/questions/74558/automate-paragraphs-in-a-post-page-to-have-a-unique-anchor-link) and the comment by Milo in [this Stack Exchange thread] (https://wordpress.stackexchange.com/questions/90066/numbering-sections-and-block-level-elements-in-wpautop-wordpress-as-cms-for-l) got me started. The [Add To Post plugin (https://www.ads-software.com/plugins/add-to-post/) was instructive in helping me build a simple settings form.
Installation
- Download the plug-in
- Unzip the files and upload rs-para-level-ids.php to the wp-content/plugins directory.
- Visit the plugins section of your WordPress Dashboard.
- Activate the plugin
- Nothing will be changed in your website’s source code until you visit the ‘Paragraph IDs’ options under the WordPress ‘Settings’ menu, and update the settings according to your taste.
FAQ
- What kind of tags does the plugin operate on?
-
The plugin only makes additions to <p> tags that have no other attributes. If any other part of the content or system gives a paragraph tag any kind of styling, name or id, then this plugin will simply ignore it.
- How are the ids and anchors added?
-
The id attributes are all added dynamically as the page is generated. The plugin works by counting the number of paragraphs and adding an id or name based on that.
- What happens when I change the content of my post?
-
If the content changes and the author reduces or adds to the number of paragraphs in the text, the anchor or paragraph id will change accordingly.
This plugin therefore works best with archived content that is not likely to change.
- I think your plugin could be improved – Would you like some help with it?
-
Absolutely, I’m at almost the limit of my coding skills here! [Get in touch via my website] (https://www.robertsharp.co.uk/paragraph-level-ids/) or on Twitter, [@robertsharp59] (https://twitter.com/robertsharp59)
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Paragraph Level IDs” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Paragraph Level IDs” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0
- Simplified the process. Now we offer only ids, not anchors.
- Added an option to add # links immediately after each paragraph
- Added an option to add highlight styling to each paragraph tag on hover
- Many thanks to @strangerpixel for this fantastic update.
0.2
- Added a settings menu
- Added the ability to add an ‘id’ to the paragraph tags, an anchor, or both
- anchor/id customisation options.
0.1
- Proof of concept, no features