Display a package's version history in a beautiful, interactive timeline format.

Overview

The [wpdm_changelog] shortcode renders the changelog/version history of a download package. It displays each version entry in a modern timeline UI with collapsible sections, making it easy for users to browse through release notes and update history.

Basic Usage

[wpdm_changelog id="123"]

Replace 123 with your package ID.

Parameters

Examples

Basic Changelog

Display all changelog entries for package ID 123:

[wpdm_changelog id="123"]

Custom Title

Use a custom header title:

[wpdm_changelog id="123" title="Version History"]

Hide Title

Remove the header title completely:

[wpdm_changelog id="123" title=""]

Show All Entries Expanded

Display all entries in expanded state (not collapsed):

[wpdm_changelog id="123" collapsed="false"]

Limit Entries

Show only the latest 5 entries:

[wpdm_changelog id="123" limit="5"]

Show Empty State Message

Display a message when no changelog exists:

[wpdm_changelog id="123" show_empty="true"]

This will show "No changelog available." if the package has no changelog entries.

Combined Parameters

Use multiple parameters together:

[wpdm_changelog id="456" title="What's New" limit="5" collapsed="false" show_empty="true"]

Visual Features

Timeline Design

• Dot indicator: Each version has a dot on the timeline
• Latest badge: The most recent version shows a "Latest" badge with a pulsing green dot
• Connecting line: A gradient line connects all versions

Interactive Elements

• Collapsible cards: Click the header to expand/collapse each entry
• Hover effects: Cards lift with shadow on hover
• Smooth transitions: All animations are smooth and subtle

Content Formatting

The changelog body supports rich HTML content including:

• Bold and italic text
• Bullet lists and numbered lists
• Links
• Code snippets
• Paragraphs

PHP Function Usage

You can also call the changelog method directly in PHP:

// Using the package controller
$controller = new \WPDM\Package\PackageController($package_id);
echo $controller->changelog($package_id, [
    'title'      => 'Changelog',
    'show_empty' => false,
    'limit'      => 0,
    'collapsed'  => true,
]);

// Or using the static method
echo \WPDM\Package\PackageController::getChangelog($package_id, $args);

// Or using the WPDM global object
echo WPDM()->package->changelog($package_id, $args);

Adding Changelog Entries

Changelog entries are added through the WordPress admin:

1. Go to Downloads > All Files
2. Edit the package you want to add a changelog to
3. Scroll down to the Changelog metabox
4. Click Add New Entry
5. Fill in:
   • Version: The version number (e.g., "2.0.0")
   • Date: Release date
   • Changes: Description of changes (supports formatting)
6. Click Save or Update the package

Responsive Design

The changelog is fully responsive:

• Desktop: Full timeline with cards
• Tablet: Slightly reduced spacing
• Mobile (< 640px):
  • Smaller timeline dots
  • Reduced padding
  • Smaller font sizes
  • Wrapped meta information