Common Boris Theme Issues and Solutions (Developers)

The Boris theme, crafted by Torango.io for Zendesk Guide, is designed to provide an intuitive and streamlined user experience. It simplifies the process of creating, managing, and delivering help content to users. However, as with any software, issues may arise that can disrupt its functionality. This guide aims to address some of the common issues users might encounter while using the Boris theme and provide practical solutions to resolve them.

Common Issues and Solutions

1. Styling Issues

Problem: Custom styles not applying or displaying incorrectly.

Solution: Check for any syntax errors in your CSS. Ensure that your custom CSS is correctly added to the theme settings under the "Edit Code" section. Use browser developer tools to inspect elements and ensure your styles aren’t being overridden by default styles. Adding more specific selectors or the !important tag may be necessary.

2. Responsiveness Issues

Problem: The theme does not look good on mobile or tablet devices.

Solution: Ensure that responsive design settings are properly configured. Test your website on various devices and use media queries to make adjustments suitable for different screen sizes. Revisit the responsive design components provided with Boris to make sure they have been implemented correctly.

3. JavaScript Errors

Problem: Custom JavaScript or jQuery code not working as expected.

Solution: Ensure there are no syntax errors in your JS code. Check that any external libraries needed are correctly loaded. Remember to wrap your custom JavaScript in a document ready function to make sure the DOM is fully loaded before scripts execute.

4. Search Functionality Issues

Problem: Search function not displaying results or showing errors.

Solution: First, check if this is a configuration issue within Zendesk Guide settings rather than a theme issue. Clear cache and check again. For theme-related issues, ensure that the search code block is present and correct in the theme's template. Review JavaScript console for any errors that might indicate what is breaking the search.

5. Update and Compatibility Issues

Problem: After updating the Boris theme or Zendesk, some features stop working.

Solution: Always back up your current theme before applying updates. After updating, test all functionalities. If you encounter issues, you might need to merge changes manually if customizations were previously made. Check Torango.io’s support documentation or community forums for any notices about theme updates and compatibility advisories.

Conclusion

While the Boris theme aims to be as user-friendly and robust as possible, encountering issues is a normal part of working with any advanced digital tool. By following the solutions outlined above, you can swiftly address and rectify most common problems. For further assistance, do not hesitate to contact Torango.io's dedicated support team.