Quick development guide

• After app is installed disable cache and enable debug output.
  • https://github.com/LiveHelperChat/livehelperchat/blob/master/lhc_web/settings/settings.ini.default.php#L13-L16
  • Change the following values to

   debug_output => true
   templatecache => false
   templatecompile => false
   modulecompile => false

• To compile JS from lhc_web folder execute. This will compile main JS and old widget javascript files.
  • npm install && gulp
• To compile new widget V2
  • There is two apps wrapper and widget
  • cd lhc_web/design/defaulttheme/widget/wrapper && npm install && npm run build
  • cd lhc_web/design/defaulttheme/widget/react-app && npm install && npm run build && npm run build-ie
• To recompile back office React APP (Left toolbar, Group Chat etc...)
  • cd lhc_web/design/defaulttheme/js/admin && npm run build
• Recompile static JS/CSS files. This is required if you change core JS files. It also avoids missing CSS/JS files if more than one server is used.
  • php cron.php -s site_admin -c cron/util/generate_css -p 1 && gulp js-static

One command to rule them all

I usually before releasing next version I just run from lhc_web folder. It will recompile everything.

cd lhc_web/ && ./deploy.sh

During development process make sure you disable network cache Network -> Disable cache in Chrome developer toolbar.

More usefull links

• It's possible to override any image in web application without overriding default ones
• It's possible to override any CSS in web application without overriding default ones
• It's possible to override any template without overriding default ones
• It's possible to override any class
• It's possible to override any module, or just a single url
• It's possible to override translations
• If you are not sure which template is used enable debug output
• If you change templates and nothing changes disable cache
• You can write your own extensions
• We are using bootstrap 4 CSS framework.