• Home
• Projects
• FAQ
• Links
• Contact

Gmail Checker (Firefox Extension)

1. Does it work with 2-step verification?

   Yes, you need version 2.5.0.91 or above.

   You need to generate an application-specific password for Gmail Checker for each of your accounts which use 2-step verification. This password must be saved locally in 'Manage Accounts'. This means that you need two passwords (one is your actual password, the other is the application-specific password) to check mail in this type of account.

2. My account keeps being logged out when I open the mailbox

   There are 2 probable causes:

   • You've opened different accounts side by side, i.e. on different tabs or windows.
   • You've selected 'Sign out' on Gmail website.

   Doing either of those will invalidate cookies currently used by the extension for authentication. This is an expected behaviour and not a bug, so there won't be a fix.

   If you encounter this problem, you need to select 'Log out' of that account from the extension's menu to remove all invalid cookies.

   You don't need to log out of an account to open the mailbox of another account. Just close its tab or window first and then open the other account.

3. My account failed to log in or
   The extension shows incorrect mail number

   This problem cannot be solved without a debug log regardless how detailed you try to explain.

   Open the Debug Window in 'About...' and then log in to the account again to get the debug log.

4. I don't want to save my account's username and password locally.
   You don't have to. Just select "Log in to new account" in the menu and enter the account you want to check mail.
5. What does "Remember login cookies" in the login window mean?

   It means that authentication cookies won't expire after you've closed the browser.

   Tick this check box if you want to reuse your authentication session when Firefox reopens without storing your username and password locally.

6. Where are the settings and account details stored? How to back them up?
   They are stored in a file called gmailchecker.sqlite under your profile directory. The passwords are encrypted using Firefox's built-in password manager and may not be decrypted on another machine (I don't know?). So the file may be unusable on the other machine.
7. Is the locally saved password encrypted?
   Yes, in the same way as the passwords stored by Firefox's built-in Password Manager.
8. Where is 'Log out of all accounts'?
   It's under each account's submenu.
9. I've got more than 20 new mail but it shows only 20?
   The extension uses Gmail Atom feeds which have a limit of 20 messages.
10. How to disable localisation?

    On 'about:config', change the value of general.useragent.locale to en to show text in English.

    You need to restart the browser for this to take effect.

News System

1. How to customize the template?
   Modify the *.tpl and *.css files in /display/basic/ directory.
2. Can BBCode be used in comments?
   Yes since version 1.3, a limit number of BBCode are allowed, including [b], [i], [u], [url] and [quote].
3. What's the URL of my RSS feed?
   http://yoursite/path/to/news/rss.php
4. The spell checker doesn't work?
   Use Firefox's built-in spell checker instead. It's much better.
5. I want to add a new locale for date and time?

   In /template/default/settings.tpl, create a new option for your preferred locale as follows

   <option value="lo_LO lo_LO.CHARSET-1 lo_LO.CHARSET-2 ...">
   	Locale Common Name
   </option>
   

   where lo_LO is the standard locale code which can be referred from here, and lo_LO.CHARSET-1 lo_LO.CHARSET-2 ... is the list of character sets supported by your host that can be referred from here

6. The script doesn't work with Unicode text?

   Try the following fix:

   • In /template/default/header.tpl and /template/default/preview.tpl, set the charset of <Content-Type> to be UTF-8.
   • In functions.php, look for function getZoneDate() around line 56 and replace the return line with this code

     return utf8_encode(
         gmstrftime($format, $time + $this->configs['zone']*3600));
      
     

Calendar

1. How to find my website's document root?
   Check the HTML source of calendar's index.php loaded on a web browser, and look for edit : function(id) in the <script> section. You'll see something like this

   var url = "/your/document/root/calendar/calendar_handle.php?edit=" + id;
    
   

   That means your document root is /your/document/root (without the trailing slash), assuming that you've put the script in a directory called calendar.
2. How to make the event window float on the left-hand side?

   <style type="text/css">
   #calendar .calendarDetail .calendarEvent {
       margin:0 0 0 -180px;
   }
   </style>
   

Image Gallery

1. How to customize the template?
   Modify the *.tpl and *.css files in /template/default/ directory.
2. There are no thumbnails at all?

   If you're sure that you have GD2 installed then it's because of wrong document root setting.

   A quick and dirty way to find your document root is to download the calendar script and refer this FAQ entry, and then set your document root manually as following

   <?php
   ...
   $gallery = new WingedGallery();
   ...
   $gallery->setDocumentRoot('/YOUR/DOCUMENT/ROOT');
   ...
   ?>
   

Misc.

1. What's the license of <insert program's name here>?
   All are in public domain unless otherwise specified.