ezsystems / ez-matrix-bundle
EzMatrix FieldType for eZ Publish Platform
Installs: 58 026
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 12
Forks: 14
Open Issues: 0
Type:ezplatform-bundle
Requires
- php: ^5.6 | ^7.0
- ezsystems/ezpublish-kernel: ~5.3.11 | ~5.4.12 | ~6.7.8 | ~6.13.4 | ^7.2.5
Requires (Dev)
- phpunit/phpunit: ^5.7
Replaces
- blend/ez-matrix-bundle: *
This package is auto-updated.
Last update: 2024-11-29 05:09:22 UTC
README
Bundle provides ezmatrix field type for eZ Publish Platform 5.x and higher
⛔️ Status DEPRECATED: As of 2.5 there is now bundled a newer version avaiable from eZ with full support, migration, UI editing and more. ⛔️
This bundle can and should be used on earlier versions, but will not recive support for use in 1.x or 2.x UI or full API support, so UI editing is limited to use via legacy bridge/bundle.
Install
From your eZ Publish Platform install root with composer installed:
php -d memory_limit=-1 composer.phar require --prefer-dist ezsystems/ez-matrix-bundle:dev-master
Add the following in your app/AppKernel.php
file:
public function registerBundles() { ... $bundles[] = new EzSystems\MatrixBundle\EzSystemsMatrixBundle(); return $bundles; }
How to update content programmatically
Here's an example on how to update the value of a matrix field for a content item. The field has two columns, and we are creating two rows of content:
$repository = $this->getContainer()->get( 'ezpublish.api.repository' ); $contentService = $repository->getContentService(); // This example for setting a current user is valid for 5.x and early versions of 6.x installs // This is deprecated from 6.6, and you should use PermissionResolver::setCurrentUserReference() instead $repository->setCurrentUser( $repository->getUserService()->loadUser( 14 ) ); $contentId = 26926; $newTitle = 'My updated title 2'; try { // create a content draft from the current published version $contentInfo = $contentService->loadContentInfo( $contentId ); $contentDraft = $contentService->createContentDraft( $contentInfo ); // instantiate a content update struct and set the new fields $contentUpdateStruct = $contentService->newContentUpdateStruct(); $contentUpdateStruct->initialLanguageCode = 'eng-US'; // set language for new version $matrixValue = new \EzSystems\MatrixBundle\FieldType\Matrix\Value( array( new \EzSystems\MatrixBundle\FieldType\Matrix\Row( array( 'col1' => 'row1col1', 'col2' => 'row1col2' ) ), new \EzSystems\MatrixBundle\FieldType\Matrix\Row( array( 'col1' => 'row2col2', 'col2' => 'row2col2' ) ), ), array( new \EzSystems\MatrixBundle\FieldType\Matrix\Column( array( 'name' => 'Column 1', 'id' => 'col1', 'num' => 0 ) ), new \EzSystems\MatrixBundle\FieldType\Matrix\Column( array( 'name' => 'Column 2', 'id' => 'col2', 'num' => 1 ) ), ) ); $contentUpdateStruct->setField( 'title', $newTitle ); $contentUpdateStruct->setField( 'matrix', $matrixValue ); // update and publish draft $contentDraft = $contentService->updateContent( $contentDraft->versionInfo, $contentUpdateStruct ); $content = $contentService->publishVersion( $contentDraft->versionInfo ); } catch ( \eZ\Publish\API\Repository\Exceptions\NotFoundException $e ) { $output->writeln( $e->getMessage() ); } catch( \eZ\Publish\API\Repository\Exceptions\ContentFieldValidationException $e ) { $output->writeln( $e->getMessage() ); } catch( \eZ\Publish\API\Repository\Exceptions\ContentValidationException $e ) { $output->writeln( $e->getMessage() ); }
License & Copyright
See LICENSE file.
Contributors
https://github.com/ezcommunity/EzMatrixFieldTypeBundle/graphs/contributors