> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.feedbucket.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Feedbucket WordPress Plugin

**We have created a WordPress plugin to make installation a lot easier on WordPress sites. It also has a few features to easily decide who should see the Feedbucket widget.**


# **Install the Feedbucket WordPress plugin on your website**

1. Sign in to WordPress Admin. From the **Plugins **tab click** Add Plugin**
2. Search for **Feedbucket **and click** Install Now **and then** Activate**

![](https://storage.crisp.chat/users/helpdesk/website/-/4/c/1/c/4c1cdabe55cf0c00/wordpress2_migtgk.png)

3. Click on **Settings **to open up the settings page of the plugin. You can also find this later from** Plugins > Installed Plugins > Settings under Feedbucket**
4. Enter your **Project key **from Feedbucket into the field called** Project Key.** You will find the project key in Feedbucket by going into your **Project > Installation > Plugins & Tools > WordPress** as you can see below. Copy the key and paste it into the project key field in the WordPress Plugin

![Copy the project key from Feedbucket into the field Project Key in the WP Plugin](https://storage.crisp.chat/users/helpdesk/website/-/4/c/1/c/4c1cdabe55cf0c00/wordpressprojectkey_hemyiw.png)

5. Configure if Feedbucket should be enabled and if it also should be enabled in the admin by ticking the checkboxes.  
6. Configure the **Visibility** of the Feedbucket widget. Who should be able to see the widget and submit feedback?
* **All users**: This is the default and that means all users coming to the site should see the Feedbucket widget. This is great for staging sites that are not public to the whole world.
* **Only authenticated users**: This is great if you want to keep allowing your clients to use Feedbucket even after you go live. Then you of course don't want it to be shown to everyone visiting the site.
* **Only users with certain roles: **If you need even more granularity you can show Feedbucket only to logged in users who have a certain role. Feedbucket is using the native roles from WordPress

7. Configure if we should automatically set the reporter to their WordPress account if they are logged in. If you have given your client a WordPress login we can automatically set the details Feedbucket needs based on the user account. That way the client do not have to fill in their name and email when submitting feedback.
8. Click **Save** to store your settings.

||| __IMPORTANT WHEN USING CACHE!__ Feedbucket is using the wp_enqueue script hook to add the Feedbucket widget to your WordPress site. Some sites are using cache plugins that may have to be busted if you make changes. If you have removed the Feedbucket plugin or made changes but still see it on your website make sure to clear the cache of your site.


# How to use the queryTrigger together with the WordPress plugin

A common issue when using the WordPress plugin is how to set things up together with our queryTrigger. The queryTrigger is used to be able to only show the Feedbucket widget when a special secret query parameter is added. 

You should follow the setup steps in our [query trigger documentation](https://help.feedbucket.app/en/article/how-to-use-feedbucket-on-a-production-live-and-public-website-gozksp/) but you **need to** have the Visibility in the WordPress plugin set to **All users.** 

# How to use members only visibility together with the WordPress plugin

Another use case could be wanting to handle reviews internally with your team and only wanting the widget to appear for your team members.

For this, you will need to set the visibility of the widget to **Only show widget to members** within Feedbucket Admin. You also **need to **have the visibility in your WordPress plugin set to **All users**.

# Common issues and FAQ

**Can I limit the widget to only a few pages?**
The Feedbucket WordPress plugin can not handle this directly. You would then need to use another WordPress plugin and only insert the script tag on the limited pages there. So a plugin to be able to add scripts in the head and only trigger it on the pages that you want to.

**I have disabled Feedbucket but I can still see it.**
Most often this is because of a caching plugin that you have on your website. Make sure to clear the WordPress cache and it should be removed.