.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../Includes.txt


.. _troubleshooting:

Troubleshooting
===============

**Empty page**

If you get an empty crossword then check if you have access to the javascript and CSS-files. In
chrome and firefox you can do this with the help of the developertools by pressing STRG+SHIFT+J
(Chrome or Firefox). Then you can see probably the following error messages in the console tab or
browser console. If you see this errors then check Chapter :ref:`Providing access to
glcrossword resources<administration-providing-access-to>` for resolve the access problems in your apache server.

Console log with chrome.

.. figure:: ../Images/image-29.png
	:alt: Console log with Chrome

Console log with firefox

.. figure:: ../Images/image-28.png
	:alt: Console log with firefox

**Crossword not response**

The crossword is displayed but not reacting. You get only a hourglass over the crossword.

If you check the error log of you apache server in /var/log/apache2/error.log then you can see
the following error “Call to a member function getQuestionsArray() on a non-object “.

::

  	[Thu Jan 02 02:10:08 2014] [error] [client w.x.y.z] PHP Fatal error: Call to a member function getQuestionsArray() on a non-object in /var/www/typo3conf/ext/glcrossword/ajax/class.tx_glcrossword_ajax.php on line 89, referer: http://my.homepage/


This error happen not every time. Sometimes it happens only with certain browsers or if you
change your IP address.

That means you are in trouble with your unicode setting of your database. Mostly it happens in
case of umlauts or special characters in your crossword. The the session could be broken and the
ajax comunication is crashing because of the error above. See the chapter :ref:`Unicode setting for mysql
database<administration-unicode-setting-for-mysql>` in the Adminstration chapter how to fix this issue. Clear your
cache after you have done this settings.

**Hourglas is not stopping**

If you see only a turning crossword and the extension is not starting.

.. figure::  ../Images/image-23.png
	:alt: Hourglas of crossword

Then press F12 in your browser and check the console for errors.

If you can see an error like “jQuery.ajax(...).done is not a function”

.. figure:: ../Images/image-16.png
	:alt: Error if jQuery library is not included

You most probably have not include the jQuery library. Check if you have include the static template like in chapter :ref:`Configuration<configuration>` described.

**The crossword is starting but not responding**

If you can see a successful startet crosswords, but you can not edit any text or you can't see
any tooltips with the questions, then press F12 in your browser and check the console. If you
can see a error like “$l_objButtonHint.tooltip is not a function”, then you have not include
the bootstrap library in your homepage.

.. figure:: ../Images/image-18.png
	:alt: Error with missing bootstrap library

Check if you have included the static template like in the chapter :ref:`Configuration<configuration>` described.

Additionally you should check, if the constants for deactivating/activating the javascript libraries are properly set.

.. figure:: ../Images/configuration_edit_constants.png
   :alt: The static template is includet