BuyTap Countdown Shortcode

BidWave is a custom WordPress/PHP transaction and order-management system developed as a collection of WordPress plugins and shortcodes.

The project extends WordPress with custom order workflows, configurable plans, user dashboards, timed transaction windows, referral-reward reporting, administrative tools, and frontend account functionality.

Key Features

Order Management

• Custom WordPress order post type
• User order creation and tracking
• Administrative order creation
• Order status management
• Search and filtering by order ID
• Configurable plan durations and calculations
• Frontend order views
• WordPress REST and AJAX interactions

User Dashboard

Custom dashboard shortcodes provide user-specific information such as:

• transaction totals
• expenses
• calculated net values
• active orders
• pending orders
• completed orders
• order history

Timed Access and Countdown System

The project includes a configurable countdown shortcode that can:

• display scheduled countdown timers;
• open transaction forms at configured times;
• control how long forms remain available;
• use configurable time zones;
• integrate with Elementor-based forms.

Referral Reward System

The referral module provides functionality for:

• referral tracking
• reward history
• configurable reward values
• payout-status tracking
• referral summaries
• CSV export
• referred-user details
• administrative review and approval

Referral Validation

The project also includes controls designed to identify potentially invalid referral activity, including:

• duplicate M-Pesa-number detection
• self-referral checks
• device-related indicators
• registration metadata checks
• administrator review workflows
• fraud-reason indicators

These checks support administrative review and should not be considered a complete fraud-prevention system.

Tech Stack

Backend

• PHP
• WordPress
• WordPress Plugin API
• WordPress REST API
• WordPress AJAX

Frontend

• HTML
• CSS
• JavaScript
• WordPress Shortcodes
• Elementor integration

Data Management

• WordPress custom post types
• WordPress post metadata
• WordPress user metadata
• WordPress Options API

Main Components

The repository contains several custom modules.

Order System

Handles the primary order workflow, including:

• custom order records;
• user and administrator workflows;
• plan configuration;
• order-status changes;
• dashboard interfaces;
• frontend forms;
• REST/AJAX functionality.

Dashboard Totals

Provides reusable WordPress shortcodes for displaying user-specific financial and transaction summaries.

Countdown Shortcode

Provides configurable scheduled countdown functionality for controlling when selected frontend forms are displayed.

Referral Reward Reports

Provides referral reporting, reward tracking, administrative review, CSV exports, and referral-validation controls.

WordPress Integration

BidWave makes use of several WordPress development concepts, including:

• custom post types
• action hooks
• filter hooks
• shortcodes
• user metadata
• post metadata
• admin menus
• nonce-protected actions
• REST routes
• AJAX requests
• WordPress options
• frontend scripts

Repository Structure

The repository currently contains both active development files and earlier development iterations.

Example:

BidWave/
├── Logo/
├── buytap-countdown-shortcode.php
├── buytap-dashboard-totals.php
├── buytap-order-systemV6.php
├── buytap-referral-reward-reports-v5_2.php
└── legacy development versions

For production use, only reviewed and tested versions of each module should be installed.

Installation

This repository contains custom WordPress plugin modules.

Before installation:

1. Set up a WordPress development environment.
2. Review the relevant PHP module.
3. Confirm that it is the intended current version.
4. Back up the WordPress installation and database.
5. Test the module in a staging environment before production deployment.

A plugin module can then be placed in the appropriate WordPress plugin directory and activated according to the structure used by the deployment.

Security Considerations

This project handles user, order, referral, and transaction-related data.

Before production deployment:

• review authentication and authorization checks;
• validate and sanitize all incoming data;
• protect administrative actions with appropriate WordPress nonces;
• restrict sensitive REST and AJAX endpoints;
• avoid committing credentials or private customer data;
• keep WordPress and dependencies updated;
• test changes in a staging environment;
• perform an independent security review where appropriate.

No API keys, passwords, payment credentials, or production secrets should be committed to this repository.

Development Notes

The repository contains several historical versions of some modules because functionality evolved through multiple development iterations.

A future cleanup can consolidate the latest stable modules into a clearer plugin structure while preserving earlier versions in an archive for reference.

Project Focus

This project demonstrates experience with:

• custom WordPress plugin development
• PHP backend development
• WordPress hooks and filters
• REST and AJAX integrations
• custom administrative interfaces
• user-specific dashboards
• transaction workflow design
• referral management
• reporting and CSV exports
• metadata-based business logic
• iterative feature development
• Git and GitHub version control

Disclaimer

This repository is presented as a software-development and portfolio project. Any transaction, reward, plan, or financial logic should be independently reviewed for security, regulatory, operational, and business requirements before production use.

License

This project is maintained for development and portfolio purposes.