Desperado House Device Service Portal

Description

Device Service Portal presents a public service page where customers submit repair requests for power, pneumatic and hand tools, upload photos and check request status later. The administration side collects every request, lets you update statuses (which emails the customer automatically), provides service analytics and printable reports.

  • Public form for customer, device and fault details, organized in 4 numbered steps (shortcode: [desperadohouse_service_portal]). Anyone can submit without an account — no login required. The submission is processed on the public page itself (not through wp-admin/admin-post.php), so guests are not blocked by security plugins, WAF rules or page caches, and the success/error message is also read from a short-lived cookie.

  • Tool types (electric, battery-powered, pneumatic, hand tools and more) that the administrator manages: new types can be added and existing ones deleted.

  • Manufacturer/brand suggestions are entered manually in the administration; visitors can also type their own brand.
  • Up to four photos JPG/PNG/WebP, maximum 5 MB per photo. Photos are stored in a private directory protected for Apache (.htaccess); for Nginx a deny rule for direct access must be added to the server configuration.
  • Unique request number (SP-YYYY-00000 format).
  • Status check combining the request number and email address, with a colored status badge and a printable confirmation.
  • Administration list and details of service requests.
  • Ten workflow statuses; status change emails to the customer with the identity you configure and reply-to preset to the service inbox.
  • Status change history log.
  • Printable service request (PDF print report) for the administrator from the request review, and for the customer from the status check, with the note that the request was submitted via the webshop and the webshop name.
  • The administrator chooses the email address where requests arrive and the sender identity (name + address) customers receive confirmations from.
  • Service analytics: statistics by month, status, tool type and brand, plus the device service history by serial number.
  • Modern, responsive frontend and administration with the Desperado House signature.

Requests are stored as private posts of the custom post type desperado_service.

Author: Desperado House s.p. Cvijetin Maletić — https://desperadohouse.com — info@desperadohouse.com

Privacy

Customer names, emails, phone numbers, addresses and device details submitted on the form are stored as private posts of the custom post type desperado_service, processed only to fulfill the service request and emailed to the addresses the site administrator configures. The content, retention period and legal basis of processing must be confirmed by the service provider. The plugin does not provide legal advice.

Support

For questions, bugs and customizations contact the author: info@desperadohouse.com.

Screenshots

Installation

  1. Back up the site and test the plugin on a staging copy first.
  2. In the WordPress administration open Plugins > Add New > Upload Plugin and choose the ZIP.
  3. Activate “Desperado House Device Service Portal”.
  4. Create a “Service” page and add the shortcode: [desperadohouse_service_portal]
  5. Adjust tool types, brands and email addresses under Device Service Portal > Tool types & email (submenu in the administration).
  6. Check the site email address under Settings > General and test email delivery.
  7. Test submission, status changes, status tracking and photo downloads as an administrator.

FAQ

Where do new requests arrive?

To the email address set under Device Service Portal > Tool types & email, “Request notification email”. It defaults to the site administration email.

What email do customers see as the sender?

The sender identity you configure in the same settings screen (name + address). Replies are routed to the notification address via Reply-To.

How are photos protected?

They are stored in a private uploads directory with an .htaccess deny rule for Apache/LiteSpeed. For Nginx, add a deny rule for that directory to the server configuration.

What happens to my data when the plugin is deleted?

The plugin deletes its own settings during uninstall. Submitted service requests (the records) are intentionally kept as business data and can be removed manually; no request lookup indexes are stored (tracking works directly over post meta).

Does the plugin send data to external services?

No. It only sends emails through your own site (wp_mail).

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Desperado House Device Service Portal” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.14

  • Guest submissions: the public form now posts to the page itself (template_redirect) instead of wp-admin/admin-post.php, the request nonce is no longer a hard gate (stale nonces from cached pages cannot block valid submissions), and the per-IP rate limit is only recorded for accepted requests, so failed test attempts no longer lock out the visitor. Status messages fall back to a short-lived cookie and remain visible on cached pages.

1.0.13

  • Performance: the status check resolves the request straight from the request number (no meta_query).

1.0.12

  • Review hardening: all admin actions verify nonces with a visible request termination, admin notices moved from query strings into one-time transients, and all generated output (icons, signature logos, status messages, analytics) is escaped late through wp_kses with explicit allowlists.

1.0.11

  • Hardening: request lookup now works directly over post meta (no extra options), the uninstall routine deletes only plugin settings with standard functions, and binary downloads are served without unescaped output.

1.0.10

  • Hardened input handling: all admin actions verify nonces and capabilities inline, read-only GET parameters are read through filter_input, file serving and photo storage use the WP_Filesystem API, and the custom post type slug was adjusted to the WordPress 20-character limit.

1.0.9

  • Renamed the plugin to Desperado House Device Service Portal; fixed the custom post type length and file serving, and moved all print view assets to enqueued files.

1.0.8

  • Initial public release: customer service form, private photo uploads, status workflow with email notifications, printable PDF documents, email settings, service analytics with serial number history, tool type and brand management.