====== LiteMage Cache Tips & Troubleshooting ======

===== Administration ======
These pages are dedicated to the different functions, tools, and tricks available to administrators in LiteMage Cache.

  * **[[litespeed_wiki:cache:litemage:troubleshooting:enabling-privileged-browser-commands|Enabling LiteMage Administrative Privilege Browser Commands]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:admin-privileged-browser-commands|All Admin Privileged Browser Commands]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:clean-up|Cache Clean Up]]**


===== Debugging =====
It is recommended to first deploy LiteMage Cache on a non-production environment for testing/debugging before deploying it on your production site. If you have to test LiteMage on your live site, you can [[#enable_litemage_for_only_certain_ips_for_testing_troubleshooting_purposes|enable LiteMage for only a few IPs during testing]]. Please disable all other full page caches as they will likely conflict with LiteMage.

We also offer a paid installation service that you can find out more about [[litespeed_wiki:cache:litemage:troubleshooting:support|here]]. This service is fully refundable if we are unable to make LiteMage work for your customized site.
 
  * **[[litespeed_wiki:cache:litemage:troubleshooting:served-from-cache|How To Check If A Page Is Being Served From LiteMage Cache]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:enabling-debug-log|Enabling The Debug Log]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:enable-for-certain-ips-only|]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:turn-off-for-certain-ips|Turning Off LiteMage For Certain IPs]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:checking-hole-punching|Checking If ESI Block Holes Are Being Properly Punched]]**

===== Troubleshooting ======
=== General ===
  * **[[litespeed_wiki:cache:litemage:troubleshooting:cache-growing-too-large|Cache Size Growing Too Large]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:uninitialized-php-vars-injected-block|Footer failed to output for SNS themes]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:javascript-global-var-problem|Private data showing on public cache content due to JS global variable issue]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:connect-cache-session-cleaning-error|Magento 503 error after (re)installation of LiteMage Cache extension]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:front-end-timeout-too-soon|Magento Front-end Session Timing Out Too Soon]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:templates-ajax-based-navigation-error|Page 2 showing Page 1 content in AJAX Based Navigation]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:installation-does-not-have-litemage-enabled|"LiteMage Cache not enabled" error message]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:header-footer-missing|Both Header and Footer Disappear After Enabling LiteMage Cache]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:turning-on-maintenance-mode|Site Abnormal After Store Maintenance with LiteMage Enabled]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:pop-ups-not-appearing|Site Pop-ups Sometimes Not Appear]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:form-keys-displayed-on-page|Form Keys Displayed On Site Page]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:unable-to-redirect-404-to-search-results|Can't Redirect 404 Pages To Search Results]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:3rd-party-auto-switcher-not-redirecting-correctly|Multi-Store/Currency Auto Switcher Not Redirecting To Correct Page]]**
  * **[[litespeed_wiki:cache:litemage:troubleshooting:logged-in-user-info-shown-to-others|Logged In Usernames/Cart Items Shown On Other User's Pages]]**

=== Customizations ===
  * **[[litespeed_wiki:cache:litemage:troubleshooting:configuration-file|Configuration File Customization]]** - Customizing LiteMage's configuration file.
    * **[[litespeed_wiki:cache:litemage:troubleshooting:configuration-file#block_type_denoted_by_t|Block Type Denoted By "T:"]]**
    * **[[litespeed_wiki:cache:litemage:troubleshooting:configuration-file#purge_tags|Purge Tags]]**
    * **[[litespeed_wiki:cache:litemage:troubleshooting:configuration-file#valueonly_blocks_denoted_by_v|Valueonly Blocks Denoted By "$v"]]**
    * **[[litespeed_wiki:cache:litemage:troubleshooting:configuration-file#hole-punching_dynamically_created_blocks_from_a_template|Hole-punching Dynamically Created Blocks From A Template]]**
    * **[[litespeed_wiki:cache:litemage:troubleshooting:configuration-file#custom_esi_block_structure_and_purge_events|Custom ESI Block Structure And Purge Events]]**
    * **[[litespeed_wiki:cache:litemage:troubleshooting:configuration-file#single_language_sites|Single Language Sites]]**
    * **[[litespeed_wiki:cache:litemage:troubleshooting:configuration-file#list_customized_block_names_for_welcome_and_toplinks_tags|List Customized Block Names For "welcome" And "toplinks" Tags]]**
  * **[[litespeed_wiki:cache:common:seperate-mobile-versions|Websites With Separate Mobile Versions]]** - Handling websites with separate mobile versions.
  * **[[litespeed_wiki:cache:common:views-based-on-cookie-values|Setting Views Based On Cookie Values]]** - Setting different views for the same URL based on customized cookie values.
  * **[[litespeed_wiki:cache:litemage:troubleshooting:private-info-in-public-block|Private Info In A Public Block]]** - Handling private information inside of a public block.
  * **[[litespeed_wiki:cache:litemage:customization:non-standard-message-blocks|Non-Standard Message Blocks]]** - Using customized message blocks not derived from "Mage_Core_Block_Messages".
  * **[[litespeed_wiki:cache:litemage:customization:separate-front-page-footer|Using A Separate Footer On Your Front Page]]** - Handling a dynamically determined separate footer for the home page.
  * **[[litespeed_wiki:cache:common:geoip-support|GEOIP Support]]** - How to enable GEOIP support.
  * **[[litespeed_wiki:cache:litemage:troubleshooting:warmup#keeping_public_cache_warm_indefinitely|Keeping Public Cache Warm Indefinitely]]** - Customizing LiteMage's crawler so your content is updated but users never hit the backend.
===== Need Additional Support? =====

For extensions that need some tweaking before being used with LiteMage, visit our [[litespeed_wiki:cache:litemage:supported_extensions#possible_modification_required|Supported 3rd Party Extensions page]]. 

If you need any additional support or help installing, configuring, or troubleshooting LiteMage for your Magento store, have a look at our [[litespeed_wiki:cache:litemage:troubleshooting:support|LiteMage Support]] page.