First steps to troubleshooting an issue
Most of the Issues that we get in our support mail are not actually the Plugin issues. Most of it are general WordPress issues which have nothing to do with the plugin and which can be fixed on your own.
So below are some of the lists which might be the possible cause of the issue you are facing:
1. WordPress Version: You might be using a WordPress version below 4.9. It should be minimum 4.9 or greater.
2. PHP Version: This has been the case for most users. You might be using a PHP version lesser than 5.6. It should be a minimum of 5.6 or greater. But V7.0 is always recommended.
3. MySQL Version: MySQL version should be 5.0 or greater than 5.0
4. Conflict with other Plugins: If none of the above solves your issue, possibility that it might be due to a conflict with any of your Plugin which might be outdated. Try deactivating all your Plugins one-by-one and find the culprit. If that plugin is outdated or no longer needed, delete that plugin or find a better alternative.
5. Increase PHP Memory Limit in WordPress: This is again one of the common errors with the WordPress websites. To increase the PHP Memory limit in WordPress:
First, you need to edit the wp-config.php file on your WordPress site. It is located in your WordPress site’s root folder, and you will need to use an FTP client or file manager in your web hosting control panel.
Next, you need to paste this code in the wp-config.php file just before the line that says ‘That’s all, stop editing! Happy blogging.’:
define( ‘WP_MEMORY_LIMIT’, ‘256M’ );
This code tells WordPress to increase the PHP memory limit to 256MB.
Once you are done, you need to save your changes and upload your wp-config.php file back to your server.
After trying all these, if you are still not able to fix your issue, kindly contact us at firstname.lastname@example.org where our support team will take up your issue.
Error Message 101: The uploaded file exceeds the upload_max_filesize directive in php.ini
This has been one of the repetitive questions we have received in our support ticket.
This is most likely an issue with your hosting’s default upload size. There are many articles out there to fix this issue.
We have added one of the articles which we feel is better and easy to understand: http://www.wpbeginner.com/wp-tutorials/how-to-increase-the-maximum-file-upload-size-in-wordpress/
Kindly follow the steps given in the article above. It should fix your issue.
Error 102: Access has been blocked by CORS Policy
Often times we do receive these error reports from our users to fix this issue. But Actually, this is a common server issue.
This error occurs because web fonts are subject to Cross-Origin Resource Sharing (CORS). CORS is a way for a remote host to control access to certain types of resources.
We have attached an article which explains how to resolve this issue easily: https://deliciousbrains.com/wp-offload-s3/doc/configure-cors-to-resolve-web-font-issues/
If you are still facing issue after trying this, please contact us at email@example.com
Error 103: Search box shows “Apologies, but no results were found for your request”
Are you facing this issue where you are searching for something which is already in your list of articles but still shows “No results found”?
It might be probably because the “Helpdesk search” page which is the search results page template would have been deleted by mistake.
How to check this?
Kindly go to Dashboard -> Pages and check whether there is a page called “Helpdesk search” in it. If not check the trash.
It should be in the trash page. Restore that page and your search should work fine.
If the issue still exists after that or the “Helpdesk search” could not be seen in the Trash, kindly contact us at firstname.lastname@example.org.
Error 104: 500 Internal Error/ Blank Page
Are you facing any issue where your page is completely blank though you have content in it? Does it show as 500 Internal error in the console?
This is another common issue we get almost every time. This is most probably because you might be using a PHP version lesser than 5.6
Remember, the min requirement for the Plugin to work well is a PHP version 5.6 or more though 7.0 is always recommended.
If you are still facing the same issue after updating the PHP version, please contact us at email@example.com
How Should I install Helpie?
- You can purchase the Helpie WordPress Knowledgebase Plugin from our website http://helpiewp.com/.
- You can directly choose to buy using our “Buy now” button in the top menu of our website or you can start our 7 days free trial by clicking the “Start Free Trial” button.
- You will be asked to enter your e-mail address and card details as shown below. Don’t worry if you are just trying our free trial. You will not be charged until 7 days are over. You can cancel at any time within 7 days. You will also be notified 2 days before the trial ends via email.
- Once you entered the details, you will receive an e-mail as shown below with the link to download the plugin and activation license key in it.
- Click “Download the plugins basic version” and you will receive the Zip file.
- From your WordPress Admin, click “Plugins” from the main menu, then click the “Add New” button, and then “Upload Plugin”.
- Next, click the “browse” button and select the “helpie.zip” file which you downloaded to your computer. Then click “Install Now”.
- Once WordPress has finished installing the plugin, click the “Activate Plugin” link.
- You will be asked to enter the activation key which you received via e-mail. Enter it and click confirm.
- You’ll now be redirected to your WordPress plugins page, where you’ll see Helpie listed along with your other plugins, and also a new menu item named “Helpie Kb Wiki” in your WordPress main menu.
How can I know about the Updates?
You can check the updates of our plugin in our account section.
Go to Dashboard -> Helpie Kb Wiki -> Accounts. Near the option “Version” you will be notified about the latest version where you can update it directly.
You can also check the updates in the plugins section itself.
Go to Dashboard -> Plugins -> Installed plugins. You will see a notification to update near “Helpie- WordPress Kb Wiki plugin” where you could update the plugin.
What should I do if I am facing an issue after installing Helpie?
Now, Most of the issues that you are facing will be some default WordPress issues which you can solve by yourself. We have written a detailed article on troubleshooting which will guide you through the full process:
I want some contents to be visible only for my Internal team or subscribers
Are you looking for a way to hide some content from normal users and visible only for your internal team or the subscribed users?
You can easily do it using our Dynamic Capabilities feature which will let you control who can and cannot view on global, topic and article level.
You can find it in Dashboard -> Helpie Kb Wiki -> Helpie settings -> Dynamic capabilities.
To know more about it, check out this doc: http://helpiewp.com/docs/home/user-access/
How to customize CSS in Helpie
There are two ways where you can customize the CSS. One is:
- Using WordPress Customizer:
Go to Dashboard -> Appearance -> Customize -> Additional CSS. Paste your CSS code inside it.
- Creating a Child Theme:
You should create a child theme for your parent theme and can apply the CSS in the style.css file.
Can I modify the Helpie Code?
No. You are not allowed to modify any of our Plugin code. Even if you modify, the update will completely erase the modification you made and it’s completely not recommended.
We Won’t provide any support if you modify the code to change the functionality of our Plugin.
In case if you want to extend the functionality of Plugin, you should create a child theme for your parent theme and modify the code in functions.php file. This is recommended in case of utmost importance to extend the functionality of Plugin.
You can also contact us at firstname.lastname@example.org if you want our team to do the customization as a service.
Can non-logged in user create Wiki?
Are you looking for a way to let any users create or edit your wiki? Helpie makes it simple by setting up capabilities for non-logged in users to edit or publish your wiki.
1. Enable Front-end editing:
First, Go to Dashboard -> Helpie Kb Wiki -> Helpie settings -> Front-end editor -> Enable Front end editing.
2. Dynamic capabilities:
Next, Go to Dashboard -> Helpie Kb Wiki -> Helpie settings -> Dynamic capabilities -> “Can Edit” -> Who can edit -> Select By: “All”. This option will give the capability for everyone to create or edit any article which will be sent for approval.
3. How do I let anyone publish it directly?
Under the same Dynamic capabilities option -> “Can Publish” -> Who can publish -> Select By: “All”
You can do the same way to give the approval capability also.
Importing Content to Helpdesk
Are you looking for ways to import your content which is already available in your hands to the Helpdesk? Are you tired of creating new articles everytime which is already available? Don’t worry, you can directly import your content to the Helpdesk articles rather creating it one by one.
We have written a brief guide on Importing articles which are in different formats like XML,CSV, Excel and Docs. If you have your content in XML or CSV format, you can follow the below simple steps which will easily import the content to the Helpdesk. But, If you are having your content in Excel or Docs format, you need to convert it first to XML or CSV format and then follow the below steps. Let’s look at in detail:
Importing Content which are in XML or CSV Format:
1.First, you need to download and install a Plugin called WP All Import (http://www.wpallimport.com/). It has both free and premium versions. We personally recommend premium version as it allows extensive possibilities in the Pro version.
2. Once you installed and activated the Plugin, You will see an option named “All Import” in your dashboard as show in the screenshot below:
3. Select “New Import” under that All Import and choose “Upload a file”. Now upload the XML or CSV file which is in your system.
4. Once the upload is complete, you will be asked where to import the data from the file you selected. Select “Article” under the Create New button as shown below and continue to step 2.
5. Next, make sure your item elements has been selected to import and continue to step 3.
6. In the Step 3, you will see a XML tree on the right which will contain all the tags of the fields. You just need to drag and drop the tags of the fields which you need on the right to its respective position on the left. For example, you need to drag the title tag which you could see on the right (in the screenshot below) and drop it in the Title box in the left. Similarly for all other fields. Remember, only in the Pro version, all the fields will be available. That’s why we recommended the premium version.
7. Continue to Step 4. Now, WP All Import will create a new article for each unique record on your file. So if you have two articles that are same, WP All Import will detect those as duplicates. They do that through something called “Unique Identifier” and in general they can Auto detect that. So Just click “Auto Detect” in it.
8. Now continue and “Confirm and Run Import” and they will create all posts. Now if you go to Helpie Kb Wiki and check the articles, you will see all your content has been imported into it.
9. If you want to have an In-depth overview on “WP All Import”, kindly check the video in this link: http://www.wpallimport.com/documentation/getting-started/wp-all-import-in-depth-overview/.
Importing Content which are in Excel Format:
Do you have your content in Excel Format and want to import it to Helpdesk?
Almost all the steps are similar, except convert your content from Excel to CSV format and then follow the same steps given above.
Check this video for detailed explanation: https://www.youtube.com/watch?v=XIhqvEsrupo
Importing Content which are in Doc’s Format:
The best way is to convert the Doc’s to CSV and then following the same steps. There are many free online tools like this: https://convertio.co/doc-csv/ which will convert the doc’s to CSV file.
If you are still facing any issues with importing your content, please contact us at email@example.com.