Update Enterprise install docs

getting_started/index.rst

@@ -10,6 +10,7 @@ Getting started
     install_new_symfony
     install_existing_project
     install_layouts_enterprise
+    install_layouts_enterprise_no_flex
     migrate_ezplatform_ibexa
 
 .. include:: /getting_started/map.rst.inc

getting_started/install_layouts_enterprise.rst

@@ -3,7 +3,7 @@ Install Netgen Layouts Enterprise
 
 To install Netgen Layouts Enterprise, you need to have an existing Symfony full
 stack installation (Ibexa CMS, Sylius, clean Symfony install...) with
-Netgen Layouts open source edition installed and configured.
+Symfony Flex and Netgen Layouts open source edition installed and configured.
 
 Add packages to Composer
 ------------------------
@@ -24,6 +24,22 @@ section of your ``composer.json``:
         { "type": "composer", "url": "https://packagist.netgen.biz", "canonical": false }
     ]
 
+Add the Netgen Layouts Flex Recipes repo to your ``composer.json``. If
+``extra.symfony.endpoint`` already exists in your ``composer.json`` file, make
+sure it is an array with ``flex://defaults`` at the very bottom:
+
+.. code-block:: json
+
+    "extra": {
+        "symfony": {
+            "allow-contrib": true,
+            "endpoint": [
+                "https://api.github.com/repos/netgen-layouts/recipes/contents/index.json?ref=flex",
+                "flex://defaults"
+            ]
+        }
+    }
+
 Add the ``netgen/layouts-enterprise`` package to your ``require`` section. Use
 the same version as the Netgen Layouts packages from open source edition. For
 example, if you're using ``~1.0.0`` version of Netgen Layouts, use the same
@@ -35,42 +51,9 @@ example, if you're using ``~1.0.0`` version of Netgen Layouts, use the same
     the ``netgen/layouts-enterprise-ibexa`` package too, in the same
     version as the other Netgen Layouts packages.
 
-Activate the bundles
---------------------
-
-Add the following bundles to your configuration:
-
-.. code-block:: php
-
-    Netgen\Bundle\LayoutsEnterpriseBundle\NetgenLayoutsEnterpriseBundle::class => ['all' => true],
-    Netgen\Bundle\LayoutsEnterpriseAdminBundle\NetgenLayoutsEnterpriseAdminBundle::class => ['all' => true],
-    Netgen\Bundle\LayoutsEnterpriseUIBundle\NetgenLayoutsEnterpriseUIBundle::class => ['all' => true],
-
-.. note::
-
-    If you're installing Netgen Layouts on Ibexa CMS, activate the following
-    bundle too after all of the bundles listed above:
-
-    .. code-block:: php
-
-        Netgen\Bundle\LayoutsEnterpriseIbexaBundle\NetgenLayoutsEnterpriseIbexaBundle::class => ['all' => true],
-
-Make sure to activate these bundles after all other Netgen Layouts bundles.
-
-Run Composer
+Run composer
 ------------
 
-.. note::
-
-    Make sure you run Composer only after adding the bundles to your
-    configuration. Otherwise, important frontend assets will not be installed.
-    In that case, you can install the assets later by running the following
-    command:
-
-    .. code-block:: shell
-
-        php bin/console assets:install --symlink --relative
-
 Run the following Composer command to install the packages:
 
 .. code-block:: shell
@@ -82,25 +65,3 @@ Run the following Composer command to install the packages:
     ``prefer-dist`` is used because it is not possible to install source
     packages from ``packagist.netgen.biz`` repository. Make sure to remember
     this when upgrading Netgen Layouts Enterprise to future versions.
-
-Routing and assets
-------------------
-
-Add the following routes to your main routing config file. Make sure you add
-them after all other Netgen Layouts routes:
-
-.. code-block:: yaml
-
-    netgen_layouts_enterprise:
-        resource: "@NetgenLayoutsEnterpriseBundle/Resources/config/routing.yaml"
-        prefix: "%netgen_layouts.route_prefix%"
-
-.. note::
-
-    If you're installing Netgen Layouts on Ibexa CMS, activate the following
-    routes too after the routes listed above:
-
-    .. code-block:: yaml
-
-        netgen_layouts_enterprise_ibexa:
-            resource: "@NetgenLayoutsEnterpriseIbexaBundle/Resources/config/routing.yaml"

