Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/dackzui/forklift-checker/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Forklift Checker Plugin
A WordPress plugin for tracking forklift equipment checks with multiple providers. Add check tasks for each provider and mark them as OK or Not OK with issue descriptions.
Features
- Multiple Equipment Providers: Add 2 or more different equipment providers
- Custom Check Tasks: Add specific tasks to check for each provider
- OK/Not OK Status: Mark each task as OK or Not OK
- Issue Descriptions: Required description field when marking items as Not OK
- Date-Based Tracking: Track checks by date
- User Tracking: Record who performed each check
- Frontend Shortcode: Display the checker on any page with Elementor or shortcodes
Installation
- Upload the
forklift-checkerfolder to/wp-content/plugins/ - Activate the plugin through the 'Plugins' menu in WordPress
- The database tables will be created automatically
Usage
Admin Setup (Administrators Only)
-
Add Equipment Providers
- Go to Forklift Checker → Providers
- Click "Add Provider" and enter provider name and description
- Click "Add Provider"
-
Add Check Tasks
- Go to Forklift Checker → Tasks
- Select a provider from the dropdown
- Add check tasks with names, descriptions, and display order
- Mark tasks as active/inactive
Performing Checks
Option 1: Admin Panel
- Go to Forklift Checker → Perform Check
- Select provider and date
- Mark each task as OK or Not OK
- Add issue descriptions for Not OK items
- Click "Save Check"
Option 2: Frontend Shortcode
- Use the shortcode on any page or post
- Users can perform checks directly from the frontend
Shortcodes
Basic Usage
[forklift_checker]
With Parameters
[forklift_checker provider_id="1" check_date="2024-01-15"]
Parameters
| Parameter | Default | Description |
|---|---|---|
provider_id |
0 | Pre-select a specific provider (0 = show selector) |
check_date |
Today | Pre-select a specific date (format: YYYY-MM-DD) |
show_provider_selector |
yes | Show/hide provider dropdown (yes/no) |
show_date_selector |
yes | Show/hide date picker (yes/no) |
Examples
Basic checker with selectors:
[forklift_checker]
Pre-selected provider and date:
[forklift_checker provider_id="1" check_date="2024-01-15"]
Fixed provider, show date selector:
[forklift_checker provider_id="1" show_provider_selector="no"]
Fixed date, show provider selector:
[forklift_checker check_date="2024-01-15" show_date_selector="no"]
Using in Elementor
- Add a Shortcode widget to your page
- Enter the shortcode:
[forklift_checker] - Or use parameters:
[forklift_checker provider_id="1"] - Publish the page
Users can now perform forklift checks directly from your Elementor page!
Requirements
- WordPress 5.0 or higher
- PHP 7.0 or higher
- Users must be logged in to perform checks
Support
For issues or questions, contact the plugin author.
Version: 1.0.0
Author: Marie Apellanes