Note: this article helps with trouble shooting issues of LTI integrations that have already been successfully installed. The article is NOT directed at admins installing the integration of Grasple with their LMS. If you encounter difficulties during the installation, please reach out to support@grasple.com.
What happens if my settings are incorrect?
When Grasple is loaded within your Learning Management System (e.g. Brightspace, Canvas, Moodle, Blackboard, etc.), your browser should allow third-party-cookies for grasple.com and allow Javascript to be run.
If you don't have the correct settings, launching Grasple within your LMS will not work. This can result in one of the following errors:
Grey screen: Javascript is disabled/blocked;
Login screen: your browser and/or extensions do not allow third-party cookies;
Error screen: your browser and/or extensions do not allow third-party cookies.
Grey screen
If you get a grey screen without any buttons or text, Javascript is disabled/blocked (for third-party origins) within your browser and/or extensions. To use Grasple you should allow Javascript to be loaded and run from the domains: grasple.com and ihatestatistics.com (the old domain and name for Grasple).
Login screen / Error screen
If this happens, your browser and/or extensions do not allow third-party cookies. When Grasple is loaded within your Learning Management System, Grasple is seen as a third-party. To use Grasple, you should allow third-party-cookies to bet set for the domain grasple.com in your browser and or extensions.
WARNING: Safari's default settings do NOT allow for third-party-cookies on all their devices (Macbook, iPad, iPhone). However, they only provide the option to allow third-party-cookies from all sources. Our advise is to use a different browser (Chrome) where you can control the cookies in a more elaborate way. If you want to use Safari for Grasple within your LMS, you have to allow third-party-cookies. The paragraph below explains how you can change these settings.
How do I configure my browser correctly?
Safari
By default Safari on both Macbook and iPhone do not allow third-party-cookies. Change your settings if you want to use Grasple within your LMS while using Safari.
Macbook:
Go to Safari > Preferences
Go to Privacy
For Safari 11+: uncheck "Prevent cross-site tracking"
For Safari 10 and lower: set "Cookies and website data" to "Always allow"
iPhone:
Go to Settings > Safari
For iOS 11: Make sure Block All Cookies AND Prevent Cross-site tracking are turned off
For iOS 10 and lower: Make sure that Always Allow is selected from the “Cookies” drop-down menu
Chrome
By default Chrome allows third-party-cookies. If you switched it off, please follow these steps below:
Go to Chrome Settings > Privacy and security > Site Settings
Go to Cookies
Enable "Allow sites to save and read cookie data" and disable "Block third-party cookies
Firefox
By default Firefox allows third-party-cookies. If you switched it off, please follow these steps below:
Go to Content Blocking
If Custom is selected, make sure that the Cookies settings is set to "Third-Party trackers" and not any of the other options.
Edge
By default Edge allows third-party-cookies. If you switched it off, please follow these steps below:
Go to Edge > Settings
Click View Advanced Settings
Select the dropdown under Cookies
Select "Don't block cookies"
Need support
If the issue persists after having followed the instructions in this guide, please contact us at support@grasple.com or via the chat. Please add screenshots of the page where you're experiencing the issues with your browser console clearly visible (article: how do I open my browser console).