Dynamic Timeline Overview

The Dynamic Timeline widget displays content (such as blog posts or custom data) in a chronological timeline format, ideal for showing events, milestones, or updates.

You can pull content dynamically from posts, custom fields, or ACF (Advanced Custom Fields) sources.

General#

• Source: Determines where the timeline’s data comes from:

  • Custom – manually add timeline items.
  • Posts – automatically pull content from WordPress posts.
  • ACF Repeater – fetches items from a repeater field created in ACF.
  • ACF Relationship – displays related posts/items from an ACF relationship field.

• Layout

  • Horizontal – timeline flows left-to-right.
  • Vertical – timeline flows top-to-bottom.

• Card Arrow: Toggle to show or hide a small arrow pointer connecting the timeline marker to its content card.
• Show Dates: Toggle to display dates on the timeline markers or cards.
• Date Type: Determines how the date is shown:

  • Published Date – uses the post’s publish date.
  • Time Ago – shows a relative time format (e.g., "3 days ago").
  • Last Modified Date – displays the date the post was last updated.

• Date Format:

  • Default – uses the site’s date format settings.
  • Or choose a custom date format from the list.

• Animate Cards: Toggle to enable entry animations for the timeline cards when they appear on screen.

Source: ACF Repeater#

• ACF Repeater Field: Select which ACF Repeater field to use as the data source for the timeline.
• Field Location: Specifies where the ACF Repeater field is stored:

  • Current Post – pulls the repeater data from the currently displayed post.
  • Current User – pulls repeater data from a user profile field.
  • Current Term – retrieves repeater data from taxonomy term metadata.
  • Options Page – uses repeater data stored in a global ACF Options Page.

• Date: Select which subfield from the ACF Repeater should be used as the date source for the timeline. This subfield must contain a valid date or date/time value.

Items#

Source: Posts#

• Content: You can choose from a variety of dynamic content sources to display inside each post item:

  • Post Title – Displays the post's title.
  • Post Author – Shows the name of the post author.
  • Post Date – Displays the post's published date.
  • Post Excerpt – Shows a trimmed version of the post content.
  • Post Content – Displays the full content of the post.
  • Post Comments Count – Shows how many comments the post has.
  • Post Terms – Displays terms (e.g., categories, tags) related to the post.
  • Post Featured Image – Renders the post's featured image.
  • Post Custom Field – Displays the value of a custom meta field.
  • ACF Field – Pulls in data from an ACF (Advanced Custom Fields) field.
  • Pods Field – Displays data from a Pods framework field.
  • Button – Adds a custom button element (e.g., Read More, View Project).

• Image-Specific Options:

  • Image Resolution – Choose from predefined WordPress image sizes like thumbnail, medium, large, full, or any custom-registered sizes.
  • Custom Height – Optionally set a fixed height for the image (useful for uniform layout).
  • Fallback Image – Define a default image to display when a post doesn’t have a featured image.

• Link To: Choose where the image or element links:

  • None
  • Post URL – Links to the post's single page.
  • Custom Field URL – Use a dynamic URL from a custom field.

Source: ACF Repeater#

• ACF Repeater Sub Field: Select which subfield from the chosen ACF Repeater will populate this content element.
• Field Type: Determines how the subfield's value is interpreted.
• Link Field: Select which subfield from the ACF Repeater will populate the link.

Query#

The advanced query logic in the Dynamic Timeline enables you to filter posts by category, tags, author, or other criteria, providing granular control. You can find more details here.