Warranty Registration Premium

# Streamline Warranty Management with Warranty Registration

**Warranty Registration** is a powerful yet simple warranty management plugin for WordPress designed specifically for repair shops, electronics retailers, and service businesses that need to track device warranties and repairs efficiently.

Built with both customers and staff in mind, this plugin provides a complete frontend-to-backend warranty tracking system with spam protection, email notifications, and optional REST API for mobile app integration.

—

## 🎯 **Why Choose Warranty Registration?**

✅ **Customer Self-Service** – Customers register warranties via frontend forms
✅ **Honeypot Protection** – Silent spam prevention, no API keys needed
✅ **Email Notifications** – Automated emails for submissions and status updates
✅ **Mobile-Ready REST API** – Build mobile apps with Pro version (FlutterFlow ready)
✅ **Audit Trail** – Complete change logging (Pro)
✅ **CSV Import/Export** – Bulk operations and data migration
✅ **Easy Setup** – Install, add shortcode, start collecting warranties

—

## 📦 **Two Versions to Fit Your Needs**

### **FREE VERSION** – Essential Warranty Management
– ✅ **Frontend Registration Form** – Customers submit warranties with `

Name:

Phone:

Email:

Device Repaired:

Repairs Completed:

Repair Date:
Must be within the last 30 days.
Receipt Code:
⚠️ Receipt code is case sensitive.

Submit Warranty

` shortcode
– ✅ **Admin Dashboard** – Manage all warranties with filtering and search
– ✅ **Status Management** – Track as Pending, Valid, or Invalid
– ✅ **Honeypot Bot Protection** – Silent spam prevention without impacting users (no API keys!)
– ✅ **Email Notifications** – Automated emails for:
– New warranty submissions
– Status changes (Pending → Valid/Invalid)
– Customer receipt with warranty details
– ✅ **Public Notes System** – Add notes visible to customers
– ✅ **CSV Export** – Export warranty data for analysis
– ✅ **Custom Support Manager Role** – Dedicated WordPress role for warranty staff
– ✅ **Mobile Responsive** – Works perfectly on all devices
– ✅ **Search Functionality** – `

Enter Receipt Code:
Search

` shortcode for customers
– ✅ **Warranty Lookup** – `

No warranty ID provided.

` shortcode to display details
– ✅ **CSRF Protection** – WordPress nonces on all forms
– ✅ **Secure Data Handling** – Sanitization and escaping throughout

### **PRO VERSION** – Enterprise Features
Everything in Free, plus:

#### REST API Integration
– 🔌 **6 Professional Endpoints** – Full CRUD operations
– `GET /wp-json/warranty/v1/records` – List all warranties
– `GET /wp-json/warranty/v1/records/{id}` – Get single warranty
– `POST /wp-json/warranty/v1/records` – Create warranty
– `PUT /wp-json/warranty/v1/records/{id}` – Update warranty
– `DELETE /wp-json/warranty/v1/records/{id}` – Delete warranty
– `GET /wp-json/warranty/v1/search? receipt_code={code}` – Search warranties
– 🔐 **Secure API Authentication** – API key system
– 📱 **FlutterFlow Ready** – Build mobile apps instantly
– 📚 **Complete API Documentation** – Built into WordPress admin

#### Advanced Management Features
– 📝 **Private Notes** – Internal staff notes NOT visible to customers
– 📊 **Change Logging** – Complete audit trail:
– Who made changes
– What changed (before/after values)
– When changes occurred
– Change type (status update, edit, deletion)
– Full JSON details
– 📤 **CSV Import** – Bulk import warranties from spreadsheets
– ⚡ **Bulk Operations** – Mass status updates and deletions
– 🤖 **reCAPTCHA v3** – Advanced spam protection (in addition to honeypot)
– 📷 **Invalidation Photos** – Upload proof images when marking warranties invalid
– 🔍 **Advanced Filtering** – Multiple search parameters:
– Customer name
– Email address
– Phone number
– Device type
– Receipt code
– Status
– Date range

#### Professional License Management
– ✨ **Automatic Updates** – Via APS Software Manager
– 🔑 **One-Click Activation** – Simple license management
– 🎯 **Real-Time Updates** – Webhook-based license validation
– ⚡ **Zero Performance Impact** – Cached license status
– 📋 **Manual Update Check** – Check for updates anytime
– 📝 **Changelog Display** – See what’s new before updating

