WP Manifestindependent plugin directory
manifest / content / dt-roadmap

DT Roadmap

Provides shortcode-driven product roadmaps with AJAX voting.

by Fahim (fahim.xyz) · github.com/ifahimreza/dt-roadmap

0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/ifahimreza/dt-roadmap/archive/refs/heads/main.zip

Overview

DT Roadmap is a shortcode-based WordPress plugin that renders interactive product roadmaps where visitors can upvote specific items. Provide a parent page/post ID, and the plugin will automatically display all child pages/posts as voteable cards. Votes are stored per page using post meta, and users are limited to one vote per item via cookie tracking and AJAX validation.

Installation

  1. Upload the dt-roadmap folder to your /wp-content/plugins/ directory.
  2. Activate “DT Roadmap” in the WordPress admin Plugins screen.
  3. Add the [roadmap_list] shortcode to any post/page where you want the cards to appear.

Shortcode Reference

[roadmap_list parent="123"]
[roadmap_list parent="123" type="backlog"]
[roadmap_list parent="123" type="in progress"]

Attribute Notes

  • parent (required): The parent post/page ID. All child pages/posts of this parent will be displayed as roadmap items.
  • post_type: Post type to query. Defaults to page.
  • type: Optional filter by roadmap type. Valid values: None, backlog, in progress, Done (case-insensitive).

Custom Meta Fields

Each child page/post should have two custom meta fields:

  • _dt_roadmap_progress: Integer 0-100 representing completion percentage.
  • _dt_roadmap_type: Text value: None, backlog, in progress, or Done.

Voting Behavior

  • Each referenced ID is rendered as a card titled with its post title, and tracked using post-{ID} as the vote key.
  • Votes are stored in the _dt_roadmap_votes post meta array keyed by item ID (post-123, etc.).
  • AJAX requests use a nonce and hit the dt_roadmap_vote action.
  • Users may only vote once per item; a cookie (dt_roadmap_votes) stores their selections.
  • Each host post/page maintains its own counts, so placing the shortcode on multiple pages creates separate tallies.

Assets

The plugin automatically enqueues assets/css/roadmap.css and assets/js/roadmap.js on any singular view that contains the [roadmap_list] shortcode.

Support

For enhancements or issues, please open a ticket with your theme/plugin maintainer or adapt the code as needed for your project.