=== Desperado House Device Service Portal ===
Contributors: desperadohouse
Tags: service portal, repairs, tools, support, requests
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.10
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Device service requests: public form, private photo uploads, status tracking, PDF reports, email notifications and analytics by Desperado House.

== 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]).
* 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

== 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.

== Frequently Asked Questions ==
= 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, rate-limit transients and request lookup indexes during uninstall. Submitted service requests (the records) are intentionally kept as business data and can be removed manually.

= Does the plugin send data to external services? =
No. It only sends emails through your own site (wp_mail).

== 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.

== Changelog ==
= 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.

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