Prettier embeds for your Vimeo videos in Neos CMS - with nice options like high-res preview images, lightbox feature and advanced customization of embed options.
|1.*||3.3.* + 4.*|
Most of the time you have to make small adjustments to a package (e.g. configuration in
Settings.yaml). Because of that, it is important to add the corresponding package to the composer from your theme package. Mostly this is the site packages located under
Packages/Sites/. To install it correctly go to your theme package (e.g.
Packages/Sites/Foo.Bar) and run following command:
composer require jonnitto/prettyembedvimeo --no-update
--no-update command prevent the automatic update of the dependencies. After the package was added to your theme
composer.json, go back to the root of the Neos installation and run
composer update. Et voilà! Your desired package is now installed correctly.
This package is member of the PrettyEmbedCollection which contains following packages:
If you install the PrettyEmbedCollection the video players get grouped into a own group in the node inspector, otherwise they will be in the default group.
What are the differences from the PrettyEmbed series to Jonnitto.Plyr?
|Advanced captions for native video||✓|
|Filesize (JS & CSS)||smaller||bigger|
All packages from the PrettyEmbed series have the benefit of a better frontend performance since the player gets only loaded on request. So, no iframe/video get's loaded until the user wants to watch a video.
If you want to customize the default settings, take a look at the Settings.Jonnitto.yaml file. If no node property is giving, these default values will be taken. If you, for example, don't want to let the editor choose if the video should open in a lightbox you can deactivate the mixin in your Configuration folder like this:
"Jonnitto.PrettyEmbedVimeo:Content.Vimeo": superTypes: "Jonnitto.PrettyEmbedHelper:Mixin.Lightbox": false
These are the available mixins:
||Enables the inspector groups||✓|
||Include the frontend resources||✓|
||Add the preview image property||✓|
||Open the video in a lightbox, defaults to
||Let the user enter the video id or youtube url||✓|
||Read the title of the video and set this as label in the content tree||✓|
||Allow fullscreen or not, defaults to
||Whether the video is muted upon loading, defaults to
||Loop the video, defaults to
If you want to give the editor even more control, you can also add your own properties like
background, for example. For a full list look at the
defaults section in the Settings.Jonnitto.yaml file.
If you want to use the player as a pure component, you can use the
Jonnitto.PrettyEmbedVimeo:Component.Vimeo fusion prototype.
If you want to read the node properties and let the package handle all for you, you should use the
Jonnitto.PrettyEmbedVimeo:Content.Vimeo prototype. For easier including in your own node types, you can disable the content element wrapping with
contentElement = false. This is useful if you want to create for example a text with video node type.
Update from version 1
To update from version 1, you have to run following command in your cli:
./flow node:migrate --version 20190617204500
To check the current state of the migrations, you can run