#### Priority Support
– 📧 **Direct Developer Access** – Email support@avoyellesphoneshop. com
– ⏱️ **Faster Response Times** – 24-48 hour response
– 🎫 **Support Ticket System** – Dedicated support portal
– 🛠️ **Implementation Assistance** – Help with setup and integration

—

## 💼 **Perfect For:**

– 📱 **Phone Repair Shops** – Track screen repairs, battery replacements, device warranties
– 💻 **Computer Repair Services** – Manage laptop/desktop repairs and warranties
– 🎮 **Electronics Retailers** – Track product warranties for customers
– 🔧 **Device Repair Tracking** – Any repair business needing warranty management
– 🏪 **Service Warranty Management** – Extended warranties and service contracts
– 📲 **Shops with Mobile Apps** – Integrate with custom mobile apps (Pro)

—

## ⚡ **Core Features**

### 📝 **Frontend Warranty Registration**

Customers register warranties easily:

**Form Fields:**
– Customer Name
– Email Address
– Phone Number
– Device Information
– Device Serial Number (optional)
– Receipt Code/Number
– Purchase Date
– Additional Notes

**`

Name:

Phone:

Email:

Device Repaired:

Repairs Completed:

Repair Date:
Must be within the last 30 days.
Receipt Code:
⚠️ Receipt code is case sensitive.

Submit Warranty

`** Shortcode Features:
– Clean, mobile-responsive design
– Honeypot spam protection (invisible to users)
– Real-time validation
– Automatic email confirmation
– Receipt code generation
– reCAPTCHA v3 (Pro only)

—

### 🛡️ **Honeypot Bot Protection**

Silent spam prevention that works:

– ✅ **No API Keys Required** – Works out of the box
– ✅ **Invisible to Users** – No CAPTCHA challenges
– ✅ **Highly Effective** – Catches 99% of spam bots
– ✅ **Zero Friction** – Doesn’t slow down real customers
– ✅ **Configurable** – Enable/disable in settings

**How it Works:**
Hidden field that humans can’t see. Bots typically fill all fields, triggering silent rejection. No impact on legitimate customers!

—

### 📧 **Email Notifications**

Keep customers and staff informed:

#### Customer Emails:
– **Warranty Registered** – Confirmation with warranty details
– **Status Changed** – When status updates to Valid or Invalid
– **Includes:** Receipt code, device details, status, notes

#### Admin Emails:
– **New Warranty Submitted** – Instant notification of new submissions
– **Configurable Recipients** – Send to multiple staff emails

**Customization Options:**
– From name and email address
– Email footer text
– Professional HTML templates

—

### 🔍 **Search & Lookup**

Help customers find their warranties:

**`

Enter Receipt Code:
Search

`** – Search Box Shortcode
– Customers enter receipt code
– Displays matching warranty details
– Mobile-responsive results
– View status, notes, device info

**`

No warranty ID provided.

`** – Warranty Details Page
– Display full warranty information
– Requires `? warranty_id=X` parameter
– Shows all notes and status history
– Professional layout

**Admin Search:**
– Search by name, email, phone, device, receipt code
– Filter by status (Pending, Valid, Invalid)
– Date range filtering
– Quick access to warranty details

—

### 📊 **Admin Dashboard**

Comprehensive warranty management:

**Features:**
– List all warranties with pagination
– Filter by status tabs (All, Pending, Valid, Invalid)
– Quick actions (View, Edit, Delete)
– Modal popups for fast viewing
– Status change tracking
– Notes management (public and private in Pro)
– Bulk operations (Pro only)

**Warranty Details Modal:**
“`
Customer: John Doe
Email: john@example.com
Phone: (555) 123-4567
Device: iPhone 12 Pro
Receipt: WR-A3K9X2
Status: Valid ✅
Purchase Date: 2024-01-15
Notes: Screen replaced, 90-day warranty

[Public Notes] [Private Notes (Pro)]
[Change Log (Pro)]
“`

—

### 📤 **CSV Export & Import**

Manage data in bulk:

#### CSV Export (Free & Pro):
– Export all warranty records
– Includes all fields:
– Customer information
– Device details
– Status and dates
– Notes
– Excel-compatible format
– Use for reporting, analysis, backup

#### CSV Import (Pro Only):
– Bulk import warranties from spreadsheets
– Sample template provided
– Map columns to fields
– Validation and error checking
– Perfect for:
– Migrating from other systems
– Bulk data entry
– Importing historical records

—

## 🔌 **REST API** *(Pro Only)*

Build custom integrations and mobile apps:

