WordPress.org
Get WordPress

Plugin Directory

Changeset 3448742


Ignore:
Timestamp:
01/28/2026 01:27:30 PM (2 months ago)
Author:
fahdi
Message:

Release 1.2.0: Added Gutenberg block support, updated assets (banner/icon), and synced with Git.

Location:
eventcrafter-visual-timeline
Files:
8 added
3 edited

Legend:

Unmodified
Added
Removed

  • eventcrafter-visual-timeline/trunk/README.md

    r3448658 r3448742  
    1 # EventCrafter – Responsive Timelines & Roadmaps
     1# 🚀 EventCrafter – Professional WordPress Timeline Plugin
    22
    3 **Create beautiful vertical timelines, product roadmaps, and event history.**
     3[![WordPress Plugin Version](https://img.shields.io/wordpress/plugin/v/eventcrafter-visual-timeline.svg)](https://wordpress.org/plugins/eventcrafter-visual-timeline/)
     4[![WordPress Plugin Downloads](https://img.shields.io/wordpress/plugin/dt/eventcrafter-visual-timeline.svg)](https://wordpress.org/plugins/eventcrafter-visual-timeline/)
     5[![WordPress Plugin Rating](https://img.shields.io/wordpress/plugin/r/eventcrafter-visual-timeline.svg)](https://wordpress.org/plugins/eventcrafter-visual-timeline/)
     6[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/gpl-2.0.html)
    47
    5 ![Version](https://img.shields.io/badge/version-1.1.2-blue.svg) ![License](https://img.shields.io/badge/license-GPLv2-green.svg)
     8Create stunning **timelines**, **roadmaps**, and **event histories** for WordPress with our intuitive drag-drop Visual Builder. Perfect for project management, company milestones, and product launches.
    69
    7 EventCrafter is a powerful tool designed for content editors and site owners. It transforms your events into professional vertical timeline visualizations using a simple drag-and-drop Visual Builder. No technical knowledge required.
     10## ⭐ Why Choose EventCrafter?
    811
    9 ## 🚀 Key Features
     12- **🎯 Zero Learning Curve** - Build professional timelines in under 5 minutes
     13- **🎛 Gutenberg Block Support** - Native block editor integration for modern WordPress
     14- **📱 Mobile-First Design** - Stunning display on all devices and screen sizes 
     15- **🎨 Unlimited Customization** - Colors, spacing, fonts, and layout control
     16- **⚡ Performance Optimized** - Lightning-fast loading and SEO-friendly
     17- **♿ Accessibility Ready** - WCAG 2.1 compliant for inclusive design
     18- **🔗 API Integration** - Connect external data sources and JSON feeds
    1019
    11 *   **👑 Visual Builder First**: Create stunning timelines using our drag-and-drop editor. No code required.
    12 *   **📱 Fully Responsive**: Vertical layouts that look great on mobile, tablet, and desktop.
    13 *   **🎨 Customization**: Control colors and styles visually.
    14 *   **👨‍💻 Developer Friendly**: Extensive hooks, filters, and optional JSON support for deep customization.
     20## 🚀 [Try Live Demo](https://tastewp.com/new?ni=true&origin=wp&redirect=admin.php?page=edit.php?post_type=eventcrafter_tl&pre-installed-plugin-slug=eventcrafter-visual-timeline&mu=false)
    1521
    16 ## 📦 Installation
     22Test EventCrafter instantly in WordPress Playground - no installation required!
    1723
    18 1.  Download the plugin zip file.
    19 2.  Upload to your WordPress site via **Plugins > Add New > Upload Plugin**.
    20 3.  Activate **EventCrafter Visual Timeline**.
    21 4.  Navigate to **Timelines** in the admin menu.
     24## 🎯 Perfect Use Cases
    2225
    23 ## 🛠 Usage
     26| Use Case | Description | Ideal For |
     27|----------|-------------|-----------|
     28| **Project Roadmaps** | Visualize development milestones and feature releases | SaaS companies, agencies, startups |
     29| **Company History** | Showcase your journey and key achievements | Corporate websites, about pages |
     30| **Product Launches** | Create anticipation with launch timelines | E-commerce, product marketing |
     31| **Event Schedules** | Display conferences, webinars, workshops | Event organizers, conferences |
     32| **Process Documentation** | Step-by-step workflow visualization | Documentation, tutorials |
     33| **Portfolio Showcases** | Career progression and project timelines | Personal branding, freelancers |
    2434
    25 ### 1. Visual Builder (Recommended)
    26 The easiest way to build a roadmap or history timeline.
    27 1.  Go to **Timelines > Add New**.
    28 2.  Use the **Visual Builder** to add events.
    29 3.  Drag and drop to reorder.
    30 4.  Copy the shortcode from the top bar: `[eventcrafter id="123"]`.
     35## 🛠 Installation & Setup
    3136
    32 ### 2. Advanced: Remote JSON
    33 For developers or dynamic data needs, you can power a timeline via JSON URL:
    34 ```shortcode
    35 [eventcrafter source="https://api.example.com/roadmap.json"]
     37### WordPress Repository (Recommended)
     38```bash
     39# Install from WordPress admin
     401. Go to Plugins → Add New
     412. Search "EventCrafter"
     423. Install & Activate
    3643```
    3744
    38 ## 👨‍💻 Developer Hooks
     45### Manual Installation
     46```bash
     471. Download from https://wordpress.org/plugins/eventcrafter-visual-timeline/
     482. Upload to /wp-content/plugins/
     493. Activate in WordPress admin
     50```
    3951
    40 EventCrafter is built to be extended.
     52### Quick Start
    4153
    42 ### Filters
    43 *   `eventcrafter_timeline_data` `(array $data, string $source)`: Modify the entire timeline data array before rendering.
    44 *   `eventcrafter_single_event_data` `(array $event, int $index)`: Modify individual event data just before rendering.
    45 *   `eventcrafter_wrapper_classes` `(array $classes)`: Add or remove CSS classes from the timeline wrapper.
     54**Method 1: Gutenberg Block (Recommended)**
     55```
     561. Create new post/page
     572. Add EventCrafter Timeline block
     583. Select timeline or enter JSON URL
     594. Customize layout and settings
     60```
     61
     62**Method 2: Shortcode**
     63```php
     64// Basic usage
     65[eventcrafter id="123"]
     66
     67// With custom styling
     68[eventcrafter id="123" layout="vertical"]
     69
     70// From JSON source
     71[eventcrafter source="https://api.example.com/timeline.json"]
     72```
     73
     74## 📸 Screenshots
     75
     76<details>
     77<summary>View Screenshots</summary>
     78
     79| Feature | Preview |
     80|---------|---------|
     81| **Visual Builder** | ![Admin Interface](screenshot-1.png) |
     82| **Timeline Display** | ![Frontend Timeline](screenshot-2.png) |
     83| **Mobile Responsive** | ![Mobile View](screenshot-3.png) |
     84| **Customization** | ![Color Options](screenshot-4.png) |
     85
     86</details>
     87
     88## 🔧 Advanced Features
     89
     90### JSON API Integration
     91```javascript
     92// Load timeline data from any API
     93fetch('https://your-api.com/timeline')
     94  .then(response => response.json())
     95  .then(data => {
     96    // EventCrafter automatically formats your data
     97  });
     98```
     99
     100### Custom Styling
     101```css
     102/* Customize timeline appearance */
     103.eventcrafter-timeline {
     104  /* Your custom styles */
     105}
     106```
     107
     108### WordPress Hooks
     109```php
     110// Modify timeline data before display
     111add_filter('eventcrafter_timeline_data', function($data) {
     112    // Your customizations
     113    return $data;
     114});
     115
     116// Modify individual events
     117add_filter('eventcrafter_single_event_data', function($event, $index) {
     118    // Your event customizations
     119    return $event;
     120}, 10, 2);
     121
     122// Add custom CSS classes
     123add_filter('eventcrafter_wrapper_classes', function($classes) {
     124    $classes[] = 'my-custom-class';
     125    return $classes;
     126});
     127```
    46128
    47129### JSON Data Schema
    48 If you are loading data from an external API, your JSON should follow this structure:
    49 
    50130```json
    51131{
    … …  
    67147```
    68148
    69 ### Development
    70 EventCrafter is built with TDD principles.
     149## 📈 SEO & Performance
     150
     151- ✅ **Semantic HTML** for better search engine indexing
     152- ✅ **Schema.org markup** for rich snippets
     153- ✅ **Optimized loading** with lazy loading and caching
     154- ✅ **Core Web Vitals** optimized for Google rankings
     155
     156## 🤝 Contributing
     157
     158We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md).
     159
     160### Development Setup
    71161```bash
     162git clone https://github.com/TableCrafter/eventcrafter-visual-timeline.git
     163cd eventcrafter-visual-timeline
     164npm install
     165npm run dev
     166```
     167
     168### Testing
     169```bash
     170# Run PHP tests
    72171composer install
    73172composer test
     173
     174# Run accessibility tests 
     175npm run test:accessibility
    74176```
     177
     178## 📄 License
     179
     180GPL v2 or later - see [LICENSE](LICENSE) file.
     181
     182## 🌟 Support EventCrafter
     183
     184- ⭐ [Rate us on WordPress.org](https://wordpress.org/plugins/eventcrafter-visual-timeline/)
     185- 🐛 [Report issues on GitHub](https://github.com/TableCrafter/eventcrafter-visual-timeline/issues)
     186- 💬 [Get support on WordPress.org](https://wordpress.org/support/plugin/eventcrafter-visual-timeline/)
     187
     188---
     189
     190**Created by [Fahad Murtaza](https://github.com/fahdi)** | **Part of the [TableCrafter Suite](https://github.com/TableCrafter)**

  • eventcrafter-visual-timeline/trunk/eventcrafter.php

    r3448658 r3448742  
    44 * Plugin URI: https://github.com/TableCrafter/eventcrafter-visual-timeline
    55 * Description: Create beautiful vertical timelines, product roadmaps, and event history. Manage your events using the intuitive Visual Builder.
    6  * Version: 1.1.7
     6 * Version: 1.2.0
    77 * Author: Fahad Murtaza
    88 * Author URI: https://github.com/fahdi
    … …  
    1919 */
    2020if (!defined('EVENTCRAFTER_VERSION')) {
    21     define('EVENTCRAFTER_VERSION', '1.1.7');
     21    define('EVENTCRAFTER_VERSION', '1.2.0');
    2222}
    2323if (!defined('EVENTCRAFTER_URL')) {
    … …  
    4747        $this->load_dependencies();
    4848        add_action('wp_enqueue_scripts', array($this, 'enqueue_assets'));
     49        add_action('init', array($this, 'register_blocks'));
    4950        add_shortcode('eventcrafter', array($this, 'render_shortcode'));
    5051    }
    … …  
    104105        $renderer = new EventCrafter_Renderer();
    105106        return $renderer->render($source, $atts['layout']);
     107    }
     108
     109    public function register_blocks()
     110    {
     111        register_block_type(
     112            EVENTCRAFTER_PATH . 'blocks/eventcrafter-timeline',
     113            array(
     114                'render_callback' => array($this, 'render_block'),
     115            )
     116        );
     117    }
     118
     119    public function render_block($attributes, $content, $block)
     120    {
     121        $atts = array(
     122            'id' => isset($attributes['timelineId']) ? $attributes['timelineId'] : '',
     123            'source' => isset($attributes['sourceUrl']) ? $attributes['sourceUrl'] : '',
     124            'layout' => isset($attributes['layout']) ? $attributes['layout'] : 'vertical',
     125            'limit' => isset($attributes['limit']) ? $attributes['limit'] : -1
     126        );
     127
     128        return $this->render_shortcode($atts);
    106129    }
    107130}

  • eventcrafter-visual-timeline/trunk/readme.txt

    r3448662 r3448742  
    11=== EventCrafter – Responsive Timelines, Roadmaps & Events Builder ===
    22Contributors: fahdi
    3 Tags: timeline, roadmap, events, visual-builder, project-timeline
     3Tags: timeline, json, roadmap, history, events
    44Requires at least: 5.0
    55Tested up to: 6.9
    6 Stable tag: 1.1.7
     6Stable tag: 1.2.0
    77Requires PHP: 7.4
    88License: GPLv2 or later
    99License URI: https://www.gnu.org/licenses/gpl-2.0.html
    1010
    11 🚀 Create stunning timelines, roadmaps & event histories with drag-drop Visual Builder. Perfect for project management, company milestones & product launches.
     11Create beautiful vertical timelines, product roadmaps, and event history. Manage your events using the intuitive Visual Builder.
    1212
    1313== Description ==
    1414
    15 **EventCrafter** is the most intuitive WordPress timeline plugin for creating professional timeline visualizations. Whether you're showcasing company history, project roadmaps, or event schedules, EventCrafter delivers pixel-perfect timelines that engage your audience.
     15**EventCrafter** is a powerful tool to create professional timeline visualizations. Unlike other timeline plugins that are bloated or difficult to use, EventCrafter offers a streamlined Visual Builder for effortless content management.
    1616
    17 **🎯 Perfect For:**
    18 *   **Project Roadmaps** - Visualize development milestones and feature releases
    19 *   **Company History** - Showcase your journey and key achievements 
    20 *   **Product Launches** - Create anticipation with launch timelines
    21 *   **Event Schedules** - Display conferences, webinars, and workshops
    22 *   **Process Documentation** - Step-by-step workflow visualization
    23 *   **Portfolio Showcases** - Career progression and project timelines
     17Perfect for:
    2418
    25 **⭐ Why 1000+ Users Choose EventCrafter:**
    26 *   **👑 Drag-Drop Visual Builder:** No coding required - build timelines in minutes
    27 *   **📱 Mobile-First Design:** Perfect display on all devices and screen sizes
    28 *   **🎨 Unlimited Customization:** Colors, spacing, and styling options
    29 *   **⚡ Lightning Fast:** Optimized for performance and SEO
    30 *   **🔗 API Integration:** Connect external data sources and JSON feeds
    31 *   **♿ Accessibility Ready:** WCAG 2.1 compliant for inclusive design
     19*   Project Roadmaps
     20*   Company History / Milestones
     21*   Event Schedules
     22*   Changelogs
    3223
    33 **🚀 Try it Live:** [Test EventCrafter in WordPress Playground](https://playground.wordpress.net/scope:ambitious-modern-city/sample-page/) - No installation needed!
     24**Why EventCrafter?**
     25
     26**🚀 Try it Live:** [Test EventCrafter in WordPress Playground](https://tastewp.com/new?ni=true&origin=wp&redirect=admin.php?page=edit.php?post_type=eventcrafter_tl&pre-installed-plugin-slug=eventcrafter-visual-timeline&mu=false) - No installation needed!
     27
     28*   **👑 Visual Builder:** The easiest way to build timelines. Drag, drop, done.
     29*   **🎯 Gutenberg Block:** Native block editor support for modern WordPress workflow.
     30*   **📱 Fully Responsive:** Adapts to any screen size automatically.
     31*   **🎨 Easy Customization:** Control colors directly in the editor.
     32*   **⚙️ Advanced JSON:** Load data from external APIs if you need to.
    3433
    3534== Installation ==
    … …  
    37361. Upload the `eventcrafter-visual-timeline` folder to the `/wp-content/plugins/` directory.
    38372. Activate the plugin through the 'Plugins' menu in WordPress.
    39 3. Use the shortcode `[eventcrafter id="123"]` (or `source="URL"`) in any post or page.
     383. Create timelines using the Visual Builder, then use the Gutenberg block or shortcode `[eventcrafter id="123"]` to display them.
    4039
    4140== Frequently Asked Questions ==
    4241
    43 = How easy is it to create a timeline? =
    44 Extremely easy! Our Visual Builder lets you create professional timelines in under 5 minutes. Simply add events, customize colors, and publish with a shortcode.
     42= Is it responsive? =
    4543
    46 = Is EventCrafter mobile responsive? =
    47 Absolutely! EventCrafter uses a mobile-first design approach. Your timelines look stunning on smartphones, tablets, and desktops with automatic responsive adjustments.
     44Yes! The specific vertical layout is designed to work perfectly on mobile devices, tablets, and desktops automatically.
    4845
    49 = Can I customize the appearance? =
    50 Yes! EventCrafter offers unlimited customization options including colors, spacing, fonts, and layout styles. Each event can have its own unique color and styling.
     46= How do I modify colors? =
    5147
    52 = Does it work with my theme? =
    53 EventCrafter is designed to work seamlessly with any WordPress theme. The clean, modern design adapts to your site's existing styling automatically.
    54 
    55 = Can I import data from external sources? =
    56 Yes! EventCrafter supports JSON data imports from APIs, spreadsheets, and external databases. Perfect for dynamic content that updates automatically.
    57 
    58 = Is it SEO optimized? =
    59 Definitely! EventCrafter generates clean, semantic HTML that search engines love. Your timelines will help improve your site's SEO performance.
    60 
    61 = Do you offer support? =
    62 We provide comprehensive support through WordPress.org forums. Premium support and custom development services are available for enterprise users.
     48You can set specific colors for each event directly within the Visual Builder.
    6349
    6450== Screenshots ==
    6551
    66 1. **Drag-Drop Visual Builder** - Create timelines in minutes with our intuitive admin interface
    67 2. **Beautiful Vertical Timeline** - Clean, modern design that engages your audience
    68 3. **Mobile-Responsive Design** - Perfect display across all devices and screen sizes
    69 4. **Customization Options** - Unlimited colors, styling, and layout possibilities
    70 5. **Live Frontend Display** - See how your timeline looks to visitors
    71 6. **Shortcode Integration** - Easy embedding in posts, pages, and widgets
     521. **Visual Builder** - Easily manage events in the WordPress Admin.
     532. **Vertical Timeline** - A clean, modern vertical representation of your events.
    7254
    7355== Changelog ==
     56
     57= 1.2.0 =
     58* **Feature**: Added Gutenberg block editor support for modern block-based editing
     59* **Enhancement**: Improved WordPress 6.x compatibility with native block registration
     60* **Feature**: Block includes intuitive timeline selector and external JSON source support
     61* **Enhancement**: Added block alignment support (wide/full width) for better theme integration
    7462
    7563= 1.1.7 =
    … …  
    118106= 1.0.0 =
    119107* Initial release.
    120 
Note: See TracChangeset for help on using the changeset viewer.