Installing HelpWP

🔍

HelpWP is a standard WordPress plugin. There is nothing to register, no API key required to activate, and no external service is contacted on activation.

Requirements

• WordPress 6.0 or newer
• PHP 7.4 or newer
• A WordPress site you can install plugins on (any host, any theme)

The optional AI features (chatbot, auto responder, doc sync) connect to the HelpWP RAG service at ai.easysuite.org and require a one-time site registration. The base help-desk features (docs, tickets, emails, migration) work fully offline.

Install from a ZIP

1. In WordPress admin, go to Plugins -> Add New -> Upload Plugin.
2. Pick the helpwp.zip file and click Install Now.
3. Click Activate Plugin when the upload finishes.

You will see a new top-level menu called HelpWP in the admin sidebar.

Install manually over SFTP

1. Copy the helpwp folder (not the zip itself) into wp-content/plugins/.
2. Go to Plugins in WordPress admin.
3. Find HelpWP in the list and click Activate.

What happens on activation

The plugin registers two custom post types (helpwp_doc, helpwp_ticket), three taxonomies (helpwp_topic, helpwp_reason, helpwp_product), eight ticket statuses, three custom roles (helpwp_manager, helpwp_agent, helpwp_user), and the REST namespace /wp-json/helpwp/v1/. No database tables are created. All settings live in a single option named helpwp_settings.

Next step

Open HelpWP -> Settings to wire up the front-end pages. The next doc walks through this.