Installation

If you have installed eZ Flow or eZ Website Interface, eZ JS Core LS 5.0.0 should be already installed.

1.  You can find eZ JS Core in your eZ Publish 5.0 sources under ezpublish_legacy/extension/ezjscore/.
2.  Activate the extension (if not active yet) by adding the following parameters to ezpublish_legacy/settings/override/site.ini by to the [ExtensionSettings] section:

   ActiveExtensions[]=ezjscore
   

3. Regenerate autoload array by running this script:

   php bin/php/ezpgenerateautoloads.php -e
   

   Or if you prefer to update the autoloads from the Admin Interface go to the Setup tab and click on the Extensions link in the menu on the left. In the list displayed check the eZ JS Core extension and click the Regenerate autoload arrays for extensions button.

4.  Clear the INI and template caches. To do this from the administration interface, select the Setup tab and click on the Cache Management link in the menu on the left. Next you are able to select the needed clear cache buttons.
5.  Some rewrite rules are necessary for eZ JS Core
    

   •  Rewrite Rules for lib folder
      eZ JSCore extension require correct Rewrite Rules in order to load the necessary yui (yahoo user interface) files from the file system. This is only required when this INI setting in ezjscore.ini is disabled.

     [eZJSCore]LoadFromCDN=disabled
     

     If this is the case add the following line to your Virtual-Host setup

     RewriteRule ^/extension/[^/]+/design/[^/]+/(stylesheets|flash|images|lib|javascripts?)/.* - [L]
     

   •  Rewrite Rules for script/css packing
      eZ JSCore packs JavaScript/CSS files together in order to decrease server requests and file size for faster download. These changes are already considered in the Virtual Host setup documentation for eZ Publish 5.x.

     •  .htaccess
        add:

       RewriteRule ^var/([^/]+/)?storage/images(-versioned)?/.* - [L]
       RewriteRule ^var/([^/]+/)?cache/(texttoimage|public)/.* - [L]
       

       For more details please check the .htaccess configuration example for eZ Publish 5.x.

     •   Virtual Host mode
        add:

       RewriteRule ^/var/([^/]+/)?storage/images(-versioned)?/.* - [L]
       RewriteRule ^/var/([^/]+/)?cache/(texttoimage|public)/.* - [L]
       

       For more details please check the Virtual Host configuration example for eZ Publish 5.x.

     • If you don't manage to get these changes working, you can disable this feature setting ezjscore.ini

       [eZJSCore]
       Packer=disabled
       

   •  Rewrite Rules for clustered enviroment
      In order to make eZ JS Core work in a cluster environment the following Rewrite Rules are required:

     RewriteRule ^/var/([^/]+/)?storage/images(-versioned)?/.* /index_cluster.php [L]
     RewriteRule ^/var/([^/]+/)?cache/(texttoimage|public)/.* /index_cluster.php [L]