Sylius/docs/components_and_bundles/bundles/SyliusTaxonomyBundle/installation.rst
2020-03-06 09:46:59 +01:00

86 lines
2.5 KiB
ReStructuredText

.. rst-class:: outdated
Installation
============
.. danger::
We're sorry but **this documentation section is outdated**. Please have that in mind when trying to use it.
You can help us making documentation up to date via Sylius Github. Thank you!
We assume you're familiar with `Composer <http://packagist.org>`_, a dependency manager for PHP.
Use the following command to add the bundle to your `composer.json` and download the package.
If you have `Composer installed globally <http://getcomposer.org/doc/00-intro.md#globally>`_.
.. code-block:: bash
composer require sylius/taxonomy-bundle
Otherwise you have to download .phar file.
.. code-block:: bash
curl -sS https://getcomposer.org/installer | php
php composer.phar require sylius/taxonomy-bundle
.. note::
This version is compatible only with Symfony 2.3 or newer. Please see the CHANGELOG file in the repository, to find version to use with older vendors.
Adding required bundles to the kernel
-------------------------------------
First, you need to enable the bundle inside the kernel.
If you're not using any other Sylius bundles, you will also need to add `SyliusResourceBundle` and its dependencies to the kernel.
Don't worry, everything was automatically installed via Composer.
.. code-block:: php
<?php
// app/AppKernel.php
public function registerBundles()
{
$bundles = array(
new winzou\Bundle\StateMachineBundle\winzouStateMachineBundle(),
new FOS\RestBundle\FOSRestBundle(),
new JMS\SerializerBundle\JMSSerializerBundle($this),
new Stof\DoctrineExtensionsBundle\StofDoctrineExtensionsBundle(),
new WhiteOctober\PagerfantaBundle\WhiteOctoberPagerfantaBundle(),
new Sylius\Bundle\TaxonomyBundle\SyliusTaxonomyBundle(),
new Sylius\Bundle\ResourceBundle\SyliusResourceBundle(),
// Other bundles...
new Doctrine\Bundle\DoctrineBundle\DoctrineBundle(),
);
}
Container configuration
-----------------------
Configure doctrine extensions which are used in the taxonomy bundle:
.. code-block:: yaml
stof_doctrine_extensions:
orm:
default:
tree: true
sluggable: true
sortable: true
Updating database schema
------------------------
Run the following command.
.. code-block:: bash
php bin/console doctrine:schema:update --force
.. warning::
This should be done only in **dev** environment! We recommend using Doctrine migrations, to safely update your schema.