novactive / ezextrabundle
Novactive eZ Platform Extra Bundle
Installs: 38 169
Dependents: 2
Suggesters: 0
Security: 0
Stars: 2
Watchers: 14
Forks: 12
Open Issues: 0
Requires
- php: >7.3
- novactive/collection: 1.*
- phpoffice/phpspreadsheet: *
This package is auto-updated.
Last update: 2024-10-16 13:30:33 UTC
README
This repository is what we call a "subtree split": a read-only copy of one directory of the main repository. It is used by Composer to allow developers to depend on specific bundles.
If you want to report or contribute, you should instead open your issue on the main repository: https://github.com/Novactive/Nova-eZPlatform-Bundles
Documentation is available in this repository via .md
files but also packaged here: https://novactive.github.io/Nova-eZPlatform-Bundles/master/ExtraBundle/README.md.html
Installation
Step 1: Download Nova eZExtra Bundle using composer
Add the lib to your composer.json, run composer require novactive/ezextrabundle
to refresh dependencies.
Step 2: Enable the bundle
Then inject the bundle in the bundles.php
of your application.
Novactive\Bundle\eZExtraBundle\NovaeZExtraBundle::class => [ 'all'=> true ],
Step 3: Add the default routes
Activate the sroutes:
_novaezextraRoutes: resource: "@NovaeZExtraBundle/Resources/config/routing/main.yml"
Step 4: Clear the cache and check
php app|ezpublish/console cache:clear --env=dev
Go to : /_novaezextra/dev/test
Documentation
Twig Content Helper
eznova_parentcontent_by_contentinfo( content )
{% set content = eznova_parentcontent_by_contentinfo( content ) %}
Note : you get the content of the parent on the main location
eznova_location_by_content( content )
{% set contentType = eznova_location_by_content( content ) %}
eznova_relationlist_field_to_content_list( fieldValue )
{% set content = eznova_relationlist_field_to_content_list( ez_field_value( content, 'internal_links' ) ) %}
Note : return an array of direct linked contents by the relation objects FieldType
eznova_is_rich_text_really_empty(richTextFieldValue)
{% set content = eznova_is_rich_text_really_empty( ez_field_value( content, 'description' ) ) %}
Note : returns true if the value of RichText field is empty excluding the tags, whitespaces and line breaks, false otherwise
Twig Text Parsing Helper
ctaize
{% set ctaField | ctaize %}
Note : Filter which converts the string like ezcontent://123 or ezlocation://234 to the URL of specified content or location
ezlinks
{% set richTextFieldValue | ezlinks %}
Note : Filter which fixes the mistakes in opening/closing div tags and converts string like ezlocation://234 to the URL of specified location
htmldecode
{% set stringValue | htmldecode %}
Note : Filter which applies html_entity_decode php function to the specified var
Twig Image Helper
get_image_tag(content, fieldIdentifier, variationAlias, params)
{{ get_image_tag(content, 'thumbnail', 'card_slider') }}
Generates the picture html code including images for original, retina and mobile screens specified in the image variations config like the following:
optimized_original: reference: ~ filters: - { name: auto_rotate } - { name: strip } - { name: geometry/scaledownonly, params: [ 200,200 ] } optimized_original_retina: reference: ~ filters: - { name: auto_rotate } - { name: strip } - { name: geometry/scaledownonly, params: [ 400,400 ] } optimized_original_mobile: reference: ~ filters: - { name: auto_rotate } - { name: strip } - { name: geometry/scaledownonly, params: [ 50,50 ] }
If the placeholder dimensions are specified with empty content and variation then the placeholder image will be displayed:
{{ get_image_tag(null, 'image', '', {placeholder: {width: 300, height: 100}}) }}
get_image_url(content, fieldIdentifier, variationAlias, params)
The same as previous but returning just an image URL instead of tag.
get_image_asset_content(field)
Returns the Content by the Image Asset field. Requires the eZ\Publish\API\Repository\Values\Content\Field to be specified.
IMPORTANT: The image placeholder is enabled by default but can be disabled by setting the bool value to ENABLE_IMAGE_PLACEHOLDER env variable.
Picture Controller
{{ render( controller( "eZNovaExtraBundle:Picture:alias", { "contentId": content.getField('picture').value.destinationContentId, "fieldIdentifier": "image", "alias": "large" })) }}
Content/Location Helper
The goal was to mimic the old Fetch Content List
public function contentTree( $parentLocationId, $typeIdentifiers = [], $sortClauses = [], $limit = null, $offset = 0, $additionnalCriterion );
public function contentList( $parentLocationId, $typeIdentifiers = [], $sortClauses = [], $limit = null, $offset = 0, $additionnalCriterion );
public function nextByAttribute( $locationId, $attributeIdentifier, $locale, $additionnalCriterions = [] );
public function nextByPriority( $locationId, $aditionnalCriterions = [] )
public function previousByAttribute( $locationId, $attributeIdentifier, $locale, $additionnalCriterion = [] )
public function previousByPriority( $locationId, $additionnalCriterion = [] )
public function getSelectionTextValue($content, $identifier)
Return an array of Result
Usage:
{% for child in children %} <h2>{{ ez_field_value( child.content, "title" ) }}</h2> {{ ez_render_field( child.content, "overview" ) }} <a href="{{ path( "ez_urlalias", { "locationId" : child.content.contentInfo.mainLocationId } ) }}">{{ "Learn more" | trans() }}</a> {% endfor %}
Children Provider
Simply inject the children ( and potentially other things on a view Full )
Add your provider in a folder of your bundle
Project\Bundle\GeneralBundle\ChildrenProvider\YOUCONTENTIDENTIFIERPROVIDERCLASS: tags: - { name: novactive.ezextra.children.provider, contentTypeIdentifier: YOUCONTENTIDENTIFIER }
You class YOUCONTENTIDENTIFIERPROVIDERCLASS must extend Novactive\Bundle\eZExtraBundle\EventListener\Type
After you need to create a method for each view you display if you want to get children in your template The goal is to have children on each view.
Ex:
namespace Yoochoose\Bundle\GeneralBundle\ChildrenProvider; use Novactive\Bundle\eZExtraBundle\EventListener\Type; use eZ\Publish\API\Repository\Values\Content\Query; class PersonalizationEngine extends Type { //its also use as default to get the full view children public function getChildren($viewParameters, SiteAccess $siteAccess = null) { return $this->contentHelper->contentList( $this->location->id, [ 'article' ], array( new Query\SortClause\Location\Priority( Query::SORT_ASC ) ), 10); } public function getLineChildren( $viewParameters ) { ... } }
RepositoryAware helper (trait)
public function loadReverseRelations(ContentInfo $contentInfo, int $offset = 0, int $limit = -1): RelationList
Returns the list of reverse relations (RelationList) of the specified ContentInfo
RouterAware helper (trait)
public function generateRouteLocation(Location $location): string
public function generateRouteContent(Content $content): string
public function generateRouteWrapper(Wrapper $wrapper): string
The trait that allows to get the Route by location, content or Wrapper object.
ViewMatcher
This allows you to specify different ez views for the same content type but with different values of particular field.
IMPORTANT: By default the field name is set to matcher but can be rewritten by specifying it in the VIEW_MATCHER_FIELD_IDENTIFIER env variable.
Then for example if you set the business value to the field that is set to identify the view (matcher by default) inside the Article Content Type then another template can be defined for that using the following config:
article_business: template: '@ezdesign/full/article_business.html.twig' match: Identifier\ContentType: [ 'article' ] '@Novactive\Bundle\eZExtraBundle\Core\ViewMatcher\ContentTypeField': 'business'