DK Progress Bar Docs

DK Progress Bar displays a work-in-progress summary anywhere WordPress accepts a shortcode. If you still need help or would like to request a change, please email me.
Usage and Examples
Shortcode Attributes
Troubleshooting

Adding a progress bar

Add a Shortcode block to a post or page, or paste the shortcode into any field that processes WordPress shortcodes.

The smallest useful example sets only the percentage:

[dk_progress_bar bar_pct="65"]

A complete example can include an attachment image, descriptive text, colors, height, and style:

[dk_progress_bar img_id="123" title="New Novel" phase="First draft" bar_pct="65" goal_txt="58,000 of 90,000 words" bar_color="#7a3db8" bar_color2="#a97be0" bar_height="30" bar_style="animated" text_color="#222222"]

Each shortcode is configured independently, so a page can display several works in progress with different values and styling.

Available attributes

  • bar_pct: Completion percentage used as the filled width, limited to 0 through 100. Default: 0.
  • bar_color: Main bar color as a hexadecimal color value. Default: #FF0000.
  • bar_color2: Optional second color for striped and animated styles. When omitted, the plugin calculates a lighter color.
  • bar_height: Bar height from 1 through 500 pixels, entered without px. Default: 30.
  • bar_style: Use animated, striped, or solid. Default: animated.
  • img_id: Optional WordPress Media Library attachment ID. The full-size image appears above the title.
  • title: Optional title displayed above the phase and bar.
  • phase: Optional status text displayed above the bar, such as Editing or First draft.
  • goal_txt: Optional text displayed below the bar, such as a word-count goal.
  • text_color: Text color as a hexadecimal color value. Default: #000000.

Troubleshooting

  • If the shortcode is shown as text, confirm that it is placed in a Shortcode block or another shortcode-capable field.
  • If an image does not appear, verify that img_id is the numeric attachment ID from the WordPress Media Library.
  • If the bar is empty, verify that bar_pct contains the intended numeric percentage.
  • If DK Progress Bar cannot be activated, install and activate DK Base Plugin first.