### API Features:
– **Full CRUD Operations** – Create, Read, Update, Delete
– **Secure Authentication** – API key system
– **JSON Responses** – Standard REST format
– **Pagination Support** – Handle large datasets
– **Error Handling** – Detailed error messages
– **FlutterFlow Compatible** – Ready for mobile app development

### Use Cases:
– 📱 **Mobile Apps** – iOS/Android warranty registration apps
– 🖥️ **Custom Dashboards** – External reporting tools
– 🔗 **Third-Party Integration** – Connect to CRM, ERP systems
– 📊 **Data Analytics** – Feed data to BI tools
– 🤖 **Automation** – Automated warranty creation from other systems

### API Example:
“`http
POST /wp-json/warranty/v1/records
Authorization: Bearer YOUR_API_KEY

{
“customer_name”: “Jane Smith”,
“customer_email”: “jane@example. com”,
“customer_phone”: “555-123-4567”,
“device_info”: “Samsung Galaxy S21”,
“receipt_code”: “WR-B7K2M9”,
“status”: “pending”
}

Response:
{
“success”: true,
“warranty_id”: 123,
“receipt_code”: “WR-B7K2M9”,
“message”: “Warranty created successfully”
}
“`

**Complete API Documentation:** Available in WordPress Admin → Warranties → API Docs (Pro)

—

## 📝 **Notes System**

Communicate with customers and staff:

### Public Notes (Free & Pro):
– ✅ Visible to customers
– ✅ Display in warranty lookups
– ✅ Included in email notifications
– ✅ Track repair progress
– ✅ Timestamped

### Private Notes (Pro Only):
– 🔒 **Staff-Only** – Never visible to customers
– 🔒 **Internal Communication** – Team collaboration
– 🔒 **Sensitive Information** – Store private details
– 🔒 **Complete History** – All notes preserved
– 🔒 **User Attribution** – Track who added notes

—

## 📊 **Change Logging & Audit Trail** *(Pro Only)*

Complete accountability:

**Track Everything:**
– Status changes (Pending → Valid/Invalid)
– Field updates (customer info, device details)
– Note additions (public and private)
– Deletions and restorations
– User who made changes
– Exact timestamp
– Before/after values (JSON format)

**Audit Log Details:**
“`
Change Log:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[2024-01-15 10:30 AM] – Admin User
Action: Status Change
From: Pending
To: Valid
Reason: Verified receipt and device

[2024-01-15 10:32 AM] – Tech Support
Action: Private Note Added
Note: “Customer called, device ready for pickup”

[2024-01-16 02:15 PM] – Manager
Action: Field Update
Changed: Phone Number
From: 555-123-4567
To: 555-987-6543
“`

**Perfect for:**
– Quality assurance
– Compliance requirements
– Dispute resolution
– Staff accountability
– Performance tracking

—

## 🔒 **Security Features**

Enterprise-grade security:

– ✅ **Honeypot Protection** – Silent bot prevention
– ✅ **reCAPTCHA v3** – Advanced spam protection (Pro)
– ✅ **CSRF Protection** – WordPress nonces on all forms
– ✅ **Input Sanitization** – All data cleaned before storage
– ✅ **Output Escaping** – XSS attack prevention
– ✅ **Authorization Checks** – Capability verification
– ✅ **Secure API** – API key authentication (Pro)
– ✅ **SQL Injection Prevention** – Prepared statements
– ✅ **License Validation** – Webhook-based validation (Pro)

—

## 📋 **Technical Specifications**

| Requirement | Details |
|————-|———|
| **WordPress** | 5.0 or higher (tested up to 6.4) |
| **PHP Version** | 7.4 or higher (8.0+ recommended) |
| **MySQL** | 5.6 or higher (5.7+ recommended) |
| **License** | Free: GPL-2.0+ / Pro: Proprietary |
| **Language** | PHP (95. 9%), JavaScript (2.5%), CSS (1.6%) |
| **Mobile** | Fully responsive |
| **Browser** | All modern browsers (Chrome, Firefox, Safari, Edge) |
| **HTTPS** | Recommended for API usage (Pro) |

—

## 🎁 **What’s Included**

### Free Version:
– ✅ Plugin files ready for installation
– ✅ Complete documentation
– ✅ 3 frontend shortcodes
– ✅ Honeypot spam protection
– ✅ Email notification system
– ✅ CSV export functionality
– ✅ Support Manager role
– ✅ Community support

