Frequently Asked Questions (FAQ)

This FAQ collects common questions from site owners, agents, and developers using ShahiAssist.

—

General

Q: What versions of WordPress and PHP does ShahiAssist support?
A: ShahiAssist requires PHP 8.0+ and WordPress 6.0+. It is tested up to WP 6.8. For best performance use PHP 8.1+.

Q: How do I install the plugin?
A: Upload shahiassist-v3.1.5.zip via Plugins → Add New → Upload Plugin or extract and upload ShahiAssist/ to /wp-content/plugins/.

Tickets

Q: Can guests submit tickets?
A: Yes. Enable “Guest Submissions” in Settings → Tickets. When enabled, guests must provide a valid email address.

Q: How can I change the ticket ID prefix?
A: Settings → Tickets → Ticket ID Format. Change the prefix and length values — new tickets will use the new format.

Q: How do I assign tickets automatically?
A: Settings → Tickets → Auto-Assign. Choose Round-robin, Least busy, Random, or Disabled.

Emails

Q: Emails aren’t sending. What should I check?
A:

1. Verify “From” address uses your domain
2. Use WP Mail SMTP or check host mail logs
3. Confirm wp_mail() is functioning by sending a test email

Q: Can I edit email templates?
A: Yes. Settings → Emails → Edit the template. Use placeholders like {ticketid} and {ticketurl}.

Knowledge Base

Q: How do I import Markdown articles?
A: Tools → Import → KB Import supports .md files. You can also use the Export/Import JSON format.

Q: Article URLs return 404 after moving site.
A: Flush permalinks (Settings → Permalinks → Save) to regenerate rewrite rules.

Developer

Q: How can I extend the REST API?
A: Use addaction('restapi_init', ...) to register custom routes under shahi-assist/v1 or your own namespace.

Q: Where can I find hooks and filters?
A: See kb/05-advanced-configuration-customization.md — it lists the main actions and filters. Use them to inject behavior without editing plugin files.

Q: Is there an SDK or Postman collection?
A: Not yet bundled. I can generate a Postman collection or a small PHP/JS SDK for common operations if you want.

Troubleshooting

Q: The My Tickets page shows no tickets for users who just submitted one.
A: If submissions are processed asynchronously (background jobs), refresh after a minute or check wp-cron is running. Also verify that guest submissions create an email token if used.

Q: How to debug webhook delivery failures?
A: Enable webhook debug logs in Settings → Integrations and inspect uploads/shahi-assist/logs/webhooks.log. Check remote endpoint accessibility and SSL.

Misc

Q: Does uninstall delete plugin data?
A: Only if you enable “Delete all plugin data on uninstall” in Settings → Advanced or define the SHAHIASSISTUNINSTALLDELETEDATA constant. By default data is preserved.

Q: Where are uploaded attachments stored?
A: Attachments are stored in wp-content/uploads/shahi-assist/ and registered as regular WP attachments.

—

If you’d like, I can convert these FAQs into a grouped UI for the KB page (accordion layout) and wire up anchor links for quick navigation. Want me to implement that?