Requirements and Installation
Install SmartSite Assistant as a WordPress plugin; the documentation site is a separate Astro application and is not uploaded through WordPress.
Installation places PHP code and bundled dependencies in WordPress, creates or upgrades the SmartSite log table, and copies the compiled public widget assets into the WordPress uploads directory. The plugin then needs outbound HTTPS access for OpenAI and any enabled channel or webhook. A successful WordPress “Activated” message therefore confirms only the installation step, not that AI, knowledge, or messaging services are ready.
Begin by obtain the trusted smartsite assistant zip package.
Installation
Section titled “Installation”Visit the download Dashboard here and download the latst zip package.
For a password please contact Marko directly over Email or Google Chat.
Before you begin
Section titled “Before you begin”- A WordPress administrator account with permission to install plugins.
- PHP 8.2 or newer is required by the bundled OpenAI client dependency. The plugin header does not declare a minimum WordPress version; verify on staging with your supported WordPress release.
- Outbound HTTPS access to OpenAI and, if used, Meta and the private update host.
Set it up step by step
Section titled “Set it up step by step”- Obtain the trusted SmartSite Assistant ZIP package.
- Open Add New Plugin, choose Upload Plugin, select the ZIP, and install it.
- Activate SmartSite Assistant.
- Open AI Website Chat and confirm the setup wizard or main page loads.
Fields, controls, and important values
Section titled “Fields, controls, and important values”The items below are less about improving the wording of an answer and more about giving the plugin a dependable foundation. A compatible server lets uploads, synchronization, streaming replies, and background requests finish correctly. If that foundation is incomplete, good instructions and knowledge can still produce missing controls, failed requests, or answers that never reach the visitor.
| Field, control, or status | What SmartSite Assistant does with it | How to use it and why it matters |
|---|---|---|
| Install Now | Extracts the plugin into wp-content/plugins. | This copies the plugin into the correct WordPress directory so its code is available, but it does not start the assistant yet. Continue to activation, then confirm the admin menu and requirements before entering credentials. |
| Activate Plugin | Creates or upgrades the SmartSite log table and copies compiled widget assets to the uploads directory. | Activation loads the plugin, prepares its database state, and makes configuration screens available. It still does not create a useful AI response by itself; the OpenAI connection, assistant profile, and knowledge setup come next. |
| Plugin identity | The bootstrap header in ai-website-chat.php identifies the installed SmartSite Assistant release. | Configure “Plugin identity” from the receiving system’s documented contract, including method, headers, and expected response. It can deliver data used in an answer or action, but it cannot make an unsafe destination trustworthy. |
How to confirm it is working
Section titled “How to confirm it is working”For Requirements and Installation, a saved notice is only the beginning. Confirm the outcome from a fresh session and compare it with the success description above so cached pages or earlier conversation context do not create a false positive.
Important warnings
Section titled “Important warnings”Common problems and focused checks
Section titled “Common problems and focused checks”| Problem | What to check and what to do next |
|---|---|
| Activation shows a PHP version/dependency error. | Switch the site to PHP 8.2+ or ask the host to do so before activation. |
| Requirements and Installation is missing or does not match this guide. | Confirm the plugin is active and the account can manage WordPress options. Confirm activation, administrator access, and that the setup workflow was not completed in another session. |
| A change on Requirements and Installation does not produce the expected result. | Keep the exact notice and test case, then review the browser console and WordPress/PHP log. Confirm activation, administrator access, and that the setup workflow was not completed in another session. |
Screen reference
Section titled “Screen reference”- Capture
- Show the Plugins list immediately after activation with SmartSite Assistant visible and active. Hide unrelated premium license data.
- Show
- Plugin name, version, Active state, AI Website Chat menu
- Viewport
- Desktop, 1440 × 900
- Annotate
- Use numbered callouts only for controls referenced in the procedure.
- Redact
- OpenAI keys, tokens, secrets, personal information, private URLs, IP addresses, and conversation text