FAQ

Install fails with blank screen

In most cases it means that your server is limited in resources and Joomla has no time/memory to unpack MobileJoomla archive (check your error_log for info about the error). Try to unpack it to Joomla’s tmp directory and do install from the directory.

Also there is a way to unpack MobileJoomla archive, remove /plugins/terawurfl directory, pack it back to new archive, and install such a “limited” version of MobileJoomla. In this case you will get working MobileJoomla, but without TeraWURFL plugin.

Content is not displayed for mobile phones

If you try to open the page in a mobile browser (iPhone/others) the mobile site version does not have content.

Possible causes

You are using low end / free hosting (Godaddy) which inserts ads on the page. These kinds of hosting plans are not compatible, because they break mobile HTML code

Install gives me a warning that I need MySQLi to use WURFL

Most likely it means that PHP was compiled without mysqli support, or mysqli lib is not installed (that is mysqli class is not defined in PHP). Also check that mysqli.so (php_mysqli.dll in Windows) extension is loaded in php.ini.

Error downloading http://www.mobilejoomla.com/tera_dump.sql

The problem is that MobileJoomla cannot unzip tera_dump.sql.bz2 file. This is usually because your hosting provider does not support PHP bz extension. Bz is needed in order to decompress bzip2 packaged file which is the distribution format of TeraWurfl handset database. Workaround here is to unpack tera_dump.sql.bz2 to the root of your site or to download http://www.mobilejoomla.com/tera_dump.sql and put it to the root of site (where configuration.php is placed) as tera_dump.sql. Then reinstall MobileJoomla. The MobileJoomla installation procedure will use this file in the case of problems with unpacking original bzip2-file.

Gateway Time-out. The gateway did not receive a timely response from the upstream server or application.

It maybe because php is run in CGI/FastCGI mode with very short timeout (it is not related to max_execution_time in php.ini) that doesn’t allow MobileJoomla installer to finish install procedure.

During install MobileJoomla tries to unpack tera_dump.sql.bz2 file. If it is impossible on your server (that is either bz2 php extension is not loaded or bunzip2 program is not installed) then MobileJoomla tries to download unpacked version (~20Mb) from mobilejoomla.com. Most likely you have a problem with downloading tera_dump.sql (that is php is able to open connection with remote server, but cannot download any data, or downloading speed is very low). So, as a solution it is recommended to install/enable bz2 php-extension.

Errors during usage

TeraWurfl::addTopLevelSettings()

Catchable fatal error: Argument 1 passed to TeraWurfl::addTopLevelSettings() must be an array, null given, called in plugins/mobile/terawurfl/TeraWurfl.php on line 334 and defined in plugins/mobile/terawurfl/TeraWurfl.php on line 463

Choose mysql4 mode in “Mobile-TeraWURFL” plugin settings.

Incorrect usage of Mobile Joomla.

Most likely you assigned mobile template to a menu item. Note that mobile templates in MobileJoomla are not usual templates. They may be loaded through “Mobile Joomla Plugin” plugin only (and not as usual templates). That is why you cannot assign them to menu items or view them in preview mode. If you would like to give users a link to mobile version, do it with MobileJoomla’s MarkupChooser module.

I cannot test iphone version of a site in phonetester.com emulator

iphonetester.com doesn’t change “user agent string”, and it is not an actual emulator as it uses your browser to load and render page. Try to use Firefox browser with UserAgentSwitcher extension to work with iphonetester.com. The typical “User Agent String” of iPhone is

Mozilla/5.0 (iPhone; U; CPU like Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) Version/3.0 Mobile/1A543a Safari/419.3

Only some menu items is shown in mobile version of a site

Check that all the menu items are correctly translated in JoomFish as default language of mobile device may differ from the language of desktop browser.

Mobile site is displayed on my desktop browser

For some reason your browser is detected as a mobile browser. A browser add-on could cause this.

Please post the following information to forum

Does error happen with different browsers?
Which URL you use to access your site?
Is your site public so we can test it?
Can you tell me your browser user agent (use http://whatsmyuseragent.com/ )