### Pro Version:
– ✅ Everything in Free, plus:
– ✅ REST API with 6 endpoints
– ✅ Mobile app support (FlutterFlow ready)
– ✅ Private notes system
– ✅ Complete change logging/audit trail
– ✅ CSV import functionality
– ✅ Bulk operations
– ✅ reCAPTCHA v3 integration
– ✅ Invalidation photo uploads
– ✅ Advanced filtering
– ✅ Priority email support (24-48 hours)
– ✅ Automatic updates via license
– ✅ Complete API documentation

—

## 📥 **Installation** *(3 Minutes)*

### Quick Start:

1. **Upload & Activate**
– Upload plugin to `/wp-content/plugins/`
– Activate through WordPress Plugins menu

2. **Configure Settings**
– Navigate to **Warranties → Settings**
– Configure email settings (from name, from email)
– Enable honeypot protection (recommended)
– Optional: Add reCAPTCHA keys (Pro)

3. **Create Pages**
– **Register Page**: Add `

Name:

Phone:

Email:

Device Repaired:

Repairs Completed:

Repair Date:
Must be within the last 30 days.
Receipt Code:
⚠️ Receipt code is case sensitive.

Submit Warranty

` shortcode
– **Search Page**: Add `

Enter Receipt Code:
Search

` shortcode
– **View Page**: Add `

No warranty ID provided.

` shortcode

4. **Test the System**
– Submit a test warranty
– Check admin dashboard
– Verify email notifications
– Test customer lookup

**For Pro:** Purchase license → Install Pro plugin → Activate license in **Warranties → License** → All premium features unlocked!

—

## 🤝 **Custom Support Manager Role**

Built-in staff role:

**Capabilities:**
– ✅ View all warranties
– ✅ Add/edit/delete warranties
– ✅ Change warranty status
– ✅ Add notes (public and private)
– ✅ Export CSV
– ✅ Access warranty dashboard
– ❌ No admin access
– ❌ No plugin settings access

**Perfect for:**
– Front desk staff
– Repair technicians
– Customer service representatives
– Support agents

—

## 💡 **Frequently Asked Questions**

**Q: Do I need the free version to use Pro? **
A: Yes! Pro is an add-on that requires the free Warranty Registration plugin to be installed and activated.

**Q: How does the honeypot protection work?**
A: The honeypot adds a hidden field that humans can’t see but bots typically fill. When a bot fills the field, the submission is silently rejected. No API keys or user interaction needed!

**Q: Can I build a mobile app with this plugin?**
A: Yes, with Pro! The REST API provides 6 endpoints for full CRUD operations, and it’s FlutterFlow-ready for easy mobile app development.

**Q: What’s the difference between public and private notes?**
A: Public notes are visible to customers via the warranty lookup. Private notes (Pro only) are staff-only and never shown to customers—perfect for internal communication.

**Q: Can I import existing warranties? **
A: Yes, with Pro! CSV import allows bulk import of warranties from spreadsheets or other systems.

**Q: Is this GDPR compliant?**
A: The plugin stores minimal customer data locally in your WordPress database. For full GDPR compliance including automatic data cleanup, you are responsible for configuring your WordPress installation appropriately.

**Q: Can customers see their warranty status?**
A: Yes! They receive an email with a link to view their warranty, or you can use the `

Enter Receipt Code:
Search

` shortcode for customer self-service lookups.

**Q: How do I get API keys for mobile apps?**
A: Pro version includes API key management in **Warranties → API Settings**. Generate keys, set permissions, and start integrating immediately.

—

## 🏆 **Why Avoyelles Phone Shop? **

Developed by **Avoyelles Phone Shop**, a team with real-world repair shop experience:

– ✅ Built by repair professionals for repair professionals
– ✅ WordPress security best practices
– ✅ Responsive support team
– ✅ Ongoing development and updates
– ✅ Transparent licensing
– ✅ Real-world solutions that work

—

## 🛒 **Get Started Today**

**Free Version**: Essential warranty management with honeypot protection
**Pro Version**: REST API, mobile apps, private notes, change logging, priority support

👉 **[Download Free Version](#)** | 👉 **[Upgrade to Pro](#)**

—

## 📞 **Support & Resources**

– 🌐 **Website**: [avoyellesphoneshop.com](https://avoyellesphoneshop.com)
– 📧 **Email**: support@avoyellesphoneshop. com
– 📚 **Documentation**: Complete setup guide included
– 🎫 **Support Portal**: https://avoyellesphoneshop.com/support/
– 📝 **API Docs**: Built into WordPress admin (Pro)
– 📋 **Response Time**: 24-48 hours for Pro license holders

—

*Simplify your warranty management today with Warranty Registration—where professional repair tracking meets WordPress simplicity! *