Platform UI Bundle

PlatformUIBundle is a bundle for eZ Publish Platform providing a webapp application to manage your content and administrate your eZ Publish Platform install.

If you find a bug, please create an issue in JIRA and don't forget to add as much details as you can (steps to reproduce, OS and browser(s) versions, ...) and to put PlatformUI in the Component/s field. If you discover a security issue, please see how to responsibly report such issues on https://doc.ez.no/Security

Installation

eZ Publish Platform 5.4 or community release 2014.11 (or later community release) are required to run the PlatformUI.

If you are using a recent clone of the ezpublish-community repository, PlatformUIBundle is automatically setup. So you can directly open http://[uri_of_ez]/ez in your favorite browser.

On an existing installation, here's what you need to do:

• From your eZ Publish installation, run composer:

  $ composer require ezsystems/platform-ui-bundle:dev-master
  

• In ezpublish/EzPublishKernel.php add an instance of EzSystemsPlatformUIBundle and EzSystemsPlatformUIAssetsBundle classes to the list of registered bundles:

  public function registerBundles()
  {
      $bundles = array(
          // enabled bundles
          // ...
  
          new EzSystems\PlatformUIBundle\EzSystemsPlatformUIBundle(),
          new EzSystems\PlatformUIAssetsBundle\EzSystemsPlatformUIAssetsBundle(),
      );
  }

• In ezpublish/config/routing.yml include the eZPlatformUIBundle routing configuration:

  _ezpublishPlatformUIRoutes:
      resource: "@eZPlatformUIBundle/Resources/config/routing.yml"

• Configure the REST API to use the session based authentication.

• Run the following command:

  $ php ezpublish/console assets:install --symlink
  

If you are running eZ Publish in the prod environment, you also need to dump the assets for Assetic with:

php ezpublish/console assetic:dump --env=prod

Once this is done, you can go to http://[uri_of_ez]/ez to run the eZ Platform UI application.

Developers tasks

Most developer related tasks can be run with Grunt and have several additional dependencies:

• Install grunt, yuidoc, bower and grover globally (usually you need to be root):

  # npm install -g grunt-cli yuidocjs grover bower gulp
  

• Install phantomjs

• Install local npm and bower dependencies, from the bundle root, run:

  $ npm install
  $ bower install
  

Once this is done, you can use any tasks registered in Grunt, the most interesting are:

• Running the JavaScript unit tests

  $ grunt test
  

• Generate a code coverage from those tests:

  $ grunt coverage
  

  The HTML coverage report is then available in Tests/report/lcov-report/index.html.

• Generate the JavaScript API doc:

  $ grunt doc
  

• Alternatively, you can run a live documentation server that will be available at http://127.0.0.1:3000 :

  $ grunt livedoc
  

• Update the custom AlloyEditor skin:

  $ composer install # or composer update
  $ cd vendor/ezsystems/platform-ui-assets-bundle/Resources/public/vendors/alloy-editor/
  $ npm install
  $ cd -
  $ grunt alloy-css

To run the PHP unit tests, you first need to install the dev dependencies of the bundle. To do that, from the bundle root, run:

$ composer install --prefer-dist

Then, you can run the unit tests with:

$ php vendor/bin/phpunit