LiteMage Cache Administration

This page is dedicated to the different functions, tools, and tricks available to administrators in LiteMage Cache.

There are three methods of enabling LiteMage administrative privilege browser commands for your Magento site. The one you choose to use will depend on the mode you would like LiteMage to be in at the time as well as the type of commands you would like access to. All debug-related commands will contain “LITEMAGE_DEBUG”. Refer to the All Administrative Privilege Browser Commands section for a full list of administrative privilege commands.

By putting LiteMage in debug mode you are essentially giving any IP that can access the site permission to use debug-related administrative privilege browser commands with regards to LiteMage. It is not recommended to do this unless your Magento site is only accessible by you at the time.

To enable Debug Mode, log in to the Magento Admin Panel and navigate to System → Configuration. Under “LITEMAGE CACHE” in the left side menu, click “LiteMage Configuration”. Under “Developer Testing” set Enable Debug to “Yes”.

By enabling LiteMage for certain IPs only, you are essentially giving permission to use debug-related administrative privilege browser commands with regards to LiteMage to those specific IPs as well as disabling LiteMage for all other traffic to your site. This setting can be very useful for debugging.

To enable LiteMage for certain IPs only, log in to the Magento Admin Panel and navigate to System → Configuration. In the left hand side menu under “LITEMAGE CACHE”, click “LiteMage Configuration”. Under “Developer Testing” add the desired IPs to the Enable LiteMage Cache Only for Listed IPs field.

This is the most direct and least obtrusive way of enabling all administrative privilege browser commands. Although it can be less useful for debugging, LiteMage will remain enabled for all visitors to your site and only the IPs listed will have permission to use all administrative privilege browser commands.

To add your IP to the Admin IPs list, log in to the Magento Admin Panel and navigate to System → Configuration. In the left hand side menu under “LITEMAGE CACHE”, click “LiteMage Configuration”. Under “General Settings” add the desired IPs to the Admin IPs field.

The following is a complete list of LiteMage Administrative privilege browser commands along with their descriptions. You can use these commands (with the proper privileges) by adding them to the end of a LiteMage enabled URL in your browser's address bar.

• ?LITEMAGE_DEBUG=NOCACHE - This command is used for retrieving the current page from the backend, bypassing LiteMage Cache. This is useful for checking the accuracy of the currently cached version of a page.
• ?LITEMAGE_DEBUG=SHOWHOLES - This command is used to display holes punched during the ESI process. This is useful for checking if all private blocks are being properly hole punched by LiteMage.
  For Example:
  
  Note: valueOnly blocks will not be shown.
• ?LITEMAGE_CTRL=PURGE - This command allows you to purge the current page from cache without having to go through the Magento Admin Panel.
• /litemage/admin/purge?tags= - This command is used to purge any page containing a certain item, category, or cms page by ID number. The command should be followed by a comma separated list of tags and ID numbers where the tag can be P(for product), C(for catalog), or G(for cms page), followed by a dot and the desired numeric ID.
  
  For Example: your_site_url/litemage/admin/purge?tags=P.345,C.4,G.1
  
  This is very useful in cases where your Magento database is updated by an external program. In these cases you can use GET with this parameter in a script to automate purging the affected products, categories, or cms pages.
  
  Note: This is not necessary if updating only through the Magento Admin Panel. When a product is saved in the Magento Admin Panel, not only the product page but also all the related category pages will be automatically purged.