Skip to content

TableCrafter/eventcrafter-visual-timeline

Repository files navigation

🚀 EventCrafter – Professional WordPress Timeline Plugin

WordPress Plugin Version WordPress Plugin Downloads WordPress Plugin Rating License: GPL v2

Create stunning timelines, roadmaps, and event histories for WordPress with our intuitive drag-drop Visual Builder. Perfect for project management, company milestones, and product launches.

⭐ Why Choose EventCrafter?

  • 🎯 Zero Learning Curve - Build professional timelines in under 5 minutes
  • 🎛 Gutenberg Block Support - Native block editor integration for modern WordPress
  • 📱 Mobile-First Design - Stunning display on all devices and screen sizes
  • 🎨 Unlimited Customization - Colors, spacing, fonts, and layout control
  • ⚡ Performance Optimized - Lightning-fast loading and SEO-friendly
  • ♿ Accessibility Ready - WCAG 2.1 compliant for inclusive design
  • 🔗 API Integration - Connect external data sources and JSON feeds

Test EventCrafter instantly in WordPress Playground - no installation required!

🎯 Perfect Use Cases

Use Case Description Ideal For
Project Roadmaps Visualize development milestones and feature releases SaaS companies, agencies, startups
Company History Showcase your journey and key achievements Corporate websites, about pages
Product Launches Create anticipation with launch timelines E-commerce, product marketing
Event Schedules Display conferences, webinars, workshops Event organizers, conferences
Process Documentation Step-by-step workflow visualization Documentation, tutorials
Portfolio Showcases Career progression and project timelines Personal branding, freelancers

🛠 Installation & Setup

WordPress Repository (Recommended)

# Install from WordPress admin
1. Go to Plugins → Add New
2. Search "EventCrafter"
3. Install & Activate

Manual Installation

1. Download from https://wordpress.org/plugins/eventcrafter-visual-timeline/
2. Upload to /wp-content/plugins/
3. Activate in WordPress admin

Quick Start

Method 1: Gutenberg Block (Recommended)

1. Create new post/page
2. Add EventCrafter Timeline block
3. Select timeline or enter JSON URL
4. Customize layout and settings

Method 2: Shortcode

// Basic usage
[eventcrafter id="123"]

// With custom styling
[eventcrafter id="123" layout="vertical"]

// From JSON source
[eventcrafter source="https://api.example.com/timeline.json"]

📸 Screenshots

View Screenshots
Feature Preview
Visual Builder Admin Interface
Timeline Display Frontend Timeline
Mobile Responsive Mobile View
Customization Color Options

🔧 Advanced Features

JSON API Integration

// Load timeline data from any API
fetch('https://your-api.com/timeline')
  .then(response => response.json())
  .then(data => {
    // EventCrafter automatically formats your data
  });

Custom Styling

/* Customize timeline appearance */
.eventcrafter-timeline {
  /* Your custom styles */
}

WordPress Hooks

// Modify timeline data before display
add_filter('eventcrafter_timeline_data', function($data) {
    // Your customizations
    return $data;
});

// Modify individual events
add_filter('eventcrafter_single_event_data', function($event, $index) {
    // Your event customizations
    return $event;
}, 10, 2);

// Add custom CSS classes
add_filter('eventcrafter_wrapper_classes', function($classes) {
    $classes[] = 'my-custom-class';
    return $classes;
});

JSON Data Schema

{
  "events": [
    {
      "date": "2025 Q1",
      "title": "Product Launch",
      "description": "HTML supported description of the event.",
      "color": "#3b82f6",
      "category": "Milestone",
      "link": {
        "url": "https://example.com",
        "text": "Read Case Study",
        "target": "_blank"
      }
    }
  ]
}

📈 SEO & Performance

  • Semantic HTML for better search engine indexing
  • Schema.org markup for rich snippets
  • Optimized loading with lazy loading and caching
  • Core Web Vitals optimized for Google rankings

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines.

Development Setup

git clone https://github.com/TableCrafter/eventcrafter-visual-timeline.git
cd eventcrafter-visual-timeline
npm install
npm run dev

Testing

# Run PHP tests
composer install
composer test

# Run accessibility tests  
npm run test:accessibility

📄 License

GPL v2 or later - see LICENSE file.

🌟 Support EventCrafter


Created by Fahad Murtaza | Part of the TableCrafter Suite

About

EventCrafter – Responsive Timelines, Roadmaps & Events Builder

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors