Augustin Phiri

The Plugs

Shift Log Plugin - Technical Manual

Download SLP Legacy or SLP Modern 

*Use SLP Legacy as SLP Modern is still in works

A WordPress plugin for logging and managing staff shift requests with admin approval.

Features

  • Staff can submit shift requests from the frontend
  • Administrators can approve or reject shift requests
  • Calendar view of all shifts
  • Dashboard widget for quick access to shift submission
  • Admin bar menu for quick access to shift management
  • Download shift calendar in CSV, Excel, or PDF format

Installation

  1. Upload the staff-shift-log folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Create a page and add the shortcode [staff_shift_form] to display the shift submission form
  4. Create a page and add the shortcode [staff_shift_calendar] to display the calendar view

Calendar Download Feature

The plugin includes a feature to download the shift calendar in various formats (CSV, Excel, PDF). To use this feature, you need to install the required dependencies:

Option 1: Using Composer (Recommended)

  1. Make sure you have Composer installed on your server
  2. Navigate to the plugin directory: cd /path/to/wp-content/plugins/staff-shift-log
  3. Run: composer install

Option 2: Manual Installation

If you can’t use Composer, you can manually download and install the required libraries:

  1. Download PhpSpreadsheet and TCPDF
  2. Create a vendor directory in the plugin folder
  3. Extract the libraries into the vendor directory

Usage

For Staff

  1. Navigate to the page with the [staff_shift_form] shortcode
  2. Fill out the shift request form and submit
  3. View your shift requests on the calendar page

For Administrators

  1. Go to the WordPress admin area
  2. Navigate to “Staff Shifts” in the admin menu
  3. Approve or reject shift requests
  4. Use the “Download Calendar” feature to export the shift calendar

Shortcodes

  • [staff_shift_form] – Displays the shift submission form
  • [staff_shift_calendar] – Displays the calendar view of all shifts

Requirements

  • WordPress 5.8 or higher
  • PHP 7.4 or higher
  • MySQL 5.7 or higher

Cafe Specials Board Plugin - Technical Manual

Download as: CSB-Plugin (link to repo/zip)

Table of Contents

  1. System Requirements
  2. Installation
  3. Database Schema
  4. Shortcode & Elementor Reference
  5. Fullscreen Kiosk Setup

1. System Requirements

  • WordPress 6.0+
  • PHP 8.0+
  • MySQL 5.7+
  • Required Plugins:
    • Elementor (Free/Pro)
    • Advanced Custom Fields (ACF)

2. Installation

  1. Upload cafe-specials-board.zip via WordPress Admin → Plugins → Add New
  2. Activate Plugin → Custom tables auto-create

Database Schema:

CREATE TABLE wp_csb_specials (
  post_id BIGINT(20) PRIMARY KEY,
  price DECIMAL(10,2),
  availability ENUM('breakfast','lunch','dinner','all-day'),
  expiry_date DATE,
  is_featured TINYINT(1) DEFAULT 0,
  FOREIGN KEY (post_id) REFERENCES wp_posts(ID)
);

3. Shortcode & Elementor Reference

Shortcode/WidgetDescriptionParameters
[csb_specials]Displays all active specialstitle="Today's Specials"<br>featured_only="yes"
Elementor WidgetDrag-and-drop design interfaceCustomize via Elementor panel

4. Fullscreen Kiosk Setup

A. Template Setup

  1. Create a page → Select “Fullscreen Specials Board” template
  2. Add shortcode or Elementor widget

B. Hardware Configuration

Windows (Chrome Kiosk Mode):

chrome.exe --kiosk <http://yourcafe.com/specials-board> --disable-session-crashed-bubble

Raspberry Pi:

chromium-browser --kiosk --noerrdialogs --disable-infobars <http://yourcafe.com/specials-board>

C. Auto-Refresh (Optional)

Edit assets/js/script.js:

setInterval(() => location.reload(), 300000); // 5 minutes

5. Google Sheets Sync (Optional)

  1. Enable Google Sheets API via Google Cloud Console
  2. Configure in includes/google-sync.php:
define('GSHEETS_CLIENT_ID', 'YOUR_CLIENT_ID');
define('GSHEETS_API_KEY', 'YOUR_API_KEY');

Troubleshooting

IssueSolution
ACF fields missingEnsure ACF Pro is active
Fullscreen mode brokenCheck template assignment to page
Price formatting issuesVerify DECIMAL(10,2) in database

 

 

Powered By Milkwood