{"id":25532,"date":"2013-10-06T13:59:19","date_gmt":"2013-10-06T13:59:19","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/paragraph-level-ids\/"},"modified":"2015-01-06T15:37:58","modified_gmt":"2015-01-06T15:37:58","slug":"paragraph-level-ids","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/paragraph-level-ids\/","author":418661,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0","stable_tag":"1.0","tested":"4.1.42","requires":"3.0.1","requires_php":"","requires_plugins":"","header_name":"Paragraph Level IDs","header_author":"Robert Sharp","header_description":"","assets_banners_color":"cbcdc7","last_updated":"2015-01-06 15:37:58","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"http:\/\/www.robertsharp.co.uk\/paragraph-level-ids\/","header_author_uri":"http:\/\/www.robertsharp.co.uk","rating":5,"author_block_rating":0,"active_installs":10,"downloads":1746,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.0":"

An overhauled version with simplified id settings, and a visible link feature for those that want it.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"1"},"assets_icons":[],"assets_banners":{"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":"1052734","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[7204,2302,175,4222],"plugin_category":[],"plugin_contributors":[128690,128689],"plugin_business_model":[],"class_list":["post-25532","plugin","type-plugin","status-publish","hentry","plugin_tags-anchor","plugin_tags-id","plugin_tags-links","plugin_tags-paragraph","plugin_contributors-amucklow","plugin_contributors-robertsharp","plugin_committers-amucklow","plugin_committers-robertsharp"],"banners":{"banner":"https:\/\/ps.w.org\/paragraph-level-ids\/assets\/banner-772x250.jpg?rev=1052734","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/paragraph-level-ids_cbcdc7.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n

The Paragraph Level IDs plugin adds an 'id' attribute to each paragraph tag in a blog post, giving the author and readers additional functionality.<\/p>\n\n

So for example, <p><\/strong> becomes <p id=\"para1234-5\"><\/strong>.<\/p>\n\n

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.<\/p>\n\n

Road Map<\/h3>\n\n

In the future I hope to make the following improvements.<\/p>\n\n

    \n
  • Streamline the code so it is at its most efficient and smallest file size.<\/li>\n
  • Further customisation options for the id<\/li>\n
  • A degree of backwards compatibility and localisation for other languages<\/li>\n
  • An option so this feature is only applied to the post types specified.<\/li>\n<\/ul>\n\n

    I would welcome any advice, offers of support, bug-testing, forking the project and troubleshooting to help make these extra features possible.<\/p>\n\n

    Acknowledgements<\/h3>\n\n

    My friend @strangerpixel overhauled the 0.2 code for this 1.0 release.<\/p>\n\n

    The comment by s_ha_dum<\/strong> in [this Stack Exchange thread] (http:\/\/wordpress.stackexchange.com\/questions\/74558\/automate-paragraphs-in-a-post-page-to-have-a-unique-anchor-link) and the comment by Milo<\/strong> in [this Stack Exchange thread] (http:\/\/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 (http:\/\/wordpress.org\/plugins\/add-to-post\/) was instructive in helping me build a simple settings form.<\/p>\n\n\n

      \n
    1. Download the plug-in<\/li>\n
    2. Unzip the files and upload rs-para-level-ids.php to the wp-content\/plugins directory.<\/li>\n
    3. Visit the plugins section of your WordPress Dashboard.<\/li>\n
    4. Activate the plugin<\/li>\n
    5. 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.<\/li>\n<\/ol>\n\n\n
      \n
      What kind of tags does the plugin operate on?<\/dt>\n

      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.<\/p><\/dd>\n

      How are the ids and anchors added?<\/dt>\n

      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.<\/p><\/dd>\n

      What happens when I change the content of my post?<\/dt>\n

      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.<\/p>\n\n

      This plugin therefore works best with archived content that is not likely to change.<\/p><\/dd>\n

      I think your plugin could be improved - Would you like some help with it?<\/dt>\n

      Absolutely, I'm at almost the limit of my coding skills here! [Get in touch via my website] (http:\/\/www.robertsharp.co.uk\/paragraph-level-ids\/) or on Twitter, [@robertsharp59] (https:\/\/twitter.com\/robertsharp59)<\/p><\/dd>\n\n<\/dl>\n\n\n

      1.0<\/h4>\n\n
        \n
      • Simplified the process. Now we offer only ids, not anchors. <\/li>\n
      • Added an option to add # links immediately after each paragraph<\/li>\n
      • Added an option to add highlight styling to each paragraph tag on hover<\/li>\n
      • Many thanks to @strangerpixel for this fantastic update.<\/li>\n<\/ul>\n\n

        0.2<\/h4>\n\n
          \n
        • Added a settings menu<\/li>\n
        • Added the ability to add an 'id' to the paragraph tags, an anchor, or both<\/li>\n
        • anchor\/id customisation options.<\/li>\n<\/ul>\n\n

          0.1<\/h4>\n\n
            \n
          • Proof of concept, no features<\/li>\n<\/ul>","raw_excerpt":"The plugin adds an 'id' attribute to each paragraph tag in a blog post.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/25532","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=25532"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/robertsharp"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=25532"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=25532"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=25532"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=25532"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=25532"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=25532"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}