Skip to content

Latest commit

 

History

History
229 lines (156 loc) · 5.87 KB

UPGRADE.md

File metadata and controls

229 lines (156 loc) · 5.87 KB
Raw

Upgrade

dev-develop

ElasticSearchFieldDescriptor constructor changed

The ElasticSearchFieldDescriptor changed see FieldDescriptor update in the UPGRADE.md of sulu/sulu.

1.1.1

New security-contexts have been created per article type. This means permission for articles need to be re-set.

1.1.0

Elasticsearch 2.0 and PHP 5.5 support dropped

To support Elasticsearch 6 we needed to drop support for Elasticsearch 2.0 and PHP 5.5 they will be maintained in the 1.0.x Version of the bundle.

When using Elasticsearch 6 and used the same index for custom entities you need to change this and create an own index for them as having multiple Elasticsearch types in the same index is not longer supported by Elasticsearch.

When you UPGRADE from ES2 to ES5/ES6 have a look at the new ongr_elasticsearch configuration.

1.0.0

Localized webspace settings

Reindex elasticsearch data:

bin/websiteconsole sulu:article:reindex --drop
bin/adminconsole sulu:article:reindex --drop

Check also the new possible localized configuration.

Elasticsearch Mapping Changed

Mapping has changed, reindex whole elasticsearch data:

bin/websiteconsole sulu:article:reindex --drop
bin/adminconsole sulu:article:reindex --drop

1.0.0-RC7

Multi webspace behavior

When you have a multi webspace setup you need to follow the new instructions: multi webspaces

ArticlePageDocument route definition need to be defined

The ArticleBundle will not longer prepend the configuration for the article page routes for this you need to define them in your configuration (app/config/config.yml):

sulu_route:
    mappings:
        # ...
        Sulu\Bundle\ArticleBundle\Document\ArticlePageDocument:
            generator: "article_page"
            options:
                route_schema: "/{translator.trans(\"page\")}-{object.getPageNumber()}"
                parent: "{object.getParent().getRoutePath()}"

1.0.0-RC5

Author and Authored

The author and authored are now localized and has to be updated.

bin/adminconsole phpcr:migrations:migrate 
bin/websiteconsole sulu:article:reindex --no-interaction

1.0.0-RC1

Reindex command

The sulu:article:index-rebuild command was refactored and renamed to sulu:article:reindex. See Commands in documentation.

NewIndex mapping has changed

Recreate the index to update mapping (new content_data field) and reindex your articles:

bin/adminconsole sulu:article:reindex --drop --no-interaction
bin/websiteconsole sulu:article:reindex --drop --no-interaction

0.7.0

Index mapping has changed

Update configuration for Elasticsearch ^2.2 or ^5.0 and add the new analyzer pathAnalyzer.

After that recreate the index and reindex your articles:

bin/adminconsole ongr:es:index:drop -m default --force
bin/websiteconsole ongr:es:index:drop -m live --force

bin/adminconsole ongr:es:index:create -m default
bin/websiteconsole ongr:es:index:create -m live

bin/adminconsole sulu:article:index-rebuild ###LOCALE###
bin/websiteconsole sulu:article:index-rebuild ###LOCALE### --live

0.6.1

Resolve of excerpt data

Excerpt data is now resolved in the article template instead of an array of categories and images you get directly the data.

before:

{{ extension.excerpt.categories[0] }}
{{ extension.excerpt.images.ids[0] }}
{{ extension.excerpt.icon.ids[0] }}

after:

{{ extension.excerpt.categories[0].id }}
{{ extension.excerpt.images[0].id }}
{{ extension.excerpt.icon[0].id }}

0.6.0

Index mapping has changed

Recreate the index and reindex your articles:

bin/adminconsole ongr:es:index:drop -m default --force
bin/websiteconsole ongr:es:index:drop -m live --force

bin/adminconsole ongr:es:index:create -m default
bin/websiteconsole ongr:es:index:create -m live

bin/adminconsole sulu:article:index-rebuild ###LOCALE###
bin/websiteconsole sulu:article:index-rebuild ###LOCALE### --live

DocumentManager

Removed persist option route_path use the method setRoutePath instead.

0.5.0

Elasticsearch 5.0

Now also support for ElasticSearch 5. To still be compatible with ^2.2, make sure you run:

  • composer require ongr/elasticsearch-bundle:1.2.9

0.4.0

WebsiteArticleController

The multi-page feature needs a refactoring of the WebsiteArticleController. If you have overwritten it you have to adapt it.

Before:

class CustomArticleController extends Controller
{
    public function indexAction(Request $request, ArticleDocument $object, $view)
    {
        $content = $this->get('jms_serializer')->serialize(
            $object,
            'array',
            SerializationContext::create()
                ->setSerializeNull(true)
                ->setGroups(['website', 'content'])
                ->setAttribute('website', true)
        );
        
        return $this->render(
            $view . '.html.twig',
            $this->get('sulu_website.resolver.template_attribute')->resolve($content),
            $this->createResponse($request)
        );
    }
}

After:

class CustomArticleController extends WebsiteArticleController
{
    public function indexAction(Request $request, ArticleInterface $object, $view, $pageNumber = 1)
    {
        return $this->renderArticle($request, $object, $view, $pageNumber, []);
    }
}

Cachelifetime request attribute changed

The _cacheLifetime attribute available in the request parameter of a article controller will return the seconds and don't need longer be resolved manually with the cachelifetime resolver.

0.2.0

Reindex elastic search indexes:

bin/adminconsole sulu:article:index-rebuild ###LOCALE### --live
bin/adminconsole sulu:article:index-rebuild ###LOCALE###