getting_started/install_layouts_enterprise_no_flex.rst

@@ -0,0 +1,106 @@
+Install Netgen Layouts Enterprise (without Symfony Flex)
+========================================================
+
+To install Netgen Layouts Enterprise, you need to have an existing Symfony full
+stack installation (Ibexa CMS, Sylius, clean Symfony install...) with
+Netgen Layouts open source edition installed and configured.
+
+Add packages to Composer
+------------------------
+
+To install Netgen Layouts Enterprise, you need a valid license. Once purchased,
+you need to add the license to Composer with the following command:
+
+.. code-block:: shell
+
+    composer config http-basic.packagist.netgen.biz <username> <token>
+
+Next, add the ``packagist.netgen.biz`` Composer repository to ``repositories``
+section of your ``composer.json``:
+
+.. code-block:: json
+
+    "repositories": [
+        { "type": "composer", "url": "https://packagist.netgen.biz", "canonical": false }
+    ]
+
+Add the ``netgen/layouts-enterprise`` package to your ``require`` section. Use
+the same version as the Netgen Layouts packages from open source edition. For
+example, if you're using ``~1.0.0`` version of Netgen Layouts, use the same
+``~1.0.0`` version for Netgen Layouts Enterprise too.
+
+.. note::
+
+    If you're installing Netgen Layouts Enterprise on Ibexa CMS, you need
+    the ``netgen/layouts-enterprise-ibexa`` package too, in the same
+    version as the other Netgen Layouts packages.
+
+Activate the bundles
+--------------------
+
+Add the following bundles to your configuration:
+
+.. code-block:: php
+
+    Netgen\Bundle\LayoutsEnterpriseBundle\NetgenLayoutsEnterpriseBundle::class => ['all' => true],
+    Netgen\Bundle\LayoutsEnterpriseAdminBundle\NetgenLayoutsEnterpriseAdminBundle::class => ['all' => true],
+    Netgen\Bundle\LayoutsEnterpriseUIBundle\NetgenLayoutsEnterpriseUIBundle::class => ['all' => true],
+
+.. note::
+
+    If you're installing Netgen Layouts on Ibexa CMS, activate the following
+    bundle too after all of the bundles listed above:
+
+    .. code-block:: php
+
+        Netgen\Bundle\LayoutsEnterpriseIbexaBundle\NetgenLayoutsEnterpriseIbexaBundle::class => ['all' => true],
+
+Make sure to activate these bundles after all other Netgen Layouts bundles.
+
+Run Composer
+------------
+
+.. note::
+
+    Make sure you run Composer only after adding the bundles to your
+    configuration. Otherwise, important frontend assets will not be installed.
+    In that case, you can install the assets later by running the following
+    command:
+
+    .. code-block:: shell
+
+        php bin/console assets:install --symlink --relative
+
+Run the following Composer command to install the packages:
+
+.. code-block:: shell
+
+    composer update --prefer-dist
+
+.. warning::
+
+    ``prefer-dist`` is used because it is not possible to install source
+    packages from ``packagist.netgen.biz`` repository. Make sure to remember
+    this when upgrading Netgen Layouts Enterprise to future versions.
+
+Routing and assets
+------------------
+
+Add the following routes to your main routing config file. Make sure you add
+them after all other Netgen Layouts routes:
+
+.. code-block:: yaml
+
+    netgen_layouts_enterprise:
+        resource: "@NetgenLayoutsEnterpriseBundle/Resources/config/routing.yaml"
+        prefix: "%netgen_layouts.route_prefix%"
+
+.. note::
+
+    If you're installing Netgen Layouts on Ibexa CMS, activate the following
+    routes too after the routes listed above:
+
+    .. code-block:: yaml
+
+        netgen_layouts_enterprise_ibexa:
+            resource: "@NetgenLayoutsEnterpriseIbexaBundle/Resources/config/routing.yaml"

getting_started/map.rst.inc

@@ -4,4 +4,5 @@
 * :doc:`/getting_started/install_new_symfony`
 * :doc:`/getting_started/install_existing_project`
 * :doc:`/getting_started/install_layouts_enterprise`
+* :doc:`/getting_started/install_layouts_enterprise_no_flex`
 * :doc:`/getting_started/migrate_ezplatform_ibexa`